픽미톡 (PickmeTalk) — 감성 연애 채팅

도메인: pickmetalk.com

카카오톡 느낌의 감정·관계 성장형 AI 캐릭터 채팅 웹앱.

기술 스택

• Frontend: Next.js 15 (App Router), TypeScript, Tailwind CSS
• Backend: Next.js API Routes
• DB / Auth: Supabase
• AI: DeepSeek (deepseek-v4-flash)
• 배포: Vercel

로컬 실행

1. 의존성 설치

cd C:\Users\user\pickmetalk
npm install

2. 환경 변수

.env.example을 복사해 .env.local을 만든 뒤 값을 채웁니다.

변수	설명
NEXT_PUBLIC_SUPABASE_URL	Supabase 프로젝트 URL
NEXT_PUBLIC_SUPABASE_ANON_KEY	anon public key
DEEPSEEK_API_KEY	DeepSeek API 키 (서버 전용)
DEEPSEEK_BASE_URL	https://api.deepseek.com (기본값 사용 가능)
TAVILY_API_KEY	(선택) Tavily 웹 검색 API — 날씨·주식 등 사실 질문 시 사용
NEXT_PUBLIC_APP_URL	http://localhost:3000

API 키는 절대 NEXT_PUBLIC_ 접두사를 붙이지 마세요.

3. Supabase 설정

1. Supabase에서 프로젝트 생성
2. SQL Editor에서 supabase/schema.sql 실행
3. Authentication → Providers에서 Email 활성화
4. (소셜 로그인) Providers에서 Google / Kakao 활성화 — Client ID·Secret은 Dashboard에만 입력 (앱 .env에 넣지 않음). 상세: docs/AUTH_OAUTH.md
5. Authentication → URL Configuration에서 아래를 설정:
   • Site URL: https://pickmetalk.com (로컬만 쓸 때는 http://localhost:3000)
   • Redirect URLs: http://localhost:3000/**, https://pickmetalk.com/** (OAuth 콜백 /api/auth/callback 포함)
   • 또는 npx supabase config push로 supabase/config.toml 반영
6. (선택) 이메일 확인 없이 바로 로그인하려면: Authentication → Settings에서 Confirm email 비활성화

4. 개발 서버

npm run dev

브라우저에서 http://localhost:3000

5. 프로덕션 빌드 확인

npm run build
npm start

사용 흐름 (MVP)

1. 시작하기 → /login 이메일 또는 Google/카카오 회원가입/로그인
2. /characters — 유나·나린·윤서·은하·지유 중 선택
3. /chat — 메시지 전송 → DeepSeek 스트리밍 응답
4. 새로고침해도 Supabase messages에서 최근 30개 대화 복원
5. PC·모바일 동기화 — 동일 이메일 로그인 시 /conversations에서 같은 히스토리 (Realtime + 탭 복귀 시 sync)
6. 메시지 1회 왕복마다 호감도 +1, 관계 레벨 자동 갱신

PC ↔ 모바일 대화 이어하기

1. PC·폰 모두 pickmetalk.com + 같은 계정 로그인
2. PC에서 채팅 → Supabase messages 저장
3. 폰 /conversations → 같은 대화방 → 히스토리 자동 복원 (Realtime 또는 앱 재진입)
4. iOS: Safari 공유 → 홈 화면에 추가 / Android: PWA 설치 배너

검증 스크립트 (.env.local + 테스트 계정 필요):

npm run verify:sync
# 또는 프로덕션 대상
npm run verify:sync -- https://pickmetalk.com

Supabase SQL Editor에서 Realtime 활성화 (1회):

-- supabase/migrations/012_messages_realtime.sql 실행

주요 경로

경로	설명
/login	이메일 로그인·회원가입
/characters	캐릭터 선택
/chat	채팅 (활성 캐릭터)
POST /api/chat	DeepSeek 스트리밍
GET /api/messages	최근 메시지 30개
POST /api/characters/select	캐릭터 선택 저장

호감도 · 관계 레벨

호감도	레벨
0~20	Lv1
21~40	Lv2
41~70	Lv3
71~90	Lv4
91~100	Lv5

감정 (MVP 규칙)

• 일반 대화: happy
• 칭찬·사랑 표현: excited
• 3시간+ 대화 공백 후 복귀: hurt (서운함)
• 키워드: 질투, 보고싶음 등 (services/emotion.ts)

아직 미구현 (의도적 제외)

• 결제·구독
• 선물·포옹모드
• 3일 미접속 이벤트

Vercel 배포

1. GitHub 푸시
2. Vercel Import → Environment Variables에 .env.local과 동일 항목 등록 (DEEPSEEK_API_KEY 포함)
3. Deploy

Cursor Cloud에서 이어서 작업

1. Cloud Agents 대시보드에서 GitHub 저장소 kimeunsun109-debug/pickmetalk 연결
2. Secrets에 .env.example 항목 등록 (DEEPSEEK_API_KEY, Supabase URL/anon key 등)
3. 저장소의 .cursor/environment.json이 npm install + openpyxl 설치를 자동 실행
4. 상세 가이드는 루트 AGENTS.md 참고

라이선스

Private MVP — 상용 전 법적·플랫폼 정책 검토 권장.