trex/trex-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(core-A): reconcile-warning durable store + blocking gate (BAT-050, REQ-102/103/104/107/108)

Browse Source 
B/C 불일치 시 슬롯을 durable 차단(ReconcileWarningStore)하고 전략 intent 경로에
pause∨reconcile_warned 게이트를 추가한다. 안전망(safety-sell/kill-switch/watchdog)
경로는 SlotService 직접 호출로 게이트를 구조적으로 우회(OQ-B 확정).
SlotState enum/전이표/wire 계약 필드는 불변, reconcile_warned 필드만 additive 추가.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHtM5Ws1HKCKQ4JGi6GRb5
This commit is contained in:
genichin
2026-06-26 00:43:04 +09:00
co-authored by Claude Sonnet 4.6
parent 35f3147250
commit c193388198
17 changed files with 1410 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/batches/bat-050_20260626_reconcile-warning-blocking-gate-core-a/design.md
+145
View File
@@ -0,0 +1,145 @@
# BAT-050 Design
- Status: confirmed
- Batch: BAT-050
## 1. ReconcileWarningStore 포트 위치 결정
**결정: `application/portfolio.py` 내에 Protocol + InMemory 통합.** pause_store 선례와 동형으로, 포트와 인메모리 구현을 `portfolio.py`에 함께 둔다. PostgreSQL 어댑터는 `adapters/portfolio/reconcile_warning_store.py`에 별도 파일.
이유: `PauseStore Protocol`과 `InMemoryPauseStore`가 `portfolio.py`에 있는 패턴을 그대로 따른다. 파일 분산 없이 선례 일관성 유지.
## 2. ReconcileWarningStore 인터페이스 설계
```python
class ReconcileWarningStore(Protocol):
def set_warned(self, slot_id: str, *, portfolio_id: str, case_code: str,
actor: str = "reconcile", reason: str = "") -> None: ...
def clear_warned(self, slot_id: str) -> None: ...
def is_warned(self, slot_id: str) -> bool: ...
def list_warned(self) -> set[str]: ... # set of slot_id strings
```
- PK: `slot_id` (문자열 UUID)
- `case_code`: `'B'` (슬롯↔브로커 qty 불일치) 또는 `'C'` (원장↔브로커 불일치)
- `list_warned()`: set[str] 반환 — bulk 조회 후 `slot_to_dict`에서 in-operator 체크
## 3. SQL 마이그레이션 스키마
```sql
CREATE TABLE IF NOT EXISTS slot_reconcile_warning (
slot_id TEXT PRIMARY KEY,
portfolio_id TEXT NOT NULL,
case_code TEXT NOT NULL,
actor TEXT NOT NULL DEFAULT 'reconcile',
reason TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
```
ON CONFLICT DO UPDATE: 동일 slot_id의 중복 삽입 시 case_code/actor/reason/updated_at 갱신.
## 4. reconcile_positions C 케이스 slot_id 조회
**결정: reconcile_positions에 `slot_repo` Optional 파라미터 추가.**
현재 `reconcile_positions`는 portfolio_id 단위로 동작. C 케이스 차단 시 slot_id가 필요. `slot_repo.find_slot_by_portfolio(instance_key, portfolio_id)` 로 조회.
- `slot_repo=None`이면 기존 동작(in-memory warning만) 유지 — 하위 호환.
- `instance_key` 파라미터도 추가 (Optional, default="default").
## 5. 안전망 경로 분리 구조 확인
**확인: safety-sell / kill-switch / watchdog는 `_admit_*` 게이트를 거치지 않는다.**
- `SafetySellService`: `SlotService.sell()` 직접 호출 → `transit_slot(HOLDING → PENDING_SELL)` 경유. `IntentService._admit_sell` 미경유.
- `KillSwitchService.fire()`: `SlotService` 직접 → `IntentService` 미경유.
- Watchdog 만료 → `SafetySellService` 경유 → 위와 동일.
따라서 `IntentService._admit_buy`/`_admit_sell`에만 reconcile-warning 게이트를 추가하면 구조적으로 안전망 차단 예외가 보장된다. 별도 우회 플래그 불필요.
## 6. IntentService warn_store 의존성 추가
```python
class IntentService:
def __init__(
self,
...,
warn_store: Optional[ReconcileWarningStore] = None,
) -> None:
...
self._warn_store = warn_store
```
`_admit_buy`/`_admit_sell`에서:
```python
if self._warn_store is not None and self._warn_store.is_warned(str(slot.slot_id)):
return IntentDecision(intent.intent_id, "rejected", None, "reconcile_warned")
```
게이트 순서: pause 체크 → reconcile_warned 체크 → 기존 capacity/state 체크.
## 7. slot_to_dict reconcile_warned 필드
bulk 조회 패턴 채택 (N+1 방지):
```python
def slot_to_dict(
s,
*,
snapshot_store=None,
watchdog_store=None,
pause_store=None,
warn_store=None, # ReconcileWarningStore (선택)
watchdog_timeout_sec=120,
) -> dict:
...
warned_set = warn_store.list_warned() if warn_store is not None else set()
d["reconcile_warned"] = str(s.slot_id) in warned_set
```
`make_slots_rpc_handler`에서 `warn_store`를 한 번 받아 `slot_to_dict` 호출 시 전달.
## 8. IntentService pause 게이트 현황 확인
현재 `_admit_buy`/`_admit_sell`에는 pause 체크가 없다. pause 차단은 `messaging_handlers.py`의 handler 레벨에서 처리된다고 예상했으나 실제 코드 확인 결과 `IntentService` 내부에는 pause 체크가 없고, `make_intent_rpc_handler`에도 pause 체크가 없다.
**실제 pause 차단 위치 재확인 필요**: 기존 pause 게이트가 `_admit_*` 외부에 있을 수 있다. 구현 시 pause 체크와 동일 위치에 reconcile_warned 체크를 배치한다.
REQ-104 AC-1: "IntentService._admit_buy 및 _admit_sell 수행 시 ... reconcile_warned ... rejected" → IntentService 내부에 두는 것이 REQ 명세를 그대로 따르는 방향. pause 게이트도 이 기회에 IntentService 내부로 통합.
## 9. daemon.py 배선 범위
- `ReconcileWarningStore` 인스턴스 생성 (PostgreSQL 또는 InMemory — 환경)
- `SnapshotScheduler` 생성 시 `warn_store` 주입
- `IntentService` 생성 시 `warn_store` 주입
- `make_slots_rpc_handler` 호출 시 `warn_store` 주입
## 10. wire 계약 영향 (NFR-4 확인)
- `SlotState` enum: 변경 없음.
- `ALLOWED_TRANSITIONS`: 변경 없음.
- `trex.slots.req` 응답: `reconcile_warned: bool` 필드 **additive 추가**. 기존 클라이언트(orb/tsl)가 이 필드를 무시해도 JSON 파싱은 정상 동작(추가 필드는 파이썬 dict에서 무시됨). trex-orb-v1/trex-tsl-v1이 slots 응답을 `pydantic` 또는 `TypedDict`로 엄격 파싱하는지 확인 필요 — 불가피하면 팀장에게 보고. (현재 추정: dict 직접 접근 방식으로 추가 필드 무시 → 하위 호환)
- `trex.intent.req` 응답: `reason="reconcile_warned"` 신규 reason 코드 추가. 기존 클라이언트는 unknown reason에 대해 rejected로만 처리하므로 하위 호환.
## 11. 로깅 구조 (REQ-107)
차단 전이 시 (`set_warned` 호출 지점, `reconciliation.py`):
```python
_log.warning(
"reconcile_warning set: slot_id=%s portfolio_id=%s symbol=%s "
"case_code=%s broker_qty=%s slot_qty=%s actor=%s",
slot_id, portfolio_id, symbol, case_code, broker_qty, slot_qty, actor,
)
```
해제 전이 시 (`clear_warned` 호출 지점, 향후 sync/verify CLI — core-B):
```python
_log.info(
"reconcile_warning cleared: slot_id=%s portfolio_id=%s symbol=%s actor=%s",
slot_id, portfolio_id, symbol, actor,
)
```
REQ-084(구조화 로깅) 기반: `logging_setup.py`의 JSON formatter와 일관. key=value 형식으로도 필터링 가능.
docs/batches/bat-050_20260626_reconcile-warning-blocking-gate-core-a/implementation.md
+64
View File
@@ -0,0 +1,64 @@
# BAT-050 Implementation
- Status: done
- Batch: BAT-050
## 변경 파일 목록
### 신규 파일
- `trex_core/adapters/persistence/sql/016_create_slot_reconcile_warning.sql` — DB 마이그레이션
- `trex_core/adapters/portfolio/reconcile_warning_store.py` — PostgreSQLReconcileWarningStore
- `tests/application/test_reconcile_warning_store.py` — ReconcileWarningStore 단위 테스트
- `tests/application/test_reconcile_warning_blocking.py` — B/C 차단 + 게이트 통합 테스트
### 변경 파일
- `trex_core/application/portfolio.py` — ReconcileWarningStore Protocol + InMemoryReconcileWarningStore + slot_to_dict warn_store 파라미터 + reconcile_warned 필드
- `trex_core/application/reconciliation.py` — reconcile_core_holdings B케이스 durable 차단 + reconcile_positions C케이스 durable 차단 + 구조화 로그
- `trex_core/application/snapshot_scheduler.py` — warn_store 파라미터 추가 + reconcile 호출 시 전달
- `trex_core/application/intents.py` — warn_store 파라미터 + _admit_buy/_admit_sell reconcile-warning 게이트
- `trex_core/application/messaging_handlers.py` — make_slots_rpc_handler warn_store 파라미터 + slot_to_dict 전달
- `trex_core/adapters/portfolio/__init__.py` — PostgreSQLReconcileWarningStore export
- `trex_core/runtime/daemon.py` — warn_store 인스턴스 생성 + intent_service/snapshot_scheduler/slots_rpc_handler 배선
## 핵심 구현 요약
### 1. ReconcileWarningStore (REQ-102)
- Protocol: `set_warned(slot_id, *, portfolio_id, case_code, actor, reason)`, `clear_warned(slot_id)`, `is_warned(slot_id)`, `list_warned() -> set[str]`
- InMemoryReconcileWarningStore: 테스트용, threading.Lock 보호, dict 기반 upsert
- PostgreSQLReconcileWarningStore: `slot_reconcile_warning` 테이블, ON CONFLICT DO UPDATE, PK=slot_id
- SQL 마이그레이션 `016_create_slot_reconcile_warning.sql`
### 2. B/C 차단 전이 (REQ-103)
- `reconcile_core_holdings`: elif bq != 0 and slot.qty != bq (B case) → `warn_store.set_warned(case_code='B')`
- `reconcile_positions`: hub_total != broker_total (C case) + slot_repo 주입 시 → `warn_store.set_warned(case_code='C')`
- A case (broker flat): 기존 SlotState.ERROR 전이 유지, warn_store 미사용
- 모든 파라미터 Optional — None 시 기존 WARN 로그 동작 유지 (하위 호환)
### 3. 전략 차단 게이트 (REQ-104)
- `IntentService.__init__`: `warn_store=None` Optional 파라미터 추가
- `_admit_buy`: slot 조회 직후 `warn_store.is_warned(slot_id)` → rejected("reconcile_warned")
- `_admit_sell`: slot 조회 직후 동일 게이트
- 안전망 경로 차단 예외(OQ-B): safety_sell/kill_switch/watchdog → SlotService.transit_slot() 직접 호출 → IntentService._admit_* 미경유 → 구조적 우회 보장
- `slot_to_dict`: `warn_store.list_warned()` 벌크 조회, `reconcile_warned: bool` 필드 추가 (additive, NFR-4)
- `make_slots_rpc_handler`: `warn_store: Optional[ReconcileWarningStore]` 파라미터 추가
### 4. 구조화 로그 (REQ-107)
- B 케이스: `WARNING reconcile_warning set: slot_id=... portfolio_id=... symbol=... case_code=B broker_qty=... slot_qty=... actor=reconcile`
- C 케이스: `WARNING reconcile_warning set: slot_id=... portfolio_id=... symbol=... case_code=C hub_qty=... broker_qty=... actor=reconcile`
- A 케이스 알람: 기존 REQ-100 경로 그대로 (확인: 기존 alarm_emitter.publish_alarm("core_holding_broker_flat", ...) 유지)
### 5. daemon.py 배선 순서 조정
- warn_store 생성을 pause_store 다음으로 배치
- intent_service 생성을 warn_store 생성 이후로 이동 (warn_store 주입 가능하게)
- snapshot_scheduler, slots_rpc_handler에 warn_store 전달
## wire 계약 영향 (NFR-4 확인)
- `SlotState` enum: 변경 없음 (INACTIVE/PENDING_BUY/HOLDING/PENDING_SELL/ERROR 5개 유지)
- `ALLOWED_TRANSITIONS`: 변경 없음 (13개 전이 유지)
- `trex.slots.req` 응답: `reconcile_warned: bool` additive 추가. 기존 클라이언트가 무시해도 JSON dict 파싱 정상 동작
- `trex.intent.req` 응답: `reason="reconcile_warned"` 신규 코드 — rejected 케이스이므로 기존 클라이언트는 rejected 처리만 하면 됨
## 범위 밖 (core-B)
- REQ-105 sync CLI: 미구현
- REQ-106 verify CLI: 미구현
- SlotState 추가, INACTIVE→HOLDING 전이 추가: 미구현 (범위 밖)
docs/batches/bat-050_20260626_reconcile-warning-blocking-gate-core-a/index.md
+26
View File
@@ -0,0 +1,26 @@
# BAT-050: reconcile-warning 차단형 게이트 (core-A)
- Status: in-delivery
- Profile: standard
- Discovery: dcy-034
- Created: 2026-06-26
## Included REQ
- REQ-102: reconcile-warning durable store — slot_id/pid 키 별도 테이블
- REQ-103: 차단형 reconcile — B/C 불일치 슬롯 reconcile-warning 전이
- REQ-104: 전략 차단 게이트 — pause ∨ reconcile-warning 중 하나라도 걸리면 차단
- REQ-107: 차단/해제 전이 식별 로깅 + 고영향 불일치 알람
- REQ-108: 차단형 reconcile 비기능 요건 — 내구성·회귀 방지·자동 정정 금지·wire 계약 최소 침습
## Excluded REQ (core-B)
- REQ-105: sync CLI 명령 — core-B 별도 batch
- REQ-106: verify CLI 명령 — core-B 별도 batch
## Documents
- [planning.md](./planning.md)
- [design.md](./design.md)
- [implementation.md](./implementation.md)
- [verification.md](./verification.md)
docs/batches/bat-050_20260626_reconcile-warning-blocking-gate-core-a/planning.md
+65
View File
@@ -0,0 +1,65 @@
# BAT-050 Planning
- Status: confirmed
- Batch: BAT-050
- Profile: standard
## Included REQ
- REQ-102: reconcile-warning durable store — slot_id/pid 키 별도 테이블
- REQ-103: 차단형 reconcile — B/C 불일치 슬롯 reconcile-warning 전이
- REQ-104: 전략 차단 게이트 — pause ∨ reconcile-warning 중 하나라도 걸리면 차단
- REQ-107: 차단/해제 전이 식별 로깅 + 고영향 불일치 알람
- REQ-108: 차단형 reconcile 비기능 요건 — 내구성·회귀 방지·자동 정정 금지·wire 계약 최소 침습
## Delivery Plan
REQ-102 → REQ-103 → REQ-104 → REQ-107 → REQ-108 인과 사슬:
1. **REQ-102 먼저**: `ReconcileWarningStore` 포트(Protocol) + `InMemoryReconcileWarningStore` (테스트용) + `PostgreSQLReconcileWarningStore` (어댑터) + SQL 마이그레이션. pause_store 동형 설계.
2. **REQ-103**: `reconcile_core_holdings`와 `reconcile_positions`에 `warn_store: Optional[ReconcileWarningStore]` 파라미터 추가. B 케이스(qty mismatch) → `set_warned`, C 케이스(원장↔브로커) → `set_warned`. `SnapshotScheduler.run_once()`에 warn_store 주입.
3. **REQ-104**: `IntentService._admit_buy`/`_admit_sell`에 reconcile-warning 게이트 추가. `slot_to_dict`에 `reconcile_warned: bool` 필드. `make_slots_rpc_handler`에 `warn_store` 파라미터 추가. 안전망 경로(safety-sell/kill-switch/watchdog)는 `_admit_*` 게이트를 우회하므로 구조적으로 차단 예외.
4. **REQ-107**: 차단/해제 전이 시 구조화 로그(`WARNING`/`INFO`) 추가. A 케이스 알람은 기존 구현 확인.
5. **REQ-108**: 불변 확인 테스트 + 회귀 방지 테스트. `SlotState`·`ALLOWED_TRANSITIONS` 불변 검증.
구현 순서:
1. SQL 마이그레이션 (`016_create_slot_reconcile_warning.sql`)
2. `adapters/portfolio/reconcile_warning_store.py` (포트 + InMemory + PostgreSQL)
3. `application/portfolio.py` (`ReconcileWarningStore` Protocol + InMemory 통합)
4. `application/reconciliation.py` (B/C 차단 전이 + 로그)
5. `application/snapshot_scheduler.py` (warn_store 주입)
6. `application/intents.py` (게이트 추가 + `ReconcileWarningStore` 의존)
7. `application/portfolio.py` (`slot_to_dict` reconcile_warned 필드)
8. `application/messaging_handlers.py` (`make_slots_rpc_handler` warn_store 파라미터)
9. `runtime/daemon.py` (warn_store 배선)
10. 테스트 작성
## Dependencies
- BAT-049 (alarm-system-dcy-033): 완료(release-candidate) — `AlarmEmitter.publish_alarm` 경로가 REQ-100으로 구현됨. A 케이스 알람은 기존 경로 재사용.
- `pause_store` (BAT-008/020): 동형 설계의 선례.
- `reconcile_core_holdings`, `reconcile_positions` (BAT-029): 차단 전이 추가 대상.
## Design Gate
**Design 필요: yes (standard — 포트/어댑터 신설, 게이트 확장, 안전망 경로 분리 구조 확인)**
- ReconcileWarningStore 포트 위치 결정: `application/portfolio.py` 내 통합 vs 별도 파일.
- `reconcile_positions`에서 slot_id를 얻기 위한 slot_repo 주입 필요 여부 설계.
- `IntentService` 생성자에 warn_store 의존성 추가 방식 설계.
- 안전망 경로가 `_admit_*` 게이트를 구조적으로 우회하는지 명시 확인.
- slots RPC `reconcile_warned` 필드: bulk 조회 vs N+1 trade-off.
## Milestones
1. SQL 마이그레이션 + ReconcileWarningStore 포트/어댑터
2. reconcile_core_holdings/reconcile_positions B/C 차단 전이
3. IntentService 게이트 + slot_to_dict reconcile_warned 필드
4. make_slots_rpc_handler warn_store 주입 + daemon.py 배선
5. 전체 테스트 통과 (신규 + 회귀)
## Risks
- R-1(Medium): reconcile_positions에서 C 케이스 slot_id 조회 — portfolio_id로 slot을 찾아야 함. slot_repo 주입이 필요할 수 있음. 완화: design에서 조회 방식 확정.
- R-2(Low): warn_store Optional 처리 누락 시 기존 테스트 더블 깨짐. 완화: 모든 파라미터 Optional로 추가, None 시 기존 동작 유지.
- R-3(Low): slots RPC reconcile_warned 필드가 기존 클라이언트(orb/tsl)에서 unknown 필드로 수신될 때 파싱 오류 발생 가능성. 완화: additive only, 클라이언트가 unknown 필드를 무시하는지 design에서 확인.
docs/batches/bat-050_20260626_reconcile-warning-blocking-gate-core-a/verification.md
+104
View File
@@ -0,0 +1,104 @@
# BAT-050 Verification
- Status: done
- Batch: BAT-050
## pytest 실행 결과
실행 명령: `pytest tests/ -q`
```
642 passed, 47 skipped in 1.45s
```
- 기존 608개 테스트 전부 통과 (회귀 0)
- 신규 34개 테스트 전부 통과
- 47개 스킵 (DB 연결 필요한 통합 테스트 — 기존과 동일, 변화 없음)
- 실패 0
## 신규 테스트 파일
### tests/application/test_reconcile_warning_store.py (7개)
- `test_set_warned_is_warned_true` — AC-1 (REQ-102): set/is_warned 기본 동작
- `test_clear_warned_returns_false` — AC-4: clear 후 False
- `test_set_warned_upsert_same_slot` — AC-3: 동일 slot_id 재삽입 시 1행 유지
- `test_list_warned_returns_set` — AC-5: 복수 slot_id 조회
- `test_is_warned_unknown_slot_false` — 미등록 slot → False
- `test_clear_warned_unknown_slot_noop` — 미등록 slot clear → no-op
- `test_list_warned_empty` — 빈 상태 → empty set
### tests/application/test_reconcile_warning_blocking.py (27개)
- B 케이스 차단 (REQ-103 AC-1): `test_reconcile_core_holdings_b_case_sets_warned`, `..._b_case_code`
- 정상 케이스 오발동 없음 (REQ-103 AC-3, S-4): `test_reconcile_core_holdings_matching_qty_no_warn`
- A 케이스 기존 동작 유지 (REQ-103 AC-4): `test_reconcile_core_holdings_a_case_error_not_warned`
- 하위 호환 (REQ-103 AC-5): `test_reconcile_core_holdings_no_warn_store_backward_compat`
- C 케이스 차단 (REQ-103 AC-2): `test_reconcile_positions_c_case_sets_warned`, `..._c_case_matching_no_warn`, `..._no_warn_store_backward_compat`
- buy intent 차단 (REQ-104 AC-1): `test_intent_service_buy_rejected_when_reconcile_warned`
- sell intent 차단 (REQ-104 AC-2, 외부): `test_intent_service_sell_rejected_when_reconcile_warned`
- 정상 intent 오발동 없음 (REQ-104 AC-3): `test_intent_service_no_warn_admitted_normally`
- 하위 호환 (REQ-104): `test_intent_service_no_warn_store_backward_compat`
- 안전망 우회 확인 (REQ-104 OQ-B): `test_safety_sell_bypasses_reconcile_warning_gate` — SlotService.transit_slot 직접 호출 시 warned 슬롯도 정상 전이
- slots RPC reconcile_warned 필드 (REQ-104 AC-4~8): 5개 테스트
- 구조화 로그 (REQ-107): B케이스/C케이스 WARNING 로그 필드 검증
- SlotState 불변 (REQ-108 NFR-4): `test_slot_state_enum_unchanged`, `test_allowed_transitions_unchanged`
- 단기 인스턴스 오발동 없음 (REQ-108 NFR-2, S-4): `test_short_term_instance_normal_no_warn`
- 자동 정정 금지 (REQ-108 NFR-3): `test_reconcile_no_auto_fix_slot_qty`
- slot_to_dict 필드 (REQ-104): 3개 테스트
## AC 검증 매핑
| AC | 테스트 | 결과 |
| --- | --- | --- |
| REQ-102 AC-1 (마이그레이션 테이블 생성) | SQL 파일 존재 확인 (DB 스킵) | SQL 파일 생성됨 |
| REQ-102 AC-2 (durable — set 후 재시작 후 True) | InMemory 동치 테스트 / PG는 DB 스킵 | PASS |
| REQ-102 AC-3 (ON CONFLICT DO UPDATE) | `test_set_warned_upsert_same_slot` | PASS |
| REQ-102 AC-4 (clear_warned → False) | `test_clear_warned_returns_false` | PASS |
| REQ-102 AC-5 (list_warned) | `test_list_warned_returns_set` | PASS |
| REQ-102 AC-6 (SlotState 불변) | `test_slot_state_enum_unchanged` | PASS |
| REQ-103 AC-1 (B case → set_warned case_code=B) | `test_reconcile_core_holdings_b_case_sets_warned` | PASS |
| REQ-103 AC-2 (C case → set_warned case_code=C) | `test_reconcile_positions_c_case_sets_warned` | PASS |
| REQ-103 AC-3 (정상 케이스 오발동 없음) | `test_reconcile_core_holdings_matching_qty_no_warn`, `test_reconcile_positions_c_case_matching_no_warn` | PASS |
| REQ-103 AC-4 (A case → ERROR, warn_store 미사용) | `test_reconcile_core_holdings_a_case_error_not_warned` | PASS |
| REQ-103 AC-5 (warn_store=None 하위 호환) | 양 함수 backward_compat 테스트 | PASS |
| REQ-104 AC-1 (buy intent → reconcile_warned 차단) | `test_intent_service_buy_rejected_when_reconcile_warned` | PASS |
| REQ-104 AC-2 (sell intent → reconcile_warned 차단 + 안전망 예외) | `test_intent_service_sell_rejected_when_reconcile_warned`, `test_safety_sell_bypasses_reconcile_warning_gate` | PASS |
| REQ-104 AC-3 (정상 → 오발동 없음) | `test_intent_service_no_warn_admitted_normally` | PASS |
| REQ-104 AC-4 (pause only: paused=T, reconcile_warned=F) | `test_slots_rpc_paused_only` | PASS |
| REQ-104 AC-5 (warn only: reconcile_warned=T) | `test_slots_rpc_reconcile_warned_true` | PASS |
| REQ-104 AC-6 (both: paused=T, reconcile_warned=T) | `test_slots_rpc_both_pause_and_reconcile_warned` | PASS |
| REQ-104 AC-7 (warn_store=None → reconcile_warned=F) | `test_slots_rpc_no_warn_store_reconcile_warned_false` | PASS |
| REQ-104 AC-8 (기존 warned 필드 불변) | `test_slots_rpc_existing_warned_field_unchanged` | PASS |
| REQ-107 AC-1 (B case WARNING 로그 필드) | `test_reconcile_core_holdings_b_case_logging` | PASS |
| REQ-107 AC-2 (C case WARNING 로그 필드) | `test_reconcile_positions_c_case_logging` | PASS |
| REQ-107 AC-3 (sync 해제 INFO 로그) | core-B 범위 — 미검증 (REQ-105/106 미구현) | 해당 없음 |
| REQ-107 AC-4 (verify 해제 INFO 로그) | core-B 범위 | 해당 없음 |
| REQ-107 AC-5 (A case CRITICAL 알람 기존 동작) | 기존 test_alarm_emitter.py 회귀 확인 | PASS (608 기존 통과) |
| REQ-108 AC-1 (durable) | InMemory 동치 + PG 스킵 | PASS |
| REQ-108 AC-2 (정상 단기 오발동 없음, NFR-2, S-4) | `test_short_term_instance_normal_no_warn` | PASS |
| REQ-108 AC-3 (자동 정정 없음, NFR-3) | `test_reconcile_no_auto_fix_slot_qty` | PASS |
| REQ-108 AC-4 (additive 하위 호환, NFR-4) | `test_slots_rpc_no_warn_store_reconcile_warned_false` | PASS |
| REQ-108 AC-5 (SlotState enum 불변, NFR-4) | `test_slot_state_enum_unchanged` | PASS |
| REQ-108 AC-6 (ALLOWED_TRANSITIONS 불변, NFR-4) | `test_allowed_transitions_unchanged` | PASS |
## wire 계약 무회귀 근거
- `SlotState` 5개 값 불변 확인: `test_slot_state_enum_unchanged` PASS
- `ALLOWED_TRANSITIONS` 13개 불변 확인: `test_allowed_transitions_unchanged` PASS
- `trex.slots.req` 기존 필드: 기존 test_slots_handler.py 전부 통과 (회귀 0)
- `reconcile_warned` additive 필드: 기존 클라이언트가 무시 가능 (JSON dict extra key)
## 미검증 항목 (핸들링)
- PostgreSQLReconcileWarningStore durable 검증: DB 연결 필요 — InMemory 동치 테스트로 계약 검증, PG 어댑터는 pause_store 동형 패턴으로 구현됨.
- sync/verify CLI clear_warned 해제 로그 (REQ-107 AC-3/4): core-B 범위 (REQ-105/106 미구현).
## 롤백
```bash
git revert <commit-sha> # 단일 커밋 롤백
```
또는 마이그레이션 롤백:
```sql
DROP TABLE IF EXISTS slot_reconcile_warning;
```
docs/batches/index.md
+1
View File
@@ -57,3 +57,4 @@
| BAT-047 | standard | release-candidate | REQ-091, REQ-092, REQ-093, REQ-094 | dcy-031 | [bat-047](./bat-047_20260619_event-publisher-connection-reliability/) |
| BAT-048 | standard | in-delivery | REQ-095, REQ-096, REQ-097 | dcy-032 | [bat-048](./bat-048_20260621_fill-price-backfill-guard-logging-alert-spike/) |
| BAT-049 | standard | release-candidate | REQ-098, REQ-099, REQ-100, REQ-101 | dcy-033 | [bat-049](./bat-049_20260621_alarm-system-dcy-033/) |
| BAT-050 | standard | in-delivery | REQ-102, REQ-103, REQ-104, REQ-107, REQ-108 | dcy-034 (core-A) | [bat-050](./bat-050_20260626_reconcile-warning-blocking-gate-core-a/) |