# serah73/lexbank architecture

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

- Interactive diagram: https://gitdiagram.com/serah73/lexbank
- Repository: https://github.com/serah73/lexbank

## Overview

LexBank is a local-use web application for importing bank statements, normalizing transactions, reporting unreadable rows, and separating each user’s data. The implemented workflow is: sign up or log in, upload a statement, select a compatible reader, compare and persist transactions, then display transactions and failed rows. The README also describes categorization, correction-derived rules, accuracy measurement, and charts as planned; their implementation is not present in the supplied source. Edges reflect shown calls, registrations, or documented relationships; unsampled roadmap capabilities are shown without inferred connections.

Main entry points: [`src/backend/LexBank.Api/Program.cs`](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Api/Program.cs) (REST API), [`src/frontend/src/App.tsx`](https://github.com/serah73/lexbank/blob/main/src/frontend/src/App.tsx) (Web app), [`src/backend/LexBank.Application/SignUp.cs`](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/SignUp.cs) (Sign-up), [`src/backend/LexBank.Application/LogIn.cs`](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/LogIn.cs) (Log-in)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_webapp["Web app<br/>[App.tsx]"]
  node_signupform["Sign-up form<br/>[SignUpForm.tsx]"]
  node_loginform["Log-in form<br/>[LogInForm.tsx]"]
  node_messages["UI messages<br/>[messages.ts]"]
end

subgraph group_api["API"]
  node_api_service["REST API<br/>[Program.cs]"]
end

subgraph group_application["Application"]
  node_signup["Sign-up<br/>[SignUp.cs]"]
  node_login["Log-in<br/>[LogIn.cs]"]
  node_upload["Statement import<br/>[UploadStatement.cs]"]
  node_reader_contract["Reader contract"]
  node_transaction_contract["Transaction repository contract"]
  node_user_contract["User repository contract<br/>[IUserRepository.cs]"]
  node_transaction["Transaction model<br/>[Transaction.cs]"]
  node_failedrow["Failed-row model<br/>[FailedRow.cs]"]
  node_user_model["User model<br/>[User.cs]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_ruralvia["Ruralvía XLSX reader"]
  node_revolut["Revolut CSV reader"]
  node_transaction_repo["EF transaction repository"]
  node_user_repo["EF user repository"]
  node_password_hasher["Password hasher"]
  node_dbcontext["EF database context"]
end

node_user(("User"))
node_database[("SQL Server")]
node_categorization["Deterministic categorization"]
node_category_corrections["Corrections and rules"]
node_accuracy_charts["Accuracy and charts"]

node_user -->|"uses"| node_webapp
node_webapp -->|"renders"| node_signupform
node_webapp -->|"renders"| node_loginform
node_signupform -->|"translates errors"| node_messages
node_loginform -->|"translates errors"| node_messages
node_webapp -->|"calls REST endpoints"| node_api_service
node_api_service -->|"invokes"| node_signup
node_api_service -->|"invokes"| node_login
node_api_service -->|"invokes"| node_upload
node_signup -->|"checks and saves"| node_user_contract
node_signup -.->|"hashes password"| node_password_hasher
node_login -->|"looks up user"| node_user_contract
node_login -.->|"verifies password"| node_password_hasher
node_upload -->|"selects and reads"| node_reader_contract
node_upload -->|"checks and stores"| node_transaction_contract
node_api_service -->|"registers reader"| node_ruralvia
node_api_service -->|"registers reader"| node_revolut
node_ruralvia -->|"produces rows"| node_transaction
node_ruralvia -->|"reports failed rows"| node_failedrow
node_revolut -->|"produces rows"| node_transaction
node_revolut -->|"reports failed rows"| node_failedrow
node_api_service -->|"registers repository"| node_transaction_repo
node_api_service -->|"registers repository"| node_user_repo
node_transaction_repo -->|"queries and saves"| node_dbcontext
node_user_repo -->|"queries and saves"| node_dbcontext
node_dbcontext -->|"maps entities"| node_database
node_user_repo -->|"persists"| node_user_model
node_transaction_repo -->|"persists and lists"| node_transaction

click node_webapp "https://github.com/serah73/lexbank/blob/main/src/frontend/src/App.tsx"
click node_signupform "https://github.com/serah73/lexbank/blob/main/src/frontend/src/SignUpForm.tsx"
click node_loginform "https://github.com/serah73/lexbank/blob/main/src/frontend/src/LogInForm.tsx"
click node_messages "https://github.com/serah73/lexbank/blob/main/src/frontend/src/messages.ts"
click node_api_service "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Api/Program.cs"
click node_signup "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/SignUp.cs"
click node_login "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/LogIn.cs"
click node_upload "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/UploadStatement.cs"
click node_reader_contract "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/IStatementReader.cs"
click node_transaction_contract "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/ITransactionRepository.cs"
click node_user_contract "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/IUserRepository.cs"
click node_transaction "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Domain/Transaction.cs"
click node_failedrow "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Domain/FailedRow.cs"
click node_user_model "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Domain/User.cs"
click node_ruralvia "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/RuralviaXlsxReader.cs"
click node_revolut "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/RevolutCsvReader.cs"
click node_transaction_repo "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/EfTransactionRepository.cs"
click node_user_repo "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/EfUserRepository.cs"
click node_password_hasher "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/IdentityPasswordHasher.cs"
click node_dbcontext "https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/LexBankDbContext.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_webapp,node_signupform,node_loginform,node_messages,node_user toneBlue
class node_api_service,node_database toneAmber
class node_signup,node_login,node_upload,node_reader_contract,node_transaction_contract,node_user_contract,node_transaction,node_failedrow,node_user_model toneMint
class node_ruralvia,node_revolut,node_transaction_repo,node_user_repo,node_password_hasher,node_dbcontext toneRose
class node_categorization,node_category_corrections,node_accuracy_charts toneIndigo
```

## Components

### Frontend

- [Web app](https://github.com/serah73/lexbank/blob/main/src/frontend/src/App.tsx): `src/frontend/src/App.tsx`
- [Sign-up form](https://github.com/serah73/lexbank/blob/main/src/frontend/src/SignUpForm.tsx): `src/frontend/src/SignUpForm.tsx`
- [Log-in form](https://github.com/serah73/lexbank/blob/main/src/frontend/src/LogInForm.tsx): `src/frontend/src/LogInForm.tsx`
- [UI messages](https://github.com/serah73/lexbank/blob/main/src/frontend/src/messages.ts): `src/frontend/src/messages.ts`

### API

- [REST API](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Api/Program.cs): `src/backend/LexBank.Api/Program.cs`

### Application

- [Sign-up](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/SignUp.cs): `src/backend/LexBank.Application/SignUp.cs`
- [Log-in](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/LogIn.cs): `src/backend/LexBank.Application/LogIn.cs`
- [Statement import](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/UploadStatement.cs): `src/backend/LexBank.Application/UploadStatement.cs`
- [Reader contract](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/IStatementReader.cs): `src/backend/LexBank.Application/IStatementReader.cs`
- [Transaction repository contract](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/ITransactionRepository.cs): `src/backend/LexBank.Application/ITransactionRepository.cs`
- [User repository contract](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Application/IUserRepository.cs): `src/backend/LexBank.Application/IUserRepository.cs`
- [Transaction model](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Domain/Transaction.cs): `src/backend/LexBank.Domain/Transaction.cs`
- [Failed-row model](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Domain/FailedRow.cs): `src/backend/LexBank.Domain/FailedRow.cs`
- [User model](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Domain/User.cs): `src/backend/LexBank.Domain/User.cs`

### Infrastructure

- [Ruralvía XLSX reader](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/RuralviaXlsxReader.cs): `src/backend/LexBank.Infrastructure/RuralviaXlsxReader.cs`
- [Revolut CSV reader](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/RevolutCsvReader.cs): `src/backend/LexBank.Infrastructure/RevolutCsvReader.cs`
- [EF transaction repository](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/EfTransactionRepository.cs): `src/backend/LexBank.Infrastructure/EfTransactionRepository.cs`
- [EF user repository](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/EfUserRepository.cs): `src/backend/LexBank.Infrastructure/EfUserRepository.cs`
- [Password hasher](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/IdentityPasswordHasher.cs): `src/backend/LexBank.Infrastructure/IdentityPasswordHasher.cs`
- [EF database context](https://github.com/serah73/lexbank/blob/main/src/backend/LexBank.Infrastructure/LexBankDbContext.cs): `src/backend/LexBank.Infrastructure/LexBankDbContext.cs`

### Other components

- **User**
- **SQL Server**
- **Deterministic categorization**
- **Corrections and rules**
- **Accuracy and charts**

## Connections

- User → Web app: uses (evidence: `README.md`)
- Web app → Sign-up form: renders (evidence: `src/frontend/src/App.tsx`)
- Web app → Log-in form: renders (evidence: `src/frontend/src/App.tsx`)
- Sign-up form → UI messages: translates errors (evidence: `src/frontend/src/SignUpForm.tsx`)
- Log-in form → UI messages: translates errors (evidence: `src/frontend/src/LogInForm.tsx`)
- Web app → REST API: calls REST endpoints (evidence: `src/frontend/src/App.tsx`)
- REST API → Sign-up: invokes (evidence: `src/backend/LexBank.Api/Program.cs`)
- REST API → Log-in: invokes (evidence: `src/backend/LexBank.Api/Program.cs`)
- REST API → Statement import: invokes (evidence: `src/backend/LexBank.Api/Program.cs`)
- Sign-up → User repository contract: checks and saves (evidence: `src/backend/LexBank.Application/SignUp.cs`)
- Sign-up → Password hasher: hashes password
- Log-in → User repository contract: looks up user (evidence: `src/backend/LexBank.Application/LogIn.cs`)
- Log-in → Password hasher: verifies password
- Statement import → Reader contract: selects and reads (evidence: `src/backend/LexBank.Application/UploadStatement.cs`)
- Statement import → Transaction repository contract: checks and stores (evidence: `src/backend/LexBank.Application/UploadStatement.cs`)
- REST API → Ruralvía XLSX reader: registers reader (evidence: `src/backend/LexBank.Api/Program.cs`)
- REST API → Revolut CSV reader: registers reader (evidence: `src/backend/LexBank.Api/Program.cs`)
- Ruralvía XLSX reader → Transaction model: produces rows (evidence: `src/backend/LexBank.Infrastructure/RuralviaXlsxReader.cs`)
- Ruralvía XLSX reader → Failed-row model: reports failed rows (evidence: `src/backend/LexBank.Infrastructure/RuralviaXlsxReader.cs`)
- Revolut CSV reader → Transaction model: produces rows (evidence: `src/backend/LexBank.Infrastructure/RevolutCsvReader.cs`)
- Revolut CSV reader → Failed-row model: reports failed rows (evidence: `src/backend/LexBank.Infrastructure/RevolutCsvReader.cs`)
- REST API → EF transaction repository: registers repository (evidence: `src/backend/LexBank.Api/Program.cs`)
- REST API → EF user repository: registers repository (evidence: `src/backend/LexBank.Api/Program.cs`)
- EF transaction repository → EF database context: queries and saves (evidence: `src/backend/LexBank.Infrastructure/EfTransactionRepository.cs`)
- EF user repository → EF database context: queries and saves (evidence: `src/backend/LexBank.Infrastructure/EfUserRepository.cs`)
- EF database context → SQL Server: maps entities
- EF user repository → User model: persists (evidence: `src/backend/LexBank.Infrastructure/EfUserRepository.cs`)
- EF transaction repository → Transaction model: persists and lists (evidence: `src/backend/LexBank.Infrastructure/EfTransactionRepository.cs`)
