pl_dibang_bridge_service.py 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504
  1. """运输计划安排时联动地磅计划与出入库单。"""
  2. from __future__ import annotations
  3. import calendar
  4. import re
  5. from dataclasses import dataclass
  6. from datetime import date, datetime
  7. from decimal import Decimal
  8. from typing import Optional
  9. from sqlalchemy.orm import Session
  10. from app.core.utils import generate_uuid
  11. from app.models.db_models import DbInboundOutbound, DbPurchasePlan, DbWeighingSlip
  12. from app.models.pl_models import PlPlan, PlPlanProduct, PlTransport, PlTransportDbLink
  13. from app.services.db.inventory_id import next_inbound_outbound_id
  14. from app.services.db.mappers import parse_date_str
  15. from app.services.db.plan_helpers import default_execution_status, generate_plan_no
  16. from app.services.db.product_helpers import (
  17. apply_product_snapshot_to_inventory,
  18. apply_product_snapshot_to_plan,
  19. resolve_crm_product,
  20. )
  21. @dataclass
  22. class DibangInventoryLinkResult:
  23. plan_product_id: str
  24. product_name: str
  25. db_purchase_plan_id: str
  26. db_inventory_id: str
  27. batch_no: str
  28. plan_no: str
  29. def resolve_partner_company(plan: PlPlan, plan_type: str) -> str:
  30. """按运输计划单据类型解析地磅往来单位(不区分 CRM 合同类型)。
  31. - 入库单 inbound:供方 → party_a,其次 supplier_name
  32. - 出库单 outbound:需方 → party_b,其次 customer_name
  33. """
  34. if plan_type == "inbound":
  35. return (plan.party_a or plan.supplier_name or "").strip()
  36. if plan_type == "outbound":
  37. return (plan.party_b or plan.customer_name or "").strip()
  38. return ""
  39. def _normalize_to_date(value: date | datetime | str | None) -> Optional[date]:
  40. if value is None:
  41. return None
  42. if isinstance(value, datetime):
  43. return value.date()
  44. if isinstance(value, date):
  45. return value
  46. if isinstance(value, str):
  47. return parse_date_str(value)
  48. return None
  49. def _normalize_plan_date(plan: PlPlan) -> date:
  50. plan_date = plan.plan_date
  51. if isinstance(plan_date, datetime):
  52. return plan_date.date()
  53. if isinstance(plan_date, date):
  54. return plan_date
  55. if isinstance(plan_date, str):
  56. parsed = parse_date_str(plan_date)
  57. return parsed or date.today()
  58. return date.today()
  59. def _resolve_dibang_date(plan: PlPlan) -> date:
  60. """入库单用送达时间,出库单用取货时间;缺失时回退计划日期。"""
  61. if plan.plan_type == "inbound":
  62. resolved = _normalize_to_date(plan.delivery_time)
  63. elif plan.plan_type == "outbound":
  64. resolved = _normalize_to_date(plan.pickup_time)
  65. else:
  66. resolved = None
  67. return resolved or _normalize_plan_date(plan)
  68. def _month_range(plan_date: date) -> tuple[date, date]:
  69. month_start = plan_date.replace(day=1)
  70. last_day = calendar.monthrange(plan_date.year, plan_date.month)[1]
  71. month_end = plan_date.replace(day=last_day)
  72. return month_start, month_end
  73. def _plan_type_to_business_type(plan_type: str) -> Optional[str]:
  74. if plan_type == "inbound":
  75. return "入库"
  76. if plan_type == "outbound":
  77. return "出库"
  78. return None
  79. def _product_quantity(product: PlPlanProduct) -> float:
  80. for value in (product.quantity, product.inbound_estimate_qty, product.outbound_estimate_qty):
  81. if value is not None:
  82. return float(value)
  83. return 0.0
  84. def _apply_plan_quantity_delta(
  85. db_plan: DbPurchasePlan,
  86. delta: float,
  87. *,
  88. user_id: Optional[str],
  89. ) -> None:
  90. current = float(db_plan.planned_quantity or 0)
  91. db_plan.planned_quantity = max(0.0, current + float(delta))
  92. db_plan.update_by = user_id
  93. def _resolve_link_contributed_qty(
  94. link: PlTransportDbLink,
  95. inventory: Optional[DbInboundOutbound],
  96. ) -> float:
  97. if link.contributed_qty is not None:
  98. return float(link.contributed_qty)
  99. if inventory and inventory.quantity is not None:
  100. return float(inventory.quantity)
  101. return 0.0
  102. def _subtract_plan_contribution(
  103. db: Session,
  104. *,
  105. tenant_no: str,
  106. link: PlTransportDbLink,
  107. inventory: Optional[DbInboundOutbound],
  108. user_id: Optional[str],
  109. ) -> None:
  110. if not link.db_purchase_plan_id:
  111. return
  112. db_plan = (
  113. db.query(DbPurchasePlan)
  114. .filter(
  115. DbPurchasePlan.id == link.db_purchase_plan_id,
  116. DbPurchasePlan.tenant_no == tenant_no,
  117. DbPurchasePlan.del_flag == 0,
  118. )
  119. .first()
  120. )
  121. if not db_plan:
  122. return
  123. qty = _resolve_link_contributed_qty(link, inventory)
  124. if qty:
  125. _apply_plan_quantity_delta(db_plan, -qty, user_id=user_id)
  126. def _generate_batch_no(db: Session, tenant_no: str) -> str:
  127. rows = (
  128. db.query(DbInboundOutbound.batch_no)
  129. .filter(
  130. DbInboundOutbound.tenant_no == tenant_no,
  131. DbInboundOutbound.del_flag == 0,
  132. DbInboundOutbound.batch_no.like("CRKDH%"),
  133. )
  134. .all()
  135. )
  136. max_seq = 0
  137. pattern = re.compile(r"^CRKDH(\d+)$")
  138. for (batch_no,) in rows:
  139. if batch_no:
  140. match = pattern.match(batch_no)
  141. if match:
  142. max_seq = max(max_seq, int(match.group(1)))
  143. return f"CRKDH{max_seq + 1:07d}"
  144. def find_monthly_db_plan(
  145. db: Session,
  146. tenant_no: str,
  147. plan_date: date,
  148. business_type: str,
  149. customer_name: str,
  150. product_id: str,
  151. specification: Optional[str],
  152. ) -> Optional[DbPurchasePlan]:
  153. month_start, month_end = _month_range(plan_date)
  154. customer = (customer_name or "").strip()
  155. spec = (specification or "").strip()
  156. query = db.query(DbPurchasePlan).filter(
  157. DbPurchasePlan.tenant_no == tenant_no,
  158. DbPurchasePlan.del_flag == 0,
  159. DbPurchasePlan.business_type == business_type,
  160. DbPurchasePlan.product_id == product_id,
  161. DbPurchasePlan.start_date <= month_end,
  162. DbPurchasePlan.end_date >= month_start,
  163. )
  164. if customer:
  165. query = query.filter(DbPurchasePlan.customer_name == customer)
  166. if spec:
  167. query = query.filter(DbPurchasePlan.specification == spec)
  168. return query.order_by(DbPurchasePlan.create_time.desc()).first()
  169. def _create_db_plan(
  170. db: Session,
  171. tenant_no: str,
  172. plan: PlPlan,
  173. product: PlPlanProduct,
  174. business_type: str,
  175. customer_name: str,
  176. dibang_date: date,
  177. month_start: date,
  178. month_end: date,
  179. user_id: Optional[str],
  180. dept_id: str,
  181. contributed_qty: float,
  182. ) -> DbPurchasePlan:
  183. snapshot = resolve_crm_product(db, tenant_no, product.product_id, require_on_shelf=False)
  184. db_plan = DbPurchasePlan(
  185. id=generate_uuid(),
  186. tenant_no=tenant_no,
  187. plan_no=generate_plan_no(),
  188. plan_date=dibang_date,
  189. start_date=month_start,
  190. end_date=month_end,
  191. business_type=business_type,
  192. planned_quantity=contributed_qty,
  193. vehicle_no=(plan.license_plate or "").strip(),
  194. customer_name=customer_name or None,
  195. remark=f"来源运输计划 {plan.plan_no}",
  196. execution_status=default_execution_status(business_type),
  197. executed_at=None,
  198. last_weighing_slip_id=None,
  199. executed_quantity=0,
  200. auto_generate_enabled=0,
  201. auto_generate_end_month=None,
  202. auto_generate_last_month=None,
  203. create_by=user_id,
  204. create_dept_id=dept_id,
  205. )
  206. apply_product_snapshot_to_plan(db_plan, snapshot)
  207. db.add(db_plan)
  208. db.flush()
  209. return db_plan
  210. def _create_db_inventory(
  211. db: Session,
  212. tenant_no: str,
  213. plan: PlPlan,
  214. product: PlPlanProduct,
  215. db_plan: DbPurchasePlan,
  216. business_type: str,
  217. customer_name: str,
  218. license_plate: str,
  219. dibang_date: date,
  220. user_id: Optional[str],
  221. dept_id: str,
  222. ) -> DbInboundOutbound:
  223. snapshot = resolve_crm_product(db, tenant_no, product.product_id, require_on_shelf=False)
  224. status_value = "待入库" if business_type == "入库" else "待出库"
  225. inventory_plan_no = ((db_plan.plan_no if db_plan else plan.plan_no) or "").strip() or None
  226. remark = f"运输计划 {plan.plan_no}"
  227. purchase_plan_id = db_plan.id if db_plan else None
  228. inventory = DbInboundOutbound(
  229. id=next_inbound_outbound_id(db, tenant_no),
  230. tenant_no=tenant_no,
  231. date=dibang_date,
  232. partner_company=customer_name,
  233. business_type=business_type,
  234. quantity=Decimal(str(_product_quantity(product))),
  235. plan_no=inventory_plan_no,
  236. batch_no=_generate_batch_no(db, tenant_no),
  237. vehicle_no=(license_plate or "").strip(),
  238. status=status_value,
  239. remark=remark,
  240. purchase_plan_id=purchase_plan_id,
  241. create_by=user_id,
  242. create_dept_id=dept_id,
  243. )
  244. apply_product_snapshot_to_inventory(inventory, snapshot)
  245. db.add(inventory)
  246. db.flush()
  247. return inventory
  248. # 仅这些状态的出入库单可在「再次安排+勾地磅」时软删后重建
  249. _REVOKABLE_INVENTORY_STATUSES = frozenset({"待入库", "待出库", "待三方填写", "待处理"})
  250. def _inventory_has_weighing_slip(db: Session, inventory_id: str) -> bool:
  251. return (
  252. db.query(DbWeighingSlip.id)
  253. .filter(
  254. DbWeighingSlip.inbound_outbound_id == inventory_id,
  255. DbWeighingSlip.del_flag == 0,
  256. DbWeighingSlip.is_voided == 0,
  257. )
  258. .first()
  259. is not None
  260. )
  261. def revoke_regeneratable_dibang_for_transport(
  262. db: Session,
  263. *,
  264. tenant_no: str,
  265. transport_id: str,
  266. user_id: Optional[str],
  267. ) -> None:
  268. """再次勾选地磅安排前:软删本运输单此前生成的、仍可作废的出入库单及关联。
  269. - 不删除地磅月计划(可能被其他业务复用)
  270. - 若出入库单已完成的/已有关联磅单 → 阻断并提示人工处理
  271. """
  272. links = (
  273. db.query(PlTransportDbLink)
  274. .filter(
  275. PlTransportDbLink.tenant_no == tenant_no,
  276. PlTransportDbLink.transport_id == transport_id,
  277. PlTransportDbLink.del_flag == 0,
  278. )
  279. .all()
  280. )
  281. if not links:
  282. return
  283. blocking: list[str] = []
  284. for link in links:
  285. inventory = (
  286. db.query(DbInboundOutbound)
  287. .filter(
  288. DbInboundOutbound.id == link.db_inventory_id,
  289. DbInboundOutbound.tenant_no == tenant_no,
  290. DbInboundOutbound.del_flag == 0,
  291. )
  292. .first()
  293. )
  294. if not inventory:
  295. link.del_flag = 1
  296. link.update_by = user_id
  297. continue
  298. label = inventory.batch_no or inventory.id
  299. status = (inventory.status or "").strip()
  300. if status and status not in _REVOKABLE_INVENTORY_STATUSES:
  301. blocking.append(f"{label}(状态:{status})")
  302. continue
  303. if _inventory_has_weighing_slip(db, inventory.id):
  304. blocking.append(f"{label}(已关联地磅单)")
  305. if blocking:
  306. raise ValueError(
  307. "以下出入库单已执行或已关联地磅,无法随运输安排自动重建:"
  308. + ";".join(blocking)
  309. + "。请在地磅管理中处理后再安排。"
  310. )
  311. for link in links:
  312. inventory = (
  313. db.query(DbInboundOutbound)
  314. .filter(
  315. DbInboundOutbound.id == link.db_inventory_id,
  316. DbInboundOutbound.tenant_no == tenant_no,
  317. DbInboundOutbound.del_flag == 0,
  318. )
  319. .first()
  320. )
  321. if inventory:
  322. _subtract_plan_contribution(
  323. db,
  324. tenant_no=tenant_no,
  325. link=link,
  326. inventory=inventory,
  327. user_id=user_id,
  328. )
  329. inventory.del_flag = 1
  330. inventory.update_by = user_id
  331. link.del_flag = 1
  332. link.update_by = user_id
  333. db.flush()
  334. def _sync_transport_inventory_links(
  335. db: Session,
  336. *,
  337. tenant_no: str,
  338. plan: PlPlan,
  339. products: list[PlPlanProduct],
  340. transport: PlTransport,
  341. user_id: Optional[str],
  342. dept_id: str,
  343. ) -> list[DibangInventoryLinkResult]:
  344. business_type = _plan_type_to_business_type(plan.plan_type)
  345. if not business_type:
  346. return []
  347. partner = resolve_partner_company(plan, plan.plan_type)
  348. if not partner:
  349. raise ValueError("无法解析往来单位,请检查合同供方/需方信息")
  350. dibang_date = _resolve_dibang_date(plan)
  351. month_start, month_end = _month_range(dibang_date)
  352. license_plate = (transport.license_plate or plan.license_plate or "").strip()
  353. results: list[DibangInventoryLinkResult] = []
  354. for product in products:
  355. if not product.product_id:
  356. raise ValueError(f"产品【{product.product_name}】未关联 CRM 产品,无法生成地磅出入库单")
  357. contributed_qty = _product_quantity(product)
  358. db_plan = find_monthly_db_plan(
  359. db,
  360. tenant_no,
  361. dibang_date,
  362. business_type,
  363. partner,
  364. product.product_id,
  365. product.model,
  366. )
  367. if not db_plan:
  368. db_plan = _create_db_plan(
  369. db,
  370. tenant_no,
  371. plan,
  372. product,
  373. business_type,
  374. partner,
  375. dibang_date,
  376. month_start,
  377. month_end,
  378. user_id,
  379. dept_id,
  380. contributed_qty,
  381. )
  382. else:
  383. _apply_plan_quantity_delta(db_plan, contributed_qty, user_id=user_id)
  384. inventory = _create_db_inventory(
  385. db,
  386. tenant_no,
  387. plan,
  388. product,
  389. db_plan,
  390. business_type,
  391. partner,
  392. license_plate,
  393. dibang_date,
  394. user_id,
  395. dept_id,
  396. )
  397. link = PlTransportDbLink(
  398. id=generate_uuid(),
  399. tenant_no=tenant_no,
  400. transport_id=transport.id,
  401. plan_id=plan.id,
  402. plan_product_id=product.id,
  403. db_purchase_plan_id=db_plan.id if db_plan else "",
  404. db_inventory_id=inventory.id,
  405. contributed_qty=Decimal(str(contributed_qty)),
  406. remark=f"运输计划 {plan.plan_no}",
  407. create_by=user_id,
  408. create_dept_id=dept_id,
  409. )
  410. db.add(link)
  411. results.append(
  412. DibangInventoryLinkResult(
  413. plan_product_id=product.id,
  414. product_name=product.product_name or "",
  415. db_purchase_plan_id=db_plan.id if db_plan else "",
  416. db_inventory_id=inventory.id,
  417. batch_no=inventory.batch_no or "",
  418. plan_no=(db_plan.plan_no if db_plan else plan.plan_no) or "",
  419. )
  420. )
  421. return results
  422. def sync_dibang_for_transport(
  423. db: Session,
  424. *,
  425. tenant_no: str,
  426. plan: PlPlan,
  427. products: list[PlPlanProduct],
  428. transport: PlTransport,
  429. user_id: Optional[str],
  430. dept_id: str,
  431. ) -> list[DibangInventoryLinkResult]:
  432. """勾选「生成地磅单」:按产品生成/复用地磅计划,并创建关联出入库单。"""
  433. return _sync_transport_inventory_links(
  434. db,
  435. tenant_no=tenant_no,
  436. plan=plan,
  437. products=products,
  438. transport=transport,
  439. user_id=user_id,
  440. dept_id=dept_id,
  441. )