"""内部额度命令。sources/on_date/executed 必须由调用方从权限校验后的业务记录提取,禁止直接暴露为 HTTP 请求体。""" from datetime import date from decimal import Decimal from typing import Dict, List, Literal, Optional from pydantic import BaseModel, ConfigDict, Field, condecimal class InternalModel(BaseModel): model_config = ConfigDict(extra='forbid') class UsageSource(InternalModel): source_stop_type: Literal['load', 'delivery'] source_stop_id: str source_stop_product_id: str plan_product_id: str contract_id: str contract_product_id: str product_id: str quantity: Decimal = Field(ge=0, max_digits=18, decimal_places=6) unit: str related_stop_products: List[str] = Field(default_factory=list) fingerprint: str snapshot: dict = Field(default_factory=dict) @property def source_id(self): return self.source_stop_type + ':' + self.source_stop_product_id class UsageManual(InternalModel): permit_kind: Literal['purchase', 'transport'] source_id: str permit_id: str source_quantity: Decimal = Field(ge=0, max_digits=18, decimal_places=6) permit_quantity: Decimal = Field(ge=0, max_digits=18, decimal_places=6) note: str = Field(min_length=1) class UsageRequest(InternalModel): operation_id: str = Field(min_length=1, max_length=64) action: Literal['reserve','resize','release','settle','actual_adjust','total_adjust'] plan_id: Optional[str] = None sources: List[UsageSource] = Field(default_factory=list) purchase_cert_ids: List[str] = Field(default_factory=list) transport_cert_ids: List[str] = Field(default_factory=list) vehicle_no: str = '' on_date: date = Field(default_factory=date.today) executed: bool = False allow_supplement: bool = False manual_allocations: List[UsageManual] = Field(default_factory=list) actual_by_source: Dict[str, Decimal] = Field(default_factory=dict) manual_actuals: List[UsageManual] = Field(default_factory=list) reason: str = '' evidence_urls: str = '' source_note: str = '' cert_type: Optional[Literal['purchase','transport']] = None cert_id: Optional[str] = None total_qty: Optional[condecimal(ge=0, max_digits=18, decimal_places=6)] = None