2026-07-31-pl-plan-follow-status-redesign.md 1.7 KB

运输计划跟进状态重构 Implementation Plan

For agentic workers: Implement task-by-task. Steps use checkbox syntax.

Goal: 将 pl_plan.follow_status 改为 wait_notice / pending_arrange / arranged / completed / cancelled,并补齐自动与手动流转。

Architecture: 后端在创建/安排/归档/作废路径写入跟进状态;新增 wait-notice / cancel-wait-notice 接口;前端标签与按钮对齐;SQL 迁移旧值。

Tech Stack: FastAPI + SQLAlchemy;Vue 3 + Element Plus;MySQL 迁移脚本。


Task 1: 后端常量与创建/删除/安排/归档

Files:

  • Modify: backend/app/models/pl_models.py(列注释/默认)
  • Modify: backend/app/schemas/pl/plan.py(默认值)
  • Modify: backend/app/api/pl/plan.py
  • Modify: backend/app/services/pl_plan_service.py(安排运输设 arranged)

  • [ ] 默认创建 pending_arrange;删除允许 pending_arrange/wait_notice;安排成功设 follow_status=arranged;忽略 PUT 中的 follow_status

  • [ ] 新增 wait-notice / cancel-wait-notice

Task 2: 前端展示与按钮

Files:

  • Modify: web-admin/src/utils/pl-display.ts
  • Modify: web-admin/src/api/pl/index.ts
  • Modify: web-admin/src/views/pl/plan/index.vue
  • Modify: web-admin/src/views/pl/plan-archive/index.vue(及 plan-cert 若有筛选)
  • Modify: 查看弹窗相关 composable/组件若有跟进状态文案

Task 3: 数据迁移

Files:

  • Create: docs/sql/20260731_pl_plan_follow_status_redesign.sql
  • Modify: docs/sql/shanxia2.0.sql 列注释/默认(若可定位)

Task 4: 校验

  • 相关 grep 无残留 draft/processing 作为跟进状态(CRM 除外)
  • ./scripts/update-graph.sh 增量更新