feat(slot): BAT-030 — 자산 중심 cutover 완성 (dcy-020 BAT-δ, REQ-056·057·062·064·065)

M1 literal inactive 전면화: SlotState 5-state(idle/closed 별칭 제거),
마이그레이션 010(CHECK 교체+행 rewrite), ops_checks 를 transition_log 기반 재작성.
M2 집행 매도 수량 브로커 정본(D3): dispatch 매도 qty=broker hldg_qty,
미러 fallback 없음, 브로커 0 → skip+WARN, 리스트 기반 dispatch(head-block 방지).
M3 컬럼 drop + legacy pool 제거: 마이그레이션 011(trading_date·entry_count DROP),
repo 계약 instance 스코프 개편(집행 큐 포함), preallocation 폐기(데몬 7스레드),
admission 자산 중심 단일 경로(slot_id 정본), capacity 재정의(available=M−active),
daily_symbol_entries 코드 경로 제거.
M4 cutover 도구(D1·D4): trex-core-cutover(전체 rebuild, preflight/브로커 carry-over/
--allow-unmapped/--promote-unique/dry-run) + PG 리허설 테스트 8건.
M5 baseline 마감: data-model/runtime-flows/project-structure/interface-contract
자산 중심 최종 갱신 + run-trex-core-daemon 스킬 정합.

검증: 단위 367 passed + ruff clean; PG-gated 29 passed(010/011 round-trip·드리프트
가드·cutover 리허설); RabbitMQ 21 passed; run-the-app e2e(test DB+실 MQ, M=1):
reconcile 슬롯 생성→slot_id 매수→dedup→capacity_full→fill→already_active→
매도→inactive(자산 바인딩 보존)→영구 슬롯 재활성 전 구간 green.
실 cutover 는 운영자 실행(REL 단계, D4).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-10 15:16:15 +09:00
co-authored by Claude Opus 4.8
parent cec34be5f4
commit 7d727824dc
67 changed files with 1584 additions and 1862 deletions
+16 -29
View File
@@ -1,7 +1,7 @@
"""State machine unit tests — asset-centric redefinition (dcy-020 / REQ-057).
"""State machine unit tests — asset-centric (dcy-020 / REQ-057, BAT-030).
`inactive` is the canonical no-position state; `idle`/`closed` are aliases that
normalize to `inactive`. `closed->idle` recovery is removed. Covers REQ-057.
`inactive` is the only no-position state. The pool-model `idle`/`closed`
aliases were removed at the cutover (D2); migration 010 rewrites legacy rows.
"""
from __future__ import annotations
@@ -12,29 +12,28 @@ from trex_core.domain.slot.state import (
SLOT_ADVISORY_LOCK_ID,
SlotState,
is_allowed_transition,
normalize_state,
slot_advisory_lock_id,
)
def test_slot_state_members():
"""dcy-020: 5 canonical + 2 aliases(idle/closed) = 7 enum members."""
"""dcy-020 (BAT-030): 5 canonical members — idle/closed aliases removed."""
assert {s.value for s in SlotState} == {
"inactive",
"idle",
"pending_buy",
"holding",
"pending_sell",
"closed",
"error",
}
def test_idle_and_closed_normalize_to_inactive():
assert normalize_state(SlotState.IDLE) is SlotState.INACTIVE
assert normalize_state(SlotState.CLOSED) is SlotState.INACTIVE
assert normalize_state(SlotState.INACTIVE) is SlotState.INACTIVE
assert normalize_state(SlotState.HOLDING) is SlotState.HOLDING
def test_legacy_alias_values_rejected():
"""`idle`/`closed` are no longer valid SlotState values (migration 010
rewrites any remaining DB rows before this code reads them)."""
with pytest.raises(ValueError):
SlotState("idle")
with pytest.raises(ValueError):
SlotState("closed")
def test_advisory_lock_id_is_stable_constant():
@@ -56,27 +55,20 @@ def test_slot_advisory_lock_id_is_instance_scoped():
@pytest.mark.parametrize(
"from_state,to_state",
[
# canonical (inactive-based)
# canonical lifecycle
(SlotState.INACTIVE, SlotState.PENDING_BUY),
(SlotState.PENDING_BUY, SlotState.HOLDING),
(SlotState.PENDING_BUY, SlotState.INACTIVE),
(SlotState.HOLDING, SlotState.PENDING_SELL),
(SlotState.PENDING_SELL, SlotState.INACTIVE),
(SlotState.PENDING_SELL, SlotState.HOLDING),
# alias equivalence: idle/closed normalize to inactive
(SlotState.IDLE, SlotState.PENDING_BUY), # idle->pending_buy
(SlotState.CLOSED, SlotState.PENDING_BUY), # closed->pending_buy (reallocation)
(SlotState.PENDING_SELL, SlotState.CLOSED), # sell filled (closed alias)
(SlotState.PENDING_BUY, SlotState.IDLE), # buy rollback (idle alias)
# to error (every non-error)
(SlotState.INACTIVE, SlotState.ERROR),
(SlotState.PENDING_BUY, SlotState.ERROR),
(SlotState.HOLDING, SlotState.ERROR),
(SlotState.PENDING_SELL, SlotState.ERROR),
(SlotState.CLOSED, SlotState.ERROR),
# operator resolve out of error
(SlotState.ERROR, SlotState.INACTIVE),
(SlotState.ERROR, SlotState.IDLE), # alias
(SlotState.ERROR, SlotState.HOLDING),
],
)
@@ -87,16 +79,14 @@ def test_allowed_transition(from_state: SlotState, to_state: SlotState):
@pytest.mark.parametrize(
"from_state,to_state",
[
# closed->idle recovery REMOVED (normalizes to inactive self-loop)
(SlotState.CLOSED, SlotState.IDLE),
# skipping intermediate states
(SlotState.INACTIVE, SlotState.HOLDING),
(SlotState.INACTIVE, SlotState.PENDING_SELL),
(SlotState.HOLDING, SlotState.INACTIVE),
(SlotState.HOLDING, SlotState.CLOSED),
(SlotState.HOLDING, SlotState.PENDING_BUY),
(SlotState.PENDING_BUY, SlotState.PENDING_SELL),
(SlotState.PENDING_SELL, SlotState.PENDING_BUY),
# error has restricted exits — only inactive(+aliases) and holding
# error has restricted exits — only inactive and holding
(SlotState.ERROR, SlotState.PENDING_BUY),
(SlotState.ERROR, SlotState.PENDING_SELL),
(SlotState.ERROR, SlotState.ERROR),
@@ -107,14 +97,11 @@ def test_disallowed_transition(from_state: SlotState, to_state: SlotState):
def test_self_loops_are_not_allowed():
"""No state may transition to itself (including inactive and its aliases)."""
"""No state may transition to itself."""
for s in SlotState:
assert not is_allowed_transition(s, s)
# alias self-loops also rejected
assert not is_allowed_transition(SlotState.IDLE, SlotState.CLOSED)
assert not is_allowed_transition(SlotState.CLOSED, SlotState.IDLE)
def test_allowed_transitions_set_size():
"""6 base (inactive-canonical) + 4 to-error + 2 operator-resolve = 12."""
"""6 base + 4 to-error + 2 operator-resolve = 12."""
assert len(ALLOWED_TRANSITIONS) == 12