# asadbek204/fast-template architecture

> Architecture diagram of the GitHub repository asadbek204/fast-template, 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/asadbek204/fast-template
- Repository: https://github.com/asadbek204/fast-template

## Overview

This is a FastAPI account service: requests enter the application/router layer, account endpoints handle registration and token operations, and authenticated profile access relies on persisted account sessions. The internal layers provide JWT/password handling and SQLAlchemy persistence. The README is empty, so the graph reflects the sampled runtime code; the PostgreSQL connection is configured in code, but no database-service wiring was excerpted.

Main entry points: [`project/src/account/views.py`](https://github.com/asadbek204/fast-template/blob/main/project/src/account/views.py) (Account endpoints), [`project/src/account/manager.py`](https://github.com/asadbek204/fast-template/blob/main/project/src/account/manager.py) (Auth manager), [`project/src/account/models/account.py`](https://github.com/asadbek204/fast-template/blob/main/project/src/account/models/account.py) (Account model), [`project/src/account/models/session.py`](https://github.com/asadbek204/fast-template/blob/main/project/src/account/models/session.py) (Session model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API runtime"]
  node_app["FastAPI app<br/>[main.py]"]
  node_routes["Route registry<br/>[routers.py]"]
end

subgraph group_accounts["Account domain"]
  node_account_api["Account endpoints<br/>[views.py]"]
  node_schemas["Account schemas<br/>[schemas.py]"]
  node_manager["Auth manager<br/>[manager.py]"]
  node_account["Account model<br/>[account.py]"]
  node_session["Session model<br/>[session.py]"]
end

subgraph group_persistence["Persistence and config"]
  node_db_session["DB session provider<br/>[database.py]"]
  node_base_model["Base model<br/>[models.py]"]
  node_db_types["DB types<br/>[types.py]"]
  node_settings["Service settings<br/>[settings.py]"]
end

node_client(("API client"))

node_client -.->|"sends requests"| node_app
node_app -->|"registers routes"| node_routes
node_routes -->|"includes router"| node_account_api
node_account_api -->|"uses schemas"| node_schemas
node_account_api -->|"calls auth"| node_manager
node_account_api -->|"queries and creates"| node_account
node_account_api -->|"checks session"| node_session
node_account_api -->|"gets DB session"| node_db_session
node_manager -->|"queries sessions"| node_db_session
node_manager -->|"loads and creates"| node_session
node_manager -->|"reads auth config"| node_settings
node_account -->|"inherits auth methods"| node_manager
node_account -->|"extends model"| node_base_model
node_account -->|"uses mapped types"| node_db_types
node_session -->|"extends model"| node_base_model
node_session -->|"relates to account"| node_account
node_db_session -->|"uses DB URL"| node_settings
node_base_model -->|"uses declarative base"| node_db_session
node_base_model -->|"uses key type"| node_db_types

click node_app "https://github.com/asadbek204/fast-template/blob/main/project/main.py"
click node_routes "https://github.com/asadbek204/fast-template/blob/main/project/routers.py"
click node_account_api "https://github.com/asadbek204/fast-template/blob/main/project/src/account/views.py"
click node_schemas "https://github.com/asadbek204/fast-template/blob/main/project/src/account/schemas.py"
click node_manager "https://github.com/asadbek204/fast-template/blob/main/project/src/account/manager.py"
click node_account "https://github.com/asadbek204/fast-template/blob/main/project/src/account/models/account.py"
click node_session "https://github.com/asadbek204/fast-template/blob/main/project/src/account/models/session.py"
click node_db_session "https://github.com/asadbek204/fast-template/blob/main/project/src/database/database.py"
click node_base_model "https://github.com/asadbek204/fast-template/blob/main/project/src/database/models.py"
click node_db_types "https://github.com/asadbek204/fast-template/blob/main/project/src/database/types.py"
click node_settings "https://github.com/asadbek204/fast-template/blob/main/project/settings.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_app,node_routes,node_client toneBlue
class node_account_api,node_schemas,node_manager,node_account,node_session toneAmber
class node_db_session,node_base_model,node_db_types,node_settings toneMint
```

## Components

### API runtime

- [FastAPI app](https://github.com/asadbek204/fast-template/blob/main/project/main.py): `project/main.py`
- [Route registry](https://github.com/asadbek204/fast-template/blob/main/project/routers.py): `project/routers.py`

### Account domain

- [Account endpoints](https://github.com/asadbek204/fast-template/blob/main/project/src/account/views.py): `project/src/account/views.py`
- [Account schemas](https://github.com/asadbek204/fast-template/blob/main/project/src/account/schemas.py): `project/src/account/schemas.py`
- [Auth manager](https://github.com/asadbek204/fast-template/blob/main/project/src/account/manager.py): `project/src/account/manager.py`
- [Account model](https://github.com/asadbek204/fast-template/blob/main/project/src/account/models/account.py): `project/src/account/models/account.py`
- [Session model](https://github.com/asadbek204/fast-template/blob/main/project/src/account/models/session.py): `project/src/account/models/session.py`

### Persistence and config

- [DB session provider](https://github.com/asadbek204/fast-template/blob/main/project/src/database/database.py): `project/src/database/database.py`
- [Base model](https://github.com/asadbek204/fast-template/blob/main/project/src/database/models.py): `project/src/database/models.py`
- [DB types](https://github.com/asadbek204/fast-template/blob/main/project/src/database/types.py): `project/src/database/types.py`
- [Service settings](https://github.com/asadbek204/fast-template/blob/main/project/settings.py): `project/settings.py`

### Other components

- **API client**

## Connections

- API client → FastAPI app: sends requests
- FastAPI app → Route registry: registers routes (evidence: `project/main.py`)
- Route registry → Account endpoints: includes router (evidence: `project/routers.py`)
- Account endpoints → Account schemas: uses schemas (evidence: `project/src/account/views.py`)
- Account endpoints → Auth manager: calls auth (evidence: `project/src/account/views.py`)
- Account endpoints → Account model: queries and creates (evidence: `project/src/account/views.py`)
- Account endpoints → Session model: checks session (evidence: `project/src/account/views.py`)
- Account endpoints → DB session provider: gets DB session (evidence: `project/src/account/views.py`)
- Auth manager → DB session provider: queries sessions (evidence: `project/src/account/manager.py`)
- Auth manager → Session model: loads and creates (evidence: `project/src/account/manager.py`)
- Auth manager → Service settings: reads auth config (evidence: `project/src/account/manager.py`)
- Account model → Auth manager: inherits auth methods (evidence: `project/src/account/models/account.py`)
- Account model → Base model: extends model (evidence: `project/src/account/models/account.py`)
- Account model → DB types: uses mapped types (evidence: `project/src/account/models/account.py`)
- Session model → Base model: extends model (evidence: `project/src/account/models/session.py`)
- Session model → Account model: relates to account (evidence: `project/src/account/models/session.py`)
- DB session provider → Service settings: uses DB URL (evidence: `project/src/database/database.py`)
- Base model → DB session provider: uses declarative base (evidence: `project/src/database/models.py`)
- Base model → DB types: uses key type (evidence: `project/src/database/models.py`)
