2.1 KiB
2.1 KiB
车辆维保申请与处理登记 — Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development or superpowers:executing-plans.
Goal: 在运输管理下新增「车辆维保申请」「车辆维保处理登记」，复用 ETC/加油 架构，含选车维保提醒。
Architecture: pl_vehicle_maintenance_apply + pl_vehicle_maintenance_process；pl_vehicle_maintenance_service.py；两 Vue 页面 + process-board API。
Spec: docs/superpowers/specs/2026-06-29-vehicle-maintenance-design.md
OpenSpec: openspec/changes/vehicle-maintenance-management/
文件结构
| 文件 | 职责 |
|---|---|
docs/sql/migrations/2026-06-29-pl-vehicle-maintenance.sql |
DDL + 字典 + 菜单 |
backend/app/models/pl_models.py |
ORM |
backend/app/schemas/pl/vehicle_maintenance.py |
Pydantic |
backend/app/services/pl_vehicle_maintenance_service.py |
业务逻辑 |
backend/app/api/pl/vehicle_maintenance.py |
REST |
web-admin/src/views/pl/vehicle-maintenance-apply/index.vue |
申请页 |
web-admin/src/views/pl/vehicle-maintenance-process/index.vue |
处理页 |
web-admin/src/api/pl/index.ts |
前端 API |
web-admin/src/router/modules/pl.ts |
静态路由 |
API 前缀： /api/transport/vehicle-maintenance-apply/*、/api/transport/vehicle-maintenance-process/*
实现顺序
- SQL 迁移 → ORM → Schema → Service → API
- 前端 API + pl-display → 申请页 → 处理页 → 路由
- 联调选车提醒与 process-board
- graphify 更新
参考复制源： pl_vehicle_recharge_*、vehicle-recharge-apply、vehicle-recharge-record
关键差异对照 ETC
| 项 | ETC | 维保 |
|---|---|---|
| 申请状态 | pending/disbursed/cancelled | pending/processed/cancelled |
| 处理单号 | SXCL | SXWC |
| 金额 | 必填 | 可选 |
| 类型 | 固定枚举 | allow-create |
| 选车 | 无 | reminders API + 弹窗 |
| 车辆状态 | 无 | V1 不联动 |
详细任务勾选见 openspec/changes/vehicle-maintenance-management/tasks.md。