member
Tables (16)
artist_follow_outbox
- aggregate_version — BIGINT — Primary key — NOT NULL — 해제 이후에도 증가하는 이벤트 버전. 서로 다른 관계의 버전 및 커밋 순서와는 독립적이다.
- event_id — UUID — NOT NULL
- follower_member_id — BIGINT — NOT NULL
- artist_member_id — BIGINT — NOT NULL
- following — BOOLEAN — NOT NULL
- occurred_at — TIMESTAMPTZ — NOT NULL
- published_at — TIMESTAMPTZ — 발행 대상에 접수된 시각. 미전송 상태는 NULL이다.
- next_attempt_at — TIMESTAMPTZ — NOT NULL
- attempt_count — BIGINT — NOT NULL
- claim_token — UUID
- claim_until — TIMESTAMPTZ
artist_follows
- follow_id — BIGINT — Primary key — NOT NULL — 팔로우 관계 내부 자동 생성 번호. 회원 번호와 별개인 BIGINT 기본키.
- follower_member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 팔로우한 회원 번호. 회원 DB 내부 FK이며 동일 작가 중복 팔로우를 허용하지 않는다.
- artist_member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 팔로우 대상 작가의 회원 번호. 작품 계약의 artistId와 같은 값이며 자기 자신은 허용하지 않는다. 작가 자격은 FK가 보장하지 않는다.
- created_at — TIMESTAMPTZ — NOT NULL — 팔로우 생성 UTC 시각. 해제 후 다시 팔로우하면 새 관계와 생성 시각을 기록한다.
auth_request_attempts
- attempt_id — BIGINT — Primary key — NOT NULL — 요청 집계 이력의 내부 자동 생성 번호
- requester_key — VARCHAR(64) — NOT NULL — 서버 확인 IP 또는 정규화 이메일의 SHA-256 소문자 64자리. 요청 종류로 용도 분리
- request_kind — VARCHAR(32) — NOT NULL — 기존 이메일 인증·로그인과 비밀번호 재설정 IP 발급·이메일 발급·IP 확인을 독립 집계
- requested_at — TIMESTAMPTZ — NOT NULL — IP별 잠금 획득 후 기록한 UTC 요청 시각. 가장 긴 집계 구간인 1시간을 지난 이력은 제한적으로 정리
auth_sessions
- session_id — BIGINT — Primary key — NOT NULL — 로그인 세션 내부 식별자: DB가 자동 생성하는 BIGINT 기본키이다.
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 로그인 회원 식별자: 필수 FK이며 미폐기 세션에만 부분 유일 인덱스가 적용된다.
- authenticated_at — TIMESTAMPTZ — NOT NULL — 최초 로그인 시각: 기본값은 현재 트랜잭션 시각이며 세션 절대 수명의 기준이다.
- absolute_expires_at — TIMESTAMPTZ — NOT NULL — 세션 절대 만료 시각: 로그인 시각 이후여야 하며 Refresh 교체로 연장하지 않는 정책은 애플리케이션에서 검증한다.
- revoked_at — TIMESTAMPTZ — 세션 폐기 시각: NULL이면 미폐기이며 폐기 시 로그인 시각 이상이어야 한다. 만료된 세션도 명시적 폐기 전에는 부분 유일 인덱스에 포함된다.
- revocation_reason — VARCHAR(32) — 세션 폐기 사유: 폐기 시각과 함께 비어 있지 않은 값으로 기록하며 미폐기 시 NULL이다.
dev_load_test_accounts
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 지갑 생성 자동 보충을 제외할 부하 시험 회원의 양의 BIGINT 번호. 회원 서비스 내부 PK 겸 FK이며 일반 회원이나 기존 시험 계정을 자동 등록하지 않는다.
- created_at — TIMESTAMPTZ — NOT NULL — 부하 시험 계정 표식 등록 UTC 시각. 기본값은 현재 트랜잭션 시각이다.
email_verification_challenges
- challenge_id — BIGINT — Primary key — NOT NULL — 코드 발급 시도 식별자: DB가 자동 생성하는 BIGINT 기본키이며 비밀값이나 인증 증명이 아니다.
- email — VARCHAR(254) — NOT NULL — 인증 대상 이메일 입력값: 회원 생성 전에도 저장할 수 있으며 회원 테이블과 직접 FK로 연결하지 않는다.
- email_key — VARCHAR(254) — 인증 대상 이메일 조회 키: 앞뒤 공백 제거 및 소문자 변환으로 자동 생성하며 여러 발급 이력을 허용하므로 유일하지 않다.
- attempt_token_hash — BYTEA — NOT NULL — 가입 화면 시도 비밀값의 SHA-256 해시 32바이트: 유일하며 원문 대신 저장한다. 단순 시도 ID와 구분한다.
- code_hash — BYTEA — NOT NULL — 숫자 코드 검증용 HMAC-SHA-256 32바이트: 시도 ID와 정규화 이메일 및 코드에 바인딩하며 비밀키는 DB 밖에서 주입한다. SQL은 길이만 검사한다.
- requested_at — TIMESTAMPTZ — NOT NULL — 코드 발급 요청 시각: 기본값은 현재 트랜잭션 시각이다.
- code_expires_at — TIMESTAMPTZ — NOT NULL — 코드 만료 시각: 요청 시각 이후여야 하며 현재 시각과의 만료 비교는 애플리케이션에서 수행한다.
- resend_available_at — TIMESTAMPTZ — NOT NULL — 재발송 가능 시각: 요청 시각 이상이어야 한다. 이메일과 요청자별 재발송 제한 및 직렬화는 애플리케이션에서 수행한다.
- failed_attempts — INTEGER — NOT NULL — 코드 오입력 횟수: 기본값 0이며 0 이상 max_attempts 이하여야 한다. 실패 응답에서도 횟수 변경을 커밋해야 한다.
- max_attempts — INTEGER — NOT NULL — 발급 코드의 오입력 허용 상한: 양의 정수이며 정책값은 애플리케이션에서 지정한다.
- invalidated_at — TIMESTAMPTZ — 시도 무효화 시각: NULL이면 미무효화이며 값이 있으면 요청 시각 이상이어야 한다. 연결된 가입 증명도 사용 시 재검증한다.
email_verifications
- verification_id — BIGINT — Primary key — NOT NULL — 가입 증명 내부 식별자: DB가 자동 생성하는 BIGINT 기본키이며 증명 비밀값과 구분한다.
- proof_hash — BYTEA — NOT NULL — 무작위 가입 증명 비밀값의 SHA-256 해시 32바이트: 유일하며 증명 원문을 보관하지 않는다.
- verified_at — TIMESTAMPTZ — NOT NULL — 이메일 코드 확인 시각: 증명 유효기간의 기준 시각이다.
- expires_at — TIMESTAMPTZ — NOT NULL — 가입 증명 만료 시각: 코드 확인 시각 이후여야 하며 코드 만료와 별개로 관리한다.
- consumed_at — TIMESTAMPTZ — 최종 가입에서 증명을 소비한 시각: 소비 회원과 함께 기록하며 확인 시각 이상 및 증명 만료 시각 미만이어야 한다.
- consumed_by — BIGINT — Foreign key → members.member_id — 증명을 소비한 회원 식별자: 미소비 시 NULL인 선택 FK이며 소비 시각과 함께 값이 있어야 한다. 회원당 증명 수에 유일 제약은 없다.
- challenge_id — BIGINT — Foreign key → email_verification_challenges.challenge_id — NOT NULL — 코드 확인 대상 시도 식별자: 필수 FK이자 유일키이다. 각 증명은 한 시도에 속하고 시도는 증명을 최대 한 개 가진다.
member_terms_consents
- consent_id — BIGINT — Primary key — NOT NULL — 약관 동의 기록 내부 자동 생성 번호
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 실제 동의한 회원 번호. 회원 서비스 내부 FK
- term_id — BIGINT — Foreign key → terms_documents.term_id — NOT NULL — 회원에게 제시하고 동의받은 특정 약관 버전 번호. 회원 서비스 내부 FK
- agreed_at — TIMESTAMPTZ — NOT NULL — 회원이 표시된 약관 버전에 실제로 동의한 UTC 시각
members
- member_id — BIGINT — Primary key — NOT NULL — 회원 식별자: DB가 자동 생성하는 BIGINT 기본키를 다른 서비스에도 그대로 제공한다. JWT sub에는 같은 값의 10진 문자열을 넣으며 탈퇴·삭제 후에도 ID를 재사용하지 않는다.
- email — VARCHAR(254) — NOT NULL — 회원 이메일 입력값: 공백만 있는 값은 금지하며 이메일 문법은 애플리케이션에서 검증한다.
- email_key — VARCHAR(254) — 이메일 중복 확인 키: 이메일 앞뒤 공백 제거 및 소문자 변환으로 자동 생성하며 회원 전체에서 유일하다.
- status — VARCHAR(16) — NOT NULL — 회원 상태: ACTIVE 활성, SUSPENDED 정지, WITHDRAWN 탈퇴이며 기본값은 ACTIVE이다.
- email_verified_at — TIMESTAMPTZ — NOT NULL — 이메일 소유 확인 시각: 실제 인증 결과와의 일치는 가입 처리에서 검증한다.
- created_at — TIMESTAMPTZ — NOT NULL — 회원 생성 시각: 기본값은 현재 트랜잭션 시각이다.
- updated_at — TIMESTAMPTZ — NOT NULL — 회원 정보 수정 시각: 기본값만 제공하며 변경 시 애플리케이션이 갱신한다.
- withdrawn_at — TIMESTAMPTZ — 탈퇴 시각: WITHDRAWN 상태일 때만 필수이며 다른 상태에서는 NULL이다. 탈퇴한 회원 ID는 재사용하지 않으며 개인정보 삭제 완료를 뜻하지 않는다.
- role — VARCHAR(16) — NOT NULL — 회원 권한: USER(일반 사용자), ADMIN(관리자). 신규 회원은 서버에서 USER로 생성하며 회원가입 입력으로 권한을 받지 않는다.
- name — VARCHAR(50) — 회원 이름: 닉네임과 별개인 최대 50자 입력값이며 본인인증을 거친 실명을 뜻하지 않는다. 기존 회원은 NULL을 유지하고 동명이인을 허용한다. 저장 시 빈 값, 앞뒤 ASCII 공백 및 제어문자를 허용하지 않는다.
- login_id — VARCHAR(20) — 로그인 아이디. 영문 소문자·숫자 4~20자, 중복 불가. 기존 회원은 NULL 보존
- nickname — VARCHAR(12) — 표시 닉네임. 완성형 한글·영문·숫자 2~12자. 영문 대소문자 구분 없이 중복 불가. 기존 회원은 NULL 보존
- nickname_key — VARCHAR(12) — 닉네임 중복 비교키. PostgreSQL lower(nickname) 자동 생성
- gender — VARCHAR(16) — NOT NULL — 성별 선택. MALE 남성, FEMALE 여성, UNSPECIFIED 선택 안 함. 기존 회원은 선택 안 함
- birth_date — DATE — 선택 입력 생년월일. 신규 가입에서 미래 날짜 거절. 본인인증 결과가 아닌 사용자 입력
oauth_accounts
- oauth_account_id — BIGINT — Primary key — NOT NULL — 외부 계정 연결 내부 식별자: DB가 자동 생성하는 BIGINT 기본키이다.
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 연결된 회원 식별자: 필수 FK이며 이메일 일치만으로 자동 연결하지 않는다.
- provider — VARCHAR(16) — NOT NULL — 외부 로그인 제공자: 현재 GOOGLE만 허용하며 provider_subject와의 조합에 유일 제약이 있다.
- provider_subject — VARCHAR(255) — NOT NULL — 제공자가 발급한 계정 식별자: Google의 sub이며 이메일이 아니다. provider와의 조합에 유일 제약이 있다.
- linked_at — TIMESTAMPTZ — NOT NULL — 외부 계정 연결 시각: 기본값은 현재 트랜잭션 시각이다.
password_credentials
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 회원 식별자: 회원 기본키를 공유하는 PK 겸 FK이며 독립 ID를 자동 생성하지 않는다.
- password_hash — TEXT — NOT NULL — 비밀번호 해시 문자열: 알고리즘과 비용 및 회원별 무작위 salt를 포함하며 안전한 해시 생성은 애플리케이션 책임이다.
- changed_at — TIMESTAMPTZ — NOT NULL — 비밀번호 설정 또는 변경 시각: 기본값은 현재 트랜잭션 시각이다.
password_login_failures
- failure_id — BIGINT — Primary key — NOT NULL — 비밀번호 실패 이력 내부 자동 생성 번호
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 비밀번호가 일치하지 않은 기존 회원 번호. 다른 서비스 DB를 참조하지 않음
- failed_at — TIMESTAMPTZ — NOT NULL — 회원 행 잠금 획득 후 기록한 UTC 실패 시각. 추가 고정 잠금 기간을 저장하지 않음
password_reset_tokens
- reset_id — BIGINT — Primary key — NOT NULL — 재설정 링크 내부 번호
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL — 재설정 대상 회원 번호
- token_hash — BYTEA — NOT NULL — 정규 Base64URL 32바이트 난수 문자열의 SHA-256 해시
- issued_at — TIMESTAMPTZ — NOT NULL — 발급 시각 UTC
- expires_at — TIMESTAMPTZ — NOT NULL — 발급 후 30분 만료 시각 UTC
- consumed_at — TIMESTAMPTZ — 비밀번호 변경과 함께 커밋한 일회 소비 시각
- invalidated_at — TIMESTAMPTZ — 재발급 등으로 폐기한 시각
refresh_tokens
- token_id — BIGINT — Primary key — NOT NULL — Refresh 토큰 이력 식별자: DB가 자동 생성하는 BIGINT 기본키이며 토큰 비밀값이 아니다.
- session_id — BIGINT — Foreign key → auth_sessions.session_id — NOT NULL — 소속 로그인 세션 식별자: 필수 FK이며 세션의 절대 만료를 따른다. 미사용 토큰에만 부분 유일 인덱스가 적용된다.
- token_hash — BYTEA — NOT NULL — 무작위 Refresh 토큰의 SHA-256 해시 32바이트: 유일하며 토큰 원문을 보관하지 않는다.
- issued_at — TIMESTAMPTZ — NOT NULL — 토큰 발급 시각: 기본값은 현재 트랜잭션 시각이며 세션 수명 안에 있는지는 애플리케이션에서 검증한다.
- used_at — TIMESTAMPTZ — 토큰 교체 시 소비한 시각: NULL이면 미사용이며 값이 있으면 발급 시각 이상이어야 한다. 이미 사용한 토큰의 재사용 판정은 애플리케이션 책임이다.
terms_documents
- term_id — BIGINT — Primary key — NOT NULL — 약관 버전 내부 자동 생성 번호. 동의 이력은 이 버전을 참조
- code — VARCHAR(32) — NOT NULL — 회원가입 약관 종류: SERVICE_TERMS 서비스 이용, PRIVACY_COLLECTION_USE 개인정보 수집·이용, CERTIFICATE_NAME_DISCLOSURE 디지털 보증서의 작가 이름 공개 동의
- version — VARCHAR(32) — NOT NULL — 동일 종류 안에서 유일한 버전 식별자. 게시한 본문 변경은 새 버전으로 추가
- title — VARCHAR(100) — NOT NULL — 회원에게 보여 줄 약관 제목. 초안은 제목에도 검토 상태 표시
- content — TEXT — NOT NULL — 해당 버전의 한국어 약관 본문. 초안의 미정 항목은 운영 전 검토
- required — BOOLEAN — NOT NULL — 회원가입 시 동의가 필요한 약관인지 여부. 현재 초안을 가입 검증에 자동 적용하지 않음
- status — VARCHAR(16) — NOT NULL — DRAFT 검토용 초안, PUBLISHED 게시본. 초안은 유효 약관 목록에서 제외
- effective_at — TIMESTAMPTZ — 게시본의 UTC 시행 시각. 초안은 NULL이며 임의 법적 시행일을 넣지 않음
- created_at — TIMESTAMPTZ — NOT NULL — 해당 버전 DB 등록 UTC 시각
wallet_provisioning_outbox
- request_id — UUID — Primary key — NOT NULL
- member_id — BIGINT — Foreign key → members.member_id — NOT NULL
- status — VARCHAR(16) — NOT NULL
- attempt_count — INTEGER — NOT NULL
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
- next_attempt_at — TIMESTAMPTZ — NOT NULL
- lease_until — TIMESTAMPTZ
- claim_token — UUID
- completed_at — TIMESTAMPTZ
- last_error_code — VARCHAR(32)