Files
shanxia2.0/docs/superpowers/plans/2026-06-29-vehicle-maintenance.md
T
2026-06-29 11:15:39 +08:00

57 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 车辆维保申请与处理登记 — 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/*`
---
## 实现顺序
1. SQL 迁移 → ORM → Schema → Service → API
2. 前端 API + pl-display → 申请页 → 处理页 → 路由
3. 联调选车提醒与 process-board
4. 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`。