How kwonhalim/portfolio works
This repository is a portfolio website with a Spring Boot portfolio API and a separate FastAPI RAG chatbot. A visitor browses profile, projects, and timeline information through the frontend, or asks the chatbot a question; the AI service retrieves context, generates an answer, and stores chat history. The graph preserves the documented frontend, backend, and chatbot capabilities. Some frontend-to-service HTTP links and unsampled AI internals are not visible in the excerpts, so those links are marked unverified or omitted.
Main entry points: chat_service.py Chat orchestration · rag_service.py RAG ingestion · api.js API client · BackendApplication.java REST API
Components 32
Portfolio frontend
- Portfolio UI
FrontEnd/src/js/navigation.js - Project browser
FrontEnd/src/js/projects.js - Chat interface
FrontEnd/src/js/chatbot.js - API client
FrontEnd/src/js/api.js
Portfolio API
- REST API
Backend/src/main/java/portfolio/backend/BackendApplication.java - Profile endpoint
Backend/src/main/java/portfolio/backend/controller/ProfileController.java - Profile service
Backend/src/main/java/portfolio/backend/service/ProfileService.java - Profile data
Backend/src/main/java/portfolio/backend/repository/ProfileRepository.java - Project endpoints
Backend/src/main/java/portfolio/backend/controller/ProjectController.java - Project service
Backend/src/main/java/portfolio/backend/service/ProjectService.java - Project data
Backend/src/main/java/portfolio/backend/repository/ProjectRepository.java - Feedback endpoint
Backend/src/main/java/portfolio/backend/controller/FeedBackController.java - Feedback service
Backend/src/main/java/portfolio/backend/service/FeedBackService.java - Timeline service
Backend/src/main/java/portfolio/backend/service/TimelineService.java - Timeline data
Backend/src/main/java/portfolio/backend/repository/EducationRepository.java
AI chatbot
- Chatbot API
AI/main.py - Chat routes
AI/routes/chat/chat.py - Chat orchestration
AI/service/chat_service.py - Hybrid retrieval
AI/service/retriever/document_retriever.py - Vector repository
AI/database/vector/repository.py - Vector index
AI/database/vector/vector_strategy/vector_store_strategy.py - BM25 index
AI/service/retriever/bm25_manager.py - Prompt and LLM
AI/service/langchain/prompt.py - Chat repository
AI/database/chat/repository.py - Chat history store
AI/database/chat/chat_strategy/langchain_mongo_repository.py - Semantic cache
AI/service/cache/redis_semantic_cache.py - Document routes
AI/routes/document/document.py - RAG ingestion
AI/service/rag_service.py - Document parsing
AI/service/data/data_processor.py - Document chunking
AI/service/chunk/service.py - Embedding service
AI/service/embedding/service.py
Other components
- Visitor
Connections 31
- Visitor → Portfolio UI: browses
README.md - Visitor → Chat interface: asks
README.md - Portfolio UI → API client: requests data
- Project browser → API client: requests projects
- Chat interface → API client: submits questions
- API client → REST API: calls API
- API client → Chatbot API: calls chatbot
- REST API → Profile endpoint: routes requests
- REST API → Project endpoints: routes requests
- Profile endpoint → Profile service: delegates
Backend/src/main/java/portfolio/backend/controller/ProfileController.java - Profile service → Profile data: queries
Backend/src/main/java/portfolio/backend/service/ProfileService.java - Project endpoints → Project service: delegates
Backend/src/main/java/portfolio/backend/controller/ProjectController.java - Project service → Project data: queries
Backend/src/main/java/portfolio/backend/service/ProjectService.java - Feedback endpoint → Feedback service: delegates
Backend/src/main/java/portfolio/backend/controller/FeedBackController.java - Timeline service → Timeline data: queries education
Backend/src/main/java/portfolio/backend/service/TimelineService.java - Chatbot API → Chat routes: mounts router
AI/main.py - Chatbot API → Document routes: mounts router
AI/main.py - Chat routes → Chat orchestration: invokes
AI/routes/chat/chat.py - Chat orchestration → Semantic cache: checks and fills
AI/service/chat_service.py - Chat orchestration → Hybrid retrieval: retrieves context
AI/service/chat_service.py - Hybrid retrieval → Vector repository: searches vectors
AI/service/retriever/document_retriever.py - Hybrid retrieval → BM25 index: uses keyword index
AI/service/retriever/document_retriever.py - Vector repository → Vector index: delegates operations
AI/database/vector/repository.py - Chat orchestration → Prompt and LLM: runs generation chain
AI/service/chat_service.py - Chat orchestration → Chat repository: saves conversation
AI/service/chat_service.py - Chat repository → Chat history store: delegates storage
AI/database/chat/repository.py - Document routes → RAG ingestion: invokes ingestion
AI/routes/document/document.py - RAG ingestion → Document parsing: parses input
AI/service/rag_service.py - RAG ingestion → Document chunking: splits documents
AI/service/rag_service.py - RAG ingestion → Vector repository: stores chunks
AI/service/rag_service.py - RAG ingestion → Embedding service: receives dependency
AI/container/dependency.py