# arpanthebaap/saathi-wealth-ai architecture

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

- Interactive diagram: https://gitdiagram.com/arpanthebaap/saathi-wealth-ai
- Repository: https://github.com/arpanthebaap/saathi-wealth-ai

## Overview

Saathi is a static, phone-frame wealth-advisory demo: a customer selects a synthetic profile, explores a financial fingerprint and its reasoning, then chats with an avatar whose compliance rules can trigger a simulated advisor handoff. The README describes the prototype capabilities, but no source excerpts were supplied, so relationships below rely only on those documented statements. All implementation nodes point to the sole source file, index.html; production integrations are excluded.

Main entry points: [`index.html`](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Mobile Experience"]
  node_profile_picker["Profile Picker<br/>[index.html]"]
  node_dashboard["Dashboard<br/>[index.html]"]
  node_avatar_ui["Avatar Interface<br/>[index.html]"]
end

subgraph group_insights["Financial Insights"]
  node_synthetic_data[("Synthetic Profiles<br/>[index.html]")]
  node_behavioral_engine["Behavioral Profiling<br/>[index.html]"]
  node_fingerprint["Financial Fingerprint<br/>[index.html]"]
  node_reasoning["Reasoning Trail<br/>[index.html]"]
  node_recommendations["Guidance<br/>[index.html]"]
end

subgraph group_advisory["Conversational Advice"]
  node_response_engine["Scripted Responses<br/>[index.html]"]
end

subgraph group_safeguards["Compliance Handoff"]
  node_compliance_rules["Compliance Rules<br/>[index.html]"]
  node_escalation_card["Handoff Card<br/>[index.html]"]
end

node_customer(("Customer"))
node_advisor(("Human Advisor"))

node_customer -->|"selects profile"| node_profile_picker
node_profile_picker -->|"chooses demo data"| node_synthetic_data
node_synthetic_data -->|"supplies transactions"| node_behavioral_engine
node_behavioral_engine -->|"classifies persona"| node_fingerprint
node_dashboard -->|"shows fingerprint"| node_fingerprint
node_dashboard -->|"shows reasoning"| node_reasoning
node_dashboard -->|"shows guidance"| node_recommendations
node_customer -->|"asks questions"| node_avatar_ui
node_avatar_ui -->|"requests response"| node_response_engine
node_response_engine -->|"delivers advice"| node_recommendations
node_response_engine -->|"checks decision"| node_compliance_rules
node_compliance_rules -->|"triggers handoff"| node_escalation_card
node_escalation_card -->|"transfers context"| node_advisor

click node_profile_picker "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_dashboard "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_avatar_ui "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_synthetic_data "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_behavioral_engine "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_fingerprint "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_reasoning "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_recommendations "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_response_engine "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_compliance_rules "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"
click node_escalation_card "https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html"

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_profile_picker,node_dashboard,node_avatar_ui toneBlue
class node_synthetic_data,node_behavioral_engine,node_fingerprint,node_reasoning,node_recommendations toneAmber
class node_response_engine toneMint
class node_compliance_rules,node_escalation_card toneRose
class node_customer,node_advisor toneIndigo
```

## Components

### Mobile Experience

- [Profile Picker](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`
- [Dashboard](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`
- [Avatar Interface](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`

### Financial Insights

- [Synthetic Profiles](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`
- [Behavioral Profiling](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`
- [Financial Fingerprint](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`
- [Reasoning Trail](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`
- [Guidance](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`

### Conversational Advice

- [Scripted Responses](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`

### Compliance Handoff

- [Compliance Rules](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`
- [Handoff Card](https://github.com/arpanthebaap/saathi-wealth-ai/blob/main/index.html): `index.html`

### Other components

- **Customer**
- **Human Advisor**

## Connections

- Customer → Profile Picker: selects profile (evidence: `README.md`)
- Profile Picker → Synthetic Profiles: chooses demo data (evidence: `README.md`)
- Synthetic Profiles → Behavioral Profiling: supplies transactions (evidence: `README.md`)
- Behavioral Profiling → Financial Fingerprint: classifies persona (evidence: `README.md`)
- Dashboard → Financial Fingerprint: shows fingerprint (evidence: `README.md`)
- Dashboard → Reasoning Trail: shows reasoning (evidence: `README.md`)
- Dashboard → Guidance: shows guidance (evidence: `README.md`)
- Customer → Avatar Interface: asks questions (evidence: `README.md`)
- Avatar Interface → Scripted Responses: requests response (evidence: `README.md`)
- Scripted Responses → Guidance: delivers advice (evidence: `README.md`)
- Scripted Responses → Compliance Rules: checks decision (evidence: `README.md`)
- Compliance Rules → Handoff Card: triggers handoff (evidence: `README.md`)
- Handoff Card → Human Advisor: transfers context (evidence: `README.md`)
