How lakshmipriya-rs/ai-portfolio works
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: Chat.tsx Chat screen · chatControllers.js Chat handler · App.tsx View switcher · sectionControllers.js Section responses
Components 20
Portfolio client
- View switcher
client/src/App.tsx - Portfolio landing
client/src/pages/Home.tsx - Chat screen
client/src/pages/Chat.tsx - Chat interaction state
client/src/hooks/useChat.ts - Chat response UI
client/src/components/chat/ResponseRenderer.tsx - Portfolio sections
client/src/components/sections - Quick prompts
client/src/components/QuickActions.tsx - Chat API client
client/src/services/apiService.ts
Chat API
- Chat handler
server/src/controllers/chatControllers.js - Section responses
server/src/controllers/sectionControllers.js - Express server
server/src/server.js
Knowledge and retrieval
- Knowledge ingestion
server/src/routes/ingest.js - Document and vector index
- Embedding service
server/src/lib/embeddings.js
AI generation
- Response cache
server/src/lib/cache.js - Text generation
server/src/lib/generation.js - AI provider selection
server/src/lib/aiService.js - Provider adapters
server/src/lib/providers/AIProvider.js
Other components
- Visitor
- AI providers
Connections 22
- Visitor → View switcher: opens portfolio
client/src/App.tsx - View switcher → Portfolio landing: shows landing
client/src/App.tsx - View switcher → Chat screen: switches to chat
client/src/App.tsx - Portfolio landing → Chat screen: starts chat
client/src/App.tsx - Chat screen → Chat interaction state: uses interaction state
client/src/pages/Chat.tsx - Chat screen → Chat response UI: renders responses
client/src/pages/Chat.tsx - Chat response UI → Portfolio sections: renders section data
client/src/components/chat/ResponseRenderer.tsx - Chat screen → Quick prompts: renders prompts
client/src/pages/Chat.tsx - Chat interaction state → Chat API client: sends question
client/src/hooks/useChat.ts - Chat API client → Express server: posts chat request
client/src/services/apiService.ts - Express server → Chat handler: routes chat requests
server/src/server.js - Chat handler → Embedding service: embeds query
server/src/controllers/chatControllers.js - Chat handler → Document and vector index: scores documents
server/src/controllers/chatControllers.js - Chat handler → Section responses: requests selected section
server/src/controllers/chatControllers.js - Section responses → Text generation: generates section text
server/src/controllers/sectionControllers.js - Section responses → Response cache: checks and stores responses
server/src/controllers/sectionControllers.js - Knowledge ingestion → Embedding service: embeds documents
server/src/routes/ingest.js - Knowledge ingestion → Document and vector index: writes index
server/src/routes/ingest.js - Embedding service → AI provider selection: uses in production
server/src/lib/embeddings.js - Text generation → AI provider selection: delegates generation
server/src/lib/generation.js - AI provider selection → Provider adapters: initializes adapters
server/src/lib/aiService.js - Provider adapters → AI providers: calls configured providers