genichinandClaude Opus 4.8
7d727824dc
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>
78 lines
3.1 KiB
Python
78 lines
3.1 KiB
Python
"""Slot state machine (REQ-001, REQ-002; dcy-020/REQ-057 asset-centric).
|
|
|
|
The asset-centric permanent slot has five states. `inactive` means "no open
|
|
position" — it replaced the pool-model `idle` (never-bought) and `closed`
|
|
(sold, now flat) states, whose aliases were removed at the cutover (BAT-030);
|
|
migration 010 rewrites any remaining `idle`/`closed` rows to `inactive` and
|
|
swaps the status CHECK constraint accordingly.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import zlib
|
|
from enum import Enum
|
|
|
|
|
|
# Shared PostgreSQL advisory lock base id. dcy-020/REQ-057 (NFR-1): in a shared
|
|
# DB the lock is scoped per instance via `slot_advisory_lock_id(instance_key)` so
|
|
# one instance's transitions never serialize against another's.
|
|
SLOT_ADVISORY_LOCK_ID: int = 0x5107_4D31 # arbitrary mnemonic constant
|
|
|
|
|
|
def slot_advisory_lock_id(instance_key: str) -> int:
|
|
"""Per-instance advisory lock id (dcy-020/REQ-057). Combines the base id with
|
|
a stable hash of instance_key so distinct instances take distinct locks while
|
|
the same instance always takes the same lock. Result stays in signed-32 range
|
|
(pg advisory lock accepts bigint; this keeps it deterministic and small)."""
|
|
h = zlib.crc32((instance_key or "default").encode("utf-8")) & 0x7FFF_FFFF
|
|
return SLOT_ADVISORY_LOCK_ID ^ h
|
|
|
|
|
|
class SlotState(str, Enum):
|
|
"""Slot lifecycle states (dcy-020/REQ-057 asset-centric, 5 states)."""
|
|
|
|
INACTIVE = "inactive" # no open position (permanent slot at rest)
|
|
PENDING_BUY = "pending_buy"
|
|
HOLDING = "holding"
|
|
PENDING_SELL = "pending_sell"
|
|
ERROR = "error"
|
|
|
|
|
|
# Canonical transitions (dcy-020/REQ-057). There is no inactive self-loop and
|
|
# no closed->idle recovery family — a permanent slot simply returns to
|
|
# `inactive` and may activate again via inactive->pending_buy.
|
|
_BASE_TRANSITIONS: frozenset[tuple[SlotState, SlotState]] = frozenset(
|
|
{
|
|
(SlotState.INACTIVE, SlotState.PENDING_BUY), # 1. buy decision (activate)
|
|
(SlotState.PENDING_BUY, SlotState.HOLDING), # 2. buy filled
|
|
(SlotState.PENDING_BUY, SlotState.INACTIVE), # 3. buy rejected/rollback
|
|
(SlotState.HOLDING, SlotState.PENDING_SELL), # 4. sell decision
|
|
(SlotState.PENDING_SELL, SlotState.INACTIVE), # 5. sell filled (deactivate)
|
|
(SlotState.PENDING_SELL, SlotState.HOLDING), # 6. sell rejected/rollback
|
|
}
|
|
)
|
|
|
|
# Any non-error state may move to error.
|
|
_TO_ERROR_TRANSITIONS: frozenset[tuple[SlotState, SlotState]] = frozenset(
|
|
(s, SlotState.ERROR)
|
|
for s in (SlotState.INACTIVE, SlotState.PENDING_BUY, SlotState.HOLDING,
|
|
SlotState.PENDING_SELL)
|
|
)
|
|
|
|
# Operator manual resolve out of error (REQ-004).
|
|
_FROM_ERROR_TRANSITIONS: frozenset[tuple[SlotState, SlotState]] = frozenset(
|
|
{
|
|
(SlotState.ERROR, SlotState.INACTIVE),
|
|
(SlotState.ERROR, SlotState.HOLDING),
|
|
}
|
|
)
|
|
|
|
|
|
ALLOWED_TRANSITIONS: frozenset[tuple[SlotState, SlotState]] = (
|
|
_BASE_TRANSITIONS | _TO_ERROR_TRANSITIONS | _FROM_ERROR_TRANSITIONS
|
|
)
|
|
|
|
|
|
def is_allowed_transition(from_state: SlotState, to_state: SlotState) -> bool:
|
|
"""Return True iff (from_state, to_state) is an allowed transition."""
|
|
return (from_state, to_state) in ALLOWED_TRANSITIONS
|