# postreen/credit-bank architecture

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

## Overview

This is a five-service prototype banking backend. A borrower submits a loan request through Gateway; Statement handles prescoring and Deal manages the application lifecycle, while Calculator provides loan calculations. After offer selection and registration, Deal supports document preparation and signing; Dossier handles email notifications. Deal’s entities and repositories represent persisted application state. The README describes synchronous and asynchronous service communication, but source excerpts do not establish every service-to-service route or event flow, so those links are omitted or marked unverified.

Main entry points: [`Gateway/src/main/java/com/gateway/service/GatewayServiceImpl.java`](https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/service/GatewayServiceImpl.java) (Gateway service), [`Calculator/src/main/java/com/calculator/service/CalculatorServiceImpl.java`](https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/service/CalculatorServiceImpl.java) (Calculation service), [`Dossier/src/main/java/com/dossier/service/DossierServiceImpl.java`](https://github.com/postreen/credit-bank/blob/main/Dossier/src/main/java/com/dossier/service/DossierServiceImpl.java) (Email service), [`Gateway/src/main/java/com/gateway/controller/GatewayController.java`](https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/controller/GatewayController.java) (Gateway API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gateway["API facade"]
  node_gateway_api["Gateway API"]
  node_gateway_service["Gateway service"]
  node_gateway_deal_client["Deal REST client"]
  node_gateway_statement_client["Statement REST client"]
end

subgraph group_application["Application workflow"]
  node_statement_api["Prescoring API"]
  node_statement_service["Prescoring service"]
  node_statement_deal_client["Deal REST client"]
  node_deal_api["Deal API"]
  node_deal_service["Deal lifecycle"]
  node_deal_records[("Application records<br/>[Statement.java]")]
  node_statement_repository["Statement repository"]
end

subgraph group_calculation["Loan calculation"]
  node_calculator_api["Calculator API"]
  node_calculator_service["Calculation service"]
  node_scoring["Credit scoring"]
  node_credit_calculator["Annuity calculator"]
end

subgraph group_notifications["Documents and email"]
  node_dossier_listener["Notification listener"]
  node_dossier_service["Email service"]
  node_document_generator["Document generator"]
  node_deal_producer["Deal event producer"]
end

node_borrower(("Borrower"))
node_kafka["Kafka broker"]
node_email["Email service"]

node_borrower -->|"submits request"| node_gateway_api
node_gateway_api -->|"delegates"| node_gateway_service
node_gateway_service -->|"routes requests"| node_gateway_deal_client
node_gateway_service -->|"routes requests"| node_gateway_statement_client
node_statement_api -->|"delegates"| node_statement_service
node_statement_service -.->|"forwards requests"| node_statement_deal_client
node_deal_api -->|"delegates"| node_deal_service
node_deal_service -.->|"reads and writes"| node_statement_repository
node_statement_repository -->|"persists"| node_deal_records
node_calculator_api -->|"delegates"| node_calculator_service
node_calculator_service -.->|"scores applications"| node_scoring
node_calculator_service -.->|"calculates credit"| node_credit_calculator
node_deal_producer -.->|"publishes events"| node_kafka
node_kafka -.->|"delivers events"| node_dossier_listener
node_dossier_listener -.->|"dispatches messages"| node_dossier_service
node_dossier_service -->|"generates documents"| node_document_generator
node_dossier_service -.->|"sends email"| node_email

click node_gateway_api "https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/controller/GatewayController.java"
click node_gateway_service "https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/service/GatewayServiceImpl.java"
click node_gateway_deal_client "https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/service/client/DealRestClient.java"
click node_gateway_statement_client "https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/service/client/StatementRestClient.java"
click node_statement_api "https://github.com/postreen/credit-bank/blob/main/Statement/src/main/java/com/statement/controller/StatementController.java"
click node_statement_service "https://github.com/postreen/credit-bank/blob/main/Statement/src/main/java/com/statement/service/StatementServiceImpl.java"
click node_statement_deal_client "https://github.com/postreen/credit-bank/blob/main/Statement/src/main/java/com/statement/service/client/DealRestClient.java"
click node_deal_api "https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/controller/DealRestController.java"
click node_deal_service "https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/service/DealServiceImpl.java"
click node_deal_records "https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/entity/Statement.java"
click node_statement_repository "https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/repositories/StatementRepository.java"
click node_calculator_api "https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/controller/CalculatorController.java"
click node_calculator_service "https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/service/CalculatorServiceImpl.java"
click node_scoring "https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/service/scoring/ScoringProviderImpl.java"
click node_credit_calculator "https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/service/credit/AnnuityCreditCalculatorImpl.java"
click node_dossier_listener "https://github.com/postreen/credit-bank/blob/main/Dossier/src/main/java/com/dossier/kafka/listener/DossierListener.java"
click node_dossier_service "https://github.com/postreen/credit-bank/blob/main/Dossier/src/main/java/com/dossier/service/DossierServiceImpl.java"
click node_document_generator "https://github.com/postreen/credit-bank/blob/main/Dossier/src/main/java/com/dossier/service/provider/DocumentGeneratorImpl.java"
click node_deal_producer "https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/kafka/producer/DealProducerImpl.java"

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_gateway_api,node_gateway_service,node_gateway_deal_client,node_gateway_statement_client toneBlue
class node_statement_api,node_statement_service,node_statement_deal_client,node_deal_api,node_deal_service,node_deal_records,node_statement_repository toneAmber
class node_calculator_api,node_calculator_service,node_scoring,node_credit_calculator toneMint
class node_dossier_listener,node_dossier_service,node_document_generator,node_deal_producer toneRose
class node_borrower,node_kafka,node_email toneIndigo
```

## Components

### API facade

- [Gateway API](https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/controller/GatewayController.java): `Gateway/src/main/java/com/gateway/controller/GatewayController.java`
- [Gateway service](https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/service/GatewayServiceImpl.java): `Gateway/src/main/java/com/gateway/service/GatewayServiceImpl.java`
- [Deal REST client](https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/service/client/DealRestClient.java): `Gateway/src/main/java/com/gateway/service/client/DealRestClient.java`
- [Statement REST client](https://github.com/postreen/credit-bank/blob/main/Gateway/src/main/java/com/gateway/service/client/StatementRestClient.java): `Gateway/src/main/java/com/gateway/service/client/StatementRestClient.java`

### Application workflow

- [Prescoring API](https://github.com/postreen/credit-bank/blob/main/Statement/src/main/java/com/statement/controller/StatementController.java): `Statement/src/main/java/com/statement/controller/StatementController.java`
- [Prescoring service](https://github.com/postreen/credit-bank/blob/main/Statement/src/main/java/com/statement/service/StatementServiceImpl.java): `Statement/src/main/java/com/statement/service/StatementServiceImpl.java`
- [Deal REST client](https://github.com/postreen/credit-bank/blob/main/Statement/src/main/java/com/statement/service/client/DealRestClient.java): `Statement/src/main/java/com/statement/service/client/DealRestClient.java`
- [Deal API](https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/controller/DealRestController.java): `Deal/src/main/java/com/deal/controller/DealRestController.java`
- [Deal lifecycle](https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/service/DealServiceImpl.java): `Deal/src/main/java/com/deal/service/DealServiceImpl.java`
- [Application records](https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/entity/Statement.java): `Deal/src/main/java/com/deal/entity/Statement.java`
- [Statement repository](https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/repositories/StatementRepository.java): `Deal/src/main/java/com/deal/repositories/StatementRepository.java`

### Loan calculation

- [Calculator API](https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/controller/CalculatorController.java): `Calculator/src/main/java/com/calculator/controller/CalculatorController.java`
- [Calculation service](https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/service/CalculatorServiceImpl.java): `Calculator/src/main/java/com/calculator/service/CalculatorServiceImpl.java`
- [Credit scoring](https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/service/scoring/ScoringProviderImpl.java): `Calculator/src/main/java/com/calculator/service/scoring/ScoringProviderImpl.java`
- [Annuity calculator](https://github.com/postreen/credit-bank/blob/main/Calculator/src/main/java/com/calculator/service/credit/AnnuityCreditCalculatorImpl.java): `Calculator/src/main/java/com/calculator/service/credit/AnnuityCreditCalculatorImpl.java`

### Documents and email

- [Notification listener](https://github.com/postreen/credit-bank/blob/main/Dossier/src/main/java/com/dossier/kafka/listener/DossierListener.java): `Dossier/src/main/java/com/dossier/kafka/listener/DossierListener.java`
- [Email service](https://github.com/postreen/credit-bank/blob/main/Dossier/src/main/java/com/dossier/service/DossierServiceImpl.java): `Dossier/src/main/java/com/dossier/service/DossierServiceImpl.java`
- [Document generator](https://github.com/postreen/credit-bank/blob/main/Dossier/src/main/java/com/dossier/service/provider/DocumentGeneratorImpl.java): `Dossier/src/main/java/com/dossier/service/provider/DocumentGeneratorImpl.java`
- [Deal event producer](https://github.com/postreen/credit-bank/blob/main/Deal/src/main/java/com/deal/kafka/producer/DealProducerImpl.java): `Deal/src/main/java/com/deal/kafka/producer/DealProducerImpl.java`

### Other components

- **Borrower**
- **Kafka broker**
- **Email service**

## Connections

- Borrower → Gateway API: submits request (evidence: `Gateway/src/main/java/com/gateway/controller/GatewayController.java`)
- Gateway API → Gateway service: delegates (evidence: `Gateway/src/main/java/com/gateway/controller/GatewayController.java`)
- Gateway service → Deal REST client: routes requests (evidence: `Gateway/src/main/java/com/gateway/service/GatewayServiceImpl.java`)
- Gateway service → Statement REST client: routes requests (evidence: `Gateway/src/main/java/com/gateway/service/GatewayServiceImpl.java`)
- Prescoring API → Prescoring service: delegates (evidence: `Statement/src/main/java/com/statement/controller/StatementController.java`)
- Prescoring service → Deal REST client: forwards requests (evidence: `Statement/src/main/java/com/statement/service/StatementServiceImpl.java`)
- Deal API → Deal lifecycle: delegates (evidence: `Deal/src/main/java/com/deal/controller/DealRestController.java`)
- Deal lifecycle → Statement repository: reads and writes
- Statement repository → Application records: persists (evidence: `Deal/src/main/java/com/deal/repositories/StatementRepository.java`)
- Calculator API → Calculation service: delegates (evidence: `Calculator/src/main/java/com/calculator/controller/CalculatorController.java`)
- Calculation service → Credit scoring: scores applications
- Calculation service → Annuity calculator: calculates credit
- Deal event producer → Kafka broker: publishes events
- Kafka broker → Notification listener: delivers events
- Notification listener → Email service: dispatches messages
- Email service → Document generator: generates documents (evidence: `Dossier/src/main/java/com/dossier/service/DossierServiceImpl.java`)
- Email service → Email service: sends email
