# hemanthvnp/arthadhruva architecture

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

- Interactive diagram: https://gitdiagram.com/hemanthvnp/arthadhruva
- Repository: https://github.com/hemanthvnp/arthadhruva

## Overview

ArthaDhruva is a mortgage-lender credit-risk platform. Analysts submit loan data for default scores and explanations, project lifetime and portfolio losses, and inspect tail risk; the platform also supports governance and loan-case operations. The graph preserves those documented capabilities and the authentication, automation, and integration branches. Several subsystem paths are directories because their implementations were not sampled; relationships without direct source evidence are omitted or marked unverified.

Main entry points: [`frontend/src/pages`](https://github.com/hemanthvnp/arthadhruva/tree/dev/frontend/src/pages) (Risk pages), [`backend/risk-engine/src/main/java/com/arthadhruva/riskengine/workflow`](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/workflow) (Loan cases), [`backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score`](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score) (Default score), [`backend/risk-engine/src/main/java/com/arthadhruva/riskengine`](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine) (Platform integrations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Analyst experience"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_riskpages["Risk pages"]
  node_apiclient["API client<br/>[client.ts]"]
end

subgraph group_risk["Risk analytics"]
  node_score["Default score"]
  node_features["Loan features<br/>[LoanFeatures.java]"]
  node_explanation["Score explanation"]
  node_lifetime["Lifetime projection"]
  node_portfolio["Portfolio risk"]
  node_tailrisk["Loss distribution<br/>[CvarEngine.java]"]
  node_regime["Regime forecast"]
end

subgraph group_governance["Governance"]
  node_governance["Model governance"]
end

subgraph group_workflow["Case operations"]
  node_workflow["Loan cases"]
  node_automation["Automation rules"]
  node_notifications["Notifications"]
end

subgraph group_platform["Platform services"]
  node_auth["Identity and sessions"]
  node_tenant["Tenant isolation"]
  node_audit[("Audit trail")]
  node_integrations["Platform integrations"]
end

node_analyst(("Analyst"))
node_llm{{"Language model"}}

node_analyst -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_riskpages
node_riskpages -.->|"requests data"| node_apiclient
node_apiclient -.->|"calls API"| node_score
node_features -->|"supplies inputs"| node_score
node_score -->|"explains score"| node_explanation
node_riskpages -.->|"requests projection"| node_lifetime
node_riskpages -.->|"starts run"| node_portfolio
node_portfolio -.->|"feeds loss profiles"| node_tailrisk
node_riskpages -.->|"requests tail risk"| node_tailrisk
node_riskpages -.->|"views models"| node_governance
node_riskpages -.->|"views forecast"| node_regime
node_riskpages -.->|"manages cases"| node_workflow
node_workflow -.->|"supports rules"| node_automation
node_workflow -.->|"supports notices"| node_notifications
node_riskpages -.->|"signs in"| node_auth
node_analyst -.->|"asks questions"| node_llm
node_workflow -->|"provides case context"| node_llm
node_integrations -.->|"records API activity"| node_audit
node_integrations -.->|"enforces isolation"| node_tenant

click node_webapp "https://github.com/hemanthvnp/arthadhruva/blob/dev/frontend/src/App.tsx"
click node_riskpages "https://github.com/hemanthvnp/arthadhruva/tree/dev/frontend/src/pages"
click node_apiclient "https://github.com/hemanthvnp/arthadhruva/blob/dev/frontend/src/api/client.ts"
click node_score "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score"
click node_features "https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/LoanFeatures.java"
click node_explanation "https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/ExplanationService.java"
click node_lifetime "https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/survival/TermStructureEngine.java"
click node_portfolio "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/survival"
click node_tailrisk "https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/cvar/CvarEngine.java"
click node_governance "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/governance"
click node_regime "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/regime"
click node_workflow "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/workflow"
click node_automation "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/automation"
click node_notifications "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/notification"
click node_auth "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/security"
click node_tenant "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/tenant"
click node_audit "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/audit"
click node_integrations "https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine"

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_webapp,node_riskpages,node_apiclient toneBlue
class node_score,node_features,node_explanation,node_lifetime,node_portfolio,node_tailrisk,node_regime toneAmber
class node_governance toneMint
class node_workflow,node_automation,node_notifications toneRose
class node_auth,node_tenant,node_audit,node_integrations,node_analyst,node_llm toneIndigo
```

## Components

### Analyst experience

- [Web application](https://github.com/hemanthvnp/arthadhruva/blob/dev/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Risk pages](https://github.com/hemanthvnp/arthadhruva/tree/dev/frontend/src/pages): `frontend/src/pages`
- [API client](https://github.com/hemanthvnp/arthadhruva/blob/dev/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### Risk analytics

- [Default score](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score`
- [Loan features](https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/LoanFeatures.java): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/LoanFeatures.java`
- [Score explanation](https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/ExplanationService.java): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/ExplanationService.java`
- [Lifetime projection](https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/survival/TermStructureEngine.java): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/survival/TermStructureEngine.java`
- [Portfolio risk](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/survival): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/survival`
- [Loss distribution](https://github.com/hemanthvnp/arthadhruva/blob/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/cvar/CvarEngine.java): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/cvar/CvarEngine.java`
- [Regime forecast](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/regime): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/regime`

### Governance

- [Model governance](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/governance): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/governance`

### Case operations

- [Loan cases](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/workflow): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/workflow`
- [Automation rules](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/automation): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/automation`
- [Notifications](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/notification): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/notification`

### Platform services

- [Identity and sessions](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/security): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/security`
- [Tenant isolation](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/tenant): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/tenant`
- [Audit trail](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine/audit): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/audit`
- [Platform integrations](https://github.com/hemanthvnp/arthadhruva/tree/dev/backend/risk-engine/src/main/java/com/arthadhruva/riskengine): `backend/risk-engine/src/main/java/com/arthadhruva/riskengine`

### Other components

- **Analyst**
- **Language model**

## Connections

- Analyst → Web application: uses (evidence: `README.md`)
- Web application → Risk pages: routes to (evidence: `frontend/src/App.tsx`)
- Risk pages → API client: requests data (evidence: `frontend/src/pages/CaseSearchPage.tsx`)
- API client → Default score: calls API
- Loan features → Default score: supplies inputs (evidence: `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/LoanFeatures.java`)
- Default score → Score explanation: explains score (evidence: `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/score/ExplanationService.java`)
- Risk pages → Lifetime projection: requests projection
- Risk pages → Portfolio risk: starts run
- Portfolio risk → Loss distribution: feeds loss profiles
- Risk pages → Loss distribution: requests tail risk
- Risk pages → Model governance: views models
- Risk pages → Regime forecast: views forecast
- Risk pages → Loan cases: manages cases
- Loan cases → Automation rules: supports rules
- Loan cases → Notifications: supports notices
- Risk pages → Identity and sessions: signs in
- Analyst → Language model: asks questions
- Loan cases → Language model: provides case context
- Platform integrations → Audit trail: records API activity
- Platform integrations → Tenant isolation: enforces isolation (evidence: `backend/risk-engine/src/main/java/com/arthadhruva/riskengine/tenant/OrganizationService.java`)
