"""运输计划管理 - 计划 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 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") 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="归档状态") 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="是否有运输费用") 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_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="送达时间") 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 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="产品明细列表") 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") 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_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") 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 transport: Optional[PlanTransportCreateBlock] = 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 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="危化品证书确认时间") 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") model_config = {"from_attributes": True, "populate_by_name": True} class PlanWithProducts(PlanRead): products: list[PlanProductRead] = [] 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: str = Field(..., alias="contractId", description="CRM合同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="客户名称") plan_date_from: Optional[date] = Field(default=None, alias="planDateFrom", description="计划日期开始") plan_date_to: Optional[date] = Field(default=None, alias="planDateTo", description="计划日期结束") page: int = Field(default=1, ge=1, description="页码") page_size: int = Field(default=20, ge=1, le=100, 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 PlanArchiveBrandQtyItem(BaseModel): brand_id: str = Field(default="", alias="brandId") brand_name: Optional[str] = Field(default=None, alias="brandName") qty: Decimal = Field(..., ge=0) model_config = {"populate_by_name": True} class PlanArchiveProductItem(BaseModel): id: str = Field(..., description="计划产品明细ID pl_plan_product.id") actual_qty: Decimal = Field(..., alias="actualQty", ge=0, description="实际数量") brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(default=None, alias="brandQtys") model_config = {"populate_by_name": True} class PlanArchiveFreightBlock(BaseModel): has_freight: int = Field(default=1, alias="hasFreight", description="是否有运输费用 0-否 1-是") 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 PlanArchiveBody(BaseModel): products: list[PlanArchiveProductItem] = Field(..., min_length=1) freight: Optional[PlanArchiveFreightBlock] = 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]