주요 개발 수행 지침

1. 팀 구성

이름	역할
진수택	PL · 테크리드
박소연	프론트엔드 · 개인 배포(cloverky.cloud)
이우정	SM
김민아	백엔드

2. 아키텍처 원칙

• 백엔드는 feature-first 헥사고날 구조다. 도메인마다 domain → app(use_cases · ports · dtos) → adapter(inbound api / outbound orm · gemini) 순서로 의존한다.
• 레이어 규칙은 import-linter 계약 5개로 CI에서 강제한다.
• DB 스키마는 Alembic으로 관리하고 서버 기동 시 upgrade head를 실행한다.

3. 협업 · 품질

• GitHub Flow — main 보호, PR 머지만 허용.
• CI: 백엔드 ruff · mypy · lint-imports · pytest, 프론트 tsc · lint · build.
• 코드와 문서가 다르면 코드가 정답이다. 현재 상태는 HANDOFF.md 한 곳에 모은다.

4. 설계 문서

문서	핵심 결정
PLAN.md	Expo → FastAPI + React 전환, 비전 → 속성 → 낱알식별 파이프라인, 이미지 미저장
docs/ERD.md	v1.4, 목표 12개 테이블 (현재 구현 3개)
docs/FRONTEND-OVERHAUL.md	라이트 · 민트 · Pretendard 유지, 디자인 토큰화, 라우터 도입
docs/FRONTEND-POLISH.md	AA 대비 버튼색, 입력 글자 16px, 모바일 폴리시
docs/backend-tasks/P1~P4	기반 · 데이터 매칭 · Vision · 상담 4트랙 분담