---

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 기반

---

🚀 핵심 사용자 흐름 (한눈에 보기)

1. 사용자 A → 생년월일시 입력

2. 사용자 A → 설문(18문항) 완료

3. 시스템 → 개인 리포트 생성

   • 설문 해석
   • 사주 분석
   • 별자리 요약

4. 사용자 A → 유료 결제

5. 유료 기능 활성화:

   • 상세 개인 리포트
   • 친구 초대 1회권
   • 관계 분석 1회권

6. 사용자 A → 초대 링크 생성 /invite?token=xxxx

7. 사용자 B → 링크 접속

8. 사용자 B → 생년월일 입력 + 설문 완료

9. 시스템 → B 리포트 생성

10. 시스템 → invites 자동 연결 (핵심)

• accepted_report_id 설정
• status = "complete"

11. 시스템 → 관계 분석 생성

12. 사용자 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 관련 테이블

• saju_inputs
• saju_charts

👉 사주 데이터 저장 및 계산용

---

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:

• reportId
• inviteToken

---

⚠️ 개발 규칙 (매우 중요)

• 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 구조 안 건드림
• 너도 흐름 안 헷갈림

---