# hariharan-2754/garments-workflow architecture

> Architecture diagram of the GitHub repository hariharan-2754/garments-workflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hariharan-2754/garments-workflow
- Repository: https://github.com/hariharan-2754/garments-workflow

## Overview

GarmentFlow is a garment-workflow task management app for administrators and department workers. Administrators manage workers, departments, and tasks; workers view department tasks and submit completion outcomes. The browser clients use a shared API helper to communicate with a FastAPI backend, which applies authentication and persists users, departments, and tasks using MongoDB when configured or a local JSON-backed mock database otherwise. The README excerpt is unreadable, so capability coverage is based on the available tree and source index; unsampled UI behavior and route wiring are not inferred.

Main entry points: [`backend/config/db.py`](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/config/db.py) (Database adapter), [`backend/app.py`](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/app.py) (FastAPI app), [`backend/middleware/auth.py`](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/middleware/auth.py) (Authentication), [`frontend/js/api.js`](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser interface"]
  node_admin["Admin screens<br/>[dashboard.js]"]
  node_assign["Task assignment<br/>[assign-task.js]"]
  node_departments_ui["Department screens<br/>[departments.js]"]
  node_workers_ui["Worker screens<br/>[workers.js]"]
  node_worker_home["Worker task list<br/>[worker-home.js]"]
  node_worker_task["Worker task detail<br/>[worker-task.js]"]
end

subgraph group_api["HTTP and access"]
  node_client_api["API client<br/>[api.js]"]
  node_app["FastAPI app<br/>[app.py]"]
  node_auth["Authentication<br/>[auth.py]"]
end

subgraph group_work["Workflow domains"]
  node_auth_route["Login API<br/>[auth.py]"]
  node_departments_route["Department API<br/>[departments.py]"]
  node_workers_route["Worker API<br/>[workers.py]"]
  node_tasks_route["Task API<br/>[tasks.py]"]
  node_user_model["User data model<br/>[user.py]"]
  node_department_model["Department model<br/>[department.py]"]
  node_task_model["Task data model<br/>[task.py]"]
end

subgraph group_persistence["Configuration and data"]
  node_settings["Runtime settings<br/>[settings.py]"]
  node_db_layer["Database adapter<br/>[db.py]"]
  node_json_store[("Local JSON data<br/>[db.json]")]
end

node_mongo[("MongoDB")]
node_operator(("Admin or worker"))

node_operator -->|"uses"| node_admin
node_operator -->|"uses"| node_worker_home
node_admin -->|"calls"| node_client_api
node_assign -->|"calls"| node_client_api
node_departments_ui -->|"calls"| node_client_api
node_workers_ui -->|"calls"| node_client_api
node_worker_home -->|"calls"| node_client_api
node_worker_task -->|"calls"| node_client_api
node_worker_task -->|"updates status"| node_tasks_route
node_app -->|"loads"| node_settings
node_app -->|"connects"| node_db_layer
node_app -->|"registers"| node_auth_route
node_app -->|"registers"| node_departments_route
node_app -->|"registers"| node_workers_route
node_app -->|"registers"| node_tasks_route
node_auth_route -->|"reads users"| node_db_layer
node_auth_route -->|"creates tokens"| node_auth
node_auth_route -->|"validates input"| node_user_model
node_departments_route -->|"reads and writes"| node_db_layer
node_departments_route -->|"checks access"| node_auth
node_departments_route -->|"validates input"| node_department_model
node_workers_route -->|"reads and writes"| node_db_layer
node_workers_route -->|"checks access"| node_auth
node_workers_route -->|"validates input"| node_user_model
node_tasks_route -->|"reads and writes"| node_db_layer
node_tasks_route -->|"checks access"| node_auth
node_tasks_route -->|"validates status"| node_task_model
node_auth -->|"loads user"| node_db_layer
node_auth -->|"uses JWT settings"| node_settings
node_db_layer -->|"reads and writes"| node_json_store
node_db_layer -.->|"connects optionally"| node_mongo

click node_admin "https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/dashboard.js"
click node_assign "https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/assign-task.js"
click node_departments_ui "https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/departments.js"
click node_workers_ui "https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/workers.js"
click node_worker_home "https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/worker-home.js"
click node_worker_task "https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/worker-task.js"
click node_client_api "https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/api.js"
click node_app "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/app.py"
click node_auth_route "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/auth.py"
click node_departments_route "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/departments.py"
click node_workers_route "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/workers.py"
click node_tasks_route "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/tasks.py"
click node_auth "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/middleware/auth.py"
click node_user_model "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/models/user.py"
click node_department_model "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/models/department.py"
click node_task_model "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/models/task.py"
click node_settings "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/config/settings.py"
click node_db_layer "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/config/db.py"
click node_json_store "https://github.com/hariharan-2754/garments-workflow/blob/main/backend/db.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_admin,node_assign,node_departments_ui,node_workers_ui,node_worker_home,node_worker_task toneBlue
class node_client_api,node_app,node_auth,node_mongo toneAmber
class node_auth_route,node_departments_route,node_workers_route,node_tasks_route,node_user_model,node_department_model,node_task_model toneMint
class node_settings,node_db_layer,node_json_store,node_operator toneRose
```

## Components

### Browser interface

- [Admin screens](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/dashboard.js): `frontend/js/dashboard.js`
- [Task assignment](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/assign-task.js): `frontend/js/assign-task.js`
- [Department screens](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/departments.js): `frontend/js/departments.js`
- [Worker screens](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/workers.js): `frontend/js/workers.js`
- [Worker task list](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/worker-home.js): `frontend/js/worker-home.js`
- [Worker task detail](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/worker-task.js): `frontend/js/worker-task.js`

### HTTP and access

- [API client](https://github.com/hariharan-2754/garments-workflow/blob/main/frontend/js/api.js): `frontend/js/api.js`
- [FastAPI app](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/app.py): `backend/app.py`
- [Authentication](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/middleware/auth.py): `backend/middleware/auth.py`

### Workflow domains

- [Login API](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/auth.py): `backend/routes/auth.py`
- [Department API](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/departments.py): `backend/routes/departments.py`
- [Worker API](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/workers.py): `backend/routes/workers.py`
- [Task API](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/routes/tasks.py): `backend/routes/tasks.py`
- [User data model](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/models/user.py): `backend/models/user.py`
- [Department model](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/models/department.py): `backend/models/department.py`
- [Task data model](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/models/task.py): `backend/models/task.py`

### Configuration and data

- [Runtime settings](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/config/settings.py): `backend/config/settings.py`
- [Database adapter](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/config/db.py): `backend/config/db.py`
- [Local JSON data](https://github.com/hariharan-2754/garments-workflow/blob/main/backend/db.json): `backend/db.json`

### Other components

- **MongoDB**
- **Admin or worker**

## Connections

- Admin or worker → Admin screens: uses
- Admin or worker → Worker task list: uses
- Admin screens → API client: calls (evidence: `frontend/js/dashboard.js`)
- Task assignment → API client: calls (evidence: `frontend/js/assign-task.js`)
- Department screens → API client: calls (evidence: `frontend/js/departments.js`)
- Worker screens → API client: calls (evidence: `frontend/js/workers.js`)
- Worker task list → API client: calls (evidence: `frontend/js/worker-home.js`)
- Worker task detail → API client: calls (evidence: `frontend/js/worker-task.js`)
- Worker task detail → Task API: updates status (evidence: `frontend/js/worker-task.js`)
- FastAPI app → Runtime settings: loads (evidence: `backend/app.py`)
- FastAPI app → Database adapter: connects (evidence: `backend/app.py`)
- FastAPI app → Login API: registers (evidence: `backend/app.py`)
- FastAPI app → Department API: registers (evidence: `backend/app.py`)
- FastAPI app → Worker API: registers (evidence: `backend/app.py`)
- FastAPI app → Task API: registers (evidence: `backend/app.py`)
- Login API → Database adapter: reads users (evidence: `backend/routes/auth.py`)
- Login API → Authentication: creates tokens (evidence: `backend/routes/auth.py`)
- Login API → User data model: validates input (evidence: `backend/routes/auth.py`)
- Department API → Database adapter: reads and writes (evidence: `backend/routes/departments.py`)
- Department API → Authentication: checks access (evidence: `backend/routes/departments.py`)
- Department API → Department model: validates input (evidence: `backend/routes/departments.py`)
- Worker API → Database adapter: reads and writes (evidence: `backend/routes/workers.py`)
- Worker API → Authentication: checks access (evidence: `backend/routes/workers.py`)
- Worker API → User data model: validates input (evidence: `backend/routes/workers.py`)
- Task API → Database adapter: reads and writes (evidence: `backend/routes/tasks.py`)
- Task API → Authentication: checks access (evidence: `backend/routes/tasks.py`)
- Task API → Task data model: validates status (evidence: `backend/routes/tasks.py`)
- Authentication → Database adapter: loads user (evidence: `backend/middleware/auth.py`)
- Authentication → Runtime settings: uses JWT settings (evidence: `backend/middleware/auth.py`)
- Database adapter → Local JSON data: reads and writes (evidence: `backend/config/db.py`)
- Database adapter → MongoDB: connects optionally (evidence: `backend/config/db.py`)
