From cc063afdb9db81f26b8ca4b181128d240ec5720a Mon Sep 17 00:00:00 2001 From: Justin Ko Date: Sun, 7 Jun 2026 16:01:08 +0900 Subject: [PATCH] =?UTF-8?q?docs(release):=20REL-003=20=EA=B2=80=EC=A6=9D?= =?UTF-8?q?=20=ED=95=9C=EA=B3=84/=EB=AF=B8=EA=B2=80=EC=A6=9D=20=EC=98=81?= =?UTF-8?q?=EC=97=AD=20=EB=AA=85=EC=8B=9C=20(=EC=9A=B4=EC=98=81=EC=9E=90?= =?UTF-8?q?=20=ED=95=B8=EB=93=9C=EC=98=A4=ED=94=84)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 배포 차단 아님 전제로 실 KIS 쓰기 경로 4가지 미검증을 Verification Checklist에 명시: LIVE 체결→ledger 미실증, kill_switch LIVE 미실행, 실 2-인스턴스 동시기동 미검증, 거래일 성공 LIVE 주문 0건 + 운영 DB 최초 적용. + 배포 후 차기 거래일 실증 권고. Co-Authored-By: Claude Opus 4.8 --- ...l-003_20260607_safety-killswitch-multi-instance.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/releases/rel-003_20260607_safety-killswitch-multi-instance.md b/docs/releases/rel-003_20260607_safety-killswitch-multi-instance.md index 920fd7c..bcfcdb6 100644 --- a/docs/releases/rel-003_20260607_safety-killswitch-multi-instance.md +++ b/docs/releases/rel-003_20260607_safety-killswitch-multi-instance.md @@ -48,6 +48,17 @@ - `instance_key="default"` 무회귀 + `portfolio_hub_token` TOML 주입(S-5). - **차기 거래일 실 KIS**: safety-sell 트리거(SL/TP·forced_close·장 마감) + kill_switch 실매도 → 상황별 에러/체결 관찰. (다중 인스턴스 운영 시) directed 격리 + broadcast manual 확인. +### 검증 한계 / 미검증 영역 (운영자 핸드오프 — 배포 후 차기 거래일/스테이징 실증 대상) + +> 아래는 배포 차단 사유가 아니라, 운영자가 무엇이 검증됐고 무엇이 안 됐는지 알고 배포하도록 명시한 한계다. 자동화(단위 271 + 인프라 게이트 301) + paper 실데몬 e2e + 읽기전용 LIVE 시세는 통과했으나, **실 KIS 쓰기(체결) 경로**는 아래가 미실증이다. + +1. **LIVE 체결 → ledger 기록 미실증**: 모든 LIVE KIS 주문이 휴장(현충일/주말) 거부라 실제 fill 이 발생하지 않음 → `fill → ledger outbox → portfolio-hub` 경로가 실 KIS 환경에서 한 번도 실행되지 않음(REL-001 이월 잔여와 동일 성격). paper e2e 에서만 검증됨. +2. **kill_switch LIVE 미실행**: kill-switch full cycle 은 paper 데몬 e2e 로만 검증. 실 KIS `kill_switch` 실매도 제출 경로는 (SL/TP LIVE e2e 와 달리) LIVE 로 미실행. — SL/TP 와 동일한 `SlotService.sell()`→execution→KIS submit 경로를 공유하므로 간접 신뢰는 있으나 직접 LIVE 관찰은 없음. +3. **실 2-인스턴스 동시 기동 미검증**: directed 라우팅 격리(S-2)/broadcast(S-3)는 실 RabbitMQ 토폴로지(raw pika)로 확인했으나, 실제 `trex-core-daemon --config` **데몬 2개 동시 구동**으로 split-brain 방지(NFR-3)를 실증하진 않음. 현재 배포는 단일 인스턴스(`instance_key="default"`) 기준. +4. **거래일 성공 LIVE 주문 0건 + 운영 환경 최초 적용**: LIVE 주문은 전부 휴장 거부라 실 거래 세션 full-stack 성공 사례 없음. `--config` 필수화(파괴적 기동 변경)와 `005_*.sql` 마이그레이션의 **운영 `trex_core` DB 적용**은 본 배포가 최초(테스트는 `trex_core_test`). + +권장 후속(배포 후): 차기 거래일에 (a) safety-sell/kill_switch 실 체결 1건 + ledger 기록 확인, (b) 운영 DB 마이그레이션 004/005 적용 로그 확보, (c) 다중 인스턴스 도입 시 2-인스턴스 라우팅 실증. + ## Release Execution Evidence - Release Status Transition Target: released