# apknation/daire architecture

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

- Interactive diagram: https://gitdiagram.com/apknation/daire
- Repository: https://github.com/apknation/daire

## Overview

DAIRE is a credit-risk and borrower-data platform: operators sign in, review dashboard and assessment information, manage borrower/lender records, and use data-exchange workflows. The repository also contains backend scoring services, a separate middleware scoring engine, and typed blockchain contract bindings. The UI-to-API calls and sampled scoring dependencies are visible; backend routing and several integration links are not, so those connections are omitted rather than inferred.

Main entry points: [`DAIRE/frontend/src/app/core/api.service.ts`](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/core/api.service.ts) (API client), [`DAIRE/backend/core/services.py`](https://github.com/apknation/daire/blob/main/DAIRE/backend/core/services.py) (Credit services), [`DAIRE/frontend/src/app/login/login.component.ts`](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/login/login.component.ts) (Login), [`DAIRE/frontend/src/app/dashboard/dashboard.component.ts`](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/dashboard/dashboard.component.ts) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator_ui["Operator interface"]
  node_login["Login<br/>[login.component.ts]"]
  node_auth["Session auth<br/>[auth.service.ts]"]
  node_routing["Page routing<br/>[app.routes.ts]"]
  node_dashboard["Dashboard"]
  node_assessments["Assessments"]
  node_records["Records"]
  node_exchange["Data exchange"]
  node_management["Data management"]
  node_api_client["API client<br/>[api.service.ts]"]
end

subgraph group_credit_backend["Credit backend"]
  node_backend_api["Backend API<br/>[views.py]"]
  node_domain_data[("Credit records<br/>[models.py]")]
  node_credit_services["Credit services<br/>[services.py]"]
end

subgraph group_scoring["Scoring engines"]
  node_nmb_scorecard["NMB scorecard<br/>[nmb_engine.py]"]
  node_middleware["Middleware API<br/>[index.js]"]
  node_score_engine["Off-chain scoring<br/>[scoreEngine.js]"]
end

subgraph group_blockchain["Blockchain bindings"]
  node_credit_contract["Credit contract types"]
  node_handshake_types["Handshake types<br/>[DaireHandshake.ts]"]
  node_credit_factory["Credit contract factory"]
  node_handshake_factory["Handshake factory"]
end

node_operator(("Operator"))

node_operator -->|"signs in"| node_login
node_login -->|"submits credentials"| node_auth
node_operator -->|"reviews"| node_dashboard
node_operator -->|"opens"| node_assessments
node_operator -->|"manages records"| node_records
node_operator -->|"uses"| node_exchange
node_operator -->|"manages data"| node_management
node_dashboard -->|"requests data"| node_api_client
node_assessments -->|"requests assessments"| node_api_client
node_records -->|"requests records"| node_api_client
node_exchange -->|"exchanges data"| node_api_client
node_management -->|"updates data"| node_api_client
node_credit_services -->|"reads and writes"| node_domain_data
node_credit_services -->|"uses scorecard"| node_nmb_scorecard
node_middleware -->|"uses scoring"| node_score_engine
node_credit_factory -->|"creates and connects"| node_credit_contract
node_handshake_factory -->|"creates and connects"| node_handshake_types

click node_login "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/login/login.component.ts"
click node_auth "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/core/auth.service.ts"
click node_routing "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/app.routes.ts"
click node_dashboard "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/dashboard/dashboard.component.ts"
click node_assessments "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/assessments/assessments.component.ts"
click node_records "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/records/records.component.ts"
click node_exchange "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/data-exchange/data-exchange.component.ts"
click node_management "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/data-management/data-management.component.ts"
click node_api_client "https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/core/api.service.ts"
click node_backend_api "https://github.com/apknation/daire/blob/main/DAIRE/backend/core/views.py"
click node_domain_data "https://github.com/apknation/daire/blob/main/DAIRE/backend/core/models.py"
click node_credit_services "https://github.com/apknation/daire/blob/main/DAIRE/backend/core/services.py"
click node_nmb_scorecard "https://github.com/apknation/daire/blob/main/DAIRE/backend/core/nmb_engine.py"
click node_middleware "https://github.com/apknation/daire/blob/main/daire-middleware/index.js"
click node_score_engine "https://github.com/apknation/daire/blob/main/daire-middleware/scoreEngine.js"
click node_credit_contract "https://github.com/apknation/daire/blob/main/types/ethers-contracts/DaireCreditScore.ts"
click node_handshake_types "https://github.com/apknation/daire/blob/main/types/ethers-contracts/DaireHandshake.ts"
click node_credit_factory "https://github.com/apknation/daire/blob/main/types/ethers-contracts/factories/DaireCreditScore__factory.ts"
click node_handshake_factory "https://github.com/apknation/daire/blob/main/types/ethers-contracts/factories/DaireHandshake__factory.ts"

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_login,node_auth,node_routing,node_dashboard,node_assessments,node_records,node_exchange,node_management,node_api_client toneBlue
class node_backend_api,node_domain_data,node_credit_services toneAmber
class node_nmb_scorecard,node_middleware,node_score_engine toneMint
class node_credit_contract,node_handshake_types,node_credit_factory,node_handshake_factory toneRose
class node_operator toneIndigo
```

## Components

### Operator interface

- [Login](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/login/login.component.ts): `DAIRE/frontend/src/app/login/login.component.ts`
- [Session auth](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/core/auth.service.ts): `DAIRE/frontend/src/app/core/auth.service.ts`
- [Page routing](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/app.routes.ts): `DAIRE/frontend/src/app/app.routes.ts`
- [Dashboard](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/dashboard/dashboard.component.ts): `DAIRE/frontend/src/app/dashboard/dashboard.component.ts`
- [Assessments](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/assessments/assessments.component.ts): `DAIRE/frontend/src/app/assessments/assessments.component.ts`
- [Records](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/records/records.component.ts): `DAIRE/frontend/src/app/records/records.component.ts`
- [Data exchange](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/data-exchange/data-exchange.component.ts): `DAIRE/frontend/src/app/data-exchange/data-exchange.component.ts`
- [Data management](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/data-management/data-management.component.ts): `DAIRE/frontend/src/app/data-management/data-management.component.ts`
- [API client](https://github.com/apknation/daire/blob/main/DAIRE/frontend/src/app/core/api.service.ts): `DAIRE/frontend/src/app/core/api.service.ts`

### Credit backend

- [Backend API](https://github.com/apknation/daire/blob/main/DAIRE/backend/core/views.py): `DAIRE/backend/core/views.py`
- [Credit records](https://github.com/apknation/daire/blob/main/DAIRE/backend/core/models.py): `DAIRE/backend/core/models.py`
- [Credit services](https://github.com/apknation/daire/blob/main/DAIRE/backend/core/services.py): `DAIRE/backend/core/services.py`

### Scoring engines

- [NMB scorecard](https://github.com/apknation/daire/blob/main/DAIRE/backend/core/nmb_engine.py): `DAIRE/backend/core/nmb_engine.py`
- [Middleware API](https://github.com/apknation/daire/blob/main/daire-middleware/index.js): `daire-middleware/index.js`
- [Off-chain scoring](https://github.com/apknation/daire/blob/main/daire-middleware/scoreEngine.js): `daire-middleware/scoreEngine.js`

### Blockchain bindings

- [Credit contract types](https://github.com/apknation/daire/blob/main/types/ethers-contracts/DaireCreditScore.ts): `types/ethers-contracts/DaireCreditScore.ts`
- [Handshake types](https://github.com/apknation/daire/blob/main/types/ethers-contracts/DaireHandshake.ts): `types/ethers-contracts/DaireHandshake.ts`
- [Credit contract factory](https://github.com/apknation/daire/blob/main/types/ethers-contracts/factories/DaireCreditScore__factory.ts): `types/ethers-contracts/factories/DaireCreditScore__factory.ts`
- [Handshake factory](https://github.com/apknation/daire/blob/main/types/ethers-contracts/factories/DaireHandshake__factory.ts): `types/ethers-contracts/factories/DaireHandshake__factory.ts`

### Other components

- **Operator**

## Connections

- Operator → Login: signs in
- Login → Session auth: submits credentials (evidence: `DAIRE/frontend/src/app/core/auth.service.ts`)
- Operator → Dashboard: reviews
- Operator → Assessments: opens
- Operator → Records: manages records
- Operator → Data exchange: uses
- Operator → Data management: manages data
- Dashboard → API client: requests data (evidence: `DAIRE/frontend/src/app/dashboard/dashboard.component.ts`)
- Assessments → API client: requests assessments (evidence: `DAIRE/frontend/src/app/assessments/assessments.component.ts`)
- Records → API client: requests records (evidence: `DAIRE/frontend/src/app/records/records.component.ts`)
- Data exchange → API client: exchanges data (evidence: `DAIRE/frontend/src/app/data-exchange/data-exchange.component.ts`)
- Data management → API client: updates data (evidence: `DAIRE/frontend/src/app/data-management/data-management.component.ts`)
- Credit services → Credit records: reads and writes (evidence: `DAIRE/backend/core/services.py`)
- Credit services → NMB scorecard: uses scorecard (evidence: `DAIRE/backend/core/services.py`)
- Middleware API → Off-chain scoring: uses scoring (evidence: `daire-middleware/index.js`)
- Credit contract factory → Credit contract types: creates and connects (evidence: `types/ethers-contracts/factories/DaireCreditScore__factory.ts`)
- Handshake factory → Handshake types: creates and connects (evidence: `types/ethers-contracts/factories/DaireHandshake__factory.ts`)
