feat(slot): BAT-027 M2/M3 — 상태머신 inactive 재정의 + 인스턴스 스코프 advisory lock (dcy-020/REQ-057)

안 B 점진의 2/3단계. runtime 무변경(idle/closed 별칭 흡수)으로 cascade 통제.

- state.py: SlotState.INACTIVE 추가 + idle/closed 별칭 normalize_state(); 전이 집합
  inactive 기준 재정의(inactive↔pending_buy↔holding↔pending_sell), closed→idle 제거;
  is_allowed_transition 양쪽 정규화; slot_advisory_lock_id(instance_key) 헬퍼
- service.py: SlotService(instance_key) + advisory lock 인스턴스 스코프(self._lock_id)
- __init__: normalize_state/slot_advisory_lock_id export; daemon: instance_key 전달
- 테스트 갱신: test_state(전이/멤버7/락/size12), test_service(closed→idle 제거→reallocation),
  test_slot_entry_count, test_postgresql_repository(closed→idle 거부+reallocation)

검증: 단위 375 passed / 35 skipped, PG-gated(trex_core_test) 8 passed
(마이그레이션 009 드리프트 + lifecycle/reallocation), ruff clean.

REQ-056/057 은 토대만 충족 → Approved 유지(entry_count/trading_date drop·literal
inactive 전면 전환은 BAT-δ; confirm-req-implemented 는 dcy-020 후속 배치 완료 후).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-10 10:53:39 +09:00
co-authored by Claude Opus 4.8
parent 86c892aa0c
commit 017b8185e0
10 changed files with 232 additions and 151 deletions
+36 -66
View File
@@ -133,78 +133,48 @@ class TestTransitHappyPath:
# ----------------------------------------------------------------------------
# transit_slot — closed → idle atomic counter (REQ-002 AC-3)
# transit_slot — closed→idle recovery REMOVED (dcy-020 / REQ-057)
# ----------------------------------------------------------------------------
class TestClosedToIdleRecovery:
def test_closed_to_idle_resets_fields_and_bumps_counter(
self, service, repo, trading_day,
):
class TestClosedRecoveryRemoved:
def test_closed_to_idle_is_rejected(self, service, repo, trading_day):
"""dcy-020: closed→idle recovery is removed (idle/closed both = inactive)."""
service.preallocate_daily_slots(trading_day, 1)
slot = _one_idle(repo, trading_day)
# full lifecycle: idle -> pending_buy -> holding -> pending_sell -> closed -> idle
service.transit_slot(
slot.slot_id, SlotState.IDLE, SlotState.PENDING_BUY,
reason="orb_breakout", actor="buy", symbol="005930", qty=10,
)
service.transit_slot(
slot.slot_id, SlotState.PENDING_BUY, SlotState.HOLDING,
reason="filled", actor="oe", avg_price=70_000,
)
service.transit_slot(
slot.slot_id, SlotState.HOLDING, SlotState.PENDING_SELL,
reason="stop_loss", actor="sell",
)
service.transit_slot(
slot.slot_id, SlotState.PENDING_SELL, SlotState.CLOSED,
reason="filled", actor="oe",
)
# before recovery: count = 0
assert repo.get_symbol_entry_count(trading_day, "005930") == 0
result = service.transit_slot(
slot.slot_id, SlotState.CLOSED, SlotState.IDLE,
reason="recovery", actor="oe",
)
# fields cleared
assert result.status is SlotState.IDLE
assert result.symbol is None
assert result.qty is None
assert result.avg_price is None
assert result.allocated_capital is None
# counter incremented atomically (REQ-002 AC-3)
assert repo.get_symbol_entry_count(trading_day, "005930") == 1
# transition log retains symbol audit
log = repo.transition_log_for(slot.slot_id)
assert log[-1].from_state is SlotState.CLOSED
assert log[-1].to_state is SlotState.IDLE
# drive to closed
service.transit_slot(slot.slot_id, SlotState.IDLE, SlotState.PENDING_BUY,
reason="r", actor="a", symbol="005930")
service.transit_slot(slot.slot_id, SlotState.PENDING_BUY, SlotState.HOLDING,
reason="r", actor="a", avg_price=70_000)
service.transit_slot(slot.slot_id, SlotState.HOLDING, SlotState.PENDING_SELL,
reason="r", actor="a")
service.transit_slot(slot.slot_id, SlotState.PENDING_SELL, SlotState.CLOSED,
reason="r", actor="a")
with pytest.raises(SlotTransitionError):
service.transit_slot(slot.slot_id, SlotState.CLOSED, SlotState.IDLE,
reason="recovery", actor="a")
def test_repeated_lifecycle_accumulates_entry_count(
def test_reuse_via_closed_to_pending_buy_reallocation(
self, service, repo, trading_day,
):
"""Two full lifecycles of same symbol → entry_count = 2."""
service.preallocate_daily_slots(trading_day, 2)
for _ in range(2):
slot = _one_idle(repo, trading_day)
service.transit_slot(
slot.slot_id, SlotState.IDLE, SlotState.PENDING_BUY,
reason="r", actor="a", symbol="005930",
)
service.transit_slot(
slot.slot_id, SlotState.PENDING_BUY, SlotState.HOLDING,
reason="r", actor="a",
)
service.transit_slot(
slot.slot_id, SlotState.HOLDING, SlotState.PENDING_SELL,
reason="r", actor="a",
)
service.transit_slot(
slot.slot_id, SlotState.PENDING_SELL, SlotState.CLOSED,
reason="r", actor="a",
)
service.transit_slot(
slot.slot_id, SlotState.CLOSED, SlotState.IDLE,
reason="r", actor="a",
)
assert service.get_today_entry_count(trading_day, "005930") == 2
"""Asset-centric reuse: a closed slot is reactivated via closed→pending_buy
(dcy-019 reallocation), not closed→idle recovery."""
service.preallocate_daily_slots(trading_day, 1)
slot = _one_idle(repo, trading_day)
service.transit_slot(slot.slot_id, SlotState.IDLE, SlotState.PENDING_BUY,
reason="r", actor="a", symbol="005930")
service.transit_slot(slot.slot_id, SlotState.PENDING_BUY, SlotState.HOLDING,
reason="r", actor="a", avg_price=70_000)
service.transit_slot(slot.slot_id, SlotState.HOLDING, SlotState.PENDING_SELL,
reason="r", actor="a")
service.transit_slot(slot.slot_id, SlotState.PENDING_SELL, SlotState.CLOSED,
reason="r", actor="a")
realloc = service.transit_slot(
slot.slot_id, SlotState.CLOSED, SlotState.PENDING_BUY,
reason="reallocate", actor="a", symbol="000660",
)
assert realloc.status is SlotState.PENDING_BUY
assert realloc.symbol == "000660" # clean-slate
assert realloc.entry_count == 2 # cumulative
# ----------------------------------------------------------------------------