How nisharj/fincore works
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: JwtGatewayConfig.java API gateway · AccountService.java Account management · TransactionService.java Transaction orchestration · AuthService.java Authentication
Components 26
Entry and discovery
- API gateway
api-gatway/src/main/java/com/fincore/api_gatway/config/JwtGatewayConfig.java - JWT validation
api-gatway/src/main/java/com/fincore/api_gatway/security/JwtService.java - Service registry
eureka-server/src/main/java/com/fincore/eureka_server/EurekaServerApplication.java - Config server
config-server/src/main/java/com/fincore/config_server/ConfigServerApplication.java
Identity and onboarding
- Auth endpoints
auth-service/src/main/java/com/fincore/auth_service/controller/AuthController.java - Authentication
auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java - User records
auth-service/src/main/java/com/fincore/auth_service/entity/User.java - OTP verification
auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java - Email delivery
auth-service/src/main/java/com/fincore/auth_service/service/EmailService.java
Customer profiles
- Customer API
customer-service/src/main/java/com/fincore/customer_service/controller/CustomerController.java - Customer profiles
customer-service/src/main/java/com/fincore/customer_service/service/CustomerService.java - Customer records
customer-service/src/main/java/com/fincore/customer_service/entity/Customer.java
Accounts and ledger
- Account API
account-service/src/main/java/com/fincore/account_service/controller/AccountController.java - Account management
account-service/src/main/java/com/fincore/account_service/service/AccountService.java - Account balances
account-service/src/main/java/com/fincore/account_service/entity/Account.java - Ledger operations
account-service/src/main/java/com/fincore/account_service/service/InternalAccountOperationService.java - Internal operations
account-service/src/main/java/com/fincore/account_service/controller/InternalAccountOperationController.java
Transaction processing
- Transaction API
transaction-service/src/main/java/com/fincore/transaction_service/controller/TransactionController.java - Transaction orchestration
transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java - Transaction records
transaction-service/src/main/java/com/fincore/transaction_service/entity/Transaction.java - Transfer reconciliation
transaction-service/src/main/java/com/fincore/transaction_service/service/TransferReconciliationScheduler.java
Other components
- Client
- Payment extension
payment-service/src/main/java/com/fincore/payment_service/PaymentServiceApplication.java - Fraud extension
fraud-service/src/main/java/com/fincore/fraud_service/FraudServiceApplication.java - Loan extension
loan-service/src/main/java/com/fincore/loan_service/LoanServiceApplication.java - Notification extension
notification-service/src/main/java/com/fincore/notification_service/NotificationServiceApplication.java
Connections 25
- 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
auth-service/src/main/java/com/fincore/auth_service/controller/AuthController.java - Authentication → User records: reads and saves
auth-service/src/main/java/com/fincore/auth_service/service/AuthService.java - Authentication → OTP verification: supports verification
- OTP verification → Email delivery: sends code
auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java - OTP verification → Customer profiles: looks up customer
auth-service/src/main/java/com/fincore/auth_service/service/CustomerVerificationService.java - Customer API → Customer profiles: delegates to
customer-service/src/main/java/com/fincore/customer_service/controller/CustomerController.java - Customer profiles → Customer records: persists profiles
customer-service/src/main/java/com/fincore/customer_service/service/CustomerService.java - Account API → Account management: delegates to
account-service/src/main/java/com/fincore/account_service/controller/AccountController.java - Account management → Account balances: manages accounts
account-service/src/main/java/com/fincore/account_service/service/AccountService.java - Account management → Auth endpoints: checks verification
account-service/src/main/java/com/fincore/account_service/service/AccountService.java - Account management → Customer API: validates customer
account-service/src/main/java/com/fincore/account_service/service/AccountService.java - Internal operations → Ledger operations: delegates to
account-service/src/main/java/com/fincore/account_service/controller/InternalAccountOperationController.java - Ledger operations → Account balances: mutates balances
account-service/src/main/java/com/fincore/account_service/service/InternalAccountOperationService.java - Transaction API → Transaction orchestration: delegates to
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
transaction-service/src/main/java/com/fincore/transaction_service/service/TransactionService.java - Transfer reconciliation → Transaction orchestration: reconciles transfers