# kokinf/bank architecture

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

## Overview

This is a small HTTP banking service. Clients create or close accounts, check balances, deposit or withdraw funds, and request transfers; Gin routes requests to handlers, which load and update account state through SQLite storage. Account rules and transaction behavior live in the models. The transfer handler currently loads the receiver using the sender email, despite accepting a recipient email. There is no README, so capabilities and links below are grounded in the sampled Go source; no separate service layer is shown.

Main entry points: [`internal/handlers/balance.go`](https://github.com/kokinf/bank/blob/main/internal/handlers/balance.go) (Balance handlers), [`internal/storage/storage.go`](https://github.com/kokinf/bank/blob/main/internal/storage/storage.go) (Account storage), [`internal/handlers/handlers.go`](https://github.com/kokinf/bank/blob/main/internal/handlers/handlers.go) (Route registration), [`internal/handlers/accounts.go`](https://github.com/kokinf/bank/blob/main/internal/handlers/accounts.go) (Account handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP entry"]
  node_server["Gin server<br/>[main.go]"]
end

subgraph group_api["Banking handlers"]
  node_routes["Route registration<br/>[handlers.go]"]
  node_account_handlers["Account handlers<br/>[accounts.go]"]
  node_balance_handlers["Balance handlers<br/>[balance.go]"]
  node_transfer_handler["Transfer handler<br/>[transfer.go]"]
end

subgraph group_domain["Account domain"]
  node_account_model["Account rules<br/>[account.go]"]
  node_transaction_model["Money operations<br/>[transaction.go]"]
  node_request_models["Request models<br/>[account.go]"]
end

subgraph group_persistence["SQLite persistence"]
  node_storage["Account storage<br/>[storage.go]"]
  node_sqlite[("SQLite database<br/>[storage.go]")]
end

node_client(("HTTP client"))

node_client -->|"sends requests"| node_server
node_server -->|"opens storage"| node_storage
node_server -->|"initializes routes"| node_routes
node_routes -->|"routes account calls"| node_account_handlers
node_routes -->|"routes balance calls"| node_balance_handlers
node_routes -->|"routes transfers"| node_transfer_handler
node_account_handlers -->|"binds requests"| node_request_models
node_account_handlers -->|"creates or closes"| node_account_model
node_account_handlers -->|"loads and saves"| node_storage
node_balance_handlers -->|"binds requests"| node_request_models
node_balance_handlers -->|"loads and saves"| node_storage
node_balance_handlers -->|"reads balance"| node_account_model
node_balance_handlers -->|"applies amounts"| node_transaction_model
node_transfer_handler -->|"binds request"| node_request_models
node_transfer_handler -->|"loads and saves"| node_storage
node_transfer_handler -->|"transfers funds"| node_transaction_model
node_storage -->|"queries and updates"| node_sqlite

click node_server "https://github.com/kokinf/bank/blob/main/cmd/main.go"
click node_routes "https://github.com/kokinf/bank/blob/main/internal/handlers/handlers.go"
click node_account_handlers "https://github.com/kokinf/bank/blob/main/internal/handlers/accounts.go"
click node_balance_handlers "https://github.com/kokinf/bank/blob/main/internal/handlers/balance.go"
click node_transfer_handler "https://github.com/kokinf/bank/blob/main/internal/handlers/transfer.go"
click node_account_model "https://github.com/kokinf/bank/blob/main/internal/models/account.go"
click node_transaction_model "https://github.com/kokinf/bank/blob/main/internal/models/transaction.go"
click node_request_models "https://github.com/kokinf/bank/blob/main/internal/models/account.go"
click node_storage "https://github.com/kokinf/bank/blob/main/internal/storage/storage.go"
click node_sqlite "https://github.com/kokinf/bank/blob/main/internal/storage/storage.go"

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_server,node_client toneBlue
class node_routes,node_account_handlers,node_balance_handlers,node_transfer_handler toneAmber
class node_account_model,node_transaction_model,node_request_models toneMint
class node_storage,node_sqlite toneRose
```

## Components

### HTTP entry

- [Gin server](https://github.com/kokinf/bank/blob/main/cmd/main.go): `cmd/main.go`

### Banking handlers

- [Route registration](https://github.com/kokinf/bank/blob/main/internal/handlers/handlers.go): `internal/handlers/handlers.go`
- [Account handlers](https://github.com/kokinf/bank/blob/main/internal/handlers/accounts.go): `internal/handlers/accounts.go`
- [Balance handlers](https://github.com/kokinf/bank/blob/main/internal/handlers/balance.go): `internal/handlers/balance.go`
- [Transfer handler](https://github.com/kokinf/bank/blob/main/internal/handlers/transfer.go): `internal/handlers/transfer.go`

### Account domain

- [Account rules](https://github.com/kokinf/bank/blob/main/internal/models/account.go): `internal/models/account.go`
- [Money operations](https://github.com/kokinf/bank/blob/main/internal/models/transaction.go): `internal/models/transaction.go`
- [Request models](https://github.com/kokinf/bank/blob/main/internal/models/account.go): `internal/models/account.go`

### SQLite persistence

- [Account storage](https://github.com/kokinf/bank/blob/main/internal/storage/storage.go): `internal/storage/storage.go`
- [SQLite database](https://github.com/kokinf/bank/blob/main/internal/storage/storage.go): `internal/storage/storage.go`

### Other components

- **HTTP client**

## Connections

- HTTP client → Gin server: sends requests (evidence: `cmd/main.go`)
- Gin server → Account storage: opens storage (evidence: `cmd/main.go`)
- Gin server → Route registration: initializes routes (evidence: `cmd/main.go`)
- Route registration → Account handlers: routes account calls (evidence: `internal/handlers/handlers.go`)
- Route registration → Balance handlers: routes balance calls (evidence: `internal/handlers/handlers.go`)
- Route registration → Transfer handler: routes transfers (evidence: `internal/handlers/handlers.go`)
- Account handlers → Request models: binds requests (evidence: `internal/handlers/accounts.go`)
- Account handlers → Account rules: creates or closes (evidence: `internal/handlers/accounts.go`)
- Account handlers → Account storage: loads and saves (evidence: `internal/handlers/accounts.go`)
- Balance handlers → Request models: binds requests (evidence: `internal/handlers/balance.go`)
- Balance handlers → Account storage: loads and saves (evidence: `internal/handlers/balance.go`)
- Balance handlers → Account rules: reads balance (evidence: `internal/handlers/balance.go`)
- Balance handlers → Money operations: applies amounts (evidence: `internal/handlers/balance.go`)
- Transfer handler → Request models: binds request (evidence: `internal/handlers/transfer.go`)
- Transfer handler → Account storage: loads and saves (evidence: `internal/handlers/transfer.go`)
- Transfer handler → Money operations: transfers funds (evidence: `internal/handlers/transfer.go`)
- Account storage → SQLite database: queries and updates (evidence: `internal/storage/storage.go`)
