plan.py 41 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710
  1. """运输计划管理 - 计划 Schema"""
  2. from datetime import date, datetime
  3. from decimal import Decimal
  4. from typing import Optional
  5. from pydantic import BaseModel, Field
  6. from app.schemas.pl.datetime_parse import OptionalPlanDateTime
  7. from app.schemas.pl.resource_snapshot import PlanResourceSnapshotMixin
  8. # =============================================================================
  9. # 计划产品明细 Schema
  10. # =============================================================================
  11. class PlanProductBase(BaseModel):
  12. product_id: str = Field(..., alias="productId", description="产品ID")
  13. product_no: str = Field(..., max_length=50, alias="productNo", description="产品编号")
  14. product_name: str = Field(..., max_length=200, alias="productName", description="产品名称")
  15. brand_mode: Optional[str] = Field(default=None, alias="brandMode", description="required/any")
  16. brand_id: Optional[str] = Field(default=None, alias="brandId", description="指定品牌ID")
  17. brand_name: Optional[str] = Field(default=None, alias="brandName", description="品牌名快照")
  18. model: Optional[str] = Field(default=None, max_length=100, description="规格型号")
  19. unit: str = Field(default="吨", max_length=20, description="单位")
  20. category_name: Optional[str] = Field(default=None, max_length=200, alias="categoryName", description="产品分类")
  21. package_spec: Optional[str] = Field(default=None, max_length=200, alias="packageSpec", description="包装规格")
  22. delivery_method: Optional[str] = Field(default=None, max_length=50, alias="deliveryMethod", description="送货方式")
  23. quantity: Optional[Decimal] = Field(default=None, description="合同数量")
  24. actual_qty: Optional[Decimal] = Field(default=None, alias="actualQty", description="实际数量")
  25. tax_price: Optional[Decimal] = Field(default=None, alias="taxPrice", description="含税单价")
  26. tax_amount: Optional[Decimal] = Field(default=None, alias="taxAmount", description="税费")
  27. tax_subtotal: Optional[Decimal] = Field(default=None, alias="taxSubtotal", description="含税总价")
  28. is_explosive: int = Field(default=0, alias="isExplosive", description="是否易制爆")
  29. is_toxic: int = Field(default=0, alias="isToxic", description="是否易制毒")
  30. purchase_cert_url: Optional[str] = Field(
  31. default=None, alias="purchaseCertUrl", description="购买证URL,逗号分隔"
  32. )
  33. transport_cert_url: Optional[str] = Field(
  34. default=None, alias="transportCertUrl", description="运输证URL,逗号分隔"
  35. )
  36. legal_use_cert_url: Optional[str] = Field(
  37. default=None, alias="legalUseCertUrl", description="合法使用证明URL,逗号分隔"
  38. )
  39. inbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="inboundEstimateQty", description="入库预估数")
  40. inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", description="入库数")
  41. inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", description="入库价")
  42. inbound_amount: Optional[Decimal] = Field(default=None, alias="inboundAmount", description="入库金额")
  43. outbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="outboundEstimateQty", description="出库预估数")
  44. outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", description="出库数")
  45. outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", description="出库单价")
  46. outbound_amount: Optional[Decimal] = Field(default=None, alias="outboundAmount", description="出库金额")
  47. remark: Optional[str] = Field(default=None, max_length=512, description="备注")
  48. class PlanProductCreate(PlanProductBase):
  49. model_config = {"populate_by_name": True}
  50. class PlanProductUpdate(BaseModel):
  51. product_id: Optional[str] = Field(default=None, alias="productId")
  52. product_no: Optional[str] = Field(default=None, max_length=50, alias="productNo")
  53. product_name: Optional[str] = Field(default=None, max_length=200, alias="productName")
  54. model: Optional[str] = Field(default=None, max_length=100)
  55. unit: Optional[str] = Field(default=None, max_length=20)
  56. is_explosive: Optional[int] = Field(default=None, alias="isExplosive")
  57. is_toxic: Optional[int] = Field(default=None, alias="isToxic")
  58. purchase_cert_url: Optional[str] = Field(default=None, alias="purchaseCertUrl")
  59. transport_cert_url: Optional[str] = Field(default=None, alias="transportCertUrl")
  60. legal_use_cert_url: Optional[str] = Field(default=None, alias="legalUseCertUrl")
  61. inbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="inboundEstimateQty")
  62. inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty")
  63. inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice")
  64. inbound_amount: Optional[Decimal] = Field(default=None, alias="inboundAmount")
  65. outbound_estimate_qty: Optional[Decimal] = Field(default=None, alias="outboundEstimateQty")
  66. outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty")
  67. outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice")
  68. outbound_amount: Optional[Decimal] = Field(default=None, alias="outboundAmount")
  69. model_config = {"populate_by_name": True}
  70. class PlanArchiveBrandQtyItem(BaseModel):
  71. brand_id: str = Field(default="", alias="brandId")
  72. brand_name: Optional[str] = Field(default=None, alias="brandName")
  73. qty: Decimal = Field(..., ge=0)
  74. unit_price: Optional[Decimal] = Field(default=None, alias="unitPrice", ge=0, description="本品牌单价")
  75. model_config = {"populate_by_name": True}
  76. class PlanProductRead(PlanProductBase):
  77. id: str
  78. plan_id: str = Field(alias="planId")
  79. tenant_no: str = Field(alias="tenantNo")
  80. create_time: datetime = Field(alias="createTime")
  81. update_time: datetime = Field(alias="updateTime")
  82. brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(
  83. default=None, alias="brandQtys", description="归档品牌数量明细"
  84. )
  85. model_config = {"from_attributes": True, "populate_by_name": True}
  86. # =============================================================================
  87. # 装货/送货段 Schema
  88. # =============================================================================
  89. class PlanStopProductBody(BaseModel):
  90. plan_product_id: Optional[str] = Field(
  91. default=None,
  92. alias="planProductId",
  93. description="计划产品行ID(新建时可空,由后端按 productId 匹配)",
  94. )
  95. product_id: str = Field(..., alias="productId", description="产品ID")
  96. product_no: str = Field(..., max_length=50, alias="productNo", description="产品编号")
  97. product_name: str = Field(..., max_length=200, alias="productName", description="产品名称")
  98. model: Optional[str] = Field(default=None, max_length=100, description="规格型号")
  99. unit: str = Field(default="吨", max_length=20, description="单位")
  100. package_spec: Optional[str] = Field(default=None, max_length=200, alias="packageSpec", description="包装规格")
  101. delivery_method: Optional[str] = Field(default=None, max_length=50, alias="deliveryMethod", description="送货方式")
  102. plan_qty: Optional[Decimal] = Field(default=None, alias="planQty", description="本段计划数量")
  103. remark: Optional[str] = Field(default=None, max_length=512, description="备注")
  104. model_config = {"populate_by_name": True}
  105. class PlanStopProductRead(PlanStopProductBody):
  106. id: str
  107. plan_id: str = Field(alias="planId")
  108. inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", description="入库数量(装货段归档)")
  109. inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", description="入库单价(装货段归档)")
  110. inbound_amount: Optional[Decimal] = Field(default=None, alias="inboundAmount", description="入库金额(装货段归档)")
  111. outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", description="出库数量(送货段归档)")
  112. outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", description="出库单价(送货段归档)")
  113. outbound_amount: Optional[Decimal] = Field(default=None, alias="outboundAmount", description="出库金额(送货段归档)")
  114. brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(
  115. default=None, alias="brandQtys", description="本段归档品牌数量"
  116. )
  117. tenant_no: str = Field(alias="tenantNo")
  118. order_num: Optional[int] = Field(default=None, alias="orderNum")
  119. create_time: datetime = Field(alias="createTime")
  120. update_time: datetime = Field(alias="updateTime")
  121. model_config = {"from_attributes": True, "populate_by_name": True}
  122. class PlanLoadBody(BaseModel):
  123. customer_id: Optional[str] = Field(default=None, alias="customerId", description="装货客户ID")
  124. customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName", description="装货客户名称")
  125. address: Optional[str] = Field(default=None, max_length=500, description="装货地址")
  126. lng: Optional[Decimal] = Field(default=None, description="经度")
  127. lat: Optional[Decimal] = Field(default=None, description="纬度")
  128. load_time: OptionalPlanDateTime = Field(default=None, alias="loadTime", description="装货时间")
  129. contact: Optional[str] = Field(default=None, max_length=200, description="联系方式")
  130. notes: Optional[str] = Field(default=None, max_length=500, description="注意事项")
  131. generate_dibang: int = Field(default=0, alias="generateDibang", description="是否生成地磅单 0-否 1-是")
  132. dibang_direction: Optional[str] = Field(
  133. default=None, alias="dibangDirection", description="地磅方向 outbound-出库 inbound-入库 none-无"
  134. )
  135. products: list[PlanStopProductBody] = Field(default_factory=list, description="装货段产品明细")
  136. contracts: Optional[list["PlanContractLink"]] = Field(default=None, description="装货段合同列表")
  137. remark: Optional[str] = Field(default=None, max_length=512, description="备注")
  138. model_config = {"populate_by_name": True}
  139. class PlanDeliveryBody(BaseModel):
  140. seq: int = Field(default=1, description="顺序号(打印、链接展示)")
  141. customer_id: Optional[str] = Field(default=None, alias="customerId", description="送货客户ID")
  142. customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName", description="送货客户名称")
  143. address: Optional[str] = Field(default=None, max_length=500, description="送货地址")
  144. lng: Optional[Decimal] = Field(default=None, description="经度")
  145. lat: Optional[Decimal] = Field(default=None, description="纬度")
  146. delivery_time: OptionalPlanDateTime = Field(default=None, alias="deliveryTime", description="送货时间")
  147. contact: Optional[str] = Field(default=None, max_length=200, description="联系方式")
  148. notes: Optional[str] = Field(default=None, max_length=500, description="注意事项")
  149. generate_dibang: int = Field(default=0, alias="generateDibang", description="是否生成地磅单 0-否 1-是")
  150. dibang_direction: Optional[str] = Field(
  151. default=None, alias="dibangDirection", description="地磅方向 outbound-出库 inbound-入库 none-无"
  152. )
  153. products: list[PlanStopProductBody] = Field(default_factory=list, description="送货段产品明细")
  154. contracts: Optional[list["PlanContractLink"]] = Field(default=None, description="送货段合同列表")
  155. remark: Optional[str] = Field(default=None, max_length=512, description="备注")
  156. model_config = {"populate_by_name": True}
  157. class PlanLoadRead(PlanLoadBody):
  158. id: str
  159. plan_id: str = Field(alias="planId")
  160. products: list[PlanStopProductRead] = Field(default_factory=list, description="装货段产品明细")
  161. tenant_no: str = Field(alias="tenantNo")
  162. order_num: Optional[int] = Field(default=None, alias="orderNum")
  163. create_time: datetime = Field(alias="createTime")
  164. update_time: datetime = Field(alias="updateTime")
  165. model_config = {"from_attributes": True, "populate_by_name": True}
  166. class PlanDeliveryRead(PlanDeliveryBody):
  167. id: str
  168. plan_id: str = Field(alias="planId")
  169. products: list[PlanStopProductRead] = Field(default_factory=list, description="送货段产品明细")
  170. tenant_no: str = Field(alias="tenantNo")
  171. order_num: Optional[int] = Field(default=None, alias="orderNum")
  172. create_time: datetime = Field(alias="createTime")
  173. update_time: datetime = Field(alias="updateTime")
  174. model_config = {"from_attributes": True, "populate_by_name": True}
  175. # =============================================================================
  176. # 计划主表 Schema
  177. # =============================================================================
  178. class PlanBase(BaseModel):
  179. belongs_company: str = Field(..., alias="belongsCompany", description="归属公司 shanxia-安庆山峡 yundong-安徽云栋")
  180. plan_type: str = Field(
  181. default="",
  182. alias="planType",
  183. description="单据类型 direct-直销单 inbound-入库单 outbound-出库单;未选择可为空",
  184. )
  185. follow_status: str = Field(
  186. default="pending_arrange",
  187. alias="followStatus",
  188. description="跟进状态 drafting/wait_notice/pending_arrange/arranged/completed/cancelled",
  189. )
  190. transport_status: str = Field(default="pending", alias="transportStatus", description="运输安排状态")
  191. archive_status: str = Field(default="unarchived", alias="archiveStatus", description="归档状态 unarchived/draft/archived")
  192. complete_status: str = Field(default="no", alias="completeStatus", description="完成状态")
  193. contract_id: Optional[str] = Field(default=None, alias="contractId", description="CRM合同ID")
  194. contract_no: Optional[str] = Field(default=None, max_length=50, alias="contractNo", description="合同编号")
  195. supplier_id: Optional[str] = Field(default=None, alias="supplierId", description="供应商ID")
  196. supplier_name: Optional[str] = Field(default=None, max_length=200, alias="supplierName", description="供应商名称")
  197. destination_id: Optional[str] = Field(default=None, alias="destinationId", description="目的地ID")
  198. destination_name: Optional[str] = Field(default=None, max_length=200, alias="destinationName", description="目的地名称")
  199. customer_id: Optional[str] = Field(default=None, alias="customerId", description="客户ID")
  200. customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName", description="客户名称")
  201. contact_name: Optional[str] = Field(default=None, max_length=100, alias="contactName", description="联系人")
  202. contact_phone: Optional[str] = Field(default=None, max_length=32, alias="contactPhone", description="联系电话")
  203. party_a: Optional[str] = Field(default=None, max_length=200, alias="partyA", description="甲方")
  204. party_b: Optional[str] = Field(default=None, max_length=200, alias="partyB", description="乙方")
  205. contract_start_date: Optional[date] = Field(default=None, alias="contractStartDate", description="合同开始日期")
  206. contract_end_date: Optional[date] = Field(default=None, alias="contractEndDate", description="合同结束日期")
  207. delivery_method: Optional[str] = Field(default=None, alias="deliveryMethod", description="送货方式")
  208. settlement_method: Optional[str] = Field(default=None, max_length=50, alias="settlementMethod", description="结算方式")
  209. has_freight: int = Field(default=0, alias="hasFreight", description="是否有运输费用")
  210. freight_remark: Optional[str] = Field(default=None, max_length=512, alias="freightRemark", description="运费备注")
  211. pickup_address: Optional[str] = Field(default=None, max_length=500, alias="pickupAddress", description="取货地址")
  212. pickup_lng: Optional[Decimal] = Field(default=None, alias="pickupLng", description="取货经度")
  213. pickup_lat: Optional[Decimal] = Field(default=None, alias="pickupLat", description="取货纬度")
  214. pickup_time: OptionalPlanDateTime = Field(default=None, alias="pickupTime", description="取货时间")
  215. pickup_contact: Optional[str] = Field(default=None, max_length=200, alias="pickupContact", description="取货联系方式")
  216. pickup_notes: Optional[str] = Field(default=None, max_length=500, alias="pickupNotes", description="取货注意事项")
  217. destination_address: Optional[str] = Field(default=None, max_length=500, alias="destinationAddress", description="目的地地址")
  218. destination_lng: Optional[Decimal] = Field(default=None, alias="destinationLng", description="送货经度")
  219. destination_lat: Optional[Decimal] = Field(default=None, alias="destinationLat", description="送货纬度")
  220. delivery_time: OptionalPlanDateTime = Field(default=None, alias="deliveryTime", description="送达时间")
  221. delivery_contact: Optional[str] = Field(default=None, max_length=200, alias="deliveryContact", description="送货联系方式")
  222. destination_notes: Optional[str] = Field(default=None, max_length=500, alias="destinationNotes", description="目的地注意事项")
  223. notify_message: Optional[str] = Field(default=None, alias="notifyMessage", description="通知信息")
  224. follow_user_id: Optional[str] = Field(default=None, alias="followUserId", description="跟进人ID")
  225. follow_user_name: Optional[str] = Field(default=None, max_length=100, alias="followUserName", description="跟进人姓名")
  226. remark: Optional[str] = None
  227. class PlanContractLink(BaseModel):
  228. contract_id: str = Field(..., alias="contractId", description="CRM合同ID")
  229. contract_no: Optional[str] = Field(default=None, max_length=50, alias="contractNo", description="合同编号")
  230. stop_id: Optional[str] = Field(default=None, alias="stopId", description="停靠段ID(装货段或送货段)")
  231. model_config = {"populate_by_name": True}
  232. class PlanCreate(PlanBase):
  233. create_date: Optional[date] = Field(
  234. default=None, alias="createDate", description="创建日期;缺省则服务端用当天"
  235. )
  236. plan_date: Optional[date] = Field(default=None, alias="planDate", description="计划日期(非必填)")
  237. products: Optional[list[PlanProductCreate]] = Field(default=None, description="产品明细列表")
  238. supplier_contracts: Optional[list[PlanContractLink]] = Field(
  239. default=None, alias="supplierContracts", description="供方合同列表"
  240. )
  241. demander_contracts: Optional[list[PlanContractLink]] = Field(
  242. default=None, alias="demanderContracts", description="需方合同列表"
  243. )
  244. load: Optional[PlanLoadBody] = Field(default=None, description="装货段")
  245. deliveries: Optional[list[PlanDeliveryBody]] = Field(default=None, description="送货段列表")
  246. model_config = {"populate_by_name": True}
  247. class PlanTransportCreateBlock(BaseModel):
  248. vehicle_id: str = Field(..., alias="vehicleId", description="车辆ID")
  249. driver_id: Optional[str] = Field(default=None, alias="driverId", description="司机/人员ID")
  250. carrier_id: Optional[str] = Field(default=None, alias="carrierId", description="承运商ID")
  251. distance_km: Optional[Decimal] = Field(default=None, alias="distanceKm", description="运输公里数")
  252. freight_type: str = Field(default="by_weight", alias="freightType", description="运费计算方式")
  253. transport_qty: Optional[Decimal] = Field(default=None, alias="transportQty", description="运输量")
  254. freight_price: Optional[Decimal] = Field(default=None, alias="freightPrice", description="运输单价")
  255. freight_amount: Optional[Decimal] = Field(default=None, alias="freightAmount", description="运费金额")
  256. has_invoice: Optional[int] = Field(default=None, alias="hasInvoice", description="是否开票(已废弃,由运费结算维护)")
  257. remark: Optional[str] = None
  258. model_config = {"populate_by_name": True}
  259. class PlanUpdate(BaseModel):
  260. create_date: Optional[date] = Field(default=None, alias="createDate")
  261. plan_date: Optional[date] = Field(default=None, alias="planDate")
  262. belongs_company: Optional[str] = Field(default=None, alias="belongsCompany")
  263. plan_type: Optional[str] = Field(default=None, alias="planType")
  264. follow_status: Optional[str] = Field(default=None, alias="followStatus")
  265. transport_status: Optional[str] = Field(default=None, alias="transportStatus")
  266. supplier_id: Optional[str] = Field(default=None, alias="supplierId")
  267. supplier_name: Optional[str] = Field(default=None, max_length=200, alias="supplierName")
  268. destination_id: Optional[str] = Field(default=None, alias="destinationId")
  269. destination_name: Optional[str] = Field(default=None, max_length=200, alias="destinationName")
  270. customer_id: Optional[str] = Field(default=None, alias="customerId")
  271. customer_name: Optional[str] = Field(default=None, max_length=200, alias="customerName")
  272. contact_name: Optional[str] = Field(default=None, max_length=100, alias="contactName")
  273. contact_phone: Optional[str] = Field(default=None, max_length=32, alias="contactPhone")
  274. party_a: Optional[str] = Field(default=None, max_length=200, alias="partyA")
  275. party_b: Optional[str] = Field(default=None, max_length=200, alias="partyB")
  276. contract_start_date: Optional[date] = Field(default=None, alias="contractStartDate")
  277. contract_end_date: Optional[date] = Field(default=None, alias="contractEndDate")
  278. delivery_method: Optional[str] = Field(default=None, alias="deliveryMethod")
  279. settlement_method: Optional[str] = Field(default=None, max_length=50, alias="settlementMethod")
  280. has_freight: Optional[int] = Field(default=None, alias="hasFreight")
  281. freight_remark: Optional[str] = Field(default=None, max_length=512, alias="freightRemark")
  282. pickup_address: Optional[str] = Field(default=None, max_length=500, alias="pickupAddress")
  283. pickup_lng: Optional[Decimal] = Field(default=None, alias="pickupLng")
  284. pickup_lat: Optional[Decimal] = Field(default=None, alias="pickupLat")
  285. pickup_time: OptionalPlanDateTime = Field(default=None, alias="pickupTime")
  286. pickup_contact: Optional[str] = Field(default=None, max_length=200, alias="pickupContact")
  287. pickup_notes: Optional[str] = Field(default=None, max_length=500, alias="pickupNotes")
  288. destination_address: Optional[str] = Field(default=None, max_length=500, alias="destinationAddress")
  289. destination_lng: Optional[Decimal] = Field(default=None, alias="destinationLng")
  290. destination_lat: Optional[Decimal] = Field(default=None, alias="destinationLat")
  291. delivery_time: OptionalPlanDateTime = Field(default=None, alias="deliveryTime")
  292. delivery_contact: Optional[str] = Field(default=None, max_length=200, alias="deliveryContact")
  293. destination_notes: Optional[str] = Field(default=None, max_length=500, alias="destinationNotes")
  294. notify_message: Optional[str] = Field(default=None, alias="notifyMessage")
  295. follow_user_id: Optional[str] = Field(default=None, alias="followUserId")
  296. follow_user_name: Optional[str] = Field(default=None, alias="followUserName")
  297. remark: Optional[str] = None
  298. products: Optional[list[PlanProductCreate]] = None
  299. supplier_contracts: Optional[list[PlanContractLink]] = Field(
  300. default=None, alias="supplierContracts", description="供方合同列表"
  301. )
  302. demander_contracts: Optional[list[PlanContractLink]] = Field(
  303. default=None, alias="demanderContracts", description="需方合同列表"
  304. )
  305. transport: Optional[PlanTransportCreateBlock] = Field(default=None, description="运输预选/更新(有车牌时同步车辆与运费)")
  306. load: Optional[PlanLoadBody] = Field(default=None, description="装货段")
  307. deliveries: Optional[list[PlanDeliveryBody]] = Field(default=None, description="送货段列表")
  308. save_mode: Optional[str] = Field(
  309. default="formal",
  310. alias="saveMode",
  311. description="保存模式 draft=暂存 formal=正式(默认)",
  312. )
  313. model_config = {"populate_by_name": True}
  314. class HazardCertReadyBody(BaseModel):
  315. ready: bool = Field(..., description="true=确认证书齐备 false=取消齐备")
  316. model_config = {"populate_by_name": True}
  317. class ErpEnteredBody(BaseModel):
  318. entered: bool = Field(..., description="true=已录入ERP false=未录入")
  319. model_config = {"populate_by_name": True}
  320. class PlanDocumentAttachmentItem(BaseModel):
  321. url: str = Field(..., description="附件URL")
  322. label: str = Field(..., description="来源标签,如司机/现场")
  323. model_config = {"populate_by_name": True}
  324. class PlanRead(PlanBase, PlanResourceSnapshotMixin):
  325. id: str
  326. plan_no: str = Field(alias="planNo")
  327. create_date: date = Field(alias="createDate")
  328. plan_date: Optional[date] = Field(default=None, alias="planDate")
  329. hazard_cert_ready: int = Field(default=0, alias="hazardCertReady", description="危化品证书是否已人工确认齐备")
  330. hazard_cert_ready_by: Optional[str] = Field(default=None, alias="hazardCertReadyBy", description="危化品证书确认人")
  331. hazard_cert_ready_time: Optional[datetime] = Field(default=None, alias="hazardCertReadyTime", description="危化品证书确认时间")
  332. erp_entered: int = Field(default=0, alias="erpEntered", description="是否已录入ERP 0-否 1-是")
  333. vehicle_id: Optional[str] = Field(default=None, alias="vehicleId")
  334. license_plate: Optional[str] = Field(default=None, alias="licensePlate")
  335. driver_id: Optional[str] = Field(default=None, alias="driverId")
  336. driver_name: Optional[str] = Field(default=None, alias="driverName")
  337. personnel_summary: Optional[str] = Field(default=None, alias="personnelSummary")
  338. transport_id: Optional[str] = Field(default=None, alias="transportId")
  339. transport_no: Optional[str] = Field(default=None, alias="transportNo")
  340. total_amount: Decimal = Field(alias="totalAmount")
  341. freight_amount: Decimal = Field(alias="freightAmount")
  342. tenant_no: str = Field(alias="tenantNo")
  343. order_num: Optional[int] = Field(default=None, alias="orderNum")
  344. create_by: Optional[str] = Field(default=None, alias="createBy")
  345. create_dept_id: Optional[str] = Field(default=None, alias="createDeptId")
  346. create_time: datetime = Field(alias="createTime")
  347. update_by: Optional[str] = Field(default=None, alias="updateBy")
  348. update_time: datetime = Field(alias="updateTime")
  349. del_flag: int = Field(default=0, alias="delFlag")
  350. supplier_contracts: list[PlanContractLink] = Field(
  351. default_factory=list, alias="supplierContracts", description="供方合同列表"
  352. )
  353. demander_contracts: list[PlanContractLink] = Field(
  354. default_factory=list, alias="demanderContracts", description="需方合同列表"
  355. )
  356. model_config = {"from_attributes": True, "populate_by_name": True}
  357. class PlanWithProducts(PlanRead):
  358. products: list[PlanProductRead] = []
  359. load: Optional[PlanLoadRead] = Field(default=None, description="装货段")
  360. deliveries: list[PlanDeliveryRead] = Field(default_factory=list, description="送货段列表")
  361. load_customer_name: Optional[str] = Field(
  362. default=None,
  363. alias="loadCustomerName",
  364. description="装货客户名称摘要(列表展示)",
  365. )
  366. delivery_customer_summary: Optional[str] = Field(
  367. default=None,
  368. alias="deliveryCustomerSummary",
  369. description="送货客户摘要(列表展示)",
  370. )
  371. warnings: list[str] = Field(default_factory=list, description="保存告警(如数量不平衡)")
  372. can_copy_to_driver: bool = Field(
  373. default=False,
  374. alias="canCopyToDriver",
  375. description="列表/查看:是否可「复制给司机」(已安排且有司机链接或现场/地磅关联)",
  376. )
  377. can_copy_to_site: bool = Field(
  378. default=False,
  379. alias="canCopyToSite",
  380. description="是否可「复制给现场」",
  381. )
  382. can_copy_pound_qrcode: bool = Field(
  383. default=False,
  384. alias="canCopyPoundQrcode",
  385. description="是否可「复制磅单二维码」",
  386. )
  387. document_attachments: list[PlanDocumentAttachmentItem] = Field(
  388. default_factory=list,
  389. alias="documentAttachments",
  390. description="单据附件(司机/现场/出入库现场等)",
  391. )
  392. # =============================================================================
  393. # 送(提)货单打印(按送货客户聚合)
  394. # =============================================================================
  395. class DeliveryPrintCustomerOption(BaseModel):
  396. customer_id: str = Field(alias="customerId", description="送货客户ID或名称键")
  397. customer_name: str = Field(alias="customerName", description="送货客户名称")
  398. delivery_count: int = Field(default=1, alias="deliveryCount", description="送货段数量")
  399. model_config = {"populate_by_name": True}
  400. class DeliverySlipPrintRead(BaseModel):
  401. plan_id: str = Field(alias="planId")
  402. plan_no: str = Field(alias="planNo")
  403. plan_date: Optional[str] = Field(default=None, alias="planDate")
  404. customer_id: Optional[str] = Field(default=None, alias="customerId")
  405. receiving_unit: Optional[str] = Field(default=None, alias="receivingUnit")
  406. receive_contact: Optional[str] = Field(default=None, alias="receiveContact")
  407. delivery_address: Optional[str] = Field(default=None, alias="deliveryAddress")
  408. products: list[PlanStopProductRead] = Field(default_factory=list)
  409. customers: list[DeliveryPrintCustomerOption] = Field(default_factory=list)
  410. model_config = {"populate_by_name": True}
  411. class PlanInboundSlipTemplateSave(BaseModel):
  412. slip_template_content: str = Field(..., alias="slipTemplateContent", description="入库单打印模板HTML")
  413. model_config = {"populate_by_name": True}
  414. class PlanDeliverySlipTemplateSave(BaseModel):
  415. delivery_slip_template_content: str = Field(
  416. ..., alias="slipTemplateContent", description="送(提)货单打印模板HTML"
  417. )
  418. model_config = {"populate_by_name": True}
  419. class PlanSubpackSlipTemplateSave(BaseModel):
  420. subpack_slip_template_content: str = Field(
  421. ..., alias="slipTemplateContent", description="分装单打印模板HTML"
  422. )
  423. model_config = {"populate_by_name": True}
  424. # =============================================================================
  425. # 从合同创建计划
  426. # =============================================================================
  427. class CreateFromContractRequest(BaseModel):
  428. contract_id: str = Field(..., alias="contractId", description="CRM合同ID")
  429. create_date: Optional[date] = Field(
  430. default=None, alias="createDate", description="创建日期;缺省当天"
  431. )
  432. plan_date: Optional[date] = Field(default=None, alias="planDate", description="计划日期(非必填)")
  433. follow_user_id: Optional[str] = Field(default=None, alias="followUserId", description="跟进人ID")
  434. follow_user_name: Optional[str] = Field(default=None, max_length=100, alias="followUserName", description="跟进人姓名")
  435. model_config = {"populate_by_name": True}
  436. class PlanCreateFull(PlanCreate):
  437. contract_id: Optional[str] = Field(default=None, alias="contractId", description="旧字段:单一合同ID,已废弃为唯一源")
  438. transport: Optional[PlanTransportCreateBlock] = Field(default=None, description="运输安排(有车牌时创建运输)")
  439. save_mode: Optional[str] = Field(
  440. default="formal",
  441. alias="saveMode",
  442. description="保存模式 draft=暂存 formal=正式(默认)",
  443. )
  444. model_config = {"populate_by_name": True}
  445. # =============================================================================
  446. # 计划列表查询
  447. # =============================================================================
  448. class PlanListQuery(BaseModel):
  449. q: Optional[str] = Field(default=None, description="模糊搜索计划号/客户名称/产品名称/车牌号")
  450. plan_no: Optional[str] = Field(default=None, alias="planNo", description="计划编号")
  451. plan_type: Optional[str] = Field(default=None, alias="planType", description="单据类型")
  452. follow_status: Optional[str] = Field(default=None, alias="followStatus", description="跟进状态")
  453. transport_status: Optional[str] = Field(default=None, alias="transportStatus", description="运输状态")
  454. archive_status: Optional[str] = Field(default=None, alias="archiveStatus", description="归档状态")
  455. customer_name: Optional[str] = Field(default=None, alias="customerName", description="客户名称")
  456. product_name: Optional[str] = Field(default=None, alias="productName", description="产品名称")
  457. license_plate: Optional[str] = Field(default=None, alias="licensePlate", description="车牌号")
  458. plan_date_from: Optional[date] = Field(default=None, alias="planDateFrom", description="计划日期开始")
  459. plan_date_to: Optional[date] = Field(default=None, alias="planDateTo", description="计划日期结束")
  460. has_hazard_product: Optional[int] = Field(
  461. default=None, alias="hasHazardProduct", description="1=仅含易制毒/易制爆产品的计划"
  462. )
  463. cert_upload_status: Optional[str] = Field(
  464. default=None,
  465. alias="certUploadStatus",
  466. description="incomplete=至少一张必需危化证书未上传",
  467. )
  468. page: int = Field(default=1, ge=1, description="页码")
  469. page_size: int = Field(default=20, ge=1, le=500, alias="pageSize", description="每页数量")
  470. model_config = {"populate_by_name": True}
  471. class PlanProductCertItem(BaseModel):
  472. id: str = Field(..., description="计划产品明细ID")
  473. purchase_cert_url: Optional[str] = Field(default=None, alias="purchaseCertUrl", description="购买证URL,逗号分隔")
  474. transport_cert_url: Optional[str] = Field(default=None, alias="transportCertUrl", description="运输证URL,逗号分隔")
  475. legal_use_cert_url: Optional[str] = Field(default=None, alias="legalUseCertUrl", description="合法使用证明URL,逗号分隔")
  476. model_config = {"populate_by_name": True}
  477. class PlanProductCertsUpdate(BaseModel):
  478. products: list[PlanProductCertItem] = Field(..., description="危化品证书更新列表")
  479. model_config = {"populate_by_name": True}
  480. class PlanArchiveProductItem(BaseModel):
  481. id: str = Field(..., description="计划产品明细ID pl_plan_product.id")
  482. actual_qty: Optional[Decimal] = Field(default=None, alias="actualQty", ge=0, description="实际数量")
  483. inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", ge=0, description="入库数量")
  484. inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", ge=0, description="入库价")
  485. outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", ge=0, description="出库数量")
  486. outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", ge=0, description="出库价")
  487. brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(default=None, alias="brandQtys")
  488. model_config = {"populate_by_name": True}
  489. class PlanArchiveStopProductItem(BaseModel):
  490. id: str = Field(..., description="段产品行ID(pl_plan_load_product / pl_plan_delivery_product)")
  491. inbound_qty: Optional[Decimal] = Field(default=None, alias="inboundQty", ge=0, description="入库数量(装货段)")
  492. inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", ge=0, description="入库单价(装货段)")
  493. outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", ge=0, description="出库数量(送货段)")
  494. outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", ge=0, description="出库单价(送货段)")
  495. brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(
  496. default=None, alias="brandQtys", description="本段归档品牌数量(与归档弹窗填写一致)"
  497. )
  498. model_config = {"populate_by_name": True}
  499. class PlanArchiveLoadBlock(BaseModel):
  500. stop_id: str = Field(alias="stopId", description="装货段ID")
  501. products: list[PlanArchiveStopProductItem] = Field(default_factory=list)
  502. model_config = {"populate_by_name": True}
  503. class PlanArchiveDeliveryBlock(BaseModel):
  504. stop_id: str = Field(alias="stopId", description="送货段ID")
  505. products: list[PlanArchiveStopProductItem] = Field(default_factory=list)
  506. model_config = {"populate_by_name": True}
  507. class PlanArchiveFreightBlock(BaseModel):
  508. has_freight: int = Field(default=1, alias="hasFreight", description="是否有运输费用 0-否 1-是")
  509. freight_remark: Optional[str] = Field(default=None, max_length=512, alias="freightRemark", description="运费备注")
  510. distance_km: Optional[Decimal] = Field(default=None, alias="distanceKm")
  511. freight_type: str = Field(default="by_weight", alias="freightType")
  512. freight_price: Optional[Decimal] = Field(default=None, alias="freightPrice")
  513. freight_amount: Optional[Decimal] = Field(default=None, alias="freightAmount")
  514. transport_qty: Optional[Decimal] = Field(default=None, alias="transportQty")
  515. has_invoice: Optional[int] = Field(default=None, alias="hasInvoice")
  516. model_config = {"populate_by_name": True}
  517. class PlanArchiveStopFeedbackAttachmentItem(BaseModel):
  518. stop_type: str = Field(alias="stopType", description="停靠段类型 load/delivery")
  519. stop_id: str = Field(alias="stopId", description="停靠段ID")
  520. attachment_urls: list[str] = Field(default_factory=list, alias="attachmentUrls", description="附件URLs")
  521. model_config = {"populate_by_name": True}
  522. class PlanArchiveFeedbacksBlock(BaseModel):
  523. driver_stops: list[PlanArchiveStopFeedbackAttachmentItem] = Field(
  524. default_factory=list, alias="driverStops", description="司机按段回传附件"
  525. )
  526. site_stops: list[PlanArchiveStopFeedbackAttachmentItem] = Field(
  527. default_factory=list, alias="siteStops", description="现场按段回传附件"
  528. )
  529. model_config = {"populate_by_name": True}
  530. class PlanArchiveBody(BaseModel):
  531. products: list[PlanArchiveProductItem] = Field(default_factory=list)
  532. load: Optional[PlanArchiveLoadBlock] = None
  533. deliveries: Optional[list[PlanArchiveDeliveryBlock]] = None
  534. freight: Optional[PlanArchiveFreightBlock] = None
  535. feedbacks: Optional[PlanArchiveFeedbacksBlock] = None
  536. model_config = {"populate_by_name": True}
  537. class PlanDriverFeedbackProductItem(BaseModel):
  538. plan_product_id: str = Field(alias="planProductId")
  539. actual_qty: Decimal = Field(alias="actualQty", ge=0)
  540. brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(default=None, alias="brandQtys")
  541. model_config = {"populate_by_name": True}
  542. class PlanDriverFeedbackUpdateBody(BaseModel):
  543. feedback_remark: Optional[str] = Field(default=None, alias="feedbackRemark", max_length=500, description="回传备注")
  544. feedback_images: Optional[list[str]] = Field(default=None, alias="feedbackImages", description="回传附件URLs")
  545. feedback_time: OptionalPlanDateTime = Field(default=None, alias="feedbackTime", description="回传时间")
  546. products: Optional[list[PlanDriverFeedbackProductItem]] = None
  547. feedback_qty: Optional[Decimal] = Field(default=None, alias="feedbackQty", ge=0, description="回传数量")
  548. model_config = {"populate_by_name": True}
  549. class PlanSiteFeedbackUpdateBody(BaseModel):
  550. site_feedback_remark: Optional[str] = Field(
  551. default=None, alias="siteFeedbackRemark", max_length=500, description="现场回执备注"
  552. )
  553. site_feedback_images: Optional[list[str]] = Field(
  554. default=None, alias="siteFeedbackImages", description="现场回执附件URLs"
  555. )
  556. site_feedback_time: OptionalPlanDateTime = Field(
  557. default=None, alias="siteFeedbackTime", description="现场回执保存时间"
  558. )
  559. model_config = {"populate_by_name": True}
  560. class PlanListResponse(BaseModel):
  561. total: int
  562. list: list[PlanWithProducts]
  563. class PlanForceFollowStatusBody(BaseModel):
  564. """运维纠错:强制改跟进状态(仅改字段,不联动业务)。"""
  565. follow_status: str = Field(
  566. ...,
  567. alias="followStatus",
  568. description="跟进状态 drafting/wait_notice/pending_arrange/arranged/completed/cancelled",
  569. )
  570. model_config = {"populate_by_name": True}
  571. class PlanSideContractsUpdateBody(BaseModel):
  572. contracts: list[PlanContractLink] = Field(default_factory=list)
  573. model_config = {"populate_by_name": True}
  574. class PlanStopContractsUpdateBody(BaseModel):
  575. stop_type: str = Field(..., alias="stopType", description="load | delivery")
  576. stop_id: str = Field(..., alias="stopId", description="装货/送货段ID")
  577. contracts: list[PlanContractLink] = Field(default_factory=list)
  578. model_config = {"populate_by_name": True}
  579. class PlanContractGapRead(BaseModel):
  580. id: str
  581. plan_no: str = Field(..., alias="planNo")
  582. plan_date: Optional[date] = Field(None, alias="planDate")
  583. plan_type: Optional[str] = Field(None, alias="planType")
  584. follow_status: str = Field(..., alias="followStatus")
  585. supplier_id: Optional[str] = Field(None, alias="supplierId")
  586. supplier_name: Optional[str] = Field(None, alias="supplierName")
  587. customer_id: Optional[str] = Field(None, alias="customerId")
  588. customer_name: Optional[str] = Field(None, alias="customerName")
  589. gap_sides: list[str] = Field(default_factory=list, alias="gapSides")
  590. supplier_contract_exempt: bool = Field(..., alias="supplierContractExempt")
  591. demander_contract_exempt: bool = Field(..., alias="demanderContractExempt")
  592. supplier_contracts: list[PlanContractLink] = Field(default_factory=list, alias="supplierContracts")
  593. demander_contracts: list[PlanContractLink] = Field(default_factory=list, alias="demanderContracts")
  594. products: list[PlanProductRead] = Field(default_factory=list, description="产品明细")
  595. load: Optional["PlanLoadRead"] = Field(default=None, description="装货段")
  596. deliveries: list["PlanDeliveryRead"] = Field(default_factory=list, alias="deliveries", description="送货段列表")
  597. model_config = {"populate_by_name": True, "from_attributes": True}
  598. class PlanContractGapListResponse(BaseModel):
  599. total: int
  600. list: list[PlanContractGapRead]