# karthik152212/digital-wealth architecture

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

- Interactive diagram: https://gitdiagram.com/karthik152212/digital-wealth
- Repository: https://github.com/karthik152212/digital-wealth

## Overview

Digital Wealth Vault is a web app for cataloguing digital assets, tracking saved valuations, and preparing for a simulated inheritance process. Users authenticate and manage their own vault; nominees can be invited, submit claims, and receive access only after owner approval. Portfolio summaries also support AI chat and insights. The README documents asset and nominee capabilities beyond the sampled source, so those links are attributed to the README; the sampled routes and libraries confirm key AI, session, nominee, and inheritance behavior.

Main entry points: [`src/app/api/ai`](https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/ai) (AI routes), [`src/lib/session.ts`](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/session.ts) (Session guards), [`src/app/dashboard/page.tsx`](https://github.com/karthik152212/digital-wealth/blob/main/src/app/dashboard/page.tsx) (Dashboard), [`src/app/api/inheritance`](https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/inheritance) (Inheritance routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Access"]
  node_auth_ui["Sign-in &amp; registration<br/>[page.tsx]"]
  node_auth_service["Authentication<br/>[auth.ts]"]
  node_session["Session guards<br/>[session.ts]"]
end

subgraph group_vault["Asset Vault"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_asset_api["Asset API"]
  node_asset_logic["Asset management<br/>[assets.ts]"]
  node_portfolio["Portfolio snapshot<br/>[portfolio.ts]"]
end

subgraph group_succession["Nominees &amp; Inheritance"]
  node_nominee_ui["Nominee management<br/>[page.tsx]"]
  node_nominee_api["Nominee routes"]
  node_nominees["Nominee operations<br/>[nominees.ts]"]
  node_claim_ui["Claim actions"]
  node_review_ui["Owner claim review"]
  node_inheritance_api["Inheritance routes"]
  node_inheritance["Claim state machine<br/>[inheritance.ts]"]
end

subgraph group_intelligence["AI Assistance"]
  node_chat_ui["Vault chat<br/>[vault-chat.tsx]"]
  node_ai_routes["AI routes"]
  node_ai_context["Safe portfolio context<br/>[ai-context.ts]"]
  node_ai_insights["Insight generation<br/>[ai-insights.ts]"]
  node_ai_service["AI generation<br/>[ai.ts]"]
end

subgraph group_foundation["Shared Services"]
  node_database[("PostgreSQL database")]
end

node_user(("Vault user"))
node_ai_provider{{"AI provider"}}

node_user -->|"signs in"| node_auth_ui
node_auth_ui -.->|"authenticates"| node_auth_service
node_session -->|"checks session"| node_auth_service
node_user -->|"opens vault"| node_dashboard
node_dashboard -->|"manages assets"| node_asset_api
node_asset_api -.->|"checks access"| node_session
node_asset_api -.->|"delegates CRUD"| node_asset_logic
node_asset_logic -.->|"reads and writes"| node_database
node_dashboard -->|"shows totals"| node_portfolio
node_portfolio -->|"reads portfolio"| node_database
node_user -->|"manages nominees"| node_nominee_ui
node_nominee_ui -.->|"submits changes"| node_nominee_api
node_nominee_api -->|"checks access"| node_session
node_nominee_api -->|"lists or creates"| node_nominees
node_nominees -->|"updates records"| node_database
node_nominee_ui -->|"supports claims"| node_claim_ui
node_claim_ui -->|"submits claim"| node_inheritance_api
node_review_ui -->|"requests decision"| node_inheritance_api
node_inheritance_api -->|"checks access"| node_session
node_inheritance_api -->|"dispatches transition"| node_inheritance
node_inheritance -->|"records transitions"| node_database
node_user -->|"asks questions"| node_chat_ui
node_chat_ui -.->|"sends chat"| node_ai_routes
node_ai_routes -->|"checks access"| node_session
node_ai_routes -->|"loads snapshot"| node_portfolio
node_ai_routes -->|"builds context"| node_ai_context
node_ai_routes -->|"generates answer"| node_ai_service
node_ai_service -.->|"calls provider"| node_ai_provider
node_dashboard -.->|"loads insights"| node_ai_routes
node_ai_routes -->|"gets insights"| node_ai_insights
node_ai_insights -->|"uses snapshot"| node_portfolio
node_ai_insights -->|"generates insights"| node_ai_service

click node_auth_ui "https://github.com/karthik152212/digital-wealth/blob/main/src/app/login/page.tsx"
click node_auth_service "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/auth.ts"
click node_session "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/session.ts"
click node_dashboard "https://github.com/karthik152212/digital-wealth/blob/main/src/app/dashboard/page.tsx"
click node_asset_api "https://github.com/karthik152212/digital-wealth/tree/main/src/app/api"
click node_asset_logic "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/assets.ts"
click node_portfolio "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/portfolio.ts"
click node_nominee_ui "https://github.com/karthik152212/digital-wealth/blob/main/src/app/dashboard/nominees/page.tsx"
click node_nominee_api "https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/nominees"
click node_nominees "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/nominees.ts"
click node_claim_ui "https://github.com/karthik152212/digital-wealth/blob/main/src/components/nominee/claim-request-actions.tsx"
click node_review_ui "https://github.com/karthik152212/digital-wealth/blob/main/src/components/nominees/claim-review-actions.tsx"
click node_inheritance_api "https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/inheritance"
click node_inheritance "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/inheritance.ts"
click node_chat_ui "https://github.com/karthik152212/digital-wealth/blob/main/src/components/chat/vault-chat.tsx"
click node_ai_routes "https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/ai"
click node_ai_context "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/ai-context.ts"
click node_ai_insights "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/ai-insights.ts"
click node_ai_service "https://github.com/karthik152212/digital-wealth/blob/main/src/lib/ai.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_auth_ui,node_auth_service,node_session,node_user toneBlue
class node_dashboard,node_asset_api,node_asset_logic,node_portfolio toneAmber
class node_nominee_ui,node_nominee_api,node_nominees,node_claim_ui,node_review_ui,node_inheritance_api,node_inheritance toneMint
class node_chat_ui,node_ai_routes,node_ai_context,node_ai_insights,node_ai_service toneRose
class node_database,node_ai_provider toneIndigo
```

## Components

### Identity & Access

- [Sign-in & registration](https://github.com/karthik152212/digital-wealth/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Authentication](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Session guards](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/session.ts): `src/lib/session.ts`

### Asset Vault

- [Dashboard](https://github.com/karthik152212/digital-wealth/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Asset API](https://github.com/karthik152212/digital-wealth/tree/main/src/app/api): `src/app/api`
- [Asset management](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/assets.ts): `src/lib/assets.ts`
- [Portfolio snapshot](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/portfolio.ts): `src/lib/portfolio.ts`

### Nominees & Inheritance

- [Nominee management](https://github.com/karthik152212/digital-wealth/blob/main/src/app/dashboard/nominees/page.tsx): `src/app/dashboard/nominees/page.tsx`
- [Nominee routes](https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/nominees): `src/app/api/nominees`
- [Nominee operations](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/nominees.ts): `src/lib/nominees.ts`
- [Claim actions](https://github.com/karthik152212/digital-wealth/blob/main/src/components/nominee/claim-request-actions.tsx): `src/components/nominee/claim-request-actions.tsx`
- [Owner claim review](https://github.com/karthik152212/digital-wealth/blob/main/src/components/nominees/claim-review-actions.tsx): `src/components/nominees/claim-review-actions.tsx`
- [Inheritance routes](https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/inheritance): `src/app/api/inheritance`
- [Claim state machine](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/inheritance.ts): `src/lib/inheritance.ts`

### AI Assistance

- [Vault chat](https://github.com/karthik152212/digital-wealth/blob/main/src/components/chat/vault-chat.tsx): `src/components/chat/vault-chat.tsx`
- [AI routes](https://github.com/karthik152212/digital-wealth/tree/main/src/app/api/ai): `src/app/api/ai`
- [Safe portfolio context](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/ai-context.ts): `src/lib/ai-context.ts`
- [Insight generation](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/ai-insights.ts): `src/lib/ai-insights.ts`
- [AI generation](https://github.com/karthik152212/digital-wealth/blob/main/src/lib/ai.ts): `src/lib/ai.ts`

### Shared Services

- **PostgreSQL database**

### Other components

- **Vault user**
- **AI provider**

## Connections

- Vault user → Sign-in & registration: signs in (evidence: `README.md`)
- Sign-in & registration → Authentication: authenticates
- Session guards → Authentication: checks session (evidence: `src/lib/session.ts`)
- Vault user → Dashboard: opens vault (evidence: `README.md`)
- Dashboard → Asset API: manages assets (evidence: `README.md`)
- Asset API → Session guards: checks access (evidence: `src/app/api/ai/chat/route.ts`)
- Asset API → Asset management: delegates CRUD
- Asset management → PostgreSQL database: reads and writes
- Dashboard → Portfolio snapshot: shows totals (evidence: `README.md`)
- Portfolio snapshot → PostgreSQL database: reads portfolio (evidence: `src/lib/portfolio.ts`)
- Vault user → Nominee management: manages nominees (evidence: `README.md`)
- Nominee management → Nominee routes: submits changes
- Nominee routes → Session guards: checks access (evidence: `src/app/api/nominees/route.ts`)
- Nominee routes → Nominee operations: lists or creates (evidence: `src/app/api/nominees/route.ts`)
- Nominee operations → PostgreSQL database: updates records (evidence: `src/lib/nominees.ts`)
- Nominee management → Claim actions: supports claims (evidence: `README.md`)
- Claim actions → Inheritance routes: submits claim (evidence: `README.md`)
- Owner claim review → Inheritance routes: requests decision (evidence: `src/components/nominees/claim-review-actions.tsx`)
- Inheritance routes → Session guards: checks access (evidence: `src/app/api/inheritance/[id]/approve/route.ts`)
- Inheritance routes → Claim state machine: dispatches transition (evidence: `src/app/api/inheritance/[id]/approve/route.ts`)
- Claim state machine → PostgreSQL database: records transitions (evidence: `src/lib/inheritance.ts`)
- Vault user → Vault chat: asks questions (evidence: `README.md`)
- Vault chat → AI routes: sends chat
- AI routes → Session guards: checks access (evidence: `src/app/api/ai/chat/route.ts`)
- AI routes → Portfolio snapshot: loads snapshot (evidence: `src/app/api/ai/chat/route.ts`)
- AI routes → Safe portfolio context: builds context (evidence: `src/app/api/ai/chat/route.ts`)
- AI routes → AI generation: generates answer (evidence: `src/app/api/ai/chat/route.ts`)
- AI generation → AI provider: calls provider
- Dashboard → AI routes: loads insights
- AI routes → Insight generation: gets insights (evidence: `src/app/api/ai/insights/route.ts`)
- Insight generation → Portfolio snapshot: uses snapshot (evidence: `src/lib/ai-insights.ts`)
- Insight generation → AI generation: generates insights (evidence: `src/lib/ai-insights.ts`)
