Relationship Analysis MVP (Next.js + Supabase)
This project is an MVP for a relationship analysis service based on personal data, survey responses, and astrological insights.
🚀 제품 개요
이 서비스는 다음 구조로 작동한다:
👉 개인 분석 → 유료 전환 → 친구 초대 → 관계 분석
🧠 핵심 개념
- report = 한 사람
- invites = 두 사람을 연결
❗ users 테이블 사용하지 않음
❗ relation 테이블 없음
👉 모든 흐름은 report + invites 기반
🚀 핵심 사용자 흐름 (한눈에 보기)
-
사용자 A → 생년월일시 입력
-
사용자 A → 설문(18문항) 완료
-
시스템 → 개인 리포트 생성
-
사용자 A → 유료 결제
-
유료 기능 활성화:
- 상세 개인 리포트
- 친구 초대 1회권
- 관계 분석 1회권
-
사용자 A → 초대 링크 생성
/invite?token=xxxx
-
사용자 B → 링크 접속
-
사용자 B → 생년월일 입력 + 설문 완료
-
시스템 → B 리포트 생성
-
시스템 → invites 자동 연결 (핵심)
- accepted_report_id 설정
- status = "complete"
-
시스템 → 관계 분석 생성
-
사용자 A / B 모두 결과 확인 가능
📊 주요 기능
1. 개인 리포트 생성
- 생년월일시 입력
- 설문 응답 (18문항)
- 사주 분석 (Manseryeok API)
- 별자리 분석 (무료 / 유료)
- 통합 해석
2. 리포트 공유
- URL 공유 (/report?id=...)
- QR 코드
3. 친구 초대
- 초대 링크 생성 (/invite?token=...)
- QR 코드
4. 관계 분석
- 친구 입력 완료 시 자동 연결
- 두 사람 데이터 기반 분석
- 결과 저장 및 공유
🗄️ DB 구조 (현재 실제 기준)
reports (사람)
- id
- name
- birth_date
- birth_time
- report_type
- plan_type (free / paid)
- payment_status
survey_responses
- report_id
- answers (JSON, 18문항)
invites (핵심 연결 구조)
- id
- from_report_id (User A)
- accepted_report_id (User B)
- invite_token
- status (open / complete)
- relationship_result
- created_at
report_results
- report_id
- analysis_result
saju 관련 테이블
👉 사주 데이터 저장 및 계산용
reference 테이블 (분석용 데이터)
- ref_earthly_branches
- ref_heavenly_stems
- ref_hidden_stems
- ref_ten_gods
- ref_ten_god_rules
- ref_relation_rules
- ref_twelve_stages
- ref_twelve_stage_rules
👉 사주 해석 로직에 사용
🔄 핵심 로직 정리
A 흐름
설문 완료
→ report 생성
→ invite 생성
→ invite_token 발급
B 흐름
링크 접속 (?token=xxx)
→ inviteToken 저장
설문 완료
→ report 생성
→ invites 업데이트 (핵심)
🔥 가장 중요한 로직
invites 업데이트:
WHERE invite_token = token
SET:
accepted_report_id = B.report_id
status = "complete"
🤖 분석 및 해석 구조 (LLM 포함)
1. 데이터 수집
- reports → 사용자 정보
- survey_responses → 성향 데이터
- saju_inputs / saju_charts → 사주 데이터
2. 분석 데이터 구성
- 개인 A 데이터
- 개인 B 데이터
- 설문 + 사주 + 별자리
3. 해석 생성 (LLM 역할)
LLM은 다음을 생성:
- 개인 성향 요약
- 사주 해석
- 별자리 해석
- 관계 분석
4. 결과 저장
- report_results
- invites.relationship_result
💡 핵심 개념
DB = 사실 데이터
LLM = 의미 해석
🎯 UI 상태 기준
inviteToken 없음
→ 일반 사용자
inviteToken 있음 + accepted_report_id 없음
→ 친구 초대 상태
accepted_report_id 있음
→ 결과 화면
📁 프로젝트 구조
app/
├── page.tsx
├── survey/page.tsx
├── invite/page.tsx
├── invite/InviteContent.tsx
├── report/page.tsx
🔑 상태 관리
localStorage:
⚠️ 개발 규칙 (매우 중요)
- DO NOT create new tables
- DO NOT rename tables
- DO NOT change database schema
- DO NOT introduce users table
- DO NOT introduce relation table
- DO NOT refactor unrelated code
👉 현재 구조 유지 + 로직만 수정
💥 현재 핵심 문제
- invites.accepted_report_id 업데이트 안 됨
- status = open 유지
👉 관계 연결 실패
🎯 현재 개발 목표
User B 설문 완료 시:
- invites 업데이트
- accepted_report_id 설정
- status = "complete"
🧪 실행 방법
npm run dev
http://localhost:3000
💡 제품 전략
👉 무료 → 유료 → 관계 분석 구조
🚀 향후 확장 (지금 구현 금지)
- 팀 분석 (N명 구조)
- user 테이블 분리
- 관계 그래프 구조
🧠 한 줄 핵심
👉 이 프로젝트는
“두 사람을 연결하는 흐름을 완성하는 것”
🔥 이제 상태
이 README 기준이면:
- Cursor 방향 안 틀림
- DB 구조 안 건드림
- 너도 흐름 안 헷갈림
