# lakshmipriya-rs/ai-portfolio architecture

> Architecture diagram of the GitHub repository lakshmipriya-rs/ai-portfolio, 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/lakshmipriya-rs/ai-portfolio
- Repository: https://github.com/lakshmipriya-rs/ai-portfolio

## Overview

AI Portfolio is a personal portfolio with a conversational interface for exploring profile sections. A visitor submits a question (or a landing-page prompt), the client sends it to the chat API, and the server embeds the query, selects a portfolio section, and returns structured content with optional generated text for display. A separate ingestion path builds the searchable portfolio index. The README documents multiple AI-provider support; source excerpts show provider selection and fallback, but not every server route or integration detail.

Main entry points: [`client/src/pages/Chat.tsx`](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/pages/Chat.tsx) (Chat screen), [`server/src/controllers/chatControllers.js`](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/controllers/chatControllers.js) (Chat handler), [`client/src/App.tsx`](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/App.tsx) (View switcher), [`server/src/controllers/sectionControllers.js`](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/controllers/sectionControllers.js) (Section responses)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Portfolio client"]
  node_app["View switcher<br/>[App.tsx]"]
  node_landing["Portfolio landing<br/>[Home.tsx]"]
  node_chatpage["Chat screen<br/>[Chat.tsx]"]
  node_chatstate["Chat interaction state<br/>[useChat.ts]"]
  node_chatui["Chat response UI"]
  node_portfoliosections["Portfolio sections"]
  node_promptui["Quick prompts<br/>[QuickActions.tsx]"]
  node_clientapi["Chat API client<br/>[apiService.ts]"]
end

subgraph group_api["Chat API"]
  node_chatcontroller["Chat handler<br/>[chatControllers.js]"]
  node_sectioncontroller["Section responses"]
  node_server["Express server<br/>[server.js]"]
end

subgraph group_knowledge["Knowledge and retrieval"]
  node_ingest["Knowledge ingestion<br/>[ingest.js]"]
  node_indexstore[("Document and vector index")]
  node_embedding["Embedding service<br/>[embeddings.js]"]
end

subgraph group_generation["AI generation"]
  node_cache[("Response cache<br/>[cache.js]")]
  node_generation["Text generation<br/>[generation.js]"]
  node_aiservice["AI provider selection<br/>[aiService.js]"]
  node_providers["Provider adapters<br/>[AIProvider.js]"]
end

node_visitor(("Visitor"))
node_aiproviders(("AI providers"))

node_visitor -->|"opens portfolio"| node_app
node_app -->|"shows landing"| node_landing
node_app -->|"switches to chat"| node_chatpage
node_landing -.->|"starts chat"| node_chatpage
node_chatpage -->|"uses interaction state"| node_chatstate
node_chatpage -->|"renders responses"| node_chatui
node_chatui -->|"renders section data"| node_portfoliosections
node_chatpage -->|"renders prompts"| node_promptui
node_chatstate -->|"sends question"| node_clientapi
node_clientapi -->|"posts chat request"| node_server
node_server -.->|"routes chat requests"| node_chatcontroller
node_chatcontroller -->|"embeds query"| node_embedding
node_chatcontroller -->|"scores documents"| node_indexstore
node_chatcontroller -->|"requests selected section"| node_sectioncontroller
node_sectioncontroller -->|"generates section text"| node_generation
node_sectioncontroller -->|"checks and stores responses"| node_cache
node_ingest -->|"embeds documents"| node_embedding
node_ingest -->|"writes index"| node_indexstore
node_embedding -->|"uses in production"| node_aiservice
node_generation -->|"delegates generation"| node_aiservice
node_aiservice -->|"initializes adapters"| node_providers
node_providers -.->|"calls configured providers"| node_aiproviders

click node_app "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/App.tsx"
click node_landing "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/pages/Home.tsx"
click node_chatpage "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/pages/Chat.tsx"
click node_chatstate "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/hooks/useChat.ts"
click node_chatui "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/components/chat/ResponseRenderer.tsx"
click node_portfoliosections "https://github.com/lakshmipriya-rs/ai-portfolio/tree/main/client/src/components/sections"
click node_promptui "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/components/QuickActions.tsx"
click node_clientapi "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/services/apiService.ts"
click node_chatcontroller "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/controllers/chatControllers.js"
click node_sectioncontroller "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/controllers/sectionControllers.js"
click node_ingest "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/routes/ingest.js"
click node_embedding "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/embeddings.js"
click node_cache "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/cache.js"
click node_generation "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/generation.js"
click node_aiservice "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/aiService.js"
click node_providers "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/providers/AIProvider.js"
click node_server "https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/server.js"

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_app,node_landing,node_chatpage,node_chatstate,node_chatui,node_portfoliosections,node_promptui,node_clientapi toneBlue
class node_chatcontroller,node_sectioncontroller,node_server toneAmber
class node_ingest,node_indexstore,node_embedding toneMint
class node_cache,node_generation,node_aiservice,node_providers toneRose
class node_visitor,node_aiproviders toneIndigo
```

## Components

### Portfolio client

- [View switcher](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Portfolio landing](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/pages/Home.tsx): `client/src/pages/Home.tsx`
- [Chat screen](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/pages/Chat.tsx): `client/src/pages/Chat.tsx`
- [Chat interaction state](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/hooks/useChat.ts): `client/src/hooks/useChat.ts`
- [Chat response UI](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/components/chat/ResponseRenderer.tsx): `client/src/components/chat/ResponseRenderer.tsx`
- [Portfolio sections](https://github.com/lakshmipriya-rs/ai-portfolio/tree/main/client/src/components/sections): `client/src/components/sections`
- [Quick prompts](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/components/QuickActions.tsx): `client/src/components/QuickActions.tsx`
- [Chat API client](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/client/src/services/apiService.ts): `client/src/services/apiService.ts`

### Chat API

- [Chat handler](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/controllers/chatControllers.js): `server/src/controllers/chatControllers.js`
- [Section responses](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/controllers/sectionControllers.js): `server/src/controllers/sectionControllers.js`
- [Express server](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/server.js): `server/src/server.js`

### Knowledge and retrieval

- [Knowledge ingestion](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/routes/ingest.js): `server/src/routes/ingest.js`
- **Document and vector index**
- [Embedding service](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/embeddings.js): `server/src/lib/embeddings.js`

### AI generation

- [Response cache](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/cache.js): `server/src/lib/cache.js`
- [Text generation](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/generation.js): `server/src/lib/generation.js`
- [AI provider selection](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/aiService.js): `server/src/lib/aiService.js`
- [Provider adapters](https://github.com/lakshmipriya-rs/ai-portfolio/blob/main/server/src/lib/providers/AIProvider.js): `server/src/lib/providers/AIProvider.js`

### Other components

- **Visitor**
- **AI providers**

## Connections

- Visitor → View switcher: opens portfolio (evidence: `client/src/App.tsx`)
- View switcher → Portfolio landing: shows landing (evidence: `client/src/App.tsx`)
- View switcher → Chat screen: switches to chat (evidence: `client/src/App.tsx`)
- Portfolio landing → Chat screen: starts chat (evidence: `client/src/App.tsx`)
- Chat screen → Chat interaction state: uses interaction state (evidence: `client/src/pages/Chat.tsx`)
- Chat screen → Chat response UI: renders responses (evidence: `client/src/pages/Chat.tsx`)
- Chat response UI → Portfolio sections: renders section data (evidence: `client/src/components/chat/ResponseRenderer.tsx`)
- Chat screen → Quick prompts: renders prompts (evidence: `client/src/pages/Chat.tsx`)
- Chat interaction state → Chat API client: sends question (evidence: `client/src/hooks/useChat.ts`)
- Chat API client → Express server: posts chat request (evidence: `client/src/services/apiService.ts`)
- Express server → Chat handler: routes chat requests (evidence: `server/src/server.js`)
- Chat handler → Embedding service: embeds query (evidence: `server/src/controllers/chatControllers.js`)
- Chat handler → Document and vector index: scores documents (evidence: `server/src/controllers/chatControllers.js`)
- Chat handler → Section responses: requests selected section (evidence: `server/src/controllers/chatControllers.js`)
- Section responses → Text generation: generates section text (evidence: `server/src/controllers/sectionControllers.js`)
- Section responses → Response cache: checks and stores responses (evidence: `server/src/controllers/sectionControllers.js`)
- Knowledge ingestion → Embedding service: embeds documents (evidence: `server/src/routes/ingest.js`)
- Knowledge ingestion → Document and vector index: writes index (evidence: `server/src/routes/ingest.js`)
- Embedding service → AI provider selection: uses in production (evidence: `server/src/lib/embeddings.js`)
- Text generation → AI provider selection: delegates generation (evidence: `server/src/lib/generation.js`)
- AI provider selection → Provider adapters: initializes adapters (evidence: `server/src/lib/aiService.js`)
- Provider adapters → AI providers: calls configured providers
