# nisharj/fincore architecture

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

- Interactive diagram: https://gitdiagram.com/nisharj/fincore
- Repository: https://github.com/nisharj/fincore

## Overview

Fincore is a distributed banking platform. A typical user journey passes through the gateway to register or log in, complete email-OTP customer verification, create an account, then deposit, withdraw, or transfer funds; transactions call account operations and support idempotency and transfer recovery. Customer profiles, account ledgers, and transaction records are separate domains. The README also describes discovery, configuration, and planned service extensions. Several cross-service links and subsystems are documented but unsampled, so those edges are dashed and marked unverified.

Main entry points: [`api-gatway/src/main/java/com/fincore/api_gatway/config/JwtGatewayConfig.java`](https://github.com/nisharj/fincore/blob/main/api-gatway/src/main/java/com/fincore/api_gatway/config/JwtGatewayConfig.java) (API gateway), [`account-service/src/main/java/com/fincore/account_service/service/AccountService.java`](https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/service/AccountService.java) (Account management), [`transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java`](https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java) (Transaction orchestration), [`auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java`](https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and discovery"]
  node_gateway["API gateway"]
  node_jwt["JWT validation<br/>[JwtService.java]"]
  node_eureka["Service registry"]
  node_config["Config server"]
end

subgraph group_identity["Identity and onboarding"]
  node_authapi["Auth endpoints"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_users["User records<br/>[User.java]"]
  node_otp["OTP verification"]
  node_email["Email delivery<br/>[EmailService.java]"]
end

subgraph group_customer["Customer profiles"]
  node_customerapi["Customer API"]
  node_customers["Customer profiles"]
  node_customerdata[("Customer records<br/>[Customer.java]")]
end

subgraph group_accounts["Accounts and ledger"]
  node_accountapi["Account API"]
  node_accountservice["Account management"]
  node_accountdata[("Account balances<br/>[Account.java]")]
  node_operations["Ledger operations"]
  node_internalapi["Internal operations"]
end

subgraph group_transactions["Transaction processing"]
  node_transactionapi["Transaction API"]
  node_transactionservice["Transaction orchestration"]
  node_txnrecords[("Transaction records<br/>[Transaction.java]")]
  node_reconcile["Transfer reconciliation"]
end

node_client(("Client"))
node_payment["Payment extension"]
node_fraud["Fraud extension"]
node_loan["Loan extension"]
node_notification["Notification extension"]

node_client -.->|"sends requests"| node_gateway
node_gateway -.->|"validates tokens"| node_jwt
node_gateway -.->|"routes auth"| node_authapi
node_gateway -.->|"routes customers"| node_customerapi
node_gateway -.->|"routes accounts"| node_accountapi
node_gateway -.->|"routes transactions"| node_transactionapi
node_gateway -.->|"discovers services"| node_eureka
node_config -.->|"provides configuration"| node_gateway
node_authapi -.->|"delegates to"| node_auth
node_auth -->|"reads and saves"| node_users
node_auth -.->|"supports verification"| node_otp
node_otp -->|"sends code"| node_email
node_otp -->|"looks up customer"| node_customers
node_customerapi -->|"delegates to"| node_customers
node_customers -->|"persists profiles"| node_customerdata
node_accountapi -.->|"delegates to"| node_accountservice
node_accountservice -->|"manages accounts"| node_accountdata
node_accountservice -->|"checks verification"| node_authapi
node_accountservice -->|"validates customer"| node_customerapi
node_internalapi -->|"delegates to"| node_operations
node_operations -->|"mutates balances"| node_accountdata
node_transactionapi -->|"delegates to"| node_transactionservice
node_transactionservice -.->|"requests account operations"| node_internalapi
node_transactionservice -->|"records transactions"| node_txnrecords
node_reconcile -.->|"reconciles transfers"| node_transactionservice

click node_gateway "https://github.com/nisharj/fincore/blob/main/api-gatway/src/main/java/com/fincore/api_gatway/config/JwtGatewayConfig.java"
click node_jwt "https://github.com/nisharj/fincore/blob/main/api-gatway/src/main/java/com/fincore/api_gatway/security/JwtService.java"
click node_eureka "https://github.com/nisharj/fincore/blob/main/eureka-server/src/main/java/com/fincore/eureka_server/EurekaServerApplication.java"
click node_config "https://github.com/nisharj/fincore/blob/main/config-server/src/main/java/com/fincore/config_server/ConfigServerApplication.java"
click node_authapi "https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/controller/AuthController.java"
click node_auth "https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java"
click node_users "https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/entity/User.java"
click node_otp "https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java"
click node_email "https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/service/EmailService.java"
click node_customerapi "https://github.com/nisharj/fincore/blob/main/customer-service/src/main/java/com/fincore/customer_service/controller/CustomerController.java"
click node_customers "https://github.com/nisharj/fincore/blob/main/customer-service/src/main/java/com/fincore/customer_service/service/CustomerService.java"
click node_customerdata "https://github.com/nisharj/fincore/blob/main/customer-service/src/main/java/com/fincore/customer_service/entity/Customer.java"
click node_accountapi "https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/controller/AccountController.java"
click node_accountservice "https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/service/AccountService.java"
click node_accountdata "https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/entity/Account.java"
click node_operations "https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/service/InternalAccountOperationService.java"
click node_internalapi "https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/controller/InternalAccountOperationController.java"
click node_transactionapi "https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/controller/TransactionController.java"
click node_transactionservice "https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java"
click node_txnrecords "https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/entity/Transaction.java"
click node_reconcile "https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/service/TransferReconciliationScheduler.java"
click node_payment "https://github.com/nisharj/fincore/blob/main/payment-service/src/main/java/com/fincore/payment_service/PaymentServiceApplication.java"
click node_fraud "https://github.com/nisharj/fincore/blob/main/fraud-service/src/main/java/com/fincore/fraud_service/FraudServiceApplication.java"
click node_loan "https://github.com/nisharj/fincore/blob/main/loan-service/src/main/java/com/fincore/loan_service/LoanServiceApplication.java"
click node_notification "https://github.com/nisharj/fincore/blob/main/notification-service/src/main/java/com/fincore/notification_service/NotificationServiceApplication.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,node_jwt,node_eureka,node_config,node_client toneBlue
class node_authapi,node_auth,node_users,node_otp,node_email toneAmber
class node_customerapi,node_customers,node_customerdata toneMint
class node_accountapi,node_accountservice,node_accountdata,node_operations,node_internalapi toneRose
class node_transactionapi,node_transactionservice,node_txnrecords,node_reconcile toneIndigo
class node_payment,node_fraud,node_loan,node_notification toneTeal
```

## Components

### Entry and discovery

- [API gateway](https://github.com/nisharj/fincore/blob/main/api-gatway/src/main/java/com/fincore/api_gatway/config/JwtGatewayConfig.java): `api-gatway/src/main/java/com/fincore/api_gatway/config/JwtGatewayConfig.java`
- [JWT validation](https://github.com/nisharj/fincore/blob/main/api-gatway/src/main/java/com/fincore/api_gatway/security/JwtService.java): `api-gatway/src/main/java/com/fincore/api_gatway/security/JwtService.java`
- [Service registry](https://github.com/nisharj/fincore/blob/main/eureka-server/src/main/java/com/fincore/eureka_server/EurekaServerApplication.java): `eureka-server/src/main/java/com/fincore/eureka_server/EurekaServerApplication.java`
- [Config server](https://github.com/nisharj/fincore/blob/main/config-server/src/main/java/com/fincore/config_server/ConfigServerApplication.java): `config-server/src/main/java/com/fincore/config_server/ConfigServerApplication.java`

### Identity and onboarding

- [Auth endpoints](https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/controller/AuthController.java): `auth-service/src/main/java/com/fincore/auth_service/controller/AuthController.java`
- [Authentication](https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java): `auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java`
- [User records](https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/entity/User.java): `auth-service/src/main/java/com/fincore/auth_service/entity/User.java`
- [OTP verification](https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java): `auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java`
- [Email delivery](https://github.com/nisharj/fincore/blob/main/auth-service/src/main/java/com/fincore/auth_service/service/EmailService.java): `auth-service/src/main/java/com/fincore/auth_service/service/EmailService.java`

### Customer profiles

- [Customer API](https://github.com/nisharj/fincore/blob/main/customer-service/src/main/java/com/fincore/customer_service/controller/CustomerController.java): `customer-service/src/main/java/com/fincore/customer_service/controller/CustomerController.java`
- [Customer profiles](https://github.com/nisharj/fincore/blob/main/customer-service/src/main/java/com/fincore/customer_service/service/CustomerService.java): `customer-service/src/main/java/com/fincore/customer_service/service/CustomerService.java`
- [Customer records](https://github.com/nisharj/fincore/blob/main/customer-service/src/main/java/com/fincore/customer_service/entity/Customer.java): `customer-service/src/main/java/com/fincore/customer_service/entity/Customer.java`

### Accounts and ledger

- [Account API](https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/controller/AccountController.java): `account-service/src/main/java/com/fincore/account_service/controller/AccountController.java`
- [Account management](https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/service/AccountService.java): `account-service/src/main/java/com/fincore/account_service/service/AccountService.java`
- [Account balances](https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/entity/Account.java): `account-service/src/main/java/com/fincore/account_service/entity/Account.java`
- [Ledger operations](https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/service/InternalAccountOperationService.java): `account-service/src/main/java/com/fincore/account_service/service/InternalAccountOperationService.java`
- [Internal operations](https://github.com/nisharj/fincore/blob/main/account-service/src/main/java/com/fincore/account_service/controller/InternalAccountOperationController.java): `account-service/src/main/java/com/fincore/account_service/controller/InternalAccountOperationController.java`

### Transaction processing

- [Transaction API](https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/controller/TransactionController.java): `transaction-service/src/main/java/com/fincore/transaction_service/controller/TransactionController.java`
- [Transaction orchestration](https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java): `transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java`
- [Transaction records](https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/entity/Transaction.java): `transaction-service/src/main/java/com/fincore/transaction_service/entity/Transaction.java`
- [Transfer reconciliation](https://github.com/nisharj/fincore/blob/main/transaction-service/src/main/java/com/fincore/transaction_service/service/TransferReconciliationScheduler.java): `transaction-service/src/main/java/com/fincore/transaction_service/service/TransferReconciliationScheduler.java`

### Other components

- **Client**
- [Payment extension](https://github.com/nisharj/fincore/blob/main/payment-service/src/main/java/com/fincore/payment_service/PaymentServiceApplication.java): `payment-service/src/main/java/com/fincore/payment_service/PaymentServiceApplication.java`
- [Fraud extension](https://github.com/nisharj/fincore/blob/main/fraud-service/src/main/java/com/fincore/fraud_service/FraudServiceApplication.java): `fraud-service/src/main/java/com/fincore/fraud_service/FraudServiceApplication.java`
- [Loan extension](https://github.com/nisharj/fincore/blob/main/loan-service/src/main/java/com/fincore/loan_service/LoanServiceApplication.java): `loan-service/src/main/java/com/fincore/loan_service/LoanServiceApplication.java`
- [Notification extension](https://github.com/nisharj/fincore/blob/main/notification-service/src/main/java/com/fincore/notification_service/NotificationServiceApplication.java): `notification-service/src/main/java/com/fincore/notification_service/NotificationServiceApplication.java`

## Connections

- Client → API gateway: sends requests
- API gateway → JWT validation: validates tokens
- API gateway → Auth endpoints: routes auth
- API gateway → Customer API: routes customers
- API gateway → Account API: routes accounts
- API gateway → Transaction API: routes transactions
- API gateway → Service registry: discovers services
- Config server → API gateway: provides configuration
- Auth endpoints → Authentication: delegates to (evidence: `auth-service/src/main/java/com/fincore/auth_service/controller/AuthController.java`)
- Authentication → User records: reads and saves (evidence: `auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java`)
- Authentication → OTP verification: supports verification
- OTP verification → Email delivery: sends code (evidence: `auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java`)
- OTP verification → Customer profiles: looks up customer (evidence: `auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java`)
- Customer API → Customer profiles: delegates to (evidence: `customer-service/src/main/java/com/fincore/customer_service/controller/CustomerController.java`)
- Customer profiles → Customer records: persists profiles (evidence: `customer-service/src/main/java/com/fincore/customer_service/service/CustomerService.java`)
- Account API → Account management: delegates to (evidence: `account-service/src/main/java/com/fincore/account_service/controller/AccountController.java`)
- Account management → Account balances: manages accounts (evidence: `account-service/src/main/java/com/fincore/account_service/service/AccountService.java`)
- Account management → Auth endpoints: checks verification (evidence: `account-service/src/main/java/com/fincore/account_service/service/AccountService.java`)
- Account management → Customer API: validates customer (evidence: `account-service/src/main/java/com/fincore/account_service/service/AccountService.java`)
- Internal operations → Ledger operations: delegates to (evidence: `account-service/src/main/java/com/fincore/account_service/controller/InternalAccountOperationController.java`)
- Ledger operations → Account balances: mutates balances (evidence: `account-service/src/main/java/com/fincore/account_service/service/InternalAccountOperationService.java`)
- Transaction API → Transaction orchestration: delegates to (evidence: `transaction-service/src/main/java/com/fincore/transaction_service/controller/TransactionController.java`)
- Transaction orchestration → Internal operations: requests account operations
- Transaction orchestration → Transaction records: records transactions (evidence: `transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java`)
- Transfer reconciliation → Transaction orchestration: reconciles transfers
