# mamanullah7/househelp-hub architecture

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

- Interactive diagram: https://gitdiagram.com/mamanullah7/househelp-hub
- Repository: https://github.com/mamanullah7/househelp-hub

## Overview

##### Project type and purpose
- This is a full-stack web application called “HouseHelp-Hub” that connects customers, professionals, and administrators to manage home-service requests.
- Built with Flask (Python) on the backend, Jinja2 templates on the frontend, and SQLite as the data store.

##### File structure
- Top-level files:
- app.py (Flask app entry point)
- wsgi.py (WSGI interface for deployment)
- build.sh, vercel.json (deployment scripts/config)
- requirements.txt, LICENSE, README.md
- applications/ directory:
- config.py (app configuration)
- models.py (ORM classes, data models via SQLAlchemy)
- routes.py (Flask view functions, Blueprints for different user roles)
- templates/:
- Subfolders for Professionals, Requests, Services, customer, plus shared templates (layout, navbar, index, login)
- static/:
- CSS, images, and JS assets
- instance/ (not in tree but mentioned in README): contains the SQLite file

##### Key insights from the README
- Application uses Flask’s built-in server at localhost:5000.
- Dependencies listed in requirements.txt.
- No external microservices beyond the SQLite backend.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Clients
    Browser["Web Browser\n(Customer, Professional, Admin)"]:::ui
    WebServer["Web Server / Reverse Proxy\n(Nginx / Vercel)"]:::infra

    %% Flask Application Container
    subgraph "Flask Application" 
        direction TB
        AppEntry["app.py"]:::app
        WSGI["wsgi.py"]:::app
        Config["Config Module\n(config.py)"]:::app
        Models["Models Layer\n(models.py)"]:::app
        Controllers["Controllers / Routes\n(routes.py)"]:::app
        subgraph "Templates (Jinja2 Views)"
            direction TB
            Layout["layout.html"]:::view
            Navbar["navbar.html"]:::view
            Index["index.html"]:::view
            Login["login.html"]:::view
            Admin["admin.html"]:::view
            AdminSearch["admin_search.html"]:::view
            AdminSummary["admin_summary.html"]:::view
            Customer["customer.html"]:::view
            Profile["profile.html"]:::view
            Prof["prof.html"]:::view
            subgraph "Professionals Templates"
                direction TB
                ProfDash["dashboard.html"]:::view
                ProfDelete["delete.html"]:::view
                ProfSearch["professional_search.html"]:::view
                ProfSummary["summary.html"]:::view
                ProfVerify["verify.html"]:::view
            end
            subgraph "Requests Templates"
                ShowReq["show.html"]:::view
            end
            subgraph "Services Templates"
                AddSrv["add_services.html"]:::view
                DelSrv["delete.html"]:::view
                EditSrv["edit_service.html"]:::view
                ShowSrv["show.html"]:::view
            end
            subgraph "Customer Templates"
                CustSearch["customer_search.html"]:::view
                CustDash["dashboard.html"]:::view
                CustSummary["summary.html"]:::view
            end
        end
        Static["Static Assets Handler\n(static/)"]:::static
    end

    %% Database
    DB["SQLite Database\n(househelpHub.sqlite3)"]:::db

    %% Deployment & Config
    subgraph "Deployment & Config"
        direction TB
        Build["build.sh"]:::infra
        Vercel["vercel.json"]:::infra
        Requirements["requirements.txt"]:::infra
        README["README.md"]:::infra
        License["LICENSE"]:::infra
    end

    %% Connections
    Browser -->|HTTP Request| WebServer
    WebServer -->|WSGI Entry| AppEntry
    AppEntry --> WSGI
    WSGI --> Config
    WSGI --> Models
    WSGI --> Controllers
    Controllers --> Models
    Controllers --> DB
    Controllers --> Templates
    Controllers --> Static
    Models --> DB
    Templates -->|Rendered HTML| Browser
    Static -->|Assets| Browser

    %% Click Events
    click AppEntry "https://github.com/mamanullah7/househelp-hub/blob/main/app.py"
    click WSGI "https://github.com/mamanullah7/househelp-hub/blob/main/wsgi.py"
    click Config "https://github.com/mamanullah7/househelp-hub/blob/main/applications/config.py"
    click Models "https://github.com/mamanullah7/househelp-hub/blob/main/applications/models.py"
    click Controllers "https://github.com/mamanullah7/househelp-hub/blob/main/applications/routes.py"
    click Layout "https://github.com/mamanullah7/househelp-hub/blob/main/templates/layout.html"
    click Navbar "https://github.com/mamanullah7/househelp-hub/blob/main/templates/navbar.html"
    click Index "https://github.com/mamanullah7/househelp-hub/blob/main/templates/index.html"
    click Login "https://github.com/mamanullah7/househelp-hub/blob/main/templates/login.html"
    click Admin "https://github.com/mamanullah7/househelp-hub/blob/main/templates/admin.html"
    click AdminSearch "https://github.com/mamanullah7/househelp-hub/blob/main/templates/admin_search.html"
    click AdminSummary "https://github.com/mamanullah7/househelp-hub/blob/main/templates/admin_summary.html"
    click Customer "https://github.com/mamanullah7/househelp-hub/blob/main/templates/customer.html"
    click Profile "https://github.com/mamanullah7/househelp-hub/blob/main/templates/profile.html"
    click Prof "https://github.com/mamanullah7/househelp-hub/blob/main/templates/prof.html"
    click ProfDash "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Professionals/dashboard.html"
    click ProfDelete "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Professionals/delete.html"
    click ProfSearch "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Professionals/professional_search.html"
    click ProfSummary "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Professionals/summary.html"
    click ProfVerify "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Professionals/verify.html"
    click ShowReq "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Requests/show.html"
    click AddSrv "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Services/add_services.html"
    click DelSrv "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Services/delete.html"
    click EditSrv "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Services/edit_service.html"
    click ShowSrv "https://github.com/mamanullah7/househelp-hub/blob/main/templates/Services/show.html"
    click CustSearch "https://github.com/mamanullah7/househelp-hub/blob/main/templates/customer/customer_search.html"
    click CustDash "https://github.com/mamanullah7/househelp-hub/blob/main/templates/customer/dashboard.html"
    click CustSummary "https://github.com/mamanullah7/househelp-hub/blob/main/templates/customer/summary.html"
    click Static "https://github.com/mamanullah7/househelp-hub/tree/main/static/"
    click Build "https://github.com/mamanullah7/househelp-hub/blob/main/build.sh"
    click Vercel "https://github.com/mamanullah7/househelp-hub/blob/main/vercel.json"
    click Requirements "https://github.com/mamanullah7/househelp-hub/blob/main/requirements.txt"
    click README "https://github.com/mamanullah7/househelp-hub/blob/main/README.md"
    click License "https://github.com/mamanullah7/househelp-hub/tree/main/LICENSE"

    %% Styles
    classDef ui fill:#cce5ff,stroke:#4d94ff,color:#000;
    classDef infra fill:#e6e6e6,stroke:#999,color:#000;
    classDef app fill:#d9f2d9,stroke:#33cc33,color:#000;
    classDef db fill:#ffe6cc,stroke:#ff9933,color:#000;
    classDef view fill:#f2e6ff,stroke:#b266ff,color:#000;
    classDef static fill:#fff5cc,stroke:#ffcc00,color:#000;
```
