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

1"""The owner's sale of one copied lot: previewed against fresh facts, then confirmed once.""" 

2 

3from decimal import Decimal 

4from typing import Literal, Self 

5 

6from pydantic import AwareDatetime, Field, model_validator 

7 

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 

14 

15 

16class LotSalePreviewRequest(Value): 

17 """Sell up to `qty` shares of one lot the copier owns in this account.""" 

18 

19 preview_id: Identifier 

20 account_id: Identifier 

21 lot_id: Identifier 

22 qty: Positive 

23 

24 

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}$") 

40 

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 

61 

62 

63class LotSaleConfirmation(Value): 

64 command_id: Identifier 

65 preview_id: Identifier 

66 account_id: Identifier 

67 actor: Identifier 

68 

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 

74 

75 

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 

83 

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 

91 

92 

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