# kwonhalim/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/kwonhalim/portfolio
- Repository: https://github.com/kwonhalim/portfolio

## Overview

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: [`AI/service/chat_service.py`](https://github.com/kwonhalim/portfolio/blob/main/AI/service/chat_service.py) (Chat orchestration), [`AI/service/rag_service.py`](https://github.com/kwonhalim/portfolio/blob/main/AI/service/rag_service.py) (RAG ingestion), [`FrontEnd/src/js/api.js`](https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/api.js) (API client), [`Backend/src/main/java/portfolio/backend/BackendApplication.java`](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/BackendApplication.java) (REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Portfolio frontend"]
  node_site["Portfolio UI<br/>[navigation.js]"]
  node_project_ui["Project browser<br/>[projects.js]"]
  node_chat_ui["Chat interface<br/>[chatbot.js]"]
  node_frontend_api["API client<br/>[api.js]"]
end

subgraph group_backend["Portfolio API"]
  node_backend_app["REST API"]
  node_profile_controller["Profile endpoint"]
  node_profile_service["Profile service"]
  node_profile_store[("Profile data")]
  node_project_controller["Project endpoints"]
  node_project_service["Project service"]
  node_project_store[("Project data")]
  node_feedback_controller["Feedback endpoint"]
  node_feedback_service["Feedback service"]
  node_timeline_service["Timeline service"]
  node_timeline_store[("Timeline data")]
end

subgraph group_ai["AI chatbot"]
  node_ai_app["Chatbot API<br/>[main.py]"]
  node_chat_route["Chat routes<br/>[chat.py]"]
  node_chat_service["Chat orchestration<br/>[chat_service.py]"]
  node_retriever["Hybrid retrieval"]
  node_vector_repo["Vector repository<br/>[repository.py]"]
  node_vector_store[("Vector index")]
  node_bm25["BM25 index<br/>[bm25_manager.py]"]
  node_prompt_llm["Prompt and LLM<br/>[prompt.py]"]
  node_chat_repo["Chat repository<br/>[repository.py]"]
  node_chat_store[("Chat history store")]
  node_cache[("Semantic cache")]
  node_document_route["Document routes<br/>[document.py]"]
  node_rag_service["RAG ingestion<br/>[rag_service.py]"]
  node_data_processor["Document parsing<br/>[data_processor.py]"]
  node_chunk_service["Document chunking<br/>[service.py]"]
  node_embedding_service["Embedding service<br/>[service.py]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_site
node_visitor -->|"asks"| node_chat_ui
node_site -.->|"requests data"| node_frontend_api
node_project_ui -.->|"requests projects"| node_frontend_api
node_chat_ui -.->|"submits questions"| node_frontend_api
node_frontend_api -.->|"calls API"| node_backend_app
node_frontend_api -.->|"calls chatbot"| node_ai_app
node_backend_app -.->|"routes requests"| node_profile_controller
node_backend_app -.->|"routes requests"| node_project_controller
node_profile_controller -->|"delegates"| node_profile_service
node_profile_service -->|"queries"| node_profile_store
node_project_controller -->|"delegates"| node_project_service
node_project_service -->|"queries"| node_project_store
node_feedback_controller -->|"delegates"| node_feedback_service
node_timeline_service -->|"queries education"| node_timeline_store
node_ai_app -->|"mounts router"| node_chat_route
node_ai_app -->|"mounts router"| node_document_route
node_chat_route -->|"invokes"| node_chat_service
node_chat_service -->|"checks and fills"| node_cache
node_chat_service -->|"retrieves context"| node_retriever
node_retriever -->|"searches vectors"| node_vector_repo
node_retriever -->|"uses keyword index"| node_bm25
node_vector_repo -->|"delegates operations"| node_vector_store
node_chat_service -->|"runs generation chain"| node_prompt_llm
node_chat_service -->|"saves conversation"| node_chat_repo
node_chat_repo -->|"delegates storage"| node_chat_store
node_document_route -->|"invokes ingestion"| node_rag_service
node_rag_service -->|"parses input"| node_data_processor
node_rag_service -->|"splits documents"| node_chunk_service
node_rag_service -->|"stores chunks"| node_vector_repo
node_rag_service -->|"receives dependency"| node_embedding_service

click node_site "https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/navigation.js"
click node_project_ui "https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/projects.js"
click node_chat_ui "https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/chatbot.js"
click node_frontend_api "https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/api.js"
click node_backend_app "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/BackendApplication.java"
click node_profile_controller "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/controller/ProfileController.java"
click node_profile_service "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/ProfileService.java"
click node_profile_store "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/repository/ProfileRepository.java"
click node_project_controller "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/controller/ProjectController.java"
click node_project_service "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/ProjectService.java"
click node_project_store "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/repository/ProjectRepository.java"
click node_feedback_controller "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/controller/FeedBackController.java"
click node_feedback_service "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/FeedBackService.java"
click node_timeline_service "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/TimelineService.java"
click node_timeline_store "https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/repository/EducationRepository.java"
click node_ai_app "https://github.com/kwonhalim/portfolio/blob/main/AI/main.py"
click node_chat_route "https://github.com/kwonhalim/portfolio/blob/main/AI/routes/chat/chat.py"
click node_chat_service "https://github.com/kwonhalim/portfolio/blob/main/AI/service/chat_service.py"
click node_retriever "https://github.com/kwonhalim/portfolio/blob/main/AI/service/retriever/document_retriever.py"
click node_vector_repo "https://github.com/kwonhalim/portfolio/blob/main/AI/database/vector/repository.py"
click node_vector_store "https://github.com/kwonhalim/portfolio/blob/main/AI/database/vector/vector_strategy/vector_store_strategy.py"
click node_bm25 "https://github.com/kwonhalim/portfolio/blob/main/AI/service/retriever/bm25_manager.py"
click node_prompt_llm "https://github.com/kwonhalim/portfolio/blob/main/AI/service/langchain/prompt.py"
click node_chat_repo "https://github.com/kwonhalim/portfolio/blob/main/AI/database/chat/repository.py"
click node_chat_store "https://github.com/kwonhalim/portfolio/blob/main/AI/database/chat/chat_strategy/langchain_mongo_repository.py"
click node_cache "https://github.com/kwonhalim/portfolio/blob/main/AI/service/cache/redis_semantic_cache.py"
click node_document_route "https://github.com/kwonhalim/portfolio/blob/main/AI/routes/document/document.py"
click node_rag_service "https://github.com/kwonhalim/portfolio/blob/main/AI/service/rag_service.py"
click node_data_processor "https://github.com/kwonhalim/portfolio/blob/main/AI/service/data/data_processor.py"
click node_chunk_service "https://github.com/kwonhalim/portfolio/blob/main/AI/service/chunk/service.py"
click node_embedding_service "https://github.com/kwonhalim/portfolio/blob/main/AI/service/embedding/service.py"

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_site,node_project_ui,node_chat_ui,node_frontend_api toneBlue
class node_backend_app,node_profile_controller,node_profile_service,node_profile_store,node_project_controller,node_project_service,node_project_store,node_feedback_controller,node_feedback_service,node_timeline_service,node_timeline_store toneAmber
class node_ai_app,node_chat_route,node_chat_service,node_retriever,node_vector_repo,node_vector_store,node_bm25,node_prompt_llm,node_chat_repo,node_chat_store,node_cache,node_document_route,node_rag_service,node_data_processor,node_chunk_service,node_embedding_service toneMint
class node_visitor toneIndigo
```

## Components

### Portfolio frontend

- [Portfolio UI](https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/navigation.js): `FrontEnd/src/js/navigation.js`
- [Project browser](https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/projects.js): `FrontEnd/src/js/projects.js`
- [Chat interface](https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/chatbot.js): `FrontEnd/src/js/chatbot.js`
- [API client](https://github.com/kwonhalim/portfolio/blob/main/FrontEnd/src/js/api.js): `FrontEnd/src/js/api.js`

### Portfolio API

- [REST API](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/BackendApplication.java): `Backend/src/main/java/portfolio/backend/BackendApplication.java`
- [Profile endpoint](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/controller/ProfileController.java): `Backend/src/main/java/portfolio/backend/controller/ProfileController.java`
- [Profile service](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/ProfileService.java): `Backend/src/main/java/portfolio/backend/service/ProfileService.java`
- [Profile data](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/repository/ProfileRepository.java): `Backend/src/main/java/portfolio/backend/repository/ProfileRepository.java`
- [Project endpoints](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/controller/ProjectController.java): `Backend/src/main/java/portfolio/backend/controller/ProjectController.java`
- [Project service](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/ProjectService.java): `Backend/src/main/java/portfolio/backend/service/ProjectService.java`
- [Project data](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/repository/ProjectRepository.java): `Backend/src/main/java/portfolio/backend/repository/ProjectRepository.java`
- [Feedback endpoint](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/controller/FeedBackController.java): `Backend/src/main/java/portfolio/backend/controller/FeedBackController.java`
- [Feedback service](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/FeedBackService.java): `Backend/src/main/java/portfolio/backend/service/FeedBackService.java`
- [Timeline service](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/service/TimelineService.java): `Backend/src/main/java/portfolio/backend/service/TimelineService.java`
- [Timeline data](https://github.com/kwonhalim/portfolio/blob/main/Backend/src/main/java/portfolio/backend/repository/EducationRepository.java): `Backend/src/main/java/portfolio/backend/repository/EducationRepository.java`

### AI chatbot

- [Chatbot API](https://github.com/kwonhalim/portfolio/blob/main/AI/main.py): `AI/main.py`
- [Chat routes](https://github.com/kwonhalim/portfolio/blob/main/AI/routes/chat/chat.py): `AI/routes/chat/chat.py`
- [Chat orchestration](https://github.com/kwonhalim/portfolio/blob/main/AI/service/chat_service.py): `AI/service/chat_service.py`
- [Hybrid retrieval](https://github.com/kwonhalim/portfolio/blob/main/AI/service/retriever/document_retriever.py): `AI/service/retriever/document_retriever.py`
- [Vector repository](https://github.com/kwonhalim/portfolio/blob/main/AI/database/vector/repository.py): `AI/database/vector/repository.py`
- [Vector index](https://github.com/kwonhalim/portfolio/blob/main/AI/database/vector/vector_strategy/vector_store_strategy.py): `AI/database/vector/vector_strategy/vector_store_strategy.py`
- [BM25 index](https://github.com/kwonhalim/portfolio/blob/main/AI/service/retriever/bm25_manager.py): `AI/service/retriever/bm25_manager.py`
- [Prompt and LLM](https://github.com/kwonhalim/portfolio/blob/main/AI/service/langchain/prompt.py): `AI/service/langchain/prompt.py`
- [Chat repository](https://github.com/kwonhalim/portfolio/blob/main/AI/database/chat/repository.py): `AI/database/chat/repository.py`
- [Chat history store](https://github.com/kwonhalim/portfolio/blob/main/AI/database/chat/chat_strategy/langchain_mongo_repository.py): `AI/database/chat/chat_strategy/langchain_mongo_repository.py`
- [Semantic cache](https://github.com/kwonhalim/portfolio/blob/main/AI/service/cache/redis_semantic_cache.py): `AI/service/cache/redis_semantic_cache.py`
- [Document routes](https://github.com/kwonhalim/portfolio/blob/main/AI/routes/document/document.py): `AI/routes/document/document.py`
- [RAG ingestion](https://github.com/kwonhalim/portfolio/blob/main/AI/service/rag_service.py): `AI/service/rag_service.py`
- [Document parsing](https://github.com/kwonhalim/portfolio/blob/main/AI/service/data/data_processor.py): `AI/service/data/data_processor.py`
- [Document chunking](https://github.com/kwonhalim/portfolio/blob/main/AI/service/chunk/service.py): `AI/service/chunk/service.py`
- [Embedding service](https://github.com/kwonhalim/portfolio/blob/main/AI/service/embedding/service.py): `AI/service/embedding/service.py`

### Other components

- **Visitor**

## Connections

- Visitor → Portfolio UI: browses (evidence: `README.md`)
- Visitor → Chat interface: asks (evidence: `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 (evidence: `Backend/src/main/java/portfolio/backend/controller/ProfileController.java`)
- Profile service → Profile data: queries (evidence: `Backend/src/main/java/portfolio/backend/service/ProfileService.java`)
- Project endpoints → Project service: delegates (evidence: `Backend/src/main/java/portfolio/backend/controller/ProjectController.java`)
- Project service → Project data: queries (evidence: `Backend/src/main/java/portfolio/backend/service/ProjectService.java`)
- Feedback endpoint → Feedback service: delegates (evidence: `Backend/src/main/java/portfolio/backend/controller/FeedBackController.java`)
- Timeline service → Timeline data: queries education (evidence: `Backend/src/main/java/portfolio/backend/service/TimelineService.java`)
- Chatbot API → Chat routes: mounts router (evidence: `AI/main.py`)
- Chatbot API → Document routes: mounts router (evidence: `AI/main.py`)
- Chat routes → Chat orchestration: invokes (evidence: `AI/routes/chat/chat.py`)
- Chat orchestration → Semantic cache: checks and fills (evidence: `AI/service/chat_service.py`)
- Chat orchestration → Hybrid retrieval: retrieves context (evidence: `AI/service/chat_service.py`)
- Hybrid retrieval → Vector repository: searches vectors (evidence: `AI/service/retriever/document_retriever.py`)
- Hybrid retrieval → BM25 index: uses keyword index (evidence: `AI/service/retriever/document_retriever.py`)
- Vector repository → Vector index: delegates operations (evidence: `AI/database/vector/repository.py`)
- Chat orchestration → Prompt and LLM: runs generation chain (evidence: `AI/service/chat_service.py`)
- Chat orchestration → Chat repository: saves conversation (evidence: `AI/service/chat_service.py`)
- Chat repository → Chat history store: delegates storage (evidence: `AI/database/chat/repository.py`)
- Document routes → RAG ingestion: invokes ingestion (evidence: `AI/routes/document/document.py`)
- RAG ingestion → Document parsing: parses input (evidence: `AI/service/rag_service.py`)
- RAG ingestion → Document chunking: splits documents (evidence: `AI/service/rag_service.py`)
- RAG ingestion → Vector repository: stores chunks (evidence: `AI/service/rag_service.py`)
- RAG ingestion → Embedding service: receives dependency (evidence: `AI/container/dependency.py`)
