How firefly-oss/core-lending-loan-origination works
This is a reactive loan-origination microservice: clients submit and manage applications, parties, documents, and offers, then the service supports underwriting, scoring, decisions, and status-history tracking. The principal runtime path is REST controllers through core services to reactive repositories and PostgreSQL; the README documents those module responsibilities. Application-party and simulation excerpts confirm selected controller-to-service behavior, and a party-service excerpt confirms repository and mapper use. Other feature paths are represented from the README and tree; their implementation-level calls were not sampled, so those links are dashed.
Main entry points: controllers REST controllers · repositories Reactive repositories · SimulationServiceImpl.java Loan simulations · LoanApplicationsServiceImpl.java Loan applications
Components 15
API boundary
- REST controllers
core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers - DTOs and enums
core-lending-loan-origination-interfaces/src/main/java/com/firefly/core/lending/origination/interfaces
Application origination
- Loan applications
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationsServiceImpl.java - Application parties
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationPartyServiceImpl.java - Application documents
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services - Proposed offers
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ProposedOfferServiceImpl.java - Loan simulations
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/SimulationServiceImpl.java - Application status
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationStatusServiceImpl.java - Status history
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationStatusHistoryServiceImpl.java
Underwriting
- Underwriting decisions
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingDecisionService.java - Application scoring
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingScoreService.java
Persistence
- Origination records
core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/entities - Reactive repositories
core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories
Other components
- API client
- Pricing engine
Connections 22
- API client → REST controllers: sends requests
- REST controllers → DTOs and enums: uses payloads
core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers/ApplicationPartyQueryController.java - REST controllers → Loan applications: routes requests
- REST controllers → Application parties: routes requests
core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers/ApplicationPartyQueryController.java - REST controllers → Application documents: routes requests
core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers/ApplicationPartyQueryController.java - REST controllers → Proposed offers: routes requests
- REST controllers → Loan simulations: routes requests
core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers/SimulationController.java - REST controllers → Application status: routes requests
core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers/ApplicationStatusController.java - REST controllers → Status history: routes requests
- REST controllers → Underwriting decisions: routes requests
- REST controllers → Application scoring: routes requests
- Loan applications → Reactive repositories: persists records
- Application parties → Reactive repositories: reads and writes
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationPartyServiceImpl.java - Application documents → Reactive repositories: persists records
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationPartyServiceImpl.java - Proposed offers → Reactive repositories: persists records
- Loan simulations → Reactive repositories: persists records
- Application status → Reactive repositories: persists records
core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationStatusServiceImpl.java - Status history → Reactive repositories: persists records
- Underwriting decisions → Reactive repositories: persists decisions
- Application scoring → Reactive repositories: persists scores
- Reactive repositories → Origination records: reads and writes
core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories/ApplicationExternalBankAccountRepository.java - Pricing engine → Loan simulations: provides calculations