Deliver BAT-001: bootstrap trex-core + port slot pure domain

Implement REQ-001~004 (dcy-001): scaffold the trex-core package (pyproject, trex_core/, tests/), port the slot pure domain into trex_core.domain.slot with import rewrites, add the EXPECTED_SLOT_FIELDS contract guard (test_contract), and port the state/service unit tests. Verification: 56 passed, ruff clean, import sweep shows zero external deps, public __all__ exposes no infra symbols, contract negative case reproduced. Align project-structure/runtime-flows baselines to the real tree. Sync SDLC tracking: REQ-001~004 → Implemented, BAT-001 → release-candidate. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 00:16:07 +09:00
parent 8b23b89977
commit 20498aa4ce
31 changed files with 2044 additions and 21 deletions
@@ -0,0 +1,84 @@
+"""Slot domain data classes (REQ-001, REQ-002)."""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import date, datetime
+from typing import Optional
+from uuid import UUID
+
+from trex_core.domain.slot.state import SlotState
+
+
+@dataclass
+class Slot:
+    """Single daily_slot row.
+
+    Matches the slot column contract recorded in dcy-001 부록 A and
+    docs/data-model.md (trex-core stores this in-memory for now; a future
+    persistence layer must satisfy the same contract).
+    """
+
+    slot_id: UUID
+    trading_date: date
+    status: SlotState
+    symbol: Optional[str] = None
+    qty: Optional[float] = None
+    avg_price: Optional[float] = None
+    entry_price: Optional[float] = None
+    allocated_capital: Optional[float] = None
+    order_id: Optional[str] = None
+    strategy_id: Optional[str] = None
+    broker_order_id: Optional[str] = None  # BAT-003 / REQ-011 (trex-orbit lineage)
+    portfolio_id: Optional[str] = None  # BAT-006 / REQ-025 (trex-orbit lineage)
+    sell_strategy_id: Optional[str] = None  # BAT-008 / REQ-047 (trex-orbit lineage)
+    forced_close_at: Optional[datetime] = None  # BAT-014 / REQ-066 (trex-orbit lineage)
+    created_at: Optional[datetime] = None
+    updated_at: Optional[datetime] = None
+
+
+# Canonical column contract for `Slot` (dcy-001 OQ-2 / FR-5).
+# test_contract.py asserts this matches `dataclasses.fields(Slot)` so any
+# field add/remove fails loudly. Type mapping lives in the docs (dcy-001 부록 A
+# / docs/data-model.md), not here — names/presence only.
+EXPECTED_SLOT_FIELDS: frozenset[str] = frozenset({
+    "slot_id",
+    "trading_date",
+    "status",
+    "symbol",
+    "qty",
+    "avg_price",
+    "entry_price",
+    "allocated_capital",
+    "order_id",
+    "strategy_id",
+    "broker_order_id",
+    "portfolio_id",
+    "sell_strategy_id",
+    "forced_close_at",
+    "created_at",
+    "updated_at",
+})
+
+
+@dataclass(frozen=True)
+class SlotCapacity:
+    """Snapshot of slot capacity returned by compute_slot_capacity (REQ-002 AC-6)."""
+
+    idle_count: int
+    holding_count: int
+    pending_count: int
+    total_slots: int
+    scarcity_ratio: float
+
+
+@dataclass(frozen=True)
+class SlotTransitionRecord:
+    """One append-only row in slot_transition_log (REQ-001, REQ-002)."""
+
+    slot_id: UUID
+    from_state: SlotState
+    to_state: SlotState
+    ts: datetime
+    reason: str
+    actor: str
+    extra: dict = field(default_factory=dict)