거래소 프로젝트 ver2

테이블 (12)

거래 (trade)

  • 거래 ID (trade_id) — BIGINT — 기본 키 — NOT NULL
  • 시장 ID (market_id) — BIGINT — 외래 키 → 시장.시장 ID — NOT NULL
  • 구매 주문 ID (buy_order_id) — BIGINT — 외래 키 → 주문.주문 ID — NOT NULL
  • 판매 주문 ID (sell_order_id) — BIGINT — 외래 키 → 주문.주문 ID — NOT NULL
  • 거래 타입 (maker_order_side) — ENUM('BID', 'ASK') — NOT NULL
  • 체결 가격 (price) — DECIMAL(30, 8) — NOT NULL — quote/unit
  • 체결 수량 (quantity) — DECIMAL(30, 8) — NOT NULL — base
  • 체결 총액 (quote_amount) — DECIMAL(30, 8) — NOT NULL — 정산용 price*quantity (quote)
  • 수수료 (fee_rate) — DECIMAL(10, 8) — NOT NULL — 스냅샷
  • 구매 수수료 (buy_fee_amount) — DECIMAL(30, 8) — NOT NULL
  • 판매 수수료 (sell_fee_amount) — DECIMAL(30, 8) — NOT NULL
  • 체결 시간 (executed_at) — TIMESTAMP(3) — NOT NULL

명령 로그 (command_log)

  • 명령 로그 ID (command_log_id) — BIGINT — 기본 키 — NOT NULL
  • 명령 ID (command_id) — VARCHAR(64) — NOT NULL — unique
  • 명령 타입 (command_type) — VARCHAR(32) — NOT NULL
  • 시장 ID (market_id) — BIGINT — NOT NULL
  • 사용자 ID (user_id) — BIGINT
  • 사용자 주문 ID (client_order_id) — VARCHAR(150)
  • 전송데이터 (payload) — JSON — NOT NULL
  • 해쉬 (request_hash) — VARCHAR(64) — NOT NULL
  • 로그 생성 시간 (created_at) — TIMESTAMP(3)

사용자 (users)

  • 사용자 ID (user_id) — BIGINT — 기본 키 — NOT NULL
  • 이메일 (email) — VARCHAR(100) — NOT NULL — UNIQUE / 로그인 ID
  • 사용자 이름 (user_name) — VARCHAR(100) — NOT NULL — 표시명 (중복 허용)
  • 상태 (status) — ENUM('ACTIVE', 'INACTIVE', 'DEPRECATED') — NOT NULL
  • 비밀번호 (password_hash) — VARCHAR(255) — NOT NULL — 암호화(bcrypt or sha256)
  • 생성 일자 (created_at) — TIMESTAMP(3) — NOT NULL
  • 수정 일자 (updated_at) — TIMESTAMP(3) — NOT NULL

시세 (market_ticker_cache)

  • 마지막 거래 금액 (last_trade_price) — DECIMAL(30, 8) — NOT NULL — 현재가
  • 24시간 최고 체결가 (high_24h) — DECIMAL(30, 8) — NOT NULL
  • 24시간 최저 체결가 (low_24h) — DECIMAL(30, 8) — NOT NULL
  • 24시간 체결량 (volume_24h) — DECIMAL(30, 8) — NOT NULL — base 기준
  • 24시간 체결 금액 (trade_amount_24h) — DECIMAL(30, 8) — NOT NULL — quote 기준
  • 전일 대비 변동률 (change_rate) — DECIMAL(30, 8) — NOT NULL
  • 수정 시간 (updated_at) — TIMESTAMP(3) — NOT NULL

시장 (market)

  • 시장 ID (market_id) — BIGINT — 기본 키 — NOT NULL
  • 기준 자산 ID (base_asset_id) — BIGINT — 외래 키 → 자산.자산 ID — NOT NULL — BTC (기준 자산)
  • 결제 자산 ID (quote_asset_id) — BIGINT — 외래 키 → 자산.자산 ID — NOT NULL — KRW (결제 자산)
  • 마켓 코드 (market_code) — VARCHAR(20) — NOT NULL — UNIQUE / BTC-KRW
  • 상태 (status) — ENUM('ACTIVE', 'INACTIVE', 'DEPRECATED') — NOT NULL
  • 최소 거래가 (min_order_quote) — DECIMAL(30, 8) — NOT NULL — quote 기준 최소 거래 금액
  • 호가 단위 (tick_size) — DECIMAL(30, 8) — NOT NULL — quote 기준 고정 호가 단위
  • 생성 일자 (created_at) — TIMESTAMP(3) — NOT NULL
  • 수정 일자 (updated_at) — TIMESTAMP(3) — NOT NULL

오프셋 (consumer_offset)

  • Key (stream_type) — ENUM('COMMAND', 'EVENT') — 기본 키 — NOT NULL — 복합키
  • Key2 (consumer_name) — VARCHAR(100) — 기본 키 — NOT NULL
  • Key3 (partition_key) — VARCHAR(64) — 기본 키 — NOT NULL
  • Field (last_offset) — BIGINT — NOT NULL
  • Field2 (updated_at) — TIMESTAMP(3)

원장 (ledger)

  • 원장 ID (ledger_id) — BIGINT — 기본 키 — NOT NULL
  • 지갑 ID (wallet_id) — BIGINT — 외래 키 → 지갑.지갑 ID — NOT NULL
  • 자산 ID (asset_id) — BIGINT — 외래 키 → 자산.자산 ID — NOT NULL
  • 거래 종류 (ledger_type) — ENUM('ORDER_LOCK','ORDER_UNLOCK','TRADE','CANCEL','DEPOSIT','WITHDRAW','FEE') — NOT NULL — 원장 항목의 성격
  • 변화 방향 (change_type) — ENUM('INCREASE', 'DECREASE') — NOT NULL
  • 변화량 (amount) — DECIMAL(30, 8) — NOT NULL — 잔액 변화 (항상 양수)
  • 변경 전 잔액 - 사용가능 (available_before) — DECIMAL(30, 8) UNSIGNED — NOT NULL
  • 변경 후 잔액 - 사용 가능 (available_after) — DECIMAL(30, 8) UNSIGNED — NOT NULL
  • 변경 전 잔액 - 대기중 (locked_before) — DECIMAL(30, 8) UNSIGNED — NOT NULL
  • 변경 후 잔액 - 대기중 (locked_after) — DECIMAL(30, 8) UNSIGNED — NOT NULL
  • 참조 타입 (reference_type) — ENUM('ORDER', 'TRADE', 'DEPOSIT', 'WITHDRAW', 'SYSTEM') — NOT NULL — 참조하는 도메인 엔티티
  • 참조 ID (reference_id) — BIGINT — 참조 대상 ID
  • 설명 (description) — VARCHAR(255)
  • 멱등성 키 (idempotency_key) — VARCHAR(150) — NOT NULL — UNIQUE / 멱등성 키
  • 원장 생성 시간 (created_at) — TIMESTAMP(3) — NOT NULL

이벤트 로그 (event_log)

  • 이벤트 로그 ID (event_log_id) — BIGINT — 기본 키 — NOT NULL
  • 명령 로그 ID (command_log_id) — BIGINT — 외래 키 → 명령 로그.명령 로그 ID — NOT NULL
  • 이벤트 ID (event_id) — VARCHAR(64) — NOT NULL — unique
  • Field2 (event_type) — VARCHAR(32) — NOT NULL
  • Field3 (market_id) — BIGINT — NOT NULL
  • Field4 (order_id) — BIGINT
  • Field5 (payload) — JSON — NOT NULL
  • Field6 (created_at) — TIMESTAMP(3) — NOT NULL

자산 (asset)

  • 자산 ID (asset_id) — BIGINT — 기본 키 — NOT NULL
  • 자산 기호 (symbol) — VARCHAR(10) — NOT NULL — UNIQUE / BTC, ETH, KRW 등
  • 자산 이름 (name) — VARCHAR(100) — NOT NULL — 비트코인, 이더리움, 원화 등
  • 표현 정밀도 (decimals) — TINYINT UNSIGNED — NOT NULL — RANGE(0~8)
  • 자산 상태 (status) — ENUM('ACTIVE', 'INACTIVE', 'DEPRECATED') — NOT NULL — 거래 가능 여부
  • 생성 일자 (created_at) — TIMESTAMP(3) — NOT NULL
  • 수정 일자 (updated_at) — TIMESTAMP(3) — NOT NULL

주문 (orders)

  • 주문 ID (order_id) — BIGINT — 기본 키 — NOT NULL
  • 시장 ID (market_id) — BIGINT — 외래 키 → 시장.시장 ID — NOT NULL
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
  • 사용자 주문 ID (client_order_id) — VARCHAR(150) — NOT NULL — UNIQUE(user scope) / 멱등성 키
  • 주문 방향 (order_side) — ENUM('BID', 'ASK') — NOT NULL — BID=매수, ASK=매도
  • 주문 타입 (order_type) — ENUM('LIMIT', 'MARKET') — NOT NULL
  • 주문 조건 (time_in_force) — ENUM('GTC', 'IOC', 'FOK') — NOT NULL
  • 주문 가격 (price) — DECIMAL(30, 8) — LIMIT 전용(quote/unit)
  • 주문 수량 (quantity) — DECIMAL(30, 8) — LIMIT/MARKET-ASK에 사용(base)
  • 총금액 (quote_amount) — DECIMAL(30, 8) — MARKET-BID 입력값(quote 총액)
  • 체결된 수량 (executed_quantity) — DECIMAL(30, 8) — NOT NULL — base 기준
  • 체결된 금액 (executed_quote_amount) — DECIMAL(30, 8) — NOT NULL — quote 기준
  • 주문 상태 (status) — ENUM('OPEN','FILLED','CANCELED') — NOT NULL
  • 취소 이유 (cancel_reason) — VARCHAR(50)
  • 주문 생성 시간 (created_at) — TIMESTAMP(3) — NOT NULL
  • 주문 변경 시간 (updated_at) — TIMESTAMP(3) — NOT NULL

지갑 (wallet)

  • 지갑 ID (wallet_id) — BIGINT — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
  • 자산 ID (asset_id) — BIGINT — 외래 키 → 자산.자산 ID — NOT NULL
  • 거래 가능 잔액 (available_balance) — DECIMAL(30, 8) UNSIGNED — NOT NULL
  • 대기중 잔액 (locked_balance) — DECIMAL(30, 8) UNSIGNED — NOT NULL
  • 버전 (version) — BIGINT — NOT NULL — 동시성 제어용 - 낙관적 락
  • 생성 일자 (created_at) — TIMESTAMP(3) — NOT NULL
  • 수정 일자 (updated_at) — TIMESTAMP(3) — NOT NULL

호가 저장 (order_book_projection)

  • 시장 ID (market_id) — BIGINT — 기본 키 — NOT NULL
  • Key (side) — ENUM('BID', 'ASK') — 기본 키 — NOT NULL
  • Key2 (price) — DECIMAL(30, 8) — 기본 키 — NOT NULL
  • Field2 (total_qty) — DECIMAL(30, 8) — NOT NULL
  • Field3 (order_count) — INT — NOT NULL
  • Field4 (updated_at) — TIMESTAMP(3) — NOT NULL