How saransh-chauhan/fintech-core works
FintechCore is a Spring Boot fintech microservices project. Its clearest implemented workflow is wallet management: a client submits wallet operations, which the wallet service handles and persists; the README describes create, credit, debit, transfer, and wallet status operations. The README also documents payment processing, immutable ledger records, and notifications, but their source directories contain only placeholders in this tree, so their internal flows are not verifiable. Edges for wallet layering are dashed where the sampled source does not show the calls.
Main entry points: payment Payment processor · WalletController.java Wallet API · WalletDomainServiceImpl.java Wallet domain · Wallet.java Wallet state
Components 19
Wallet service
- Wallet API
wallet-service/src/main/java/com/saransh/fintech/wallet/controller/WalletController.java - Wallet operations
wallet-service/src/main/java/com/saransh/fintech/wallet/service/application/WalletApplicationServiceImpl.java - Wallet domain
wallet-service/src/main/java/com/saransh/fintech/wallet/service/domain/WalletDomainServiceImpl.java - Wallet mapping
wallet-service/src/main/java/com/saransh/fintech/wallet/mapper/WalletMapper.java - Wallet API models
wallet-service/src/main/java/com/saransh/fintech/wallet/dto/request/TransferWalletRequest.java - Wallet state
wallet-service/src/main/java/com/saransh/fintech/wallet/entity/Wallet.java - Wallet repository
wallet-service/src/main/java/com/saransh/fintech/wallet/repository/WalletRepository.java - Wallet database
wallet-service/src/main/resources/db/migration/V1__create_wallet_schema.sql - API error handling
wallet-service/src/main/java/com/saransh/fintech/wallet/exception/GlobalExceptionHandler.java - Correlation tracking
wallet-service/src/main/java/com/saransh/fintech/wallet/filter/CorrelationIdFilter.java - Health and version
wallet-service/src/main/java/com/saransh/fintech/wallet/metrics/HealthController.java
Payment processing
- Payment processor
payment-service/src/main/java/com/saransh/fintech/payment - Idempotency and outbox
payment-service/src/main/java/com/saransh/fintech/payment
Ledger and notifications
- Immutable ledger
ledger-service/src/main/java/com/saransh/fintech/ledger - Notifications
notification-service/src/main/java/com/saransh/fintech/notification
Shared and infrastructure
- Payment events
common/src/main/java/com/saransh/fintech/common/events - Kafka
- Redis
Other components
- API client
Connections 19
- API client → Wallet API: calls
README.md - Wallet API → Wallet operations: delegates to
- Wallet operations → Wallet domain: coordinates
- Wallet domain → Wallet mapping: maps
- Wallet domain → Wallet repository: accesses
- Wallet mapping → Wallet state: maps state
wallet-service/src/main/java/com/saransh/fintech/wallet/mapper/WalletMapper.java - Wallet repository → Wallet state: persists
wallet-service/src/main/java/com/saransh/fintech/wallet/repository/WalletRepository.java - Wallet state → Wallet database: maps table
- Wallet API → Wallet API models: accepts
- Wallet API → API error handling: returns errors
- API client → Health and version: checks status
wallet-service/src/main/java/com/saransh/fintech/wallet/metrics/HealthController.java - Payment processor → Idempotency and outbox: uses
README.md - Payment processor → Payment events: publishes
- Payment processor → Immutable ledger: records payment
- Payment processor → Notifications: triggers notice
- Payment processor → Redis: checks idempotency
README.md - Payment events → Kafka: communicates via
README.md - Kafka → Immutable ledger: dispatches events
- Kafka → Notifications: dispatches events