transport.py 34 KB

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