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 — 탈퇴 요청 상태 최종 변경 시각