# zoro13252/bankapi architecture

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

## Overview

This repository combines a .NET banking API with a small .NET MAUI client. The API’s visible user workflow is registration or login, token issuance, then authenticated user-management requests backed by PostgreSQL. Accounts and transfers are represented in the domain and API tree, but their implementations are only partly sampled. The client contains a login page, but no client-to-API request path is shown; that integration is therefore left unasserted. Edges reflect sampled calls or explicit configuration, not inferred wiring.

Main entry points: [`BankAPI/Services/UserService.cs`](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Services/UserService.cs) (User service), [`BankAPI/Data/BankDbContext.cs`](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Data/BankDbContext.cs) (EF Core context), [`BankAPI/Controllers/AuthController.cs`](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/AuthController.cs) (Authentication routes), [`BankAPI/Controllers/UsersController.cs`](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/UsersController.cs) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Banking client"]
  node_maui["MAUI app startup<br/>[MauiProgram.cs]"]
  node_loginpage["Login page<br/>[LoginPage.xaml.cs]"]
end

subgraph group_api["HTTP API"]
  node_authcontroller["Authentication routes<br/>[AuthController.cs]"]
  node_userscontroller["User routes<br/>[UsersController.cs]"]
  node_accountscontroller["Account routes"]
  node_transfercontroller["Transfer routes"]
  node_contracts["Request and response DTOs"]
  node_api_host["ASP.NET API host<br/>[Program.cs]"]
end

subgraph group_services["Application services"]
  node_user_service["User service<br/>[UserService.cs]"]
  node_transfer_service["Transfer service<br/>[TransferService.cs]"]
end

subgraph group_domain["Banking data"]
  node_models["User, account, transaction"]
  node_dbcontext["EF Core context<br/>[BankDbContext.cs]"]
end

node_customer(("Bank customer"))
node_postgres[("PostgreSQL")]

node_customer -->|"uses"| node_maui
node_maui -.->|"starts UI"| node_loginpage
node_customer -->|"submits auth"| node_authcontroller
node_authcontroller -->|"calls auth"| node_user_service
node_customer -->|"requests users"| node_userscontroller
node_userscontroller -->|"calls user ops"| node_user_service
node_authcontroller -->|"accepts DTOs"| node_contracts
node_userscontroller -->|"uses DTOs"| node_contracts
node_user_service -->|"queries and saves"| node_dbcontext
node_user_service -->|"creates and reads"| node_models
node_user_service -->|"maps data"| node_contracts
node_accountscontroller -->|"uses context"| node_dbcontext
node_transfer_service -->|"uses context"| node_dbcontext
node_dbcontext -->|"maps entities"| node_models
node_api_host -->|"configures database"| node_dbcontext
node_api_host -->|"connects via EF"| node_postgres

click node_maui "https://github.com/zoro13252/bankapi/blob/master/BankMAUI/MauiProgram.cs"
click node_loginpage "https://github.com/zoro13252/bankapi/blob/master/BankMAUI/Pages/LoginPage.xaml.cs"
click node_authcontroller "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/AuthController.cs"
click node_userscontroller "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/UsersController.cs"
click node_accountscontroller "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/AccountsController.cs"
click node_transfercontroller "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/TransferControllers.cs"
click node_user_service "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Services/UserService.cs"
click node_transfer_service "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Services/TransferService.cs"
click node_contracts "https://github.com/zoro13252/bankapi/tree/master/BankAPI/DTOs"
click node_models "https://github.com/zoro13252/bankapi/tree/master/BankAPI/Models"
click node_dbcontext "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Data/BankDbContext.cs"
click node_api_host "https://github.com/zoro13252/bankapi/blob/master/BankAPI/Program.cs"

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_maui,node_loginpage toneBlue
class node_authcontroller,node_userscontroller,node_accountscontroller,node_transfercontroller,node_contracts,node_api_host,node_postgres toneAmber
class node_user_service,node_transfer_service toneMint
class node_models,node_dbcontext toneRose
class node_customer toneIndigo
```

## Components

### Banking client

- [MAUI app startup](https://github.com/zoro13252/bankapi/blob/master/BankMAUI/MauiProgram.cs): `BankMAUI/MauiProgram.cs`
- [Login page](https://github.com/zoro13252/bankapi/blob/master/BankMAUI/Pages/LoginPage.xaml.cs): `BankMAUI/Pages/LoginPage.xaml.cs`

### HTTP API

- [Authentication routes](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/AuthController.cs): `BankAPI/Controllers/AuthController.cs`
- [User routes](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/UsersController.cs): `BankAPI/Controllers/UsersController.cs`
- [Account routes](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/AccountsController.cs): `BankAPI/Controllers/AccountsController.cs`
- [Transfer routes](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Controllers/TransferControllers.cs): `BankAPI/Controllers/TransferControllers.cs`
- [Request and response DTOs](https://github.com/zoro13252/bankapi/tree/master/BankAPI/DTOs): `BankAPI/DTOs`
- [ASP.NET API host](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Program.cs): `BankAPI/Program.cs`

### Application services

- [User service](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Services/UserService.cs): `BankAPI/Services/UserService.cs`
- [Transfer service](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Services/TransferService.cs): `BankAPI/Services/TransferService.cs`

### Banking data

- [User, account, transaction](https://github.com/zoro13252/bankapi/tree/master/BankAPI/Models): `BankAPI/Models`
- [EF Core context](https://github.com/zoro13252/bankapi/blob/master/BankAPI/Data/BankDbContext.cs): `BankAPI/Data/BankDbContext.cs`

### Other components

- **Bank customer**
- **PostgreSQL**

## Connections

- Bank customer → MAUI app startup: uses
- MAUI app startup → Login page: starts UI
- Bank customer → Authentication routes: submits auth (evidence: `BankAPI/Controllers/AuthController.cs`)
- Authentication routes → User service: calls auth (evidence: `BankAPI/Controllers/AuthController.cs`)
- Bank customer → User routes: requests users (evidence: `BankAPI/Controllers/UsersController.cs`)
- User routes → User service: calls user ops (evidence: `BankAPI/Controllers/UsersController.cs`)
- Authentication routes → Request and response DTOs: accepts DTOs (evidence: `BankAPI/Controllers/AuthController.cs`)
- User routes → Request and response DTOs: uses DTOs (evidence: `BankAPI/Controllers/UsersController.cs`)
- User service → EF Core context: queries and saves (evidence: `BankAPI/Services/UserService.cs`)
- User service → User, account, transaction: creates and reads (evidence: `BankAPI/Services/UserService.cs`)
- User service → Request and response DTOs: maps data (evidence: `BankAPI/Services/UserService.cs`)
- Account routes → EF Core context: uses context (evidence: `BankAPI/Controllers/AccountsController.cs`)
- Transfer service → EF Core context: uses context (evidence: `BankAPI/Services/TransferService.cs`)
- EF Core context → User, account, transaction: maps entities (evidence: `BankAPI/Data/BankDbContext.cs`)
- ASP.NET API host → EF Core context: configures database (evidence: `BankAPI/Program.cs`)
- ASP.NET API host → PostgreSQL: connects via EF (evidence: `BankAPI/Program.cs`)
