Brit

Tables (41)

banks

  • id — SMALLSERIAL — Primary key — NOT NULL — Brit 내부 은행 식별자.
  • code — VARCHAR(20) — NOT NULL — 외부 API 및 화면에서 사용하는 은행 코드.
  • name — VARCHAR(50) — NOT NULL — 은행 공식 명칭.
  • icon_key — VARCHAR(50) — 프론트엔드가 아이콘을 찾는 논리 키.
  • svg_filename — VARCHAR(255) — 정적 리소스로 제공하는 SVG 파일명.
  • daily_maintenance_start — TIME — 매일 반복되는 점검 시작 시각.
  • daily_maintenance_end — TIME — 매일 반복되는 점검 종료 시각.
  • regular_maintenance_rule — VARCHAR(100) — 예: 매월 둘째 일요일 같은 정기 점검 규칙.
  • regular_maintenance_start — TIME — 정기 점검 시작 시각.
  • regular_maintenance_end — TIME — 정기 점검 종료 시각.
  • maintenance_note — TEXT — 사용자에게 보여줄 점검 안내.
  • sort_order — SMALLINT — NOT NULL — 은행 선택 화면 정렬 순서.
  • is_active — BOOLEAN — NOT NULL — 신규 계좌 등록 화면 노출 여부.
  • created_at — TIMESTAMPTZ — NOT NULL — 기준정보 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 기준정보 수정 시각.

buy_orders

  • id — UUID — Primary key — NOT NULL — 구매 주문 식별자.
  • order_number — VARCHAR(40) — NOT NULL — 사용자·관리자 표시 구매 주문번호.
  • buyer_user_id — UUID — Foreign key → users.id — NOT NULL — 구매자.
  • coin_amount — BIGINT — NOT NULL — 한 명의 판매자로부터 전부 구매할 Coin 수량.
  • status — buy_order_status — NOT NULL — 매칭 대기·매칭·완료·취소·만료 상태.
  • idempotency_key — VARCHAR(150) — NOT NULL — 버튼 중복 클릭·API 재시도 중복 주문 방지 키.
  • match_attempt_count — SMALLINT — NOT NULL — 현재까지 수행한 매칭 시도 횟수.
  • max_match_attempts — SMALLINT — NOT NULL — 주문 생성 당시 정책에서 복사한 최대 재매칭 횟수.
  • next_matchable_at — TIMESTAMPTZ — NOT NULL — 재시도 지연을 반영한 다음 매칭 가능 시각.
  • expires_at — TIMESTAMPTZ — 구매 주문 자체 대기 만료 시각.
  • matched_at — TIMESTAMPTZ — 현재 활성 거래와 매칭된 시각.
  • completed_at — TIMESTAMPTZ — 최종 거래 완료 시각.
  • cancelled_at — TIMESTAMPTZ — 사용자 또는 관리자 취소 시각.
  • cancel_reason — VARCHAR(500) — 취소 또는 만료 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 구매 주문 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 주문 상태 최종 수정 시각.

coin_ledger_entries

  • id — UUID — Primary key — NOT NULL — 사용자 원장 행 식별자.
  • transaction_id — UUID — NOT NULL — 한 업무에서 발생한 사용자·업체 원장 행을 묶는 거래 그룹 ID.
  • sequence_no — SMALLINT — NOT NULL — 동일 transaction_id 내부 원장 순서.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 잔액이 변한 사용자.
  • counterparty_user_id — UUID — Foreign key → users.id — P2P 이전의 상대방 사용자.
  • counterparty_partner_id — UUID — Foreign key → partners.id — 업체 충전·REDEEM·관리자 지급의 상대 업체. partners 생성 후 FK를 추가한다.
  • coin_lot_id — UUID — Foreign key → user_coin_lots.id — 관련 사용자 Coin 묶음.
  • entry_type — coin_ledger_entry_type — NOT NULL — 잔액이 변한 업무 원인.
  • non_sellable_delta — BIGINT — NOT NULL — 판매 불가 사용 가능 잔액 증감.
  • sellable_delta — BIGINT — NOT NULL — 판매 가능 사용 가능 잔액 증감.
  • locked_non_sellable_delta — BIGINT — NOT NULL — 잠긴 판매 불가 잔액 증감.
  • locked_sellable_delta — BIGINT — NOT NULL — 잠긴 판매 가능 잔액 증감.
  • pending_sellable_delta — BIGINT — NOT NULL — 대기 판매 가능 잔액 증감.
  • non_sellable_balance_after — BIGINT — NOT NULL — 반영 직후 판매 불가 사용 가능 잔액.
  • sellable_balance_after — BIGINT — NOT NULL — 반영 직후 판매 가능 사용 가능 잔액.
  • locked_non_sellable_balance_after — BIGINT — NOT NULL — 반영 직후 잠긴 판매 불가 잔액.
  • locked_sellable_balance_after — BIGINT — NOT NULL — 반영 직후 잠긴 판매 가능 잔액.
  • pending_sellable_balance_after — BIGINT — NOT NULL — 반영 직후 대기 판매 가능 잔액.
  • reference_type — VARCHAR(50) — NOT NULL — BUY_ORDER·TRADE·PARTNER_EXCHANGE·PARTNER_COIN_GRANT 등 원장 발생 업무 종류.
  • reference_id — UUID — NOT NULL — 원장을 발생시킨 업무 ID.
  • idempotency_key — VARCHAR(150) — NOT NULL — 같은 업무의 원장 중복 INSERT 방지 키.
  • description — VARCHAR(500) — 운영자가 이해할 수 있는 원장 설명.
  • created_by_user_id — UUID — Foreign key → users.id — 관리자 조정 시 처리 관리자.
  • created_at — TIMESTAMPTZ — NOT NULL — 원장 확정 시각.

matching_attempts

  • id — UUID — Primary key — NOT NULL — 매칭 시도 식별자.
  • buy_order_id — UUID — Foreign key → buy_orders.id — NOT NULL — 매칭을 요청한 구매 주문.
  • sell_order_id — UUID — Foreign key → sell_orders.id — 선택했거나 최종 검토한 판매 후보.
  • trade_id — UUID — Foreign key → trades.id — 매칭 성공 시 생성된 실제 거래. trades 생성 후 FK를 추가한다.
  • result — matching_result — NOT NULL — 성공·후보 없음·위험 거절·시스템 오류 결과.
  • failure_reason — VARCHAR(500) — 실패 또는 거절의 구체적 원인.
  • requested_amount — BIGINT — NOT NULL — 구매 주문이 요구한 Coin 수량.
  • candidate_remaining_amount — BIGINT — 후보 판매 주문 조회 당시 잔량.
  • created_at — TIMESTAMPTZ — NOT NULL — 매칭 시도 시각.

matching_policies

  • id — UUID — Primary key — NOT NULL — 매칭 정책 식별자.
  • version — INTEGER — NOT NULL — 정책 버전 번호.
  • minimum_partial_match_rate — NUMERIC(5,4) — NOT NULL — 최초 판매액 대비 최소 분할 체결 비율. 기본 20%.
  • absolute_minimum_trade_amount — BIGINT — NOT NULL — 비율 계산값이 지나치게 작을 때 적용하는 절대 최소 거래액.
  • amount_unit — BIGINT — NOT NULL — 최소 거래액과 주문액을 올림·검증하는 단위.
  • buyer_payment_timeout_seconds — INTEGER — NOT NULL — 매칭 후 구매자 입금 제한시간.
  • seller_confirmation_timeout_seconds — INTEGER — NOT NULL — 입금 선언 후 판매자 확인 제한시간.
  • additional_confirmation_timeout_seconds — INTEGER — NOT NULL — 추가 확인 단계 제한시간.
  • max_auto_rematch_attempts — SMALLINT — NOT NULL — 거래 실패·만료 후 구매 주문 자동 재매칭 최대 횟수.
  • is_active — BOOLEAN — NOT NULL — 신규 주문에 적용할 현재 정책 여부.
  • effective_from — TIMESTAMPTZ — NOT NULL — 정책 적용 시작 시각.
  • effective_to — TIMESTAMPTZ — 정책 적용 종료 시각.
  • created_by_user_id — UUID — Foreign key → users.id — NOT NULL — 정책 생성 관리자.
  • created_at — TIMESTAMPTZ — NOT NULL — 정책 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 정책 수정 시각.

partner_assets

  • id — UUID — Primary key — NOT NULL — 업체 자산 식별자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 자산을 제공하는 업체.
  • asset_code — VARCHAR(50) — NOT NULL — 업체 내부 자산 코드.
  • asset_name — VARCHAR(100) — NOT NULL — 사용자 화면 표시 자산명.
  • unit_name — VARCHAR(30) — NOT NULL — P·캐시·마일 등의 표시 단위.
  • charge_enabled — BOOLEAN — NOT NULL — Brit Coin에서 업체 자산으로 CHARGE 가능한지 여부.
  • redeem_enabled — BOOLEAN — NOT NULL — 업체 자산에서 Brit Coin으로 REDEEM 가능한지 여부.
  • is_active — BOOLEAN — NOT NULL — 신규 전환 요청 사용 가능 여부.
  • created_at — TIMESTAMPTZ — NOT NULL — 자산 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 자산 설정 수정 시각.

partner_client_origins

  • id — UUID — Primary key — NOT NULL — Origin 허용 항목 식별자.
  • partner_client_id — UUID — Foreign key → partner_clients.id — NOT NULL — 대상 PUBLIC_SDK Client.
  • allowed_origin — VARCHAR(255) — NOT NULL — 프로토콜·호스트·포트를 포함한 정확한 Origin.
  • created_by_user_id — UUID — Foreign key → users.id — NOT NULL — Origin 등록자.
  • created_at — TIMESTAMPTZ — NOT NULL — Origin 등록 시각.

partner_client_scopes

  • scope — VARCHAR(50) — Primary key — NOT NULL — 허용 API 범위 코드.
  • partner_client_id — UUID — Foreign key → partner_clients.id — NOT NULL — 권한 대상 Client.
  • granted_by_user_id — UUID — Foreign key → users.id — NOT NULL — Scope 부여자.
  • granted_at — TIMESTAMPTZ — NOT NULL — Scope 부여 시각.

partner_client_secrets

  • id — UUID — Primary key — NOT NULL — Secret 이력 식별자.
  • partner_client_id — UUID — Foreign key → partner_clients.id — NOT NULL — Secret 소유 Client.
  • secret_type — partner_client_secret_type — NOT NULL — CLIENT_AUTH 또는 WEBHOOK_SIGNING.
  • secret_hash — VARCHAR(255) — NOT NULL — Secret 원문의 단방향 해시.
  • secret_prefix — VARCHAR(30) — NOT NULL — 관리 화면에서 Secret을 식별하는 접두부.
  • status — partner_client_secret_status — NOT NULL — 활성·만료·폐기 상태.
  • expires_at — TIMESTAMPTZ — 자동 만료 시각.
  • last_used_at — TIMESTAMPTZ — 최근 인증 또는 서명 검증 성공 시각.
  • revoked_at — TIMESTAMPTZ — 폐기 시각.
  • revoked_by_user_id — UUID — Foreign key → users.id — 폐기 처리자.
  • revoke_reason — VARCHAR(500) — 폐기 사유.
  • created_by_user_id — UUID — Foreign key → users.id — NOT NULL — Secret 발급자.
  • created_at — TIMESTAMPTZ — NOT NULL — Secret 발급 시각.

partner_clients

  • id — UUID — Primary key — NOT NULL — 내부 Client 식별자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — Client 소유 업체.
  • client_id — VARCHAR(100) — NOT NULL — 외부에 공개되는 Client ID.
  • name — VARCHAR(100) — NOT NULL — 운영자가 구분하는 애플리케이션 또는 서버 이름.
  • client_type — partner_client_type — NOT NULL — 브라우저 PUBLIC_SDK 또는 Secret 사용 서버형 Client.
  • environment — partner_client_environment — NOT NULL — SANDBOX·STAGING·PRODUCTION 환경.
  • status — partner_client_status — NOT NULL — Client 활성·정지·폐기 상태.
  • access_token_ttl_seconds — INTEGER — NOT NULL — 서버 Client 접근 토큰 유효시간.
  • webhook_url — VARCHAR(500) — Brit가 전환 결과를 통지할 업체 서버 Webhook URL.
  • last_used_at — TIMESTAMPTZ — 최근 인증 또는 API 호출 시각.
  • created_by_user_id — UUID — Foreign key → users.id — NOT NULL — Client를 발급한 업체 담당자 또는 Brit 관리자.
  • created_at — TIMESTAMPTZ — NOT NULL — Client 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — Client 설정 최종 수정 시각.

partner_coin_grants

  • id — UUID — Primary key — NOT NULL — 업체 Coin 지급 업무 식별자.
  • grant_number — VARCHAR(40) — NOT NULL — 운영자와 업체가 조회하는 지급번호.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — Coin을 지급하는 업체.
  • recipient_partner_member_id — UUID — Foreign key → partner_members.id — NOT NULL — Coin을 받는 업체 담당자 소속 이력.
  • recipient_user_id — UUID — Foreign key → users.id — NOT NULL — 실제 개인 Coin 지갑 소유 사용자.
  • amount — BIGINT — NOT NULL — 업체가 개인 사용자에게 지급할 Coin 수량.
  • status — partner_coin_grant_status — NOT NULL — 요청·승인·완료·반려·취소 상태.
  • idempotency_key — VARCHAR(150) — NOT NULL — 지급 요청 중복 생성 방지 키.
  • requested_by_user_id — UUID — Foreign key → users.id — NOT NULL — 지급을 요청한 업체 담당자 또는 Brit 관리자.
  • approved_by_user_id — UUID — Foreign key → users.id — 지급을 승인한 다른 업체 담당자 또는 Brit 관리자.
  • reason — VARCHAR(500) — NOT NULL — 성과급·운영 배분·유동성 공급 등 지급 사유.
  • rejection_reason — VARCHAR(500) — 지급 반려 사유.
  • requested_at — TIMESTAMPTZ — NOT NULL — 지급 요청 시각.
  • approved_at — TIMESTAMPTZ — 지급 승인 시각.
  • completed_at — TIMESTAMPTZ — 업체 지갑 차감과 사용자 지갑 증가가 완료된 시각.
  • cancelled_at — TIMESTAMPTZ — 처리 전 지급 취소 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 지급 업무 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 지급 상태 최종 수정 시각.

partner_coin_ledger_entries

  • id — UUID — Primary key — NOT NULL — 업체 Coin 원장 행 식별자.
  • transaction_id — UUID — NOT NULL — 같은 사용자·업체 가치 이동의 원장 행을 묶는 거래 그룹 ID.
  • sequence_no — SMALLINT — NOT NULL — 동일 transaction_id 내부 순서.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 잔액이 변한 업체.
  • counterparty_user_id — UUID — Foreign key → users.id — CHARGE·REDEEM·관리자 지급의 상대 사용자.
  • entry_type — partner_coin_entry_type — NOT NULL — 업체 Coin 잔액이 변한 업무 원인.
  • available_delta — BIGINT — NOT NULL — 업체 사용 가능 Coin 증감.
  • locked_delta — BIGINT — NOT NULL — 업체 잠금 Coin 증감.
  • available_balance_after — BIGINT — NOT NULL — 반영 직후 업체 사용 가능 잔액.
  • locked_balance_after — BIGINT — NOT NULL — 반영 직후 업체 잠금 잔액.
  • reference_type — VARCHAR(50) — NOT NULL — PARTNER_EXCHANGE·PARTNER_COIN_GRANT·ADMIN_ADJUSTMENT 등 원본 업무 종류.
  • reference_id — UUID — NOT NULL — 원장을 발생시킨 업무 ID.
  • idempotency_key — VARCHAR(150) — NOT NULL — 업체 원장 중복 INSERT 방지 키.
  • description — VARCHAR(500) — 운영자용 원장 설명.
  • created_by_user_id — UUID — Foreign key → users.id — 관리자 조정 또는 지급 승인 처리자.
  • created_at — TIMESTAMPTZ — NOT NULL — 원장 확정 시각.

partner_coin_wallets

  • partner_id — UUID — Foreign key → partners.id — NOT NULL — Coin 지갑 소유 업체.
  • available_balance — BIGINT — NOT NULL — REDEEM 지급 또는 업체 담당자 배분에 사용할 수 있는 Coin.
  • locked_balance — BIGINT — NOT NULL — REDEEM·담당자 지급 처리 중 잠긴 Coin.
  • status — partner_coin_wallet_status — NOT NULL — 업체 지갑 활성·정지·종료 상태.
  • version — BIGINT — NOT NULL — 동시 잔액 갱신 충돌 감지 버전.
  • suspended_at — TIMESTAMPTZ — 지갑 정지 시각.
  • suspended_reason — VARCHAR(500) — 지갑 정지 사유.
  • closed_at — TIMESTAMPTZ — 지갑 종료 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 업체 지갑 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 잔액 또는 상태 최종 변경 시각.

partner_exchange_attempts

  • id — UUID — Primary key — NOT NULL — 외부 통신 시도 식별자.
  • partner_exchange_id — UUID — Foreign key → partner_exchanges.id — NOT NULL — 대상 업체 전환.
  • attempt_no — INTEGER — NOT NULL — 동일 전환 업무 안에서의 통신 순번.
  • attempt_type — exchange_attempt_type — NOT NULL — 실행·상태 조회·취소·역처리·Webhook 통지 종류.
  • request_id — VARCHAR(100) — NOT NULL — Brit가 생성한 서버 간 요청 추적 ID.
  • endpoint — VARCHAR(500) — 호출한 업체 API 또는 Webhook 주소. 인증정보는 제외한다.
  • request_payload_masked — JSONB — 민감정보를 제거한 요청 본문.
  • response_payload_masked — JSONB — 민감정보를 제거한 응답 본문.
  • http_status — INTEGER — HTTP 응답 상태. 네트워크 타임아웃은 NULL.
  • result — exchange_attempt_result — NOT NULL — 성공·확정 실패·타임아웃·네트워크 오류·결과 불명.
  • partner_result_code — VARCHAR(100) — 업체가 응답한 원본 결과 코드.
  • error_code — VARCHAR(100) — Brit 표준 네트워크·파싱·서명 오류 코드.
  • error_message — VARCHAR(500) — 운영자용 오류 상세.
  • started_at — TIMESTAMPTZ — NOT NULL — 외부 통신 시작 시각.
  • responded_at — TIMESTAMPTZ — 응답 수신 또는 오류 확정 시각.
  • next_retry_at — TIMESTAMPTZ — 재조회·Webhook 재전송 예정 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 시도 행 생성 시각.

partner_exchange_coin_lots

  • partner_exchange_id — UUID — Foreign key → partner_exchanges.id — NOT NULL — 업체 CHARGE 요청.
  • coin_lot_id — UUID — Foreign key → user_coin_lots.id — NOT NULL — CHARGE에 배정한 사용자 Coin 묶음.
  • allocated_amount — BIGINT — NOT NULL — 이 묶음에서 전환 요청에 잠근 수량.
  • completed_amount — BIGINT — NOT NULL — 업체 포인트 지급 성공으로 최종 소비한 수량.
  • released_amount — BIGINT — NOT NULL — 취소·확정 실패로 사용자 묶음에 반환한 수량.
  • created_at — TIMESTAMPTZ — NOT NULL — 배정 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 소비 또는 반환 수량 최종 변경 시각.

partner_exchange_events

  • id — UUID — Primary key — NOT NULL — 전환 이벤트 식별자.
  • partner_exchange_id — UUID — Foreign key → partner_exchanges.id — NOT NULL — 대상 전환 업무.
  • previous_status — partner_exchange_status — 이벤트 직전 상태. 최초 생성은 NULL 가능.
  • new_status — partner_exchange_status — NOT NULL — 이벤트 반영 후 상태.
  • event_type — VARCHAR(50) — NOT NULL — REQUESTED·LOCKED·API_CALLED·RECONCILIATION 등 이벤트 분류.
  • actor_type — VARCHAR(30) — NOT NULL — USER·PARTNER_CLIENT·ADMIN·SYSTEM 중 행위 주체 종류.
  • actor_user_id — UUID — Foreign key → users.id — 사용자 또는 관리자 행위자.
  • actor_partner_client_id — UUID — Foreign key → partner_clients.id — 업체 Client 행위자.
  • event_code — VARCHAR(100) — NOT NULL — 프로그램 분기·집계용 표준 이벤트 코드.
  • event_message — VARCHAR(500) — 운영자가 읽는 상세 설명.
  • metadata — JSONB — NOT NULL — 오류 코드·재시도 정보 등 비핵심 부가값.
  • created_at — TIMESTAMPTZ — NOT NULL — 이벤트 발생 시각.

partner_exchanges

  • id — UUID — Primary key — NOT NULL — 업체 전환 업무 식별자.
  • exchange_number — VARCHAR(40) — NOT NULL — 사용자·운영자가 조회하는 전환번호.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 전환을 요청한 Brit 사용자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 전환 대상 업체.
  • user_partner_link_id — UUID — Foreign key → user_partner_links.id — NOT NULL — 사용자의 해당 업체 계정 연결.
  • partner_asset_id — UUID — Foreign key → partner_assets.id — NOT NULL — 충전·환전할 업체 자산.
  • exchange_type — partner_exchange_type — NOT NULL — CHARGE 또는 REDEEM 방향.
  • status — partner_exchange_status — NOT NULL — 요청·Coin 잠금·업체 처리·결과 확인·완료·실패·취소·역처리 상태.
  • amount — BIGINT — NOT NULL — MVP 1:1 기준 Brit Coin과 업체 자산의 공통 수량.
  • partner_transaction_id — VARCHAR(255) — 업체가 발급한 실제 처리 거래번호.
  • idempotency_key — VARCHAR(255) — NOT NULL — Brit API 재시도 시 같은 전환 중복 생성을 막는 키.
  • partner_idempotency_key — VARCHAR(255) — 업체가 전달한 멱등 키.
  • metadata — JSONB — NOT NULL — 업체별 비핵심 부가정보. 금액·상태 같은 핵심값은 JSON에 두지 않는다.
  • requested_at — TIMESTAMPTZ — NOT NULL — 사용자가 전환을 확정한 시각.
  • coin_locked_at — TIMESTAMPTZ — CHARGE 대상 사용자 Coin 또는 REDEEM 대상 업체 Coin을 잠근 시각.
  • processing_at — TIMESTAMPTZ — 업체 API 처리를 시작한 시각.
  • reconciliation_required_at — TIMESTAMPTZ — 타임아웃 등으로 실제 결과 재확인이 필요해진 시각.
  • partner_completed_at — TIMESTAMPTZ — 업체가 응답한 실제 완료 시각.
  • completed_at — TIMESTAMPTZ — Brit가 최종 완료를 확정한 시각.
  • failed_at — TIMESTAMPTZ — 업체 미처리를 확인하여 실패를 확정한 시각.
  • cancelled_at — TIMESTAMPTZ — 업체 처리 전 취소 시각.
  • reversed_at — TIMESTAMPTZ — 완료 후 보정·역처리를 확정한 시각.
  • failure_code — VARCHAR(100) — Brit 표준 실패 코드.
  • failure_message — VARCHAR(500) — 운영자용 실패 상세.
  • created_by_client_id — UUID — Foreign key → partner_clients.id — 전환을 요청한 업체 Client.
  • created_at — TIMESTAMPTZ — NOT NULL — 전환 업무 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 전환 현재 상태 최종 수정 시각.

partner_fee_accruals

  • id — UUID — Primary key — NOT NULL — 건별 수수료 발생 식별자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 수수료를 지급할 업체.
  • partner_exchange_id — UUID — Foreign key → partner_exchanges.id — NOT NULL — 수수료 발생 원인이 된 완료 전환.
  • fee_policy_id — UUID — Foreign key → partner_fee_policies.id — NOT NULL — 적용한 업체 수수료 정책.
  • exchange_type — partner_exchange_type — NOT NULL — 수수료가 발생한 CHARGE 또는 REDEEM 방향.
  • gross_amount — BIGINT — NOT NULL — 수수료 계산 기준이 된 전환 총액.
  • fee_rate_bps — INTEGER — NOT NULL — 거래 당시 적용 비율의 스냅샷.
  • fixed_fee_amount — BIGINT — NOT NULL — 거래 당시 건당 고정 수수료 스냅샷.
  • rounding_rule — fee_rounding_rule — NOT NULL — 거래 당시 수수료 원 단위 처리 규칙.
  • percentage_fee_amount — BIGINT — NOT NULL — 비율에 따라 계산된 수수료.
  • total_fee_amount — BIGINT — NOT NULL — 비율 수수료와 고정 수수료를 합한 최종 건별 수수료.
  • status — fee_accrual_status — NOT NULL — 미정산·정산 포함·지급 완료·취소 상태.
  • accrued_at — TIMESTAMPTZ — NOT NULL — 수수료가 확정 발생한 시각.
  • settled_at — TIMESTAMPTZ — 업체 정산 지급 완료에 포함된 시각.
  • cancelled_at — TIMESTAMPTZ — 전환 역처리 등으로 수수료를 취소한 시각.
  • cancel_reason — VARCHAR(500) — 수수료 취소 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 수수료 발생 행 생성 시각.

partner_fee_policies

  • id — UUID — Primary key — NOT NULL — 수수료 정책 식별자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 정책 대상 업체.
  • fee_target — partner_fee_target — NOT NULL — CHARGE·REDEEM·ALL_EXCHANGE 중 적용 방향.
  • fee_rate_bps — INTEGER — NOT NULL — 비율 수수료를 Basis Point로 저장. 0.7%는 70.
  • fixed_fee_amount — BIGINT — NOT NULL — 전환 완료 한 건당 추가되는 고정 수수료 원화 금액.
  • rounding_rule — fee_rounding_rule — NOT NULL — 비율 수수료의 원 단위 절사·반올림·올림 규칙.
  • settlement_cycle — settlement_cycle — NOT NULL — 주간·월간·수동 정산 주기.
  • payment_due_days — SMALLINT — NOT NULL — 정산 기간 종료 후 업체 지급 기한까지의 일수.
  • effective_from — TIMESTAMPTZ — NOT NULL — 정책 적용 시작 시각.
  • effective_to — TIMESTAMPTZ — 정책 적용 종료 시각.
  • is_active — BOOLEAN — NOT NULL — 신규 완료 전환에 적용 가능한 정책인지 여부.
  • created_by_user_id — UUID — Foreign key → users.id — NOT NULL — 정책 등록 관리자.
  • created_at — TIMESTAMPTZ — NOT NULL — 정책 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 정책 설명·기간 수정 시각.

partner_link_sessions

  • id — UUID — Primary key — NOT NULL — SDK 사용자 연결 세션 식별자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 연결 대상 업체.
  • partner_client_id — UUID — Foreign key → partner_clients.id — NOT NULL — 연결 세션을 생성한 SDK 또는 서버 Client.
  • partner_request_id — VARCHAR(150) — NOT NULL — 업체 서버가 생성한 연결 요청 식별자.
  • partner_user_key — VARCHAR(255) — NOT NULL — 업체 내부의 불변 사용자 PK.
  • partner_user_display_name — VARCHAR(100) — 사용자 동의 화면에 표시할 업체 사용자명.
  • session_token_hash — VARCHAR(255) — NOT NULL — 브라우저에 전달한 일회성 세션 토큰의 해시.
  • status — partner_link_session_status — NOT NULL — 생성·Brit 인증·연결 완료·취소·만료 상태.
  • authenticated_user_id — UUID — Foreign key → users.id — SDK 안에서 로그인한 Brit 사용자.
  • linked_user_partner_link_id — UUID — Foreign key → user_partner_links.id — 완료 후 생성 또는 확인된 user_partner_links ID.
  • expires_at — TIMESTAMPTZ — NOT NULL — 연결 세션 만료 시각.
  • authenticated_at — TIMESTAMPTZ — Brit 사용자 인증 완료 시각.
  • linked_at — TIMESTAMPTZ — 영구 연결 완료 시각.
  • cancelled_at — TIMESTAMPTZ — 사용자 또는 업체가 연결을 취소한 시각.
  • cancel_reason — VARCHAR(500) — 취소 또는 실패 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 연결 세션 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 세션 상태 최종 수정 시각.

partner_members

  • id — UUID — Primary key — NOT NULL — 업체 담당자 소속 이력 식별자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 소속 업체.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 업체 업무를 수행하는 Brit 사용자.
  • role — partner_member_role — NOT NULL — 업체 범위 OWNER·ADMIN·OPERATOR·DEVELOPER·VIEWER 권한.
  • status — partner_member_status — NOT NULL — 초대·활성·정지·제거 상태.
  • invited_by_user_id — UUID — Foreign key → users.id — 담당자를 초대한 사용자 또는 Brit 관리자.
  • invited_at — TIMESTAMPTZ — NOT NULL — 초대 시각.
  • joined_at — TIMESTAMPTZ — 사용자가 초대를 수락한 시각.
  • suspended_at — TIMESTAMPTZ — 업체 권한 정지 시각.
  • removed_at — TIMESTAMPTZ — 업체 소속 제거 시각.
  • removed_by_user_id — UUID — Foreign key → users.id — 소속 제거 관리자.
  • remove_reason — VARCHAR(500) — 소속 제거 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 소속 이력 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 소속 상태 최종 수정 시각.

partner_settlement_items

  • settlement_id — UUID — Foreign key → partner_settlements.id — NOT NULL — 정산서.
  • fee_accrual_id — UUID — Foreign key → partner_fee_accruals.id — NOT NULL — 정산에 포함한 건별 수수료.
  • partner_id — UUID — Foreign key → partner_fee_accruals.partner_id — NOT NULL — 정산서와 수수료 발생 업체의 일치 검증용 업체 ID.
  • included_fee_amount — BIGINT — NOT NULL — 이 정산에 포함한 건별 수수료 금액.
  • created_at — TIMESTAMPTZ — NOT NULL — 정산 포함 시각.

partner_settlements

  • id — UUID — Primary key — NOT NULL — 업체 정산서 식별자.
  • settlement_number — VARCHAR(40) — NOT NULL — 운영자와 업체가 조회하는 정산서 번호.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 정산 대상 업체.
  • period_start — DATE — NOT NULL — 정산 포함 기간 시작일.
  • period_end — DATE — NOT NULL — 정산 포함 기간 종료일.
  • exchange_count — INTEGER — NOT NULL — 정산에 포함된 완료 전환 건수.
  • gross_amount — BIGINT — NOT NULL — 포함 전환의 기준금액 합계.
  • percentage_fee_amount — BIGINT — NOT NULL — 비율 수수료 합계.
  • fixed_fee_amount — BIGINT — NOT NULL — 고정 수수료 합계.
  • adjustment_amount — BIGINT — NOT NULL — 이전 기간 취소·오류·계약 보정 등 추가 또는 차감 조정액.
  • final_payable_amount — BIGINT — NOT NULL — 업체가 Brit에 실제 지급할 최종 정산금.
  • status — partner_settlement_status — NOT NULL — 초안·확정·청구·지급 완료·연체·취소 상태.
  • due_date — DATE — 업체 지급 기한.
  • confirmed_at — TIMESTAMPTZ — 정산 포함 항목과 금액을 확정한 시각.
  • confirmed_by_user_id — UUID — Foreign key → users.id — 정산 확정 관리자.
  • invoiced_at — TIMESTAMPTZ — 업체에 청구서를 전달한 시각.
  • paid_amount — BIGINT — 업체로부터 실제 확인한 지급액.
  • payment_reference — VARCHAR(150) — 입금 거래번호·세금계산서·회계 문서 참조번호.
  • paid_at — TIMESTAMPTZ — 업체 지급 확인 시각.
  • paid_by_user_id — UUID — Foreign key → users.id — 입금 확인 관리자.
  • cancelled_at — TIMESTAMPTZ — 정산서 취소 시각.
  • cancel_reason — VARCHAR(500) — 정산서 취소 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 정산서 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 정산서 현재값 최종 수정 시각.

partners

  • id — UUID — Primary key — NOT NULL — 업체 식별자.
  • code — VARCHAR(30) — NOT NULL — SDK·운영 화면에서 사용하는 공개 업체 코드.
  • name — VARCHAR(100) — NOT NULL — 계약·정산 기준의 업체 법인명.
  • display_name — VARCHAR(100) — NOT NULL — 사용자 화면에 노출할 업체명.
  • status — partner_status — NOT NULL — 가입 대기·활성·정지·종료 상태.
  • business_registration_number_encrypted — BYTEA — 사업자등록번호 암호문.
  • business_registration_number_hash — CHAR(64) — 업체 중복 등록 확인용 HMAC 결과.
  • business_registration_number_masked — VARCHAR(20) — 관리 화면 표시용 마스킹 사업자번호.
  • representative_name — VARCHAR(50) — 대표자명.
  • contact_name — VARCHAR(50) — 운영·연동 담당자명.
  • contact_phone — VARCHAR(20) — 담당자 연락처.
  • contact_email — VARCHAR(255) — 담당자 이메일.
  • logo_path — TEXT — 업체 로고 스토리지 경로.
  • approved_at — TIMESTAMPTZ — 업체 활성 승인 시각.
  • approved_by_user_id — UUID — Foreign key → users.id — 업체 승인 관리자.
  • suspended_at — TIMESTAMPTZ — 업체 연동 정지 시각.
  • suspended_reason — VARCHAR(500) — 업체 정지 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 업체 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 업체 정보 최종 수정 시각.

sell_order_coin_lots

  • sell_order_id — UUID — Foreign key → sell_orders.id — NOT NULL — 판매 주문.
  • coin_lot_id — UUID — Foreign key → user_coin_lots.id — NOT NULL — 판매 주문에 잠근 판매 가능 Coin 묶음.
  • locked_amount — BIGINT — NOT NULL — 판매 주문 생성 시 이 묶음에서 잠근 수량.
  • completed_amount — BIGINT — NOT NULL — 완료 거래를 통해 실제 판매된 수량.
  • released_amount — BIGINT — NOT NULL — 주문 취소·만료로 사용자에게 반환한 수량.
  • created_at — TIMESTAMPTZ — NOT NULL — 잠금 배정 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 완료 또는 반환 수량 최종 변경 시각.

sell_orders

  • id — UUID — Primary key — NOT NULL — 판매 주문 식별자.
  • order_number — VARCHAR(40) — NOT NULL — 사용자·관리자 표시 판매 주문번호.
  • seller_user_id — UUID — Foreign key → users.id — NOT NULL — 판매자. 업체 담당자도 Coin을 개인 지갑으로 지급받은 후 동일하게 참여한다.
  • matching_policy_id — UUID — Foreign key → matching_policies.id — NOT NULL — 주문 생성 당시 적용 정책 원본.
  • original_coin_amount — BIGINT — NOT NULL — 최초 등록 전체 판매량.
  • remaining_coin_amount — BIGINT — NOT NULL — 새 구매 주문과 매칭 가능한 미예약 잔량.
  • reserved_coin_amount — BIGINT — NOT NULL — 진행 중 거래에 배정된 수량.
  • completed_coin_amount — BIGINT — NOT NULL — 정상 완료되어 구매자에게 이전된 수량.
  • minimum_partial_match_rate — NUMERIC(5,4) — NOT NULL — 주문 생성 시 복사한 최소 분할 비율.
  • minimum_trade_amount — BIGINT — NOT NULL — 비율·절대 최소액·단위를 반영한 실제 최소 체결량.
  • status — sell_order_status — NOT NULL — 대기·부분 매칭·전량 예약·완료·취소·만료 상태.
  • idempotency_key — VARCHAR(150) — NOT NULL — 동일 판매 주문 중복 등록 방지 키.
  • expires_at — TIMESTAMPTZ — 미체결 잔량 자동 만료 시각.
  • completed_at — TIMESTAMPTZ — 전체 판매 완료 시각.
  • cancelled_at — TIMESTAMPTZ — 미체결 잔량 취소 시각.
  • cancel_reason — VARCHAR(500) — 취소 또는 만료 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 판매 주문 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 수량·상태 최종 수정 시각.

trade_coin_lots

  • trade_id — UUID — Foreign key → trades.id — NOT NULL — Coin을 사용하는 실제 거래.
  • coin_lot_id — UUID — Foreign key → user_coin_lots.id — NOT NULL — 판매자의 원본 Coin 묶음.
  • allocated_amount — BIGINT — NOT NULL — 매칭 시 이 거래에 예약한 수량.
  • transferred_amount — BIGINT — NOT NULL — 거래 완료로 구매자에게 이전한 수량.
  • released_amount — BIGINT — NOT NULL — 취소·만료·분쟁 취소로 판매 주문에 반환한 수량.
  • created_at — TIMESTAMPTZ — NOT NULL — 거래별 묶음 배정 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 이전 또는 반환 수량 최종 변경 시각.

trade_disputes

  • id — UUID — Primary key — NOT NULL — 분쟁 업무 식별자.
  • dispute_number — VARCHAR(40) — NOT NULL — 사용자·관리자 표시 분쟁번호.
  • trade_id — UUID — Foreign key → trades.id — NOT NULL — 분쟁 대상 거래.
  • requested_by_user_id — UUID — Foreign key → users.id — NOT NULL — 분쟁 신청 구매자 또는 판매자.
  • reason_code — VARCHAR(50) — NOT NULL — SELLER_NO_CONFIRMATION·PAYMENT_NOT_FOUND 등 표준 사유.
  • description — TEXT — 신청자가 작성한 상세 설명.
  • priority — trade_dispute_priority — NOT NULL — 자산 위험과 지연시간에 따른 처리 우선순위.
  • status — trade_dispute_status — NOT NULL — 접수·검토·증빙 대기·응답 대기·해결·취소 상태.
  • assigned_admin_user_id — UUID — Foreign key → users.id — 현재 담당 관리자.
  • assigned_at — TIMESTAMPTZ — 관리자 배정 시각.
  • resolution_type — trade_dispute_resolution — 강제 완료·강제 취소·철회·판매자 확인·기각 중 최종 결과.
  • resolution_reason — TEXT — 관리자 판단 근거와 사용자 안내 내용.
  • resolved_by_user_id — UUID — Foreign key → users.id — 최종 해결 관리자.
  • requested_at — TIMESTAMPTZ — NOT NULL — 분쟁 접수 시각.
  • resolved_at — TIMESTAMPTZ — 분쟁 해결 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 분쟁 행 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 담당자·상태·결과 최종 수정 시각.

trade_events

  • id — UUID — Primary key — NOT NULL — 거래 이벤트 식별자.
  • trade_id — UUID — Foreign key → trades.id — NOT NULL — 대상 거래.
  • previous_status — trade_status — 이벤트 직전 상태. 최초 생성은 NULL 가능.
  • new_status — trade_status — NOT NULL — 이벤트 반영 후 상태.
  • actor_type — VARCHAR(30) — NOT NULL — BUYER·SELLER·ADMIN·SYSTEM 중 행위 주체 종류.
  • actor_user_id — UUID — Foreign key → users.id — 구매자·판매자·관리자 행위자.
  • event_code — VARCHAR(100) — NOT NULL — BUYER_REPORTED_PAID·SELLER_CONFIRMED·TIMEOUT 등의 표준 코드.
  • reason — VARCHAR(500) — 취소·시간초과·강제 처리 사유.
  • metadata — JSONB — NOT NULL — 증빙 ID·기한 계산값 등 비핵심 부가정보.
  • created_at — TIMESTAMPTZ — NOT NULL — 이벤트 발생 시각.

trades

  • id — UUID — Primary key — NOT NULL — 실제 거래 식별자.
  • trade_number — VARCHAR(40) — NOT NULL — 사용자·관리자 표시 거래번호.
  • buy_order_id — UUID — Foreign key → buy_orders.id — NOT NULL — 원본 구매 주문. 실패 후 같은 주문에 새 거래가 생길 수 있다.
  • sell_order_id — UUID — Foreign key → sell_orders.id — NOT NULL — 거래 Coin을 제공하는 판매 주문.
  • trade_attempt_no — SMALLINT — NOT NULL — 동일 구매 주문에서 몇 번째 거래 시도인지 나타낸다.
  • buyer_user_id — UUID — Foreign key → users.id — NOT NULL — 구매자.
  • seller_user_id — UUID — Foreign key → users.id — NOT NULL — 판매자.
  • seller_bank_account_id — UUID — Foreign key → user_bank_accounts.id — NOT NULL — 매칭 당시 사용한 판매자의 승인 계좌 행.
  • seller_bank_code — VARCHAR(20) — NOT NULL — 거래 당시 은행 코드 스냅샷.
  • seller_bank_name — VARCHAR(50) — NOT NULL — 거래 당시 은행명 스냅샷.
  • seller_account_number_encrypted — BYTEA — NOT NULL — 구매자 입금 안내용 거래 당시 계좌번호 암호문.
  • seller_account_number_masked — VARCHAR(50) — NOT NULL — 목록·분쟁 화면용 거래 당시 마스킹 계좌번호.
  • seller_account_holder_name — VARCHAR(50) — NOT NULL — 거래 당시 예금주명.
  • coin_amount — BIGINT — NOT NULL — 이 거래가 이전할 Coin 수량.
  • total_payment_amount — BIGINT — NOT NULL — 구매자가 판매자에게 입금할 원화 금액. MVP에서는 Coin 수량과 동일.
  • status — trade_status — NOT NULL — 입금 대기부터 완료·취소·만료·분쟁까지 현재 상태.
  • buyer_payment_deadline_at — TIMESTAMPTZ — NOT NULL — 구매자 입금 완료 선언 마감 시각.
  • seller_confirmation_deadline_at — TIMESTAMPTZ — 구매자 입금 선언 후 판매자 확인 마감 시각.
  • additional_confirmation_deadline_at — TIMESTAMPTZ — 추가 확인 단계 마감 시각.
  • buyer_reported_paid_at — TIMESTAMPTZ — 구매자가 입금을 완료했다고 선언한 시각.
  • seller_confirmed_at — TIMESTAMPTZ — 판매자가 실제 계좌 입금을 확인한 시각.
  • coin_transferred_at — TIMESTAMPTZ — 판매자 Coin이 구매자 소유로 이전된 시각.
  • completed_at — TIMESTAMPTZ — 정상 완료 시각.
  • cancelled_at — TIMESTAMPTZ — 취소 또는 만료 종료 시각.
  • cancel_reason — VARCHAR(500) — 취소·만료·관리자 강제 종료 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 거래 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 거래 현재 상태 최종 수정 시각.

user_approval_reviews

  • id — UUID — Primary key — NOT NULL — 가입 심사 이력 식별자.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 심사 대상 사용자.
  • bank_account_id — UUID — Foreign key → user_bank_accounts.id — NOT NULL — 가입과 함께 심사한 사용자 계좌.
  • decision — approval_decision — NOT NULL — 승인 또는 반려 결정.
  • identity_checked — BOOLEAN — NOT NULL — 이름과 주민등록번호를 관리자가 확인했는지 여부.
  • phone_checked — BOOLEAN — NOT NULL — 제출 전화번호를 관리자가 확인했는지 여부.
  • bank_account_checked — BOOLEAN — NOT NULL — 은행과 계좌정보를 확인했는지 여부.
  • holder_name_matched — BOOLEAN — NOT NULL — 예금주와 사용자 실명이 일치하는지 확인한 결과.
  • reviewed_by_user_id — UUID — Foreign key → users.id — NOT NULL — 심사를 수행한 관리자.
  • review_reason — VARCHAR(500) — 승인 근거 또는 사용자에게 안내할 반려 사유.
  • reviewed_at — TIMESTAMPTZ — NOT NULL — 관리자가 결정을 확정한 시각.

user_bank_account_reviews

  • id — UUID — Primary key — NOT NULL — 계좌 심사 이력 식별자.
  • bank_account_id — UUID — Foreign key → user_bank_accounts.id — NOT NULL — 심사 대상 계좌.
  • user_id — UUID — Foreign key → user_bank_accounts.user_id — NOT NULL — 계좌 소유 사용자. 복합 FK로 계좌 소유자를 보장한다.
  • previous_status — bank_account_status — NOT NULL — 관리자 처리 직전 상태.
  • decision — bank_account_review_decision — NOT NULL — 승인·반려·정지·재활성·교체·종료 조치.
  • resulting_status — bank_account_status — NOT NULL — 처리 후 상태.
  • reviewed_by_user_id — UUID — Foreign key → users.id — NOT NULL — 계좌 조치를 수행한 관리자.
  • review_reason — VARCHAR(500) — 처리 근거 또는 사용자 안내 사유.
  • reviewed_at — TIMESTAMPTZ — NOT NULL — 처리 확정 시각.

user_bank_accounts

  • id — UUID — Primary key — NOT NULL — 계좌 이력 식별자.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 계좌 소유 사용자.
  • bank_code — VARCHAR(20) — Foreign key → banks.code — NOT NULL — 은행 코드.
  • account_number_encrypted — BYTEA — NOT NULL — 전체 계좌번호 암호문.
  • account_number_hash — CHAR(64) — NOT NULL — 동일 계좌 중복 등록 검색용 HMAC 결과.
  • account_number_masked — VARCHAR(50) — NOT NULL — 목록·로그 표시용 마스킹 계좌번호.
  • holder_name — VARCHAR(50) — NOT NULL — 사용자가 제출한 예금주명. 관리자 승인 전에는 검증된 정보가 아니다.
  • status — bank_account_status — NOT NULL — 심사 대기·활성·정지·교체 예정·종료·반려 상태.
  • replaces_bank_account_id — UUID — Foreign key → user_bank_accounts.id — 계좌 변경 시 이 행이 대체하는 기존 계좌.
  • requested_at — TIMESTAMPTZ — NOT NULL — 등록 또는 변경 신청 시각.
  • reviewed_at — TIMESTAMPTZ — 최근 심사 시각.
  • reviewed_by_user_id — UUID — Foreign key → users.id — 최근 심사 관리자.
  • rejection_reason — VARCHAR(500) — 현재 반려 상태의 사유.
  • activated_at — TIMESTAMPTZ — 입금 계좌로 활성화된 시각.
  • suspended_at — TIMESTAMPTZ — 사용 정지 시각.
  • retired_at — TIMESTAMPTZ — 신규 거래에는 사용하지 않고 기존 거래 확인만 유지하기 시작한 시각.
  • closed_at — TIMESTAMPTZ — 모든 기존 거래 종료 후 계좌를 최종 종료한 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 계좌 행 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 계좌 현재값 최종 수정 시각.

user_coin_lots

  • id — UUID — Primary key — NOT NULL — 사용자 Coin 묶음 식별자.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 현재 Coin 소유 사용자.
  • source_type — coin_source_type — NOT NULL — Brit 구매·업체 REDEEM·업체 관리자 지급·P2P 구매·환불·관리자 조정 중 생성 출처.
  • source_id — UUID — Coin을 생성한 구매·업체 전환·업체 지급·거래·환불 업무 ID.
  • original_amount — BIGINT — NOT NULL — 묶음 최초 생성 수량.
  • remaining_amount — BIGINT — NOT NULL — 아직 잠그거나 사용할 수 있는 수량.
  • locked_amount — BIGINT — NOT NULL — 판매 주문·거래·업체 충전에 배정되어 잠긴 수량.
  • consumed_amount — BIGINT — NOT NULL — P2P 이전 또는 업체 충전 완료로 최종 소비된 수량.
  • cancelled_amount — BIGINT — NOT NULL — 원본 업무 취소·역처리로 무효화된 수량.
  • is_sellable — BOOLEAN — NOT NULL — P2P 판매 주문에 사용할 수 있는 묶음인지 여부.
  • status — coin_lot_status — NOT NULL — 묶음의 현재 사용 상태.
  • available_at — TIMESTAMPTZ — 사용 가능 상태가 된 시각.
  • consumed_at — TIMESTAMPTZ — 전량 소비된 시각.
  • cancelled_at — TIMESTAMPTZ — 잔여분이 취소된 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 묶음 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 수량·상태 최종 변경 시각.

user_coin_wallets

  • user_id — UUID — Foreign key → users.id — NOT NULL — 지갑 소유 사용자.
  • non_sellable_balance — BIGINT — NOT NULL — 업체 충전에는 사용할 수 있지만 P2P 판매는 불가능한 사용 가능 Coin.
  • sellable_balance — BIGINT — NOT NULL — P2P 판매 또는 업체 충전에 사용할 수 있는 사용 가능 Coin.
  • locked_non_sellable_balance — BIGINT — NOT NULL — 업체 충전 처리 중 잠긴 판매 불가 Coin.
  • locked_sellable_balance — BIGINT — NOT NULL — 판매 주문·업체 충전 처리 중 잠긴 판매 가능 Coin.
  • pending_sellable_balance — BIGINT — NOT NULL — 업체 REDEEM 성공 확정 전 대기 중인 판매 가능 예정 Coin.
  • status — coin_wallet_status — NOT NULL — 지갑 활성·정지·종료 상태.
  • version — BIGINT — NOT NULL — 낙관적 잠금과 동시 갱신 충돌 감지 버전.
  • suspended_at — TIMESTAMPTZ — 지갑 정지 시각.
  • suspended_reason — VARCHAR(500) — 지갑 정지 사유.
  • closed_at — TIMESTAMPTZ — 지갑 종료 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 지갑 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 잔액 또는 상태 최종 변경 시각.

user_consents

  • id — UUID — Primary key — NOT NULL — 동의 이력 식별자.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 동의 사용자.
  • consent_type — VARCHAR(30) — NOT NULL — SERVICE·PRIVACY·UNIQUE_IDENTIFIER·BANK_ACCOUNT·MARKETING 중 동의 종류.
  • document_version — VARCHAR(30) — NOT NULL — 가입 당시 노출된 약관 또는 정책 문서 버전.
  • is_agreed — BOOLEAN — NOT NULL — 동의 여부.
  • agreed_at — TIMESTAMPTZ — 동의를 확정한 시각.
  • revoked_at — TIMESTAMPTZ — 선택 동의를 철회한 시각.
  • evidence — JSONB — NOT NULL — 동의 화면 버전, IP, User-Agent 등 증빙용 부가정보.
  • created_at — TIMESTAMPTZ — NOT NULL — 동의 이력 생성 시각.

user_partner_links

  • id — UUID — Primary key — NOT NULL — 사용자-업체 연결 식별자.
  • user_id — UUID — Foreign key → users.id — NOT NULL — Brit 사용자.
  • partner_id — UUID — Foreign key → partners.id — NOT NULL — 연결 대상 업체.
  • partner_user_key — VARCHAR(255) — NOT NULL — 업체 내부에서 변하지 않는 사용자 PK.
  • partner_user_display_name — VARCHAR(100) — 연결 확인 화면 표시명.
  • status — user_partner_link_status — NOT NULL — 연결 대기·활성·정지·해제 상태.
  • linked_at — TIMESTAMPTZ — 사용자 동의 후 연결 완료 시각.
  • suspended_at — TIMESTAMPTZ — 연결 정지 시각.
  • unlinked_at — TIMESTAMPTZ — 연결 해제 시각.
  • created_by_client_id — UUID — Foreign key → partner_clients.id — 연결 절차를 시작한 Client.
  • created_at — TIMESTAMPTZ — NOT NULL — 연결 요청 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 연결 상태 최종 수정 시각.

user_profiles

  • user_id — UUID — Foreign key → users.id — NOT NULL — users.id와 동일한 사용자 식별자.
  • name — VARCHAR(50) — NOT NULL — 가입 신청자가 제출한 실명.
  • resident_registration_number_encrypted — BYTEA — NOT NULL — 전체 주민등록번호의 암호문. 평문을 저장하지 않는다.
  • resident_registration_number_hash — CHAR(64) — NOT NULL — 중복 가입 검색을 위한 HMAC-SHA-256 결과.
  • resident_registration_number_masked — CHAR(14) — NOT NULL — 관리자 목록 표시용 마스킹 값. 예: 900101-1******.
  • birth_date — DATE — NOT NULL — 주민등록번호에서 서버가 파생한 생년월일.
  • gender_code — CHAR(1) — NOT NULL — 주민등록번호에서 서버가 파생한 성별 코드.
  • mobile_carrier — VARCHAR(20) — NOT NULL — 가입 신청자가 선택한 통신사. 외부 인증 결과가 아니다.
  • nickname — VARCHAR(30) — 서비스 화면에 표시할 선택 닉네임.
  • pin_hash — VARCHAR(255) — NOT NULL — 거래 승인에 사용하는 숫자 PIN의 단방향 해시.
  • pin_failed_count — SMALLINT — NOT NULL — 연속 PIN 검증 실패 횟수.
  • pin_locked_until — TIMESTAMPTZ — PIN 검증이 잠긴 종료 시각.
  • pin_changed_at — TIMESTAMPTZ — NOT NULL — PIN을 마지막으로 변경한 시각.
  • profile_image_path — TEXT — 프로필 이미지의 스토리지 객체 경로.
  • profile_image_updated_at — TIMESTAMPTZ — 프로필 이미지 변경 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 프로필 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 프로필 최종 수정 시각.

user_roles

  • id — UUID — Primary key — NOT NULL — 역할 부여 이력 식별자.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 역할 대상 사용자.
  • role — user_role — NOT NULL — USER·ADMIN·SYS_ADMIN 중 하나의 전역 역할.
  • status — role_grant_status — NOT NULL — 현재 역할 부여의 활성 또는 회수 상태.
  • granted_by_user_id — UUID — Foreign key → users.id — 역할 부여자. 가입 시 기본 USER는 시스템 처리로 NULL 가능.
  • granted_at — TIMESTAMPTZ — NOT NULL — 역할 부여 시각.
  • revoked_by_user_id — UUID — Foreign key → users.id — 역할 회수 관리자.
  • revoked_at — TIMESTAMPTZ — 역할 회수 시각.
  • revoke_reason — VARCHAR(500) — 역할 회수 사유.

user_sessions

  • id — UUID — Primary key — NOT NULL — 로그인 세션 식별자.
  • user_id — UUID — Foreign key → users.id — NOT NULL — 로그인 사용자.
  • refresh_token_hash — VARCHAR(255) — NOT NULL — Refresh Token 원문의 단방향 해시.
  • device_id — VARCHAR(100) — 브라우저 또는 앱이 생성한 기기 식별값.
  • device_name — VARCHAR(100) — 사용자 세션 목록에 표시하는 기기명.
  • user_agent — TEXT — 브라우저·앱 User-Agent.
  • ip_address — INET — 로그인 또는 토큰 갱신 IP.
  • status — session_status — NOT NULL — 세션 활성·폐기·만료 상태.
  • expires_at — TIMESTAMPTZ — NOT NULL — Refresh 세션 만료 시각.
  • last_used_at — TIMESTAMPTZ — 가장 최근 Refresh Token 사용 시각.
  • revoked_at — TIMESTAMPTZ — 로그아웃·비밀번호 변경·관리자 조치로 폐기한 시각.
  • revoke_reason — VARCHAR(255) — 세션 폐기 사유.
  • created_at — TIMESTAMPTZ — NOT NULL — 세션 생성 시각.

users

  • id — UUID — Primary key — NOT NULL — 모든 사용자 업무 데이터가 참조하는 사용자 식별자.
  • login_id — VARCHAR(30) — NOT NULL — 사용자가 입력하는 로그인 ID. 저장 전 서버에서 소문자 등 정규화한다.
  • password_hash — VARCHAR(255) — NOT NULL — Argon2id 또는 bcrypt로 단방향 해시한 로그인 비밀번호.
  • phone_e164 — VARCHAR(20) — NOT NULL — 가입 신청자가 제출한 휴대전화 번호의 E.164 정규화 값. 관리자 승인 전에는 인증된 번호가 아니다.
  • status — user_status — NOT NULL — 가입 대기·활성·정지·탈퇴·반려의 현재 상태.
  • registration_submitted_at — TIMESTAMPTZ — NOT NULL — 가입 정보 전체가 제출된 시각.
  • approved_at — TIMESTAMPTZ — 가장 최근 관리자 승인 시각.
  • approved_by_user_id — UUID — Foreign key → users.id — 가장 최근 가입 승인을 수행한 관리자.
  • rejected_at — TIMESTAMPTZ — 가장 최근 가입 반려 시각.
  • rejection_reason — VARCHAR(500) — 현재 반려 상태의 사용자에게 안내하는 사유.
  • last_login_at — TIMESTAMPTZ — 가장 최근 정상 로그인 성공 시각.
  • password_changed_at — TIMESTAMPTZ — NOT NULL — 비밀번호를 마지막으로 변경한 시각.
  • withdrawn_at — TIMESTAMPTZ — 탈퇴 처리 시각.
  • created_at — TIMESTAMPTZ — NOT NULL — 사용자 행 생성 시각.
  • updated_at — TIMESTAMPTZ — NOT NULL — 사용자 현재값 최종 수정 시각.