feat: bootstrap lunch picker miniapp with backend, docs, and branding assets

template/docs/01_MVP_PRODUCT_SPEC.md

@@ -0,0 +1,120 @@
+# 직장인 점심 추천 미니앱 MVP 기획/기능 명세
+
+## 1. 목표
+- 사용자 현재 위치 기반으로 근처 식당을 빠르게 탐색한다.
+- 점심 시간 의사결정을 줄이기 위해 카테고리 필터(한식/중식/일식/양식/기타)와 정렬(거리/평점/좋아요)을 제공한다.
+- 사용자 생성 데이터(리뷰/별점/좋아요)를 누적해 추천 품질을 개선한다.
+
+## 2. MVP 범위
+### 2.1 포함
+- 위치 권한 요청 및 현재 좌표 획득
+- 반경 N미터 내 식당 목록 조회
+- 카테고리 필터
+- 식당 상세(기본 정보, 평균 평점, 좋아요 수, 최근 리뷰)
+- 리뷰 작성/수정/삭제
+- 별점(1~5) 작성
+- 좋아요 토글
+- 사용자별 내 리뷰 목록
+
+### 2.2 제외(2차)
+- 결제/예약
+- 친구 초대/소셜 그래프
+- AI 취향 학습 개인화 추천
+- 관리자 운영 콘솔 웹
+
+## 3. 사용자 시나리오
+1. 사용자가 미니앱 실행
+2. 위치 권한 동의
+3. 현재 위치 기준 주변 식당 로딩
+4. 카테고리(예: 일식) 선택
+5. 정렬 기준(거리순/평점순) 선택
+6. 식당 상세 진입
+7. 리뷰와 평점 확인 후 본인 리뷰 남김
+8. 마음에 드는 식당 좋아요
+
+## 4. 화면 구조(MVP)
+### 4.1 홈/목록 화면
+- 상단: 현재 위치(동 이름 또는 좌표 기반 주소), 반경 선택(500m/1km/2km)
+- 필터: 카테고리 탭
+- 정렬: 거리순, 평점순, 좋아요순
+- 리스트 카드: 식당명, 카테고리, 거리, 평균평점, 좋아요수, 리뷰수
+
+### 4.2 식당 상세 화면
+- 기본 정보: 상호명, 주소, 영업시간, 전화번호
+- 통계: 평균평점, 총 리뷰수, 좋아요수
+- 액션: 좋아요 버튼, 리뷰 작성 버튼
+- 리뷰 리스트: 최신순 기본, 본인 리뷰 강조
+
+### 4.3 리뷰 작성/수정 화면
+- 평점(1~5)
+- 텍스트(최대 500자)
+- 저장/취소
+
+### 4.4 내 활동 화면
+- 내가 작성한 리뷰 목록
+- 내가 좋아요한 식당 목록(선택)
+
+## 5. 추천/정렬 규칙(MVP)
+- 기본 정렬: 거리 오름차순
+- 평점 정렬: 평균 평점 내림차순, 동점 시 리뷰수 내림차순
+- 좋아요 정렬: 좋아요수 내림차순, 동점 시 거리 오름차순
+
+## 6. 카테고리 정책
+- 내부 표준 카테고리
+  - KOREAN
+  - CHINESE
+  - JAPANESE
+  - WESTERN
+  - OTHER
+- 외부 장소 API 카테고리 값을 내부 표준 카테고리로 매핑
+- 매핑 실패 시 OTHER
+
+## 7. 권한/개인정보 최소 수집
+- 필수: 위치 권한
+- 선택: 알림(2차)
+- 사용자 식별자: 토스 식별자 또는 내부 user_id
+- 저장 데이터
+  - 리뷰 텍스트, 평점
+  - 좋아요 이력
+  - 위치는 조회 시점 중심 좌표만 사용(정밀 로그 장기 저장 금지 권장)
+
+## 8. 비기능 요구사항
+- 최초 화면 진입 10초 이내
+- 목록 API p95 800ms 이하 목표
+- 앱 크래시 없이 복구 가능한 오류 처리
+- 네트워크 장애 시 재시도/안내 메시지 제공
+
+## 9. 운영 정책
+- 욕설/비방 리뷰 신고 플로우(간단 신고 버튼)
+- 중복 리뷰 정책
+  - 식당당 사용자 1개 리뷰 원칙
+  - 작성 시 upsert(기존 리뷰 수정)
+- 좋아요 정책
+  - 식당당 사용자 1회
+  - 토글 허용
+
+## 10. 성공 지표(MVP)
+- DAU
+- 위치 권한 허용률
+- 리뷰 작성 전환율
+- 식당 상세 진입률
+- 재방문율(7일)
+
+## 11. 리스크와 대응
+- 위치 권한 거부율 높음
+  - 대안: 수동 지역 선택(구/동) 제공
+- 카테고리 오분류
+  - 대안: 사용자 제보/운영 보정
+- 초기 리뷰 부족
+  - 대안: 기본 외부 평점(가능 시) + 내부 리뷰 분리 표기
+
+## 12. 릴리즈 단위
+### v0.1 (MVP)
+- 위치 기반 목록/상세
+- 카테고리 필터
+- 리뷰/평점/좋아요
+
+### v0.2
+- 개인화 추천(최근 선택 기반)
+- 점심시간 알림
+- 회사/사무실 즐겨찾기