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 — 수정 시각