transport.py 32 KB

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