Doran ERD
테이블 (17)
Supabase Auth (시스템) (auth.users)
- id — uuid — 기본 키 — NOT NULL — Supabase auth.users PK (시스템 테이블)
- 이메일 (email) — text — 로그인 이메일 (Supabase 관리)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
관리자 (admins)
- id — uuid — 기본 키 — NOT NULL — PK
- auth 유저 ID (auth_user_id) — uuid — 외래 키 → Supabase Auth (시스템).id — NOT NULL — → auth.users. 관리자 로그인(일반 users 와 분리)
- 권한 역할 (role) — int2 — NOT NULL — 권한 역할. 값 미정
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
기기 (devices)
- id — uuid — 기본 키 — NOT NULL — PK
- 기기 UUID (device_uuid) — uuid — NOT NULL — Keychain 기기 UUID. UNIQUE
- 현재 유저 (current_user_id) — uuid — 외래 키 → 유저.id — → users. nullable UNIQUE (기기:유저 1:1)
- 제재 상태 (ban_status) — int2 — NOT NULL — 0=none 1=temp 2=perm (DeviceCheck 비트 캐시)
- 제재 만료 (ban_expires_at) — timestamptz — 임시 제재 만료(nullable)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
- 수정 시각 (updated_at) — timestamptz — NOT NULL — 수정 시각(트리거)
매너 점수 이력 (manner_events)
- id — uuid — 기본 키 — NOT NULL — PK
- 유저 (user_id) — uuid — 외래 키 → 유저.id — NOT NULL — → users. CASCADE
- 증감량 (delta) — int4 — NOT NULL — 매너 점수 증감(+/-)
- 사유 (reason) — text — 변동 사유
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
매칭 (matches)
- id — uuid — 기본 키 — NOT NULL — PK
- 발신 유저 (caller_id) — uuid — 외래 키 → 유저.id — NOT NULL — 건 쪽 → users. RESTRICT
- 수신 유저 (callee_id) — uuid — 외래 키 → 유저.id — NOT NULL — 받은 쪽 → users. RESTRICT. CHECK(≠)
- 상태 (status) — int2 — NOT NULL — 0=accepted 1=connected 2=completed 3=abandoned 4=failed
- 생성 시각 (created_at) — timestamptz — NOT NULL — 매칭 성사 시각
신고 (reports)
- id — uuid — 기본 키 — NOT NULL — PK
- 신고한 유저 (reporter_id) — uuid — 외래 키 → 유저.id — NOT NULL — 신고자 → users. RESTRICT
- 신고당한 유저 (target_id) — uuid — 외래 키 → 유저.id — NOT NULL — 대상 → users. RESTRICT. UNIQUE(reporter, target). CHECK(≠)
- 신고 맥락 매칭 (match_id) — uuid — 외래 키 → 매칭.id — → matches. nullable. SET NULL
- 신고 맥락 통화 (call_id) — uuid — 외래 키 → 통화.id — → calls. nullable. SET NULL
- 사유 (reason) — text — 신고 사유
- 생성 시각 (created_at) — timestamptz — NOT NULL — 신고 접수 시각
신고 조치 이력 (report_actions)
- id — uuid — 기본 키 — NOT NULL — PK
- 신고 (report_id) — uuid — 외래 키 → 신고.id — NOT NULL — → reports. CASCADE
- 관리자 (admin_id) — uuid — 외래 키 → 관리자.id — NOT NULL — 조치 관리자 → admins. RESTRICT
- 조치 (action) — int2 — NOT NULL — 0=banned 1=dismissed 2=deferred
- 연결된 제재 (ban_id) — uuid — 외래 키 → 제재.id — → bans. nullable. SET NULL
- 비고 (note) — text — 검토 메모
- 생성 시각 (created_at) — timestamptz — NOT NULL — 조치 시각
유저 (users)
- id — uuid — 기본 키 — NOT NULL — PK
- 표시 이름 (display_name) — text — 닉네임. 온보딩
- 생년월일 (birth_date) — date — 생년월일
- 성별 (gender) — int2 — 0=male 1=female
- 국가 (country) — text — 국가 코드(KR, JP)
- 프로필 이미지 URL (profile_image_url) — text — 프로필 이미지 URL
- 대표 음성 (default_audio_id) — uuid — 외래 키 → 음성 프로필.id — 대표 음성 → user_audios. SET NULL. 복합FK(본인 음성만)
- 관심 언어 (interested_languages) — text[] — NOT NULL — 관심 언어 BCP47 배열. default {}
- 매너 점수 (manner_score) — int4 — NOT NULL — 현재 매너 점수. default 0. 이력=manner_events
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
- 수정 시각 (updated_at) — timestamptz — NOT NULL — 수정 시각(트리거)
유저 인증 매핑 (user_identities)
- id — uuid — 기본 키 — NOT NULL — PK
- 유저 (user_id) — uuid — 외래 키 → 유저.id — NOT NULL — → users. RESTRICT
- auth 유저 ID (auth_user_id) — uuid — 외래 키 → Supabase Auth (시스템).id — NOT NULL — → auth.users. UNIQUE. CASCADE. 탈퇴 시 삭제
- 로그인 제공자 (provider) — int2 — NOT NULL — 0=apple 1=google
- 제공자 sub (provider_user_id) — text — NOT NULL — 제공자 sub. UNIQUE(provider, provider_user_id)
- 이메일 (email) — text — 제공자 이메일. PII(유일, 탈퇴 시 삭제)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
유저 차단 (user_blocks)
- id — uuid — 기본 키 — NOT NULL — PK
- 차단한 유저 (blocker_id) — uuid — 외래 키 → 유저.id — NOT NULL — 차단 건 유저 → users. CASCADE
- 차단당한 유저 (blocked_id) — uuid — 외래 키 → 유저.id — NOT NULL — 차단당한 유저 → users. UNIQUE(blocker, blocked). CHECK(≠)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
음성 프로필 (user_audios)
- id — uuid — 기본 키 — NOT NULL — PK. UNIQUE(id, user_id)
- 유저 (user_id) — uuid — 외래 키 → 유저.id — NOT NULL — → users. CASCADE
- 음성 URL (audio_url) — text — NOT NULL — 음성 파일 URL
- 언어 (language) — text — NOT NULL — 구사 언어 BCP47. 유저당 중복 허용
- 대사 번호 (script_id) — int2 — NOT NULL — 검증 대사 번호. UNIQUE(user_id, script_id)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
- 수정 시각 (updated_at) — timestamptz — NOT NULL — 수정 시각(트리거)
이의제기 (appeals)
- id — uuid — 기본 키 — NOT NULL — PK
- 대상 제재 (ban_id) — uuid — 외래 키 → 제재.id — NOT NULL — → bans. CASCADE
- 처리 관리자 (admin_id) — uuid — 외래 키 → 관리자.id — 처리 관리자 → admins. nullable. SET NULL
- 처리 상태 (status) — int2 — NOT NULL — 0=pending 1=accepted 2=rejected 3=withdrawn
- 이의 내용 (message) — text — 이의 사유
- 처리 시각 (resolved_at) — timestamptz — 처리 완료 시각(nullable)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 제출 시각
제재 (bans)
- id — uuid — 기본 키 — NOT NULL — PK
- 제재 대상 기기 (device_id) — uuid — 외래 키 → 기기.id — NOT NULL — 제재 대상 → devices (기기 앵커)
- 제재 당시 유저 (user_id) — uuid — 외래 키 → 유저.id — 제재 당시 유저 → users. nullable(이력)
- 제재한 관리자 (issued_by) — uuid — 외래 키 → 관리자.id — NOT NULL — 제재한 관리자 → admins. RESTRICT
- 제재 유형 (type) — int2 — NOT NULL — 0=temporary 1=permanent 2=content_deleted
- 사유 (reason) — text — 제재 사유
- 만료 시각 (expires_at) — timestamptz — 임시 만료(nullable, perm=NULL)
- 무효화 시각 (revoked_at) — timestamptz — 무효화 시각(nullable, appeal 인용 시)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 제재 발효 시각
통화 (calls)
- id — uuid — 기본 키 — NOT NULL — PK
- 매칭 (match_id) — uuid — 외래 키 → 매칭.id — NOT NULL — → matches. UNIQUE(1:1). CASCADE
- 외부 세션 ID (external_session_id) — text — 외부 RTC(Agora) 세션 ID
- 시작 시각 (started_at) — timestamptz — 통화 시작 시각
- 종료 시각 (ended_at) — timestamptz — 통화 종료 시각
- 통화 길이(초) (duration_sec) — int4 — 통화 길이(초)
통화 평가 (call_ratings)
- id — uuid — 기본 키 — NOT NULL — PK
- 통화 (call_id) — uuid — 외래 키 → 통화.id — NOT NULL — → calls. CASCADE
- 평가한 유저 (rater_id) — uuid — 외래 키 → 유저.id — NOT NULL — 평가한 유저 → users. CASCADE
- 평가받은 유저 (ratee_id) — uuid — 외래 키 → 유저.id — NOT NULL — 평가받은 유저 → users. CASCADE. CHECK(≠)
- 원점수 (score) — int2 — NOT NULL — 원점수. UNIQUE(call_id, rater_id)
- 생성 시각 (created_at) — timestamptz — NOT NULL — 평가 시각
티켓 거래 이력 (ticket_transactions)
- id — uuid — 기본 키 — NOT NULL — PK
- 유저 (user_id) — uuid — 외래 키 → 유저.id — NOT NULL — → users. CASCADE
- 증감량 (delta) — int4 — NOT NULL — 티켓 증감(+획득/-소진)
- 거래 유형 (type) — int2 — NOT NULL — 0=daily_grant 1=ad_reward 2=purchase 3=admin_grant 4=match_spend 5=refund
- 통화 (call_id) — uuid — 외래 키 → 통화.id — → calls. nullable. SET NULL
- 거래 후 잔액 (balance_after) — int4 — 거래 직후 잔액 스냅샷
- 비고 (note) — text — 비고
- 생성 시각 (created_at) — timestamptz — NOT NULL — 생성 시각
티켓 지갑 (user_wallets)
- 유저 (user_id) — uuid — 기본 키 — 외래 키 → 유저.id — NOT NULL — PK. → users 1:1. CASCADE
- 잔액 (balance) — int4 — NOT NULL — 현재 티켓 수. default 0. CHECK(>=0)
- 수정 시각 (updated_at) — timestamptz — NOT NULL — 수정 시각