Third_Place

Tables (29)

account_deletion_jobs (회원 탈퇴 익명화 기록 테이블)

  • id — identity.ulid — Primary key — NOT NULL — 계정 삭제·익명화 작업 고유 ULID
  • withdrawal_request_id — identity.ulid — Foreign key → withdrawal_requests.id — NOT NULL — 작업을 생성한 회원탈퇴 요청 ID
  • user_id — identity.ulid — Foreign key → users.id — NOT NULL — 삭제·익명화 대상 사용자 ID
  • status — VARCHAR(20) — NOT NULL — 작업 상태: SCHEDULED, RUNNING, COMPLETED, FAILED, CANCELLED
  • scheduled_at — TIMESTAMPTZ — NOT NULL — 작업 실행 예정 시각
  • started_at — TIMESTAMPTZ — 작업 실행을 시작한 시각
  • completed_at — TIMESTAMPTZ — 모든 필수 도메인 작업이 완료된 시각
  • attempt_count — INTEGER — NOT NULL — 작업 실행을 시도한 누적 횟수
  • next_retry_at — TIMESTAMPTZ — 실패한 작업의 다음 재시도 예정 시각
  • last_error_code — VARCHAR(50) — 가장 최근 작업 실패의 내부 오류 코드
  • domain_results — JSONB — NOT NULL — 도메인별 삭제·보존·익명화 처리 결과 JSON
  • created_at — TIMESTAMPTZ — NOT NULL — 삭제·익명화 작업 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 삭제·익명화 작업 최종 변경 시각

account_link_requests (계정 통합 요청 테이블)

  • id (계정 통합 요청 고유 ID. PK) — identity.ulid — Primary key — NOT NULL — 계정 통합 요청 고유 ULID
  • target_user_id (새로운 로그인 수단을 연결할 기존 사용자 ID) — identity.ulid — Foreign key → users.id — NOT NULL — 새 로그인 수단을 연결할 기존 사용자 ID
  • link_type (LOCAL 연결인지 소셜 연결인지 구분) — VARCHAR(20) — NOT NULL — 연결 유형: LINK_LOCAL_IDENTITY 또는 LINK_SOCIAL_IDENTITY
  • incoming_provider (새로 연결하려는 인증 제공자) — VARCHAR(20) — NOT NULL — 새로 연결하려는 인증 제공자
  • incoming_provider_user_id_hash (새 소셜 Provider 사용자 ID의 해시) — CHAR(64) — 새 소셜 로그인 수단의 제공자 사용자 식별자 해시. LOCAL 연결이면 NULL
  • verified_email_hash (새 로그인 수단에서 소유 확인된 이메일의 해시) — CHAR(64) — NOT NULL — 새 로그인 수단에서 소유 확인된 이메일의 HMAC 해시
  • status (통합 요청의 현재 상태) — VARCHAR(20) — NOT NULL — 통합 요청 상태: PENDING, COMPLETED, EXPIRED, CONFLICTED
  • verification_reference_id (앞에서 완료된 이메일·소셜 인증 컨텍스트 ID) — identity.ulid — NOT NULL — 이메일 또는 소셜 인증 컨텍스트를 가리키는 내부 참조 ID
  • expires_at (계정 통합 요청과 Link Token의 만료 시각) — TIMESTAMPTZ — NOT NULL — 계정 통합 요청과 Link Token의 유효기간 종료 시각
  • completed_at (실제 로그인 수단 연결 완료 시각) — TIMESTAMPTZ — 새 로그인 수단 연결이 완료된 시각
  • consumed_at (Link Token과 인증 컨텍스트 소비 시각) — TIMESTAMPTZ — Link Token과 검증 컨텍스트가 원자적으로 소비된 시각
  • created_identity_id (통합 과정에서 생성한 auth_identities.id) — identity.ulid — Foreign key → auth_identities.id — 통합 완료로 생성·연결된 인증 Identity ID
  • created_at — TIMESTAMPTZ — NOT NULL — 계정 통합 요청 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 계정 통합 요청 최종 변경 시각

allowed_terms

  • id — BIGINT — Primary key — NOT NULL — 허용어 자동 증가 식별자
  • value — VARCHAR(100) — NOT NULL — 비속어 탐지보다 우선 적용할 허용 문자열
  • enabled — BOOLEAN — NOT NULL — 현재 허용어 사전에서 활성화된 항목인지 여부
  • description — VARCHAR(255) — 운영자가 기록하는 허용 근거와 사용 문맥
  • created_at — TIMESTAMPTZ — NOT NULL — 허용어 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 허용어 최종 변경 시각

auth_identities (사용자의 로그인 방식)

  • id — identity.ulid — Primary key — NOT NULL — 로그인 수단 고유 ULID
  • user_id — identity.ulid — Foreign key → users.id — NOT NULL — 로그인 수단이 연결된 사용자 ID
  • provider (로그인 제공자 (LOCAL, KAKAO 등)) — VARCHAR(20) — NOT NULL — 인증 제공자: LOCAL, KAKAO, NAVER, GOOGLE, APPLE
  • provider_user_id_ciphertext (Provider 사용자 ID를 암호화한 값) — BYTEA — NOT NULL — 제공자가 발급한 사용자 식별자를 암호화한 값. 제공자 연동 작업에 사용
  • provider_user_id_hash (Provider 사용자 ID의 HMAC 해시) — CHAR(64) — NOT NULL — 제공자 사용자 식별자의 HMAC-SHA-256 해시. 로그인 조회와 중복 연결 방지에 사용
  • status (로그인 수단 상태) — VARCHAR(20) — NOT NULL — 로그인 수단 상태: ACTIVE, UNLINKED, WITHDRAWN
  • provider_email_ciphertext (Provider가 전달한 이메일 암호문) — BYTEA — 소셜 제공자가 전달한 이메일의 암호문
  • provider_email_hash (Provider 이메일의 HMAC 해시) — CHAR(64) — 소셜 제공자 이메일의 HMAC-SHA-256 해시
  • provider_email_verified (Provider가 이메일 소유 확인을 보장했는지 여부) — BOOLEAN — 소셜 제공자가 이메일 소유 확인 완료로 응답했는지 여부
  • linked_at (로그인 수단 연결 시각) — TIMESTAMPTZ — NOT NULL — 로그인 수단이 사용자 계정에 연결된 시각
  • last_authenticated_at (해당 로그인 수단의 마지막 로그인 성공 시각) — TIMESTAMPTZ — 해당 로그인 수단으로 마지막 인증에 성공한 시각
  • unlinked_at (로그인 수단 연결 해제 시각) — TIMESTAMPTZ — 로그인 수단 연결이 해제된 시각
  • created_at — TIMESTAMPTZ — NOT NULL — 로그인 수단 레코드 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 로그인 수단 레코드 최종 변경 시각

auth_sessions (로그인 장기세션 Refresh Token 계보 관리)

  • id (로그인 세션 아이디) — identity.ulid — Primary key — NOT NULL — 인증 세션 고유 ULID. Access Token의 세션 식별자와 연결
  • user_id (로그인한 사용자 아이디) — identity.ulid — Foreign key → users.id — NOT NULL — 세션 소유 사용자 ID
  • token_family_id (Refresh Token Rotaion 계보를 구분하는 ID) — identity.ulid — NOT NULL — Refresh Token Rotation 계보를 식별하는 Token Family ULID
  • device_name (기기 브라우저 이름) — VARCHAR(150) — 사용자가 세션을 구분할 수 있는 기기 또는 브라우저 표시 이름
  • platform (접속 플랫폼 (WEB, IOS, ANDROID)) — VARCHAR(20) — NOT NULL — 세션 플랫폼: WEB, IOS, ANDROID
  • user_agent_hash (로그인 당시 브라우저/앱 환경 해시) — CHAR(64) — 세션 생성 User-Agent의 비식별 해시
  • ip_prefix_hash (로그인 당시 IP 대역의 해시) — CHAR(64) — 세션 생성 IP Prefix의 비식별 해시
  • status (세션 상태 ( ACTIVE, REVOKED, EXPIRED, COMPROMISED)) — VARCHAR(20) — NOT NULL — 세션 상태: ACTIVE, REVOKED, EXPIRED, COMPROMISED
  • refresh_expires_at (리프레쉬 토큰 만료시각) — TIMESTAMPTZ — NOT NULL — 현재 Refresh Session이 만료되는 시각
  • last_rotated_at (마지막 갱신 시각) — TIMESTAMPTZ — NOT NULL — Refresh Token이 마지막으로 Rotation된 시각
  • last_seen_at (해당 세션에서 마지막 정상 활동이 확인된 시각 (병목 방지 3분단위)) — TIMESTAMPTZ — NOT NULL — 해당 세션으로 마지막 인증 요청이 확인된 시각
  • revoked_at (세션 폐기 시각) — TIMESTAMPTZ — 세션 또는 Token Family가 폐기된 시각
  • revoke_reason (폐기 이유 (USER_LOGOUT, PASSWORD_CHANGED 등)) — VARCHAR(50) — 세션 폐기 원인을 나타내는 내부 코드
  • created_at (세션 생성 시각) — TIMESTAMPTZ — NOT NULL — 인증 세션 생성 시각
  • updated_at (세션 변경 시각) — TIMESTAMPTZ — NOT NULL — 인증 세션 최종 변경 시각

email_verification_requests (이메일 인증 요청 테이블)

  • id — identity.ulid — Primary key — NOT NULL — 클라이언트에 verificationId로 전달하는 이메일 인증 요청 ULID
  • purpose (인증 목적. SIGNUP 또는 PASSWORD_RESET) — VARCHAR(30) — NOT NULL — 이메일 인증 목적: SIGNUP 또는 PASSWORD_RESET
  • email_hash (정규화된 이메일의 HMAC-SHA-256 해시) — CHAR(64) — NOT NULL — 인증 대상 정규화 이메일의 HMAC-SHA-256 해시
  • email_masked (화면에 표시할 마스킹 이메일. 예: yu***@example.com) — VARCHAR(320) — NOT NULL — 응답 화면에 표시할 마스킹 이메일 주소
  • requester_fingerprint_hash (IP·디바이스 등으로 만든 요청자 식별값의 해시) — CHAR(64) — NOT NULL — IP·device 등으로 구성한 요청자 지문의 비식별 해시. 요청자 단위 발송 제한에 사용
  • ip_prefix_hash (요청 IP 대역을 해시) — CHAR(64) — 발송 요청 IP Prefix의 비식별 해시
  • status (인증 요청의 현재 상태) — VARCHAR(20) — NOT NULL — 인증 요청 상태: PENDING, VERIFIED, SUPERSEDED, EXPIRED, CONSUMED, BLOCKED
  • send_count (이 요청을 발급한 시점의 해당 이메일·목적 버킷 누적 발송 횟수) — SMALLINT — NOT NULL — 해당 요청 발급 시점의 이메일·목적 버킷 누적 발송 횟수
  • failed_attempts (틀린 인증번호를 입력한 횟수) — SMALLINT — NOT NULL — 인증번호 불일치 누적 횟수
  • expires_at (인증번호 검증 가능 기간 종료 시각) — TIMESTAMPTZ — NOT NULL — 인증번호 검증 가능 기간이 종료되는 시각
  • verified_at (올바른 인증번호를 입력하여 인증에 성공한 시각) — TIMESTAMPTZ — 올바른 인증번호 검증에 성공한 시각
  • superseded_at (재전송으로 인해 이 요청이 이전 요청으로 폐기된 시각) — TIMESTAMPTZ — 재전송으로 더 이상 사용할 수 없는 요청이 된 시각
  • consumed_at (회원가입이나 비밀번호 재설정에서 인증 결과를 최종 사용한 시각) — TIMESTAMPTZ — 계정 생성 또는 비밀번호 재설정 흐름에서 인증 컨텍스트가 최종 소비된 시각
  • blocked_until (발송 또는 검증 제한이 해제되는 시각) — TIMESTAMPTZ — 발송 또는 검증 제한이 적용된 경우 제한 종료 시각
  • created_at — TIMESTAMPTZ — NOT NULL — 이메일 인증 요청 생성 및 발송 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 이메일 인증 요청 상태 최종 변경 시각

genres (장르)

  • code (장르 코드) — VARCHAR(50) — Primary key — NOT NULL — 장르를 식별하는 고유 코드
  • name (장르 이름) — VARCHAR(100) — NOT NULL — 사용자 화면에 표시할 장르 이름
  • active (활성화 여부) — BOOLEAN — NOT NULL — 현재 온보딩에서 선택 가능한 장르인지 여부
  • display_order (노출 순서) — INTEGER — NOT NULL — 장르 목록의 화면 표시 순서
  • created_at (생성시각) — TIMESTAMPTZ — NOT NULL — 장르 생성 시각
  • updated_at (최종 변경시각) — TIMESTAMPTZ — NOT NULL — 장르 최종 변경 시각

idempotency_records

  • id — identity.ulid — Primary key — NOT NULL — 멱등 처리 레코드 고유 ULID
  • scope — VARCHAR(100) — NOT NULL — 멱등키 충돌 범위를 구분하는 API 작업·인증 주체 Scope
  • idempotency_key — UUID — NOT NULL — 클라이언트가 전달한 UUID 형식 Idempotency-Key
  • request_hash — CHAR(64) — NOT NULL — 동일 키에 다른 요청 Body가 사용됐는지 확인하는 정규화 요청 해시
  • user_id — identity.ulid — Foreign key → users.id — 인증된 요청 사용자 ID. 계정 생성 전 요청은 NULL 가능
  • status — VARCHAR(20) — NOT NULL — 멱등 작업 상태: PROCESSING, SUCCEEDED, FAILED
  • resource_type — VARCHAR(100) — 성공 결과로 생성·변경된 리소스 종류
  • resource_id — VARCHAR(100) — 성공 결과 리소스 식별자. 토큰 원문이나 전체 응답은 저장하지 않음
  • http_status — SMALLINT — 최초 처리 결과의 HTTP 상태 코드
  • error_code — VARCHAR(100) — 최초 실패 결과의 공개 API 오류 코드
  • locked_until — TIMESTAMPTZ — PROCESSING 작업 소유권 만료 시각. 장애 후 안전한 재처리에 사용
  • expires_at — TIMESTAMPTZ — NOT NULL — 멱등 처리 결과 보존 및 재사용 가능 기간 종료 시각
  • created_at — TIMESTAMPTZ — NOT NULL — 멱등 처리 레코드 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 멱등 처리 레코드 최종 변경 시각

image_uploads (PresignedURL 발급, 업로드 검증, 이미지 연결 관리)

  • id (PK) — identity.ulid — Primary key — NOT NULL — 프로필 이미지 업로드 요청 고유 ULID
  • user_id (업로드 요청 사용자) — identity.ulid — Foreign key → users.id — NOT NULL — 업로드를 요청한 사용자 ID
  • object_key (서버가 생성한 S3 Object Key) — VARCHAR(512) — NOT NULL — 서버가 발급한 사용자 전용 S3 객체 키
  • original_file_name (원본 파일명) — VARCHAR(255) — NOT NULL — 클라이언트가 전달한 원본 파일 이름. 표시·감사용이며 객체 키로 사용하지 않음
  • content_type (요청 당시 MIME 타입) — VARCHAR(100) — NOT NULL — 업로드 요청 시 검증한 MIME Content-Type
  • expected_size_bytes (클라이언트가 전달한 예상 파일 크기) — BIGINT — NOT NULL — 클라이언트가 사전에 전달한 예상 파일 크기
  • actual_size_bytes (S3 업로드 후 확인한 실제 크기) — BIGINT — S3 업로드 후 서버가 확인한 실제 파일 크기
  • expected_checksum_sha256 (예상 파일 SHA-256 체크섬) — CHAR(64) — 클라이언트가 선택적으로 전달한 예상 파일 SHA-256 체크섬
  • actual_checksum_sha256 (실제 업로드 파일 SHA-256 체크섬) — CHAR(64) — 업로드 완료 후 서버가 확인한 실제 파일 SHA-256 체크섬
  • status (업로드 처리 상태) — VARCHAR(20) — NOT NULL — 업로드 처리 상태: ISSUED, UPLOADED, VERIFIED, ATTACHED, EXPIRED, REJECTED
  • expires_at (PresingedURL 만료시간) — TIMESTAMPTZ — NOT NULL — Presigned 업로드 권한 만료 시각
  • uploaded_at (S3 업로드 확인 시각) — TIMESTAMPTZ — S3 객체 업로드가 감지된 시각
  • verified_at (MIME/크기/체크섬 검증 완료 시각) — TIMESTAMPTZ — MIME·크기·체크섬 등 서버 검증이 완료된 시각
  • attached_at (사용자 프로필에 연결된 시각) — TIMESTAMPTZ — 업로드 객체가 사용자 프로필에 최종 연결된 시각
  • failure_code (거절 실패 사유 코드) — VARCHAR(50) — 업로드 검증 또는 연결 실패의 내부 오류 코드
  • created_at (업로드 요청 생성 시각) — TIMESTAMPTZ — NOT NULL — 업로드 요청 생성 시각
  • updated_at (상태 최종 변경 시각) — TIMESTAMPTZ — NOT NULL — 업로드 요청 상태 최종 변경 시각
  • purpose (이미지의 목적 (PROFILE)) — VARCHAR(50)

local_credentials (로컬계정 자격증명)

  • identity_id — identity.ulid — Foreign key → auth_identities.id — NOT NULL — LOCAL 인증 Identity ID
  • password_hash (비밀번호 단방향 해시한 값) — VARCHAR(255) — NOT NULL — Argon2id 또는 bcrypt로 단방향 해시한 비밀번호. 평문 저장 금지
  • password_algorithm (해시 알고리즘 ARGON2ID 또는 BCRYPT) — VARCHAR(30) — NOT NULL — 비밀번호 해시에 사용한 알고리즘
  • password_parameter_version (해시 알고리즘의 세부 설정 버전) — SMALLINT — NOT NULL — 해시 비용·메모리 등 파라미터 정책 버전
  • password_changed_at (비밀번호를 마지막으로 변경한 시각) — TIMESTAMPTZ — NOT NULL — 비밀번호가 마지막으로 변경된 시각
  • must_change_password (다음 로그인 후 비밀번호를 강제로 변경시킬지 여부) — BOOLEAN — NOT NULL — 다음 인증 후 강제 비밀번호 변경이 필요한지 여부
  • credential_version (비밀번호가 변경될 때 증가하는 버전) — BIGINT — NOT NULL — 비밀번호 변경 시 증가하는 자격 증명 버전. 기존 토큰 무효화 판단에 사용
  • created_at — TIMESTAMPTZ — NOT NULL — 로컬 자격 증명 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 로컬 자격 증명 최종 변경 시각

local_password_history (이전 비밀번호 사용을 막는 기록 테이블)

  • id — BIGINT — Primary key — NOT NULL — 비밀번호 이력 자동 증가 식별자
  • identity_id (어느 LOCAL 로그인 수단의 이력인지 나타내는 FK) — identity.ulid — Foreign key → local_credentials.identity_id — NOT NULL — 비밀번호 이력의 LOCAL Identity ID
  • password_hash (교체된 과거 비밀번호의 단방향 해시값) — VARCHAR(255) — NOT NULL — 교체되어 더 이상 현재 값이 아닌 과거 비밀번호 해시
  • password_algorithm (해당 과거 비밀번호에 사용한 알고리즘.) — VARCHAR(30) — NOT NULL — 과거 비밀번호 해시에 사용한 알고리즘
  • password_parameter_version (해시 정책 버전) — SMALLINT — NOT NULL — 과거 비밀번호 해시 파라미터 정책 버전
  • replaced_at (해당 비밀번호가 새 비밀번호로 교체된 시각) — TIMESTAMPTZ — NOT NULL — 해당 비밀번호가 새 비밀번호로 교체된 시각

outbox_events

  • id — identity.ulid — Primary key — NOT NULL — Outbox 이벤트 고유 ULID
  • aggregate_type — VARCHAR(100) — NOT NULL — 이벤트를 발생시킨 집계 종류
  • aggregate_id — VARCHAR(100) — NOT NULL — 이벤트를 발생시킨 집계 식별자
  • event_type — VARCHAR(150) — NOT NULL — 구독자가 처리할 도메인 이벤트 유형
  • payload — JSONB — NOT NULL — 민감정보를 최소화한 도메인 이벤트 Payload JSON
  • headers — JSONB — NOT NULL — 추적 ID, 스키마 버전 등 이벤트 전송 헤더 JSON
  • status — VARCHAR(20) — NOT NULL — 발행 상태: PENDING, PUBLISHED, FAILED, DEAD
  • available_at — TIMESTAMPTZ — NOT NULL — 이벤트가 최초 발행 또는 재발행 가능한 시각
  • published_at — TIMESTAMPTZ — 메시지 브로커 발행이 성공한 시각
  • attempt_count — INTEGER — NOT NULL — 메시지 발행 누적 시도 횟수
  • next_retry_at — TIMESTAMPTZ — 발행 실패 후 다음 재시도 예정 시각
  • last_error — VARCHAR(1000) — 가장 최근 발행 실패의 민감정보 제거 오류 요약
  • created_at — TIMESTAMPTZ — NOT NULL — Outbox 이벤트 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — Outbox 이벤트 상태 최종 변경 시각

password_reset_requests (비밀번호 재발급 요청 테이블)

  • id — identity.ulid — Primary key — NOT NULL — 비밀번호 재설정 요청 고유 ULID
  • user_id (비밀번호를 변경할 사용자 ID) — identity.ulid — Foreign key → users.id — NOT NULL — 비밀번호를 재설정할 사용자 ID
  • local_identity_id (변경 대상 LOCAL 로그인 수단 ID) — identity.ulid — Foreign key → local_credentials.identity_id — NOT NULL — 재설정 대상 사용자가 소유한 LOCAL Identity ID
  • verification_method (사용자를 확인한 방법. 현재는 EMAIL만 허용) — VARCHAR(20) — NOT NULL — 재설정 본인 확인 방식. 현재 활성 DDL은 EMAIL만 허용
  • email_verification_id (재설정 권한의 근거가 된 이메일 인증 요청 ID) — identity.ulid — Foreign key → email_verification_requests.id — 재설정 권한 발급 근거가 된 이메일 인증 요청 ID
  • status (재설정 요청의 현재 상태) — VARCHAR(20) — NOT NULL — 재설정 요청 상태: VERIFIED, COMPLETED, EXPIRED, REVOKED
  • expires_at (재설정 권한과 Reset Token의 만료 시각) — TIMESTAMPTZ — NOT NULL — 비밀번호 재설정 권한 만료 시각
  • consumed_at (이 요청으로 새 비밀번호를 저장하여 권한이 소비된 시각) — TIMESTAMPTZ — 새 비밀번호 저장과 함께 재설정 권한이 소비된 시각
  • created_at (재설정 요청 생성 시각) — TIMESTAMPTZ — NOT NULL — 비밀번호 재설정 요청 생성 시각
  • updated_at (상태가 마지막으로 변경된 시각) — TIMESTAMPTZ — NOT NULL — 비밀번호 재설정 요청 최종 변경 시각

permissions

  • code — VARCHAR(100) — Primary key — NOT NULL — 권한을 식별하는 고유 코드
  • description — VARCHAR(255) — NOT NULL — 권한이 허용하는 작업 설명
  • created_at — TIMESTAMPTZ — NOT NULL — 권한 생성 시각

prohibited_term_variants

  • id — BIGINT — Primary key — NOT NULL — 금칙어 변형 자동 증가 식별자
  • term_id — BIGINT — Foreign key → prohibited_terms.id — NOT NULL — 변형어가 속한 기본 금칙어 ID
  • value — VARCHAR(100) — NOT NULL — 탐지할 변형 표기 또는 우회 문자열
  • enabled — BOOLEAN — NOT NULL — 현재 탐지에 사용하는 변형어인지 여부
  • description — VARCHAR(255) — 변형 규칙과 등록 사유 설명
  • created_at — TIMESTAMPTZ — NOT NULL — 금칙어 변형 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 금칙어 변형 최종 변경 시각

prohibited_terms

  • id — BIGINT — Primary key — NOT NULL — 금칙어 자동 증가 식별자
  • value — VARCHAR(100) — NOT NULL — 정규화 전 기본 금칙어 문자열
  • category — VARCHAR(30) — NOT NULL — 금칙어 분류 코드. 기본값은 PROFANITY
  • severity — SMALLINT — NOT NULL — 금칙어 위험도. 1은 낮음, 5는 가장 높음
  • match_type — VARCHAR(20) — NOT NULL — 탐지 방식: CONTAINS, EDGE, EXACT
  • fuzzy_enabled — BOOLEAN — NOT NULL — 문자 치환·유사 문자열 등 Fuzzy 탐지를 적용할지 여부
  • enabled — BOOLEAN — NOT NULL — 현재 탐지 사전에서 활성화된 금칙어인지 여부
  • description — VARCHAR(255) — 운영자가 기록하는 금칙어 의미와 등록 사유
  • created_at — TIMESTAMPTZ — NOT NULL — 금칙어 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 금칙어 최종 변경 시각

role_permissions

  • role_code — VARCHAR(50) — Foreign key → roles.code — NOT NULL — 권한이 연결된 역할 코드
  • permission_code — VARCHAR(100) — Foreign key → permissions.code — NOT NULL — 역할에 부여된 권한 코드
  • created_at — TIMESTAMPTZ — NOT NULL — 역할과 권한 연결 생성 시각

roles

  • code — VARCHAR(50) — Primary key — NOT NULL — 역할을 식별하는 고유 코드
  • name — VARCHAR(100) — NOT NULL — 관리 화면에 표시할 역할 이름
  • description — VARCHAR(255) — 역할의 목적과 적용 범위 설명
  • system_role — BOOLEAN — NOT NULL — 애플리케이션 기본 제공 역할로 임의 삭제를 제한해야 하는지 여부
  • created_at — TIMESTAMPTZ — NOT NULL — 역할 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 역할 최종 변경 시각

social_identity_profiles (소셜에서 받아온 정보 저장 테이블)

  • identity_id — identity.ulid — Foreign key → auth_identities.id — NOT NULL — 소셜 프로필이 속한 인증 Identity ID
  • name_ciphertext — BYTEA — 소셜 제공자가 전달한 이름의 암호문
  • phone_ciphertext — BYTEA — 소셜 제공자가 전달한 전화번호의 암호문
  • phone_hash — CHAR(64) — 정규화 전화번호의 HMAC-SHA-256 해시
  • phone_verified — BOOLEAN — 소셜 제공자가 전화번호 인증 완료로 응답했는지 여부
  • birth_date_ciphertext — BYTEA — 소셜 제공자가 전달한 생년월일의 암호문
  • birth_date_precision — VARCHAR(20) — 수집된 생년월일 정밀도: FULL_DATE, YEAR_MONTH, YEAR_ONLY
  • gender — VARCHAR(20) — 소셜 제공자가 전달한 성별 정보
  • profile_image_url — VARCHAR(2048) — 소셜 제공자가 전달한 원본 프로필 이미지 URL
  • locale — VARCHAR(35) — 소셜 제공자가 전달한 언어 및 지역 코드
  • granted_scopes — TEXT — NOT NULL — 사용자가 소셜 OAuth에서 승인한 권한 Scope 목록
  • pii_key_version — SMALLINT — 소셜 개인정보 암호화에 사용한 키 버전
  • collected_at — TIMESTAMPTZ — NOT NULL — 소셜 개인정보를 최초 수집한 시각
  • last_synced_at — TIMESTAMPTZ — NOT NULL — 소셜 제공자 정보와 마지막으로 동기화한 시각
  • created_at — TIMESTAMPTZ — NOT NULL — 소셜 프로필 레코드 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 소셜 프로필 레코드 최종 변경 시각

term_versions

  • id — identity.ulid — Primary key — NOT NULL — 약관 버전 고유 ULID
  • term_id — identity.ulid — Foreign key → terms.id — NOT NULL — 버전이 속한 약관 항목 ID
  • version — VARCHAR(30) — NOT NULL — 클라이언트 동의 요청과 이력에 사용하는 약관 버전 문자열
  • content_url — VARCHAR(2048) — NOT NULL — 사용자가 약관 원문을 조회할 수 있는 URL
  • content_sha256 — CHAR(64) — NOT NULL — 게시 약관 원문의 SHA-256 해시. 원문 변조 및 버전 무결성 확인에 사용
  • effective_at — TIMESTAMPTZ — NOT NULL — 약관 버전의 효력이 시작되는 시각
  • expires_at — TIMESTAMPTZ — 약관 버전의 효력이 종료되는 시각. 종료되지 않았으면 NULL
  • published_at — TIMESTAMPTZ — 검토를 마치고 사용자에게 게시된 시각. 미게시 초안이면 NULL
  • created_at — TIMESTAMPTZ — NOT NULL — 약관 버전 생성 시각

terms

  • id — identity.ulid — Primary key — NOT NULL — 약관 항목 고유 ULID
  • code — VARCHAR(50) — NOT NULL — API의 termId로 사용하는 변경되지 않는 약관 코드
  • title — VARCHAR(200) — NOT NULL — 사용자 화면에 표시할 약관 제목
  • context — VARCHAR(30) — NOT NULL — 약관 노출 및 동의 문맥: SIGNUP, SERVICE, MARKETING, PRIVACY
  • required — BOOLEAN — NOT NULL — 해당 약관이 필수 동의 항목인지 여부
  • active — BOOLEAN — NOT NULL — 신규 조회 및 동의 대상으로 사용할 수 있는지 여부
  • display_order — INTEGER — NOT NULL — 동일 문맥 내 화면 표시 순서
  • created_at — TIMESTAMPTZ — NOT NULL — 약관 항목 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 약관 항목 최종 변경 시각

user_consents

  • id — identity.ulid — Primary key — NOT NULL — 약관 동의 이력 고유 ULID
  • user_id — identity.ulid — Foreign key → users.id — NOT NULL — 동의 또는 거절 의사를 표시한 사용자 ID
  • term_version_id — identity.ulid — Foreign key → term_versions.id — NOT NULL — 사용자가 확인한 정확한 약관 버전 ID
  • agreed — BOOLEAN — NOT NULL — 동의 여부. 선택 약관 거절도 FALSE로 기록 가능
  • consent_source — VARCHAR(30) — NOT NULL — 동의 수집 경로: LOCAL_SIGNUP, SOCIAL_SIGNUP, SETTINGS, ADMIN
  • ip_hash — CHAR(64) — 동의 요청 IP의 비식별 해시. 감사 및 부정 행위 분석용
  • user_agent_hash — CHAR(64) — 동의 요청 User-Agent의 비식별 해시
  • agreed_at — TIMESTAMPTZ — NOT NULL — 사용자가 동의 또는 거절 의사를 확정한 시각
  • revoked_at — TIMESTAMPTZ — 기존 선택 동의를 철회한 시각
  • created_at — TIMESTAMPTZ — NOT NULL — 동의 이력 레코드 생성 시각

user_login_security (유저 1:1 보안 테이블)

  • user_id (대상 사용자 ID) — identity.ulid — Foreign key → users.id — NOT NULL — 로그인 보안 상태의 대상 사용자 ID
  • restriction_status (현재 로그인 제한 상태) — VARCHAR(30) — NOT NULL — 로그인 제한 상태: NONE, TEMPORARILY_LOCKED, LOCKED
  • current_cycle (현재 로그인 실패 사이클 (1~3)) — SMALLINT — NOT NULL — 현재 로그인 실패 사이클. 1·2사이클은 일시 잠금, 3사이클은 재설정 전까지 잠금
  • failed_attempts_in_cycle (현재 사이클에서 누적된 로그인 실패 횟수 (0~5)) — SMALLINT — NOT NULL — 현재 사이클에서 누적된 로그인 실패 횟수
  • locked_until (일시 잠금이 해제되는 시각) — TIMESTAMPTZ — 일시 로그인 제한 종료 시각. 영구 제한 또는 제한 없음이면 NULL
  • permanently_locked_at (3사이클 도달로 영구 잠금된 시각) — TIMESTAMPTZ — 3사이클 도달로 비밀번호 재설정 전까지 잠긴 시각
  • last_failed_at (가장 최근 로그인 실패 시각) — TIMESTAMPTZ — 가장 최근 로그인 실패 시각
  • last_success_at (가장 최근 로그인 성공 시각) — TIMESTAMPTZ — 가장 최근 로그인 성공 시각
  • notification_email_sent_at (영구 잠금 안내 이메일 발송 성공 시각) — TIMESTAMPTZ — 영구 로그인 제한 안내 이메일 발송 성공 시각
  • created_at (로그인 보안 레코드값 생성 시각) — TIMESTAMPTZ — NOT NULL — 로그인 보안 상태 생성 시각
  • updated_at (최종 변경 시각) — TIMESTAMPTZ — NOT NULL — 로그인 보안 상태 최종 변경 시각

user_onboarding (유저 온보딩)

  • user_id (온보딩 사용자 ID) — identity.ulid — Foreign key → users.id — NOT NULL — 온보딩 정보 소유 사용자 ID
  • content_preference (콘텐츠 선호 성향 (ALL, MALE_ORIENTED, FEMALE_OREIENTED)) — VARCHAR(30) — 콘텐츠 선호 성향: ALL, MALE_ORIENTED, FEMALE_ORIENTED
  • gender (사용자가 선택한 성별) — VARCHAR(20) — 사용자가 선택한 성별 정보: UNSPECIFIED, MALE, FEMALE
  • onboarding_age (온보딩에서 선택 입력한 나이) — SMALLINT — 계정 생년월일과 별개로 온보딩에서 선택 입력한 나이
  • created_at (온보딩 정보 생성 시각) — TIMESTAMPTZ — NOT NULL — 온보딩 정보 생성 시각
  • updated_at (온보딩 정보 최종 변경 시각) — TIMESTAMPTZ — NOT NULL — 온보딩 정보 최종 변경 시각

user_preferred_genres (유저 선호 장르)

  • user_id (선호 장르를 선택한 사용자 ID) — identity.ulid — Foreign key → users.id — NOT NULL — 선호 장르를 선택한 사용자 ID
  • genre_code (사용자가 선택한 장르 코드) — VARCHAR(50) — Foreign key → genres.code — NOT NULL — 사용자가 선택한 장르 코드
  • display_order (사용자가 선택한 순서) — SMALLINT — 사용자 선택 순서 또는 선호 우선순위
  • created_at (생성 시각) — TIMESTAMPTZ — NOT NULL — 사용자 선호 장르 연결 생성 시각

user_profiles (유저 프로필)

  • user_id (해당 프로필의 유저 ID) — identity.ulid — Foreign key → users.id — NOT NULL — 프로필 소유 사용자 ID
  • image_uploads_id (이미지 업로드 테이블의 ID) — identity.ulid — Foreign key → image_uploads.id — NOT NULL — 프로필 이미지 업로드 요청 고유 ULID
  • nickname (유저 닉네임) — VARCHAR(100) — NOT NULL — 현재 표시 닉네임. 사용자 입력 규칙은 API에서 검증하며 탈퇴 시 시스템 익명화 닉네임 저장 가능
  • nickname_normalized (닉네임 중복 검사용 정규화 값) — VARCHAR(100) — NOT NULL — 대소문자·유니코드 정책에 따라 정규화한 닉네임. 사용자 간 유일성 검사에 사용
  • temporary_nickname (가입 시 자동 생성된 닉네임인지 여부) — BOOLEAN — NOT NULL — 가입 시 자동 생성된 임시 닉네임인지 여부
  • nickname_source (닉네임 의 생성 출처 (RANDOM, USER, SYSTEM_ANONYMIZED)) — VARCHAR(20) — NOT NULL — 닉네임 생성 출처: RANDOM, USER, SYSTEM_ANONYMIZED
  • profile_image_object_key (프로필 이미지 S3 내부 객체 위치) — VARCHAR(512) — 사용자 프로필에 연결된 S3 객체 키. 버킷명과 Presigned URL은 저장하지 않음
  • created_at (프로필 생성 시각) — TIMESTAMPTZ — NOT NULL — 사용자 프로필 생성 시각
  • updated_at (프로필 업데이트 시각) — TIMESTAMPTZ — NOT NULL — 사용자 프로필 최종 변경 시각

user_roles

  • user_id — identity.ulid — Foreign key → users.id — NOT NULL — 역할을 부여받은 사용자 ID
  • role_code — VARCHAR(50) — Foreign key → roles.code — NOT NULL — 사용자에게 부여된 역할 코드
  • granted_by_user_id — identity.ulid — Foreign key → users.id — 역할을 부여한 관리자 사용자 ID. 시스템 부여이면 NULL 가능
  • granted_at — TIMESTAMPTZ — NOT NULL — 역할 부여 시각
  • expires_at — TIMESTAMPTZ — 기간제 역할의 만료 시각. 영구 역할이면 NULL
  • revoked_at — TIMESTAMPTZ — 역할이 만료 전에 명시적으로 회수된 시각

users (유저)

  • id (PK) — identity.ulid — Primary key — NOT NULL — 애플리케이션에서 생성한 사용자 고유 ULID. 다른 도메인이 영구 참조하는 식별자
  • status (계정 상태 (프로필 필요, 온보딩 필요, 활성, 정지 등)) — VARCHAR(30) — NOT NULL — 계정 진행 및 생명주기 상태: PROFILE_REQUIRED, ONBOARDING_REQUIRED, ACTIVE, SUSPENDED, WITHDRAWAL_PENDING, WITHDRAWN
  • email_ciphertext (암호화한 정규화 이메일) — BYTEA — 정규화된 이메일을 KMS Envelope Encryption으로 암호화한 값. 평문 저장 금지
  • email_hash (이메일 조회, 중복 확인용 HMAC-SHA-26 해시) — CHAR(64) — 정규화 이메일의 HMAC-SHA-256 해시. 이메일 중복 검사와 계정 조회에 사용
  • email_masked (화면에 표시할 마스킹 이메일) — VARCHAR(320) — 화면과 알림에 노출할 마스킹 이메일 주소
  • email_key_version (이메일 암호화에 사용한 키 버전) — SMALLINT — 이메일 암호문 생성에 사용한 암호화 키 버전
  • email_verified_at (이메일 인증 완료 시간) — TIMESTAMPTZ — 계정 이메일 소유 인증이 완료된 시각
  • profile_completed_at (프로필 설정 완료 시간 (완료 여부의 단일 기준)) — TIMESTAMPTZ — 필수 프로필 설정 완료 시각의 단일 원본. 미완료이면 NULL
  • onboarding_completed_at (온보딩 설정 완료 시간 (완료 여부의 단일 기준)) — TIMESTAMPTZ — 온보딩 완료 시각의 단일 원본. 미완료이면 NULL
  • suspended_at (운영 정책으로 정지된 시간) — TIMESTAMPTZ — 운영 정책에 의해 계정이 정지된 시각
  • suspension_reason_code (계정 정지 사유 코드) — VARCHAR(50) — 계정 정지 사유를 나타내는 내부 정책 코드
  • withdrawal_requested_at (회원 탈퇴 신청 시간) — TIMESTAMPTZ — 회원탈퇴가 최초 요청된 시각
  • withdrawal_scheduled_at (30일 유예 후 최종 탈퇴 예정 시간) — TIMESTAMPTZ — 30일 유예 종료 후 최종 탈퇴를 실행할 예정 시각
  • withdrawn_at (최종 탈퇴 처리 시간) — TIMESTAMPTZ — 계정이 최종 탈퇴 상태로 전환된 시각
  • anonymized_at (실제 개인정보 제거 익명화 작업이 끝난 시간) — TIMESTAMPTZ — 이메일·프로필 등 개인정보 익명화가 완료된 시각
  • row_version (낙관락 버전) — BIGINT — NOT NULL — 동시 상태 변경 충돌을 탐지하기 위한 낙관적 잠금 버전
  • created_at (계정 생성시간) — TIMESTAMPTZ — NOT NULL — 사용자 계정 레코드 생성 시각
  • updated_at (계정 최정 변경 시간) — TIMESTAMPTZ — NOT NULL — 사용자 계정 레코드 최종 변경 시각

withdrawal_requests (회원 탈퇴 요청 테이블)

  • id — identity.ulid — Primary key — NOT NULL — 회원탈퇴 요청 고유 ULID. API의 withdrawalId
  • user_id — identity.ulid — Foreign key → users.id — NOT NULL — 탈퇴를 요청한 사용자 ID
  • status (처리 상태) — VARCHAR(30) — NOT NULL — 탈퇴 요청 상태: PENDING, RECOVERED, FINALIZED, FAILED
  • reason_code (탈퇴 사유 코드) — VARCHAR(50) — 사용자가 선택한 탈퇴 사유 코드
  • reason_detail (사용자가 작성한 상세 사유) — VARCHAR(1000) — 사용자가 선택적으로 입력한 탈퇴 사유 상세 내용
  • requested_at (요청 시각) — TIMESTAMPTZ — NOT NULL — 회원탈퇴가 신청된 시각
  • scheduled_at (최종 탈퇴 예정 시각) — TIMESTAMPTZ — NOT NULL — 30일 유예 종료 후 최종 익명화를 실행할 예정 시각
  • recovered_at (로그인으로 계정을 복구한 시각) — TIMESTAMPTZ — 유예기간 내 정상 로그인으로 탈퇴 요청이 취소된 시각
  • finalized_at (최종 탈퇴 완료 시각) — TIMESTAMPTZ — 최종 탈퇴와 개인정보 익명화가 완료된 시각
  • recovery_method (복구 방식) — VARCHAR(20) — 탈퇴 복구에 사용한 로그인 방식: LOCAL_LOGIN 또는 SOCIAL_LOGIN
  • created_at — TIMESTAMPTZ — NOT NULL — 탈퇴 요청 레코드 생성 시각
  • updated_at — TIMESTAMPTZ — NOT NULL — 탈퇴 요청 상태 최종 변경 시각