Skip to content

feat: 트랙레코드 재시작 도구 — 자본 결정(A안) 원클릭 실행 준비#427

Merged
easygap merged 1 commit into
mainfrom
feat/track-record-restart-tool
Jun 11, 2026
Merged

feat: 트랙레코드 재시작 도구 — 자본 결정(A안) 원클릭 실행 준비#427
easygap merged 1 commit into
mainfrom
feat/track-record-restart-tool

Conversation

@easygap

@easygap easygap commented Jun 11, 2026

Copy link
Copy Markdown
Owner

배경

#422 자본 결정(A/B/C)의 어느 쪽이든 운영 중 구성 변경에는 트랙레코드 재시작이 필요합니다(NAV 점프 방지 — 평가 기준서 권장). 지금까지는 재시작 수단이 없었습니다.

내용 — tools/restart_basket_track_record.py

  • 비파괴: 삭제가 아니라 <키>@archived-<날짜>로 이전 — 아카이브 기록은 평가·게이트(정확 키 매칭)에서 자연 제외
  • 가역: --undo --archive-suffix <값> --apply로 복원, 살아있는 키에 기록 존재 시 섞임 방지 fail-closed
  • dry-run 기본

A안 선택 시 실행 절차 (3단계)

1) config/baskets.yaml의 kr_diversified_hold에  initial_capital: 30000000  추가
2) .venv\Scripts\python.exe tools/restart_basket_track_record.py --basket kr_diversified_hold        # dry-run 확인
3) 같은 명령 + --apply  →  다음 일일 사이클부터 새 자본·새 시계열 (0/60 재시작)

평가 자본 정합(#426)이 이미 머지돼 있어 레버를 켜도 판정 왜곡이 없습니다.

검증

테스트 3건(dry-run 무변경 / 아카이브↔undo 왕복 / 오염 방지 차단) — 전체 1526 passed

자본 레버(A안) 등 운영 중 구성 변경 시 NAV 시계열 점프를 피하려면 재시작이
필요하다(평가 기준서 권장 절차). 이 도구는 기존 기록을 삭제하지 않고
account_key/strategy를 '<키>@archived-<날짜>'로 이전한다:
- 가역: --undo --archive-suffix <값> --apply로 복원 (살아있는 키에 기록이
  있으면 섞임 방지 fail-closed)
- 아카이브 기록은 평가·게이트(정확 키 매칭)에서 자연 제외 — 새 시계열만 판정
- dry-run 기본, --apply 명시 시에만 변경

A안 실행 절차(도구 docstring에 명시): yaml에 initial_capital 추가 → dry-run
확인 → --apply → 다음 사이클부터 새 자본·새 시계열(0/60 재시작).

테스트 3건(dry-run 무변경 / 아카이브→undo 왕복 / 살아있는 기록 위 undo 차단).
전체 1526 passed.
@easygap easygap merged commit ece7437 into main Jun 11, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant