# mirzafahmi/ezadmin architecture

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

- Interactive diagram: https://gitdiagram.com/mirzafahmi/ezadmin
- Repository: https://github.com/mirzafahmi/ezadmin

## Overview

##### Project type and purpose
- ezAdmin is a full-stack web application built with Django (Python) on the backend, SQLite for data storage, and a classic HTML/CSS/JavaScript/Bootstrap frontend. It provides a centralized administrative dashboard covering inventory (store), production, purchasing, office equipment management, user profiles, and miscellaneous utilities.

##### File structure
- Top-level directories:
- ezAdmin/ezAdmin – Django project configuration (settings.py, wsgi.py, asgi.py, celery.py, urls.py)
- apps: dashboard, user, store, production, purchasing, misc, office
- static/ – CSS, JS, images, third-party package.json & node_modules
- media/ – user-uploaded files (agreements, invoices, profile_images, etc.)
- templates/ – per-app and shared HTML templates
- db.sqlite3 – embedded database
- celery.py & tasks/ – background job processing
- Patterns & infrastructure:
- Django’s MTV (model-template-view) structure per app
- Celery integration for asynchronous tasks
- Static file pipeline for CSS/JS, served by Django (or AWS in production)
- Media file storage on local filesystem (or S3 in production via settings)

##### README insights
- Lists five main apps and their models
- Describes core functionality: CRUD dashboards, document upload/download, production logs, inter-model interactions
- Mentions AWS hosting potential

##### Detail without overthinking
- Celery asynchronous layer and static/media pipelines
- Clear data flow, especially where uploads/downloads and background jobs occur

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["Client Browser<br/>(Desktop/Mobile)"]:::frontend
        StaticAssets["Static Assets<br/>(CSS/JS/Images)"]:::static
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        DjangoServer["Django ASGI/WSGI Server"]:::django
        subgraph "Django Core"
            direction TB
            URLRouter["URL Router & Middleware"]:::django
            ViewsTemplates["Views & Template Engine"]:::django
            ModelsORM["Models & ORM"]:::django
        end
        subgraph "Celery Layer"
            direction TB
            CeleryBroker["Celery Broker<br/>(Redis/RabbitMQ)"]:::external
            CeleryWorker["Celery Worker"]:::external
        end
    end

    %% External Services & Storage
    Database["SQLite Database<br/>(or RDS)"]:::storage
    MediaStorage["Media Storage<br/>(Local FS or S3)"]:::storage
    ExternalServices["External Services<br/>(Email/SMS/AWS)"]:::external

    %% App Modules inside Django Core
    subgraph "Django Apps"
        direction TB
        DashboardApp["Dashboard App"]:::app
        UserApp["User Management App"]:::app
        StoreApp["Store (Inventory) App"]:::app
        ProductionApp["Production App"]:::app
        PurchasingApp["Purchasing App"]:::app
        OfficeApp["Office Equipment App"]:::app
        MiscApp["Misc Utilities App"]:::app
        Mixins["Mixins<br/>(Shared Utilities)"]:::django
    end

    %% Connections
    Browser -->|HTTP/HTTPS GET/POST| DjangoServer
    StaticAssets -->|Served via Django/CDN| DjangoServer
    DjangoServer -->|Routes requests| URLRouter
    URLRouter -->|Invokes| ViewsTemplates
    ViewsTemplates -->|Uses| ModelsORM
    ViewsTemplates -->|Renders| Browser
    ModelsORM -->|Read/Write ORM| Database
    ViewsTemplates -->|File I/O| MediaStorage
    URLRouter -->|Dispatches tasks| CeleryBroker
    CeleryBroker -->|Queue jobs| CeleryWorker
    CeleryWorker -->|Updates| Database
    DjangoServer -->|Integrates| ExternalServices

    %% App Modules Relations
    URLRouter --> DashboardApp
    URLRouter --> UserApp
    URLRouter --> StoreApp
    URLRouter --> ProductionApp
    URLRouter --> PurchasingApp
    URLRouter --> OfficeApp
    URLRouter --> MiscApp
    ViewsTemplates --> DashboardApp
    ViewsTemplates --> UserApp
    ViewsTemplates --> StoreApp
    ViewsTemplates --> ProductionApp
    ViewsTemplates --> PurchasingApp
    ViewsTemplates --> OfficeApp
    ViewsTemplates --> MiscApp
    ModelsORM --> DashboardApp
    ModelsORM --> UserApp
    ModelsORM --> StoreApp
    ModelsORM --> ProductionApp
    ModelsORM --> PurchasingApp
    ModelsORM --> OfficeApp
    ModelsORM --> MiscApp
    ViewsTemplates --> Mixins
    ModelsORM --> Mixins

    %% Click Events for Component Mapping
    click DjangoServer "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/ezAdmin/asgi.py"
    click DjangoServer "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/ezAdmin/wsgi.py"
    click DjangoServer "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/ezAdmin/celery.py"
    click URLRouter "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/ezAdmin/urls.py"
    click Mixins "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/mixins/file_size_mixin.py"
    click Mixins "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/mixins/validation_mixin.py"
    click Mixins "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/mixins/modify_case_fields_mixin.py"
    click DashboardApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/dashboard/urls.py"
    click DashboardApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/dashboard/views.py"
    click DashboardApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/dashboard/middleware.py"
    click DashboardApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/dashboard/models.py"
    click DashboardApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/dashboard/admin.py"
    click UserApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/user/urls.py"
    click UserApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/user/views.py"
    click UserApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/user/forms.py"
    click UserApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/user/models.py"
    click UserApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/user/signals.py"
    click StoreApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/store/urls.py"
    click StoreApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/store/views.py"
    click StoreApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/store/models.py"
    click StoreApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/store/forms.py"
    click ProductionApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/production/urls.py"
    click ProductionApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/production/views.py"
    click ProductionApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/production/models.py"
    click ProductionApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/production/forms.py"
    click PurchasingApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/purchasing/urls.py"
    click PurchasingApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/purchasing/views.py"
    click PurchasingApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/purchasing/models.py"
    click PurchasingApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/purchasing/forms.py"
    click OfficeApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/office/urls.py"
    click OfficeApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/office/views.py"
    click OfficeApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/office/models.py"
    click OfficeApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/office/forms.py"
    click MiscApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/misc/urls.py"
    click MiscApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/misc/views.py"
    click MiscApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/misc/models.py"
    click MiscApp "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/misc/forms.py"
    click CeleryWorker "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/ezAdmin/tasks/tasks.py"
    click Database "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/db.sqlite3"
    click StaticAssets "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/static/css/"
    click StaticAssets "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/static/js/"
    click StaticAssets "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/static/img/"
    click StaticAssets "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/static/node_modules/"
    click MediaStorage "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/media/profile_images/"
    click MediaStorage "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/media/office/agreement/"
    click MediaStorage "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/media/office/purchasing_documents/"
    click MediaStorage "https://github.com/mirzafahmi/ezadmin/tree/main/ezAdmin/media/purchasing_documents/"
    click mixins "https://github.com/mirzafahmi/ezadmin/blob/main/ezAdmin/requirements.txt"
    click mixins "https://github.com/mirzafahmi/ezadmin/blob/main/README.md"

    %% Styles
    classDef frontend fill:#D6E9FE,stroke:#2B6CB0,color:#2B6CB0;
    classDef django fill:#E8F1FF,stroke:#2C5282,color:#2C5282;
    classDef static fill:#F0F9E8,stroke:#2F855A,color:#2F855A;
    classDef storage fill:#E3FDFD,stroke:#319795,color:#319795;
    classDef external fill:#FFF5E5,stroke:#DD6B20,color:#DD6B20;
    classDef app fill:#EBF4FF,stroke:#2B6CB0,color:#2B6CB0;
```
