vehicle_maintenance.py 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343
  1. """车辆维保 API"""
  2. from datetime import date
  3. from datetime import datetime
  4. from typing import List, Optional
  5. from pydantic import BaseModel, Field
  6. from fastapi import APIRouter, Depends, HTTPException, Query, status
  7. from sqlalchemy.orm import Session
  8. from app.core.database import get_db
  9. from app.core.db_auth import DbUserContext, get_db_current_user
  10. from app.core.tenant_context import get_tenant_no
  11. from app.utils.excel_export import (
  12. EXPORT_MAX_ROWS,
  13. ExportColumn,
  14. ExportValidationError,
  15. export_rows_to_xlsx_response,
  16. filter_export_columns,
  17. )
  18. from app.schemas.pl.vehicle_maintenance import (
  19. VehicleMaintenanceApplyCreate,
  20. VehicleMaintenanceApplyListResponse,
  21. VehicleMaintenanceApplyRead,
  22. VehicleMaintenanceApplyReminder,
  23. VehicleMaintenanceApplyUpdate,
  24. VehicleMaintenanceProcessBoardListResponse,
  25. VehicleMaintenanceProcessCreate,
  26. VehicleMaintenanceProcessRead,
  27. VehicleMaintenanceProcessUpdate,
  28. )
  29. from app.services import pl_vehicle_maintenance_service as svc
  30. apply_router = APIRouter(prefix="/vehicle-maintenance-apply", tags=["运输计划-车辆维保申请"])
  31. process_router = APIRouter(prefix="/vehicle-maintenance-process", tags=["运输计划-车辆维保处理"])
  32. @apply_router.get("/", response_model=VehicleMaintenanceApplyListResponse)
  33. def list_applies(
  34. q: Optional[str] = Query(default=None),
  35. maintenance_type: Optional[str] = Query(default=None, alias="maintenanceType"),
  36. status: Optional[str] = Query(default=None),
  37. apply_date_from: Optional[date] = Query(default=None, alias="applyDateFrom"),
  38. apply_date_to: Optional[date] = Query(default=None, alias="applyDateTo"),
  39. applicant_id: Optional[str] = Query(default=None, alias="applicantId"),
  40. page: int = Query(default=1, ge=1),
  41. page_size: int = Query(default=20, ge=1, le=500, alias="pageSize"),
  42. db: Session = Depends(get_db),
  43. user: DbUserContext = Depends(get_db_current_user),
  44. ) -> VehicleMaintenanceApplyListResponse:
  45. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  46. items, total = svc.list_applies(
  47. db,
  48. tenant_no,
  49. user,
  50. q=q,
  51. maintenance_type=maintenance_type,
  52. status=status,
  53. apply_date_from=apply_date_from,
  54. apply_date_to=apply_date_to,
  55. applicant_id=applicant_id,
  56. page=page,
  57. page_size=page_size,
  58. )
  59. return VehicleMaintenanceApplyListResponse(
  60. items=items, total=total, page=page, pageSize=page_size
  61. )
  62. @apply_router.get("/reminders", response_model=list[VehicleMaintenanceApplyReminder])
  63. def list_reminders(
  64. license_plate: str = Query(..., alias="licensePlate"),
  65. exclude_apply_id: Optional[str] = Query(default=None, alias="excludeApplyId"),
  66. db: Session = Depends(get_db),
  67. user: DbUserContext = Depends(get_db_current_user),
  68. ) -> list[VehicleMaintenanceApplyReminder]:
  69. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  70. return svc.list_reminders(
  71. db,
  72. tenant_no,
  73. user,
  74. license_plate,
  75. exclude_apply_id=exclude_apply_id,
  76. )
  77. MAINT_APPLY_EXPORT_COLUMNS = [
  78. ExportColumn(title="申请单号", field="applyNo"),
  79. ExportColumn(title="车牌号", field="licensePlate"),
  80. ExportColumn(title="维保类型", field="maintenanceType"),
  81. ExportColumn(title="申请日期", field="applyDate"),
  82. ExportColumn(title="开始日期", field="startDate"),
  83. ExportColumn(title="预计取车", field="expectedPickupDate"),
  84. ExportColumn(title="申请人", field="applicantName"),
  85. ExportColumn(title="状态", field="status"),
  86. ExportColumn(title="创建时间", field="createTime"),
  87. ]
  88. class MaintenanceApplyExportBody(BaseModel):
  89. q: Optional[str] = None
  90. maintenance_type: Optional[str] = Field(default=None, alias="maintenanceType")
  91. status: Optional[str] = None
  92. apply_date_from: Optional[date] = Field(default=None, alias="applyDateFrom")
  93. apply_date_to: Optional[date] = Field(default=None, alias="applyDateTo")
  94. ids: Optional[List[str]] = None
  95. columns: Optional[List[str]] = None
  96. model_config = {"populate_by_name": True}
  97. @apply_router.post("/export")
  98. def export_applies(
  99. body: MaintenanceApplyExportBody,
  100. db: Session = Depends(get_db),
  101. user: DbUserContext = Depends(get_db_current_user),
  102. ):
  103. """导出维保申请列表(当前筛选全量,或 ids 已选)。"""
  104. try:
  105. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  106. items, _ = svc.list_applies(
  107. db,
  108. tenant_no,
  109. user,
  110. q=body.q,
  111. maintenance_type=body.maintenance_type,
  112. status=body.status,
  113. apply_date_from=body.apply_date_from,
  114. apply_date_to=body.apply_date_to,
  115. ids=body.ids,
  116. page=1,
  117. page_size=EXPORT_MAX_ROWS,
  118. max_page_size=EXPORT_MAX_ROWS,
  119. )
  120. rows = []
  121. for item in items:
  122. data = item.model_dump(by_alias=True)
  123. for k in ("applyDate", "startDate", "expectedPickupDate", "createTime"):
  124. if data.get(k) is not None:
  125. data[k] = str(data[k])[:19]
  126. rows.append(data)
  127. cols = filter_export_columns(MAINT_APPLY_EXPORT_COLUMNS, body.columns)
  128. date_str = datetime.now().strftime("%Y%m%d")
  129. return export_rows_to_xlsx_response(
  130. db,
  131. tenant_no=tenant_no,
  132. sheet_title="维保申请",
  133. columns=cols,
  134. rows=rows,
  135. filename_stem=f"维保申请_{date_str}",
  136. )
  137. except ExportValidationError as e:
  138. raise HTTPException(status_code=400, detail=str(e)) from e
  139. @apply_router.get("/{id}", response_model=VehicleMaintenanceApplyRead)
  140. def get_apply(
  141. id: str,
  142. db: Session = Depends(get_db),
  143. user: DbUserContext = Depends(get_db_current_user),
  144. ) -> VehicleMaintenanceApplyRead:
  145. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  146. return svc.get_apply(db, tenant_no, user, id)
  147. @apply_router.post("/", response_model=VehicleMaintenanceApplyRead, status_code=status.HTTP_201_CREATED)
  148. def create_apply(
  149. payload: VehicleMaintenanceApplyCreate,
  150. db: Session = Depends(get_db),
  151. user: DbUserContext = Depends(get_db_current_user),
  152. ) -> VehicleMaintenanceApplyRead:
  153. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  154. return svc.create_apply(db, tenant_no, user, payload)
  155. @apply_router.put("/{id}", response_model=VehicleMaintenanceApplyRead)
  156. def update_apply(
  157. id: str,
  158. payload: VehicleMaintenanceApplyUpdate,
  159. db: Session = Depends(get_db),
  160. user: DbUserContext = Depends(get_db_current_user),
  161. ) -> VehicleMaintenanceApplyRead:
  162. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  163. return svc.update_apply(db, tenant_no, user, id, payload)
  164. @apply_router.post("/{id}/cancel", response_model=VehicleMaintenanceApplyRead)
  165. def cancel_apply(
  166. id: str,
  167. db: Session = Depends(get_db),
  168. user: DbUserContext = Depends(get_db_current_user),
  169. ) -> VehicleMaintenanceApplyRead:
  170. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  171. return svc.cancel_apply(db, tenant_no, user, id)
  172. @apply_router.delete("/{ids}", status_code=status.HTTP_204_NO_CONTENT)
  173. def delete_applies(
  174. ids: str,
  175. db: Session = Depends(get_db),
  176. user: DbUserContext = Depends(get_db_current_user),
  177. ) -> None:
  178. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  179. apply_ids = [item for item in ids.split(",") if item]
  180. svc.delete_applies(db, tenant_no, user, apply_ids)
  181. @process_router.get("/process-board", response_model=VehicleMaintenanceProcessBoardListResponse)
  182. def list_process_board(
  183. q: Optional[str] = Query(default=None),
  184. maintenance_type: Optional[str] = Query(default=None, alias="maintenanceType"),
  185. apply_status: Optional[str] = Query(default=None, alias="applyStatus"),
  186. apply_date_from: Optional[date] = Query(default=None, alias="applyDateFrom"),
  187. apply_date_to: Optional[date] = Query(default=None, alias="applyDateTo"),
  188. process_date_from: Optional[date] = Query(default=None, alias="processDateFrom"),
  189. process_date_to: Optional[date] = Query(default=None, alias="processDateTo"),
  190. page: int = Query(default=1, ge=1),
  191. page_size: int = Query(default=20, ge=1, le=500, alias="pageSize"),
  192. db: Session = Depends(get_db),
  193. user: DbUserContext = Depends(get_db_current_user),
  194. ) -> VehicleMaintenanceProcessBoardListResponse:
  195. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  196. items, total = svc.list_process_board(
  197. db,
  198. tenant_no,
  199. user,
  200. q=q,
  201. maintenance_type=maintenance_type,
  202. apply_status=apply_status,
  203. apply_date_from=apply_date_from,
  204. apply_date_to=apply_date_to,
  205. process_date_from=process_date_from,
  206. process_date_to=process_date_to,
  207. page=page,
  208. page_size=page_size,
  209. )
  210. return VehicleMaintenanceProcessBoardListResponse(
  211. items=items, total=total, page=page, pageSize=page_size
  212. )
  213. MAINT_PROCESS_EXPORT_COLUMNS = [
  214. ExportColumn(title="申请单号", field="applyNo"),
  215. ExportColumn(title="申请日期", field="applyDate"),
  216. ExportColumn(title="申请人", field="applicantName"),
  217. ExportColumn(title="申请状态", field="applyStatus"),
  218. ExportColumn(title="车牌号", field="licensePlate"),
  219. ExportColumn(title="维保类型", field="maintenanceType"),
  220. ExportColumn(title="处理单号", field="processNo"),
  221. ExportColumn(title="处理日期", field="processDate"),
  222. ExportColumn(title="处理人", field="handlerName"),
  223. ExportColumn(title="金额(元)", field="amount"),
  224. ]
  225. class MaintProcessExportBody(BaseModel):
  226. q: Optional[str] = None
  227. maintenance_type: Optional[str] = Field(default=None, alias="maintenanceType")
  228. apply_status: Optional[str] = Field(default=None, alias="applyStatus")
  229. apply_date_from: Optional[date] = Field(default=None, alias="applyDateFrom")
  230. apply_date_to: Optional[date] = Field(default=None, alias="applyDateTo")
  231. process_date_from: Optional[date] = Field(default=None, alias="processDateFrom")
  232. process_date_to: Optional[date] = Field(default=None, alias="processDateTo")
  233. ids: Optional[List[str]] = None
  234. columns: Optional[List[str]] = None
  235. model_config = {"populate_by_name": True}
  236. @process_router.post("/process-board/export")
  237. def export_process_board(
  238. body: MaintProcessExportBody,
  239. db: Session = Depends(get_db),
  240. user: DbUserContext = Depends(get_db_current_user),
  241. ):
  242. try:
  243. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  244. items, _ = svc.list_process_board(
  245. db, tenant_no, user,
  246. q=body.q, maintenance_type=body.maintenance_type, apply_status=body.apply_status,
  247. apply_date_from=body.apply_date_from, apply_date_to=body.apply_date_to,
  248. process_date_from=body.process_date_from, process_date_to=body.process_date_to,
  249. ids=body.ids, page=1, page_size=EXPORT_MAX_ROWS, max_page_size=EXPORT_MAX_ROWS,
  250. )
  251. rows = []
  252. for item in items:
  253. data = item.model_dump(by_alias=True)
  254. for k, v in list(data.items()):
  255. if hasattr(v, 'isoformat'):
  256. data[k] = str(v)[:19]
  257. rows.append(data)
  258. cols = filter_export_columns(MAINT_PROCESS_EXPORT_COLUMNS, body.columns)
  259. date_str = datetime.now().strftime("%Y%m%d")
  260. return export_rows_to_xlsx_response(
  261. db, tenant_no=tenant_no, sheet_title="维保过程", columns=cols, rows=rows,
  262. filename_stem=f"维保过程_{date_str}",
  263. )
  264. except ExportValidationError as e:
  265. raise HTTPException(status_code=400, detail=str(e)) from e
  266. @process_router.get("/{id}", response_model=VehicleMaintenanceProcessRead)
  267. def get_process(
  268. id: str,
  269. db: Session = Depends(get_db),
  270. user: DbUserContext = Depends(get_db_current_user),
  271. ) -> VehicleMaintenanceProcessRead:
  272. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  273. return svc.get_process(db, tenant_no, user, id)
  274. @process_router.post("/", response_model=VehicleMaintenanceProcessRead, status_code=status.HTTP_201_CREATED)
  275. def create_process(
  276. payload: VehicleMaintenanceProcessCreate,
  277. db: Session = Depends(get_db),
  278. user: DbUserContext = Depends(get_db_current_user),
  279. ) -> VehicleMaintenanceProcessRead:
  280. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  281. return svc.create_process(db, tenant_no, user, payload)
  282. @process_router.put("/{id}", response_model=VehicleMaintenanceProcessRead)
  283. def update_process(
  284. id: str,
  285. payload: VehicleMaintenanceProcessUpdate,
  286. db: Session = Depends(get_db),
  287. user: DbUserContext = Depends(get_db_current_user),
  288. ) -> VehicleMaintenanceProcessRead:
  289. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  290. return svc.update_process(db, tenant_no, user, id, payload)
  291. @process_router.delete("/{ids}", status_code=status.HTTP_204_NO_CONTENT)
  292. def delete_processes(
  293. ids: str,
  294. db: Session = Depends(get_db),
  295. user: DbUserContext = Depends(get_db_current_user),
  296. ) -> None:
  297. tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
  298. process_ids = [item for item in ids.split(",") if item]
  299. svc.delete_processes(db, tenant_no, user, process_ids)