# khairulhasanrakib/fall-fest architecture

> Architecture diagram of the GitHub repository khairulhasanrakib/fall-fest, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/khairulhasanrakib/fall-fest
- Repository: https://github.com/khairulhasanrakib/fall-fest

## Overview

##### Project type and purpose
- From the file tree and the lone README title “Fall-Fest,” we see a Python-based web application (Bill-Ads) that uses Flask (app.py, config.py, models.py, forms.py, templates/, static/) alongside a small static site (normal/).
- The purpose is to serve dynamic ad-posting pages (login, register, verify) backed by an SQLite database (instance/users.db), plus a set of static landing pages in “normal.”

##### File structure
- Top-level directories:
- .github/workflows – CI pipeline using a Jekyll-Docker action (likely for docs or deployment).
- Bill-Ads – the Flask app:
– config.py, app.py – application setup and entry point
– models.py – ORM definitions
– forms.py – WTForms definitions
– templates/ – Jinja2 views for login, register, verify
– static/ – CSS, images, JS assets
– instance/ – environment-specific data (SQLite DB, .env)
- normal – purely static HTML/CSS site

##### README
- The README only gives the project title. No further architectural hints, so we rely on the file layout and Flask conventions.

##### Detailed capture of essential components
- Routes (app.py)
- Config loader (config.py + .env)
- Models (models.py)
- Forms (forms.py)
- Template renderer (templates/)
- Static assets served directly from “static/.”
- How GitHub Actions file (jekyll-docker.yml) triggers on push, builds docs/site, and pushes to a hosting service (if used).

1. User Layer (Browser)
2. Presentation Layer
– Static Pages (normal/)
– Dynamic Pages (Flask + Jinja2)
3. Business Logic Layer (Forms, Models, Routes)
4. Data Layer (SQLite)
5. DevOps/CI Layer (GitHub → Jekyll Docker → Deployment)

## Diagram (Mermaid)

```mermaid
flowchart TD
    Browser["Browser"]:::external

    Browser -->|GET /| StaticIndex
    Browser -->|GET/POST /login, /register, /verify| Routes

    subgraph "Static Front-End (normal/)"
        direction TB
        StaticIndex["index.html"]:::static
        StaticStyle["style.css"]:::static
    end

    subgraph "Flask Application Server"
        direction TB
        Routes["App Routes (app.py)"]:::compute
        Config["Config Loader (config.py)"]:::compute
        Forms["Form-Validation (forms.py)"]:::compute
        Models["Data Models (models.py)"]:::compute
        TemplateEngine["Template Engine (Jinja2)"]:::compute
        DynStatic["Static Assets (style.css)"]:::static
    end

    subgraph "Templates"
        direction TB
        LoginTemp["login.html"]:::static
        RegisterTemp["register.html"]:::static
        VerifyTemp["verify.html"]:::static
    end

    DB["SQLite DB"]:::db

    subgraph "CI/CD Pipeline"
        direction TB
        CI["GitHub Actions (jekyll-docker.yml)"]:::ci
        ArchDiagrams["Architecture Diagrams (.drawio)"]:::static
    end

    Routes -->|uses| Config
    Routes -->|validates| Forms
    Routes -->|queries| Models
    Routes -->|renders| TemplateEngine
    Routes -->|serves| DynStatic
    TemplateEngine -->|loads| LoginTemp
    TemplateEngine -->|loads| RegisterTemp
    TemplateEngine -->|loads| VerifyTemp
    Models -->|reads/writes| DB
    CI -.->|triggers on push| ArchDiagrams

    click StaticIndex "https://github.com/khairulhasanrakib/fall-fest/blob/main/normal/index.html"
    click StaticStyle "https://github.com/khairulhasanrakib/fall-fest/blob/main/normal/style.css"
    click Routes "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/app.py"
    click Config "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/config.py"
    click Forms "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/forms.py"
    click Models "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/models.py"
    click LoginTemp "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/templates/login.html"
    click RegisterTemp "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/templates/register.html"
    click VerifyTemp "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/templates/verify.html"
    click DynStatic "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/static/style.css"
    click DB "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads/instance/users.db"
    click CI "https://github.com/khairulhasanrakib/fall-fest/blob/main/.github/workflows/jekyll-docker.yml"
    click ArchDiagrams "https://github.com/khairulhasanrakib/fall-fest/blob/main/Bill-Ads-App.drawio"

    classDef compute fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef db fill:#90EE90,stroke:#000,stroke-width:1px
    classDef static fill:#FFFACD,stroke:#000,stroke-width:1px
    classDef ci fill:#FFD700,stroke:#000,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
```
