v0.1
Tables (32)
accounts
- id — BIGINT — Primary key — NOT NULL — 계좌 식별자
- user_id — BIGINT — Foreign key → users.id — NOT NULL — 계좌 주인
- season_id — BIGINT — Foreign key → seasons.id — NOT NULL — 소속 시즌
- krw_cash — DECIMAL(20, 4) — NOT NULL — 원화 현금 총액. 잠긴 금액을 포함한다 — 주문 가능 금액은 krw_cash - locked_krw
- usd_cash — DECIMAL(20, 4) — NOT NULL — 달러 현금 총액. 잠긴 금액을 포함한다
- locked_krw — DECIMAL(20, 4) — NOT NULL — 예약 매수와 청약 증거금이 점유한 원화
- locked_usd — DECIMAL(20, 4) — NOT NULL — 예약 매수와 청약 증거금이 점유한 달러
- starting_balance_krw — DECIMAL(20, 4) — NOT NULL — 누적 수익률의 분모. 시드 1억 또는 중간 합류자의 소급 인덱스 잔고 (기획서 3.3.2)
- index_adjusted — BOOLEAN — NOT NULL — 소급 인덱스 잔고로 시작했는가. 참이면 합류 안내 문구를 띄운다
- joined_season_day — SMALLINT — NOT NULL — 참가한 일차 (1~3)
- daily_base_valuation_krw — DECIMAL(20, 4) — NOT NULL — 일간 수익률의 분모. 매일 개장에 그 시점 평가액으로 갱신된다. 일간 리더보드와 계좌 화면이 반드시 같은 값을 써야 한다 (기획서 7.1.4 · 11.2.1)
- daily_base_season_day — SMALLINT — NOT NULL — 위 기준값이 어느 일차의 것인지. 개장 갱신이 누락되면 이 값으로 감지한다
- last_acked_tick_seq — BIGINT — NOT NULL — 부재 요약을 마지막으로 확인 처리한 틱. 현재 tickSeq 와의 차이가 임계(50틱) 이상이면 부재로 판정한다
- created_at — DATETIME — NOT NULL — 계좌 생성 시각 = 시즌 참가 시각
admin_audit_logs
- id — BIGINT — Primary key — NOT NULL — 감사 로그 식별자
- actor_user_id — BIGINT — NOT NULL — 수행한 관리자. FK 가 아니라 "그 시점에 그 값이었다"는 기록이다
- action — VARCHAR(30) — NOT NULL — USER_ROLE_UPDATE | SESSION_REVOKE
- target_user_id — BIGINT — 대상 사용자. 대상이 없는 행위면 NULL
- detail — VARCHAR(255) — 예: 'USER -> ADMIN'. 저장 실패가 나지 않도록 잘라 담는다
- created_at — DATETIME — NOT NULL — 수행 시각
awards
- id — BIGINT — Primary key — NOT NULL — 시상 식별자
- season_id — BIGINT — Foreign key → seasons.id — NOT NULL — 소속 시즌
- season_day — SMALLINT — 일간 시상이면 일차, 시즌 최종 시상이면 NULL
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 수상 계좌
- title — VARCHAR(50) — NOT NULL — "오늘의 투자자" | "시즌 우승자"
- return_rate — DECIMAL(9, 4) — NOT NULL — 수상 근거가 된 수익률(%)
- announced_at — DATETIME — NOT NULL — 정산 발표 시각. 폐장에 확정되고 17:00 에 공개된다
chat_messages
- id — BIGINT — Primary key — NOT NULL — 메시지 식별자. 커서 페이지네이션의 정렬 키이기도 하다
- user_id — BIGINT — NOT NULL — 보낸 사람. FK 가 아니라 기록이다 — 탈퇴해도 메시지는 남아야 한다(기획서 2.4.6). 닉네임·아바타는 조회 시 users 를 조인해 얻고, 조인이 비면 "탈퇴한 사용자"로 렌더링한다
- content — VARCHAR(200) — NOT NULL — 금칙어 마스킹이 적용된 값을 저장한다. 차단이 아니라 마스킹이다 (기획서 12.2.2)
- tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 보낸 시점의 게임 시각. 나중에 "코로나 폭락 때 사람들이 뭐라고 했나"를 볼 수 있어야 한다
- sent_at — DATETIME — NOT NULL — 보낸 실제 시각
- deleted_at — DATETIME — 관리자 삭제 시각. 행을 지우지 않는다 — 커서 페이지네이션이 가리키는 지점이 사라지면 안 된다
- deleted_by — BIGINT — 삭제한 관리자. FK 를 걸지 않는다 — 그 관리자가 탈퇴해도 기록이 사라지거나 탈퇴가 실패하면 안 된다 (inquiries.answered_by 와 같은 판단)
chat_reports
- reporter_id — BIGINT — Primary key — NOT NULL — 신고자. FK 가 아니라 기록이다 — 탈퇴해도 신고는 관리자 큐에 남는다. PK 의 일부라 같은 사람의 반복 신고가 자동으로 1건이 된다
- message_id — BIGINT — Foreign key → chat_messages.id — NOT NULL — 신고 대상 메시지
- reason — VARCHAR(20) — NOT NULL — ABUSE | SPAM | OTHER
- created_at — DATETIME — NOT NULL — 신고 시각
daily_closes
- game_date — DATE — Primary key — NOT NULL — 게임 거래일. 이 종목이 그날 휴장이면 행 자체가 없다
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 대상 종목
- close_price — DECIMAL(20, 8) — NOT NULL — 분할 조정된 종가. 화면·체결·평가에 쓰이는 값은 전부 이것이다 (mkt.md §가격은 분할 조정된 값이다)
- raw_close — DECIMAL(20, 8) — NOT NULL — 조정 전 원본 종가. 버리지 않는다 — 조정 기준일(conflicts.md C-5)을 나중에 바꾸려면 원본이 있어야 하고, 없으면 그 결정이 되돌릴 수 없게 된다
daily_reports
- season_day — SMALLINT — Primary key — NOT NULL — 리포트 일차
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 대상 계좌
- daily_return — DECIMAL(9, 4) — NOT NULL — 당일 수익률(%). daily_settlements 와 같은 값
- execution_count — INT — NOT NULL — 당일 체결 건수
- total_fee_krw — DECIMAL(20, 4) — NOT NULL — 당일 수수료 합계(원화 환산). 거래 수수료만이며 환전 수수료는 제외
- realized_pnl_krw — DECIMAL(20, 4) — NOT NULL — 당일 실현 손익 합계(원화 환산)
- best_execution_id — BIGINT — Foreign key → executions.id — 실현 손익 상위 1건. 매도 체결이 없으면 NULL
- worst_execution_id — BIGINT — Foreign key → executions.id — 실현 손익 하위 1건
- pattern_tags — JSON — NOT NULL — 자동 태깅 결과 (고점 매수·저점 매도). 판정 기준(-10%)이 편성값이라 저장한다. 표시 전용이고 형태가 유동적이라 JSONB
- finalized_at — DATETIME — NOT NULL — 폐장 스냅샷 시각
daily_settlements
- season_day — SMALLINT — Primary key — NOT NULL — 확정된 일차
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 대상 계좌
- season_rank — INT — NOT NULL — 시즌 누적 수익률 기준 순위. 동점은 같은 순위를 주고 다음을 건너뛴다
- daily_rank — INT — NOT NULL — 당일 수익률 기준 순위
- season_return — DECIMAL(9, 4) — NOT NULL — 확정 시점 시즌 누적 수익률(%). 계좌 요약의 cumulativeReturn 과 같은 기준
- daily_return — DECIMAL(9, 4) — NOT NULL — 확정 시점 당일 수익률(%)
- total_valuation_krw — DECIMAL(20, 4) — NOT NULL — 확정 시점 총 평가액. 다음 날 일간 기준값의 출발점이기도 하다
- finalized_at — DATETIME — NOT NULL — 폐장 스냅샷 시각
exchanges
- id — BIGINT — Primary key — NOT NULL — 환전 식별자
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 환전한 계좌
- direction — VARCHAR(12) — NOT NULL — KRW_TO_USD | USD_TO_KRW
- rate — DECIMAL(12, 4) — NOT NULL — 적용 환율. 그 게임 거래일의 값이며 하루 안에서는 변하지 않는다
- send_amount — DECIMAL(20, 4) — NOT NULL — 보내는 통화 기준 금액. 받는 통화 기준으로 두면 수수료 역산과 반올림 방향이 애매해진다
- fee_rate — DECIMAL(9, 4) — NOT NULL — 적용된 환전 수수료율(%). 항상 0.05
- fee — DECIMAL(20, 4) — NOT NULL — 보내는 통화로 부과. 환전 수수료는 무료 타임 대상이 아니다 (기획서 6.7.4)
- receive_amount — DECIMAL(20, 4) — NOT NULL — 수령액. 받는 통화 기준
- tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 환전 시점의 게임 시각
- exchanged_at — DATETIME — NOT NULL — 환전 실제 시각
executions
- id — BIGINT — Primary key — NOT NULL — 체결 식별자. 응답의 executionId
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 체결된 계좌
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 체결된 종목
- order_id — BIGINT — Foreign key → orders.id — 예약에서 온 체결이면 그 주문. 시장가면 NULL
- order_type — VARCHAR(10) — NOT NULL — MARKET | LIMIT
- side — VARCHAR(4) — NOT NULL — BUY | SELL
- quantity — INT — NOT NULL — 체결 수량. 전량 체결이므로 주문 수량과 같다
- executed_price — DECIMAL(20, 8) — NOT NULL — 체결가 = 그 틱의 종가. 예약이라도 지정가가 아니다 (기획서 6.4.2)
- currency — CHAR(3) — NOT NULL — 결제 통화
- amount — DECIMAL(20, 4) — NOT NULL — 체결 금액 = 체결가 × 수량. 수수료를 포함하지 않는다
- applied_fee_rate — DECIMAL(9, 4) — NOT NULL — 체결 시점에 실제 적용된 요율(%). 파생으로 두면 안 된다 — 무료 타임 여부가 시점 의존이라 나중에 재계산하면 값이 달라진다
- fee — DECIMAL(20, 4) — NOT NULL — 부과된 수수료. 매수는 추가 차감, 매도는 대금에서 차감된다
- realized_pnl — DECIMAL(20, 4) — 실현 손익. 매도만 채워지고 매수는 NULL. 같은 이유로 저장한다 — 승률과 최고/최악 거래의 근거다 (기획서 13.1.3 · 13.3.2)
- tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 게임 시각. game_date 는 이 값으로 조인해 얻는다
- executed_at — DATETIME — NOT NULL — 실제 시각. 게임 시각과 둘 다 기록한다 — 전자는 사용자의 체험 순서, 후자는 시장에서 일어난 시점이다 (기획서 7.4.1)
fx_rates
- game_date — DATE — Primary key — NOT NULL — 게임 거래일
- usd_krw — DECIMAL(12, 4) — NOT NULL — 일별 매매기준율. 휴장이 어긋나는 날은 직전 거래일 값을 이월 적재한다
game_ticks
- tick_seq — BIGINT — Primary key — NOT NULL — 시즌 시작부터의 틱 순번. 1 씩 증가하며 클라이언트가 동기화 구멍을 감지하는 기준 (mkt.md 재접속 동기화)
- season_id — BIGINT — Foreign key → seasons.id — NOT NULL — 소속 시즌
- season_day — SMALLINT — NOT NULL — 이 틱이 속한 일차. 일간 리더보드·복기의 구간 경계
- game_date — DATE — NOT NULL — 이 틱이 확정하는 게임 거래일. 한국·미국 거래일의 합집합 (기획서 4.1.4)
- tick_at — DATETIME — NOT NULL — 실제 발생 시각. round(720초 × k ÷ N) 로 계산된 절대 시각이며 간격은 31~36초로 유동적이다
inquiries
- id — BIGINT — Primary key — NOT NULL — 문의 식별자
- user_id — BIGINT — Foreign key → users.id — NOT NULL — 작성자
- title — VARCHAR(100) — NOT NULL — 제목
- content — VARCHAR(2000) — NOT NULL — 본문
- status — VARCHAR(20) — NOT NULL — OPEN | ANSWERED. 중간 상태를 만들지 않는다
- answer — VARCHAR(2000) — 관리자 답변. 미답변이면 NULL
- answered_by — BIGINT — 답변한 관리자. FK 가 아니라 기록이다
- answered_at — DATETIME — 답변 시각
- created_at — DATETIME — NOT NULL — 작성 시각
- updated_at — DATETIME — NOT NULL — 마지막 수정 시각
instrument_metrics
- fiscal_quarter — CHAR(6) — Primary key — NOT NULL — 회계 분기. 2022Q1 형식
- metric_key — VARCHAR(30) — Primary key — NOT NULL — MARKET_CAP | PER | REVENUE_GROWTH | OPERATING_MARGIN | DEBT_RATIO 등
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 대상 종목. 주식만 행을 갖는다
- label — VARCHAR(30) — NOT NULL — 화면 표기 ("시가총액", "PER"). info.md 의 metrics.label
- disclosed_game_date — DATE — NOT NULL — 공시일 = 분기 종료일 + 45일. 게임 시각이 이 날 이후여야 노출된다 — 이 지연이 있어야 "실적 발표"가 게임 안의 사건이 된다 (기획서 9.1.2)
- value — DECIMAL(24, 6) — 지표 값. NULL 이면 산출 불가이며 화면에 N/A 로 표시한다 (기획서 9.1.3)
- unit — VARCHAR(10) — NOT NULL — KRW | USD | PERCENT | TIMES
instrument_splits
- ex_date — DATE — Primary key — NOT NULL — 분할 후 첫 거래일. 그날 종가는 이미 분할된 값이다
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 대상 종목
- ratio — DECIMAL(12, 6) — NOT NULL — 1주가 몇 주가 되는가. 4:1 분할은 4, 1:5 역분할은 0.2. 누적 계수는 이 값들의 곱이다
instruments
- id — BIGINT — Primary key — NOT NULL — 종목 식별자. 모든 응답의 instrumentId
- symbol — VARCHAR(20) — NOT NULL — 티커. 수집 파이프라인과 맞추는 키
- name — VARCHAR(100) — NOT NULL — 종목명. 화면 표시용
- category — VARCHAR(20) — NOT NULL — NASDAQ | KRX | CRYPTO. 탭 구분(화면)이며 결제 통화와는 별개 관심사다
- asset_type — VARCHAR(20) — NOT NULL — STOCK | ETF | INVERSE_ETF | IPO_STOCK | CRYPTO. 정보 카드 종류를 결정한다. 인버스 배수는 담지 않는다
- currency — CHAR(3) — NOT NULL — KRW | USD. 결제 통화 — 나스닥·코인은 USD, 국내는 KRW
- price_scale — SMALLINT — NOT NULL — 가격 소수 자릿수. 종목마다 다르다 (엔비디아 2, MATIC 4). 전부 통일하면 저가 코인의 등락이 안 보인다
- listed_game_date — DATE — IPO 종목의 상장 게임 거래일. 상시 종목은 NULL. 게임 시각이 이 날 이전이면 listingStatus 가 UPCOMING
- summary — VARCHAR(500) — NOT NULL — 사업·상품·프로젝트 개요 1~2줄 (기획서 9.1.1)
- info_card — JSON — ETF·코인의 정보 카드 (info.md 의 product / project). 자산 유형마다 형태가 달라 JSONB 로 둔다. 주식은 NULL 이고 instrument_metrics 를 쓴다
ipo_offerings
- id — BIGINT — Primary key — NOT NULL — 공모 식별자. 응답의 offeringId
- season_id — BIGINT — Foreign key → seasons.id — NOT NULL — 소속 시즌
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 공모 대상 종목. 공시 전에는 이 종목이 목록에 노출되지 않는다
- currency — CHAR(3) — NOT NULL — 증거금·공모가의 통화. 국내는 KRW, 나스닥은 USD
- offer_price — DECIMAL(20, 8) — NOT NULL — 공모가. 실제 데이터를 쓴다. 당첨 시 이 값이 그대로 평단이 된다
- deposit_amount — DECIMAL(20, 4) — NOT NULL — 청약 단위 = 증거금 100%. 국내 1,000만 원(시드의 10%), 나스닥은 상당 달러 고정액. 수량·금액 선택이 없다 (기획서 8.2.1~2)
- disclosure_tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 공시 틱. 이 이전에는 종목명조차 노출하지 않는다 (기획서 3.5.2)
- close_tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 청약 마감 틱. 마감 즉시 추첨한다
- listing_tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 상장 틱. 배정 물량이 이 시점에 포지션으로 전환된다 (기획서 8.5.2)
- allocation_rule — VARCHAR(300) — NOT NULL — 당첨 인원 산정 방식의 설명 문장. 비율이 편성값이라 숫자로 두고 프론트가 문장을 조립하면 편성이 바뀔 때마다 프론트를 고쳐야 한다
- winner_count — INT — 확정된 당첨자 수. 추첨 전에는 NULL. 전체 공지의 "○○○명 당첨"
- drawn_at — DATETIME — 추첨 실행 시각. 추첨 전에는 NULL 이며 status 판정에 쓰인다
ipo_subscriptions
- offering_id — BIGINT — Foreign key → ipo_offerings.id — NOT NULL — 청약한 공모
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 청약한 계좌
- deposit_amount — DECIMAL(20, 4) — NOT NULL — 잠긴 증거금. 신청 시점의 offering.deposit_amount 를 복사한다
- won — BOOLEAN — 추첨 결과. 추첨 전에는 NULL. 무작위라 재계산할 수 없어 저장한다
- allocated_quantity — INT — floor(증거금 ÷ 공모가). 낙첨이면 0 (기획서 8.5.1)
- allocated_amount — DECIMAL(20, 4) — 배정 금액 = 배정 수량 × 공모가. 상장 시 포지션의 취득 총액이 되어 평단이 공모가가 된다
- refunded_amount — DECIMAL(20, 4) — 반환액. 낙첨이면 증거금 전액이며 추첨 확정 즉시 반환해 상장일 매매 자금으로 쓸 수 있게 한다 (기획서 8.4.4)
- subscribed_at — DATETIME — NOT NULL — 신청 실제 시각
news
- id — BIGINT — Primary key — NOT NULL — 기사 식별자
- channel — VARCHAR(10) — NOT NULL — US | KR | CRYPTO
- headline — VARCHAR(200) — NOT NULL — 헤드라인. 티커가 이 값만 굴린다
- body — VARCHAR(1000) — NOT NULL — 본문 2~4문장. 미래를 아는 서술은 금지이며 검증이 불가능해 사람 검수에 의존한다 (기획서 10.5.1). 가격이 분할 조정값이므로 주가 절대값도 쓰지 않는다
- published_tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 발행 틱. 현재 tickSeq 이하인 기사만 노출한다
news_instruments
- news_id — BIGINT — Foreign key → news.id — NOT NULL — 기사
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 관련 종목
oauth_accounts
- id — BIGINT — Primary key — NOT NULL — 신원 식별자
- user_id — BIGINT — Foreign key → users.id — NOT NULL — 이 신원의 주인
- provider — VARCHAR(20) — NOT NULL — google | kakao. 둘은 별개 계정이며 연결 기능이 없다
- provider_user_id — VARCHAR(255) — NOT NULL — Provider 가 발급한 불변 고유 식별자(sub). 탈퇴 시 이 값의 해시가 withdrawn_identities 에 남는다
orders
- id — BIGINT — Primary key — NOT NULL — 예약 주문 식별자. 응답의 orderId
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 주문한 계좌
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 대상 종목
- side — VARCHAR(4) — NOT NULL — BUY | SELL
- limit_price — DECIMAL(20, 8) — NOT NULL — 지정가. 체결가는 이 값이 아니라 그 틱의 종가이며 차이는 항상 사용자에게 유리하다 (기획서 6.4.2)
- quantity — INT — NOT NULL — 주문 수량. 1주 단위 정수이며 부분 체결이 없어 그대로 체결된다
- currency — CHAR(3) — NOT NULL — 결제 통화. 주문 시점 종목의 통화를 복사한다
- locked_amount — DECIMAL(20, 4) — 매수만 채워진다. 지정가 × 수량 × (1 + 정상 수수료율)
- locked_quantity — INT — 매도만 채워진다. 잠긴 보유 수량. 매수·매도가 서로 다른 것을 잠그므로 금액과 한 컬럼에 합치지 않는다
- status — VARCHAR(10) — NOT NULL — OPEN | FILLED | CANCELLED | EXPIRED. 행을 지우지 않는다 — 폐장 자동 취소와 사용자 취소를 구분해 남긴다
- expires_at — DATETIME — NOT NULL — 당일 폐장 시각. 예약의 유효기간은 당일뿐이다 (기획서 6.2.4)
- created_tick_seq — BIGINT — Foreign key → game_ticks.tick_seq — NOT NULL — 등록 시점의 틱
- created_at — DATETIME — NOT NULL — 등록 실제 시각
- closed_at — DATETIME — 체결·취소·만료된 시각. status 가 OPEN 이면 NULL
positions
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 보유 계좌
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 보유 종목
- quantity — INT — NOT NULL — 보유 수량. 1주 단위 정수이며 소수 보유가 없다 (기획서 6.1.4)
- total_cost — DECIMAL(20, 4) — NOT NULL — 취득 총액(현지 통화)
season_days
- season_day — SMALLINT — Primary key — NOT NULL — 1 | 2 | 3
- season_id — BIGINT — Foreign key → seasons.id — NOT NULL — 소속 시즌
- from_game_month — CHAR(7) — NOT NULL — 그날 재생 시작 게임 월. YYYY-MM. 브리핑에서 이것만 공개한다
- to_game_month — CHAR(7) — NOT NULL — 그날 재생 종료 게임 월. 정산 발표 후 rpt.md 의 일차 목록에서 처음 공개된다
- opens_at — DATETIME — NOT NULL — 재생·거래 시작 실제 시각 (11:05)
- closes_at — DATETIME — NOT NULL — 폐장 실제 시각 (16:40). 조기 종료 시 앞당겨진다
- settled_at — DATETIME — 순위 확정 시각. NULL 이면 아직 확정 전
season_reports
- account_id — BIGINT — Foreign key → accounts.id — NOT NULL — 대상 계좌. 계좌가 시즌에 종속되므로 이것만으로 유일하다
- final_return — DECIMAL(9, 4) — NOT NULL — 최종 수익률(%). 3일차 폐장 시점 확정값
- max_drawdown — DECIMAL(9, 4) — NOT NULL — 최대 낙폭(%). 종가 틱 시계열의 원화 평가액 기준
- win_rate — DECIMAL(9, 4) — NOT NULL — 승률(%). 실현 손익이 양수인 매도 체결의 비율
- turnover — DECIMAL(9, 4) — NOT NULL — 회전율. 총 거래대금 ÷ 평균 자산
- total_fee_krw — DECIMAL(20, 4) — NOT NULL — 시즌 총 수수료(원화 환산)
- final_rank — INT — NOT NULL — 최종 순위
- finalized_at — DATETIME — NOT NULL — 3일차 폐장 스냅샷 시각
seasons
- id — BIGINT — Primary key — NOT NULL — 시즌 식별자
- name — VARCHAR(100) — NOT NULL — 시즌 표시 이름
- start_date — DATE — NOT NULL — 운영 시작일 (기획서 3.1.1)
- end_date — DATE — NOT NULL — 운영 종료일
- seed_krw — DECIMAL(20, 4) — NOT NULL — 시드 머니. 기획서 v0.7 기준 1억 원
- trade_fee_rate — DECIMAL(9, 4) — NOT NULL — 거래 수수료율(%). 0.15 = 0.15%. 무료 타임에는 0 이 적용된다
- exchange_fee_rate — DECIMAL(9, 4) — NOT NULL — 환전 수수료율(%). 0.05. 무료 타임 대상이 아니다
- ipo_winner_ratio — DECIMAL(9, 4) — NOT NULL — IPO 당첨 예정 인원 비율(%). 기본 30 (기획서 8.4.2)
- created_at — DATETIME — NOT NULL — 생성 시각
signal_criteria
- id — BIGINT — Primary key — NOT NULL — 판정 기준 식별자
- kind — VARCHAR(20) — NOT NULL — GROWTH | SAFETY | VALUATION — 세 가지 질문
- metric_key — VARCHAR(30) — NOT NULL — 판정에 쓰는 지표. 응답의 basisKeys 가 이 값이다
- level — VARCHAR(10) — NOT NULL — GOOD | NORMAL | CAUTION
- lower_bound — DECIMAL(24, 6) — 경계 하한(포함). NULL 이면 하한 없음. 서버 판정에만 쓰고 응답에 내리지 않는다
- upper_bound — DECIMAL(24, 6) — 경계 상한(미포함). NULL 이면 상한 없음
- description — VARCHAR(200) — NOT NULL — "매출 성장률 20% 이상" 같은 설명 문장. 숫자가 아니라 문장으로 두는 이유는 항목마다 표현 방식이 달라 템플릿으로 못 만들기 때문이다
- sort_order — SMALLINT — NOT NULL — 도움말에서의 표시 순서
test_users
- user_id — BIGINT — Foreign key → users.id — NOT NULL — 대상 사용자. 이 리포에서 유일하게 CASCADE 를 거는 FK 다
- name — VARCHAR(30) — NOT NULL — 안정된 핸들. 닉네임은 바뀌고 유일하지도 않아 키로 쓸 수 없다
- assigned_admin_id — BIGINT — NULL 이면 부하 테스트 전용. UNIQUE 라 DB 가 관리자 1:1 을 강제하고, 관리자가 탈퇴하면 배정이 자동 회수된다
user_restrictions
- id — BIGINT — Primary key — NOT NULL — 제한 식별자
- user_id — BIGINT — Foreign key → users.id — NOT NULL — 제한 대상 사용자
- restricted_until — DATETIME — NOT NULL — 제한 만료 시각
- reason — VARCHAR(200) — NOT NULL — 제한 사유. 관리자 기록용이며 사용자에게 그대로 보여주지 않는다
- created_by — BIGINT — 제한을 건 관리자. FK 를 걸지 않는 이유는 chat_messages.deleted_by 와 같다
- created_at — DATETIME — NOT NULL — 제한을 건 시각
users
- id — BIGINT — Primary key — NOT NULL — 사용자 식별자
- email — VARCHAR(255) — 표시용 이메일. IdP 가 주지 않으면 NULL 이다 (Kakao 는 항상 NULL). 식별자가 아니다
- nickname — VARCHAR(50) — NOT NULL — 표시 이름. 리더보드·채팅에 공개된다
- role — VARCHAR(20) — NOT NULL — USER | ADMIN. 세션 authorities 에 담기며 변경 시 해당 사용자의 세션을 무효화한다
- created_at — DATETIME — NOT NULL — 가입 시각
- updated_at — DATETIME — NOT NULL — 마지막 수정 시각
watchlists
- user_id — BIGINT — Foreign key → users.id — NOT NULL — 관심종목을 등록한 사용자
- instrument_id — BIGINT — Foreign key → instruments.id — NOT NULL — 대상 종목
- created_at — DATETIME — NOT NULL — 등록 시각
withdrawn_identities
- id — BIGINT — Primary key — NOT NULL — 탈퇴 이력 식별자
- season_id — BIGINT — Foreign key → seasons.id — NOT NULL — 탈퇴가 발생한 시즌. 다음 시즌부터는 다시 참가할 수 있다
- provider — VARCHAR(20) — NOT NULL — google | kakao
- provider_user_id_hash — CHAR(64) — NOT NULL — SHA-256(provider_user_id). 원본을 저장하지 않아 복원 불가
- withdrawn_at — DATETIME — NOT NULL — 탈퇴 시각