# alireza-davatgar/payment-system architecture

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

- Interactive diagram: https://gitdiagram.com/alireza-davatgar/payment-system
- Repository: https://github.com/alireza-davatgar/payment-system

## Overview

This is a Spring Boot fintech payment and wallet API. Its main user workflow is registration/login, JWT issuance, then authenticated user and wallet operations; deposits and withdrawals update wallet balances and record transactions. User creation also provisions a wallet. Orders are documented as a core capability and represented by entities and a repository, but the supplied tree has no order service or controller. The graph reflects the sampled source and README; order execution and database wiring are not shown in detail.

Main entry points: [`src/main/java/com/fintech/paymentsystem/service/AuthService.java`](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/AuthService.java) (Authentication Service), [`src/main/java/com/fintech/paymentsystem/service/UserService.java`](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/UserService.java) (User Service), [`src/main/java/com/fintech/paymentsystem/service/WalletService.java`](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/WalletService.java) (Wallet Service), [`src/main/java/com/fintech/paymentsystem/repository/UserRepository.java`](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/UserRepository.java) (User Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API Layer"]
  node_auth_controller["Auth API"]
  node_user_controller["User API"]
  node_wallet_controller["Wallet API"]
  node_dto["Request And Response DTOs"]
  node_errors["Error Handling"]
end

subgraph group_security["Security"]
  node_security_config["Security Configuration"]
  node_jwt_filter["JWT Filter"]
  node_jwt_provider["JWT Provider"]
  node_user_details["User Details Loader"]
end

subgraph group_business["Business Services"]
  node_auth_service["Authentication Service<br/>[AuthService.java]"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_wallet_service["Wallet Service<br/>[WalletService.java]"]
  node_user_mapper["User Mapper<br/>[UserMapper.java]"]
  node_wallet_mapper["Wallet Mapper<br/>[WalletMapper.java]"]
end

subgraph group_domain["Domain And Persistence"]
  node_user_domain["User Domain<br/>[User.java]"]
  node_wallet_domain["Wallet Domain<br/>[Wallet.java]"]
  node_transaction_domain["Transaction Domain<br/>[Transaction.java]"]
  node_order_domain["Order Domain<br/>[Order.java]"]
  node_user_repo["User Repository"]
  node_wallet_repo["Wallet Repository"]
  node_transaction_repo["Transaction Repository"]
  node_order_repo["Order Repository"]
end

node_client(("API Client"))
node_postgres[("PostgreSQL")]

node_client -->|"registers or logs in"| node_auth_controller
node_client -->|"manages users"| node_user_controller
node_client -->|"operates wallet"| node_wallet_controller
node_auth_controller -->|"delegates auth"| node_auth_service
node_user_controller -->|"delegates user ops"| node_user_service
node_wallet_controller -->|"delegates wallet ops"| node_wallet_service
node_auth_service -->|"looks up user"| node_user_repo
node_auth_service -->|"maps registration"| node_user_mapper
node_auth_service -->|"creates user"| node_user_service
node_auth_service -->|"issues token"| node_jwt_provider
node_user_service -->|"persists user"| node_user_repo
node_user_service -->|"creates wallet"| node_wallet_repo
node_user_service -->|"builds wallet"| node_wallet_domain
node_wallet_service -->|"reads and saves"| node_wallet_repo
node_wallet_service -->|"records and lists"| node_transaction_repo
node_wallet_service -->|"builds transaction"| node_transaction_domain
node_user_controller -->|"maps responses"| node_user_mapper
node_wallet_controller -->|"maps responses"| node_wallet_mapper
node_security_config -->|"registers filter"| node_jwt_filter
node_jwt_filter -->|"validates token"| node_jwt_provider
node_jwt_filter -->|"loads identity"| node_user_details
node_user_details -->|"finds user"| node_user_repo
node_user_mapper -->|"maps DTOs"| node_dto
node_wallet_mapper -->|"maps DTOs"| node_dto
node_user_domain -->|"owns wallet"| node_wallet_domain
node_wallet_domain -->|"has transactions"| node_transaction_domain
node_order_domain -->|"relates transactions"| node_transaction_domain
node_user_domain -->|"places orders"| node_order_domain
node_user_repo -.->|"stores entities"| node_postgres
node_wallet_repo -.->|"stores entities"| node_postgres
node_transaction_repo -.->|"stores entities"| node_postgres
node_order_repo -.->|"stores entities"| node_postgres

click node_auth_controller "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/controller/AuthController.java"
click node_user_controller "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/controller/UserController.java"
click node_wallet_controller "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/controller/WalletController.java"
click node_dto "https://github.com/alireza-davatgar/payment-system/tree/main/src/main/java/com/fintech/paymentsystem/dto"
click node_errors "https://github.com/alireza-davatgar/payment-system/tree/main/src/main/java/com/fintech/paymentsystem/exception"
click node_security_config "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/config/SecurityConfig.java"
click node_jwt_filter "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/security/JwtAuthenticationFilter.java"
click node_jwt_provider "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/security/JwtTokenProvider.java"
click node_user_details "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/security/CustomUserDetailsService.java"
click node_auth_service "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/AuthService.java"
click node_user_service "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/UserService.java"
click node_wallet_service "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/WalletService.java"
click node_user_mapper "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/mapper/UserMapper.java"
click node_wallet_mapper "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/mapper/WalletMapper.java"
click node_user_domain "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/User.java"
click node_wallet_domain "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/Wallet.java"
click node_transaction_domain "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/Transaction.java"
click node_order_domain "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/Order.java"
click node_user_repo "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/UserRepository.java"
click node_wallet_repo "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/WalletRepository.java"
click node_transaction_repo "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/TransactionRepository.java"
click node_order_repo "https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/OrderRepository.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_auth_controller,node_user_controller,node_wallet_controller,node_dto,node_errors,node_client toneBlue
class node_security_config,node_jwt_filter,node_jwt_provider,node_user_details,node_postgres toneAmber
class node_auth_service,node_user_service,node_wallet_service,node_user_mapper,node_wallet_mapper toneMint
class node_user_domain,node_wallet_domain,node_transaction_domain,node_order_domain,node_user_repo,node_wallet_repo,node_transaction_repo,node_order_repo toneRose
```

## Components

### API Layer

- [Auth API](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/controller/AuthController.java): `src/main/java/com/fintech/paymentsystem/controller/AuthController.java`
- [User API](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/controller/UserController.java): `src/main/java/com/fintech/paymentsystem/controller/UserController.java`
- [Wallet API](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/controller/WalletController.java): `src/main/java/com/fintech/paymentsystem/controller/WalletController.java`
- [Request And Response DTOs](https://github.com/alireza-davatgar/payment-system/tree/main/src/main/java/com/fintech/paymentsystem/dto): `src/main/java/com/fintech/paymentsystem/dto`
- [Error Handling](https://github.com/alireza-davatgar/payment-system/tree/main/src/main/java/com/fintech/paymentsystem/exception): `src/main/java/com/fintech/paymentsystem/exception`

### Security

- [Security Configuration](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/config/SecurityConfig.java): `src/main/java/com/fintech/paymentsystem/config/SecurityConfig.java`
- [JWT Filter](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/security/JwtAuthenticationFilter.java): `src/main/java/com/fintech/paymentsystem/security/JwtAuthenticationFilter.java`
- [JWT Provider](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/security/JwtTokenProvider.java): `src/main/java/com/fintech/paymentsystem/security/JwtTokenProvider.java`
- [User Details Loader](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/security/CustomUserDetailsService.java): `src/main/java/com/fintech/paymentsystem/security/CustomUserDetailsService.java`

### Business Services

- [Authentication Service](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/AuthService.java): `src/main/java/com/fintech/paymentsystem/service/AuthService.java`
- [User Service](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/UserService.java): `src/main/java/com/fintech/paymentsystem/service/UserService.java`
- [Wallet Service](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/service/WalletService.java): `src/main/java/com/fintech/paymentsystem/service/WalletService.java`
- [User Mapper](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/mapper/UserMapper.java): `src/main/java/com/fintech/paymentsystem/mapper/UserMapper.java`
- [Wallet Mapper](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/mapper/WalletMapper.java): `src/main/java/com/fintech/paymentsystem/mapper/WalletMapper.java`

### Domain And Persistence

- [User Domain](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/User.java): `src/main/java/com/fintech/paymentsystem/entity/User.java`
- [Wallet Domain](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/Wallet.java): `src/main/java/com/fintech/paymentsystem/entity/Wallet.java`
- [Transaction Domain](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/Transaction.java): `src/main/java/com/fintech/paymentsystem/entity/Transaction.java`
- [Order Domain](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/entity/Order.java): `src/main/java/com/fintech/paymentsystem/entity/Order.java`
- [User Repository](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/UserRepository.java): `src/main/java/com/fintech/paymentsystem/repository/UserRepository.java`
- [Wallet Repository](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/WalletRepository.java): `src/main/java/com/fintech/paymentsystem/repository/WalletRepository.java`
- [Transaction Repository](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/TransactionRepository.java): `src/main/java/com/fintech/paymentsystem/repository/TransactionRepository.java`
- [Order Repository](https://github.com/alireza-davatgar/payment-system/blob/main/src/main/java/com/fintech/paymentsystem/repository/OrderRepository.java): `src/main/java/com/fintech/paymentsystem/repository/OrderRepository.java`

### Other components

- **API Client**
- **PostgreSQL**

## Connections

- API Client → Auth API: registers or logs in (evidence: `README.md`)
- API Client → User API: manages users (evidence: `README.md`)
- API Client → Wallet API: operates wallet (evidence: `README.md`)
- Auth API → Authentication Service: delegates auth (evidence: `src/main/java/com/fintech/paymentsystem/controller/AuthController.java`)
- User API → User Service: delegates user ops (evidence: `src/main/java/com/fintech/paymentsystem/controller/UserController.java`)
- Wallet API → Wallet Service: delegates wallet ops (evidence: `src/main/java/com/fintech/paymentsystem/controller/WalletController.java`)
- Authentication Service → User Repository: looks up user (evidence: `src/main/java/com/fintech/paymentsystem/service/AuthService.java`)
- Authentication Service → User Mapper: maps registration (evidence: `src/main/java/com/fintech/paymentsystem/service/AuthService.java`)
- Authentication Service → User Service: creates user (evidence: `src/main/java/com/fintech/paymentsystem/service/AuthService.java`)
- Authentication Service → JWT Provider: issues token (evidence: `src/main/java/com/fintech/paymentsystem/service/AuthService.java`)
- User Service → User Repository: persists user (evidence: `src/main/java/com/fintech/paymentsystem/service/UserService.java`)
- User Service → Wallet Repository: creates wallet (evidence: `src/main/java/com/fintech/paymentsystem/service/UserService.java`)
- User Service → Wallet Domain: builds wallet (evidence: `src/main/java/com/fintech/paymentsystem/service/UserService.java`)
- Wallet Service → Wallet Repository: reads and saves (evidence: `src/main/java/com/fintech/paymentsystem/service/WalletService.java`)
- Wallet Service → Transaction Repository: records and lists (evidence: `src/main/java/com/fintech/paymentsystem/service/WalletService.java`)
- Wallet Service → Transaction Domain: builds transaction (evidence: `src/main/java/com/fintech/paymentsystem/service/WalletService.java`)
- User API → User Mapper: maps responses (evidence: `src/main/java/com/fintech/paymentsystem/controller/UserController.java`)
- Wallet API → Wallet Mapper: maps responses (evidence: `src/main/java/com/fintech/paymentsystem/controller/WalletController.java`)
- Security Configuration → JWT Filter: registers filter (evidence: `src/main/java/com/fintech/paymentsystem/config/SecurityConfig.java`)
- JWT Filter → JWT Provider: validates token (evidence: `src/main/java/com/fintech/paymentsystem/security/JwtAuthenticationFilter.java`)
- JWT Filter → User Details Loader: loads identity (evidence: `src/main/java/com/fintech/paymentsystem/security/JwtAuthenticationFilter.java`)
- User Details Loader → User Repository: finds user (evidence: `src/main/java/com/fintech/paymentsystem/security/CustomUserDetailsService.java`)
- User Mapper → Request And Response DTOs: maps DTOs (evidence: `src/main/java/com/fintech/paymentsystem/mapper/UserMapper.java`)
- Wallet Mapper → Request And Response DTOs: maps DTOs (evidence: `src/main/java/com/fintech/paymentsystem/mapper/WalletMapper.java`)
- User Domain → Wallet Domain: owns wallet (evidence: `src/main/java/com/fintech/paymentsystem/entity/User.java`)
- Wallet Domain → Transaction Domain: has transactions (evidence: `src/main/java/com/fintech/paymentsystem/entity/Wallet.java`)
- Order Domain → Transaction Domain: relates transactions (evidence: `src/main/java/com/fintech/paymentsystem/entity/Order.java`)
- User Domain → Order Domain: places orders (evidence: `src/main/java/com/fintech/paymentsystem/entity/User.java`)
- User Repository → PostgreSQL: stores entities
- Wallet Repository → PostgreSQL: stores entities
- Transaction Repository → PostgreSQL: stores entities
- Order Repository → PostgreSQL: stores entities
