Files
trex-core/docs/batches/bat-012_20260607_kill-switch-control/index.md
T
genichinandClaude Opus 4.8 941d324899 docs(release): REL-002/003 feedback-captured + 포함 batch released 정합
REL-002(BAT-009)·REL-003(BAT-010~013) 을 released→feedback-captured 로 전환해
REL-001/004 와 동일한 완료(종착) 상태로 정합. REL-002 Feedback Handoff 빈
플레이스홀더 정리(tooling 릴리즈, Discovery/REQ Input=없음). 포함 batch
BAT-009~013 release-candidate→released(register + 개별 index) — 누락 정정.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 13:59:41 +09:00

2.8 KiB

BAT-012: 비상 정지/kill-switch — 제어 채널 + 범위별 청산 + 당일 제외 masking/resume

  • Status: released
  • Profile: standard
  • Source Discovery: dcy-008
  • Included REQ: REQ-043, REQ-044, REQ-045, REQ-046, REQ-047
  • Excluded REQ: REQ-030 (BAT-008 released 포함, 옵션 D 는 portfolio-hub#8 후 별도 change-req)

Summary

  • dcy-008(비상 정지/강제 청산 kill-switch) 전체를 단일 standard batch 로 delivery 한다. 운영자가 trex.control.req 제어 채널로 portfolio/전역 단위 holding 슬롯을 즉시 청산하고 당일 전략 실행에서 제외하며(다음 거래일 자동 복귀 + 수동 resume), 기존 SlotService.sell()(REQ-036)·outbox·execution 인프라를 재사용한다. 구성: 제어 채널 + action dispatch(REQ-043), day-scoped 제외 store + 마이그레이션(REQ-044), kill_switch 실행(REQ-045), 당일 제외 masking + 자동복귀 + resume_kill_switch(REQ-046), baseline 3문서 정합(REQ-047).

Scope

  • In Scope:
    • trex.pause.req → trex.control.req 제어 채널 확장 + action dispatch(pause/resume/list 유지 + kill_switch/resume_kill_switch 추가) (REQ-043)
    • 신규 killswitch_exclusion 테이블 + 005_*.sql additive 마이그레이션 + 전용 store 어댑터 (REQ-044)
    • kill_switch 실행: 범위별(portfolio/전역) holding 순차 SlotService.sell() + REQ-036 idempotency + 발동 이력 로깅 (REQ-045)
    • 당일 제외 masking(snapshot envelope mask = pending|warning|pause|killswitch_today) + 다음 거래일 자동 복귀 + resume_kill_switch 수동 해제 (REQ-046)
    • baseline 3문서(interface-contract/runtime-flows/project-structure) 정합 (REQ-047)
  • Out of Scope:
    • pending_buy 슬롯 롤백 (dcy-008 OQ-3 Deferred — 기본 구현 HOLDING 한정)
    • 부분 수량 청산 (GitHub #5 별도 Discovery)
    • kill-switch 발동 후 자율 안전 매도(dcy-007/REL-003) 비활성화 — 두 경로 독립
    • 제어 큐 rename 의 기존 클라이언트 호환 정책 확정 — release 단계 결정(REQ-043 Notes)

Documents

Notes

  • Source discovery 단일(dcy-008). OQ-1(제어 채널)·OQ-2(별도 테이블)·OQ-4(수동 resume) Answered, OQ-3(pending_buy) REQ Deferred.
  • NFR-1(청산 지연)·NFR-2(dcy-007 독립)는 REQ-045 AC-7/8, NFR-3(영속 masking)은 REQ-046 AC-5 로 흡수(별도 NFR REQ 없음).
  • 기존 자산 재사용: SlotService.sell()(REQ-036/BAT-010), outbox·execution worker, pause masking 패턴(portfolio.py). 호출 진입점·제어 채널·day-scoped store 만 신규.
  • REQ-047(문서 정합)은 REQ-043~046 구현 완료 후 verification 단계 수행(REQ-042 선례).