🚀 HEBEES

RAG 기반 지능형 문서 검색 및 답변 생성 플랫폼
마이크로서비스 아키텍처를 통해 확장 가능한 RAG 파이프라인을 구축하고,
**다양한 문서 형식(PDF, DOCX, XLSX, TXT, 이미지)**을 지원하며,
벡터 검색과 LLM을 결합하여 정확하고 맥락에 맞는 답변을 제공하는 엔터프라이즈급 RAG 시스템입니다.

지식의 연결, 더 스마트한 검색 HEBEES

개발 기간 : 2025.10.10 ~ 2025.11.20
플랫폼 : Web Application
개발 인원 : 7명
기관 : 삼성 청년 SW·AI 아카데미 13기

👥 팀원 소개

👑 최민석
[Infra · Leader]

_{- MSA 기반 시스템 아키텍처 설계 및 구현

- Marker 프로세스 구현

- 전체 일정 관리 및 팀 리딩

- 인프라 구조 안정화}

김태윤 [Backend]	이민희 [Frontend]	이재원 [Backend · AI]
_{- 로그인/인증 시스템 개발 - 문서 업로드/삭제/조회 기능 개발 - 업로드 진행률 실시간 처리 - 알림 시스템 구축}	_{- RAG 채팅 + SSE 실시간 응답 훅 개발 - 실시간 인프라 대시보드 개발 - 공통 UI 컴포넌트 구축 - 서버 API/에러 처리 규칙 통합}	_{- AI 파이프라인 오케스트레이션 - Marker 기반 문서 파싱/레이아웃 분석 - Embedding · 유사도 검색 · Re-ranking 구현 - 스트리밍 AI 응답 시스템 구축}

배준수 [Backend · AI]	이진모 [Frontend]	백종석 [Backend · AI]
_{- ERD & API 명세 설계/관리 - 실시간 대시보드 스트림 개발 - LLM 채팅 및 히스토리 기능 - RAG 커스터마이징 기능 개발}	_{- RAG 운영 데이터 대시보드(SSE) 개발 - Ingest 업로드·처리 실시간 현황 구현 - 벡터화 알림 시스템 구축 - FE 구조개선 및 품질 개선}	_{- RAG 설정 템플릿 CRUD 개발 - 개인 안경원 매출 요약 페이지 개발 - LLM 기반 보고서 생성 API - 체인 안경원 매출 비교 분석 로직 개발}

🔎 목차

🛠️ 기술 스택

🌐 시스템 아키텍처

📦 서비스 구성

📂 디렉터리 구조

📦 프로젝트 산출물

🛠️ 기술 스택

🌕 Frontend

Category	Stack
Language	TypeScript 5.9.3
Runtime Environment	Node.js (Vite 기반)
Framework	React 18.3.1, Vite 7.1.7
Styling	TailwindCSS 3.4.14
State / Data	Zustand 5.0.8, TanStack React Query 5.90.5
Form / Validation	React Hook Form, Zod
Network / Auth	Axios 1.12.2, JWT
UI / Animation	Lucide React 0.548.0, React Toastify 11.0.5, Lottie Web 5.13.0
Build Tool	Vite 7.1.7
IDE	Visual Studio Code

🌑 Backend

Category	Stack
Language	Java 21, Python 3.11
Framework	Spring Boot 3.5.6, FastAPI 0.119.0
Build Tool	Gradle 8.14.3, uv (Python)
Libraries	Spring Security, Spring Data JPA, QueryDSL, Spring Data Redis, Spring Data MongoDB, WebFlux, jjwt 0.11.5, Springdoc OpenAPI 2.5.0, LangChain 1.0.3, LangChain OpenAI 1.0.1, LangChain Ollama 1.0.0, Sentence Transformers, PyTorch, Transformers
Database	MySQL 8.0.11, MongoDB, Redis 7.4.5, Milvus (Vector DB)
AI/ML	OpenAI GPT-4o, Ollama (Qwen), Sentence Transformers, Cross-Encoder
Storage	MinIO (S3 Compatible)
Monitoring	Spring Actuator
Docs	Swagger UI (springdoc-openapi-starter-webmvc-ui 2.5.0)
IDE	IntelliJ IDEA, Visual Studio Code

⚙️ Infra / DevOps

Category	Stack
Containerization	Docker, Docker Compose
CI/CD	Jenkins 2.516.2
Web / Proxy	Nginx 1.27
Version Control	GitLab

🤝 Collaboration

🌐 시스템 아키텍처

🖧 System Architecture

마이크로서비스 기반 RAG 파이프라인

📦 서비스 구성

서비스명	설명	기술 스택
fastapi-gateway	API 게이트웨이, JWT 인증, 라우팅	FastAPI, PyJWT
backend-repo	사용자 관리, 채팅 세션, 대시보드	Spring Boot, MySQL, MongoDB, Redis
python-backend-repo	파일 관리, MinIO 연동	FastAPI, MinIO
ingest-repo	문서 수집 및 파이프라인 오케스트레이션	FastAPI, MySQL, Redis
extract-repo	문서 추출 (PDF, DOCX, XLSX, TXT, 이미지)	FastAPI, PyMuPDF, python-docx, openpyxl, OpenAI
chunking-repo	문서 청킹 (의미 단위 분할)	FastAPI, Transformers, PyTorch
embedding-repo	문서 임베딩 생성	FastAPI, Sentence Transformers, PyTorch, Milvus
query-embedding-repo	쿼리 임베딩 생성	FastAPI, Sentence Transformers
search-repo	벡터 유사도 검색	FastAPI, LangChain, Milvus
cross-encoder-repo	검색 결과 재정렬	FastAPI, Sentence Transformers, Cross-Encoder
generation-repo	LLM 답변 생성 (OpenAI, Ollama)	FastAPI, LangChain, OpenAI, Ollama, MongoDB
frontend-repo	웹 프론트엔드	React, TypeScript, Vite, TanStack Query, Zustand
rag-data-marker	문서 마킹 처리	FastAPI
rag-data-yolo	YOLO 기반 문서 레이아웃 분석	FastAPI, YOLO
rag-embedding-model-runpod	RunPod 기반 임베딩 모델 서비스	FastAPI, RunPod

📂 디렉터리 구조

🌕 Frontend

Frontend-App

📦 frontend-repo
 ┣ 📂public
 ┃ ┣ 📂fonts
 ┃ ┣ 📂lotties
 ┃ ┗ 📜hebees-logo.webp
 ┣ 📂src
 ┃ ┣ 📂app
 ┃ ┣ 📂assets
 ┃ ┣ 📂domains
 ┃ ┃ ┣ 📂admin
 ┃ ┃ │ ┣ 📂api
 ┃ ┃ │ ┣ 📂components
 ┃ ┃ │ │ ┣ 📂dashboard
 ┃ ┃ │ │ ┣ 📂documents
 ┃ ┃ │ │ ┣ 📂rag-settings
 ┃ ┃ │ │ ┣ 📂rag-test
 ┃ ┃ │ │ ┗ 📂users
 ┃ ┃ │ ┣ 📂hooks
 ┃ ┃ │ ┣ 📂pages
 ┃ ┃ │ ┣ 📂types
 ┃ ┃ │ ┗ 📂utils
 ┃ ┃ ┣ 📂auth
 ┃ ┃ │ ┣ 📂api
 ┃ ┃ │ ┣ 📂components
 ┃ ┃ │ ┣ 📂pages
 ┃ ┃ │ ┗ 📂store
 ┃ ┃ ┗ 📂user
 ┃ ┃   ┣ 📂api
 ┃ ┃   ┣ 📂components
 ┃ ┃   ┣ 📂hooks
 ┃ ┃   ┣ 📂pages
 ┃ ┃   ┗ 📂types
 ┣ 📂guards
 ┣ 📂layouts
 ┣ 📂router
 ┣ 📂shared
 ┣ 📜App.tsx
 ┣ 📜main.tsx
 ┣ 📜vite.config.ts
 ┣ 📜tailwind.config.js
 ┗ 📜package.json

🌑 Backend

Backend-Core (Spring Boot)

📦 backend-repo
 ┣ 📂src
 ┃ ┣ 📂main
 ┃ ┃ ┣ 📂java
 ┃ ┃ │ ┗ 📂com/ssafy/hebees
 ┃ ┃ │   ┣ 📂auth
 ┃ ┃ │   │ ┣ 📂controller
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┗ 📂service
 ┃ ┃ │   ┣ 📂chat
 ┃ ┃ │   │ ┣ 📂client
 ┃ ┃ │   │ ┣ 📂config
 ┃ ┃ │   │ ┣ 📂controller
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┣ 📂entity
 ┃ ┃ │   │ ┣ 📂event
 ┃ ┃ │   │ ┣ 📂repository
 ┃ ┃ │   │ ┗ 📂service
 ┃ ┃ │   ┣ 📂common
 ┃ ┃ │   │ ┣ 📂config
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┣ 📂entity
 ┃ ┃ │   │ ┣ 📂exception
 ┃ ┃ │   │ ┣ 📂interceptor
 ┃ ┃ │   │ ┣ 📂response
 ┃ ┃ │   │ ┣ 📂security
 ┃ ┃ │   │ ┗ 📂util
 ┃ ┃ │   ┣ 📂dashboard
 ┃ ┃ │   │ ┣ 📂chat
 ┃ ┃ │   │ ┣ 📂controller
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┣ 📂entity
 ┃ ┃ │   │ ┣ 📂keyword
 ┃ ┃ │   │ ┣ 📂model
 ┃ ┃ │   │ ┣ 📂repository
 ┃ ┃ │   │ ┣ 📂service
 ┃ ┃ │   │ ┗ 📂util
 ┃ ┃ │   ┣ 📂ingest
 ┃ ┃ │   │ ┣ 📂controller
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┗ 📂service
 ┃ ┃ │   ┣ 📂monitoring
 ┃ ┃ │   │ ┣ 📂client
 ┃ ┃ │   │ ┣ 📂config
 ┃ ┃ │   │ ┣ 📂controller
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┣ 📂entity
 ┃ ┃ │   │ ┣ 📂repository
 ┃ ┃ │   │ ┗ 📂service
 ┃ ┃ │   ┣ 📂offer
 ┃ ┃ │   │ ┣ 📂entity
 ┃ ┃ │   │ ┗ 📂repository
 ┃ ┃ │   ┣ 📂ragsetting
 ┃ ┃ │   │ ┣ 📂controller
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┣ 📂entity
 ┃ ┃ │   │ ┣ 📂repository
 ┃ ┃ │   │ ┗ 📂service
 ┃ ┃ │   ┣ 📂user
 ┃ ┃ │   │ ┣ 📂controller
 ┃ ┃ │   │ ┣ 📂dto
 ┃ ┃ │   │ ┣ 📂entity
 ┃ ┃ │   │ ┣ 📂repository
 ┃ ┃ │   │ ┗ 📂service
 ┃ ┃ │   ┗ 📂HebeesApplication.java
 ┃ ┃ ┗ 📂resources
 ┃ ┗ 📂test
 ┣ 📜build.gradle
 ┣ 📜Dockerfile
 ┗ 📜Jenkinsfile

🐍 Python Services

RAG Pipeline Services

📦 RAG Services
 ┣ 📂fastapi-gateway
 ┃ ┣ 📂app
 ┃ │ ┣ 📂common (auth, cache)
 ┃ │ ┣ 📂core (settings, database, utils)
 ┃ │ ┣ 📂routers (rag_router, backend_router)
 ┃ │ ┗ 📂services (proxy_service, docs_service)
 ┃ ┗ 📜run.py
 ┣ 📂ingest-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂core (database, settings)
 ┃ │ ┣ 📂routers (ingest_router, query_router)
 ┃ │ ┣ 📂schemas
 ┃ │ ┣ 📂service (ingest_service, query_service, gateway_client)
 ┃ │ ┗ 📂models
 ┃ ┗ 📜run.py
 ┣ 📂extract-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂routers
 ┃ │ ┣ 📂schemas
 ┃ │ ┣ 📂service
 ┃ │ ┗ 📂src (extraction strategies)
 ┃ ┗ 📜run.py
 ┣ 📂chunking-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂routers
 ┃ │ ┣ 📂schemas
 ┃ │ ┣ 📂service
 ┃ │ ┗ 📂src (chunking strategies)
 ┃ ┗ 📜run.py
 ┣ 📂embedding-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂routers
 ┃ │ ┣ 📂schemas
 ┃ │ ┣ 📂service
 ┃ │ ┣ 📂src (embedding strategies)
 ┃ │ ┗ 📂models
 ┃ ┗ 📜run.py
 ┣ 📂query-embedding-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂routers
 ┃ │ ┣ 📂schemas
 ┃ │ ┣ 📂service
 ┃ │ ┣ 📂services
 ┃ │ ┗ 📂src (query embedding strategies)
 ┃ ┗ 📜run.py
 ┣ 📂search-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂routers
 ┃ │ ┣ 📂schemas
 ┃ │ ┣ 📂service
 ┃ │ ┗ 📂src (search strategies)
 ┃ ┗ 📜run.py
 ┣ 📂cross-encoder-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂routers
 ┃ │ ┣ 📂schemas
 ┃ │ ┗ 📂src (cross-encoder strategies)
 ┃ ┗ 📜run.py
 ┣ 📂generation-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂core (memory_manager, custom_chat_history)
 ┃ │ ┣ 📂routers
 ┃ │ ┣ 📂schemas
 ┃ │ ┣ 📂service
 ┃ │ ┗ 📂src (generation strategies: openai, ollama)
 ┃ ┗ 📜run.py
 ┣ 📂python-backend-repo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂core
 ┃ │ ┗ 📂domains
 ┃ ┗ 📜run.py
 ┣ 📂rag-data-marker
 ┃ ┣ 📂app
 ┃ │ ┣ 📂processors
 ┃ │ ┣ 📂routers
 ┃ │ ┗ 📂services
 ┃ ┗ 📜run.py
 ┣ 📂rag-data-yolo
 ┃ ┣ 📂app
 ┃ │ ┣ 📂processors
 ┃ │ ┗ 📂routers
 ┃ ┗ 📜run.py
 ┗ 📂rag-embedding-model-runpod
   ┣ 📂app
   │ ┣ 📂api
   │ ┣ 📂models
   │ ┗ 📂services
   ┗ 📜main.py

📦 프로젝트 산출물

📐 와이어프레임

🗄️ ERD

✅ Swagger API Docs

Backend

📅 Jira Issues

자세히

📋 기능 명세서

자세히

📡 API 명세서

자세히

📢 Collaboration & Event Notification

🧩 Jenkins Pipeline	🗨️ Jira Issue Created	🔀 Merge Code Review

📊 주요 기능

기능	설명
문서 수집 (Ingest)	PDF, DOCX, XLSX, TXT, 이미지 파일 업로드 및 처리
문서 추출 (Extract)	다양한 형식의 문서에서 텍스트 및 이미지 추출 (Marker, YOLO 활용)
문서 청킹 (Chunking)	의미 단위로 문서 분할
임베딩 생성 (Embedding)	텍스트/이미지를 벡터로 변환하여 Milvus에 저장
벡터 검색 (Search)	쿼리와 유사한 문서 검색
재정렬 (Cross-Encoder)	검색 결과 정확도 향상을 위한 재정렬
답변 생성 (Generation)	LLM을 통한 맥락 기반 답변 생성 (OpenAI, Ollama/Qwen)
스트리밍 응답	SSE를 통한 실시간 답변 스트리밍
대화 기록 관리	MongoDB를 통한 채팅 히스토리 저장
대시보드	사용량 통계, 에러 모니터링, 키워드 분석
RAG 설정 관리	추출, 청킹, 임베딩, 검색, 재정렬, 프롬프트 전략 설정

🎨 주요 화면

📝 사용자 채팅

📄 문서 업로드 (사용자)

🖼️ 이미지 생성 (사용자)

📊 운영 대시보드

⚙️ RAG 대시보드

HEBEES - 지식의 연결, 더 스마트한 검색

Name		Name	Last commit message	Last commit date
Latest commit History 1,646 Commits
backend-repo		backend-repo
chunking-repo		chunking-repo
cross-encoder-repo		cross-encoder-repo
embedding-repo		embedding-repo
exec		exec
extract-repo		extract-repo
fastapi-gateway		fastapi-gateway
frontend-repo		frontend-repo
generation-repo		generation-repo
ingest-repo		ingest-repo
python-backend-repo		python-backend-repo
query-embedding-repo		query-embedding-repo
rag-data-marker		rag-data-marker
rag-data-yolo		rag-data-yolo
rag-embedding-model-runpod		rag-embedding-model-runpod
readme-assets		readme-assets
search-repo		search-repo
spring-gateway-repo		spring-gateway-repo
.gitignore		.gitignore
.gitmodules		.gitmodules
README.md		README.md

minhe8564/rag-extension

Folders and files

Latest commit

History

Repository files navigation

🚀 HEBEES

👥 팀원 소개

🔎 목차

🛠️ 기술 스택

🌕 Frontend

🌑 Backend

⚙️ Infra / DevOps

🤝 Collaboration

🌐 시스템 아키텍처

🖧 System Architecture

📦 서비스 구성

📂 디렉터리 구조

🌕 Frontend

🌑 Backend

🐍 Python Services

📦 프로젝트 산출물

📐 와이어프레임

🗄️ ERD

✅ Swagger API Docs

📅 Jira Issues

📋 기능 명세서

📡 API 명세서

📢 Collaboration & Event Notification

📊 주요 기능

🎨 주요 화면

📝 사용자 채팅

📄 문서 업로드 (사용자)

🖼️ 이미지 생성 (사용자)

📊 운영 대시보드

⚙️ RAG 대시보드

About

Resources

Uh oh!

Stars

Watchers

Forks

Uh oh!

Languages