Coverage for src/copytrading_engine/execution/domain/lot_sales.py: 100%
49 statements
« prev ^ index » next coverage.py v7.16.2, created at 2026-11-16 16:55 +0000
« prev ^ index » next coverage.py v7.16.2, created at 2026-11-16 16:55 +0000
1"""The owner's sale of one copied lot: previewed against fresh facts, then confirmed once."""
3from decimal import Decimal
4from typing import Literal, Self
6from pydantic import AwareDatetime, Field, model_validator
8from copytrading_engine.execution.domain.manual_commands import ManualCheck
9from copytrading_engine.execution.domain.market import Quote
10from copytrading_engine.execution.domain.order_lifecycle import OrderStatus
11from copytrading_engine.execution.domain.orders import OrderPlan
12from copytrading_engine.execution.domain.sessions import Session
13from copytrading_engine.execution.domain.values import Identifier, Positive, Quantity, Value
16class LotSalePreviewRequest(Value):
17 """Sell up to `qty` shares of one lot the copier owns in this account."""
19 preview_id: Identifier
20 account_id: Identifier
21 lot_id: Identifier
22 qty: Positive
25class LotSalePreview(Value):
26 request: LotSalePreviewRequest
27 broker_account_id: Identifier
28 environment: Literal["paper", "live"]
29 symbol: Identifier
30 lot_remaining_qty: Quantity
31 created_at: AwareDatetime
32 expires_at: AwareDatetime
33 session: Session | None
34 quote: Quote | None
35 fresh_price: Positive | None
36 plan: OrderPlan | None
37 checks: tuple[ManualCheck, ...]
38 reasons: tuple[Identifier, ...]
39 facts_sha256: str = Field(pattern=r"^[0-9a-f]{64}$")
41 @model_validator(mode="after")
42 def valid_decision(self) -> Self:
43 if (self.plan is not None) != (not self.reasons):
44 raise ValueError("A lot sale preview plan must agree with its blocking reasons")
45 if self.expires_at <= self.created_at:
46 raise ValueError("Lot sale preview expiration must follow its creation")
47 if (self.quote is None) != (self.fresh_price is None):
48 raise ValueError("A fresh preview price requires its quote evidence")
49 if self.plan is not None:
50 if self.session is None:
51 raise ValueError("A ready lot sale preview requires a market session")
52 if (
53 self.plan.side != "sell"
54 or self.plan.symbol != self.symbol
55 or self.plan.lot_id != self.request.lot_id
56 or self.plan.qty > self.request.qty
57 or self.plan.qty > self.lot_remaining_qty
58 ):
59 raise ValueError("A lot sale plan must sell no more than its lot holds")
60 return self
63class LotSaleConfirmation(Value):
64 command_id: Identifier
65 preview_id: Identifier
66 account_id: Identifier
67 actor: Identifier
69 @model_validator(mode="after")
70 def valid_actor(self) -> Self:
71 if not self.actor.strip():
72 raise ValueError("A lot sale confirmation requires an actor")
73 return self
76class LotSaleRecord(Value):
77 request: LotSaleConfirmation
78 lot_id: Identifier
79 confirmed_at: AwareDatetime
80 state: Literal["rejected", "prepared"]
81 reason: Identifier | None = None
82 client_id: Identifier | None = None
84 @model_validator(mode="after")
85 def valid_state(self) -> Self:
86 if self.state == "rejected" and (self.reason is None or self.client_id is not None):
87 raise ValueError("A rejected lot sale requires a reason and no order intent")
88 if self.state == "prepared" and (self.reason is not None or self.client_id is None):
89 raise ValueError("A prepared lot sale requires its order intent")
90 return self
93class LotSaleResult(Value):
94 sale: LotSaleRecord
95 status: Literal[
96 "rejected",
97 "prepared",
98 "uncertain",
99 "accepted",
100 "partially_filled",
101 "filled",
102 "cancelled",
103 "broker_rejected",
104 "expired",
105 ]
106 reason: Identifier | None = None
107 client_id: Identifier | None = None
108 broker_order_id: Identifier | None = None
109 order_status: OrderStatus | None = None
110 filled_qty: Quantity = Decimal(0)
111 filled_avg_price: Positive | None = None