패키지 구조
Spring Boot (glowb-server)
Section titled “Spring Boot (glowb-server)”주요 패키지
Section titled “주요 패키지”| 패키지 | 역할 | 파일 수 |
|---|---|---|
| controller/main/ | 메인 API 엔드포인트 | 20 |
| controller/saas/ | SaaS 기능 엔드포인트 | 12 |
| controller/legacy/ | 레거시 (단계적 제거) | 11 |
| Service/ | 비즈니스 로직 | 85 |
| Repository/ | 데이터 접근 (JPA + QueryDSL) | 79 |
| entity/ | JPA 엔티티 | 90 |
| dto/ | 요청/응답 DTO | 37 디렉토리 |
| Enum/ | 열거형 | 61 |
| config/security/ | JWT 인증, Spring Security | - |
| Mapper/ | 엔티티-DTO 변환 | - |
네이밍 컨벤션
Section titled “네이밍 컨벤션”- 컨트롤러: {Domain}Controller.java
- 서비스: {Domain}Service.java
- 레포지토리: {Domain}Repository.java
- 엔티티: {Domain}.java (테이블명: TB_{DOMAIN})
- DTO: {Domain}RequestDto, {Domain}ResponseDto, {Domain}Dto
Python FastAPI 서비스
Section titled “Python FastAPI 서비스”Python 주요 모듈
Section titled “Python 주요 모듈”| 모듈 | 역할 |
|---|---|
| routers/ | FastAPI 엔드포인트 정의 |
| service/ | 비즈니스 로직 (크롤링, AI, 벡터화) |
| tasks_rq/ | Redis Queue 백그라운드 작업 |
| schemas/ | SQLAlchemy ORM 모델 (PostgreSQL) |
| prompts/ | Gemini AI 프롬프트 템플릿 (34개) |
| util/ | PDF/DOCX 생성, 티어 계산 등 |