How baran-ozkann/ledger-payment-core works
Ledger Payment Core is a single-currency, double-entry payment service. Clients create accounts, fund them, transfer money, reverse transactions, and query account or transaction history. Mutating API calls pass through request hashing and idempotency before LedgerService posts balanced entries and outbox events in one database transaction. The outbox relay publishes account activity for a deduplicated projection; reconciliation checks ledger invariants, while retention jobs clean old records. The README documents these capabilities and integrations; unsampled subsystem links are omitted where callers were not shown.
Main entry points: LedgerService.java Ledger service · RequestHashFilter.java Request hash · TransferController.java Transfer API · FundingController.java Funding API
Components 24
API and requests
- Request hash
src/main/java/com/baran/ledger/config/RequestHashFilter.java - Account API
src/main/java/com/baran/ledger/api/AccountController.java - Transfer API
src/main/java/com/baran/ledger/api/TransferController.java - Funding API
src/main/java/com/baran/ledger/api/FundingController.java - Response mapping
src/main/java/com/baran/ledger/api/IdempotentResponse.java
Ledger posting
- Ledger service
src/main/java/com/baran/ledger/service/LedgerService.java - Accounts store
src/main/java/com/baran/ledger/store/AccountRepository.java - Transactions store
src/main/java/com/baran/ledger/store/TransactionRepository.java - Entries store
src/main/java/com/baran/ledger/store/EntryRepository.java - Idempotency store
src/main/java/com/baran/ledger/store/IdempotencyRepository.java
Events and projections
- Outbox store
src/main/java/com/baran/ledger/store/OutboxRepository.java - Outbox relay
src/main/java/com/baran/ledger/outbox/OutboxRelay.java - Activity publisher
src/main/java/com/baran/ledger/outbox/AccountActivityPublisher.java - Activity projection
src/main/java/com/baran/ledger/projection/AccountActivityProjection.java - Activity and dedup
src/main/java/com/baran/ledger/store/AccountActivityRepository.java - Consumed events
src/main/java/com/baran/ledger/store/ConsumedEventRepository.java
Integrity and retention
- Reconciliation
src/main/java/com/baran/ledger/recon/ReconciliationJob.java - Retention jobs
src/main/java/com/baran/ledger/retention/OutboxArchivalJob.java - Key cleanup
src/main/java/com/baran/ledger/retention/IdempotencyKeyCleanupJob.java - Transfer metrics
src/main/java/com/baran/ledger/config/TransferMetrics.java
Other components
- Client
- Kafka
- Prometheus
- Load scenarios
load/k6/ledger.js
Connections 26
- Client → Request hash: sends request
- Request hash → Transfer API: provides hash
src/main/java/com/baran/ledger/api/TransferController.java - Request hash → Account API: provides hash
src/main/java/com/baran/ledger/api/AccountController.java - Request hash → Funding API: provides hash
src/main/java/com/baran/ledger/api/FundingController.java - Transfer API → Ledger service: calls transfers
src/main/java/com/baran/ledger/api/TransferController.java - Funding API → Ledger service: calls funding
src/main/java/com/baran/ledger/api/FundingController.java - Account API → Ledger service: calls account ops
src/main/java/com/baran/ledger/api/AccountController.java - Transfer API → Response mapping: wraps response
src/main/java/com/baran/ledger/api/TransferController.java - Funding API → Response mapping: wraps response
src/main/java/com/baran/ledger/api/FundingController.java - Ledger service → Accounts store: reads and updates
src/main/java/com/baran/ledger/service/LedgerService.java - Ledger service → Transactions store: records transaction
src/main/java/com/baran/ledger/service/LedgerService.java - Ledger service → Entries store: posts entries
src/main/java/com/baran/ledger/service/LedgerService.java - Ledger service → Idempotency store: claims and replays
src/main/java/com/baran/ledger/service/LedgerService.java - Ledger service → Outbox store: appends events
src/main/java/com/baran/ledger/service/LedgerService.java - Outbox store → Outbox relay: supplies pending rows
src/main/java/com/baran/ledger/outbox/OutboxRelay.java - Outbox relay → Activity publisher: publishes events
src/main/java/com/baran/ledger/outbox/OutboxRelay.java - Activity publisher → Kafka: sends activity
- Kafka → Activity projection: delivers events
- Activity projection → Activity and dedup: writes activity
src/main/java/com/baran/ledger/projection/AccountActivityProjection.java - Activity projection → Consumed events: deduplicates events
src/main/java/com/baran/ledger/projection/AccountActivityProjection.java - Reconciliation → Accounts store: checks balances
src/main/java/com/baran/ledger/recon/ReconciliationJob.java - Reconciliation → Entries store: sums postings
src/main/java/com/baran/ledger/recon/ReconciliationJob.java - Retention jobs → Outbox store: archives published
src/main/java/com/baran/ledger/retention/OutboxArchivalJob.java - Key cleanup → Idempotency store: cleans expired keys
- Prometheus → Transfer metrics: scrapes metrics
- Load scenarios → Transfer API: posts transfers
load/k6/ledger.js