# firefly-oss/core-lending-loan-origination architecture

> Architecture diagram of the GitHub repository firefly-oss/core-lending-loan-origination, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/firefly-oss/core-lending-loan-origination
- Repository: https://github.com/firefly-oss/core-lending-loan-origination

## Overview

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: [`core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers`](https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers) (REST controllers), [`core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories`](https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories) (Reactive repositories), [`core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/SimulationServiceImpl.java`](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/SimulationServiceImpl.java) (Loan simulations), [`core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationsServiceImpl.java`](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationsServiceImpl.java) (Loan applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API boundary"]
  node_controllers["REST controllers"]
  node_contracts["DTOs and enums"]
end

subgraph group_origination["Application origination"]
  node_applications["Loan applications"]
  node_parties["Application parties"]
  node_documents["Application documents"]
  node_offers["Proposed offers"]
  node_simulation["Loan simulations"]
  node_status["Application status"]
  node_history["Status history"]
end

subgraph group_underwriting["Underwriting"]
  node_underwriting["Underwriting decisions"]
  node_scoring["Application scoring"]
end

subgraph group_persistence["Persistence"]
  node_data[("Origination records")]
  node_repositories["Reactive repositories"]
end

node_client(("API client"))
node_pricing["Pricing engine"]

node_client -->|"sends requests"| node_controllers
node_controllers -.->|"uses payloads"| node_contracts
node_controllers -.->|"routes requests"| node_applications
node_controllers -->|"routes requests"| node_parties
node_controllers -.->|"routes requests"| node_documents
node_controllers -.->|"routes requests"| node_offers
node_controllers -->|"routes requests"| node_simulation
node_controllers -->|"routes requests"| node_status
node_controllers -.->|"routes requests"| node_history
node_controllers -.->|"routes requests"| node_underwriting
node_controllers -.->|"routes requests"| node_scoring
node_applications -.->|"persists records"| node_repositories
node_parties -->|"reads and writes"| node_repositories
node_documents -.->|"persists records"| node_repositories
node_offers -.->|"persists records"| node_repositories
node_simulation -.->|"persists records"| node_repositories
node_status -.->|"persists records"| node_repositories
node_history -.->|"persists records"| node_repositories
node_underwriting -.->|"persists decisions"| node_repositories
node_scoring -.->|"persists scores"| node_repositories
node_repositories -.->|"reads and writes"| node_data
node_pricing -.->|"provides calculations"| node_simulation

click node_controllers "https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers"
click node_contracts "https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-interfaces/src/main/java/com/firefly/core/lending/origination/interfaces"
click node_applications "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationsServiceImpl.java"
click node_parties "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationPartyServiceImpl.java"
click node_documents "https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services"
click node_offers "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ProposedOfferServiceImpl.java"
click node_simulation "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/SimulationServiceImpl.java"
click node_status "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationStatusServiceImpl.java"
click node_history "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationStatusHistoryServiceImpl.java"
click node_underwriting "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingDecisionService.java"
click node_scoring "https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingScoreService.java"
click node_data "https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/entities"
click node_repositories "https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_controllers,node_contracts,node_client toneBlue
class node_applications,node_parties,node_documents,node_offers,node_simulation,node_status,node_history toneAmber
class node_underwriting,node_scoring toneMint
class node_data,node_repositories toneRose
class node_pricing toneIndigo
```

## Components

### API boundary

- [REST controllers](https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers): `core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers`
- [DTOs and enums](https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-interfaces/src/main/java/com/firefly/core/lending/origination/interfaces): `core-lending-loan-origination-interfaces/src/main/java/com/firefly/core/lending/origination/interfaces`

### Application origination

- [Loan applications](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationsServiceImpl.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationsServiceImpl.java`
- [Application parties](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationPartyServiceImpl.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationPartyServiceImpl.java`
- [Application documents](https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services`
- [Proposed offers](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ProposedOfferServiceImpl.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ProposedOfferServiceImpl.java`
- [Loan simulations](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/SimulationServiceImpl.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/SimulationServiceImpl.java`
- [Application status](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationStatusServiceImpl.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationStatusServiceImpl.java`
- [Status history](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationStatusHistoryServiceImpl.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/LoanApplicationStatusHistoryServiceImpl.java`

### Underwriting

- [Underwriting decisions](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingDecisionService.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingDecisionService.java`
- [Application scoring](https://github.com/firefly-oss/core-lending-loan-origination/blob/main/core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingScoreService.java): `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/UnderwritingScoreService.java`

### Persistence

- [Origination records](https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/entities): `core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/entities`
- [Reactive repositories](https://github.com/firefly-oss/core-lending-loan-origination/tree/main/core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories): `core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories`

### Other components

- **API client**
- **Pricing engine**

## Connections

- API client → REST controllers: sends requests
- REST controllers → DTOs and enums: uses payloads (evidence: `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 (evidence: `core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers/ApplicationPartyQueryController.java`)
- REST controllers → Application documents: routes requests (evidence: `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 (evidence: `core-lending-loan-origination-web/src/main/java/com/firefly/core/lending/origination/web/controllers/SimulationController.java`)
- REST controllers → Application status: routes requests (evidence: `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 (evidence: `core-lending-loan-origination-core/src/main/java/com/firefly/core/lending/origination/core/services/impl/ApplicationPartyServiceImpl.java`)
- Application documents → Reactive repositories: persists records (evidence: `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 (evidence: `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 (evidence: `core-lending-loan-origination-models/src/main/java/com/firefly/core/lending/origination/models/repositories/ApplicationExternalBankAccountRepository.java`)
- Pricing engine → Loan simulations: provides calculations
