"""运输计划管理 - 计划 Schema""" from datetime import date, datetime from decimal import Decimal from typing import Optional from pydantic import BaseModel, Field from app.schemas.pl.datetime_parse import OptionalPlanDateTime from app.schemas.pl.resource_snapshot import PlanResourceSnapshotMixin # ============================================================================= # 计划产品明细 Schema # ============================================================================= class PlanProductBase(BaseModel): product_id: str = Field(..., alias="productId", description="产品ID") product_no: str = Field(..., max_length=50, alias="productNo", description="产品编号") product_name: str = Field(..., max_length=200, alias="productName", description="产品名称") brand_mode: Optional[str] = Field(default=None, alias="brandMode", description="required/any") brand_id: Optional[str] = Field(default=None, alias="brandId", description="指定品牌ID") brand_name: Optional[str] = Field(default=None, alias="brandName", description="品牌名快照") model: Optional[str] = Field(default=None, max_length=100, description="规格型号") unit: str = Field(default="吨", max_length=20, description="单位") category_name: Optional[str] = Field(default=None, max_length=200, alias="categoryName", description="产品分类") package_spec: Optional[str] = Field(default=None, max_length=200, alias="packageSpec", description="包装规格") delivery_method: Optional[str] = Field(default=None, max_length=50, alias="deliveryMethod", description="送货方式") quantity: Optional[Decimal] = Field(default=None, description="合同数量") actual_qty: Optional[Decimal] = Field(default=None, alias="actualQty", description="实际数量") tax_price: Optional[Decimal] = Field(default=None, alias="taxPrice", description="含税单价") tax_amount: Optional[Decimal] = Field(default=None, alias="taxAmount", description="税费") tax_subtotal: Optional[Decimal] = Field(default=None, alias="taxSubtotal", description="含税总价") is_explosive: int = Field(default=0, alias="isExplosive", description="是否易制爆") is_toxic: int = Field(default=0, alias="isToxic", description="是否易制毒") purchase_cert_url: Optional[str] = Field( default=None, alias="purchaseCertUrl", description="购买证URL，逗号分隔" ) transport_cert_url: Optional[str] = Field( default=None, alias="transportCertUrl", description="运输证URL，逗号分隔" ) legal_use_cert_url: Optional[str] = Field( default=None, alias="legalUseCertUrl", description="合法使用证明URL，逗号分隔" ) inbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="inboundEstimateQty", description="入库预估数") inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", description="入库数") inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", description="入库价") inbound_amount: Optional[Decimal] = Field(default=None, alias="inboundAmount", description="入库金额") outbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="outboundEstimateQty", description="出库预估数") outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", description="出库数") outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", description="出库单价") outbound_amount: Optional[Decimal] = Field(default=None, alias="outboundAmount", description="出库金额") remark: Optional[str] = Field(default=None, max_length=512, description="备注") class PlanProductCreate(PlanProductBase): model_config = {"populate_by_name": True} class PlanProductUpdate(BaseModel): product_id: Optional[str] = Field(default=None, alias="productId") product_no: Optional[str] = Field(default=None, max_length=50, alias="productNo") product_name: Optional[str] = Field(default=None, max_length=200, alias="productName") model: Optional[str] = Field(default=None, max_length=100) unit: Optional[str] = Field(default=None, max_length=20) is_explosive: Optional[int] = Field(default=None, alias="isExplosive") is_toxic: Optional[int] = Field(default=None, alias="isToxic") purchase_cert_url: Optional[str] = Field(default=None, alias="purchaseCertUrl") transport_cert_url: Optional[str] = Field(default=None, alias="transportCertUrl") legal_use_cert_url: Optional[str] = Field(default=None, alias="legalUseCertUrl") inbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="inboundEstimateQty") inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty") inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice") inbound_amount: Optional[Decimal] = Field(default=None, alias="inboundAmount") outbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="outboundEstimateQty") outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty") outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice") outbound_amount: Optional[Decimal] = Field(default=None, alias="outboundAmount") model_config = {"populate_by_name": True} class PlanArchiveBrandQtyItem(BaseModel): brand_id: str = Field(default="", alias="brandId") brand_name: Optional[str] = Field(default=None, alias="brandName") qty: Decimal = Field(..., ge=0) unit_price: Optional[Decimal] = Field(default=None, alias="unitPrice", ge=0, description="本品牌单价") model_config = {"populate_by_name": True} class PlanProductRead(PlanProductBase): id: str plan_id: str = Field(alias="planId") tenant_no: str = Field(alias="tenantNo") create_time: datetime = Field(alias="createTime") update_time: datetime = Field(alias="updateTime") brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field( default=None, alias="brandQtys", description="归档品牌数量明细" ) model_config = {"from_attributes": True, "populate_by_name": True} # ============================================================================= # 装货/送货段 Schema # ============================================================================= class PlanStopProductBody(BaseModel): plan_product_id: Optional[str] = Field( default=None, alias="planProductId", description="计划产品行ID（新建时可空，由后端按 productId 匹配）", ) product_id: str = Field(..., alias="productId", description="产品ID") product_no: str = Field(..., max_length=50, alias="productNo", description="产品编号") product_name: str = Field(..., max_length=200, alias="productName", description="产品名称") model: Optional[str] = Field(default=None, max_length=100, description="规格型号") unit: str = Field(default="吨", max_length=20, description="单位") package_spec: Optional[str] = Field(default=None, max_length=200, alias="packageSpec", description="包装规格") delivery_method: Optional[str] = Field(default=None, max_length=50, alias="deliveryMethod", description="送货方式") plan_qty: Optional[Decimal] = Field(default=None, alias="planQty", description="本段计划数量") remark: Optional[str] = Field(default=None, max_length=512, description="备注") model_config = {"populate_by_name": True} class PlanStopProductRead(PlanStopProductBody): id: str plan_id: str = Field(alias="planId") inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", description="入库数量（装货段归档）") inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", description="入库单价（装货段归档）") inbound_amount: Optional[Decimal] = Field(default=None, alias="inboundAmount", description="入库金额（装货段归档）") outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", description="出库数量（送货段归档）") outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", description="出库单价（送货段归档）") outbound_amount: Optional[Decimal] = Field(default=None, alias="outboundAmount", description="出库金额（送货段归档）") brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field( default=None, alias="brandQtys", description="本段归档品牌数量" ) tenant_no: str = Field(alias="tenantNo") order_num: Optional[int] = Field(default=None, alias="orderNum") create_time: datetime = Field(alias="createTime") update_time: datetime = Field(alias="updateTime") model_config = {"from_attributes": True, "populate_by_name": True} class PlanLoadBody(BaseModel): customer_id: Optional[str] = Field(default=None, alias="customerId", description="装货客户ID") customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName", description="装货客户名称") address: Optional[str] = Field(default=None, max_length=500, description="装货地址") lng: Optional[Decimal] = Field(default=None, description="经度") lat: Optional[Decimal] = Field(default=None, description="纬度") load_time: OptionalPlanDateTime = Field(default=None, alias="loadTime", description="装货时间") contact: Optional[str] = Field(default=None, max_length=200, description="联系方式") notes: Optional[str] = Field(default=None, max_length=500, description="注意事项") generate_dibang: int = Field(default=0, alias="generateDibang", description="是否生成地磅单 0-否 1-是") dibang_direction: Optional[str] = Field( default=None, alias="dibangDirection", description="地磅方向 outbound-出库 inbound-入库 none-无" ) products: list[PlanStopProductBody] = Field(default_factory=list, description="装货段产品明细") contracts: Optional[list["PlanContractLink"]] = Field(default=None, description="装货段合同列表") remark: Optional[str] = Field(default=None, max_length=512, description="备注") model_config = {"populate_by_name": True} class PlanDeliveryBody(BaseModel): seq: int = Field(default=1, description="顺序号（打印、链接展示）") customer_id: Optional[str] = Field(default=None, alias="customerId", description="送货客户ID") customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName", description="送货客户名称") address: Optional[str] = Field(default=None, max_length=500, description="送货地址") lng: Optional[Decimal] = Field(default=None, description="经度") lat: Optional[Decimal] = Field(default=None, description="纬度") delivery_time: OptionalPlanDateTime = Field(default=None, alias="deliveryTime", description="送货时间") contact: Optional[str] = Field(default=None, max_length=200, description="联系方式") notes: Optional[str] = Field(default=None, max_length=500, description="注意事项") generate_dibang: int = Field(default=0, alias="generateDibang", description="是否生成地磅单 0-否 1-是") dibang_direction: Optional[str] = Field( default=None, alias="dibangDirection", description="地磅方向 outbound-出库 inbound-入库 none-无" ) products: list[PlanStopProductBody] = Field(default_factory=list, description="送货段产品明细") contracts: Optional[list["PlanContractLink"]] = Field(default=None, description="送货段合同列表") remark: Optional[str] = Field(default=None, max_length=512, description="备注") model_config = {"populate_by_name": True} class PlanLoadRead(PlanLoadBody): id: str plan_id: str = Field(alias="planId") products: list[PlanStopProductRead] = Field(default_factory=list, description="装货段产品明细") tenant_no: str = Field(alias="tenantNo") order_num: Optional[int] = Field(default=None, alias="orderNum") create_time: datetime = Field(alias="createTime") update_time: datetime = Field(alias="updateTime") model_config = {"from_attributes": True, "populate_by_name": True} class PlanDeliveryRead(PlanDeliveryBody): id: str plan_id: str = Field(alias="planId") products: list[PlanStopProductRead] = Field(default_factory=list, description="送货段产品明细") tenant_no: str = Field(alias="tenantNo") order_num: Optional[int] = Field(default=None, alias="orderNum") create_time: datetime = Field(alias="createTime") update_time: datetime = Field(alias="updateTime") model_config = {"from_attributes": True, "populate_by_name": True} # ============================================================================= # 计划主表 Schema # ============================================================================= class PlanBase(BaseModel): belongs_company: str = Field(..., alias="belongsCompany", description="归属公司 shanxia-安庆山峡 yundong-安徽云栋") plan_type: str = Field( default="", alias="planType", description="单据类型 direct-直销单 inbound-入库单 outbound-出库单；未选择可为空", ) follow_status: str = Field( default="pending_arrange", alias="followStatus", description="跟进状态 wait_notice/pending_arrange/arranged/completed/cancelled", ) transport_status: str = Field(default="pending", alias="transportStatus", description="运输安排状态") archive_status: str = Field(default="unarchived", alias="archiveStatus", description="归档状态 unarchived/draft/archived") complete_status: str = Field(default="no", alias="completeStatus", description="完成状态") contract_id: Optional[str] = Field(default=None, alias="contractId", description="CRM合同ID") contract_no: Optional[str] = Field(default=None, max_length=50, alias="contractNo", description="合同编号") supplier_id: Optional[str] = Field(default=None, alias="supplierId", description="供应商ID") supplier_name: Optional[str] = Field(default=None, max_length=200, alias="supplierName", description="供应商名称") destination_id: Optional[str] = Field(default=None, alias="destinationId", description="目的地ID") destination_name: Optional[str] = Field(default=None, max_length=200, alias="destinationName", description="目的地名称") customer_id: Optional[str] = Field(default=None, alias="customerId", description="客户ID") customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName", description="客户名称") contact_name: Optional[str] = Field(default=None, max_length=100, alias="contactName", description="联系人") contact_phone: Optional[str] = Field(default=None, max_length=32, alias="contactPhone", description="联系电话") party_a: Optional[str] = Field(default=None, max_length=200, alias="partyA", description="甲方") party_b: Optional[str] = Field(default=None, max_length=200, alias="partyB", description="乙方") contract_start_date: Optional[date] = Field(default=None, alias="contractStartDate", description="合同开始日期") contract_end_date: Optional[date] = Field(default=None, alias="contractEndDate", description="合同结束日期") delivery_method: Optional[str] = Field(default=None, alias="deliveryMethod", description="送货方式") settlement_method: Optional[str] = Field(default=None, max_length=50, alias="settlementMethod", description="结算方式") has_freight: int = Field(default=0, alias="hasFreight", description="是否有运输费用") freight_remark: Optional[str] = Field(default=None, max_length=512, alias="freightRemark", description="运费备注") pickup_address: Optional[str] = Field(default=None, max_length=500, alias="pickupAddress", description="取货地址") pickup_lng: Optional[Decimal] = Field(default=None, alias="pickupLng", description="取货经度") pickup_lat: Optional[Decimal] = Field(default=None, alias="pickupLat", description="取货纬度") pickup_time: OptionalPlanDateTime = Field(default=None, alias="pickupTime", description="取货时间") pickup_contact: Optional[str] = Field(default=None, max_length=200, alias="pickupContact", description="取货联系方式") pickup_notes: Optional[str] = Field(default=None, max_length=500, alias="pickupNotes", description="取货注意事项") destination_address: Optional[str] = Field(default=None, max_length=500, alias="destinationAddress", description="目的地地址") destination_lng: Optional[Decimal] = Field(default=None, alias="destinationLng", description="送货经度") destination_lat: Optional[Decimal] = Field(default=None, alias="destinationLat", description="送货纬度") delivery_time: OptionalPlanDateTime = Field(default=None, alias="deliveryTime", description="送达时间") delivery_contact: Optional[str] = Field(default=None, max_length=200, alias="deliveryContact", description="送货联系方式") destination_notes: Optional[str] = Field(default=None, max_length=500, alias="destinationNotes", description="目的地注意事项") notify_message: Optional[str] = Field(default=None, alias="notifyMessage", description="通知信息") follow_user_id: Optional[str] = Field(default=None, alias="followUserId", description="跟进人ID") follow_user_name: Optional[str] = Field(default=None, max_length=100, alias="followUserName", description="跟进人姓名") remark: Optional[str] = None class PlanContractLink(BaseModel): contract_id: str = Field(..., alias="contractId", description="CRM合同ID") contract_no: Optional[str] = Field(default=None, max_length=50, alias="contractNo", description="合同编号") stop_id: Optional[str] = Field(default=None, alias="stopId", description="停靠段ID（装货段或送货段）") model_config = {"populate_by_name": True} class PlanCreate(PlanBase): create_date: Optional[date] = Field( default=None, alias="createDate", description="创建日期；缺省则服务端用当天" ) plan_date: Optional[date] = Field(default=None, alias="planDate", description="计划日期（非必填）") products: Optional[list[PlanProductCreate]] = Field(default=None, description="产品明细列表") supplier_contracts: Optional[list[PlanContractLink]] = Field( default=None, alias="supplierContracts", description="供方合同列表" ) demander_contracts: Optional[list[PlanContractLink]] = Field( default=None, alias="demanderContracts", description="需方合同列表" ) load: Optional[PlanLoadBody] = Field(default=None, description="装货段") deliveries: Optional[list[PlanDeliveryBody]] = Field(default=None, description="送货段列表") model_config = {"populate_by_name": True} class PlanTransportCreateBlock(BaseModel): vehicle_id: str = Field(..., alias="vehicleId", description="车辆ID") driver_id: Optional[str] = Field(default=None, alias="driverId", description="司机/人员ID") carrier_id: Optional[str] = Field(default=None, alias="carrierId", description="承运商ID") distance_km: Optional[Decimal] = Field(default=None, alias="distanceKm", description="运输公里数") freight_type: str = Field(default="by_weight", alias="freightType", description="运费计算方式") transport_qty: Optional[Decimal] = Field(default=None, alias="transportQty", description="运输量") freight_price: Optional[Decimal] = Field(default=None, alias="freightPrice", description="运输单价") freight_amount: Optional[Decimal] = Field(default=None, alias="freightAmount", description="运费金额") has_invoice: Optional[int] = Field(default=None, alias="hasInvoice", description="是否开票（已废弃，由运费结算维护）") remark: Optional[str] = None model_config = {"populate_by_name": True} class PlanUpdate(BaseModel): create_date: Optional[date] = Field(default=None, alias="createDate") plan_date: Optional[date] = Field(default=None, alias="planDate") belongs_company: Optional[str] = Field(default=None, alias="belongsCompany") plan_type: Optional[str] = Field(default=None, alias="planType") follow_status: Optional[str] = Field(default=None, alias="followStatus") transport_status: Optional[str] = Field(default=None, alias="transportStatus") supplier_id: Optional[str] = Field(default=None, alias="supplierId") supplier_name: Optional[str] = Field(default=None, max_length=200, alias="supplierName") destination_id: Optional[str] = Field(default=None, alias="destinationId") destination_name: Optional[str] = Field(default=None, max_length=200, alias="destinationName") customer_id: Optional[str] = Field(default=None, alias="customerId") customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName") contact_name: Optional[str] = Field(default=None, max_length=100, alias="contactName") contact_phone: Optional[str] = Field(default=None, max_length=32, alias="contactPhone") party_a: Optional[str] = Field(default=None, max_length=200, alias="partyA") party_b: Optional[str] = Field(default=None, max_length=200, alias="partyB") contract_start_date: Optional[date] = Field(default=None, alias="contractStartDate") contract_end_date: Optional[date] = Field(default=None, alias="contractEndDate") delivery_method: Optional[str] = Field(default=None, alias="deliveryMethod") settlement_method: Optional[str] = Field(default=None, max_length=50, alias="settlementMethod") has_freight: Optional[int] = Field(default=None, alias="hasFreight") freight_remark: Optional[str] = Field(default=None, max_length=512, alias="freightRemark") pickup_address: Optional[str] = Field(default=None, max_length=500, alias="pickupAddress") pickup_lng: Optional[Decimal] = Field(default=None, alias="pickupLng") pickup_lat: Optional[Decimal] = Field(default=None, alias="pickupLat") pickup_time: OptionalPlanDateTime = Field(default=None, alias="pickupTime") pickup_contact: Optional[str] = Field(default=None, max_length=200, alias="pickupContact") pickup_notes: Optional[str] = Field(default=None, max_length=500, alias="pickupNotes") destination_address: Optional[str] = Field(default=None, max_length=500, alias="destinationAddress") destination_lng: Optional[Decimal] = Field(default=None, alias="destinationLng") destination_lat: Optional[Decimal] = Field(default=None, alias="destinationLat") delivery_time: OptionalPlanDateTime = Field(default=None, alias="deliveryTime") delivery_contact: Optional[str] = Field(default=None, max_length=200, alias="deliveryContact") destination_notes: Optional[str] = Field(default=None, max_length=500, alias="destinationNotes") notify_message: Optional[str] = Field(default=None, alias="notifyMessage") follow_user_id: Optional[str] = Field(default=None, alias="followUserId") follow_user_name: Optional[str] = Field(default=None, alias="followUserName") remark: Optional[str] = None products: Optional[list[PlanProductCreate]] = None supplier_contracts: Optional[list[PlanContractLink]] = Field( default=None, alias="supplierContracts", description="供方合同列表" ) demander_contracts: Optional[list[PlanContractLink]] = Field( default=None, alias="demanderContracts", description="需方合同列表" ) transport: Optional[PlanTransportCreateBlock] = Field(default=None, description="运输预选/更新（有车牌时同步车辆与运费）") load: Optional[PlanLoadBody] = Field(default=None, description="装货段") deliveries: Optional[list[PlanDeliveryBody]] = Field(default=None, description="送货段列表") model_config = {"populate_by_name": True} class HazardCertReadyBody(BaseModel): ready: bool = Field(..., description="true=确认证书齐备 false=取消齐备") model_config = {"populate_by_name": True} class ErpEnteredBody(BaseModel): entered: bool = Field(..., description="true=已录入ERP false=未录入") model_config = {"populate_by_name": True} class PlanDocumentAttachmentItem(BaseModel): url: str = Field(..., description="附件URL") label: str = Field(..., description="来源标签，如司机/现场") model_config = {"populate_by_name": True} class PlanRead(PlanBase, PlanResourceSnapshotMixin): id: str plan_no: str = Field(alias="planNo") create_date: date = Field(alias="createDate") plan_date: Optional[date] = Field(default=None, alias="planDate") hazard_cert_ready: int = Field(default=0, alias="hazardCertReady", description="危化品证书是否已人工确认齐备") hazard_cert_ready_by: Optional[str] = Field(default=None, alias="hazardCertReadyBy", description="危化品证书确认人") hazard_cert_ready_time: Optional[datetime] = Field(default=None, alias="hazardCertReadyTime", description="危化品证书确认时间") erp_entered: int = Field(default=0, alias="erpEntered", description="是否已录入ERP 0-否 1-是") vehicle_id: Optional[str] = Field(default=None, alias="vehicleId") license_plate: Optional[str] = Field(default=None, alias="licensePlate") driver_id: Optional[str] = Field(default=None, alias="driverId") driver_name: Optional[str] = Field(default=None, alias="driverName") personnel_summary: Optional[str] = Field(default=None, alias="personnelSummary") transport_id: Optional[str] = Field(default=None, alias="transportId") transport_no: Optional[str] = Field(default=None, alias="transportNo") total_amount: Decimal = Field(alias="totalAmount") freight_amount: Decimal = Field(alias="freightAmount") tenant_no: str = Field(alias="tenantNo") order_num: Optional[int] = Field(default=None, alias="orderNum") create_by: Optional[str] = Field(default=None, alias="createBy") create_dept_id: Optional[str] = Field(default=None, alias="createDeptId") create_time: datetime = Field(alias="createTime") update_by: Optional[str] = Field(default=None, alias="updateBy") update_time: datetime = Field(alias="updateTime") del_flag: int = Field(default=0, alias="delFlag") supplier_contracts: list[PlanContractLink] = Field( default_factory=list, alias="supplierContracts", description="供方合同列表" ) demander_contracts: list[PlanContractLink] = Field( default_factory=list, alias="demanderContracts", description="需方合同列表" ) model_config = {"from_attributes": True, "populate_by_name": True} class PlanWithProducts(PlanRead): products: list[PlanProductRead] = [] load: Optional[PlanLoadRead] = Field(default=None, description="装货段") deliveries: list[PlanDeliveryRead] = Field(default_factory=list, description="送货段列表") load_customer_name: Optional[str] = Field( default=None, alias="loadCustomerName", description="装货客户名称摘要（列表展示）", ) delivery_customer_summary: Optional[str] = Field( default=None, alias="deliveryCustomerSummary", description="送货客户摘要（列表展示）", ) warnings: list[str] = Field(default_factory=list, description="保存告警（如数量不平衡）") can_copy_to_driver: bool = Field( default=False, alias="canCopyToDriver", description="列表/查看：是否可「复制给司机」（已安排且有司机链接或现场/地磅关联）", ) can_copy_to_site: bool = Field( default=False, alias="canCopyToSite", description="是否可「复制给现场」", ) can_copy_pound_qrcode: bool = Field( default=False, alias="canCopyPoundQrcode", description="是否可「复制磅单二维码」", ) document_attachments: list[PlanDocumentAttachmentItem] = Field( default_factory=list, alias="documentAttachments", description="单据附件（司机/现场/出入库现场等）", ) # ============================================================================= # 送(提)货单打印（按送货客户聚合） # ============================================================================= class DeliveryPrintCustomerOption(BaseModel): customer_id: str = Field(alias="customerId", description="送货客户ID或名称键") customer_name: str = Field(alias="customerName", description="送货客户名称") delivery_count: int = Field(default=1, alias="deliveryCount", description="送货段数量") model_config = {"populate_by_name": True} class DeliverySlipPrintRead(BaseModel): plan_id: str = Field(alias="planId") plan_no: str = Field(alias="planNo") plan_date: Optional[str] = Field(default=None, alias="planDate") customer_id: Optional[str] = Field(default=None, alias="customerId") receiving_unit: Optional[str] = Field(default=None, alias="receivingUnit") receive_contact: Optional[str] = Field(default=None, alias="receiveContact") delivery_address: Optional[str] = Field(default=None, alias="deliveryAddress") products: list[PlanStopProductRead] = Field(default_factory=list) customers: list[DeliveryPrintCustomerOption] = Field(default_factory=list) model_config = {"populate_by_name": True} class PlanInboundSlipTemplateSave(BaseModel): slip_template_content: str = Field(..., alias="slipTemplateContent", description="入库单打印模板HTML") model_config = {"populate_by_name": True} class PlanDeliverySlipTemplateSave(BaseModel): delivery_slip_template_content: str = Field( ..., alias="slipTemplateContent", description="送(提)货单打印模板HTML" ) model_config = {"populate_by_name": True} class PlanSubpackSlipTemplateSave(BaseModel): subpack_slip_template_content: str = Field( ..., alias="slipTemplateContent", description="分装单打印模板HTML" ) model_config = {"populate_by_name": True} # ============================================================================= # 从合同创建计划 # ============================================================================= class CreateFromContractRequest(BaseModel): contract_id: str = Field(..., alias="contractId", description="CRM合同ID") create_date: Optional[date] = Field( default=None, alias="createDate", description="创建日期；缺省当天" ) plan_date: Optional[date] = Field(default=None, alias="planDate", description="计划日期（非必填）") follow_user_id: Optional[str] = Field(default=None, alias="followUserId", description="跟进人ID") follow_user_name: Optional[str] = Field(default=None, max_length=100, alias="followUserName", description="跟进人姓名") model_config = {"populate_by_name": True} class PlanCreateFull(PlanCreate): contract_id: Optional[str] = Field(default=None, alias="contractId", description="旧字段：单一合同ID，已废弃为唯一源") transport: Optional[PlanTransportCreateBlock] = Field(default=None, description="运输安排（有车牌时创建运输）") model_config = {"populate_by_name": True} # ============================================================================= # 计划列表查询 # ============================================================================= class PlanListQuery(BaseModel): q: Optional[str] = Field(default=None, description="模糊搜索计划号/客户名称/产品名称/车牌号") plan_no: Optional[str] = Field(default=None, alias="planNo", description="计划编号") plan_type: Optional[str] = Field(default=None, alias="planType", description="单据类型") follow_status: Optional[str] = Field(default=None, alias="followStatus", description="跟进状态") transport_status: Optional[str] = Field(default=None, alias="transportStatus", description="运输状态") archive_status: Optional[str] = Field(default=None, alias="archiveStatus", description="归档状态") customer_name: Optional[str] = Field(default=None, alias="customerName", description="客户名称") product_name: Optional[str] = Field(default=None, alias="productName", description="产品名称") license_plate: Optional[str] = Field(default=None, alias="licensePlate", description="车牌号") plan_date_from: Optional[date] = Field(default=None, alias="planDateFrom", description="计划日期开始") plan_date_to: Optional[date] = Field(default=None, alias="planDateTo", description="计划日期结束") has_hazard_product: Optional[int] = Field( default=None, alias="hasHazardProduct", description="1=仅含易制毒/易制爆产品的计划" ) cert_upload_status: Optional[str] = Field( default=None, alias="certUploadStatus", description="incomplete=至少一张必需危化证书未上传", ) page: int = Field(default=1, ge=1, description="页码") page_size: int = Field(default=20, ge=1, le=500, alias="pageSize", description="每页数量") model_config = {"populate_by_name": True} class PlanProductCertItem(BaseModel): id: str = Field(..., description="计划产品明细ID") purchase_cert_url: Optional[str] = Field(default=None, alias="purchaseCertUrl", description="购买证URL，逗号分隔") transport_cert_url: Optional[str] = Field(default=None, alias="transportCertUrl", description="运输证URL，逗号分隔") legal_use_cert_url: Optional[str] = Field(default=None, alias="legalUseCertUrl", description="合法使用证明URL，逗号分隔") model_config = {"populate_by_name": True} class PlanProductCertsUpdate(BaseModel): products: list[PlanProductCertItem] = Field(..., description="危化品证书更新列表") model_config = {"populate_by_name": True} class PlanArchiveProductItem(BaseModel): id: str = Field(..., description="计划产品明细ID pl_plan_product.id") actual_qty: Optional[Decimal] = Field(default=None, alias="actualQty", ge=0, description="实际数量") inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", ge=0, description="入库数量") inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", ge=0, description="入库价") outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", ge=0, description="出库数量") outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", ge=0, description="出库价") brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(default=None, alias="brandQtys") model_config = {"populate_by_name": True} class PlanArchiveStopProductItem(BaseModel): id: str = Field(..., description="段产品行ID（pl_plan_load_product / pl_plan_delivery_product）") inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", ge=0, description="入库数量（装货段）") inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", ge=0, description="入库单价（装货段）") outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", ge=0, description="出库数量（送货段）") outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", ge=0, description="出库单价（送货段）") brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field( default=None, alias="brandQtys", description="本段归档品牌数量（与归档弹窗填写一致）" ) model_config = {"populate_by_name": True} class PlanArchiveLoadBlock(BaseModel): stop_id: str = Field(alias="stopId", description="装货段ID") products: list[PlanArchiveStopProductItem] = Field(default_factory=list) model_config = {"populate_by_name": True} class PlanArchiveDeliveryBlock(BaseModel): stop_id: str = Field(alias="stopId", description="送货段ID") products: list[PlanArchiveStopProductItem] = Field(default_factory=list) model_config = {"populate_by_name": True} class PlanArchiveFreightBlock(BaseModel): has_freight: int = Field(default=1, alias="hasFreight", description="是否有运输费用 0-否 1-是") freight_remark: Optional[str] = Field(default=None, max_length=512, alias="freightRemark", description="运费备注") distance_km: Optional[Decimal] = Field(default=None, alias="distanceKm") freight_type: str = Field(default="by_weight", alias="freightType") freight_price: Optional[Decimal] = Field(default=None, alias="freightPrice") freight_amount: Optional[Decimal] = Field(default=None, alias="freightAmount") transport_qty: Optional[Decimal] = Field(default=None, alias="transportQty") has_invoice: Optional[int] = Field(default=None, alias="hasInvoice") model_config = {"populate_by_name": True} class PlanArchiveStopFeedbackAttachmentItem(BaseModel): stop_type: str = Field(alias="stopType", description="停靠段类型 load/delivery") stop_id: str = Field(alias="stopId", description="停靠段ID") attachment_urls: list[str] = Field(default_factory=list, alias="attachmentUrls", description="附件URLs") model_config = {"populate_by_name": True} class PlanArchiveFeedbacksBlock(BaseModel): driver_stops: list[PlanArchiveStopFeedbackAttachmentItem] = Field( default_factory=list, alias="driverStops", description="司机按段回传附件" ) site_stops: list[PlanArchiveStopFeedbackAttachmentItem] = Field( default_factory=list, alias="siteStops", description="现场按段回传附件" ) model_config = {"populate_by_name": True} class PlanArchiveBody(BaseModel): products: list[PlanArchiveProductItem] = Field(default_factory=list) load: Optional[PlanArchiveLoadBlock] = None deliveries: Optional[list[PlanArchiveDeliveryBlock]] = None freight: Optional[PlanArchiveFreightBlock] = None feedbacks: Optional[PlanArchiveFeedbacksBlock] = None model_config = {"populate_by_name": True} class PlanDriverFeedbackProductItem(BaseModel): plan_product_id: str = Field(alias="planProductId") actual_qty: Decimal = Field(alias="actualQty", ge=0) brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(default=None, alias="brandQtys") model_config = {"populate_by_name": True} class PlanDriverFeedbackUpdateBody(BaseModel): feedback_remark: Optional[str] = Field(default=None, alias="feedbackRemark", max_length=500, description="回传备注") feedback_images: Optional[list[str]] = Field(default=None, alias="feedbackImages", description="回传附件URLs") feedback_time: OptionalPlanDateTime = Field(default=None, alias="feedbackTime", description="回传时间") products: Optional[list[PlanDriverFeedbackProductItem]] = None feedback_qty: Optional[Decimal] = Field(default=None, alias="feedbackQty", ge=0, description="回传数量") model_config = {"populate_by_name": True} class PlanSiteFeedbackUpdateBody(BaseModel): site_feedback_remark: Optional[str] = Field( default=None, alias="siteFeedbackRemark", max_length=500, description="现场回执备注" ) site_feedback_images: Optional[list[str]] = Field( default=None, alias="siteFeedbackImages", description="现场回执附件URLs" ) site_feedback_time: OptionalPlanDateTime = Field( default=None, alias="siteFeedbackTime", description="现场回执保存时间" ) model_config = {"populate_by_name": True} class PlanListResponse(BaseModel): total: int list: list[PlanWithProducts] class PlanForceFollowStatusBody(BaseModel): """运维纠错：强制改跟进状态（仅改字段，不联动业务）。""" follow_status: str = Field( ..., alias="followStatus", description="跟进状态 wait_notice/pending_arrange/arranged/completed/cancelled", ) model_config = {"populate_by_name": True} class PlanSideContractsUpdateBody(BaseModel): contracts: list[PlanContractLink] = Field(default_factory=list) model_config = {"populate_by_name": True} class PlanStopContractsUpdateBody(BaseModel): stop_type: str = Field(..., alias="stopType", description="load | delivery") stop_id: str = Field(..., alias="stopId", description="装货/送货段ID") contracts: list[PlanContractLink] = Field(default_factory=list) model_config = {"populate_by_name": True} class PlanContractGapRead(BaseModel): id: str plan_no: str = Field(..., alias="planNo") plan_date: Optional[date] = Field(None, alias="planDate") plan_type: Optional[str] = Field(None, alias="planType") follow_status: str = Field(..., alias="followStatus") supplier_id: Optional[str] = Field(None, alias="supplierId") supplier_name: Optional[str] = Field(None, alias="supplierName") customer_id: Optional[str] = Field(None, alias="customerId") customer_name: Optional[str] = Field(None, alias="customerName") gap_sides: list[str] = Field(default_factory=list, alias="gapSides") supplier_contract_exempt: bool = Field(..., alias="supplierContractExempt") demander_contract_exempt: bool = Field(..., alias="demanderContractExempt") supplier_contracts: list[PlanContractLink] = Field(default_factory=list, alias="supplierContracts") demander_contracts: list[PlanContractLink] = Field(default_factory=list, alias="demanderContracts") products: list[PlanProductRead] = Field(default_factory=list, description="产品明细") load: Optional["PlanLoadRead"] = Field(default=None, description="装货段") deliveries: list["PlanDeliveryRead"] = Field(default_factory=list, alias="deliveries", description="送货段列表") model_config = {"populate_by_name": True, "from_attributes": True} class PlanContractGapListResponse(BaseModel): total: int list: list[PlanContractGapRead]