# froov30/task-tracker-rest-api architecture

> Architecture diagram of the GitHub repository froov30/task-tracker-rest-api, 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/froov30/task-tracker-rest-api
- Repository: https://github.com/froov30/task-tracker-rest-api

## Overview

Task Tracker is a multi-user REST API. Clients register or authenticate, then manage only their own tasks through a versioned HTTP API; task operations enforce ownership, lifecycle transitions, and optimistic concurrency, with mutations recorded in an audit trail. The main internal layers are routers, services, and repositories, backed by async SQLAlchemy models and PostgreSQL. The README documents rate limiting, structured request logging, health probes, pagination/filtering/sorting, soft-delete restoration, and migrations. Some subsystem links below rely on README statements because their implementations were not excerpted.

Main entry points: [`app/main.py`](https://github.com/froov30/task-tracker-rest-api/blob/main/app/main.py) (FastAPI App), [`app/dependencies.py`](https://github.com/froov30/task-tracker-rest-api/blob/main/app/dependencies.py) (Dependency Wiring), [`app/services/auth_service.py`](https://github.com/froov30/task-tracker-rest-api/blob/main/app/services/auth_service.py) (Auth Service), [`app/routers/tasks.py`](https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/tasks.py) (Task Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_application["FastAPI App<br/>[main.py]"]
  node_task_routes["Task Routes<br/>[tasks.py]"]
  node_auth_routes["Auth Routes<br/>[auth.py]"]
  node_user_routes["User Routes<br/>[users.py]"]
  node_health_routes["Health Probes<br/>[health.py]"]
  node_legacy_routes["Legacy Redirects"]
  node_api_schemas["API Schemas"]
  node_dependencies["Dependency Wiring<br/>[dependencies.py]"]
end

subgraph group_business["Business Services"]
  node_task_service["Task Service<br/>[task_service.py]"]
  node_auth_service["Auth Service<br/>[auth_service.py]"]
  node_security["JWT Security<br/>[security.py]"]
end

subgraph group_persistence["Persistence"]
  node_task_repository["Task Repository<br/>[task_repository.py]"]
  node_user_repository["User Repository<br/>[user_repository.py]"]
  node_history_repository["History Repository"]
  node_orm["ORM Models<br/>[orm.py]"]
  node_database["DB Sessions<br/>[database.py]"]
end

subgraph group_operations["Request Operations"]
  node_rate_limit["Rate Limiting<br/>[rate_limit.py]"]
  node_middleware["Request Middleware<br/>[middleware.py]"]
  node_logging["Structured Logging<br/>[logging_config.py]"]
  node_error_handlers["Error Responses<br/>[error_handlers.py]"]
  node_configuration["Settings<br/>[config.py]"]
end

node_client(("HTTP Client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_application
node_application -->|"registers limiter"| node_rate_limit
node_application -->|"installs middleware"| node_middleware
node_middleware -->|"uses logging"| node_logging
node_application -->|"configures logging"| node_logging
node_application -->|"registers handlers"| node_error_handlers
node_error_handlers -->|"formats errors"| node_api_schemas
node_application -->|"registers routes"| node_task_routes
node_application -->|"registers routes"| node_auth_routes
node_application -->|"registers routes"| node_user_routes
node_application -->|"registers routes"| node_health_routes
node_application -->|"registers routes"| node_legacy_routes
node_task_routes -->|"requests dependencies"| node_dependencies
node_auth_routes -->|"calls service"| node_auth_service
node_task_routes -->|"calls service"| node_task_service
node_user_routes -->|"uses dependencies"| node_dependencies
node_dependencies -->|"injects sessions"| node_database
node_dependencies -->|"constructs service"| node_task_service
node_dependencies -->|"constructs service"| node_auth_service
node_dependencies -->|"constructs repository"| node_task_repository
node_dependencies -->|"constructs repository"| node_user_repository
node_dependencies -->|"constructs repository"| node_history_repository
node_dependencies -->|"resolves user"| node_auth_service
node_task_service -->|"queries tasks"| node_task_repository
node_task_service -->|"records audit"| node_history_repository
node_auth_service -->|"queries users"| node_user_repository
node_auth_service -->|"hashes and validates tokens"| node_security
node_task_repository -->|"queries models"| node_orm
node_user_repository -->|"queries models"| node_orm
node_history_repository -->|"queries models"| node_orm
node_database -->|"connects to"| node_postgres
node_orm -->|"maps persisted tables"| node_postgres
node_rate_limit -->|"reads limits"| node_configuration
node_security -->|"reads JWT settings"| node_configuration
node_health_routes -->|"checks readiness"| node_database
node_health_routes -->|"reports limiter"| node_rate_limit
node_task_routes -->|"validates task payloads"| node_api_schemas

click node_application "https://github.com/froov30/task-tracker-rest-api/blob/main/app/main.py"
click node_task_routes "https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/tasks.py"
click node_auth_routes "https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/auth.py"
click node_user_routes "https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/users.py"
click node_health_routes "https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/health.py"
click node_legacy_routes "https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/legacy_redirects.py"
click node_api_schemas "https://github.com/froov30/task-tracker-rest-api/tree/main/app/schemas"
click node_task_service "https://github.com/froov30/task-tracker-rest-api/blob/main/app/services/task_service.py"
click node_auth_service "https://github.com/froov30/task-tracker-rest-api/blob/main/app/services/auth_service.py"
click node_security "https://github.com/froov30/task-tracker-rest-api/blob/main/app/security.py"
click node_task_repository "https://github.com/froov30/task-tracker-rest-api/blob/main/app/repositories/task_repository.py"
click node_user_repository "https://github.com/froov30/task-tracker-rest-api/blob/main/app/repositories/user_repository.py"
click node_history_repository "https://github.com/froov30/task-tracker-rest-api/blob/main/app/repositories/history_repository.py"
click node_orm "https://github.com/froov30/task-tracker-rest-api/blob/main/app/models/orm.py"
click node_database "https://github.com/froov30/task-tracker-rest-api/blob/main/app/database.py"
click node_dependencies "https://github.com/froov30/task-tracker-rest-api/blob/main/app/dependencies.py"
click node_rate_limit "https://github.com/froov30/task-tracker-rest-api/blob/main/app/rate_limit.py"
click node_middleware "https://github.com/froov30/task-tracker-rest-api/blob/main/app/middleware.py"
click node_logging "https://github.com/froov30/task-tracker-rest-api/blob/main/app/logging_config.py"
click node_error_handlers "https://github.com/froov30/task-tracker-rest-api/blob/main/app/error_handlers.py"
click node_configuration "https://github.com/froov30/task-tracker-rest-api/blob/main/app/config.py"

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_application,node_task_routes,node_auth_routes,node_user_routes,node_health_routes,node_legacy_routes,node_api_schemas,node_dependencies,node_client toneBlue
class node_task_service,node_auth_service,node_security,node_postgres toneAmber
class node_task_repository,node_user_repository,node_history_repository,node_orm,node_database toneMint
class node_rate_limit,node_middleware,node_logging,node_error_handlers,node_configuration toneRose
```

## Components

### HTTP API

- [FastAPI App](https://github.com/froov30/task-tracker-rest-api/blob/main/app/main.py): `app/main.py`
- [Task Routes](https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/tasks.py): `app/routers/tasks.py`
- [Auth Routes](https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/auth.py): `app/routers/auth.py`
- [User Routes](https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/users.py): `app/routers/users.py`
- [Health Probes](https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/health.py): `app/routers/health.py`
- [Legacy Redirects](https://github.com/froov30/task-tracker-rest-api/blob/main/app/routers/legacy_redirects.py): `app/routers/legacy_redirects.py`
- [API Schemas](https://github.com/froov30/task-tracker-rest-api/tree/main/app/schemas): `app/schemas`
- [Dependency Wiring](https://github.com/froov30/task-tracker-rest-api/blob/main/app/dependencies.py): `app/dependencies.py`

### Business Services

- [Task Service](https://github.com/froov30/task-tracker-rest-api/blob/main/app/services/task_service.py): `app/services/task_service.py`
- [Auth Service](https://github.com/froov30/task-tracker-rest-api/blob/main/app/services/auth_service.py): `app/services/auth_service.py`
- [JWT Security](https://github.com/froov30/task-tracker-rest-api/blob/main/app/security.py): `app/security.py`

### Persistence

- [Task Repository](https://github.com/froov30/task-tracker-rest-api/blob/main/app/repositories/task_repository.py): `app/repositories/task_repository.py`
- [User Repository](https://github.com/froov30/task-tracker-rest-api/blob/main/app/repositories/user_repository.py): `app/repositories/user_repository.py`
- [History Repository](https://github.com/froov30/task-tracker-rest-api/blob/main/app/repositories/history_repository.py): `app/repositories/history_repository.py`
- [ORM Models](https://github.com/froov30/task-tracker-rest-api/blob/main/app/models/orm.py): `app/models/orm.py`
- [DB Sessions](https://github.com/froov30/task-tracker-rest-api/blob/main/app/database.py): `app/database.py`

### Request Operations

- [Rate Limiting](https://github.com/froov30/task-tracker-rest-api/blob/main/app/rate_limit.py): `app/rate_limit.py`
- [Request Middleware](https://github.com/froov30/task-tracker-rest-api/blob/main/app/middleware.py): `app/middleware.py`
- [Structured Logging](https://github.com/froov30/task-tracker-rest-api/blob/main/app/logging_config.py): `app/logging_config.py`
- [Error Responses](https://github.com/froov30/task-tracker-rest-api/blob/main/app/error_handlers.py): `app/error_handlers.py`
- [Settings](https://github.com/froov30/task-tracker-rest-api/blob/main/app/config.py): `app/config.py`

### Other components

- **HTTP Client**
- **PostgreSQL**

## Connections

- HTTP Client → FastAPI App: sends requests (evidence: `README.md`)
- FastAPI App → Rate Limiting: registers limiter (evidence: `app/main.py`)
- FastAPI App → Request Middleware: installs middleware (evidence: `app/main.py`)
- Request Middleware → Structured Logging: uses logging (evidence: `app/middleware.py`)
- FastAPI App → Structured Logging: configures logging (evidence: `app/main.py`)
- FastAPI App → Error Responses: registers handlers (evidence: `app/main.py`)
- Error Responses → API Schemas: formats errors (evidence: `app/error_handlers.py`)
- FastAPI App → Task Routes: registers routes (evidence: `app/main.py`)
- FastAPI App → Auth Routes: registers routes (evidence: `app/main.py`)
- FastAPI App → User Routes: registers routes (evidence: `app/main.py`)
- FastAPI App → Health Probes: registers routes (evidence: `app/main.py`)
- FastAPI App → Legacy Redirects: registers routes (evidence: `app/main.py`)
- Task Routes → Dependency Wiring: requests dependencies (evidence: `app/routers/tasks.py`)
- Auth Routes → Auth Service: calls service (evidence: `app/routers/auth.py`)
- Task Routes → Task Service: calls service (evidence: `app/routers/tasks.py`)
- User Routes → Dependency Wiring: uses dependencies (evidence: `app/dependencies.py`)
- Dependency Wiring → DB Sessions: injects sessions (evidence: `app/dependencies.py`)
- Dependency Wiring → Task Service: constructs service (evidence: `app/dependencies.py`)
- Dependency Wiring → Auth Service: constructs service (evidence: `app/dependencies.py`)
- Dependency Wiring → Task Repository: constructs repository (evidence: `app/dependencies.py`)
- Dependency Wiring → User Repository: constructs repository (evidence: `app/dependencies.py`)
- Dependency Wiring → History Repository: constructs repository (evidence: `app/dependencies.py`)
- Dependency Wiring → Auth Service: resolves user (evidence: `app/dependencies.py`)
- Task Service → Task Repository: queries tasks (evidence: `app/services/task_service.py`)
- Task Service → History Repository: records audit (evidence: `app/services/task_service.py`)
- Auth Service → User Repository: queries users (evidence: `app/services/auth_service.py`)
- Auth Service → JWT Security: hashes and validates tokens (evidence: `app/services/auth_service.py`)
- Task Repository → ORM Models: queries models (evidence: `app/repositories/task_repository.py`)
- User Repository → ORM Models: queries models (evidence: `app/repositories/user_repository.py`)
- History Repository → ORM Models: queries models (evidence: `app/repositories/history_repository.py`)
- DB Sessions → PostgreSQL: connects to (evidence: `README.md`)
- ORM Models → PostgreSQL: maps persisted tables (evidence: `README.md`)
- Rate Limiting → Settings: reads limits (evidence: `app/rate_limit.py`)
- JWT Security → Settings: reads JWT settings (evidence: `app/security.py`)
- Health Probes → DB Sessions: checks readiness (evidence: `app/routers/health.py`)
- Health Probes → Rate Limiting: reports limiter (evidence: `app/routers/health.py`)
- Task Routes → API Schemas: validates task payloads (evidence: `app/routers/tasks.py`)
