🌟 스티커 친구

아이가 매일 루틴을 체크하면 부모(엄마/아빠)가 승인해 스티커를 주고, 30개를 모으면 장난감 쿠폰이 생기는 서비스. 전체 기획은 SPEC.md 참고.

로컬 실행

npm install
npm run dev

• http://localhost:3000/kid/demo — 데모 모드 (Supabase 없이 아이 화면/애니메이션 체험, 데모 도구 버튼 포함)
• http://localhost:3000/parent — 부모 로그인 (Supabase 연결 필요)

Supabase 연결 (실서비스)

1. Supabase에서 새 프로젝트 생성 (GitHub 로그인 가능)
2. SQL Editor에서 supabase/schema.sql 실행
3. Project Settings → API에서 값을 복사해 .env.example을 .env.local로 복사한 뒤 입력
   • NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY
   • SUPABASE_SERVICE_ROLE_KEY (service_role / secret 키, 서버 전용·절대 공개 금지)
4. npm run dev 후 http://localhost:3000/admin 에서 ADMIN / 1234 로 로그인 → 가족 추가로 엄마·아빠 아이디/비밀번호와 아이 이름 입력
   • 가족은 최대 5개, 가족당 아이는 최대 2명(부모가 설정 탭에서 추가), 부모는 엄마·아빠 2명 고정입니다.
   • 관리자 화면에서 가족 이름 변경, 부모 비밀번호 재설정, 가족 삭제를 할 수 있습니다.
   • 인터넷에 배포할 때는 ADMIN_PASSWORD로 ADMIN 비밀번호를 꼭 바꾸세요(기본값 1234는 누구나 압니다).
5. http://localhost:3000/parent 에서 만든 아이디/비밀번호로 로그인
6. 부모 화면 설정 → 아이 코드(QR 포함)를 아이 폰에서 열고 “홈 화면에 추가”

한도 규칙(가족 5개, 아이 2명)은 schema.sql의 트리거로 DB에서도 강제됩니다. 예전 스키마를 이미 실행했다면 schema.sql을 SQL Editor에서 다시 실행하세요(재실행 안전).

배포 (Vercel)

GitHub 저장소를 Vercel에 연결하고 환경변수(.env.example의 항목들, SUPABASE_SERVICE_ROLE_KEY와 ADMIN_PASSWORD 포함)를 등록하면 push마다 자동 배포됩니다.

구조

• src/components/kid/* — 아이 화면 (토글, 대기, 스티커판, 쿠폰, 축하 연출)
• src/components/parent/* — 부모 화면 (승인함, 루틴, 쿠폰, 설정)
• src/lib/kid-api.ts — 아이 링크용 API (실서비스 RPC + 데모 구현)
• supabase/schema.sql — 테이블, RLS, 승인/토글 RPC
• src/app/api/admin/route.ts — 관리자 API (가족 생성/삭제/비밀번호 재설정)
• src/components/admin/* — 관리자 화면(/admin)

보안 메모

• 아이 링크(토큰)로는 kid_view / kid_toggle / kid_pick_theme RPC만 호출됩니다. 테이블 직접 접근은 RLS로 막혀 있습니다.
• 스티커 발급은 로그인한 부모의 approve_submission RPC로만 가능합니다.