# imtahiriqbal/web-app-tasks architecture

> Architecture diagram of the GitHub repository imtahiriqbal/web-app-tasks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/imtahiriqbal/web-app-tasks
- Repository: https://github.com/imtahiriqbal/web-app-tasks

## Overview

##### Project type and purpose
- This is a small‐to‐medium‐scale full-stack e-commerce web application built with Python/Flask (monolith) serving a “Perfume” storefront.
- It offers user-facing pages (home, products, cart, signup/login, checkout) plus an admin dashboard.

##### File structure
- Top level:
- app.py – single entry point, Flask application definition, URL routes, controllers.
- static/ – CSS, JS, images served as static assets.
- templates/ – Jinja2 HTML templates: base layouts, pages (home.html, products.html, cart.html, dashboard.html, login/signup, success).
- No subfolders for “backend” or “services” → code is a single service (monolith).
- No obvious Dockerfile, CI/CD configs, or cloud infra files—focus is on core web app.

##### README
- Minimal contents (“# web-app-tasks”) → no extra architectural guidance.
- We infer a basic single-tenant Flask app with (likely) a relational database and optional external integrations (e.g. payment gateway).

## Diagram (Mermaid)

```mermaid
flowchart TB
    Client["Web Browser (Client)"]:::client
    LoadBalancer["Load Balancer"]:::infra
    WSGI["WSGI Server (Gunicorn/uWSGI)"]:::app

    subgraph "Flask Application"
        direction TB
        App["Flask App (app.py)"]:::app
        subgraph "Controllers & Routes"
            direction TB
            Controllers["Route Handlers"]:::app
        end
        subgraph "Static File Handler"
            direction TB
            Static["Static/ CSS, JS, Images"]:::app
        end
        subgraph "Template Engine"
            direction TB
            Templates["Jinja2 Templates"]:::templates
            Base["base.html"]:::templates
            Layout["layout.html"]:::templates
            Home["home.html"]:::templates
            Products["products.html"]:::templates
            Cart["cart.html"]:::templates
            Login["login.html"]:::templates
            Signup["signup.html"]:::templates
            Success["success.html"]:::templates
            Dashboard["dashboard.html"]:::templates
            Index["index.html"]:::templates
        end
    end

    DB["Relational Database\n(PostgreSQL/MySQL)"]:::db
    Payment["Payment Gateway"]:::external
    Email["Email Service"]:::external
    OAuth["OAuth Provider"]:::external

    Client -->|"GET /, /products, etc."| LoadBalancer
    LoadBalancer -->|"Forwards HTTP"| WSGI
    WSGI -->|"Invokes"| Controllers
    Controllers -->|"renders"| Templates
    Templates -->|"HTML"| Client
    Controllers -->|"serves"| Static
    Static -->|"assets"| Client
    Controllers -->|"read/write"| DB
    Controllers -->|"API: /checkout"| Payment
    Payment -->|"callback"| Controllers
    Controllers -->|"send email"| Email
    Controllers -->|"OAuth auth"| OAuth
    DB -->|"data"| Controllers

    classDef client fill:#85C1E9,stroke:#333,stroke-width:1px;
    classDef infra fill:#D5DBDB,stroke:#333,stroke-width:1px;
    classDef app fill:#82E0AA,stroke:#333,stroke-width:1px;
    classDef templates fill:#F7DC6F,stroke:#333,stroke-width:1px;
    classDef db fill:#F5B041,stroke:#333,stroke-width:1px;
    classDef external fill:#A6ACAF,stroke:#333,stroke-width:1px;

    click App "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/app.py"
    click Static "https://github.com/imtahiriqbal/web-app-tasks/tree/master/Perfume_ecommerce/static/"
    click Templates "https://github.com/imtahiriqbal/web-app-tasks/tree/master/Perfume_ecommerce/templates/"
    click Base "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/base.html"
    click Layout "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/layout.html"
    click Home "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/home.html"
    click Products "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/products.html"
    click Cart "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/cart.html"
    click Login "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/login.html"
    click Signup "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/signup.html"
    click Success "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/success.html"
    click Dashboard "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/dashboard.html"
    click Index "https://github.com/imtahiriqbal/web-app-tasks/blob/master/Perfume_ecommerce/templates/index.html"
```
