캡스톤
테이블 (14)
거래 내역 (transaction_history)
- 거래 고유 번호 (transation_id) — VARCHAR(100) — 기본 키 — NOT NULL
- 거래 발생 시점 (transaction_time) — TIMESTAMPTZ(3) — NOT NULL
- 거래 유형 (transaction_type) — TEXT — NOT NULL — 입금, 출금
- 거래 방향 (transaction_side) — VARCHAR(10) — NOT NULL
- 거래 금액 (transaction_amount) — DECIMAL(25,2) — NOT NULL
- 체결 수량 (transaction_volume) — DECIMAL(20,8) — NOT NULL
- 체결 금액 (transaction_price) — DECIMAL(20,8) — NOT NULL
- 잔액 (after_balance) — DECIMAL(25,2) — NOT NULL
- 수수료 (transaction_fee) — DECIMAL(20,8) — NOT NULL
- 거래소 주문 ID (exchange_order_id) — TEXT — NOT NULL
- 고유 계좌 식별자 (account_id) — SERIAL — 외래 키 → 계좌 정보.고유 계좌 식별자 — NOT NULL
- 시그널 고유 ID (signal_id) — SERIAL — 외래 키 → 시그널(전략 및 리스크 관리).시그널 고유 ID — NOT NULL — 시그널 기록의 고유 ID
계좌 정보 (account)
- 고유 계좌 식별자 (account_id) — SERIAL — 기본 키 — NOT NULL
- 계좌 별칭 (account_label) — VARCHAR(50) — NOT NULL
- 계좌 유형 (account_type) — VARCHAR(20) — NOT NULL
- 기준 통화 (base_currency) — VARCHAR(10) — NOT NULL
- 초기 자산 금액 (initial_balance) — DECIMAL(38,18) — NOT NULL
- 현재 사용 가능 금액 (availiable_balance) — DECIMAL(38,18) — NOT NULL
- 실현 손익 합계 (realized_pnl) — DECIMAL(38,18) — NOT NULL
- 계좌 상태 (account_status) — VARCHAR(10) — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
리스크 관리( 전략 및 파라미터 관리 영역) (risk_management)
- 리스크 고유 ID (risk_id) — BIGSERIAL — 기본 키 — NOT NULL — 리스크 관리 레코드 고유 ID
- 최대 허용 손실 (max_drawdown) — DECIMAL(10,4) — NOT NULL — 최대 허용 손실 비율
- 최대 포지션 크기 (max_position_size) — DECIMAL(18,8) — NOT NULL — 최대 포지션 크기
- 손절 기준 (stop_loss_ratio) — DECIMAL(10,4) — NOT NULL — 손절 기준 비율 (%)
- 익절 기준 (take_profit_ratio) — DECIMAL(10,4) — NOT NULL — 익절 기준 비율 (%)
- 리스크 지수 (risk_score) — DECIMAL(6,3) — 리스크 지수 (평가 값)
- ATR 기준 기간 (atr_period) — INT — ATR 기준 기간 (변동성 계산용)
- ATR 보정 계수 (atr_muliplier) — DECIMAL(6,3) — ATR 손절 익절 보정 계수
- 포지션 모드 (positon_mode) — VARCHAR(10) — NOT NULL — 포지션 모드
- 상태 (status) — VARCHAR(10) — NOT NULL — 'ACTIVE' 혹은 'DISABLED' 와 같은 상태
- 생성 시각 (created_at) — TIMESTAMPTZ(3) — NOT NULL — 데이터가 만들어진 시각
- 전략명 (strategy_name) — VARCHAR(100) — 외래 키 → 전략 파라미터 관리 (전략 및 리스크 관리 영역).전략명 — NOT NULL
백테스트 결과/메타 (백테스팅 영역) (core_backtest_results)
- 백테스트 ID (backtest_id) — BIGSERIAL — 기본 키 — NOT NULL — 개별 백테스트 실행을 구분하는 고유 식별자
- 테스트에 사용된 파라미터 (parameters) — JSONB — NOT NULL — 백테스트 실행시 적용된 전략 변수 값
- 테스트 시작일 (test_start_date) — DATE — NOT NULL — 백테스트가 시작된 일자
- 테스트 종료일 (test_end_date) — DATE — NOT NULL — 백테스트가 종료된 일자
- 누적 수익률 (total_return_pct) — DECIMAL(8,4) — NOT NULL — 테스트 기간 전체의 총 수익률
- 연환산 수익률 (annual_return_pct) — DECIMAL(8,4) — NOT NULL — 누적 수익률을 연 단위로 환산한 수익률
- 샤프 지수 (sharpe_ratio) — DECIMAL(8,4) — NOT NULL — 위험 대비 수익 효율성을 나타내는 지표
- 승률 (win_rate_pct) — DECIMAL(8,4) — NOT NULL — 전채 거래 중 수익을 낸 비율(%)
- 거래 수 (trade_count) — INT — NOT NULL — 테스트 중 발생한 총 거래 횟수
- 리포트 저장 경로 (report_path) — TEXT — NOT NULL — 백테스트 결과 리포트 파일이 저장된 경로
- 최대 낙폭 (max_down_pct) — DECIMAL(8,4) — NOT NULL — 테스트 기간 중 최대 손실률 (Maximum Drawdown)
- 생성 시각 (created_at) — TIMESTAMPTZ(3) — NOT NULL — 백테스트 결과 기록된 시점
- 전략명 (strategy_name) — VARCHAR(100) — 외래 키 → 전략 파라미터 관리 (전략 및 리스크 관리 영역).전략명 — NOT NULL
보조 지표 ( 보조 지표 영역) (indicator_data)
- 보조 지표 ID (indicator_id) — SERIAL — 기본 키 — NOT NULL — 테이블을 식별하는 컬럼
- 캔들 봉의 시작 시간 (time) — TIMESTAMPTZ(3) — 외래 키 → 차트 정보 (시세 데이터 영역).캔들 봉의 시작 시간 — NOT NULL — 집계 시간, 캔들 봉이 시작되는 시점
- RSI (rsi_data) — DECIMAL(18,8) — NOT NULL — RSI 지표에 대한 결과
- 이동평균선 (ma_data) — DECIMAL(18,8) — NOT NULL — 이동평균선 지표에 대한 결과
- VMA (vma_data) — DECIMAL(18,8) — NOT NULL — 거래량 이동평균선 지표에 대한 결과
- ATR (atr_data) — DECIMAL(18,8) — NOT NULL — 평균 변동폭 지표에 대한 결과
- MACD (macd_data) — DECIMAL(18,8) — NOT NULL — 이동평균 수렴 ・ 확산 지수에 대한 결과
- 볼린저 밴드 (bollinger_band_data) — DECIMAL(18,8) — NOT NULL — 볼린저 밴드 지표에 대한 결과
- 스토캐스틱 (stochastic_data) — DECIMAL(18,8) — NOT NULL — 스토캐스틱 지표에 대한 결과
- 생성 시간 (created_at) — TIMESTAMPTZ(3) — NOT NULL — 계산 결과 생성 시간
시그널(전략 및 리스크 관리) (signal_data)
- 시그널 고유 ID (signal_id) — SERIAL — 기본 키 — NOT NULL — 시그널 기록의 고유 ID
- 거래쌍 (pair) — INT — NOT NULL — 거래 대상 거래 쌍
- 시그널의 종류 (signal_type) — VARCHAR(10) — NOT NULL — 매수,매도,포지션 종료 등 시그널의 종류
- 진입 희망 가격 (entry_type) — DECIMAL(25,10) — NOT NULL — 시그널 생성 시점의 진입 희망 가격
- 청산 가격 (target_price) — DECIMAL(25,10) — NOT NULL — 목표 수익 달성 시 청산 가격
- 제한 가격 (stop_loss_price) — DECIMAL(25,10) — NOT NULL — 손절매를 위한 제한 가격
- 거래할 비중 (quantity_ratio) — DECIMAL(5,4) — NOT NULL — 거래할 자본금의 비중
- 고유 계좌 식별자 (account_id) — SERIAL — 외래 키 → 계좌 정보.고유 계좌 식별자 — NOT NULL
- 전략명 (strategy_name) — VARCHAR(100) — 외래 키 → 전략 파라미터 관리 (전략 및 리스크 관리 영역).전략명 — NOT NULL
- 보조 지표 ID (indicator_id) — SERIAL — 외래 키 → 보조 지표 ( 보조 지표 영역).보조 지표 ID — NOT NULL
- 생성시점 (created_at) — TIMESTAMPTZ(3) — NOT NULL — 시그널이 생성된 시점
시스템 로그 테이블 (system_log)
- 시스템 로그 ID (system_log_id) — BIGSERIAL — 기본 키 — NOT NULL — 시스템 로그를 식별
- 로그 레벨 (system_log_level) — VARCHAR(30) — NOT NULL — INFO, WARNING, ERROR 등을 저장
- 에이전트 ID (agent_name) — VARCHAR(30) — NOT NULL — 로그를 생성한 에이전트의 이름을 식별하는 필드
- 로그 메세지 (system_log_message) — TEXT — NOT NULL — 로그 내용 전체를 저장하는 필드
- 시각 (created_at) — TIMESTAMPTZ(3) — NOT NULL — 로그가 생성된 시점
에러 발생 기록 (error_history)
- 에러 식별 (error_id) — BIGSERIAL — 기본 키 — NOT NULL — 시스템에서 발생한 각 에러 기록의 고유 식별자
- 에이전트 ID (agent_name) — VARCHAR(30) — NOT NULL — 에러가 발생한 에이전트의 이름
- 에러 코드 (error_code) — VARCHAR(20) — NOT NULL — DB 연결 실패, API 응답 실패, 주문 실패 등 코드화 된 오류형을 저장
- 에러 설명 (description) — TEXT — NOT NULL — 에러에 대한 상세한 설명 또는 스택 트레이스 및 디버깅 및 모니터링 핵심 정보 저장
- 발생 시각 (occured_at) — TIMESTAMPTZ(3) — NOT NULL — 에러가 발생한 시간을 기록
에이전트 상태 테이블 (agent_status)
- 에이전트 고유 id (agent_name) — VARCHAR(30) — 기본 키 — NOT NULL
- 상태 (agent_status) — VARCHAR(20) — NOT NULL — running,stopped,error 등 상태
- 마지막 생존 신호 (last_heartbeat) — TIMESTAMPTZ(3) — NOT NULL — 마지막 생존 신호
- 최근 에러 메시지 (last_error) — TEXT — 최근 에러 메시지
- 갱신 시각 (updated_at) — TIMESTAMPTZ(3) — NOT NULL — 업데이트 시간
- cpu 사용률 (cpu_use) — DECIMAL(5,2)
- 메모리 사용률 (memory_use) — DECIMAL(7,2)
원장 엔트리 (가상 원장 영역)) (ledger_entry)
- 원장 항목 고유 ID (entry_id) — BIGSERIAL — 기본 키 — NOT NULL
- 트랜잭션 고유 ID (txn_id) — BIGSERIAL — 외래 키 → 원장 트랜잭션 헤더(가상 원장 영역).트랜잭션 고유 ID — NOT NULL — 원장 거래 단위를 식별하는 내부 고유 ID
- 이벤트 발생 시간 (timestamp) — TIMESTAMPTZ(3) — NOT NULL
- 거래 방향 (Field) — VARCHAR(10) — NOT NULL — BUY/SELL/OPEN/CLOSE
- 체결 가격 (price) — DECIMAL(20,8) — NOT NULL
- 거래 수량 (qty) — DECIMAL(20,8) — NOT NULL
- 수수료 (fee) — DECIMAL(20,8)
- 해당 거래로 발생한 pnl (realized_pnl) — DECIMAL(20,8)
- 거래 이후 총 잔고 (balance_after_trade) — DECIMAL(20,8) — NOT NULL
- 거래 후 보유 수량 (position_size) — DECIMAL(20,8)
- 거래 후 평균 단가 (avg_entry_price) — DECIMAL(20,8)
- 거래 사유 (discription) — TEXT
- 생성 시각 (cteated_at) — TIMESTAMPTZ(3) — NOT NULL
원장 트랜잭션 헤더(가상 원장 영역) (ledger_txn)
- 트랜잭션 고유 ID (txn_id) — BIGSERIAL — 기본 키 — NOT NULL — 원장 거래 단위를 식별하는 내부 고유 ID
- 원장 시작 잔고 (start_balance) — DECIMAL(20,8) — NOT NULL
- 현재 잔고 (current_balance) — DECIMAL(20,8) — NOT NULL
- 누적 실현 손익 (realized_pnl) — DECIMAL(20,8) — NOT NULL
- 현재 미실현 손익 (unrealized_pnl) — DECIMAL(20,8) — NOT NULL
- 최대 낙폭 (mdd) — DECIMAL(10,4)
- 총 거래 횟수 (trade_count) — INT — NOT NULL
- 원장 시작 시간 (start_time) — TIMESTAMPTZ(3) — NOT NULL
- 원장 종료 시간 (end_time) — TIMESTAMPTZ(3)
- 생성 시각 (created_at) — TIMESTAMPTZ(3) — NOT NULL
- 갱신 시각 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
- 전략명 (strategy_name) — VARCHAR(100) — 외래 키 → 전략 파라미터 관리 (전략 및 리스크 관리 영역).전략명 — NOT NULL
전략 파라미터 관리 (전략 및 리스크 관리 영역) (core_strategy_params)
- 전략명 (strategy_name) — VARCHAR(100) — 기본 키 — NOT NULL
- 현재 값 (parameters_value) — VARCHAR(255) — NOT NULL — 실제 적용 중인 설정값 기록
- 숫자 값 (value_num) — DECIMAL(18,8) — NOT NULL — 수치 계산이 필요한 경우 사용
- 파라미터 적용 시작 (effective_start) — TIMESTAMPTZ(3) — NOT NULL — 해당 파라미터가 적용되기 시작한 시점
- 파라미터 적용 종료 (effective_end) — TIMESTAMPTZ(3) — NOT NULL — 해당 파라미터 적용이 종료되는 시점
- 업데이트 주체 (updated_by) — VARCHAR(100) — NOT NULL — 파라미터를 변경한 주체 추적
- 갱신 시각 (updated_at) — TIMESTAMPTZ(3) — NOT NULL — 파라미터가 마지막으로 갱신된 시각
- 파라미터 키 (parameters_key) — VARCHAR(100) — NOT NULL — 전략 내부 변수 명 저장
차트 정보 (시세 데이터 영역) (ohlcv_data)
- 캔들 봉의 시작 시간 (time) — TIMESTAMPTZ(3) — 기본 키 — NOT NULL — 집계 시간, 캔들 봉이 시작되는 시점
- 시가 (open_price) — DECIMAL(25,10) — NOT NULL — 기간의 첫 번째 거래 가격
- 고가 (high_price) — DECIMAL(25.10) — NOT NULL — 해당 기간 동안의 최고가
- 저가 (low _price) — DEMICAL(25,10) — NOT NULL — 해당 기간 동안의 최저가
- 종가 (close_price) — DEMICAL(25,10) — NOT NULL — 기간의 마지막 거래 가격
- 거래량 (volume) — DECIMAL(30,10) — 해당 기간 동안의 거래 수량
- 거래 대금 (quote_volume) — DECIMAL(30,2) — 특정 기간 동안 발생한 거래들의 법정화폐 단위로 환산한 총 거래 금액
- 기간 내 총 거래 횟수 (trade_count) — BIGINT — NOT NULL — 거래 빈도
- 데이터 저장 시각 (created_at) — TIMESTAMPTZ(3) — NOT NULL — 데이터를 저장한 시각
- 봉의 시간 간격 (time_trace) — VARCHAR(20) — NOT NULL — 캔들 봉의 시간 간격
하드리밋 조정/ 산출 근거 로그( 백테스팅 영역) (core_backtest_log)
- 로그 ID (log_id) — BIGSERIAL — 기본 키 — NOT NULL — 리스크 계산 또는 검증 결과를 구분하는 고유 식별자
- 계좌 (account_id) — BIGINT — NOT NULL — 해당 로그가 속한 계좌 정보
- 관련 리밋 키 (limit_key) — VARCHAR(100) — NOT NULL — 연결된 리스크 제한(한도) 규칙의 참조 키
- 계산 결과 (computed_value) — JSONB — NOT NULL — 리스크 평가나 계산된 수치 결과
- 계산 근거 (source) — VARCHAR(50) — NOT NULL — 결과 산출에 사용된 기준 또는 수식의 설명
- 상세 파라미터 (details) — JSONB — NOT NULL — 계산 시 입력된 변수나 설정값
- 생성 시각 (created_at) — TIMESTAMPTZ(3) — NOT NULL — 로그가 기록된 시점
- 백테스트 ID (backtest_id) — BIGSERIAL — 외래 키 → 백테스트 결과/메타 (백테스팅 영역).백테스트 ID — NOT NULL — 개별 백테스트 실행을 구분하는 고유 식별자