예지(YEJI) 는 단순한 텍스트 기반 운세를 넘어, 프리미엄 인터랙티브 경험과 AI 정밀 분석, 소셜 게이미피케이션을 결합한 차세대 운세 플랫폼입니다.
사용자는 물리 엔진 기반의 카드 셔플로 직접 타로/화투 카드를 선택하고, 커스텀 파인튜닝된 LLM이 동양 도사와 서양 마법사 캐릭터의 유머러스한 티키타카로 운세를 해석해줍니다.
SSAFY 14기 자율 프로젝트 A605팀 | 2026.01.05 - 2026.02.09 (6주)
|
|
|
|
사용자
|
┌──────▼──────┐
│ Nginx │
│ Reverse │
│ Proxy │
└──┬──────┬───┘
│ │
┌────────▼┐ ┌──▼────────┐
│ Backend │ │ AI Server │
│ Spring │ │ FastAPI │
│ Boot 3.4 │ │ + vLLM │
└──┬───┬───┘ └─────┬─────┘
│ │ │
┌────▼┐ ┌▼────┐ ┌────▼─────┐
│ RDS │ │Redis│ │ Qwen3 │
│ PG │ │ │ │ 4B AWQ │
└─────┘ └─────┘ └──────────┘
(GPU)
| 계층 | 기술 | 설명 |
|---|---|---|
| Frontend | React 19, TypeScript, Framer Motion, Tailwind CSS | 물리 엔진 카드 인터랙션, 프리미엄 UI |
| Backend | Java 21, Spring Boot 3.4, Spring Security, JPA | 인증/인가, 도메인 로직, SSE 중계 |
| AI Server | Python 3.11, FastAPI, Pydantic v2, structlog | 운세 생성, 프롬프트 엔지니어링, 후처리 |
| LLM 추론 | vLLM, yeji-4b-instruct-v9-AWQ |
GPU 기반 실시간 텍스트 생성 |
| Database | PostgreSQL 16 (RDS), Redis | 영속 데이터 + 세션/캐시 |
| Infra | AWS EC2, Docker, Jenkins, Nginx | CI/CD 자동 배포 |
| 저장소 | 설명 | 주요 기술 |
|---|---|---|
| yeji-ai | AI 운세 생성 서버 | Python 3.11, FastAPI, vLLM, Qwen3 4B AWQ |
| yeji-backend | 백엔드 API 서버 | Java 21, Spring Boot 3.4, PostgreSQL, Redis |
| yeji-frontend | 프론트엔드 웹 앱 | React 19, TypeScript, Framer Motion, Vite |
| yeji-code-review | 코드 리뷰 아카이브 | 7라운드 / 249건 (CRITICAL 26, HIGH 72) |
이 프로젝트는 직접 파인튜닝한 커스텀 LLM을 사용합니다.
| 모델 | 기반 | 양자화 | 용도 |
|---|---|---|---|
tellang/yeji-4b-instruct-v9-AWQ |
Qwen3 4B | AWQ 4bit | 프로덕션 (GPU 추론) |
- 학습 데이터: 사주/타로 도메인 특화 + 캐릭터 페르소나 + 구조화 출력 (JSON)
- 학습 기법: QLoRA (Rank 16) + NEFTune + Cosine LR
- 추론 최적화: vLLM + guided_json + AWQ 양자화 (메모리 75% 절감)
SSAFY 14기 A605팀 | Samsung Software Academy For Youth
