transport.py 30 KB

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