Project Kickoff Checklist
### 1.1 엔티티 명명
checklist docs/checklist/project-kickoff.md
planner 에이전트가 새 프로젝트 시작 시 참조하는 체크리스트. 코딩 시작 전에 아래 항목을 모두 확인/결정해야 한다.
1. 도메인 설계
1.1 엔티티 명명
- 핵심 엔티티명 확정 (단수형 영어: Prompt, User, Category)
- DB 테이블명 = snake_case 복수형 (prompts, users)
- URL 경로명 = kebab-case 복수형 (/prompts, /categories)
- 약어 사용 시 용어집에 등록
1.2 데이터 모델
- "누가 했는지" 추적 필요한 행위 식별 → 이벤트 테이블 설계
- 1:N / N:M 관계 명확히 정의
- 소프트 삭제 전략 결정 (deleted_at vs 물리 삭제)
- 감사 컬럼 정의 (created_at, updated_at, created_by)
- PK 전략 결정 (UUID vs auto-increment)
1.3 렌더링 전략
- SEO 필요 페이지 → SSR/SSG
- SEO 불필요 페이지 → CSR
- 주요 페이지별 렌더링 방식 명시
1.4 리텐션 루프
- 사용자가 재방문하는 이유 1가지 이상 명시
- 핵심 지표(North Star Metric) 정의
2. 기술 설계
2.1 환경 호환성 매트릭스
- OS (Windows/Mac/Linux) 호환 확인
- Python/Node.js 버전 명시 + 라이브러리 호환성 확인
- DB 버전 명시
- Docker 이미지 버전 고정
2.2 동시성 시나리오
- 동시 쓰기 가능 리소스 식별 (좋아요, 조회수, 재고 등)
- 중복 방지 전략 (UNIQUE 제약, idempotency key 등)
- 락 전략 결정 (필요 시)
2.3 ERD
- MVP 범위 전체 엔티티 관계도 (텍스트 또는 Mermaid)
- FK + 인덱스 설계 포함
2.4 API 전체 목록
- 모든 엔드포인트: Method + Path + Auth + response_model
- 공개 / 인증 필수 / Admin 전용 분류
- 버전 전략 결정 (v1/ prefix 등)
3. 인프라 & 보안
3.1 환경 구성
- .env 변수 목록 확정 (.env.example 작성)
- 개발/스테이징/프로덕션 환경 차이 정의
3.2 초기 보안
- Rate limiting 정책 (분당 요청 수)
- Request body 크기 제한
- CORS 허용 도메인
완료 기준
- 1.1~2.4 모든 항목에 결정 또는 "이번 Phase에서 불필요" 명시
- 결과를 INTENT.md "제약 조건" 섹션에 반영
- 사용자 승인 완료