transport.py 35 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025
  1. """运输计划管理 - 运输 API"""
  2. from datetime import date, datetime
  3. from typing import Optional
  4. import json
  5. import secrets
  6. from fastapi import APIRouter, Depends, HTTPException, Query, status
  7. from pydantic import BaseModel, Field
  8. from sqlalchemy import func, or_
  9. from sqlalchemy.orm import Session
  10. from app.core.database import get_db
  11. from app.core.db_auth import DbUserContext, get_db_current_user
  12. from app.services.pl_data_scope import apply_pl_scope, assert_pl_row_in_scope
  13. from app.core.tenant_context import get_tenant_no
  14. from app.core.utils import generate_uuid
  15. from app.core.config import settings
  16. from app.models.pl_models import (
  17. PlCarrier,
  18. PlDriver,
  19. PlPersonnel,
  20. PlPlan,
  21. PlPlanProduct,
  22. PlPlanTransport,
  23. PlTransport,
  24. PlTransportApproval,
  25. PlTransportDbLink,
  26. PlVehicle,
  27. )
  28. from app.schemas.pl.transport import (
  29. ApprovalRecordRead,
  30. ApprovalRequest,
  31. ApprovalSubmit,
  32. TransportArrange,
  33. TransportArrangeResult,
  34. TransportCreate,
  35. TransportFeedback,
  36. TransportInventoryLinkRead,
  37. TransportIoOrderBrief,
  38. TransportSiteLinkRead,
  39. TransportListQuery,
  40. TransportListResponse,
  41. TransportDriverProductFeedbackRead,
  42. TransportRead,
  43. )
  44. from app.services.pl_dibang_bridge_service import (
  45. revoke_regeneratable_dibang_for_transport,
  46. sync_dibang_for_transport,
  47. )
  48. from app.services.pl_inventory_link_read import build_transport_inventory_link_read
  49. from app.services.pl_io_order_service import (
  50. apply_dibang_prefill_to_order,
  51. create_io_order_for_transport,
  52. void_io_orders_for_plan,
  53. )
  54. from app.services.pl_plan_service import (
  55. is_ton_product_unit,
  56. validate_hazard_cert_ready_for_transport,
  57. )
  58. from app.services.pl_transport_resource_snapshot_service import (
  59. apply_resource_snapshot_json,
  60. build_transport_resource_snapshot,
  61. )
  62. from app.services.pl_carrier_service import assert_carrier_eligible_for_transport
  63. from app.services.pl_feedback_brand_qty import load_transport_driver_product_feedbacks
  64. router = APIRouter(prefix="/order", tags=["运输计划-运输管理"])
  65. def _transport_to_read(db: Session, transport: PlTransport) -> TransportRead:
  66. base = TransportRead.model_validate(transport)
  67. feedbacks = load_transport_driver_product_feedbacks(
  68. db,
  69. tenant_no=transport.tenant_no,
  70. transport_id=transport.id,
  71. )
  72. if not feedbacks:
  73. return base
  74. return base.model_copy(
  75. update={
  76. "driver_product_feedbacks": [
  77. TransportDriverProductFeedbackRead.model_validate(item)
  78. for item in feedbacks
  79. ]
  80. }
  81. )
  82. def _generate_transport_no(db: Session) -> str:
  83. """生成运输编号 SXYS######"""
  84. now = date.today()
  85. prefix = f"SXYS{now.strftime('%Y%m')}"
  86. last = (
  87. db.query(PlTransport)
  88. .filter(
  89. PlTransport.transport_no.like(f"{prefix}%"),
  90. PlTransport.del_flag == 0,
  91. )
  92. .order_by(PlTransport.transport_no.desc())
  93. .first()
  94. )
  95. if last:
  96. last_seq = int(last.transport_no[-6:])
  97. seq = last_seq + 1
  98. else:
  99. seq = 1
  100. return f"{prefix}{seq:06d}"
  101. def _resolve_driver_info(db: Session, tenant_no: str, driver_id: Optional[str]) -> Optional[dict]:
  102. """解析司机信息:优先 pl_personnel,兼容旧 pl_driver。"""
  103. if not driver_id:
  104. return None
  105. personnel = (
  106. db.query(PlPersonnel)
  107. .filter(
  108. PlPersonnel.id == driver_id,
  109. PlPersonnel.tenant_no == tenant_no,
  110. PlPersonnel.del_flag == 0,
  111. )
  112. .first()
  113. )
  114. if personnel:
  115. return {
  116. "id": personnel.id,
  117. "name": personnel.personnel_name,
  118. "phone": personnel.phone_no,
  119. }
  120. legacy = (
  121. db.query(PlDriver)
  122. .filter(
  123. PlDriver.id == driver_id,
  124. PlDriver.tenant_no == tenant_no,
  125. PlDriver.del_flag == 0,
  126. )
  127. .first()
  128. )
  129. if legacy:
  130. return {
  131. "id": legacy.id,
  132. "name": legacy.driver_name,
  133. "phone": legacy.phone_no,
  134. }
  135. return None
  136. def _get_vehicle_info(db: Session, vehicle_id: str, tenant_no: Optional[str] = None) -> dict:
  137. vehicle = db.query(PlVehicle).filter(PlVehicle.id == vehicle_id).first()
  138. if not vehicle:
  139. return {}
  140. info = {
  141. "license_plate": vehicle.license_plate,
  142. "carrier_id": vehicle.carrier_id,
  143. "carrier_name": vehicle.carrier_name,
  144. }
  145. if vehicle.default_driver_id:
  146. driver_info = (
  147. _resolve_driver_info(db, tenant_no, vehicle.default_driver_id)
  148. if tenant_no
  149. else None
  150. )
  151. if not driver_info:
  152. personnel = db.query(PlPersonnel).filter(
  153. PlPersonnel.id == vehicle.default_driver_id,
  154. PlPersonnel.del_flag == 0,
  155. ).first()
  156. if personnel:
  157. driver_info = {
  158. "id": personnel.id,
  159. "name": personnel.personnel_name,
  160. "phone": personnel.phone_no,
  161. }
  162. else:
  163. legacy = db.query(PlDriver).filter(
  164. PlDriver.id == vehicle.default_driver_id,
  165. PlDriver.del_flag == 0,
  166. ).first()
  167. if legacy:
  168. driver_info = {
  169. "id": legacy.id,
  170. "name": legacy.driver_name,
  171. "phone": legacy.phone_no,
  172. }
  173. if driver_info:
  174. info["driver_id"] = driver_info["id"]
  175. info["driver_name"] = driver_info["name"]
  176. info["driver_phone"] = driver_info["phone"]
  177. elif vehicle.default_driver_name:
  178. info["driver_id"] = vehicle.default_driver_id
  179. info["driver_name"] = vehicle.default_driver_name
  180. return info
  181. def _assert_vehicle_carrier_eligible(
  182. db: Session,
  183. tenant_no: str,
  184. vehicle_id: str,
  185. *,
  186. rearrange: bool = False,
  187. ) -> None:
  188. vehicle = (
  189. db.query(PlVehicle)
  190. .filter(
  191. PlVehicle.id == vehicle_id,
  192. PlVehicle.tenant_no == tenant_no,
  193. PlVehicle.del_flag == 0,
  194. )
  195. .first()
  196. )
  197. if not vehicle:
  198. raise HTTPException(status_code=400, detail="车辆不存在")
  199. if not vehicle.carrier_id:
  200. return
  201. carrier = (
  202. db.query(PlCarrier)
  203. .filter(
  204. PlCarrier.id == vehicle.carrier_id,
  205. PlCarrier.tenant_no == tenant_no,
  206. PlCarrier.del_flag == 0,
  207. )
  208. .first()
  209. )
  210. if not carrier:
  211. raise HTTPException(status_code=400, detail="承运商不存在")
  212. assert_carrier_eligible_for_transport(carrier, rearrange=rearrange)
  213. def _ensure_driver_access_token(transport: PlTransport) -> str:
  214. token = (transport.driver_access_token or "").strip()
  215. if not token:
  216. token = secrets.token_urlsafe(32)[:64]
  217. transport.driver_access_token = token
  218. return token
  219. def _rotate_driver_access_token(transport: PlTransport) -> str:
  220. token = secrets.token_urlsafe(32)[:64]
  221. transport.driver_access_token = token
  222. return token
  223. def _is_rearrange(plan: PlPlan, existing_transport: Optional[PlTransport]) -> bool:
  224. """仅计划已正式安排才算「调整运输」。
  225. 创建/编辑表单预选车辆会留下 draft 运输单,计划仍为 pending;
  226. 若把非 cancelled 运输单都当成 rearrange,会把首次正式安排误判为调整。
  227. existing_transport 保留入参以兼容调用方;草稿复用由后续分支处理。
  228. """
  229. _ = existing_transport
  230. return plan.transport_status == "arranged"
  231. def _transport_has_db_links(db: Session, tenant_no: str, transport_id: str) -> bool:
  232. return (
  233. db.query(PlTransportDbLink.id)
  234. .filter(
  235. PlTransportDbLink.tenant_no == tenant_no,
  236. PlTransportDbLink.transport_id == transport_id,
  237. PlTransportDbLink.del_flag == 0,
  238. )
  239. .first()
  240. is not None
  241. )
  242. def _apply_plan_logistics_from_payload(plan: PlPlan, payload: TransportArrange) -> None:
  243. if payload.pickup_address is not None:
  244. plan.pickup_address = payload.pickup_address
  245. elif payload.start_point is not None:
  246. plan.pickup_address = payload.start_point
  247. if "pickup_lng" in payload.model_fields_set or "pickup_lat" in payload.model_fields_set:
  248. plan.pickup_lng = payload.pickup_lng
  249. plan.pickup_lat = payload.pickup_lat
  250. if payload.pickup_time is not None:
  251. plan.pickup_time = payload.pickup_time
  252. if payload.pickup_contact is not None:
  253. plan.pickup_contact = payload.pickup_contact
  254. if payload.pickup_notes is not None:
  255. plan.pickup_notes = payload.pickup_notes
  256. if payload.destination_address is not None:
  257. plan.destination_address = payload.destination_address
  258. elif payload.end_point is not None:
  259. plan.destination_address = payload.end_point
  260. if "destination_lng" in payload.model_fields_set or "destination_lat" in payload.model_fields_set:
  261. plan.destination_lng = payload.destination_lng
  262. plan.destination_lat = payload.destination_lat
  263. if payload.delivery_time is not None:
  264. plan.delivery_time = payload.delivery_time
  265. if payload.delivery_contact is not None:
  266. plan.delivery_contact = payload.delivery_contact
  267. if payload.destination_notes is not None:
  268. plan.destination_notes = payload.destination_notes
  269. def _resolve_transport_endpoints(plan: PlPlan, payload: TransportArrange) -> tuple[Optional[str], Optional[str]]:
  270. start_point = (
  271. payload.pickup_address
  272. or payload.start_point
  273. or plan.pickup_address
  274. )
  275. end_point = (
  276. payload.destination_address
  277. or payload.end_point
  278. or plan.destination_address
  279. or plan.destination_name
  280. )
  281. return start_point, end_point
  282. def _apply_transport_arrange_fields(
  283. transport: PlTransport,
  284. *,
  285. payload: TransportArrange,
  286. vehicle_info: dict,
  287. driver_info: Optional[dict],
  288. carrier_name: Optional[str],
  289. start_point: Optional[str],
  290. end_point: Optional[str],
  291. freight_amount: Optional[float],
  292. user_id: str,
  293. ) -> None:
  294. transport.vehicle_id = payload.vehicle_id
  295. transport.license_plate = vehicle_info.get("license_plate")
  296. transport.driver_id = driver_info["id"] if driver_info else None
  297. transport.driver_name = driver_info["name"] if driver_info else None
  298. transport.driver_phone = driver_info["phone"] if driver_info else None
  299. transport.carrier_id = payload.carrier_id or vehicle_info.get("carrier_id")
  300. transport.carrier_name = carrier_name
  301. transport.transport_medium = payload.transport_medium
  302. transport.start_point = start_point
  303. transport.end_point = end_point
  304. transport.distance_km = payload.distance_km
  305. transport.unit = payload.unit or ("吨" if payload.freight_type == "by_weight" else "趟")
  306. transport.freight_price = payload.freight_price
  307. transport.freight_amount = freight_amount or 0
  308. transport.freight_type = payload.freight_type
  309. if payload.has_invoice is not None:
  310. transport.has_invoice = payload.has_invoice
  311. if payload.remark is not None:
  312. transport.remark = payload.remark
  313. transport.update_by = user_id
  314. def _build_driver_url(token: str) -> str:
  315. origin = (settings.PUBLIC_WEB_ORIGIN or "").rstrip("/")
  316. return f"{origin}/#/public/pl/transport/{token}"
  317. def _build_arrange_result(
  318. transport: PlTransport,
  319. site_records: list[TransportSiteLinkRead],
  320. inventory_records: list[TransportInventoryLinkRead],
  321. io_order: Optional[TransportIoOrderBrief] = None,
  322. ) -> TransportArrangeResult:
  323. token = transport.driver_access_token or ""
  324. result = TransportArrangeResult.model_validate(transport)
  325. result.driver_access_token = token
  326. result.driver_url = _build_driver_url(token) if token else None
  327. result.site_records = site_records
  328. result.inventory_records = inventory_records
  329. result.io_order = io_order
  330. return result
  331. # =============================================================================
  332. # 运输列表
  333. # =============================================================================
  334. @router.get("/", response_model=TransportListResponse)
  335. def list_transports(
  336. q: Optional[str] = Query(default=None, description="模糊搜索"),
  337. transport_no: Optional[str] = Query(default=None, alias="transportNo", description="运输编号"),
  338. transport_status: Optional[str] = Query(default=None, alias="transportStatus", description="运输状态"),
  339. approval_status: Optional[str] = Query(default=None, alias="approvalStatus", description="审批状态"),
  340. vehicle_id: Optional[str] = Query(default=None, alias="vehicleId", description="车辆ID"),
  341. driver_id: Optional[str] = Query(default=None, alias="driverId", description="司机ID"),
  342. page: int = Query(default=1, ge=1),
  343. page_size: int = Query(default=20, ge=1, le=100, alias="pageSize"),
  344. db: Session = Depends(get_db),
  345. user: DbUserContext = Depends(get_db_current_user),
  346. ) -> TransportListResponse:
  347. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  348. query = db.query(PlTransport).filter(
  349. PlTransport.tenant_no == tenant_no,
  350. PlTransport.del_flag == 0,
  351. )
  352. if q:
  353. query = query.filter(
  354. or_(
  355. PlTransport.transport_no.contains(q),
  356. PlTransport.license_plate.contains(q),
  357. PlTransport.driver_name.contains(q),
  358. )
  359. )
  360. if transport_no:
  361. query = query.filter(PlTransport.transport_no.contains(transport_no))
  362. if transport_status:
  363. query = query.filter(PlTransport.transport_status == transport_status)
  364. if approval_status:
  365. query = query.filter(PlTransport.approval_status == approval_status)
  366. if vehicle_id:
  367. query = query.filter(PlTransport.vehicle_id == vehicle_id)
  368. if driver_id:
  369. query = query.filter(PlTransport.driver_id == driver_id)
  370. query = apply_pl_scope(query, PlTransport, user, db, tenant_no)
  371. total = query.count()
  372. offset = (page - 1) * page_size
  373. transports = query.order_by(PlTransport.create_time.desc()).offset(offset).limit(page_size).all()
  374. return TransportListResponse(total=total, list=transports)
  375. # =============================================================================
  376. # 创建运输
  377. # =============================================================================
  378. @router.post("/", response_model=TransportRead, status_code=status.HTTP_201_CREATED)
  379. def create_transport(
  380. payload: TransportCreate,
  381. db: Session = Depends(get_db),
  382. user: DbUserContext = Depends(get_db_current_user),
  383. ) -> TransportRead:
  384. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  385. transport_no = _generate_transport_no(db)
  386. transport = PlTransport(
  387. id=generate_uuid(),
  388. tenant_no=tenant_no,
  389. transport_no=transport_no,
  390. vehicle_id=payload.vehicle_id,
  391. license_plate=payload.license_plate,
  392. driver_id=payload.driver_id,
  393. driver_name=payload.driver_name,
  394. driver_phone=payload.driver_phone,
  395. carrier_id=payload.carrier_id,
  396. carrier_name=payload.carrier_name,
  397. transport_medium=payload.transport_medium,
  398. start_point=payload.start_point,
  399. end_point=payload.end_point,
  400. distance_km=payload.distance_km,
  401. unit=payload.unit,
  402. freight_price=payload.freight_price,
  403. freight_amount=payload.freight_amount,
  404. freight_type=payload.freight_type,
  405. has_invoice=payload.has_invoice,
  406. qr_expire_date=payload.qr_expire_date,
  407. transport_status=payload.transport_status or "draft",
  408. approval_status=payload.approval_status or "none",
  409. remark=payload.remark,
  410. create_by=user.id,
  411. create_dept_id=user.dept_id,
  412. )
  413. db.add(transport)
  414. # 关联计划
  415. if payload.plan_ids:
  416. for pid in payload.plan_ids:
  417. pt = PlPlanTransport(
  418. id=generate_uuid(),
  419. tenant_no=tenant_no,
  420. plan_id=pid,
  421. transport_id=transport.id,
  422. create_by=user.id,
  423. create_dept_id=user.dept_id,
  424. )
  425. db.add(pt)
  426. # 更新计划关联的运输信息
  427. plan = db.query(PlPlan).filter(PlPlan.id == pid, PlPlan.del_flag == 0).first()
  428. if plan:
  429. assert_pl_row_in_scope(db, plan, PlPlan, user, tenant_no)
  430. plan.transport_id = transport.id
  431. plan.transport_no = transport_no
  432. plan.vehicle_id = transport.vehicle_id
  433. plan.license_plate = transport.license_plate
  434. plan.driver_id = transport.driver_id
  435. plan.driver_name = transport.driver_name
  436. if transport.vehicle_id:
  437. snapshot = build_transport_resource_snapshot(
  438. db,
  439. tenant_no,
  440. transport.vehicle_id,
  441. selected_driver_id=transport.driver_id,
  442. )
  443. apply_resource_snapshot_json(
  444. plan=plan, transport=transport, snapshot=snapshot
  445. )
  446. db.commit()
  447. db.refresh(transport)
  448. return transport
  449. # =============================================================================
  450. # 运输安排
  451. # =============================================================================
  452. @router.post("/arrange/{plan_id}", response_model=TransportArrangeResult, status_code=status.HTTP_201_CREATED)
  453. def arrange_transport(
  454. plan_id: str,
  455. payload: TransportArrange,
  456. db: Session = Depends(get_db),
  457. user: DbUserContext = Depends(get_db_current_user),
  458. ) -> TransportArrangeResult:
  459. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  460. # 获取计划
  461. plan = db.query(PlPlan).filter(
  462. PlPlan.id == plan_id,
  463. PlPlan.tenant_no == tenant_no,
  464. PlPlan.del_flag == 0,
  465. ).first()
  466. if not plan:
  467. raise HTTPException(status_code=404, detail="计划不存在")
  468. assert_pl_row_in_scope(db, plan, PlPlan, user, tenant_no)
  469. existing_transport = None
  470. if plan.transport_id:
  471. existing_transport = db.query(PlTransport).filter(
  472. PlTransport.id == plan.transport_id,
  473. PlTransport.tenant_no == tenant_no,
  474. PlTransport.del_flag == 0,
  475. ).first()
  476. is_rearrange = _is_rearrange(plan, existing_transport)
  477. if is_rearrange and existing_transport and existing_transport.vehicle_id:
  478. _assert_vehicle_carrier_eligible(
  479. db,
  480. tenant_no,
  481. existing_transport.vehicle_id,
  482. rearrange=True,
  483. )
  484. _assert_vehicle_carrier_eligible(db, tenant_no, payload.vehicle_id, rearrange=False)
  485. # 获取车辆信息
  486. vehicle_info = _get_vehicle_info(db, payload.vehicle_id, tenant_no)
  487. # 获取司机信息(可选;driverId 为人员 pl_personnel.id)
  488. driver_info = None
  489. if payload.driver_id:
  490. driver_info = _resolve_driver_info(db, tenant_no, payload.driver_id)
  491. if not driver_info:
  492. raise HTTPException(status_code=400, detail="司机不存在")
  493. # 检查产品属性(易制毒/易制爆需要证件,以 CRM 产品主数据为准)
  494. products = db.query(PlPlanProduct).filter(
  495. PlPlanProduct.plan_id == plan_id,
  496. PlPlanProduct.del_flag == 0,
  497. ).all()
  498. validate_hazard_cert_ready_for_transport(db, tenant_no, plan, products)
  499. # 计算运费
  500. freight_amount = payload.freight_amount
  501. if payload.freight_type == "by_weight" and payload.freight_price:
  502. total_qty = sum(
  503. float(p.quantity or p.inbound_estimate_qty or p.outbound_estimate_qty or 0)
  504. for p in products
  505. )
  506. freight_amount = total_qty * float(payload.freight_price)
  507. carrier_name = vehicle_info.get("carrier_name")
  508. if payload.carrier_id:
  509. carrier = db.query(PlCarrier).filter(PlCarrier.id == payload.carrier_id).first()
  510. if carrier:
  511. carrier_name = carrier.carrier_name
  512. _apply_plan_logistics_from_payload(plan, payload)
  513. start_point, end_point = _resolve_transport_endpoints(plan, payload)
  514. if (
  515. plan.plan_type in ("inbound", "outbound")
  516. and is_rearrange
  517. and existing_transport
  518. and _transport_has_db_links(db, tenant_no, existing_transport.id)
  519. ):
  520. try:
  521. revoke_regeneratable_dibang_for_transport(
  522. db,
  523. tenant_no=tenant_no,
  524. transport_id=existing_transport.id,
  525. user_id=user.id,
  526. )
  527. except ValueError as exc:
  528. raise HTTPException(status_code=400, detail=str(exc)) from exc
  529. if existing_transport and existing_transport.transport_status != "cancelled":
  530. transport = existing_transport
  531. _apply_transport_arrange_fields(
  532. transport,
  533. payload=payload,
  534. vehicle_info=vehicle_info,
  535. driver_info=driver_info,
  536. carrier_name=carrier_name,
  537. start_point=start_point,
  538. end_point=end_point,
  539. freight_amount=freight_amount,
  540. user_id=user.id,
  541. )
  542. transport_no = transport.transport_no
  543. else:
  544. transport_no = _generate_transport_no(db)
  545. transport = PlTransport(
  546. id=generate_uuid(),
  547. tenant_no=tenant_no,
  548. transport_no=transport_no,
  549. transport_status="draft",
  550. approval_status="none",
  551. create_by=user.id,
  552. create_dept_id=user.dept_id,
  553. )
  554. db.add(transport)
  555. _apply_transport_arrange_fields(
  556. transport,
  557. payload=payload,
  558. vehicle_info=vehicle_info,
  559. driver_info=driver_info,
  560. carrier_name=carrier_name,
  561. start_point=start_point,
  562. end_point=end_point,
  563. freight_amount=freight_amount,
  564. user_id=user.id,
  565. )
  566. pt = PlPlanTransport(
  567. id=generate_uuid(),
  568. tenant_no=tenant_no,
  569. plan_id=plan_id,
  570. transport_id=transport.id,
  571. create_by=user.id,
  572. create_dept_id=user.dept_id,
  573. )
  574. db.add(pt)
  575. plan.transport_id = transport.id
  576. plan.transport_no = transport_no
  577. plan.vehicle_id = transport.vehicle_id
  578. plan.license_plate = transport.license_plate
  579. plan.driver_id = transport.driver_id
  580. plan.driver_name = transport.driver_name
  581. if transport.vehicle_id:
  582. snapshot = build_transport_resource_snapshot(
  583. db,
  584. tenant_no,
  585. transport.vehicle_id,
  586. selected_driver_id=transport.driver_id,
  587. )
  588. apply_resource_snapshot_json(plan=plan, transport=transport, snapshot=snapshot)
  589. plan.transport_status = "arranged"
  590. plan.follow_status = "arranged"
  591. plan.freight_amount = freight_amount or 0
  592. plan.update_by = user.id
  593. if is_rearrange:
  594. _rotate_driver_access_token(transport)
  595. else:
  596. _ensure_driver_access_token(transport)
  597. site_records: list[TransportSiteLinkRead] = []
  598. inventory_records: list[TransportInventoryLinkRead] = []
  599. io_order_brief: Optional[TransportIoOrderBrief] = None
  600. if plan.plan_type in ("inbound", "outbound"):
  601. try:
  602. if is_rearrange:
  603. # 调整运输:先作废旧出入库单(现场链接随之失效),再重建
  604. void_io_orders_for_plan(
  605. db,
  606. tenant_no=tenant_no,
  607. plan_id=plan.id,
  608. user_id=user.id,
  609. )
  610. io_result = create_io_order_for_transport(
  611. db,
  612. tenant_no=tenant_no,
  613. plan=plan,
  614. products=products,
  615. transport=transport,
  616. user_id=user.id,
  617. dept_id=user.dept_id or "",
  618. after_dibang=False,
  619. )
  620. if io_result:
  621. io_order_brief = TransportIoOrderBrief(
  622. kind=io_result.kind,
  623. order_id=io_result.order_id,
  624. order_no=io_result.order_no,
  625. site_access_token=io_result.site_access_token,
  626. site_url=io_result.site_url,
  627. status="in_progress",
  628. )
  629. # 兼容旧前端:合成单条 siteRecords 供复制现场链接
  630. site_records = [
  631. TransportSiteLinkRead(
  632. plan_product_id="",
  633. product_name=io_result.order_no,
  634. site_link_id=io_result.order_id,
  635. plan_no=plan.plan_no or "",
  636. business_type="入库" if io_result.kind == "inbound" else "出库",
  637. site_access_token=io_result.site_access_token,
  638. site_url=io_result.site_url,
  639. )
  640. ]
  641. except ValueError as exc:
  642. db.rollback()
  643. raise HTTPException(status_code=400, detail=str(exc)) from exc
  644. if plan.plan_type in ("inbound", "outbound") and payload.generate_dibang_plan:
  645. non_ton_products = [
  646. prod.product_name or prod.product_no or "未知产品"
  647. for prod in products
  648. if not is_ton_product_unit(prod.unit)
  649. ]
  650. if non_ton_products:
  651. raise HTTPException(
  652. status_code=400,
  653. detail=f"产品【{non_ton_products[0]}】等单位非吨,不支持生成地磅单",
  654. )
  655. try:
  656. link_results = sync_dibang_for_transport(
  657. db,
  658. tenant_no=tenant_no,
  659. plan=plan,
  660. products=products,
  661. transport=transport,
  662. user_id=user.id,
  663. dept_id=user.dept_id,
  664. )
  665. inventory_records = [
  666. build_transport_inventory_link_read(
  667. db,
  668. plan_product_id=item.plan_product_id,
  669. product_name=item.product_name,
  670. db_purchase_plan_id=item.db_purchase_plan_id,
  671. db_inventory_id=item.db_inventory_id,
  672. batch_no=item.batch_no,
  673. plan_no=item.plan_no,
  674. )
  675. for item in link_results
  676. ]
  677. except ValueError as exc:
  678. db.rollback()
  679. raise HTTPException(status_code=400, detail=str(exc)) from exc
  680. apply_dibang_prefill_to_order(
  681. db, tenant_no=tenant_no, plan=plan, transport=transport
  682. )
  683. db.commit()
  684. db.refresh(transport)
  685. return _build_arrange_result(transport, site_records, inventory_records, io_order_brief)
  686. # =============================================================================
  687. # 获取运输详情
  688. # =============================================================================
  689. @router.get("/{id}", response_model=TransportRead)
  690. def get_transport(
  691. id: str,
  692. db: Session = Depends(get_db),
  693. user: DbUserContext = Depends(get_db_current_user),
  694. ) -> TransportRead:
  695. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  696. transport = _get_transport(db, tenant_no, id, user)
  697. return _transport_to_read(db, transport)
  698. # =============================================================================
  699. # 生成二维码
  700. # =============================================================================
  701. class QrCodeResponse(BaseModel):
  702. transport_id: str = Field(alias="transportId")
  703. transport_no: str = Field(alias="transportNo")
  704. qr_code: str = Field(alias="qrCode")
  705. expire_date: Optional[date] = Field(default=None, alias="expireDate")
  706. model_config = {"from_attributes": True, "populate_by_name": True}
  707. @router.get("/{id}/qrcode", response_model=QrCodeResponse)
  708. def generate_qrcode(
  709. id: str,
  710. expire_days: int = Query(default=30, ge=1, le=365, description="有效期天数"),
  711. db: Session = Depends(get_db),
  712. user: DbUserContext = Depends(get_db_current_user),
  713. ) -> QrCodeResponse:
  714. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  715. transport = _get_transport(db, tenant_no, id, user)
  716. from datetime import timedelta
  717. expire_date = date.today() + timedelta(days=expire_days)
  718. # 生成二维码内容(URL scheme)
  719. qr_content = f"/transport/scan/{transport.id}?code={transport.transport_no}"
  720. transport.qr_code = qr_content
  721. transport.qr_expire_date = expire_date
  722. db.commit()
  723. return QrCodeResponse(
  724. transport_id=transport.id,
  725. transport_no=transport.transport_no,
  726. qr_code=qr_content,
  727. expire_date=expire_date,
  728. )
  729. # =============================================================================
  730. # 司机扫码回传(无需登录)
  731. # =============================================================================
  732. @router.post("/scan/feedback")
  733. def transport_scan_feedback(
  734. payload: TransportFeedback,
  735. db: Session = Depends(get_db),
  736. ) -> dict:
  737. """司机扫码回传,无需登录"""
  738. transport = (
  739. db.query(PlTransport)
  740. .filter(
  741. PlTransport.transport_no == payload.transport_no,
  742. PlTransport.del_flag == 0,
  743. )
  744. .first()
  745. )
  746. if not transport:
  747. raise HTTPException(status_code=404, detail="运输单不存在")
  748. if payload.verify_code and payload.verify_code != transport.transport_no:
  749. raise HTTPException(status_code=400, detail="验证码错误")
  750. # 更新回传信息
  751. if payload.feedback_qty:
  752. transport.feedback_qty = payload.feedback_qty
  753. if payload.feedback_images:
  754. transport.feedback_images = json.dumps(payload.feedback_images)
  755. if payload.feedback_remark:
  756. transport.feedback_remark = payload.feedback_remark
  757. transport.feedback_time = datetime.now()
  758. db.commit()
  759. return {"success": True, "message": "回传成功"}
  760. # =============================================================================
  761. # 提交审批
  762. # =============================================================================
  763. @router.post("/{id}/submit-approval", response_model=TransportRead)
  764. def submit_approval(
  765. id: str,
  766. payload: ApprovalSubmit,
  767. db: Session = Depends(get_db),
  768. user: DbUserContext = Depends(get_db_current_user),
  769. ) -> TransportRead:
  770. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  771. transport = _get_transport(db, tenant_no, id, user)
  772. if transport.approval_status not in ("none", "rejected"):
  773. raise HTTPException(status_code=400, detail="当前状态不允许提交审批")
  774. # 创建审批记录
  775. for idx, approver_id in enumerate(payload.approver_ids):
  776. from app.models.models import SysUser
  777. approver = db.query(SysUser).filter(SysUser.id == approver_id).first()
  778. if not approver:
  779. raise HTTPException(status_code=400, detail=f"审批人不存在: {approver_id}")
  780. approval = PlTransportApproval(
  781. id=generate_uuid(),
  782. tenant_no=tenant_no,
  783. transport_id=id,
  784. approver_id=approver_id,
  785. approver_name=approver.nick_name,
  786. approval_order=idx + 1,
  787. status="pending",
  788. create_by=user.id,
  789. create_dept_id=user.dept_id,
  790. )
  791. db.add(approval)
  792. transport.approval_status = "pending"
  793. db.commit()
  794. db.refresh(transport)
  795. return transport
  796. # =============================================================================
  797. # 审批
  798. # =============================================================================
  799. @router.post("/approval/{id}", response_model=ApprovalRecordRead)
  800. def process_approval(
  801. id: str,
  802. payload: ApprovalRequest,
  803. db: Session = Depends(get_db),
  804. user: DbUserContext = Depends(get_db_current_user),
  805. ) -> ApprovalRecordRead:
  806. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  807. approval = (
  808. db.query(PlTransportApproval)
  809. .filter(
  810. PlTransportApproval.id == id,
  811. PlTransportApproval.tenant_no == tenant_no,
  812. PlTransportApproval.del_flag == 0,
  813. )
  814. .first()
  815. )
  816. if not approval:
  817. raise HTTPException(status_code=404, detail="审批记录不存在")
  818. if approval.status != "pending":
  819. raise HTTPException(status_code=400, detail="该审批已处理")
  820. # 更新审批状态
  821. from datetime import datetime
  822. approval.status = "approved" if payload.action == "approve" else "rejected"
  823. approval.comment = payload.comment
  824. approval.approval_time = datetime.now()
  825. # 更新运输审批状态
  826. transport = db.query(PlTransport).filter(PlTransport.id == approval.transport_id).first()
  827. if transport:
  828. if payload.action == "approve":
  829. # 检查是否所有审批人都通过了
  830. pending = (
  831. db.query(PlTransportApproval)
  832. .filter(
  833. PlTransportApproval.transport_id == approval.transport_id,
  834. PlTransportApproval.status == "pending",
  835. PlTransportApproval.del_flag == 0,
  836. )
  837. .count()
  838. )
  839. if pending == 0:
  840. transport.approval_status = "approved"
  841. transport.transport_status = "pending"
  842. else:
  843. transport.approval_status = "rejected"
  844. transport.transport_status = "draft"
  845. db.commit()
  846. db.refresh(approval)
  847. return approval
  848. # =============================================================================
  849. # 获取运输的审批记录
  850. # =============================================================================
  851. @router.get("/{id}/approvals", response_model=list[ApprovalRecordRead])
  852. def get_transport_approvals(
  853. id: str,
  854. db: Session = Depends(get_db),
  855. user: DbUserContext = Depends(get_db_current_user),
  856. ) -> list[ApprovalRecordRead]:
  857. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  858. approvals = (
  859. db.query(PlTransportApproval)
  860. .filter(
  861. PlTransportApproval.transport_id == id,
  862. PlTransportApproval.tenant_no == tenant_no,
  863. PlTransportApproval.del_flag == 0,
  864. )
  865. .order_by(PlTransportApproval.approval_order)
  866. .all()
  867. )
  868. return approvals
  869. # =============================================================================
  870. # 辅助函数
  871. # =============================================================================
  872. def _get_transport(db: Session, tenant_no: str, transport_id: str, user: DbUserContext) -> PlTransport:
  873. transport = (
  874. db.query(PlTransport)
  875. .filter(
  876. PlTransport.id == transport_id,
  877. PlTransport.tenant_no == tenant_no,
  878. PlTransport.del_flag == 0,
  879. )
  880. .first()
  881. )
  882. if not transport:
  883. raise HTTPException(status_code=404, detail="运输不存在")
  884. assert_pl_row_in_scope(db, transport, PlTransport, user, tenant_no)
  885. return transport