# chaichanateam/bankrupt_back architecture

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

## Overview

Bankrupt is a demo online-banking backend built with FastAPI. Clients use its API to register and verify accounts, authenticate, and manage cards, savings, bills, and transaction history; user services also support password reset and email-based two-factor authentication. The graph separates API routes, domain services, persistence/query logic, and shared infrastructure. README capabilities are included, but detailed behavior for unsampled feature modules is limited to documented and indexed relationships.

Main entry points: [`src/db/queries.py`](https://github.com/chaichanateam/bankrupt_back/blob/main/src/db/queries.py) (Database queries), [`src/core/back_app.py`](https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/back_app.py) (FastAPI app), [`src/services/user.py`](https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/user.py) (User service), [`src/api/utils/auth.py`](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/utils/auth.py) (JWT and verification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_app["FastAPI app<br/>[back_app.py]"]
  node_user_routes["User routes<br/>[user.py]"]
  node_card_routes["Card routes<br/>[cards.py]"]
  node_savings_routes["Savings routes<br/>[savings.py]"]
  node_bill_routes["Bill routes<br/>[bills.py]"]
  node_cleanup_routes["Cleanup route<br/>[cleanup.py]"]
  node_schemas["Request schemas"]
end

subgraph group_domain["Banking services"]
  node_user_service["User service<br/>[user.py]"]
  node_base_user["Base user service<br/>[base_user.py]"]
  node_card_service["Card service<br/>[cards.py]"]
  node_savings_service["Savings service<br/>[savings.py]"]
  node_bill_service["Bill service<br/>[bills.py]"]
end

subgraph group_persistence["Persistence"]
  node_queries["Database queries<br/>[queries.py]"]
  node_db_dependency["DB dependency<br/>[dependencies.py]"]
  node_session["DB session<br/>[session.py]"]
  node_user_model[("User records<br/>[user.py]")]
  node_card_model[("Card records<br/>[cards.py]")]
  node_savings_model[("Savings records<br/>[savings.py]")]
  node_bill_model[("Bill records<br/>[bills.py]")]
  node_wallet_model[("Wallet records<br/>[wallet.py]")]
  node_history_model[("Transfer history<br/>[wallet_history.py]")]
end

subgraph group_shared["Shared infrastructure"]
  node_auth["JWT and verification<br/>[auth.py]"]
  node_mail["Email sender<br/>[mail.py]"]
  node_config["Settings<br/>[config.py]"]
  node_exceptions["API errors<br/>[exceptions.py]"]
  node_traceback["Logging helper<br/>[traceback.py]"]
end

node_client(("API client"))
node_smtp["SMTP service"]

node_client -->|"sends requests"| node_app
node_app -->|"registers"| node_user_routes
node_app -->|"registers"| node_card_routes
node_app -->|"registers"| node_savings_routes
node_app -->|"registers"| node_bill_routes
node_app -->|"registers"| node_cleanup_routes
node_user_routes -->|"calls"| node_user_service
node_card_routes -->|"calls"| node_card_service
node_savings_routes -->|"calls"| node_savings_service
node_bill_routes -->|"calls"| node_bill_service
node_user_routes -->|"uses auth"| node_auth
node_card_routes -->|"uses auth"| node_auth
node_savings_routes -->|"uses auth"| node_auth
node_bill_routes -->|"uses auth"| node_auth
node_user_routes -->|"validates with"| node_schemas
node_card_routes -->|"validates with"| node_schemas
node_savings_routes -->|"validates with"| node_schemas
node_bill_routes -->|"validates with"| node_schemas
node_user_service -->|"inherits from"| node_base_user
node_user_service -->|"queries"| node_queries
node_card_service -->|"queries"| node_queries
node_savings_service -->|"queries"| node_queries
node_bill_service -->|"queries"| node_queries
node_user_service -->|"sends email"| node_mail
node_mail -->|"sends via"| node_smtp
node_auth -->|"looks up users"| node_queries
node_queries -->|"queries"| node_user_model
node_queries -->|"queries"| node_card_model
node_queries -->|"queries"| node_savings_model
node_queries -->|"queries"| node_bill_model
node_queries -->|"queries"| node_wallet_model
node_queries -->|"queries"| node_history_model
node_user_routes -->|"requests session"| node_db_dependency
node_card_routes -->|"requests session"| node_db_dependency
node_savings_routes -->|"requests session"| node_db_dependency
node_bill_routes -->|"requests session"| node_db_dependency
node_cleanup_routes -->|"requests session"| node_db_dependency
node_db_dependency -->|"opens session"| node_session
node_app -->|"initializes"| node_session
node_session -->|"reads settings"| node_config
node_app -->|"configures app"| node_config
node_config -->|"logs settings"| node_traceback
node_user_service -->|"logs errors"| node_traceback
node_user_service -->|"raises errors"| node_exceptions
node_auth -->|"raises errors"| node_exceptions

click node_app "https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/back_app.py"
click node_user_routes "https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/user.py"
click node_card_routes "https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/cards.py"
click node_savings_routes "https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/savings.py"
click node_bill_routes "https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/bills.py"
click node_cleanup_routes "https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/cleanup.py"
click node_user_service "https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/user.py"
click node_base_user "https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/base_user.py"
click node_card_service "https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/cards.py"
click node_savings_service "https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/savings.py"
click node_bill_service "https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/bills.py"
click node_schemas "https://github.com/chaichanateam/bankrupt_back/tree/main/src/schemas"
click node_auth "https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/utils/auth.py"
click node_mail "https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/utils/mail.py"
click node_queries "https://github.com/chaichanateam/bankrupt_back/blob/main/src/db/queries.py"
click node_db_dependency "https://github.com/chaichanateam/bankrupt_back/blob/main/src/db/dependencies.py"
click node_session "https://github.com/chaichanateam/bankrupt_back/blob/main/src/db/session.py"
click node_user_model "https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/user.py"
click node_card_model "https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/cards.py"
click node_savings_model "https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/savings.py"
click node_bill_model "https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/bills.py"
click node_wallet_model "https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/wallet.py"
click node_history_model "https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/wallet_history.py"
click node_config "https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/config.py"
click node_exceptions "https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/exceptions.py"
click node_traceback "https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/traceback.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_user_routes,node_card_routes,node_savings_routes,node_bill_routes,node_cleanup_routes,node_schemas,node_client toneBlue
class node_user_service,node_base_user,node_card_service,node_savings_service,node_bill_service toneAmber
class node_queries,node_db_dependency,node_session,node_user_model,node_card_model,node_savings_model,node_bill_model,node_wallet_model,node_history_model toneMint
class node_auth,node_mail,node_config,node_exceptions,node_traceback toneRose
class node_smtp toneIndigo
```

## Components

### API

- [FastAPI app](https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/back_app.py): `src/core/back_app.py`
- [User routes](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/user.py): `src/api/routes/user.py`
- [Card routes](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/cards.py): `src/api/routes/cards.py`
- [Savings routes](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/savings.py): `src/api/routes/savings.py`
- [Bill routes](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/bills.py): `src/api/routes/bills.py`
- [Cleanup route](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/routes/cleanup.py): `src/api/routes/cleanup.py`
- [Request schemas](https://github.com/chaichanateam/bankrupt_back/tree/main/src/schemas): `src/schemas`

### Banking services

- [User service](https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/user.py): `src/services/user.py`
- [Base user service](https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/base_user.py): `src/services/base_user.py`
- [Card service](https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/cards.py): `src/services/cards.py`
- [Savings service](https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/savings.py): `src/services/savings.py`
- [Bill service](https://github.com/chaichanateam/bankrupt_back/blob/main/src/services/bills.py): `src/services/bills.py`

### Persistence

- [Database queries](https://github.com/chaichanateam/bankrupt_back/blob/main/src/db/queries.py): `src/db/queries.py`
- [DB dependency](https://github.com/chaichanateam/bankrupt_back/blob/main/src/db/dependencies.py): `src/db/dependencies.py`
- [DB session](https://github.com/chaichanateam/bankrupt_back/blob/main/src/db/session.py): `src/db/session.py`
- [User records](https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/user.py): `src/models/user.py`
- [Card records](https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/cards.py): `src/models/cards.py`
- [Savings records](https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/savings.py): `src/models/savings.py`
- [Bill records](https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/bills.py): `src/models/bills.py`
- [Wallet records](https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/wallet.py): `src/models/wallet.py`
- [Transfer history](https://github.com/chaichanateam/bankrupt_back/blob/main/src/models/wallet_history.py): `src/models/wallet_history.py`

### Shared infrastructure

- [JWT and verification](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/utils/auth.py): `src/api/utils/auth.py`
- [Email sender](https://github.com/chaichanateam/bankrupt_back/blob/main/src/api/utils/mail.py): `src/api/utils/mail.py`
- [Settings](https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/config.py): `src/core/config.py`
- [API errors](https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/exceptions.py): `src/core/exceptions.py`
- [Logging helper](https://github.com/chaichanateam/bankrupt_back/blob/main/src/core/traceback.py): `src/core/traceback.py`

### Other components

- **API client**
- **SMTP service**

## Connections

- API client → FastAPI app: sends requests (evidence: `README.md`)
- FastAPI app → User routes: registers (evidence: `src/core/back_app.py`)
- FastAPI app → Card routes: registers (evidence: `src/core/back_app.py`)
- FastAPI app → Savings routes: registers (evidence: `src/core/back_app.py`)
- FastAPI app → Bill routes: registers (evidence: `src/core/back_app.py`)
- FastAPI app → Cleanup route: registers (evidence: `src/core/back_app.py`)
- User routes → User service: calls (evidence: `src/api/routes/user.py`)
- Card routes → Card service: calls (evidence: `src/api/routes/cards.py`)
- Savings routes → Savings service: calls (evidence: `src/api/routes/savings.py`)
- Bill routes → Bill service: calls (evidence: `src/api/routes/bills.py`)
- User routes → JWT and verification: uses auth (evidence: `src/api/routes/user.py`)
- Card routes → JWT and verification: uses auth (evidence: `src/api/routes/cards.py`)
- Savings routes → JWT and verification: uses auth (evidence: `src/api/routes/savings.py`)
- Bill routes → JWT and verification: uses auth (evidence: `src/api/routes/bills.py`)
- User routes → Request schemas: validates with (evidence: `src/api/routes/user.py`)
- Card routes → Request schemas: validates with (evidence: `src/api/routes/cards.py`)
- Savings routes → Request schemas: validates with (evidence: `src/api/routes/savings.py`)
- Bill routes → Request schemas: validates with (evidence: `src/api/routes/bills.py`)
- User service → Base user service: inherits from (evidence: `src/services/user.py`)
- User service → Database queries: queries (evidence: `src/services/user.py`)
- Card service → Database queries: queries (evidence: `src/services/cards.py`)
- Savings service → Database queries: queries (evidence: `src/services/savings.py`)
- Bill service → Database queries: queries (evidence: `src/services/bills.py`)
- User service → Email sender: sends email (evidence: `src/services/user.py`)
- Email sender → SMTP service: sends via (evidence: `README.md`)
- JWT and verification → Database queries: looks up users (evidence: `src/api/utils/auth.py`)
- Database queries → User records: queries (evidence: `src/db/queries.py`)
- Database queries → Card records: queries (evidence: `src/db/queries.py`)
- Database queries → Savings records: queries (evidence: `src/db/queries.py`)
- Database queries → Bill records: queries (evidence: `src/db/queries.py`)
- Database queries → Wallet records: queries (evidence: `src/db/queries.py`)
- Database queries → Transfer history: queries (evidence: `src/db/queries.py`)
- User routes → DB dependency: requests session (evidence: `src/api/routes/user.py`)
- Card routes → DB dependency: requests session (evidence: `src/api/routes/cards.py`)
- Savings routes → DB dependency: requests session (evidence: `src/api/routes/savings.py`)
- Bill routes → DB dependency: requests session (evidence: `src/api/routes/bills.py`)
- Cleanup route → DB dependency: requests session (evidence: `src/api/routes/cleanup.py`)
- DB dependency → DB session: opens session (evidence: `src/db/dependencies.py`)
- FastAPI app → DB session: initializes (evidence: `src/core/back_app.py`)
- DB session → Settings: reads settings (evidence: `src/db/session.py`)
- FastAPI app → Settings: configures app (evidence: `src/core/back_app.py`)
- Settings → Logging helper: logs settings (evidence: `src/core/config.py`)
- User service → Logging helper: logs errors (evidence: `src/services/user.py`)
- User service → API errors: raises errors (evidence: `src/services/user.py`)
- JWT and verification → API errors: raises errors (evidence: `src/api/utils/auth.py`)
