# qaziong/todo-list architecture

> Architecture diagram of the GitHub repository qaziong/todo-list, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qaziong/todo-list
- Repository: https://github.com/qaziong/todo-list

## Overview

This is a personal task-management application with a React client and an Express API. Users sign up or log in, then create, view, update, complete, and delete tasks; task records may include uploaded or remotely imported images. The client calls the API directly, while the server routes requests through authentication, validation, controllers, services, repositories, and MySQL models. The graph also captures account/session handling and image processing. Some capabilities are documented only by the source index, so their internal relationships are omitted where excerpts do not establish them.

Main entry points: [`frontend/src/App.tsx`](https://github.com/qaziong/todo-list/blob/main/frontend/src/App.tsx) (Workspace UI), [`server/src/routes/task.routes.js`](https://github.com/qaziong/todo-list/blob/main/server/src/routes/task.routes.js) (Task routes), [`server/src/routes/auth.routes.js`](https://github.com/qaziong/todo-list/blob/main/server/src/routes/auth.routes.js) (Auth routes), [`server/src/controllers/auth.controller.js`](https://github.com/qaziong/todo-list/blob/main/server/src/controllers/auth.controller.js) (Auth controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Task client"]
  node_app_ui["Workspace UI<br/>[App.tsx]"]
  node_task_form["Task form<br/>[TaskForm.tsx]"]
  node_task_list["Task list<br/>[TaskList.tsx]"]
  node_task_item["Task item<br/>[TaskItem.tsx]"]
  node_login_form["Login form<br/>[loginForm.tsx]"]
  node_signup_form["Signup form<br/>[singupForm.tsx]"]
end

subgraph group_api["API and auth"]
  node_api_routes["API router<br/>[index.routes.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_task_routes["Task routes<br/>[task.routes.js]"]
  node_auth_controller["Auth controller<br/>[auth.controller.js]"]
  node_task_controller["Task controller<br/>[task.controller.js]"]
  node_auth_middleware["Authentication<br/>[authenticate.js]"]
  node_validation_middleware["Validation middleware<br/>[validate.js]"]
  node_auth_validation["Auth schemas<br/>[auth.validator.js]"]
  node_task_validation["Task schema<br/>[task.validator.js]"]
  node_app_server["Express app<br/>[app.js]"]
end

subgraph group_domain["Task domain"]
  node_auth_service["Auth service<br/>[auth.services.js]"]
  node_task_service["Task service<br/>[task.services.js]"]
end

subgraph group_persistence["Persistence and images"]
  node_user_repo["User repository<br/>[user.repository.js]"]
  node_task_repo["Task repository<br/>[task.repository.js]"]
  node_user_model["User model<br/>[user.model.js]"]
  node_task_model["Task model<br/>[task.model.js]"]
  node_mysql[("MySQL database")]
  node_image_upload["Image upload<br/>[upload.js]"]
  node_image_service["Image service<br/>[image.services.js]"]
  node_image_format["Image format detection<br/>[image-format.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_app_ui
node_app_ui -->|"renders"| node_task_form
node_app_ui -->|"renders"| node_task_list
node_task_list -->|"renders"| node_task_item
node_app_ui -->|"renders"| node_login_form
node_app_ui -->|"renders"| node_signup_form
node_app_ui -->|"calls task and auth API"| node_api_routes
node_app_server -->|"mounts"| node_api_routes
node_api_routes -->|"dispatches"| node_auth_routes
node_api_routes -->|"dispatches"| node_task_routes
node_auth_routes -->|"routes to"| node_auth_controller
node_auth_routes -->|"validates with"| node_validation_middleware
node_auth_routes -->|"uses schemas"| node_auth_validation
node_auth_routes -->|"requires auth"| node_auth_middleware
node_task_routes -->|"requires auth"| node_auth_middleware
node_task_routes -->|"validates with"| node_validation_middleware
node_task_routes -->|"uses schema"| node_task_validation
node_task_routes -->|"parses uploads"| node_image_upload
node_task_routes -->|"routes to"| node_task_controller
node_auth_controller -->|"authenticates through"| node_auth_service
node_auth_controller -->|"looks up user"| node_user_repo
node_auth_controller -->|"imports schema"| node_auth_validation
node_auth_controller -.->|"sets session for"| node_user
node_auth_service -->|"reads and creates"| node_user_repo
node_auth_middleware -->|"loads user"| node_user_repo
node_task_controller -->|"runs task operations"| node_task_service
node_task_controller -->|"imports and removes images"| node_image_service
node_task_service -->|"runs task queries"| node_task_repo
node_task_service -->|"uses user repository"| node_user_repo
node_user_repo -->|"queries"| node_user_model
node_task_repo -->|"queries"| node_task_model
node_user_model -.->|"persists to"| node_mysql
node_task_model -.->|"persists to"| node_mysql
node_image_upload -->|"checks file content"| node_image_format
node_image_service -->|"detects formats"| node_image_format
node_image_service -->|"uses upload directory"| node_image_upload

click node_app_ui "https://github.com/qaziong/todo-list/blob/main/frontend/src/App.tsx"
click node_task_form "https://github.com/qaziong/todo-list/blob/main/frontend/src/components/TaskForm.tsx"
click node_task_list "https://github.com/qaziong/todo-list/blob/main/frontend/src/components/TaskList.tsx"
click node_task_item "https://github.com/qaziong/todo-list/blob/main/frontend/src/components/TaskItem.tsx"
click node_login_form "https://github.com/qaziong/todo-list/blob/main/frontend/src/components/login/loginForm.tsx"
click node_signup_form "https://github.com/qaziong/todo-list/blob/main/frontend/src/components/signup/singupForm.tsx"
click node_api_routes "https://github.com/qaziong/todo-list/blob/main/server/src/routes/index.routes.js"
click node_auth_routes "https://github.com/qaziong/todo-list/blob/main/server/src/routes/auth.routes.js"
click node_task_routes "https://github.com/qaziong/todo-list/blob/main/server/src/routes/task.routes.js"
click node_auth_controller "https://github.com/qaziong/todo-list/blob/main/server/src/controllers/auth.controller.js"
click node_task_controller "https://github.com/qaziong/todo-list/blob/main/server/src/controllers/task.controller.js"
click node_auth_middleware "https://github.com/qaziong/todo-list/blob/main/server/src/middleware/authenticate.js"
click node_validation_middleware "https://github.com/qaziong/todo-list/blob/main/server/src/middleware/validate.js"
click node_auth_validation "https://github.com/qaziong/todo-list/blob/main/server/src/validators/auth.validator.js"
click node_task_validation "https://github.com/qaziong/todo-list/blob/main/server/src/validators/task.validator.js"
click node_auth_service "https://github.com/qaziong/todo-list/blob/main/server/src/services/auth.services.js"
click node_task_service "https://github.com/qaziong/todo-list/blob/main/server/src/services/task.services.js"
click node_user_repo "https://github.com/qaziong/todo-list/blob/main/server/src/repositories/user.repository.js"
click node_task_repo "https://github.com/qaziong/todo-list/blob/main/server/src/repositories/task.repository.js"
click node_user_model "https://github.com/qaziong/todo-list/blob/main/server/src/models/user.model.js"
click node_task_model "https://github.com/qaziong/todo-list/blob/main/server/src/models/task.model.js"
click node_image_upload "https://github.com/qaziong/todo-list/blob/main/server/src/middleware/upload.js"
click node_image_service "https://github.com/qaziong/todo-list/blob/main/server/src/services/image.services.js"
click node_image_format "https://github.com/qaziong/todo-list/blob/main/server/src/utils/image-format.js"
click node_app_server "https://github.com/qaziong/todo-list/blob/main/server/src/app.js"

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_app_ui,node_task_form,node_task_list,node_task_item,node_login_form,node_signup_form,node_user toneBlue
class node_api_routes,node_auth_routes,node_task_routes,node_auth_controller,node_task_controller,node_auth_middleware,node_validation_middleware,node_auth_validation,node_task_validation,node_app_server toneAmber
class node_auth_service,node_task_service toneMint
class node_user_repo,node_task_repo,node_user_model,node_task_model,node_mysql,node_image_upload,node_image_service,node_image_format toneRose
```

## Components

### Task client

- [Workspace UI](https://github.com/qaziong/todo-list/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Task form](https://github.com/qaziong/todo-list/blob/main/frontend/src/components/TaskForm.tsx): `frontend/src/components/TaskForm.tsx`
- [Task list](https://github.com/qaziong/todo-list/blob/main/frontend/src/components/TaskList.tsx): `frontend/src/components/TaskList.tsx`
- [Task item](https://github.com/qaziong/todo-list/blob/main/frontend/src/components/TaskItem.tsx): `frontend/src/components/TaskItem.tsx`
- [Login form](https://github.com/qaziong/todo-list/blob/main/frontend/src/components/login/loginForm.tsx): `frontend/src/components/login/loginForm.tsx`
- [Signup form](https://github.com/qaziong/todo-list/blob/main/frontend/src/components/signup/singupForm.tsx): `frontend/src/components/signup/singupForm.tsx`

### API and auth

- [API router](https://github.com/qaziong/todo-list/blob/main/server/src/routes/index.routes.js): `server/src/routes/index.routes.js`
- [Auth routes](https://github.com/qaziong/todo-list/blob/main/server/src/routes/auth.routes.js): `server/src/routes/auth.routes.js`
- [Task routes](https://github.com/qaziong/todo-list/blob/main/server/src/routes/task.routes.js): `server/src/routes/task.routes.js`
- [Auth controller](https://github.com/qaziong/todo-list/blob/main/server/src/controllers/auth.controller.js): `server/src/controllers/auth.controller.js`
- [Task controller](https://github.com/qaziong/todo-list/blob/main/server/src/controllers/task.controller.js): `server/src/controllers/task.controller.js`
- [Authentication](https://github.com/qaziong/todo-list/blob/main/server/src/middleware/authenticate.js): `server/src/middleware/authenticate.js`
- [Validation middleware](https://github.com/qaziong/todo-list/blob/main/server/src/middleware/validate.js): `server/src/middleware/validate.js`
- [Auth schemas](https://github.com/qaziong/todo-list/blob/main/server/src/validators/auth.validator.js): `server/src/validators/auth.validator.js`
- [Task schema](https://github.com/qaziong/todo-list/blob/main/server/src/validators/task.validator.js): `server/src/validators/task.validator.js`
- [Express app](https://github.com/qaziong/todo-list/blob/main/server/src/app.js): `server/src/app.js`

### Task domain

- [Auth service](https://github.com/qaziong/todo-list/blob/main/server/src/services/auth.services.js): `server/src/services/auth.services.js`
- [Task service](https://github.com/qaziong/todo-list/blob/main/server/src/services/task.services.js): `server/src/services/task.services.js`

### Persistence and images

- [User repository](https://github.com/qaziong/todo-list/blob/main/server/src/repositories/user.repository.js): `server/src/repositories/user.repository.js`
- [Task repository](https://github.com/qaziong/todo-list/blob/main/server/src/repositories/task.repository.js): `server/src/repositories/task.repository.js`
- [User model](https://github.com/qaziong/todo-list/blob/main/server/src/models/user.model.js): `server/src/models/user.model.js`
- [Task model](https://github.com/qaziong/todo-list/blob/main/server/src/models/task.model.js): `server/src/models/task.model.js`
- **MySQL database**
- [Image upload](https://github.com/qaziong/todo-list/blob/main/server/src/middleware/upload.js): `server/src/middleware/upload.js`
- [Image service](https://github.com/qaziong/todo-list/blob/main/server/src/services/image.services.js): `server/src/services/image.services.js`
- [Image format detection](https://github.com/qaziong/todo-list/blob/main/server/src/utils/image-format.js): `server/src/utils/image-format.js`

### Other components

- **User**

## Connections

- User → Workspace UI: uses
- Workspace UI → Task form: renders (evidence: `frontend/src/App.tsx`)
- Workspace UI → Task list: renders (evidence: `frontend/src/App.tsx`)
- Task list → Task item: renders (evidence: `frontend/src/components/TaskList.tsx`)
- Workspace UI → Login form: renders (evidence: `frontend/src/App.tsx`)
- Workspace UI → Signup form: renders (evidence: `frontend/src/App.tsx`)
- Workspace UI → API router: calls task and auth API (evidence: `frontend/src/App.tsx`)
- Express app → API router: mounts (evidence: `server/src/app.js`)
- API router → Auth routes: dispatches (evidence: `server/src/routes/index.routes.js`)
- API router → Task routes: dispatches (evidence: `server/src/routes/index.routes.js`)
- Auth routes → Auth controller: routes to (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Validation middleware: validates with (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Auth schemas: uses schemas (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Authentication: requires auth (evidence: `server/src/routes/auth.routes.js`)
- Task routes → Authentication: requires auth (evidence: `server/src/routes/task.routes.js`)
- Task routes → Validation middleware: validates with (evidence: `server/src/routes/task.routes.js`)
- Task routes → Task schema: uses schema (evidence: `server/src/routes/task.routes.js`)
- Task routes → Image upload: parses uploads (evidence: `server/src/routes/task.routes.js`)
- Task routes → Task controller: routes to (evidence: `server/src/routes/task.routes.js`)
- Auth controller → Auth service: authenticates through (evidence: `server/src/controllers/auth.controller.js`)
- Auth controller → User repository: looks up user (evidence: `server/src/controllers/auth.controller.js`)
- Auth controller → Auth schemas: imports schema (evidence: `server/src/controllers/auth.controller.js`)
- Auth controller → User: sets session for
- Auth service → User repository: reads and creates (evidence: `server/src/services/auth.services.js`)
- Authentication → User repository: loads user (evidence: `server/src/middleware/authenticate.js`)
- Task controller → Task service: runs task operations (evidence: `server/src/controllers/task.controller.js`)
- Task controller → Image service: imports and removes images (evidence: `server/src/controllers/task.controller.js`)
- Task service → Task repository: runs task queries (evidence: `server/src/services/task.services.js`)
- Task service → User repository: uses user repository (evidence: `server/src/services/task.services.js`)
- User repository → User model: queries (evidence: `server/src/repositories/user.repository.js`)
- Task repository → Task model: queries (evidence: `server/src/repositories/task.repository.js`)
- User model → MySQL database: persists to
- Task model → MySQL database: persists to
- Image upload → Image format detection: checks file content (evidence: `server/src/middleware/upload.js`)
- Image service → Image format detection: detects formats (evidence: `server/src/services/image.services.js`)
- Image service → Image upload: uses upload directory (evidence: `server/src/services/image.services.js`)
