# creepymemes/barbermanager architecture

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

- Interactive diagram: https://gitdiagram.com/creepymemes/barbermanager
- Repository: https://github.com/creepymemes/barbermanager

## Overview

##### Project Type & Purpose
- Full-stack, containerized web application for barber shop management
- Frontend: React (Vite) SPA served by Nginx
- Backend: Django REST API served by Gunicorn
- Asynchronous tasks via Celery + Redis
- Persistent data in Postgres
- Reverse proxy (Nginx) for HTTPS termination & routing

##### Break Down the File Structure into High-Level Components
- Root: Docker Compose definitions (docker-compose.dev.yml, docker-compose.prod.yml), deploy scripts
- frontend/: Dockerfiles (dev/prod), Nginx config, Vite config, React source (src/)
- backend/: Django project (config/, api/), Celery config, migrations, Dockerfiles, manage.py, tasks.py
- Shared infra: .env, GitHub Actions (CI/CD), docs/

##### Core Components
A. User Agent
– Browser or Mobile Client (HTTP/HTTPS)
B. Reverse Proxy
– Nginx container (nginx.conf at project root) routing to frontend Nginx or Gunicorn
C. Frontend Infrastructure
1. Builder Stage (Vite)
2. Nginx Server Stage serving the compiled React SPA
D. Backend Infrastructure
1. Gunicorn WSGI server
2. Django REST API
3. Django settings split (dev/prod)
E. Asynchronous Processing
1. Celery Worker (api/tasks.py, config/celery.py)
2. Celery-Beat scheduler
F. Datastores & Brokers
1. Postgres database
2. Redis (as Celery broker & cache if used)
G. External Services
– SMTP Email provider (EMAIL_HOST, etc. from .env)
H. CI/CD & Deploy
– GitHub Actions workflows (test.yml, deploy.yml)
– deploy.sh script

##### Relationships & Data Flows
- User → HTTPS → Reverse Proxy
- Reverse Proxy →
– “/static/*” → Frontend Nginx → React SPA
– “/api/*” → Gunicorn → Django REST views
- Django ORM → Postgres (reads/writes)
- API endpoints trigger Celery tasks → Redis
- Celery Worker pulls tasks from Redis → executes business logic → writes to Postgres (e.g., send reminder emails)
- Celery-Beat → scheduled tasks → enqueues into Redis
- Django can also enqueue tasks for Celery Worker or Beat

##### Architectural Patterns & Design Principles
- Containerization: one container per “service” (frontend, backend, celery, beat, db, redis)
- Single-page Application (SPA) consuming REST API
- 12-factor app: configuration via environment variables, separate build/runtime stages
- Layer separation: presentation (React), application/API (Django), data (Postgres), queue (Redis/Celery)
- Dev vs Prod Dockerfiles and Compose files for environment parity

##### Diagramming Recommendations
- Client → Reverse Proxy → Services
- API → DB / Queue
- Queue → Worker → DB / Email
- Green for networking (Nginx, reverse proxy)
- Blue for frontend (Vite, React)
- Dark blue or grey for backend (Gunicorn, Django)
- Orange for message queue (Redis, Celery)
- Purple for data store (Postgres)
– Optionally include port mappings and environment variable references for clarity

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Layer
    subgraph "User Layer"
        User["Browser/Mobile Client"]:::client
    end

    %% Reverse Proxy
    subgraph "Reverse Proxy"
        ReverseProxy["Nginx (nginx.conf)"]:::network
    end

    %% Frontend Infrastructure
    subgraph "Frontend Infrastructure"
        subgraph "Builder Stage"
            FBDev["Dockerfile.dev"]:::frontend
            FBProd["Dockerfile.prod"]:::frontend
            Vite["vite.config.js"]:::frontend
        end
        subgraph "Server Stage"
            FEServer["Nginx (frontend/nginx.conf)"]:::network
            React["React SPA (frontend/src/)"]:::frontend
        end
    end

    %% Backend Infrastructure
    subgraph "Backend Infrastructure"
        subgraph "Docker & Entrypoint"
            BDev["Dockerfile.dev"]:::backend
            BProd["Dockerfile.prod"]:::backend
            Entry["entrypoint.sh"]:::backend
        end
        subgraph "Application Server"
            Gunicorn["Gunicorn WSGI (config/wsgi.py)"]:::backend
            ASGI["ASGI (config/asgi.py)"]:::backend
            DjangoAPI["Django REST API (backend/api/)"]:::backend
            URLs1["API URLs (backend/api/urls/)"]:::backend
            URLs2["Root URLs (backend/config/urls.py)"]:::backend
        end
        subgraph "Settings"
            Base["base.py"]:::backend
            DevS["dev.py"]:::backend
            ProdS["prod.py"]:::backend
        end
    end

    %% Asynchronous Processing
    subgraph "Asynchronous Processing"
        CelConf["celery.py"]:::queue
        Tasks["tasks.py"]:::queue
        Worker["Celery Worker"]:::queue
        Beat["Celery-Beat Scheduler"]:::queue
    end

    %% Data & Brokers
    subgraph "Data & Brokers"
        Postgres["Postgres"]:::db
        Redis["Redis"]:::queue
    end

    %% External Services
    SMTP["SMTP Email Service"]:::external

    %% CI/CD & Infra
    subgraph "CI/CD & Infrastructure"
        ComposeDev["docker-compose.dev.yml"]:::infra
        ComposeProd["docker-compose.prod.yml"]:::infra
        Env[".env.example"]:::infra
        TestWF["test.yml"]:::infra
        DeployWF["deploy.yml"]:::infra
        DeployScript["deploy.sh"]:::infra
        Docs["docs/"]:::infra
        DocsReadme["docs/README.md"]:::infra
        Gitignore[".gitignore"]:::infra
        VSCode[".vscode/"]:::infra
    end

    %% Connections
    User -->|"HTTPS"| ReverseProxy
    ReverseProxy -->|"GET /static/*"| FEServer
    FEServer --> React
    ReverseProxy -->|"GET /api/*"| Gunicorn
    Gunicorn --> DjangoAPI
    DjangoAPI -->|"ORM"| Postgres
    DjangoAPI -->|"enqueue tasks"| Redis
    DjangoAPI -->|"load URLs"| URLs1
    URLs1 --> URLs2
    Redis --> Worker
    Worker -->|"process tasks"| Postgres
    Worker -->|"send emails"| SMTP
    Beat --> Redis

    %% CI/CD & Infra connections
    ComposeDev --> FBDev
    ComposeDev --> BDev
    ComposeDev --> Redis
    ComposeDev --> Postgres
    ComposeProd --> FBProd
    ComposeProd --> BProd
    Env --> FBDev
    Env --> BDev
    TestWF --> ComposeDev
    DeployWF --> ComposeProd
    DeployScript --> ComposeProd
    Docs --> DocsReadme

    %% Click Events
    click ReverseProxy "https://github.com/creepymemes/barbermanager/blob/master/nginx.conf"
    click FBDev "https://github.com/creepymemes/barbermanager/blob/master/frontend/Dockerfile.dev"
    click FBProd "https://github.com/creepymemes/barbermanager/blob/master/frontend/Dockerfile.prod"
    click Vite "https://github.com/creepymemes/barbermanager/blob/master/frontend/vite.config.js"
    click FEServer "https://github.com/creepymemes/barbermanager/blob/master/frontend/nginx.conf"
    click React "https://github.com/creepymemes/barbermanager/tree/master/frontend/src/"
    click BDev "https://github.com/creepymemes/barbermanager/blob/master/backend/Dockerfile.dev"
    click BProd "https://github.com/creepymemes/barbermanager/blob/master/backend/Dockerfile.prod"
    click Entry "https://github.com/creepymemes/barbermanager/blob/master/backend/entrypoint.sh"
    click Gunicorn "https://github.com/creepymemes/barbermanager/blob/master/backend/config/wsgi.py"
    click ASGI "https://github.com/creepymemes/barbermanager/blob/master/backend/config/asgi.py"
    click DjangoAPI "https://github.com/creepymemes/barbermanager/tree/master/backend/api/"
    click URLs1 "https://github.com/creepymemes/barbermanager/tree/master/backend/api/urls/"
    click URLs2 "https://github.com/creepymemes/barbermanager/blob/master/backend/config/urls.py"
    click Base "https://github.com/creepymemes/barbermanager/blob/master/backend/config/settings/base.py"
    click DevS "https://github.com/creepymemes/barbermanager/blob/master/backend/config/settings/dev.py"
    click ProdS "https://github.com/creepymemes/barbermanager/blob/master/backend/config/settings/prod.py"
    click CelConf "https://github.com/creepymemes/barbermanager/blob/master/backend/config/celery.py"
    click Tasks "https://github.com/creepymemes/barbermanager/blob/master/backend/api/tasks.py"
    click Postgres "https://github.com/creepymemes/barbermanager/blob/master/docker-compose.dev.yml"
    click Redis "https://github.com/creepymemes/barbermanager/blob/master/docker-compose.dev.yml"
    click Env "https://github.com/creepymemes/barbermanager/blob/master/.env.example"
    click TestWF "https://github.com/creepymemes/barbermanager/blob/master/.github/workflows/test.yml"
    click DeployWF "https://github.com/creepymemes/barbermanager/blob/master/.github/workflows/deploy.yml"
    click DeployScript "https://github.com/creepymemes/barbermanager/blob/master/deploy.sh"
    click Docs "https://github.com/creepymemes/barbermanager/tree/master/docs/"
    click DocsReadme "https://github.com/creepymemes/barbermanager/blob/master/docs/README.md"
    click Gitignore "https://github.com/creepymemes/barbermanager/blob/master/.gitignore"
    click VSCode "https://github.com/creepymemes/barbermanager/tree/master/.vscode/"
    click ComposeDev "https://github.com/creepymemes/barbermanager/blob/master/docker-compose.dev.yml"
    click ComposeProd "https://github.com/creepymemes/barbermanager/blob/master/docker-compose.prod.yml"

    %% Styles
    classDef client fill:#e3f2fd,stroke:#2196f3,color:#0d47a1
    classDef network fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
    classDef frontend fill:#e3f2fd,stroke:#1e88e5,color:#0d47a1
    classDef backend fill:#cfd8dc,stroke:#455a64,color:#263238
    classDef queue fill:#fff3e0,stroke:#fb8c00,color:#e65100
    classDef db fill:#f3e5f5,stroke:#6a1b9a,color:#4a148c
    classDef external fill:#ffebee,stroke:#c62828,color:#b71c1c
    classDef infra fill:#eceff1,stroke:#607d8b,color:#37474f
```
