거래소 프로젝트
테이블 (8)
거래 (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
사용자 (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
원장 (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
자산 (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