# vusisean11/loan-system architecture

> Architecture diagram of the GitHub repository vusisean11/loan-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vusisean11/loan-system
- Repository: https://github.com/vusisean11/loan-system

## Overview

DigiFi is an open-source loan-origination platform combining a lending CRM, configurable decision engine, machine learning, and APIs. A representative CRM workflow is an authenticated API request that passes through route middleware and transforms to an application controller, which reads or writes lending data and returns a response. The README documents broader underwriting, document, e-sign, task-automation, and model-training capabilities. Those subsystems are represented where the tree supports them, but most of their implementation and wiring was not sampled; dashed links mark these limits.

Main entry points: [`content/container/decision-engine-service-container/routers/lap/applications.js`](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/routers/lap/applications.js) (Application routes), [`content/container/decision-engine-service-container/controllers/los/application.js`](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/los/application.js) (Application workflow), [`content/container/decision-engine-service-container/controllers/overrides/strategy.js`](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/overrides/strategy.js) (Rules and strategies), [`content/container/decision-engine-service-container/routers/los.js`](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/routers/los.js) (Lending routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_lap_routes["Application routes<br/>[applications.js]"]
  node_controller_index["Controller registry<br/>[index.js]"]
  node_transforms["Request transforms<br/>[transform.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_api_controller["API controller<br/>[api.js]"]
  node_integration["Integrations<br/>[integration.js]"]
end

subgraph group_lending["Lending CRM"]
  node_los_controller["Application workflow<br/>[application.js]"]
  node_lap_controllers["Lending API handlers<br/>[application.js]"]
  node_los_routes["Lending routes<br/>[los.js]"]
  node_crm_ui["CRM interface"]
end

subgraph group_decision["Decision services"]
  node_decision_controller["Decision evaluation<br/>[decision.js]"]
  node_rules["Rules and strategies<br/>[strategy.js]"]
  node_simulation["Simulation<br/>[simulation.js]"]
  node_optimization["Optimization<br/>[optimization.js]"]
end

subgraph group_learning["Machine learning"]
  node_ml_controller["ML operations<br/>[ml.js]"]
  node_ml_resources["Model execution"]
  node_ml_jobs["ML training jobs"]
  node_ocr["Document OCR<br/>[ocr.js]"]
end

subgraph group_platform["Platform data"]
  node_standard_controllers["Standard CRUD"]
  node_los_data[("Lending records")]
  node_standard_data[("Shared records")]
end

node_user(("API client"))

node_user -.->|"submits request"| node_lap_routes
node_lap_routes -->|"loads handlers"| node_controller_index
node_lap_routes -->|"authenticates"| node_auth
node_lap_routes -->|"transforms request"| node_transforms
node_lap_routes -->|"dispatches application"| node_lap_controllers
node_lap_routes -->|"dispatches application"| node_los_controller
node_los_controller -->|"reads and writes"| node_los_data
node_los_routes -.->|"routes requests"| node_los_controller
node_crm_ui -.->|"loads CRM data"| node_los_routes
node_api_controller -.->|"uses CRUD"| node_standard_controllers
node_standard_controllers -->|"builds CRUD for"| node_standard_data
node_integration -.->|"connects systems"| node_user
node_decision_controller -.->|"evaluates decisions"| node_rules
node_simulation -.->|"tests strategies"| node_rules
node_optimization -.->|"optimizes decisions"| node_rules
node_ml_controller -.->|"runs models"| node_ml_resources
node_ml_jobs -.->|"updates models"| node_ml_resources
node_ocr -.->|"extracts documents"| node_los_data

click node_lap_routes "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/routers/lap/applications.js"
click node_controller_index "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/index.js"
click node_transforms "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/transform.js"
click node_auth "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/auth.js"
click node_api_controller "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/api.js"
click node_integration "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/integration.js"
click node_los_controller "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/los/application.js"
click node_lap_controllers "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/lap_api/application.js"
click node_los_routes "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/routers/los.js"
click node_crm_ui "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/views/los/applications/detail_tasks.manifest.js"
click node_decision_controller "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/decision.js"
click node_rules "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/overrides/strategy.js"
click node_simulation "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/simulation.js"
click node_optimization "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/optimization.js"
click node_ml_controller "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/ml.js"
click node_ml_resources "https://github.com/vusisean11/loan-system/tree/master/content/container/decision-engine-service-container/utilities/mlresource"
click node_ml_jobs "https://github.com/vusisean11/loan-system/tree/master/content/container/decision-engine-service-container/utilities/mlcrons"
click node_ocr "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/ocr.js"
click node_standard_controllers "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/utilities/standard_controllers.js"
click node_los_data "https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/config/databases/standard/models/losapplication.mongoose.js"
click node_standard_data "https://github.com/vusisean11/loan-system/tree/master/content/config/databases/standard/models"

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_lap_routes,node_controller_index,node_transforms,node_auth,node_api_controller,node_integration,node_user toneBlue
class node_los_controller,node_lap_controllers,node_los_routes,node_crm_ui toneAmber
class node_decision_controller,node_rules,node_simulation,node_optimization toneMint
class node_ml_controller,node_ml_resources,node_ml_jobs,node_ocr toneRose
class node_standard_controllers,node_los_data,node_standard_data toneIndigo
```

## Components

### API and access

- [Application routes](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/routers/lap/applications.js): `content/container/decision-engine-service-container/routers/lap/applications.js`
- [Controller registry](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/index.js): `content/container/decision-engine-service-container/controllers/index.js`
- [Request transforms](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/transform.js): `content/container/decision-engine-service-container/controllers/transform.js`
- [Authentication](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/auth.js): `content/container/decision-engine-service-container/controllers/auth.js`
- [API controller](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/api.js): `content/container/decision-engine-service-container/controllers/api.js`
- [Integrations](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/integration.js): `content/container/decision-engine-service-container/controllers/integration.js`

### Lending CRM

- [Application workflow](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/los/application.js): `content/container/decision-engine-service-container/controllers/los/application.js`
- [Lending API handlers](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/lap_api/application.js): `content/container/decision-engine-service-container/controllers/lap_api/application.js`
- [Lending routes](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/routers/los.js): `content/container/decision-engine-service-container/routers/los.js`
- [CRM interface](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/views/los/applications/detail_tasks.manifest.js): `content/container/decision-engine-service-container/views/los/applications/detail_tasks.manifest.js`

### Decision services

- [Decision evaluation](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/decision.js): `content/container/decision-engine-service-container/controllers/decision.js`
- [Rules and strategies](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/overrides/strategy.js): `content/container/decision-engine-service-container/controllers/overrides/strategy.js`
- [Simulation](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/simulation.js): `content/container/decision-engine-service-container/controllers/simulation.js`
- [Optimization](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/optimization.js): `content/container/decision-engine-service-container/controllers/optimization.js`

### Machine learning

- [ML operations](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/ml.js): `content/container/decision-engine-service-container/controllers/ml.js`
- [Model execution](https://github.com/vusisean11/loan-system/tree/master/content/container/decision-engine-service-container/utilities/mlresource): `content/container/decision-engine-service-container/utilities/mlresource`
- [ML training jobs](https://github.com/vusisean11/loan-system/tree/master/content/container/decision-engine-service-container/utilities/mlcrons): `content/container/decision-engine-service-container/utilities/mlcrons`
- [Document OCR](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/controllers/ocr.js): `content/container/decision-engine-service-container/controllers/ocr.js`

### Platform data

- [Standard CRUD](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/utilities/standard_controllers.js): `content/container/decision-engine-service-container/utilities/standard_controllers.js`
- [Lending records](https://github.com/vusisean11/loan-system/blob/master/content/container/decision-engine-service-container/config/databases/standard/models/losapplication.mongoose.js): `content/container/decision-engine-service-container/config/databases/standard/models/losapplication.mongoose.js`
- [Shared records](https://github.com/vusisean11/loan-system/tree/master/content/config/databases/standard/models): `content/config/databases/standard/models`

### Other components

- **API client**

## Connections

- API client → Application routes: submits request
- Application routes → Controller registry: loads handlers (evidence: `content/container/decision-engine-service-container/routers/lap/applications.js`)
- Application routes → Authentication: authenticates (evidence: `content/container/decision-engine-service-container/routers/lap/applications.js`)
- Application routes → Request transforms: transforms request (evidence: `content/container/decision-engine-service-container/routers/lap/applications.js`)
- Application routes → Lending API handlers: dispatches application (evidence: `content/container/decision-engine-service-container/routers/lap/applications.js`)
- Application routes → Application workflow: dispatches application (evidence: `content/container/decision-engine-service-container/routers/lap/applications.js`)
- Application workflow → Lending records: reads and writes (evidence: `content/container/decision-engine-service-container/controllers/los/application.js`)
- Lending routes → Application workflow: routes requests
- CRM interface → Lending routes: loads CRM data
- API controller → Standard CRUD: uses CRUD
- Standard CRUD → Shared records: builds CRUD for (evidence: `content/container/decision-engine-service-container/utilities/standard_controllers.js`)
- Integrations → API client: connects systems
- Decision evaluation → Rules and strategies: evaluates decisions
- Simulation → Rules and strategies: tests strategies
- Optimization → Rules and strategies: optimizes decisions
- ML operations → Model execution: runs models
- ML training jobs → Model execution: updates models
- Document OCR → Lending records: extracts documents
