# sarcasmius/----------------------alembic architecture

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

- Interactive diagram: https://gitdiagram.com/sarcasmius/----------------------alembic
- Repository: https://github.com/sarcasmius/----------------------alembic

## Overview

This repository is a FastAPI user-management API backed by PostgreSQL. The main workflow is an HTTP request routed to the user endpoints, validated with Pydantic schemas, and handled through an async SQLAlchemy session against the user data model; responses return through the API. The source also includes database setup, configuration, migration files, and Alembic database utilities. The README is empty, and migration runtime wiring is not shown, so no migration-flow edges are inferred.

Main entry points: [`public/users.py`](https://github.com/sarcasmius/----------------------alembic/blob/main/public/users.py) (User endpoints), [`public/db.py`](https://github.com/sarcasmius/----------------------alembic/blob/main/public/db.py) (Session provider), [`main.py`](https://github.com/sarcasmius/----------------------alembic/blob/main/main.py) (FastAPI app), [`models/dbcontext.py`](https://github.com/sarcasmius/----------------------alembic/blob/main/models/dbcontext.py) (User and company model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API runtime"]
  node_application["FastAPI app<br/>[main.py]"]
  node_user_routes["User endpoints<br/>[users.py]"]
end

subgraph group_domain["User domain"]
  node_user_schemas["User schemas<br/>[models_user.py]"]
  node_password_codec["Password codec<br/>[users.py]"]
  node_user_company_model["User and company model<br/>[dbcontext.py]"]
end

subgraph group_database["Database access"]
  node_session_provider["Session provider<br/>[db.py]"]
  node_database_config["Database settings<br/>[config.py]"]
end

subgraph group_operations["Database operations"]
  node_db_utilities["DB and Alembic utilities<br/>[db_utils.py]"]
  node_migrations["Schema migrations"]
end

node_caller(("API caller"))
node_postgres[("PostgreSQL")]

node_caller -->|"sends request"| node_application
node_application -->|"includes router"| node_user_routes
node_user_routes -->|"validates and serializes"| node_user_schemas
node_user_routes -->|"encodes password"| node_password_codec
node_user_routes -->|"queries users"| node_user_company_model
node_user_routes -->|"depends on session"| node_session_provider
node_session_provider -->|"uses metadata"| node_user_company_model
node_session_provider -->|"reads URLs"| node_database_config
node_session_provider -->|"connects to"| node_postgres

click node_application "https://github.com/sarcasmius/----------------------alembic/blob/main/main.py"
click node_user_routes "https://github.com/sarcasmius/----------------------alembic/blob/main/public/users.py"
click node_user_schemas "https://github.com/sarcasmius/----------------------alembic/blob/main/models/models_user.py"
click node_password_codec "https://github.com/sarcasmius/----------------------alembic/blob/main/public/users.py"
click node_user_company_model "https://github.com/sarcasmius/----------------------alembic/blob/main/models/dbcontext.py"
click node_session_provider "https://github.com/sarcasmius/----------------------alembic/blob/main/public/db.py"
click node_database_config "https://github.com/sarcasmius/----------------------alembic/blob/main/config.py"
click node_db_utilities "https://github.com/sarcasmius/----------------------alembic/blob/main/db_utils.py"
click node_migrations "https://github.com/sarcasmius/----------------------alembic/tree/main/migrations/versions"

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_user_routes toneBlue
class node_user_schemas,node_password_codec,node_user_company_model,node_postgres toneAmber
class node_session_provider,node_database_config,node_caller toneMint
class node_db_utilities,node_migrations toneRose
```

## Components

### API runtime

- [FastAPI app](https://github.com/sarcasmius/----------------------alembic/blob/main/main.py): `main.py`
- [User endpoints](https://github.com/sarcasmius/----------------------alembic/blob/main/public/users.py): `public/users.py`

### User domain

- [User schemas](https://github.com/sarcasmius/----------------------alembic/blob/main/models/models_user.py): `models/models_user.py`
- [Password codec](https://github.com/sarcasmius/----------------------alembic/blob/main/public/users.py): `public/users.py`
- [User and company model](https://github.com/sarcasmius/----------------------alembic/blob/main/models/dbcontext.py): `models/dbcontext.py`

### Database access

- [Session provider](https://github.com/sarcasmius/----------------------alembic/blob/main/public/db.py): `public/db.py`
- [Database settings](https://github.com/sarcasmius/----------------------alembic/blob/main/config.py): `config.py`

### Database operations

- [DB and Alembic utilities](https://github.com/sarcasmius/----------------------alembic/blob/main/db_utils.py): `db_utils.py`
- [Schema migrations](https://github.com/sarcasmius/----------------------alembic/tree/main/migrations/versions): `migrations/versions`

### Other components

- **API caller**
- **PostgreSQL**

## Connections

- API caller → FastAPI app: sends request (evidence: `main.py`)
- FastAPI app → User endpoints: includes router (evidence: `main.py`)
- User endpoints → User schemas: validates and serializes (evidence: `public/users.py`)
- User endpoints → Password codec: encodes password (evidence: `public/users.py`)
- User endpoints → User and company model: queries users (evidence: `public/users.py`)
- User endpoints → Session provider: depends on session (evidence: `public/users.py`)
- Session provider → User and company model: uses metadata (evidence: `public/db.py`)
- Session provider → Database settings: reads URLs (evidence: `public/db.py`)
- Session provider → PostgreSQL: connects to (evidence: `public/db.py`)