Reelay 기능명세 v1
vv1업데이트: 2025-11-05 00:00:00 UTC연구 준비 → 리스크/집행 → 전략/포트폴리오 → 검증 → 실거래 → 모니터링 전과정을 아우르는 실무 명세. 본 JSON은 개발 레퍼런스/페이지 렌더링 및 API/DB/운영 기준으로 사용합니다.
0. 공용(Global Core Specification)
전역 표기/스키마/로깅/진행도 정책
- 표기 규칙: [MARKET] 이름 (CODE), 6자리 정규화(normalizeCode)
- 메타: CodeMeta {code, name, market, sector, style, themes[], ...}
- 스키마 버저닝: schema_ver, 스냅샷/시드/codeHash/paramsHash 보존
- 로깅 표준: {event, step, ms, payloadSize, success, warn?, traceId, commitSha}
- 진행률: (완료스텝/전체)×100, BiLabel(ko/en) 지원
공통 UI 규칙
- 단계 카드 레이아웃 통일: 헤더/메트릭/업데이트시간
- 표준 필드: progress(%), resultSummary, finalComment, explain(요약/세부/주의)
- 인쇄 모드 지원: 헤더 고정 해제, 페이지 나눔 제어(A4 기준)
역할/플랜 배지 정책
Beginner/Pro/PRO(요금제) 가시성 매트릭스
- Beginner: 기초 학습 경로 우선, 위험 노출 축소
- Pro: 연구/검증/집행 속도 최적화 UI 우선
- PRO 플랜: 프로 전략/최적화/집행/리스크 고급 기능 사용 가능
i18n / A11y
- 문구는 key 기반 번역(JSON)으로 관리, 날짜·숫자 클라이언트 포맷
- 키보드 탐색/ARIA 라벨, 대비/폰트크기 확대 대응
- 차트 색상 팔레트는 색각보정 프리셋 제공
Ⅰ. API 공통 규약
엔벨로프/에러/페이지네이션/정렬/필터/레이트리밋/Idempotency
- Base: /api/v1
- Envelope: { ok: boolean, data?: any, error?: ErrorResponse, meta?: Pagination }
- 오류코드: E400_VALIDATION, E401_UNAUTH, E403_FORBIDDEN, E404_NOT_FOUND, E409_CONFLICT, E429_RATELIMIT, E500_INTERNAL
- 페이지네이션: cursor 기반 우선(next, prev, limit), 필요 시 offset 허용
- 정렬/필터: sort=field:asc|desc, filter[market]=KOSPI&filter[style]=value
- 레이트리밋: 사용자/키/경로 단위 RPM, 초과 시 429 + Retry-After
- Idempotency-Key 헤더 지원(POST/PUT/PATCH/DELETE), 24h 캐시
인증/권한
- JWT(Bearer) + 서버 검증, 기한 24h, Refresh 별도
- RBAC: role ∈ {viewer, editor, pro, admin}, scope 세분화
- 감사로그: who, when, what, before/after(snapshotId) 저장
Ⅱ. 연구 준비 (Research Foundation)
① 종목 유니버스 (Universe Scan)
관심 종목/소스를 선택하고 스캔으로 유니버스를 정의합니다. (정제/필터는 후속 단계)
- 입력: 소스(시장/템플릿/CSV/즐겨찾기), 선택 심볼
- 출력: UniverseResult {symbols[], metaMap, summary, diagnostics, explain}
- 검증: 이름매칭 ≥98%, 시장/템플릿 쿼터 확인
- 용량 가이드: 리스트/편집/템플릿 간 수량 일치 정책
- API: GET /universe/templates, GET /universe/templates/:id, GET /universe/lookup, POST /universe/resolve
② 데이터 파이프라인 (Data Pipeline)
- 증분 수집 & 리트라이: 30→60→120s backoff, 부분 재처리
- 품질 기준: 커버리지 ≥97%, 결측 ≤3% PASS
- 스케줄/모니터링: 상태 대시보드, 지연 경보
- API: POST /pipeline/build, GET /pipeline/status
③ 전략 코어 세트 (Strategy Core)
- 전략군: trend / reversion / momentum / event
- 출력: StrategyCoreResult {strategyStats[], signals[], explain}
- 검증: 유효 시그널 비율 <50% 경고, 데이터 커버리지 점검
- 파라미터 프리셋 관리 및 버전 고정
④ 앙상블 랩 (Ensemble Lab)
- 상관행렬→클러스터링→가중치 산출(Σweights≈1)
- 효율 프론티어, 평균상관 ≤0.3 유지
- API: POST /strategy/ensemble/optimize
Ⅲ. 리스크·집행 (Risk & Execution)
⑤ 리스크 엔진 (Risk Engine)
- 규칙: VolTarget/ATRCap/DailyLossCap/SectorLimit
- 편차 ±5% 초과 시 Fail-safe(주문 차단) + 알림
- API: POST /risk/calc, POST /risk/check
- 리스크 이벤트는 StepResult.warnings 및 risk_events 테이블 반영
⑥ 주문 집행 게이트웨이 (Execution Gateway)
- 전략: TWAP/POV/IOC/FOK
- 목표: 체결률 ≥85%, 슬리피지 ≤0.3%
- 출력: ExecResult {fillRate, slipStats, resendRate, explain}
- 브로커별 레이트리밋/세션 관리, 재전송 규칙
Ⅳ. 전략·포트폴리오 (Strategy & Portfolio)
⑦ 프로 전략 (Pro Strategy)
- 튜닝/백테스트, params+pnlCurve+metrics 저장
- 경고 기준: Sharpe<0.5 또는 MDD>25%
- 체결모델/비용/슬리피지 시뮬레이션 옵션
⑧ 포트폴리오 연구실 (Portfolio Lab)
- Equal/RP/MinVar/TargetVol, 가중합 1.0±0.001
- Sharpe 개선율/음수비중/턴오버 제약
- 공분산: EWMA/Ledoit, 박스 제약 지원
Ⅴ. 검증 체계 (Validation Framework)
⑨ 최적화 실험실 (Optimize Lab)
- Grid/Random/Bayes, 분산 큐, maxTrials=50
- 개선도(Sharpe Δ), 수렴도 모니터
- 탐색 결과는 워크포워드로 이어짐
⑩ 워크포워드 검증 (Walk-Forward)
- 롤링 분할: Train→(Valid)→Test 반복
- IS/OOS 편차 ≤20% 유지, fold별 저장
- 폴드 길이 합 ≤ 데이터 길이
Ⅵ. 실거래 준비 (Live Readiness)
⑪ 브로커 연결/키 (Broker Setup)
- KMS/Secrets 관리, 레이트리밋 프로파일
- 키 유효성 점검/회전 정책(90일)
⑫ 페이퍼/섀도 (Paper & Shadow)
- 평가기간 ≥60영업일, KPI≥80% 유지
- 실시간 리스크 이벤트 연동
⑬ 실거래 체크리스트 (Live Checklist)
- 총점 ≥90% PASS, Fail-safe 이벤트 자동 Fail
- 법적 고지 및 사용자 확인 절차
Ⅶ. 모니터링 (Monitoring)
⑭ 멀티 리플레이 (Multi Replay)
- 리밸런스 규칙 위배율 >5% 경고, 슬리피지 >0.3% 강조
- 여러 종목/전략 동시 비교 차트
관측성(Logs/Traces/Metrics)
- 분산 트레이싱: traceId/parentId/spanId 전파
- 메트릭: p50/p95 지연, 오류율, 처리량, 큐 대기시간
- 알림: 임계치 초과 시 Slack/Email/Webhook
SLO/SLA
- API 가용성 99.9%, p95 응답 800ms 이하
- 데이터 파이프라인 지연 p95 10분 이하
- 위반 시 런북 자동 링크/알림
Ⅷ. 성과·결론 체계
- StepResult: progress, metrics, grade, warnings, recommendations, impactScore, resultSummary, finalComment, aiComment, nextStepHint, updatedAt
- Overall Summary: overallProgress, passRate, totalWarnings, highlight, issues, finalGrade, overallComment
등급 정책
- A: 목표 ≥95% 달성, 주요 경고 없음
- B: 목표 85~95%, 경미 경고
- C/D: 미달/중대 경고 → 개선 권고
Ⅸ. 운영·보안·API·DB·DoD
운영 체크리스트
- 증분수집/재시도/백오프
- 백업/모니터링/알림
- 성능 목표/용량 계획
- 릴리즈 프로세스: blue/green + 롤백 스위치
API 설계
- OpenAPI 경로 고정, Swagger 문서화
- 버전 관리: /v1, 호환 경고 헤더
- 예외/에러 코드 정책 표준화, 샌드박스 키 제공
DB 핵심 테이블
- step_results, strategy_runs, portfolio_runs, risk_events, exec_orders
- 불변 스냅샷: inputs_snapshot, params_snapshot
- 마이그레이션 버전·다운그레이드 경로 필수
Definition of Done (단계별 통과 기준)
- 연구 준비: 커버리지/결측/이름매칭 기준 PASS
- 리스크/집행: 슬리피지/체결률 목표 충족
- 검증: IS/OOS 편차, 워크포워드 결과 만족
- 실거래 준비: 체크리스트 점수 ≥90%
Ⅹ. 인쇄/배포 가이드
- 인쇄 시 숨김: .header-sticky, .toc-sticky, .btn, .input-group
- 페이지 나눔 제어: section-card, metrics에 page-break-inside: avoid
- 용지: A4, 여백 12mm
본 페이지는 내부 개발 레퍼런스용입니다. 제공되는 명세/가이드는 연구·교육 목적의 참고 정보이며, 투자 자문이 아닙니다. 실거래 전 충분한 사전 검증을 권장합니다.
© 2025 Reelay