개발 일정 및 추진 체계

단계별 개발 일정

Sprint 1 — 기반 구축

예정	진행중	완료
		✅ FastAPI + Clean Architecture 기반 세팅
		✅ PostgreSQL (Neon) + SQLAlchemy 2.0 Async
		✅ Docker Compose 로컬 환경
		✅ Next.js 16 프론트엔드 초기 구조
		✅ JWT 인증 + OAuth 2.0 (Google·Kakao·Naver)

Sprint 2 — Mova 코어

예정	진행중	완료
		✅ TMDB 영화 데이터 import (200+ 편)
		✅ 박스오피스 랭킹 (KOFIC API)
		✅ 영화 상세·검색·컬렉션·찜
		✅ Gemini 영화 챗봇
		✅ 개봉 예정작 (TMDB)

Sprint 3 — AI 추천 + 리뷰

예정	진행중	완료
		✅ EXAONE-2.4B AWQ LoRA 파인튜닝
		✅ LoRA 서버 (systemd + Cloudflare Tunnel)
		✅ Gemini 폴백 듀얼 백엔드
		✅ 크롤링 파이프라인 (KOBIS·뉴스·위키)
		✅ AI 리뷰 자동 생성 (Gemini)

Sprint 4 — Gildle + 보안

예정	진행중	완료
		✅ OSM 보행 그래프 추출 (osmnx)
		✅ 환경 점수 배치 산정 (가로수·결빙)
		✅ A* 경로 추천 + 시즌 모드
		✅ Leaflet 지도 시각화
		✅ IDOR 취약점 5건 전수 수정

Sprint 5 — 고도화

예정	진행중	완료
		✅ 지역 확장 (영등포구 → 서울 전역 23만 간선)
		✅ 여름 그늘 경로 (건물 그림자 사전 계산)
		✅ 리뷰 감정분석·유용성 투표, 베이지안 가중 평점
		✅ 자동 폴백 + 서킷 브레이커, mypy strict 재활성화
EC2 Docker 이미지 통합		폐기 — 프로덕션을 노트북으로 이전하며 대상 소멸

Sprint 6 — 온프레미스 · 에이전트 · v1 마감 (2026.09)

예정	진행중	완료
		✅ 프로덕션 EC2 → 노트북 이전(09-03), k3s 컷오버(09-07)
		✅ 추천 모델 GGUF 전환(llama.cpp), 임베딩 bge-m3 교체
		✅ 채팅 도구 호출 에이전트 (판단 모델 v9, 도구 10개)
		✅ 길들: 브이월드 건물 그림자 월별 12벌, 경로 후보, 문장 추천, 네이버 지도
		✅ 길들 Flutter 앱 — 게스트 모드·이메일 가입·회원 탈퇴, 릴리스 번들
		✅ 웹 인증 httpOnly 쿠키 전환 (09-30)
		✅ 길들 웹·앱 통일 (09-30)
	길들 Play 스토어 출시 (내부 → 비공개 테스트)	✅ v1 마감 (2026-09-30)

---

위험 관리 방안

위험 요소	영향	대응
GPU 서버 다운	추천 서비스 중단	Gemini 자동 폴백 + 서킷 브레이커(연속 2회 실패 → 60초 우회 → 자동 복귀)
노트북 전원·네트워크	서빙 기기 전환	집 서버가 약 30초 안에 자동으로 넘겨받음(10-05). 노트북이 밖이면 GPU만 Tailscale로 제공(10-06)
집 서버 전원	API 전체 중단(프론트만 생존)	DB가 한 곳이라 감수한 트레이드오프 — 클라우드 분리안은 비용·지연으로 기각(09-29)
환경 변수 누락	빈 자격증명으로 기동	배포 스크립트가 .env → Secret 변환, 없으면 즉시 실패
외부 API 제한	수집 실패	타일 분할·미러 순환·지수 백오프·이어받기, 부분 수집 허용
VRAM 경합	운영 추론 + 학습 동시 불가(8GB)	학습은 Colab에서 GGUF까지 완결, 노트북 GPU는 운영 전용
소형 모델 천장	2.4B 판단 모델이 재학습해도 v9(77/86)를 못 넘음	새 기능은 프롬프트 예시로 얹고, 사실·기록은 코드 가드로 보호
하네스 밖 장면	실사용에서만 드러나는 버그	실사용 대화를 평가셋·회귀 테스트에 그대로 추가