1. 프로젝트 목적
사진 한 장을 올리면 AI가 사진을 분석하고, 4가지 그림체 중 선택한 스타일로 다시 그려 한 줄 캡션과 함께 보여주는 그림일기 서비스입니다. 모바일 웹을 기준으로 MVP를 진행하고, 이후 네이티브 앱으로 확장할 계획입니다.
2. 대상 사용자
- 테스터 — 관리자가 전화번호로 등록한 초대 대상만 입장 가능(SMS 인증 없이 이름+전화번호 확인, 신뢰 기반). 사진 업로드, 스타일 선택, 결과 확인, 5점 피드백을 남깁니다.
- 관리자 — Supabase Auth로 로그인. 프롬프트(1단계 분석 / 2단계 공통·사진유형·스타일·부정) 버전 관리, API 키 보관(Vault), 테스터 관리, 생성 결과 확인, 연동 테스트, 4스타일 비교 테스트를 수행합니다.
3. 핵심 기능 요구사항
- 사진 업로드 — 1장 업로드(MVP), 클라이언트에서 최대 1536px로 리사이즈 후 전송(비용·속도 절감)
- 스타일 선택 — 파스텔 크레용 · 색연필 일러스트 · 수채화 · 잉크 라인아트 4종 고정
- 2단계 AI 파이프라인 — 1단계(사진유형·캡션·안전성 분석) → 2단계(사진유형+스타일+공통 프롬프트를 조립해 이미지 생성)
- 비동기 처리 — 접수 즉시 응답하고 백그라운드에서 생성, 홈 피드에서 진행중/완료/실패/거부 상태를 확인
- 스토리 뷰어 — 전체화면으로 그림일기를 넘겨보는 화면(좌우 스와이프/탭), 캡션은 이미지 위에 레이어로 표시
- 피드백 — 완료된 그림일기에 5점 척도 평가
- 백오피스 — 프롬프트 버전 관리, API 키 Vault 저장, 테스터 관리, 결과 확인, 연동 테스트, 4스타일 동시 비교 + 테스트 히스토리, Batch API 실험
4. 비기능 요구사항
- 완전한 인프라 분리 — 기존 사내 시스템(가득율 관리 시스템)과 git 브랜치 · Vercel 프로젝트 · Supabase 프로젝트 · 도메인 · API 키를 전부 독립적으로 구성
- 접근 제어 — anon 롤에는 테이블 정책을 주지 않고, 소비자 파이프라인은 서버 사이드 서비스 롤 키로만 DB·스토리지에 접근
- 비용 관리 — 이미지 생성 비용이 서비스 단가에 직접 영향을 주는 구조라, 모델 선택 · 해상도 · API 방식을 지속적으로 재검토
5. 제약 사항
MVP는 1장 업로드로 한정하고, 펜슬·크레딧 같은 과금 체계와 이용약관은 보류합니다. 실사용자 인증(SMS OTP, 카카오 로그인 등)도 정식 도입 전이라, 지금은 관리자가 등록한 테스터만 화이트리스트 방식으로 입장합니다.