money_town-erd

테이블 (26)

AI 포트폴리오 (p_ai_portfolios)

  • AI 포트폴리오 ID (ai_portfolio_id) — UUID — 기본 키 — NOT NULL — AI 포트폴리오 ID
  • 멱등성 키 (idempotency_key) — UUID — NOT NULL — 멱등성 키 / 동일 요청 중복 처리 방지
  • 사용자 ID (user_id) — UUID — NOT NULL — 사용자 ID
  • 투자 가능 금액 (investment_amount) — BIGINT — NOT NULL — 투자 가능 금액 / 원 단위
  • 투자 성향 (risk_type) — VARCHAR(20) — NOT NULL — 투자 성향 / CONSERVATIVE, BALANCED, AGGRESSIVE
  • 선호 자산 유형 (preferred_asset_type) — VARCHAR(30) — 선호 자산 유형
  • 슬랙 ID (slack_id) — VARCHAR(100) — NOT NULL — 생성 완료 시 연락 받을 슬랙 ID
  • AI 처리 상태 (status) — VARCHAR(20) — NOT NULL — AI 처리 상태 / PENDING, PROCESSING, COMPLETED, FAILED
  • AI 응답 (response) — JSONB — AI 응답 / 구조화된 포트폴리오 결과
  • 실패 원인 (error_message) — TEXT — 실패 원인
  • AI 모델 (model) — VARCHAR(100) — AI 모델
  • 프롬프트 버전 (prompt_version) — VARCHAR(30) — 프롬프트 버전
  • 처리 시간 (processing_time_ms) — BIGINT — 처리 시간(ms)
  • 처리 완료 시각 (completed_at) — TIMESTAMPTZ — 처리 완료 시각
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 생성 시각
  • 생성자 (created_by) — UUID — 생성자
  • 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL — 수정 시각
  • 수정자 (updated_by) — UUID — 수정자
  • 삭제 시각 (deleted_at) — TIMESTAMPTZ — 삭제 시각
  • 삭제자 (deleted_by) — UUID — 삭제자
  • 삭제여부 (is_deleted) — BOOLEAN — NOT NULL

FDS 탐지 로그 (p_fds_detection_logs)

  • FDS 탐지 로그 ID (fds_detection_log_id) — UUID — 기본 키 — NOT NULL — FDS 탐지 로그 ID
  • 요청 ID (request_id) — UUID — 요청 ID / Pre-FDS HTTP 요청 식별자
  • 이벤트 ID (event_id) — UUID — 이벤트 ID / Post-FDS Kafka 이벤트 식별자
  • 사용자 ID (user_id) — UUID — NOT NULL — 사용자 ID
  • 자산 ID (asset_id) — UUID — 자산 ID
  • 탐지 구분 (detection_type) — VARCHAR(10) — NOT NULL — 탐지 구분 / PRE, POST
  • 이벤트 유형 (event_type) — VARCHAR(50) — NOT NULL — 이벤트 유형
  • 탐지 규칙 코드 (rule_code) — VARCHAR(50) — NOT NULL — 탐지 규칙 코드
  • 관측값 (observed_value) — INTEGER — NOT NULL — 관측값 / 탐지 당시 실제 측정값
  • 임계값 (threshold_value) — INTEGER — NOT NULL — 임계값 / 탐지 당시 적용된 기준값
  • 발생 시각 (occurred_at) — TIMESTAMPTZ — NOT NULL — 발생 시각
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 생성 시각
  • 생성자 (created_by) — UUID — 생성자

KYC (p_kyc_verifications)

  • KYC 심사 ID (kyc_verification_id) — UUID — 기본 키 — NOT NULL — KYC 신청 건의 고유 식별자
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자.사용자 ID — NOT NULL — KYC 신청 사용자 ID. p_users.user_id 참조. 사용자는 여러 번 KYC를 신청할 수 있음
  • 직업 유형 (occupation_type) — VARCHAR(30) — NOT NULL — 신청자가 선택한 직업 유형
  • 투자 목적 (fund_source) — VARCHAR(30) — NOT NULL — 투자 자금의 주요 출처
  • 국내 거주 여부 (domestic_resident) — BOOLEAN — NOT NULL — 국내 거주 여부, Mock KYC 심사 조건에 사용
  • 동의 약관 버전 (consent_version) — VARCHAR(20) — NOT NULL — 사용자가 동이한 KYC 정보 수집 약관 버전
  • KYC 동의 시각 (consented_at) — TIMESTAMPTZ — NOT NULL — KYC 정보 수집 및 심사 동의 시각
  • KYC 심사 상태 (status) — VARCHAR(30) — NOT NULL — PENDING / VERIFIED / REJECTED / EXPIRED. 신청 시 PENDING으로 시작
  • 신청 회차 (attempt_no) — INT — NOT NULL — 사용자별 KYC 신청 회차. 재신청할 때마다 1씩 증가하며 사용자 ID와 신청 회차는 중복 불가
  • KYC 신청 시각 (submitted_at) — TIMESTAMPTZ — NOT NULL — 사용자가 KYC 심사를 신청한 시각
  • 심사 완료 시각 (reviewed_at) — TIMESTAMPTZ — 관리자가 승인 또는 거절한 시각. 심사 전에는 NULL
  • 심사 관리자 ID (reviewed_by) — UUID — 외래 키 — KYC 심사를 처리한 ADMIN 사용자 ID. p_users.user_id 참조
  • 심사 거절 사유 (rejection_reason) — VARCHAR(500) — 심사 상태가 REJECTED인 경우 필수로 기록
  • 인증 완료 시각 (verified_at) — TIMESTAMPTZ — 심사 상태가 VERIFIED로 변경될 때 기록
  • 인증 만료 시각 (expires_at) — TIMESTAMPTZ — KYC 인증 유효기간 만료 시각. 만료되면 EXPIRED 상태로 변경
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — KYC 신청 레코드가 최초 생성된 시각
  • 생성자 ID (created_by) — UUID — NOT NULL — 일반 신청은 신청 사용자 ID, 시스템 생성은 약속된 SYSTEM ID 저장
  • 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL — KYC 심사 정보가 최종으로 변경된 시각
  • 수정자 ID (updated_by) — UUID — NOT NULL — 신청 시 사용자 ID, 심사 처리 후 관리자 ID 저장

RAG Vector (p_ai_rag_documents)

  • AI RAG 문서 ID (ai_rag_document_id) — UUID — 기본 키 — NOT NULL — AI RAG 문서 ID
  • 자산 ID (asset_id) — UUID — NOT NULL — 자산 ID / Asset Service 논리 참조
  • 문서 유형 (document_type) — VARCHAR(30) — NOT NULL — 문서 유형 / DESCRIPTION, REVENUE, RISK, DIVIDEND
  • 문서 내용 (content) — TEXT — NOT NULL — 문서 내용 / Embedding 및 RAG 검색 대상
  • 메타데이터 (metadata) — JSONB — NOT NULL — 메타데이터 / 자산 유형, 위험등급 등
  • 임베딩 벡터 (embedding) — VECTOR(1536) — NOT NULL — 임베딩 벡터
  • 임베딩 모델 (embedding_model) — VARCHAR(100) — NOT NULL — 임베딩 모델
  • 원본 수정 시각 (source_updated_at) — TIMESTAMPTZ — NOT NULL — 원본 수정 시각 / Asset 원본 데이터 최종 수정 시각
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 생성 시각
  • 생성자 (created_by) — UUID — 생성자
  • 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL — 수정 시각
  • 수정자 (updated_by) — UUID — 수정자
  • 삭제 시각 (deleted_at) — TIMESTAMPTZ — 삭제 시각
  • 삭제자 (deleted_by) — UUID — 삭제자
  • 삭제 여부 (is_deleted) — BOOLEAN — NOT NULL

Slack 알림 이벤트 (p_notifications)

  • 알림 ID (notification_id) — UUID — 기본 키 — NOT NULL — 알림 ID
  • 멱등성 키 (idempotency_key) — UUID — NOT NULL — 멱등성 키 / 동일 알림 이벤트 중복 전송 방지
  • 관련 사용자 ID (user_id) — UUID — 관련 사용자 ID
  • 알림 유형 (notification_type) — VARCHAR(50) — NOT NULL — 알림 유형 / FDS_BLOCKED, SETTLEMENT_FAILED 등
  • 알림 제목 (title) — VARCHAR(200) — NOT NULL — 알림 제목
  • 알림 내용 (message) — TEXT — NOT NULL — 알림 내용 / Slack 전송 메시지
  • 알림 처리 상태 (status) — VARCHAR(20) — NOT NULL — 알림 처리 상태 / PENDING, SENT, FAILED
  • 전송 완료 시각 (sent_at) — TIMESTAMPTZ — 전송 완료 시각
  • 전송 실패 원인 (error_message) — TEXT — 전송 실패 원인
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 생성 시각
  • 생성자 (created_by) — UUID — 생성자
  • 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL — 수정 시각
  • 수정자 (updated_by) — UUID — 수정자
  • 삭제 시각 (deleted_at) — TIMESTAMPTZ — 삭제 시각
  • 삭제자 (deleted_by) — UUID — 삭제자
  • 삭제여부 (is_deleted) — BOOLEAN — NOT NULL

개별 배당 지급 (p_dividend_payouts)

  • 개별 지급 건 id (dividend_payout_id) — UUID — 기본 키 — NOT NULL
  • 지급 대상 투자자id (investor_id) — UUID — NOT NULL
  • 계산 지점 지분율 (share_ratio) — DECIMAL(10,8) — NOT NULL — record_date 스냅샷 값 그대로 고정, 이후 변경 불가
  • 지급 금액(원) (amount) — BIGINT — NOT NULL — 0 이상, 단수 처리 결과 포함
  • 멱등키 (idempotency_key) — VARCHAR(100) — NOT NULL — 지갑 입금 요청 시 중복 지급 방지의 근거 키,UNIQUE
  • 상태 (status) — VARCHAR(20) — NOT NULL
  • 재시도 횟수 (retry_count) — INT — NOT NULL — 최대 재시도 횟수(예: 5회) 초과 시 DEAD_LETTER로 전환
  • 생성시간 (created_at) — TIMESTAMPTZ — NOT NULL
  • 생성자 (created_by) — UUID — NOT NULL
  • 수정시간 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 수정자 (updated_by) — UUID — NOT NULL
  • 삭제시간 (deleted_at) — TIMESTAMPTZ
  • 삭제자 (deleted_by) — UUID
  • 삭제 여부 (is_deleted) — BOOLEAN — NOT NULL
  • 포기 처리 시 지급 방법 (resolution_type) — VARCHAR(20) — BANK_TRANSFER/OTHER. status=ABANDONED일 때만 값이 있음
  • 지급 증빙 번호 (resolution_reference) — VARCHAR(200) — 은행 이체 확인번호 등. 형식 검증만 가능(외부 연동 없음). 포기 처리 시 필수
  • 상세 설명 (resolution_note) — VARCHAR(500) — resolution_type=OTHER이면 필수(애플리케이션 검증)
  • 정산 회차id (settlement_batch_id) — UUID — 외래 키 → 정산 회차.정산 회차id — NOT NULL

공모 상품 테이블 (p_offerings)

  • 공모 ID (offering_id) — UUID — 기본 키 — NOT NULL — 공모 식별자
  • 공모 대상 자산 ID (asset_id) — UUID — NOT NULL — Asset Service 논리 참조. MSA 서비스 간 실제 FK를 사용하지 않음, 공모 소유자
  • 공모 등록 자산운용자 ID (issuer_id) — UUID — NOT NULL — JWT 사용자 ID 사용. User Service 논리 참조
  • 공모 상품명 (title) — VARCHAR(200) — NOT NULL
  • 단위당 청약 가격 (price_per_unit) — BIGINT — NOT NULL — 공모 시점 가격 Snapshot. 0보다 커야 함
  • 총 모집 수량 (total_quantity) — BIGINT — NOT NULL — 해당 공모에서 모집할 전체 수량
  • 잔여 모집 수량 (remaining_quantity) — BIGINT — NOT NULL — 0 이상 total_quantity 이하. 조건부 UPDATE를 이용한 선착순 동시성 제어의 핵심 데이터
  • 투자자 1회 최소 청약 수량 (min_subscription_quantity) — BIGINT — NOT NULL — 기본값 1
  • 투자자 1인 최대 청약 수량 (max_subscription_quantity) — BIGINT — NOT NULL — min_subscription_quantity 이상 total_quantity 이하. 공모별 설정
  • 모집 시작 시각 (start_at) — TIMESTAMPTZ — NOT NULL — start_at < end_at
  • 모집 종료 시각 (end_at) — TIMESTAMPTZ — NOT NULL — 도달 시 CLOSED로 전환 후 All-or-Nothing 모집 결과 판정
  • 공모 상태 (offering_status) — VARCHAR(30) — NOT NULL — DRAFT / REVIEW_REQUESTED / SCHEDULED / OPEN / SOLD_OUT / CLOSED / REJECTED / CANCELLING / CANCELLED
  • 심사 요청 시각 (review_requested_at) — TIMESTAMPTZ — REVIEW_REQUESTED 전환 시 기록
  • 운영자 심사 완료 시각 (reviewed_at) — TIMESTAMPTZ — 승인 또는 반려 시 기록
  • 심사 처리 관리자 ID (reviewed_by) — UUID — User Service 논리 참조, 승인 또는 반려 처리자
  • 공모 반려 사유 (rejection_reason) — VARCHAR(500) — REJECTED 상태인 경우 기록
  • 공모 취소 완료 시각 (cancelled_at) — TIMESTAMPTZ — CANCELLING 진입 시점이 아니라 모든 보상 완료 후 CANCELLED 전환 시 기록
  • 공모 취소 유형 (cancellation_type) — VARCHAR(30) — ADMIN_CANCELLED=관리자 공모 중단, UNDER_SUBSCRIBED=모집 미달(All-or-Nothing 실패), 그 외 상태에서는 NULL
  • 레코드 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — CANCELLING 진입 시각 ❌ CANCELLED 전환 시각 ⭕
  • 레코드 생성자 ID (created_by) — UUID — NOT NULL — User Service 논리 참조
  • 레코드 최종 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 레코드 최종 수정자 ID (updated_by) — UUID — NOT NULL — 사용자 또는 시스템
  • 논리 삭제 여부 (is_deleted) — BOOLEAN — NOT NULL
  • 논리 삭제 시각 (deleted_at) — TIMESTAMPTZ
  • 논리 삭제자 ID (deleted_by) — UUID — User Service 논리 참조

금융 거래 원장 테이블 (p_wallet_transactions)

  • 거래 ID (transaction_id) — BIGSERIAL — 기본 키 — NOT NULL — 거래 원장 고유 식별자
  • 지갑 ID (wallet_id) — BIGINT — 외래 키 → 지갑 테이블.지갑 ID — NOT NULL — 대상 지갑 식별자, 존재하는 지갑 ID만 매핑
  • 거래유형 (type) — VARCHAR(20) — NOT NULL — DEPOSIT/WITHDRAW/HOLD/UNHOLD/DEDUCT/DIVIDEND/REFUND/SETTLEMENT
  • 거래금액 (amount) — BIGINT — NOT NULL — 이번 거래로 움직인 금액, 0보다 큰 양수 값
  • 거래전 잔액 (balance_before) — BIGINT — NOT NULL — 거래 직전 총잔액 스냅샷
  • 거래 후 잔액 (balance_after) — BIGINT — NOT NULL — 거래 직후 총잔액 스냅샷
  • 멱등키 (idempotency_key) — VARCHAR(255) — NOT NULL — 요청 중복 처리 방지용 고유 키, 모든 거래 타입 필수, 미제공 시 서버가 UUID 자동 생성
  • 참조 ID (reference_id) — VARCHAR(100) — 거래의 발생 원인이 된 대상 ID
  • 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 거래 발생 일시, INSERT 전용, 이후 절대 수정·삭제 불가
  • 생성자 (created_by) — UUID — NOT NULL — 거래 발생 주체(user_id), 시스템 자동 발생 거래(배당 등)는 약속된 SYSTEM 식별자 사용

멱등 요청 테이블 (p_idempotency_requests)

  • 멱등 요청 ID (idempotency_request_id) — UUID — 기본 키 — NOT NULL — 멱등 요청 식별자
  • 요청 사용자 ID (user_id) — UUID — NOT NULL — User Service 논리 참조, UNIQUE(user_id, operation, idempotency_key)
  • 멱등성 적용 명령 (operation) — VARCHAR(50) — NOT NULL — 예: CREATE_SUBSCRIPTION
  • 클라이언트 멱등 키 (idempotency_key) — VARCHAR(100) — NOT NULL — HTTP Header의 Idempotency-Key
  • 요청 데이터 해시 (request_hash) — VARCHAR(64) — NOT NULL — 동일 키로 다른 요청을 보냈는지 검증 SHA-256 hex 문자열을 저장
  • 처리 결과 리소스 종류 (resource_type) — VARCHAR(50) — NOT NULL — 청약 생성 요청의 경우 SUBSCRIPTION
  • 처리 결과로 생성된 리소스 ID (resource_id) — UUID — 청약 생성 시 subscription_id 논리 참조. 처리 완료 전 NULL 가능
  • 멱등 요청 처리 상태 (idempotency_request_status) — VARCHAR(20) — NOT NULL — PROCESSING / COMPLETED / FAILED. 동일 요청 재수신 시 비즈니스 로직을 다시 실행하지 않음
  • 최초 요청 HTTP 응답 코드 (response_code) — INTEGER — 동일 요청 재요청 시 기존 결과 판단에 활용
  • created_at — TIMESTAMPTZ — NOT NULL — 최초 요청 시각
  • 요청 처리 완료 시각 (completed_at) — TIMESTAMPTZ — COMPLETED 또는 FAILED 처리 시 기록

보유지분 테이블 (p_holdings)

  • 지분 ID (holding_id) — UUID — 기본 키 — NOT NULL — 최초 지분 배정 시 자동 발급
  • 자산 ID (asset_id) — UUID — 외래 키 → 자산 테이블.자산 ID — NOT NULL — 승인된 자산만 보유 가능
  • 유저 ID (user_id) — UUID — NOT NULL — KYC가 완료된 활성 투자자만 보유 가능
  • 현재 보유 지분 수량 (quantity) — BIGINT — NOT NULL — 0 이상이어야 함
  • 낙관적 락 버전 (version) — BIGINT — NOT NULL — 동시 배정·회수에 따른 수량 충돌 방지
  • 생성시간 (created_at) — TIMESTAMPTZ — NOT NULL — 일반적으로 SYSTEM ID 저장
  • 생성자 (created_by) — UUID
  • 업데이트 시간 (updated_at) — TIMESTAMPTZ — 지분 수량 변경 시 갱신
  • 업데이트자 (updated_by) — UUID — 시스템 또는 관리자 ID

사용자 (p_users)

  • 사용자 ID (user_id) — UUID — 기본 키 — NOT NULL — 사용자 고유 식별자
  • 이메일 (email) — VARCHAR(255) — NOT NULL — 로그인에 사용하는 이메일, 사용자 간 중복 불가
  • 비밀번호 (password) — VARCHAR(255) — NOT NULL — 딘빙행 암호화된 비밀번호 저장, 평문 저장 불가
  • 사용자 이름 (name) — VARCHAR(100) — NOT NULL — 사용자 실명
  • Slack 사용자 ID (slack_id) — VARCHAR(100) — Slack이 부여하는 고유 User ID 저장. 알림 발송 대상 식별에 사용
  • 휴대전화 번호 (phone) — VARCHAR(20) — NOT NULL — 사용자 본인 연락처, 사용자 간 중복 불가
  • 사용자 권한 (role) — VARCHAR(30) — NOT NULL — INVESTOR / ISSUER / ADMIN
  • 계정 상태 (account_status) — VARCHAR(30) — NOT NULL — ACTIVE / SUSPENDED / WITHDRAWN 등. ACTIVE가 아닌 경우 보호된 기능 사용 제한
  • KYC 상태 (kyc_status) — VARCHAR(30) — NOT NULL — NOT_SUBMITTED / PENDING / VERIFIED / REJECTED / EXPIRED
  • 투자 가능 상태 (investment_eligibility_status) — VARCHAR(30) — NOT NULL — ELIGIBLE, NOT_ELIGIBLE, RESTRICTED, 청약 가능 여부 판단에 사용
  • KYC 인증 완료 시각 (kyc_verified_at) — TIMESTAMPTZ — kyc_status가 VERIFIED로 변경될 때 기록
  • KYC 인증 만료 시각 (kyc_expires_at) — TIMESTAMPTZ — 만료 시 KYC 상태를 EXPIRED로 변경 가능
  • 마지막 로그인 성공 시각 (last_login_at) — TIMESTAMPTZ — 로그인 성공 시 갱신, 사용자 활동 추적에 사용
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 사용자 최초 생성 시각
  • 생성자 ID (created_by) — UUID — NOT NULL — 직접 가입 시 생성된 user_id, 관리자가 생성한 경우 관리자 user_id 저장
  • 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL — 사용자 정보가 최종 변경된 시각
  • 수정자 ID (updated_by) — UUID — NOT NULL — 생성 시 created_by와 동일하게 초기화
  • 삭제 여부 (is_deleted) — BOOLEAN — NOT NULL — 물리 삭제하지 않고 탈퇴 시 TRUE로 변경
  • 삭제 시각 (deleted_at) — TIMESTAMPTZ — 삭제되지 않은 사용자는 NULL
  • 삭제자 ID (deleted_by) — UUID — 탈퇴한 본인 또는 탈퇴 처리 관리자 ID

사용자별 FDS 상태 (p_fds_user_states)

  • FDS 사용자 상태 ID (fds_user_state_id) — UUID — 기본 키 — NOT NULL — FDS 사용자 상태 ID
  • 사용자 ID (user_id) — UUID — NOT NULL — 사용자 ID
  • FDS 상태 (status) — VARCHAR(20) — NOT NULL — FDS 상태 / NORMAL, BLOCKED
  • 차단 시각 (blocked_at) — TIMESTAMPTZ — 차단 시각 / BLOCKED 전환 시 기록
  • 차단 사유 (block_reason) — VARCHAR(500) — 차단 사유
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 생성 시각
  • 생성자 (created_by) — UUID — 생성자
  • 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL — 수정 시각
  • 수정자 (updated_by) — UUID — 수정자
  • 삭제 시각 (deleted_at) — TIMESTAMPTZ — 삭제 시각
  • 삭제자 (deleted_by) — UUID — 삭제자
  • 삭제 여부 (is_deleted) — BOOLEAN — NOT NULL

수익 (p_revenues)

  • 수익 id (revenue_id) — UUID — 기본 키 — NOT NULL — 정산 수익 데이터 생성 시 자동 발급
  • 자산 ID (asset_id) — UUID — 외래 키 → 자산 테이블.자산 ID — NOT NULL — 서비스 간 물리 FK를 설정하지 않고 API 또는 이벤트로 전달받음
  • 수익 출처 (source_type) — ENUM — NOT NULL — PROPERTY_MANAGER, MUSIC_TRUST, ADMIN, SYNTHETIC
  • 출처ID (source_reference_id) — VARCHAR(100) — NOT NULL — 외부 원본 수익 데이터 추적에 사용
  • 수익 유형 (revenue_type) — ENUM — NOT NULL — RENTAL_INCOME, COPYRIGHT_ROYALTY, DIVIDEND, ETC
  • 총수익 (gross_amount) — DECIMAL(19,2) — NOT NULL — 0보다 커야 함
  • 비용 (expense_amount) — DECIMAL(19,2) — NOT NULL — 0 이상이어야 하며 공제 가능 여부는 정산 서비스가 판단
  • 수수료 (fee_amount) — DECIMAL(19,2) — NOT NULL — 0 이상이어야 하며 공제 가능 여부는 정산 서비스가 판단
  • 통화 코드 (currency) — VARCHAR(3) — NOT NULL — ISO 4217 형식 사용, MVP는 KRW만 허용
  • 수익 발생 기간 시작일 (period_start) — DATE — NOT NULL — period_end보다 늦을 수 없음
  • 수익 발생 기간 종료일 (period_end) — DATE — NOT NULL — period_start와 같거나 이후여야 함
  • 외부에서 전달받은 원본 (raw_payload) — JSONB — NOT NULL — 출처별 원본 데이터 추적 및 장애 분석용
  • 정산 서비스 전달 상태 (transfer_status) — ENUM — NOT NULL — READY, TRANSFERRED, FAILED
  • 정산 서비스 전달 완료 시간 (transferred_at) — TIMESTAMPTZ — TRANSFERRED 상태 변경 시 기록
  • 전달 실패 사유 (failure_reason) — VARCHAR(500) — FAILED 상태인 경우 기록
  • 생성시간 (created_at) — TIMESTAMPTZ — NOT NULL — 생성 후 변경하지 않음
  • 생성자 (created_by) — UUID — NOT NULL — 자동 등록은 약속된 SYSTEM ID 사용
  • 수정 시간 (updated_at) — TIMESTAMPTZ — transfer_status 변경 시 갱신
  • 수정자 (updated_by) — UUID — 스케줄러·Kafka 처리는 SYSTEM ID 사용

이벤트 발행 테이블 (p_outbox_events)

  • Outbox 이벤트 ID (event_id) — UUID — 기본 키 — NOT NULL — Kafka Event ID로 사용
  • 이벤트 발생 Aggregate 종류 (aggregate_type) — VARCHAR(50) — NOT NULL — 예: SUBSCRIPTION, OFFERING
  • 이벤트 발생 Aggregate ID (aggregate_id) — UUID — NOT NULL — 물리 FK를 사용하지 않고 Aggregate 논리 참조
  • 이벤트 종류 (event_type) — VARCHAR(100) — NOT NULL — 예: SubscriptionReserved, SubscriptionConfirmed, SubscriptionCompensationRequested
  • Kafka 발행 Topic (topic) — VARCHAR(100) — NOT NULL — 예: subscription-reserved, subscription-confirmed
  • Kafka 발행 Payload (payload) — JSONB — NOT NULL — 이벤트 생성 시점 Snapshot. EventEnvelope 전체 또는 재구성 가능한 공통 필드를 포함
  • 이벤트 발행 상태 (event_status) — VARCHAR(20) — NOT NULL — PENDING=발행 대기, PROCESSING=Publisher 점유/발행 중, PUBLISHED=발행 완료, FAILED=재시도 한도 초과
  • Kafka 발행 재시도 횟수 (retry_count) — INTEGER — NOT NULL — 발행 실패 시 증가
  • 다음 Kafka 발행 재시도 시각 (next_retry_at) — TIMESTAMPTZ — Retry 대상인 경우 기록
  • 마지막 Kafka 발행 실패 사유 (last_error) — TEXT — 운영 추적 및 장애 분석용
  • Outbox 이벤트 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 비즈니스 데이터 변경과 동일 DB 트랜잭션에서 저장
  • Kafka 발행 완료 시각 (published_at) — TIMESTAMPTZ — PUBLISHED 전환 시 기록
  • 현재 Kafka 발행 시도 시작 시각 (processing_started_at) — TIMESTAMPTZ — PROCESSING 전환 시마다 갱신. 최초 발행 대기 시 NULL. 장시간 PROCESSING 상태인 이벤트의 복구 판단에 사용

이벤트 처리 이력 테이블 (p_processed_events)

  • Consumer 이벤트 처리 이력 ID (processed_event_id) — UUID — 기본 키 — NOT NULL — 처리 이력 식별자
  • 수신 Kafka 이벤트 ID (event_id) — UUID — NOT NULL — Producer Event 논리 참조. 동일 event_id와 consumer_group 조합의 중복 처리 방지
  • Kafka Consumer Group (consumer_group) — VARCHAR(100) — NOT NULL — Consumer Group 단위로 멱등 처리
  • 수신 이벤트 종류 (event_type) — VARCHAR(100) — NOT NULL — 예: WalletHoldSucceeded
  • 처리 대상 Aggregate ID (aggregate_id) — UUID — 물리 FK 없이 논리 참조. 운영 추적 및 장애 분석용
  • 이벤트 처리 완료 시각 (processed_at) — TIMESTAMPTZ — NOT NULL — 비즈니스 처리 성공 후 처리 이력 기록. 비즈니스 처리와 동일 DB 트랜잭션에서 저장

자산 문서 테이블 (p_asset_documents)

  • 문서 ID (document_id) — UUID — 기본 키 — NOT NULL — 문서 등록 시 자동 발급
  • 자산 ID (asset_id) — UUID — 외래 키 → 자산 테이블.자산 ID — NOT NULL — 존재하며 삭제되지 않은 자산만 문서 등록 가능
  • 문서 유형 (document_type) — VARCHAR(30) — NOT NULL — INVESTMENT_GUIDE, APPRAISAL, RIGHT_PROOF, ETC
  • 문서 버전 (document_version) — INTEGER — NOT NULL — 자산·문서 유형별 1부터 순차 증가
  • 업로드한 원본 파일명 (original_filename) — VARCHAR(255) — NOT NULL — 경로 문자를 제외한 원본 파일명 저장
  • S3 파일 Object Key (s3_object_key) — VARCHAR(500) — NOT NULL — S3 전체 URL이 아닌 Object Key 저장
  • 파일 MIME 타입 (content_type) — VARCHAR(100) — NOT NULL — PDF, JPEG, PNG 등 허용된 형식만 저장
  • 파일 크기 (file_size) — BIGINT — NOT NULL — Byte 단위 최대 업로드 크기 제한
  • 파일 해시 (file_hash) — CHAR(64) — NOT NULL — 파일 변조 여부 확인에 사용
  • 등록시간 (created_at) — TIMESTAMPTZ — NOT NULL
  • 등록자 (created_by) — UUID — NOT NULL — 자산운용자 또는 운영자
  • 삭제시간 (deleted_at) — TIMESTAMPTZ
  • 삭제자 (deleted_by) — UUID

자산 테이블 (p_assets)

  • 자산 ID (asset_id) — UUID — 기본 키 — NOT NULL — 자산 생성 시 자동 발급
  • 유저 ID (user_id) — UUID — NOT NULL — ISSUER 권한을 가진 사용자만 자산 등록 가능
  • 자산 유형 (asset_type) — ENUM — NOT NULL — REAL_ESTATE, MUSIC_COPYRIGHT
  • 자산명 (asset_name) — VARCHAR(200) — NOT NULL
  • 자산 상세 (description) — TEXT — NOT NULL — 자산 특징·권리·수익 구조 작성
  • 자산 평가금액 (valuation_amount) — BIGINT — NOT NULL — 원 단위 저장0보다 커야 함
  • 예상 연 수익률 (expected_return_rate) — NUMERIC(7,4) — NOT NULL — 0 이상의 백분율 값
  • 자산 유형별 상세 (detail_data) — JSONB — NOT NULL — 부동산의 주소·면적·임대료 또는 음원의 가수·권리 유형·저작권료 저장
  • 조각당 가격 (unit_price) — BIGINT — NOT NULL — 원 단위 저장0보다 커야 함
  • 전체 발행 지분 수량 (total_share_quantity) — BIGINT — NOT NULL — 0보다 커야 함
  • 투자자에게 배정된 지분 수량 (allocated_quantity) — BIGINT — NOT NULL — 0 이상이며 전체 발행 수량을 초과할 수 없음
  • 자산 상태 (asset_status) — ENUM — NOT NULL — DRAFT, REVIEW_REQUESTED, APPROVED, REJECTED, SUSPENDED, TERMINATED
  • 심사 반려 사유 (rejection_reason) — VARCHAR(500) — asset_status가 REJECTED일 때 필수
  • 대표 이미지 (representative_image_key) — VARCHAR(500) — S3 전체 URL이 아닌 Object Key 저장
  • 낙관적 락 버전 (version) — BIGINT — NOT NULL — 동시 수정과 지분 수량 변경 충돌 방지
  • 자산 생성 시간 (created_at) — TIMESTAMPZ — NOT NULL
  • 자산 생성자 (created_by) — UUID — NOT NULL
  • 자산 수정 시간 (updated_at) — TIMESTAMPZ — 수정 시 현재 시간으로 갱신
  • 자산 수정자 (updated_by) — UUID — 생성 시 created_by와 동일
  • 삭제 시간 (deleted_at) — TIMESTAMPZ
  • 삭제 사용자 (deleted_by) — UUID

정산 회차 (p_settlement_batches)

  • 정산 회차id (settlement_batch_id) — UUID — 기본 키 — NOT NULL
  • 대상 자산id (asset_id) — UUID — NOT NULL
  • 근거가 된 수익id (revenue_id) — UUID — NOT NULL — p_revenues 1:1, UNIQUE
  • 배당 기준일 (record_date) — TIMESTAMPTZ — NOT NULL
  • 회차 배당 총액(원) (total_amount) — BIGINT — NOT NULL
  • 상태 (status) — VARCHAR(20) — NOT NULL
  • 생성 시간 (created_at) — TIMESTAMPTZ — NOT NULL
  • 생성자 (created_by) — UUID — NOT NULL
  • 수정시간 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 수정자 (updated_by) — UUID — NOT NULL
  • 삭제시간 (deleted_at) — TIMESTAMPTZ
  • 삭제자 (deleted_by) — UUID
  • 삭제여부 (is_deleted) — BOOLEAN — NOT NULL

지갑 테이블 (p_wallets)

  • 지갑 ID (wallet_id) — BIGSERIAL — 기본 키 — NOT NULL — 지갑 고유 식별자
  • 사용자 ID (user_id) — UUID — NOT NULL — 회원 고유 식별자, 유저당 1개의 지갑만 생성
  • 총 잔액 (balance) — BIGINT — NOT NULL — 사용자가 실제 보유한 총 자산, 청약 동결/해제 시에는 변동 없음(음수 불가)
  • 동결 금액 (hold_balance) — BIGINT — NOT NULL — balance 중 청약 등으로 묶여 사용 제한된 금액, hold_balance는 항상 balance 이하 유지
  • 가용 잔액 (available_balance) — BIGINT — NOT NULL — 출금·재청약에 즉시 사용 가능한 금액(balance - hold_balance)
  • 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 지갑 생성 일시
  • 생성자 (created_by) — UUID — NOT NULL — 지갑 생성자(user_id), 회원가입 이벤트로 자동 생성 시 약속된 SYSTEM 식별자 사용
  • 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL — 최종 수정 일시, 잔액 등 변경 시 자동 갱신
  • 수정자 (updated_by) — UUID — NOT NULL — 최종 수정자(user_id), 생성 시 created_by와 동일 초기화
  • 삭제여부 (is_deleted) — BOOLEAN — NOT NULL — 논리 삭제 여부, 탈퇴 시 true로 전환
  • 삭제일시 (deleted_at) — TIMESTAMPTZ — 논리 삭제 시각, 삭제 안 됐으면 NULL
  • deleted_by — UUID — 논리 삭제자(user_id), 삭제 안 됐으면 NULL

지분 변동 이력 테이블 (p_holding_histories)

  • 지분히스토리 ID (history_id) — UUID — 기본 키 — NOT NULL
  • 지분 ID (holding_id) — UUID — 외래 키 → 보유지분 테이블.지분 ID — NOT NULL — p_holdings.holding_id
  • 청약 ID (subscription_id) — UUID — NOT NULL — 청약 서비스 subscription_id 논리 참조
  • 지분 변동 유형 (history_type) — VARCHAR(30) — NOT NULL
  • 변동 지분 수량 (quantity) — BIGINT — NOT NULL
  • 처리 전 보유 수량 (balance_before) — BIGINT — NOT NULL
  • 처리 후 보유 수량 (balance_after) — BIGINT — NOT NULL
  • 중복 처리 방지 키 (idempotency_key) — VARCHAR(100) — NOT NULL
  • 지분 변동 사유 (reason) — VARCHAR(500)
  • 생성 시간 (created_at) — TIMESTAMPTZ — NOT NULL
  • 생성자 (created_by) — UUID — NOT NULL — 사용자 서비스 user_id 논리 참조

지분 스냅샷 (p_holdings_snapshots)

  • 보유지분 스냅샷id (holding_snapshot_id) — UUID — 기본 키 — NOT NULL
  • 정산 회차id (settlement_batch_id) — UUID — 외래 키 → 정산 회차.정산 회차id — NOT NULL
  • 스냅샷 대상 자산 id (asset_id) — UUID — NOT NULL
  • 보유지분 조회 기준 시간 (snapshot_at) — TIMESTAMPTZ] — NOT NULL
  • 스냅샷 전체 보유 수량 (total_quantity) — BIGINT — NOT NULL
  • 스냅샷에 포함된 투자자 수 (total_holders) — INTEGER — NOT NULL
  • 스냅샷 시점 자산의 전체 발행 지분 수량 (total_share_quantity) — BIGINT
  • 생성 시간 (created_at) — TIMESTAMPTZ] — NOT NULL
  • 스냅샷 생성 사용자or시스템id (created_by) — UUID — NOT NULL

청약 보상 진행 테이블 (p_subscription_compensations)

  • 보상 진행 정보 ID (compensation_id) — UUID — 기본 키 — NOT NULL
  • 청약 ID (subscription_id) — UUID — 외래 키 → 청약 테이블.청약 ID — NOT NULL — 청약당 보상 진행 정보 1행. 재시도 시 기존 행 사용
  • Wallet 보상 진행 상태 (wallet_status) — VARCHAR(20) — NOT NULL — PENDING: 결과 대기SUCCEEDED: 보상 완료FAILED: 실패 결과 수신
  • Holding 회수 보상 진행 상태 (holding_status) — VARCHAR(20) — NOT NULL — PENDING: 결과 대기SUCCEEDED: 회수 보상 완료FAILED: 실패 결과 수신
  • Wallet 보상의 최근 실패 코드 (wallet_error_code) — VARCHAR(100) — 실패 payload의 reason 저장
  • Holding 회수의 최근 실패 코드 (holding_error_code) — VARCHAR(100) — 실패 payload의 errorCode 저장
  • 보상 진행 정보 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL — 최초 보상 시작 시 기록. 이후 유지
  • 보상 진행 정보 최초 생성자 (created_by) — UUID — NOT NULL — 관리자 요청이면 관리자 ID, 스케줄러가 시작하면 SYSTEM_USER_ID. 이후 유지
  • 보상 진행 정보 최종 변경 시각 (updated_at) — TIMESTAMPTZ — NOT NULL — 결과 반영·재시도 상태 변경 시 갱신. DEFAULT만으로 UPDATE 시 자동 갱신되지는 않음
  • updated_by — UUID — NOT NULL — 관리자 재처리면 관리자 ID, Kafka 결과 처리·스케줄러 작업이면 SYSTEM_USER_ID

청약 자금 동결 테이블 (p_wallet_holds)

  • 동결 ID (hold_id) — BIGSERIAL — 기본 키 — NOT NULL — 동결 건 고유 식별자
  • 지갑 ID (wallet_id) — BIGINT — 외래 키 → 지갑 테이블.지갑 ID — NOT NULL — 대상 지갑 식별자
  • 청약 ID (subscription_id) — UUID — NOT NULL — 동결에 연계된 청약 식별 ID, 청약당 1개의 동결 레코드만 존재(UNIQUE), 멱등성 자연 보장
  • 동결 금액 (amount) — BIGINT — NOT NULL — 동결된 청약금액, 0보다 큰 양수 값, wallet_transactions의 HOLD 거래 금액과 항상 일치
  • 동결 상태 (status) — VARCHAR(20) — NOT NULL — HELD →RELEASED 또는 COMMITTED만 허용, 역전이 불가, 조건부 UPDATE로 원자적 전이
  • 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 최초 동결 시간
  • 생성자 (created_by) — UUID — NOT NULL — 생성 주체(user_id)
  • 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL — 상태 변경 일시, 상태 변경 시 자동 갱신
  • 수정자 (updated_by) — UUID — NOT NULL — 상태 최종 수정자(user_id)

청약 테이블 (p_subscriptions)

  • 청약 ID (subscription_id) — UUID — 기본 키 — NOT NULL — 청약 식별자
  • 대상 공모 ID (offering_id) — UUID — 외래 키 → 공모 상품 테이블.공모 ID — NOT NULL — 동일 서비스 내 p_offerings.offering_id 실제 FK, 복합 UNIQUE
  • 청약 투자자 ID (user_id) — UUID — NOT NULL — JWT 사용자 ID 사용. User Service 논리 참조, 복합 UNIQUE
  • 청약 시점 단위 가격 (price_per_unit) — BIGINT — NOT NULL — Offering.price_per_unit을 청약 접수 시점에 Snapshot으로 저장
  • 청약 수량 (quantity) — BIGINT — NOT NULL — 공모별 최소/최대 청약 수량 범위 내에서 검증
  • 청약 수량 확보 여부 (quantity_reserved) — BOOLEAN — NOT NULL — 선착순 수량 확보 성공 시 true, 수량 복원 완료 시 false
  • 청약 시점 총 금액 (amount) — BIGINT — NOT NULL — price_per_unit × quantity
  • 청약 처리 상태 (subscription_status) — VARCHAR(30) — NOT NULL — PROCESSING/CONFIRMED/COMPENSATING/REJECTED/CANCELLED/MANUAL_REVIEW
  • Offering 내부 청약 처리 실패 또는 상태 전환 사유 코드 (subscription_failure_code) — VARCHAR(50) — 예약 만료 시 RESERVATION_EXPIRED, 늦게 수신된 Wallet HOLD 성공으로 수동 확인 전환 시 LATE_WALLET_HOLD_SUCCEEDED 저장
  • Wallet HOLD 실패 사유 코드 (wallet_hold_failure_code) — VARCHAR(50) — WalletHoldFailed 이벤트 Payload의 reason 저장
  • 청약 취소 유형 (cancellation_type) — VARCHAR(50) — OFFERING_ADMIN_CANCELLED 또는 OFFERING_UNDER_SUBSCRIBED. CONFIRMED 이후 투자자의 자발적 취소는 허용하지 않음
  • 청약 취소 완료 시각 (cancelled_at) — TIMESTAMPTZ — 필요한 보상이 모두 완료되어 CANCELLED 전환 시 기록
  • 청약 최종 확정 시각 (confirmed_at) — TIMESTAMPTZ — 수량 확보와 Wallet HOLD 성공으로 CONFIRMED 전환 시 기록
  • PROCESSING 처리 제한 시각 (reservation_expires_at) — TIMESTAMPTZ — 장기 PROCESSING 탐지용. CONFIRMED/REJECTED/CANCELLED 이후에는 사용하지 않음
  • Holding 지분 배정 후처리 상태 (holding_allocation_status) — VARCHAR(20) — 청약 확정 전에는 NULL. CONFIRMED 전환 시 PENDING, 지분 배정 성공 시 SUCCEEDED, 실패 시 FAILED.
  • Holding 지분 배정의 최근 실패 코드 (holding_allocation_error_code) — VARCHAR(100) — 배정 실패 시 수신 Payload의 errorCode 저장. 성공 시 NULL로 초기화. 상태가 FAILED일 때만 값이 존재할 수 있음
  • 레코드 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL
  • 레코드 생성자 ID (created_by) — UUID — NOT NULL — 일반적으로 청약 투자자 ID
  • 레코드 최종 수정 시각 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 레코드 최종 수정자 ID (updated_by) — UUID — NOT NULL — 사용자 또는 시스템
  • 논리 삭제 여부 (is_deleted) — BOOLEAN — NOT NULL
  • 논리 삭제자 ID (deleted_by) — UUID
  • 논리 삭제 시각 (deleted_at) — TIMESTAMPTZ

최종 정산 개별 지급 테이블 (p_final_settlement_payouts)

  • 개별 원금반환 건 고유 식별자 (final_settlement_payout_id) — UUID — 기본 키 — NOT NULL
  • 지급 대상 투자자id (investor_id) — UUID — NOT NULL
  • 스냅샷 시점 보유 수량 (quantity) — BIGINT — NOT NULL — record_date 기준 조회값 그대로 고정
  • 지급 금액(원) (amount) — BIGINT — NOT NULL — 0 이상, 단수 처리 결과 포함
  • 멱등키 (idempotency_key) — VARCHAR(100) — NOT NULL — UNIQUE
  • 상태 (status) — VARCHAR(20) — NOT NULL
  • 재시도 횟수 (retry_count) — INT — NOT NULL — 최대 재시도 횟수(예: 5회) 초과 시 DEAD_LETTER로 전환
  • 생성시간 (created_at) — TIMESTAMPTZ — NOT NULL
  • 생성자 (created_by) — UUID — NOT NULL
  • 수정시간 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 수정자 (updated_by) — UUID — NOT NULL
  • 삭제시간 (deleted_at) — TIMESTAMPTZ
  • 삭제자 (deleted_by) — UUID
  • 삭제 여부 (is_deleted) — BOOLEAN — NOT NULL
  • 최종 정산 회차 고유 식별자 (final_settlement_batch_id) — UUID — 외래 키 → 최종 정산 회차 테이블.최종 정산 회차 고유 식별자 — NOT NULL
  • 포기 처리 시 지급 방법 (resolution_type) — VARCHAR(20) — BANK_TRANSFER/OTHER. status=ABANDONED일 때만 값이 있음
  • 지급 증빙 번호 (resolution_reference) — VARCHAR(200) — 은행 이체 확인번호 등. 형식 검증만 가능(외부 연동 없음). 포기 처리 시 필수
  • 상세 설명 (resolution_note) — VARCHAR(500) — resolution_type=OTHER이면 필수

최종 정산 회차 테이블 (p_final_settlement_batches)

  • 최종 정산 회차 고유 식별자 (final_settlement_batch_id) — UUID — 기본 키 — NOT NULL
  • 대상 자산 (asset_id) — UUID — NOT NULL — UNIQUE
  • 자산 종료 확정 시각 (지분 스냅샷 기준일) (terminated_at) — TIMESTAMPTZ — NOT NULL — 자산의 동기 호출 요청 바디에서 전달받은 값
  • 조각당 취득가 (원) (unit_price) — BIGINT — NOT NULL — 자산의 동기 호출 요청 바디에서 전달받은 값
  • 회차 원금반환 총액 (원) (total_amount) — BIGINT — NOT NULL — Σ(투자자별 amount)와 일치해야 함.
  • 상태 (status) — VARCHAR(20) — NOT NULL
  • 생성시간 (created_at) — TIMESTAMPTZ — NOT NULL
  • 생성자 (created_by) — UUID — NOT NULL
  • 수정시간 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 수정자 (updated_by) — UUID — NOT NULL
  • 삭제시간 (deleted_at) — TIMESTAMPTZ
  • 삭제자 (deleted_by) — UUID
  • 삭제 여부 (is_deleted) — BOOLEAN
  • 자산 서비스에 종료 완료를 통보한 시각 (asset_termination_completed_at) — TIMESTAMPTZ