갈까? MVP

인스타 캡처나 직접 입력을 친구에게 보내기 좋은 “갈까 카드”로 바꾸는 모바일 웹 MVP입니다.

실행

npm start

기본 주소는 http://127.0.0.1:4173입니다. 포트를 바꾸려면 PORT 환경 변수를 지정하세요.

테스트

npm test

Supabase 전환

로컬에서는 data/db.json을 사용합니다. 서버 환경에 DATABASE_URL을 설정하면 Supabase/Postgres 저장소 어댑터를 사용합니다.

npm run db:migrate
npm start

이미지 업로드는 SUPABASE_URL과 SUPABASE_SERVICE_ROLE_KEY가 있으면 Supabase Storage bucket plan-covers를 사용하고, 없으면 로컬 uploads/ 폴더를 사용합니다.

문서

• App Store 카피
• 설계구현서 v0.3
• 팀 에이전트 구성서
• 전체회의 회의록 2026-05-07
• 다음 단계 회의록 2026-05-07
• External Test v0.1 런북
• Supabase 전환 가이드
• Render Deploy Runbook
• iOS App Shell
• Codemagic TestFlight 배포

구현 범위

• 캡처 이미지 업로드와 미리보기
• 직접 입력 기반 갈까 카드 생성
• 공개 링크(/c/:slug)와 방장 링크(/c/:slug/host) 발급
• 로그인 없는 친구 2초 반응
• 친구들 반응 집계와 추천 시간 표시
• 방장 링크 기반 수정, 마감, 확정, 삭제
• 확정 카드 화면(/c/:slug/confirmed)
• 카드별 Open Graph 메타데이터
• 로컬 JSON 저장소와 로컬 업로드 저장
• Capacitor 기반 iOS 앱 껍데기, 앱 아이콘, 스플래시

정식 서비스용 PostgreSQL/S3/OCR 연동은 API 경계가 잡힌 뒤 교체하는 전제로 둔 로컬 MVP입니다.

주요 화면

• / 홈
• /make 카드 만들기
• /made/:slug 공유 완료
• /c/:slug 친구 반응
• /c/:slug/result 친구들 반응
• /c/:slug/host?token=... 방장 관리
• /c/:slug/confirmed 확정 카드