모의 주식 트레이딩 서비스 — ERD

MVP 동작 매트릭스 확정

조회는 언제나 전 종목 가능하고, 거래는 "해당 시장 정규장 + 상위 100" 에만 허용됩니다. 판정 기준은 보는 사람의 시각이 아니라 그 종목이 속한 시장이 열려 있는가입니다 — 한국 낮에 엔비디아를 열면 미국장이 닫혀 있으므로 전일 종가가 나갑니다.

엔드포인트별 호출 계획 2026-08 문서 기준

테이블별 데이터 출처

배치 일정 확정

users 회원계정계

account 모의 투자 계좌계정계

포트폴리오 초기화의 단위입니다. 초기화 시 이 행을 지우지 않고 회차를 올린 새 행을 만듭니다.

trade_order 주문 + 체결계정계

MVP는 시장가 즉시 체결이라 주문과 체결이 한 행입니다. 지정가를 도입하면 체결 부분을 trade_execution 으로 분리하게 됩니다. 거절된 주문도 남깁니다 — 사용자에게 "왜 안 됐는지" 설명하려면 필요합니다.

ledger_entry 거래 원장계정계

예수금이 움직인 모든 사건을 기록합니다. UPDATE 와 DELETE 를 하지 않는 것이 이 테이블의 존재 이유입니다. 잘못 기록했으면 수정하지 말고 반대 부호 항목을 넣어 상쇄합니다.

holding 보유 종목계정계

원장에서 파생되는 집계입니다. 이론적으로는 원장을 재생하면 복원할 수 있지만, 조회 성능을 위해 별도로 유지합니다. 계좌+종목당 한 행입니다.

daily_account_snapshot 일별 자산 스냅샷계정계

1주차에는 화면에 쓰지 않지만 배치는 지금 넣으세요. 매일 장 마감 후 한 줄씩 쌓는 단순한 작업인데, 이게 없으면 2주차에 자산 추이 그래프를 그릴 과거 데이터가 아예 없습니다. 거래 내역으로 역산하려면 과거 시점의 모든 시세가 필요해 현실적이지 않습니다.

stock 종목 마스터

내부 stock_id 를 정규 식별자로 삼고, 외부 심볼은 매핑 테이블로 분리합니다. 하루 1회 배치로 갱신합니다.

quote_snapshot 현재가 스냅샷

전 종목을 1행씩 담습니다 — 약 8,500행 고정. 이력을 쌓지 않고 계속 UPDATE 하므로 시계열 테이블이 아닙니다.

이렇게 하면 화면 로직이 하나로 통일됩니다. 상세 페이지는 종목이 상위 100 이든 아니든 항상 이 테이블만 조회하고, quote_at 을 보고 문구만 바꿉니다. "이 종목이 상위 100 인가?"를 화면이 알 필요가 없어집니다.
거래 가능 판정은 별도입니다 — stock.is_ranked AND 해당 시장 정규장 중 AND 거래정지 아님.

daily_candle 일봉TimescaleDB 하이퍼테이블

용도가 둘입니다 — 일봉 차트와 prev_close 의 원천. 장 마감 직후 수집해 그날 봉을 확정하고, 그 close_price 가 다음 장 시작 전 quote_snapshot.prev_close 로 복사되어 등락률의 기준이 됩니다.
100종목 × 250거래일 = 연 2.5만 행. 10년을 쌓아도 25만 행입니다.

CREATE MATERIALIZED VIEW candle_1w WITH (timescaledb.continuous) AS
SELECT stock_id,
       time_bucket(INTERVAL '1 week', trade_date) AS bucket,
       first(open_price, trade_date)              AS open_price,
       max(high_price) AS high_price, min(low_price) AS low_price,
       last(close_price, trade_date)              AS close_price,
       sum(volume)                                AS volume
  FROM daily_candle GROUP BY stock_id, bucket;

minute_candle 분봉하이퍼테이블 — 2주차

1주차에는 온디맨드로 채웁니다. 사용자가 종목 상세를 열 때 /candles?interval=1m 을 호출하고, 받은 봉을 이 테이블에 넣은 뒤 60초 동안은 DB 에서 바로 내려줍니다. 테이블이 저장소이자 캐시 역할을 겸합니다.
비용은 동시 시청 30명 기준 0.5 req/s — MARKET_DATA_CHART 20 TPS 의 2.5% 입니다. 상시 적재(1.67 req/s)보다 오히려 싼데, 아무도 안 보는 종목까지 1분마다 긁을 이유가 없기 때문입니다.

exchange_rate 환율일반 테이블

시세는 quote_snapshot 에 UPDATE 하므로 이력이 없지만, 환율은 그래프를 그려야 해서 시점별로 쌓습니다. 다른 테이블과 FK 로 연결되지 않습니다 — 원장에 필요한 환율은 "그때 그 값"이지 참조가 아니어야 하기 때문입니다. 나중에 환율 데이터를 정정해도 과거 체결 기록은 흔들리면 안 됩니다.

stock_external_id 소스별 심볼 매핑

같은 삼성전자를 토스는 005930, DART 는 00126380 으로 부릅니다. 지금 만들어두면 나중에 소스를 추가하거나 교체해도 도메인 코드를 고칠 일이 없습니다. 비용은 거의 0 인데 나중에 넣으려면 이미 짠 코드를 전부 손대야 합니다.

유형(배타적) × 속성(태그) 조합

배당주는 유형이 아니라 속성입니다. KB금융은 배당주이면서 개별주이므로 한 컬럼에 넣으면 표현할 수 없습니다. 그래서 유형과 태그를 분리했습니다.

Phase 1 주문 접수동결

Phase 2 주문 체결확정

거래 비용 매수는 수수료만 · 매도는 시장별로 다름확정

// .env — 요율은 여기가 유일한 정의 지점. DB 에는 없다.
FEE_RATE      = 0.0001       0.01% · 매수/매도 · 국내/미국 공통
K_TAX_RATE    = 0.002        한국 증권거래세 0.2%
A_TAX_RATE    = 0.0000206    미국 SEC Fee · $20.60 per million
A_TAX_MIN_USD = 0.01         미국 최소 수수료

// 계산 — 결과값만 trade_order.fee / trade_order.tax 에 저장
매수        net = gross + fee                                    tax 는 두 시장 모두 0
매도(국내)  net = gross − fee − k_tax
매도(미국)  net = gross − fee − a_tax

  fee   = gross × FEE_RATE
  k_tax = gross × K_TAX_RATE
  a_tax = max(gross × A_TAX_RATE, A_TAX_MIN_USD × 환율)