한투 호가 = 2번째 앱키 전용 키 없거나 start 실패 시 메인에 H0STASP0 안 붙임. 운영설정 WS_ORDERBOOK_SAVE_KIS 빨간 danger. LS RAM 합집합 후보∪보유∪영구∪grace. sync_targets와 split reconcile 둘 다. 틱 DB 영구 게이트는 그대로. 분봉 쓰레기 → 다음 소스 봉 통째 그 분 틱 0건이거나 전부 봉끝 대비 LIVE_FEED_FALLBACK_MAX_AGE_SEC 초과면 구멍. 메인 WS → 2차 → LS → REST → rollup. CANDLE_GARBAGE_FALLBACK 기본 true. 파일: feed_fallback.py(신규), ws_manager.py, kis_ws.py, candle_series.py, bt_candle_source.py, live_config_schema.py, database.py, 스모크, MD 2개. 같은 ws_manager/database/kis_ws/live_config에는 직전 커밋 이후 쌓여 있던 시세 폴백·ENV 키 정리도 같이 들어갔습니다. 파일 단위로 나눌 수 없어서입니다.
38 lines
2.1 KiB
Plaintext
38 lines
2.1 KiB
Plaintext
---
|
|
description: docs/like_mcp.md 지도 필수 참조 · MD vs MCP/grep 역할 · 변경 시 MD stale 방지 (체크리스트 본문은 문서에만)
|
|
alwaysApply: true
|
|
---
|
|
|
|
# like_mcp 문서 지도 (중복 없는 포인터)
|
|
|
|
체크리스트·ERD·의존성 **본문은 여기에 복사하지 말고** 아래 파일만 연다.
|
|
정합·DB adhoc·웹 재시작·Optuna 운영 세부는 기존 룰(`.cursorrules` CRITICAL, `live-backtest-optuna-parity`, `db-adhoc-query-safety` 등)을 따른다.
|
|
|
|
## 1. 필수 문서 (`docs/like_mcp.md/`)
|
|
|
|
| 문서 | 경로 | 언제 |
|
|
|------|------|------|
|
|
| 수정 가이드 | `docs/like_mcp.md/MODIFICATION_GUIDE.md` | **수정 전** — 유형별 필수 grep·사이드이펙트 |
|
|
| 아키텍처 맵 | `docs/like_mcp.md/code_architecture.md` | 구조·허브·import 영향 범위 |
|
|
| DB ERD | `docs/like_mcp.md/db_erd.md` | 테이블/컬럼 지도 (실행 전 스키마는 실DB `SHOW COLUMNS` — `db-adhoc-query-safety`) |
|
|
|
|
주석/docstring만 바꾸는 경우가 아니면, 수정 전 `MODIFICATION_GUIDE.md`의 해당 유형 grep을 **실제로 실행**해 파일 목록을 확정한다. MD는 “어디를 찾을지” 지도일 뿐.
|
|
|
|
## 2. MD vs MCP / 도구 (토큰)
|
|
|
|
1. **거시(Layer·Hub·영향 범위)** → `docs/like_mcp.md/` 목차·관련 섹션만.
|
|
2. **미시(현재 소스·API)** → MCP(`kis-code-assistant` 등) 또는 Grep/부분 Read. 거대 파일 통째 읽기 지양.
|
|
3. **수정 범위 확정** → 가이드의 grep 후 그 결과로만 패치.
|
|
|
|
## 3. 코드 변경 후 MD 갱신 (stale 방지)
|
|
|
|
| 변경 | 갱신 |
|
|
|------|------|
|
|
| 파일 추가·삭제·이동 / import 구조 | `code_architecture.md` |
|
|
| DB 테이블·컬럼 | `db_erd.md` |
|
|
| ENV·params 키 / 전략 추가·삭제 | `MODIFICATION_GUIDE.md` 체크리스트 (± architecture) |
|
|
|
|
재생성 스크립트는 `MODIFICATION_GUIDE.md` 하단 표를 따른다.
|
|
완료 보고에 실매·웹백테·파람 영향 여부를 명시한다 (세부 절차는 `live-backtest-optuna-parity` 등 기존 룰).
|
|
중요 실매/인프라 수정 후 스모크: `.cursor/rules/live-execution-validation.mdc` (`scripts/test_live_execution_validation.py` 1회).
|