# mahmudsaidxonov/bank-core architecture

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

- Interactive diagram: https://gitdiagram.com/mahmudsaidxonov/bank-core
- Repository: https://github.com/mahmudsaidxonov/bank-core

## Overview

This repository is the bank-core service in a documented banking microservices system. Its main workflow is registration/login to create an authenticated user and account, then account operations and transfers; transfers lock accounts, update balances, record transaction history and queue a notification event. The graph also shows the transactional outbox publisher, JWT security, and the documented broker and notification-service boundary. Evidence is limited to the README and indexed excerpts/read files; unshown integrations are dashed.

Main entry points: [`src/main/java/uz/banking/bank_core/service/TransactionService.java`](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/TransactionService.java) (Transfers and history), [`src/main/java/uz/banking/bank_core/service/UserService.java`](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/UserService.java) (User and auth), [`src/main/java/uz/banking/bank_core/repository/AccountRepository.java`](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/AccountRepository.java) (Account repository), [`src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java`](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java) (Outbox scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_user_api["User API"]
  node_account_api["Account API"]
  node_transaction_api["Transaction API"]
  node_internal_api["Internal user API"]
end

subgraph group_domain["Banking operations"]
  node_user_service["User and auth<br/>[UserService.java]"]
  node_account_service["Account operations"]
  node_transaction_service["Transfers and history"]
  node_audit_service["Failed transfer audit"]
end

subgraph group_storage["Persistence"]
  node_models["Banking records"]
  node_account_repo["Account repository"]
  node_user_repo["User repository"]
  node_transaction_repo["Transaction repository"]
  node_outbox_repo["Outbox repository"]
end

subgraph group_security["Security and messaging"]
  node_jwt["JWT filter and utilities"]
  node_outbox_scheduler["Outbox scheduler"]
  node_rabbit_config["RabbitMQ configuration"]
end

node_customer(("Banking client"))
node_postgres[("PostgreSQL")]
node_rabbit["RabbitMQ"]
node_notification["bank-notification"]
node_registry["Eureka registry"]

node_customer -->|"register or login"| node_user_api
node_customer -->|"manage accounts"| node_account_api
node_customer -->|"request transfer"| node_transaction_api
node_customer -->|"request user data"| node_internal_api
node_user_api -->|"delegates"| node_user_service
node_account_api -->|"delegates"| node_account_service
node_transaction_api -->|"delegates"| node_transaction_service
node_internal_api -->|"delegates"| node_user_service
node_user_service -->|"reads and saves users"| node_user_repo
node_user_service -->|"creates account"| node_account_repo
node_user_service -->|"issues token"| node_jwt
node_account_service -->|"reads and updates"| node_account_repo
node_account_service -->|"checks user"| node_user_repo
node_transaction_service -->|"locks accounts"| node_account_repo
node_transaction_service -->|"records and queries"| node_transaction_repo
node_transaction_service -->|"records failed transfer"| node_audit_service
node_audit_service -->|"saves failed record"| node_transaction_repo
node_transaction_service -->|"queues event"| node_outbox_repo
node_outbox_scheduler -->|"polls and locks events"| node_outbox_repo
node_outbox_scheduler -->|"uses broker settings"| node_rabbit_config
node_outbox_scheduler -.->|"publishes events"| node_rabbit
node_rabbit -.->|"delivers transfer events"| node_notification
node_registry -.->|"supports discovery"| node_notification
node_registry -.->|"supports service discovery"| node_rabbit_config
node_user_repo -.->|"persists users"| node_postgres
node_account_repo -.->|"persists accounts"| node_postgres
node_transaction_repo -.->|"persists transactions"| node_postgres
node_outbox_repo -.->|"persists outbox"| node_postgres

click node_user_api "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/UserController.java"
click node_account_api "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/AccountController.java"
click node_transaction_api "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/TransactionController.java"
click node_internal_api "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/InternalUserController.java"
click node_user_service "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/UserService.java"
click node_account_service "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/AccountService.java"
click node_transaction_service "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/TransactionService.java"
click node_audit_service "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/TransactionAuditService.java"
click node_models "https://github.com/mahmudsaidxonov/bank-core/tree/main/src/main/java/uz/banking/bank_core/entity"
click node_account_repo "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/AccountRepository.java"
click node_user_repo "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/UserRepository.java"
click node_transaction_repo "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/TransactionRepository.java"
click node_outbox_repo "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/OutboxRepository.java"
click node_jwt "https://github.com/mahmudsaidxonov/bank-core/tree/main/src/main/java/uz/banking/bank_core/security"
click node_outbox_scheduler "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java"
click node_rabbit_config "https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/config/RabbitMQConfig.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_user_api,node_account_api,node_transaction_api,node_internal_api,node_customer toneBlue
class node_user_service,node_account_service,node_transaction_service,node_audit_service,node_postgres toneAmber
class node_models,node_account_repo,node_user_repo,node_transaction_repo,node_outbox_repo toneMint
class node_jwt,node_outbox_scheduler,node_rabbit_config toneRose
class node_rabbit,node_notification,node_registry toneIndigo
```

## Components

### API

- [User API](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/UserController.java): `src/main/java/uz/banking/bank_core/controller/UserController.java`
- [Account API](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/AccountController.java): `src/main/java/uz/banking/bank_core/controller/AccountController.java`
- [Transaction API](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/TransactionController.java): `src/main/java/uz/banking/bank_core/controller/TransactionController.java`
- [Internal user API](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/controller/InternalUserController.java): `src/main/java/uz/banking/bank_core/controller/InternalUserController.java`

### Banking operations

- [User and auth](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/UserService.java): `src/main/java/uz/banking/bank_core/service/UserService.java`
- [Account operations](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/AccountService.java): `src/main/java/uz/banking/bank_core/service/AccountService.java`
- [Transfers and history](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/TransactionService.java): `src/main/java/uz/banking/bank_core/service/TransactionService.java`
- [Failed transfer audit](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/service/TransactionAuditService.java): `src/main/java/uz/banking/bank_core/service/TransactionAuditService.java`

### Persistence

- [Banking records](https://github.com/mahmudsaidxonov/bank-core/tree/main/src/main/java/uz/banking/bank_core/entity): `src/main/java/uz/banking/bank_core/entity`
- [Account repository](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/AccountRepository.java): `src/main/java/uz/banking/bank_core/repository/AccountRepository.java`
- [User repository](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/UserRepository.java): `src/main/java/uz/banking/bank_core/repository/UserRepository.java`
- [Transaction repository](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/TransactionRepository.java): `src/main/java/uz/banking/bank_core/repository/TransactionRepository.java`
- [Outbox repository](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/repository/OutboxRepository.java): `src/main/java/uz/banking/bank_core/repository/OutboxRepository.java`

### Security and messaging

- [JWT filter and utilities](https://github.com/mahmudsaidxonov/bank-core/tree/main/src/main/java/uz/banking/bank_core/security): `src/main/java/uz/banking/bank_core/security`
- [Outbox scheduler](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java): `src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java`
- [RabbitMQ configuration](https://github.com/mahmudsaidxonov/bank-core/blob/main/src/main/java/uz/banking/bank_core/config/RabbitMQConfig.java): `src/main/java/uz/banking/bank_core/config/RabbitMQConfig.java`

### Other components

- **Banking client**
- **PostgreSQL**
- **RabbitMQ**
- **bank-notification**
- **Eureka registry**

## Connections

- Banking client → User API: register or login (evidence: `src/main/java/uz/banking/bank_core/controller/UserController.java`)
- Banking client → Account API: manage accounts (evidence: `src/main/java/uz/banking/bank_core/controller/AccountController.java`)
- Banking client → Transaction API: request transfer (evidence: `src/main/java/uz/banking/bank_core/controller/TransactionController.java`)
- Banking client → Internal user API: request user data (evidence: `src/main/java/uz/banking/bank_core/controller/InternalUserController.java`)
- User API → User and auth: delegates (evidence: `src/main/java/uz/banking/bank_core/controller/UserController.java`)
- Account API → Account operations: delegates (evidence: `src/main/java/uz/banking/bank_core/controller/AccountController.java`)
- Transaction API → Transfers and history: delegates (evidence: `src/main/java/uz/banking/bank_core/controller/TransactionController.java`)
- Internal user API → User and auth: delegates (evidence: `src/main/java/uz/banking/bank_core/controller/InternalUserController.java`)
- User and auth → User repository: reads and saves users (evidence: `src/main/java/uz/banking/bank_core/service/UserService.java`)
- User and auth → Account repository: creates account (evidence: `src/main/java/uz/banking/bank_core/service/UserService.java`)
- User and auth → JWT filter and utilities: issues token (evidence: `src/main/java/uz/banking/bank_core/service/UserService.java`)
- Account operations → Account repository: reads and updates (evidence: `src/main/java/uz/banking/bank_core/service/AccountService.java`)
- Account operations → User repository: checks user (evidence: `src/main/java/uz/banking/bank_core/service/AccountService.java`)
- Transfers and history → Account repository: locks accounts (evidence: `src/main/java/uz/banking/bank_core/service/TransactionService.java`)
- Transfers and history → Transaction repository: records and queries (evidence: `src/main/java/uz/banking/bank_core/service/TransactionService.java`)
- Transfers and history → Failed transfer audit: records failed transfer (evidence: `src/main/java/uz/banking/bank_core/service/TransactionService.java`)
- Failed transfer audit → Transaction repository: saves failed record (evidence: `src/main/java/uz/banking/bank_core/service/TransactionAuditService.java`)
- Transfers and history → Outbox repository: queues event (evidence: `src/main/java/uz/banking/bank_core/service/TransactionService.java`)
- Outbox scheduler → Outbox repository: polls and locks events (evidence: `src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java`)
- Outbox scheduler → RabbitMQ configuration: uses broker settings (evidence: `src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java`)
- Outbox scheduler → RabbitMQ: publishes events (evidence: `README.md`)
- RabbitMQ → bank-notification: delivers transfer events (evidence: `README.md`)
- Eureka registry → bank-notification: supports discovery (evidence: `README.md`)
- Eureka registry → RabbitMQ configuration: supports service discovery (evidence: `README.md`)
- User repository → PostgreSQL: persists users (evidence: `README.md`)
- Account repository → PostgreSQL: persists accounts (evidence: `README.md`)
- Transaction repository → PostgreSQL: persists transactions (evidence: `README.md`)
- Outbox repository → PostgreSQL: persists outbox (evidence: `README.md`)
