shuim
1b9257c4d2
## 배경 "전략이 혼란스럽고 현재와 맞지 않는다"를 조사한 결과, 전략 설계가 아니라 전략을 검증했다는 도구와 파라미터 소스가 어긋나 있었다. ## 파라미터 소스 단일화 - 우선순위가 adaptive > strategy_cfg(DB) > config.py 인데 문서는 맨 마지막인 config.py 를 기술하고 있었다. 11곳이 불일치(BULL RSI 46 vs DB 30, SL -7% vs -6%). - DEFAULT_PARAMS 를 config.py 에 정합 + alembic 0012 로 기존 DB 행 갱신 (운영자가 UI 로 바꾼 값은 보존, 옛 기본값과 같은 행만 갱신, 테이블 가드·멱등) ## 백테스트를 실전 로직에 정합 - calculate_adx_simple 이 정확히 period 배(14.0×) 발산 → Aggressive 게이트 `ADX>25` 가 전 레짐 100% 통과. 전환 빈도 5.6%→2.0%(-65%), 성과 상방 편향 - 백테스트 RSI 는 SMA, 실전은 Wilder → 진입 판정 10~11% 불일치 - us_backtest_engine RSI 1봉 지연 제거 (룩어헤드 없음을 절단 테스트로 증명) - backend/backtest_results/ 25건은 폐기 대상 (§8.4) ## 리스크 가드 복원 - 4% 절대 상한이 try 블록 안에 있어 예외 시 적응형 6~7% 가 통과 → try 밖으로 - 청산을 매수보다 먼저 평가 (보유 종목이 추천에 들면 손절 대신 물타기가 나갔다) - 리스크 가드 4개를 매수 전용화 → MDD -10%·보유한도 도달 시에도 손절 작동 - MDD 갱신 5회 연속 실패 시 신규 진입 차단 fail-safe (청산은 계속 허용) - 스윙 청산이 DT 보유분까지 매도하던 문제, sell_pct 기준 혼재 정정 ## 죽은 코드 제거 (2,695줄) - short_term_strategy, kosdaq_scanner, app/strategy/ 패키지 - app/trading/ + korea_investment_api_adapter (real_market_api 정본은 korea_investment_api.py:1482, adapter 는 import 0건) ## 지표·사이징 단일화 (수치 무변경 증명) - indicators_core.py: 3,274건 비교 최대 오차 0.000e+00 - sizing_core.py: 42,105건 비교 불일치 0 - 미국 전략 상수 13개 config 편입 (hex 까지 동일, 3,168 케이스 전수 비교) ## 테스트 안전 (실 KIS 호출 차단) - 유닛 테스트가 실제 KIS 에 매도 주문을 2회 전송하고 있었다. 리팩터링이 close_stale_positions 의 대상을 _execute_exit → _execute_exit_stale 로 바꿨는데 목이 전자에 걸려 빗나갔다. test_api_endpoints 도 캡처된 싱글톤 참조 누수로 실제 잔고 조회를 타 141초를 소비했다. - backend/tests/conftest.py 신설: 주문·토큰·시세·잔고를 호출 즉시 예외로 차단. 예외는 BaseException 파생(프로덕션 except Exception 폴백에 삼켜지지 않게), 클래스 메서드에 적용(캡처된 참조까지 덮음), DATABASE_URL `_test` 가드 강제 - 전체 유닛 스위트: 365초/6 failed → 11.8초/0 failed (소켓 차단 하 559 passed) ## 신규 (둘 다 플래그 OFF, 백테스트 미검증) - range_trading_strategy.py — SIDEWAYS 담당 전략이 없던 빈 칸. 미배선 - check_bear_buy_signal_v2 — BEAR 4중 AND(발화율 2.3%) → 점수제(12.4%) ## 문서 - CLAUDE.md 를 실제 코드 기준으로 재작성. §0 파라미터 우선순위, §4.1 테스트 규약, §6.4 문서화되지 않았던 진입 차단 게이트 9종, §8.4 백테스트 폐기 근거, §8.5 미해결 19항목 - 루트 md 6개 → 2개(docs/ 이동), 중복 배치 문서 병합, 스테일 worktree 제거 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
81 lines
3.2 KiB
Python
81 lines
3.2 KiB
Python
"""섹터 매핑 캐시 수집 배치 (CLAUDE.md §8.5 항목 8)
|
|
|
|
네이버 업종 API에서 전 종목 업종 → 정본 섹터 라벨을 수집해
|
|
`~/.cache/auto-stock/sector_map.json` 에 적재한다. 적재된 캐시는
|
|
`sector_mapper.get_sector()`(동기·네트워크 없음)를 통해 correlation_filter
|
|
§5.1 섹터캡 판정에 쓰인다.
|
|
|
|
사용법:
|
|
python collect_sector_map.py # 수집 + 캐시 기록 + 커버리지 리포트
|
|
python collect_sector_map.py --dry-run # 수집만 (캐시 파일 미기록)
|
|
python collect_sector_map.py --coverage-only # 기존 캐시로 커버리지만 측정 (네트워크 최소)
|
|
|
|
Cron 권장 (상장/업종 변경 반영 — 하루 1회로 충분):
|
|
30 8 * * 1-5 cd /path/to/auto-stock/backend && python collect_sector_map.py
|
|
|
|
주의: DB 를 쓰지 않는다(파일 캐시 전용) → db_worker 경유 규칙 대상 아님.
|
|
"""
|
|
|
|
import argparse
|
|
import asyncio
|
|
import logging
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
sys.path.insert(0, str(Path(__file__).parent))
|
|
|
|
from app.core.json_helpers import _dumps # noqa: E402
|
|
from app.services import sector_mapper # noqa: E402
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
async def _universe_codes(max_pages: int = 10) -> list:
|
|
"""커버리지 측정용 유니버스(네이버 시총 상위 KOSPI+KOSDAQ) 종목코드."""
|
|
try:
|
|
from app.services.naver_finance import get_naver_stock_list
|
|
stocks = await get_naver_stock_list(max_pages_per_market=max_pages)
|
|
return [code for code, _name in stocks]
|
|
except Exception as exc:
|
|
logger.warning("유니버스 조회 실패 (커버리지 측정 생략): %s", exc)
|
|
return []
|
|
|
|
|
|
async def main() -> int:
|
|
parser = argparse.ArgumentParser(description="섹터 매핑 캐시 수집")
|
|
parser.add_argument("--dry-run", action="store_true", help="캐시 파일에 기록하지 않음")
|
|
parser.add_argument("--coverage-only", action="store_true", help="수집 없이 커버리지만 측정")
|
|
parser.add_argument("--no-coverage", action="store_true", help="커버리지 측정 생략(유니버스 조회 안 함)")
|
|
parser.add_argument("--universe-pages", type=int, default=10, help="시장별 유니버스 페이지 수 (기본 10=~500종목/시장)")
|
|
args = parser.parse_args()
|
|
|
|
if not args.coverage_only:
|
|
result = await sector_mapper.refresh_sector_map(write_cache=not args.dry_run)
|
|
print(_dumps({"refresh": result}))
|
|
if not result.get("ok"):
|
|
logger.error("섹터 맵 수집 실패 — 기존 캐시/정적 표 폴백 유지")
|
|
return 1
|
|
|
|
if args.no_coverage:
|
|
return 0
|
|
|
|
universe = await _universe_codes(args.universe_pages)
|
|
coverage = sector_mapper.get_coverage(universe or None)
|
|
print(_dumps({"coverage": coverage}))
|
|
|
|
pct = coverage.get("universe_coverage_pct")
|
|
if pct is not None:
|
|
logger.info(
|
|
"섹터 커버리지 %.2f%% (%s/%s) — 80%% 이상이면 SECTOR_CAP_UNMAPPED_ENABLED 검토 가능",
|
|
pct, coverage.get("universe_covered"), coverage.get("universe_size"),
|
|
)
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
logging.basicConfig(
|
|
level=logging.INFO,
|
|
format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
|
|
)
|
|
sys.exit(asyncio.run(main()))
|