# tologon7/todo_lst-fastapi- architecture

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

- Interactive diagram: https://gitdiagram.com/tologon7/todo_lst-fastapi-
- Repository: https://github.com/tologon7/todo_lst-fastapi-

## Overview

This is a FastAPI task-management API with user registration/login, task operations, and administrator-managed roles. The main workflow is an HTTP request routed through the task API, authenticated where required, then handled by a task DAO against the database; user and role routes provide account and access-control capabilities. The graph reflects indexed imports and sampled calls. Several modules, including task dependencies and DAO implementations, were not excerpted, so their indexed references support only limited relationships.

Main entry points: [`app/users/router.py`](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/router.py) (User routes), [`app/tasks/router.py`](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/router.py) (Task routes), [`app/users/dependencies.py`](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/dependencies.py) (User access checks), [`app/database.py`](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/database.py) (Database session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API routes"]
  node_main["App registration<br/>[main.py]"]
  node_user_routes["User routes<br/>[router.py]"]
  node_task_routes["Task routes<br/>[router.py]"]
  node_role_routes["Role routes<br/>[router.py]"]
  node_exceptions["API exceptions<br/>[exceptions.py]"]
end

subgraph group_identity["Identity and roles"]
  node_auth["Password and tokens<br/>[auth.py]"]
  node_user_access["User access checks<br/>[dependencies.py]"]
  node_user_dao["User DAO<br/>[dao.py]"]
  node_user_model["User records<br/>[models.py]"]
  node_role_dao["Role DAO<br/>[dao.py]"]
  node_role_model["Role records<br/>[models.py]"]
  node_user_schemas["User schemas<br/>[schemas.py]"]
  node_role_schemas["Role schemas<br/>[schemas.py]"]
end

subgraph group_tasks["Task management"]
  node_task_access["Task lookup<br/>[dependencies.py]"]
  node_task_dao["Task DAO<br/>[dao.py]"]
  node_task_model["Task records<br/>[models.py]"]
  node_task_schemas["Task schemas<br/>[schemas.py]"]
end

subgraph group_persistence["Persistence"]
  node_base_dao["DAO operations<br/>[base.py]"]
  node_database["Database session<br/>[database.py]"]
  node_config["Runtime settings<br/>[config.py]"]
end

node_client(("API client"))
node_store[("PostgreSQL")]

node_client -->|"sends requests"| node_main
node_main -->|"registers"| node_user_routes
node_main -->|"registers"| node_task_routes
node_main -->|"registers"| node_role_routes
node_user_routes -->|"authenticates"| node_auth
node_user_routes -->|"reads and writes"| node_user_dao
node_user_routes -->|"checks admin"| node_user_access
node_user_routes -->|"validates input"| node_user_schemas
node_user_routes -->|"raises"| node_exceptions
node_auth -->|"loads account"| node_user_dao
node_auth -->|"signs tokens"| node_config
node_user_access -->|"loads user"| node_user_dao
node_user_access -->|"decodes token"| node_config
node_user_access -->|"raises"| node_exceptions
node_task_routes -->|"runs task operations"| node_task_dao
node_task_routes -->|"resolves task"| node_task_access
node_task_routes -->|"requires user"| node_user_access
node_task_routes -->|"validates and shapes"| node_task_schemas
node_task_routes -->|"raises"| node_exceptions
node_role_routes -->|"runs role operations"| node_role_dao
node_role_routes -->|"requires admin"| node_user_access
node_role_routes -->|"validates input"| node_role_schemas
node_role_routes -->|"raises"| node_exceptions
node_user_dao -->|"inherits operations"| node_base_dao
node_task_dao -->|"inherits operations"| node_base_dao
node_role_dao -->|"inherits operations"| node_base_dao
node_user_dao -->|"operates on"| node_user_model
node_task_dao -->|"operates on"| node_task_model
node_role_dao -->|"operates on"| node_role_model
node_base_dao -->|"opens sessions"| node_database
node_database -->|"gets connection settings"| node_config
node_database -.->|"connects"| node_store
node_user_model -->|"maps records"| node_database
node_task_model -->|"maps records"| node_database
node_role_model -->|"maps records"| node_database
node_user_model -->|"references role"| node_role_model
node_task_model -->|"references owner"| node_user_model

click node_main "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/main.py"
click node_user_routes "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/router.py"
click node_task_routes "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/router.py"
click node_role_routes "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/router.py"
click node_auth "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/auth.py"
click node_user_access "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/dependencies.py"
click node_user_dao "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/dao.py"
click node_user_model "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/models.py"
click node_role_dao "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/dao.py"
click node_role_model "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/models.py"
click node_task_access "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/dependencies.py"
click node_task_dao "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/dao.py"
click node_task_model "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/models.py"
click node_task_schemas "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/schemas.py"
click node_user_schemas "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/schemas.py"
click node_role_schemas "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/schemas.py"
click node_base_dao "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/dao/base.py"
click node_database "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/database.py"
click node_config "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/config.py"
click node_exceptions "https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/exceptions.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_main,node_user_routes,node_task_routes,node_role_routes,node_exceptions,node_client toneBlue
class node_auth,node_user_access,node_user_dao,node_user_model,node_role_dao,node_role_model,node_user_schemas,node_role_schemas,node_store toneAmber
class node_task_access,node_task_dao,node_task_model,node_task_schemas toneMint
class node_base_dao,node_database,node_config toneRose
```

## Components

### API routes

- [App registration](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/main.py): `app/main.py`
- [User routes](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/router.py): `app/users/router.py`
- [Task routes](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/router.py): `app/tasks/router.py`
- [Role routes](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/router.py): `app/users/roles/router.py`
- [API exceptions](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/exceptions.py): `app/exceptions.py`

### Identity and roles

- [Password and tokens](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/auth.py): `app/users/auth.py`
- [User access checks](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/dependencies.py): `app/users/dependencies.py`
- [User DAO](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/dao.py): `app/users/dao.py`
- [User records](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/models.py): `app/users/models.py`
- [Role DAO](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/dao.py): `app/users/roles/dao.py`
- [Role records](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/models.py): `app/users/roles/models.py`
- [User schemas](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/schemas.py): `app/users/schemas.py`
- [Role schemas](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/users/roles/schemas.py): `app/users/roles/schemas.py`

### Task management

- [Task lookup](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/dependencies.py): `app/tasks/dependencies.py`
- [Task DAO](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/dao.py): `app/tasks/dao.py`
- [Task records](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/models.py): `app/tasks/models.py`
- [Task schemas](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/tasks/schemas.py): `app/tasks/schemas.py`

### Persistence

- [DAO operations](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/dao/base.py): `app/dao/base.py`
- [Database session](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/database.py): `app/database.py`
- [Runtime settings](https://github.com/tologon7/todo_lst-fastapi-/blob/main/app/config.py): `app/config.py`

### Other components

- **API client**
- **PostgreSQL**

## Connections

- API client → App registration: sends requests
- App registration → User routes: registers (evidence: `app/main.py`)
- App registration → Task routes: registers (evidence: `app/main.py`)
- App registration → Role routes: registers (evidence: `app/main.py`)
- User routes → Password and tokens: authenticates (evidence: `app/users/router.py`)
- User routes → User DAO: reads and writes (evidence: `app/users/router.py`)
- User routes → User access checks: checks admin (evidence: `app/users/router.py`)
- User routes → User schemas: validates input (evidence: `app/users/router.py`)
- User routes → API exceptions: raises (evidence: `app/users/router.py`)
- Password and tokens → User DAO: loads account (evidence: `app/users/auth.py`)
- Password and tokens → Runtime settings: signs tokens (evidence: `app/users/auth.py`)
- User access checks → User DAO: loads user (evidence: `app/users/dependencies.py`)
- User access checks → Runtime settings: decodes token (evidence: `app/users/dependencies.py`)
- User access checks → API exceptions: raises (evidence: `app/users/dependencies.py`)
- Task routes → Task DAO: runs task operations (evidence: `app/tasks/router.py`)
- Task routes → Task lookup: resolves task (evidence: `app/tasks/router.py`)
- Task routes → User access checks: requires user (evidence: `app/tasks/router.py`)
- Task routes → Task schemas: validates and shapes (evidence: `app/tasks/router.py`)
- Task routes → API exceptions: raises (evidence: `app/tasks/router.py`)
- Role routes → Role DAO: runs role operations (evidence: `app/users/roles/router.py`)
- Role routes → User access checks: requires admin (evidence: `app/users/roles/router.py`)
- Role routes → Role schemas: validates input (evidence: `app/users/roles/router.py`)
- Role routes → API exceptions: raises (evidence: `app/users/roles/router.py`)
- User DAO → DAO operations: inherits operations (evidence: `app/users/dao.py`)
- Task DAO → DAO operations: inherits operations (evidence: `app/tasks/dao.py`)
- Role DAO → DAO operations: inherits operations (evidence: `app/users/roles/dao.py`)
- User DAO → User records: operates on (evidence: `app/users/dao.py`)
- Task DAO → Task records: operates on (evidence: `app/tasks/dao.py`)
- Role DAO → Role records: operates on (evidence: `app/users/roles/dao.py`)
- DAO operations → Database session: opens sessions (evidence: `app/dao/base.py`)
- Database session → Runtime settings: gets connection settings (evidence: `app/database.py`)
- Database session → PostgreSQL: connects
- User records → Database session: maps records (evidence: `app/users/models.py`)
- Task records → Database session: maps records (evidence: `app/tasks/models.py`)
- Role records → Database session: maps records (evidence: `app/users/roles/models.py`)
- User records → Role records: references role (evidence: `app/users/models.py`)
- Task records → User records: references owner (evidence: `app/tasks/models.py`)
