How 008993368-yaz/genai-portfolio works
GenAI Portfolio combines a content-rich React portfolio with a FastAPI assistant. Visitors browse profile, skills, experience, projects and education, or ask the chat console a question; the frontend streams a reply and refreshes suggested questions. The backend applies topic guardrails, uses session memory, retrieves resume context and generates answers; separate endpoints expose search, suggestions and metrics. The README documents resume ingestion into Pinecone. Source excerpts establish the main chat and retrieval relationships; unsampled endpoint details are represented conservatively.
Main entry points: App.tsx Portfolio app · profile.ts Profile content · Console.tsx Chat console · chat_orchestrator.py Chat orchestrator
Components 25
Portfolio experience
- Portfolio app
frontend-v2/src/App.tsx - Profile content
frontend-v2/src/data/profile.ts - About context
frontend-v2/src/components/Context.tsx - Skill explorer
frontend-v2/src/components/EmbeddingSpace.tsx - Experience
frontend-v2/src/components/Experience.tsx - Projects
frontend-v2/src/components/Results.tsx - Education
frontend-v2/src/components/Education.tsx - Contact
frontend-v2/src/components/Contact.tsx - Status bar
frontend-v2/src/components/StatusBar.tsx - Scroll reveals
frontend-v2/src/hooks/useScrollReveal.ts
Chat interface
- Chat console
frontend-v2/src/components/Console.tsx - Chat state
frontend-v2/src/hooks/useChat.ts - Chat API client
frontend-v2/src/services/chatApi.ts - SSE parser
frontend-v2/src/services/sseParser.ts - Typing cycle
frontend-v2/src/hooks/useTypewriterCycle.ts
Backend API
- FastAPI endpoints
rag-backend/app/main.py - Chat orchestrator
rag-backend/app/services/chat_orchestrator.py
RAG services
- Topic guardrails
rag-backend/app/services/guardrails.py - Session memory
rag-backend/app/services/memory.py - RAG generation
rag-backend/app/services/rag.py - Resume retrieval
rag-backend/app/services/retriever.py
Resume knowledge
- Resume ingestion
rag-backend/scripts/ingest_resume.py - Pinecone
Other components
- Visitor
- OpenAI
Connections 30
- Visitor → Portfolio app: browses
README.md - Portfolio app → Chat console: renders
frontend-v2/src/App.tsx - Portfolio app → About context: renders
frontend-v2/src/App.tsx - Portfolio app → Skill explorer: renders
frontend-v2/src/App.tsx - Portfolio app → Experience: renders
frontend-v2/src/App.tsx - Portfolio app → Projects: renders
frontend-v2/src/App.tsx - Portfolio app → Education: renders
frontend-v2/src/App.tsx - Portfolio app → Contact: renders
frontend-v2/src/App.tsx - Portfolio app → Status bar: renders
frontend-v2/src/App.tsx - About context → Profile content: reads content
frontend-v2/src/components/Context.tsx - Skill explorer → Profile content: reads content
frontend-v2/src/components/EmbeddingSpace.tsx - Experience → Profile content: reads content
frontend-v2/src/components/Experience.tsx - Projects → Profile content: reads content
frontend-v2/src/components/Results.tsx - Education → Profile content: reads content
frontend-v2/src/components/Education.tsx - Contact → Profile content: reads content
frontend-v2/src/components/Contact.tsx - Chat console → Profile content: reads content
frontend-v2/src/components/Console.tsx - Chat console → Chat state: uses chat
frontend-v2/src/components/Console.tsx - Chat console → Typing cycle: uses typing
frontend-v2/src/components/Console.tsx - About context → Scroll reveals: uses reveal
frontend-v2/src/components/Context.tsx - Chat state → Chat API client: sends requests
frontend-v2/src/hooks/useChat.ts - Chat API client → SSE parser: parses events
frontend-v2/src/services/chatApi.ts - Chat API client → FastAPI endpoints: calls chat and suggestions
README.md - FastAPI endpoints → Chat orchestrator: dispatches chat
rag-backend/app/main.py - Chat orchestrator → Topic guardrails: checks topic
rag-backend/app/services/chat_orchestrator.py - Chat orchestrator → Session memory: reads and stores
rag-backend/app/services/chat_orchestrator.py - Chat orchestrator → RAG generation: generates reply
rag-backend/app/services/chat_orchestrator.py - RAG generation → Resume retrieval: retrieves context
rag-backend/app/services/rag.py - Resume retrieval → Pinecone: queries vectors
rag-backend/app/services/retriever.py - RAG generation → OpenAI: generates text
README.md - Resume ingestion → Pinecone: ingests vectors
README.md