How firefly-oss/core-banking-ledger works
Core Banking Ledger is a reactive banking microservice for transaction and related-record CRUD, not financial calculation or payment processing. A client submits transaction requests through the REST API; services manage transaction records and payment-specific details, with status changes tracked as history, while the data layer persists the records. The README also identifies double-entry legs, attachments, and statement generation as product capabilities. Source excerpts confirm the transaction and attachment controller-to-service paths; connections to unsampled service and persistence internals are documented at the module level only.
Main entry points: repositories Related Records · TransactionController.java Transactions API · TransactionAttachmentController.java Attachments API · TransactionServiceImpl.java Transaction CRUD
Components 14
REST API
- Transactions API
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/core/v1/TransactionController.java - Attachments API
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/attachment/v1/TransactionAttachmentController.java - Payment Line APIs
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers - Statements API
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/statement/v1
Ledger Services
- Transaction CRUD
core-banking-ledger-core/src/main/java/com/firefly/core/banking/ledger/core/services/core/v1/TransactionServiceImpl.java - Attachment CRUD
core-banking-ledger-core/src/main/java/com/firefly/core/banking/ledger/core/services/attachment/v1/TransactionAttachmentServiceImpl.java - Payment Lines
core-banking-ledger-core/src/main/java/com/firefly/core/banking/ledger/core/services - Status History
core-banking-ledger-core/src/main/java/com/firefly/core/banking/ledger/core/services/core/v1/TransactionStatusHistoryServiceImpl.java - Accounting Legs
core-banking-ledger-core/src/main/java/com/firefly/core/banking/ledger/core/services/leg/v1/TransactionLegServiceImpl.java - Statement Generation
core-banking-ledger-core/src/main/java/com/firefly/core/banking/ledger/core/services/statement/v1/StatementServiceImpl.java
API Contracts
- DTO Contracts
core-banking-ledger-interfaces/src/main/java/com/firefly/core/banking/ledger/interfaces/dtos
Persistence
- Ledger Records
core-banking-ledger-models/src/main/java/com/firefly/core/banking/ledger/models/repositories/core/v1/TransactionRepository.java - Related Records
core-banking-ledger-models/src/main/java/com/firefly/core/banking/ledger/models/repositories
Other components
- API Client
Connections 17
- API Client → Transactions API: sends requests
README.md - Transactions API → Transaction CRUD: calls
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/core/v1/TransactionController.java - API Client → Attachments API: sends requests
README.md - Attachments API → Attachment CRUD: calls
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/attachment/v1/TransactionAttachmentController.java - API Client → Payment Line APIs: sends requests
README.md - API Client → Statements API: sends requests
README.md - Transactions API → DTO Contracts: accepts and returns
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/core/v1/TransactionController.java - Attachments API → DTO Contracts: accepts and returns
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/attachment/v1/TransactionAttachmentController.java - Transaction CRUD → Status History: records status changes
- Transaction CRUD → Ledger Records: persists transactions
README.md - Attachment CRUD → Related Records: persists attachments
README.md - Payment Line APIs → Payment Lines: delegates CRUD
core-banking-ledger-web/src/main/java/com/firefly/core/banking/ledger/web/controllers/core/v1/TransactionController.java - Statements API → Statement Generation: delegates generation
- Payment Lines → Related Records: persists line records
README.md - Status History → Related Records: persists history
README.md - Accounting Legs → Related Records: persists legs
README.md - Statement Generation → Related Records: reads ledger data