# iil-0/taskflow-api architecture

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

- Interactive diagram: https://gitdiagram.com/iil-0/taskflow-api
- Repository: https://github.com/iil-0/taskflow-api

## Overview

TaskFlow is an Express task-management API whose currently wired user workflow is an HTTP request to the health endpoint, with request logging and JSON error handling. Task input validation and JSON-backed task storage are implemented as reusable capabilities, but task routes do not connect them to HTTP yet. The documented data file is not in the supplied tree; its storage relationship is shown from the README. Other edges reflect explicit middleware registration or module references in the excerpts.

Main entry points: [`src/app.js`](https://github.com/iil-0/taskflow-api/blob/main/src/app.js) (Express app), [`src/services/taskService.js`](https://github.com/iil-0/taskflow-api/blob/main/src/services/taskService.js) (Task operations), [`src/taskModel.js`](https://github.com/iil-0/taskflow-api/blob/main/src/taskModel.js) (Task field rules), [`src/middleware/taskValidation.js`](https://github.com/iil-0/taskflow-api/blob/main/src/middleware/taskValidation.js) (Task validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP server"]
  node_app["Express app<br/>[app.js]"]
  node_request_log["Request logger<br/>[logger.js]"]
  node_json_parser["JSON parsing<br/>[app.js]"]
  node_health["Health endpoint<br/>[app.js]"]
  node_not_found["Unknown routes<br/>[notFound.js]"]
  node_error_handler["Error responses<br/>[errorHandler.js]"]
end

subgraph group_domain["Task domain"]
  node_validation["Task validation<br/>[taskValidation.js]"]
  node_task_model["Task field rules<br/>[taskModel.js]"]
end

subgraph group_persistence["Task persistence"]
  node_task_service["Task operations<br/>[taskService.js]"]
  node_task_file[("Task JSON file")]
end

node_client(("HTTP client"))

node_client -->|"sends requests"| node_app
node_app -->|"registers middleware"| node_request_log
node_app -->|"parses JSON"| node_json_parser
node_app -->|"serves health"| node_health
node_app -->|"registers fallback"| node_not_found
node_app -->|"registers errors"| node_error_handler
node_validation -->|"uses field rules"| node_task_model
node_task_service -->|"checks task fields"| node_task_model
node_task_service -->|"reads and writes"| node_task_file

click node_app "https://github.com/iil-0/taskflow-api/blob/main/src/app.js"
click node_request_log "https://github.com/iil-0/taskflow-api/blob/main/src/middleware/logger.js"
click node_json_parser "https://github.com/iil-0/taskflow-api/blob/main/src/app.js"
click node_health "https://github.com/iil-0/taskflow-api/blob/main/src/app.js"
click node_not_found "https://github.com/iil-0/taskflow-api/blob/main/src/middleware/notFound.js"
click node_error_handler "https://github.com/iil-0/taskflow-api/blob/main/src/middleware/errorHandler.js"
click node_validation "https://github.com/iil-0/taskflow-api/blob/main/src/middleware/taskValidation.js"
click node_task_model "https://github.com/iil-0/taskflow-api/blob/main/src/taskModel.js"
click node_task_service "https://github.com/iil-0/taskflow-api/blob/main/src/services/taskService.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,node_request_log,node_json_parser,node_health,node_not_found,node_error_handler,node_client toneBlue
class node_validation,node_task_model toneAmber
class node_task_service,node_task_file toneMint
```

## Components

### HTTP server

- [Express app](https://github.com/iil-0/taskflow-api/blob/main/src/app.js): `src/app.js`
- [Request logger](https://github.com/iil-0/taskflow-api/blob/main/src/middleware/logger.js): `src/middleware/logger.js`
- [JSON parsing](https://github.com/iil-0/taskflow-api/blob/main/src/app.js): `src/app.js`
- [Health endpoint](https://github.com/iil-0/taskflow-api/blob/main/src/app.js): `src/app.js`
- [Unknown routes](https://github.com/iil-0/taskflow-api/blob/main/src/middleware/notFound.js): `src/middleware/notFound.js`
- [Error responses](https://github.com/iil-0/taskflow-api/blob/main/src/middleware/errorHandler.js): `src/middleware/errorHandler.js`

### Task domain

- [Task validation](https://github.com/iil-0/taskflow-api/blob/main/src/middleware/taskValidation.js): `src/middleware/taskValidation.js`
- [Task field rules](https://github.com/iil-0/taskflow-api/blob/main/src/taskModel.js): `src/taskModel.js`

### Task persistence

- [Task operations](https://github.com/iil-0/taskflow-api/blob/main/src/services/taskService.js): `src/services/taskService.js`
- **Task JSON file**

### Other components

- **HTTP client**

## Connections

- HTTP client → Express app: sends requests (evidence: `README.md`)
- Express app → Request logger: registers middleware (evidence: `src/app.js`)
- Express app → JSON parsing: parses JSON (evidence: `src/app.js`)
- Express app → Health endpoint: serves health (evidence: `src/app.js`)
- Express app → Unknown routes: registers fallback (evidence: `src/app.js`)
- Express app → Error responses: registers errors (evidence: `src/app.js`)
- Task validation → Task field rules: uses field rules (evidence: `src/middleware/taskValidation.js`)
- Task operations → Task field rules: checks task fields (evidence: `src/services/taskService.js`)
- Task operations → Task JSON file: reads and writes (evidence: `README.md`)
