dingdanquanliucheng/开发细节/任务状态跟踪.md

15 KiB
Raw Blame History

任务状态跟踪

状态说明:

  • 已完成:真实功能已开发完成,具备可验证业务行为,不只是占位或演示数据。
  • 待完成:已完成骨架、页面、路由、演示数据或部分逻辑,但真实功能还没做完。
  • 未完成:尚未开始或仅有很少准备。

一、基础工程

任务 来源 验证方式 状态
建立任务状态跟踪机制 05-开发实施与部署准备清单 仓库存在本文件且持续更新 已完成
后端 FastAPI 基础工程初始化 05-开发实施与部署准备清单 backend 下存在可启动服务与 /health 已完成
前端目录骨架初始化 05-开发实施与部署准备清单 frontend 下存在各端目录 已完成
环境变量模板 05-开发实施与部署准备清单 backend/.env.example 存在 已完成

二、页面与前端

任务 来源 验证方式 状态
Vue WEB 业务员端页面骨架 01-页面级原型字段说明 已形成真实订单管理闭环:列表、筛选、建单、详情、提交、取消 已完成
Vue WEB 管理后台页面骨架 01-页面级原型字段说明 已形成真实审批闭环与履约调度闭环:审批中心、发厂确认、司机任务创建 已完成
微信管理层端页面骨架 01-页面级原型字段说明 已支持登录、待审批/待取消审批列表、审批详情、审批动作、待发厂概览、发厂确认、司机任务创建等真实数据流 已完成
微信司机端页面骨架 01-页面级原型字段说明 已支持登录、本人任务列表、任务详情、接单、揽货、送达和物流轨迹查看等真实数据流 已完成

三、后端接口

任务 来源 验证方式 状态
认证接口 02-API细化设计 已有路由、service、统一异常未接真实鉴权 待完成
订单接口 02-API细化设计 已支持真实建单、列表筛选、详情、提交、取消、发厂确认等主流程;其余延伸场景待补 待完成
审批接口 02-API细化设计 已支持真实订单审批、取消审批和审批日志写入;权限与更多角色场景待补 待完成
客户接口 02-API细化设计 已有接口与 service客户列表、创建、详情已接入真实数据库优先链路导入仅完成最小落库样例尚未按文件内容做真实解析导入 待完成
产品与分类接口 02-API细化设计 已有接口与 service产品分类列表/新增/更新、产品列表/详情已接入真实数据库优先链路,基础资料页已形成真实联调闭环 待完成
供应商接口 02-API细化设计 已有接口与 service供应商列表、创建已接入真实数据库优先链路前端详情展示仍为演示态补充不计入真实接口完成度 待完成
司机任务接口 02-API细化设计 已支持真实任务创建、列表、详情、接单/揽货/送达状态联动;司机端页面尚待补齐 待完成
文件接口 02-API细化设计 只有占位返回;未接 OSS 待完成
物流与 AI 接口 02-API细化设计 只有占位返回;未接真实轨迹与 AI 服务 待完成
提醒接口 02-API细化设计 只有占位返回;未接真实提醒任务 待完成
报表接口 02-API细化设计 只有演示聚合结果;未接真实统计 待完成
配置与审计接口 02-API细化设计 已有 service 骨架;未接真实表与写入逻辑 待完成
系统管理接口 02-API细化设计 已接入真实用户/角色/菜单查询、新增、编辑、重置密码与角色授权链路;仍待进一步补齐更细粒度审计与迁移落地 待完成

四、数据库

任务 来源 验证方式 状态
SQLAlchemy 模型设计 03-数据库调整设计 backend/app/models 存在模型定义 已完成
Alembic 迁移初始化 03-数据库调整设计 存在 migrations 目录和迁移脚本 待完成
初始化配置与基础数据方案 03-数据库调整设计 存在初始化脚本或说明 待完成

五、测试与验收

任务 来源 验证方式 状态
后端基础自测 04-测试用例清单 仅完成少量代码级验证,未形成系统测试 待完成
核心流程测试清单映射 04-测试用例清单 任务状态与测试目标可对应 待完成
部署准备文档落地 05-开发实施与部署准备清单 目录结构与模板文件已建立 待完成

当前真实完成度说明

已真正完成

  • 基础工程初始化
  • 前后端目录结构搭建
  • 后端模型与 service / repository 主体分层
  • web-sales 业务员端订单管理闭环
  • web-admin 管理端订单审批闭环
  • web-admin 履约调度闭环
  • mini-manager 管理层端审批与履约下发主线
  • mini-driver 司机端任务执行主线
  • 订单、审批、发厂确认、司机任务创建等主链路的数据库优先实现

仍未真正完成

  • 真实登录鉴权与权限体系
  • 客户、产品、供应商、系统管理等完整后台能力
  • 真实 OSS / AI / 提醒 / 报表
  • 更完整的物流轨迹、附件上传与异常处理
  • 测试、联调、部署

修正记录

时间 记录
2026-05-14 已读取 开发细节 下 5 份文档,完成任务拆解。
2026-05-14 已完成基础工程、页面骨架、后端接口骨架、模型骨架、service 骨架、前端 mock 数据流等演示级开发。
2026-05-14 已修正状态口径:此前部分“已完成”实际仅代表骨架完成,现已按真实功能完成度改回。
2026-05-14 已开始进入真实功能开发:客户和订单已补数据库 session、repository并让 service/API 优先走数据库实现。
2026-05-14 已进一步推进真实功能:客户创建接入真实请求模型,订单详情开始返回真实明细,订单提交审核开始走数据库状态更新。
2026-05-14 已继续按 02-API细化设计.md 推进主流程:订单列表补主要筛选参数,取消订单开始走数据库状态更新,客户详情字段向接口文档靠拢。
2026-05-14 已重写客户仓储、订单 service、订单 API 的关键文件,稳定接入订单筛选、取消订单和客户详情真实功能路径。
2026-05-14 已继续推进订单审批主线:approvecancel-approve 开始走真实数据库状态更新路径。
2026-05-14 已继续收紧订单/客户主线:补齐订单提交、审批、取消审批的状态合法性校验;客户列表已支持 customer_name/mobile/customer_type/settlement_type/salesman_id 筛选,并完成核心文件编译与导入校验。
2026-05-14 已继续补齐订单详情与发厂主线:订单详情开始返回真实 factory_namesupplier-textsupplier-text/confirm 已接入真实 service/repository 路径,并在确认后将订单状态流转到 pending_factory
2026-05-14 已继续推进审批主线真实化:新增订单审批日志模型与仓储;approvecancel-approve 会写入真实审批日志;订单详情 approve_logs 已开始返回真实数据库记录。
2026-05-14 已继续推进审计查询主线:/api/audit-logs 已支持按 biz_type/biz_id/operate_type/start_time/end_time/page_no/page_size 查询,并接入真实订单审批日志数据源。
2026-05-14 已开始补前端真实联调:frontend/web-sales 的订单列表与订单详情已改为优先请求真实后端接口,失败时再回退 mock同时清理了该模块关键页面中的乱码展示文本。
2026-05-14 已继续按前后端同步方式推进:后端订单接口已清理真实中文提示语;前端 web-sales 订单列表页与详情页已接入真实 提交审核/取消订单 动作,并补充加载态、禁用态与操作结果提示。
2026-05-14 已继续按前后端同步方式推进创建订单链路:后端补充创建订单参数校验;前端 web-sales 新建订单页已接入真实 /api/orders 创建接口,并支持最小可用单明细录入。
2026-05-14 已继续补齐创建订单的数据选择链路:后端供应商接口支持按 supplier_type 筛选;前端新建订单页已改为加载真实客户与工厂选项,并通过下拉选择回填表单。
2026-05-14 已继续补齐创建订单的产品选择链路:后端产品接口支持按 product_name 筛选;前端新建订单页已接入真实产品选项,并在选择后自动回填规格、单位、销售价、成本价。
2026-05-14 已完成一个可检查的完整任务:frontend/web-sales 业务员端订单管理闭环现已支持登录后查看真实订单列表、按状态/客户/来源/日期筛选、创建最小可用订单、进入详情查看真实明细与审批记录,并可发起提交审核/取消订单;后端同步补齐订单列表 order_source 返回与前端最小校验配套。
2026-05-14 已完成一个可检查的完整任务:frontend/web-admin 管理端订单审批闭环现已支持工作台查看真实审批待办摘要、审批中心按订单编号/客户姓名/审批类型筛选待办订单、进入审批详情查看真实订单明细与审批记录,并可执行订单审批与取消审批;后端同步补齐订单列表 order_no 筛选能力以支撑管理端精确查询。
2026-05-14 已完成一个可检查的完整任务:frontend/web-admin 履约调度闭环现已支持查看待发厂订单、生成发厂文案、确认下发工厂、创建司机任务并查看真实任务列表;后端同步补齐物流任务请求模型、数据库仓储、真实任务创建与订单状态从 pending_factory 流转到 pending_driver 的联动。
2026-05-14 已整理 任务状态跟踪.md 的总览口径,使其与当前真实进度一致;并已完成一个可检查的完整任务:frontend/mini-driver 司机端执行闭环现已支持司机登录、查看真实任务列表、查看任务详情,并按状态执行接单、确认揽货、确认送达;后端已有司机任务状态与订单状态联动。
2026-05-14 已完成一个可检查的完整任务:frontend/mini-manager 微信管理层端审批闭环现已支持管理层登录、查看待订单审批/待取消审批列表、进入审批详情并执行通过/退回或同意取消/驳回取消;前端直接复用已打通的真实订单审批与取消审批接口。
2026-05-14 已继续提速推进微信管理层端:补齐 dashboard / supplier-text / task-create 三页真实联动,管理层端现已支持查看待审批/待发厂/待司机接单概览、生成并确认发厂文案、以及直接创建司机任务,微信管理层主线已基本覆盖审批后到履约下发的核心流程。
2026-05-14 已继续提速推进跨端履约留痕:补齐文件上传凭证与附件保存接口、增强物流轨迹新增与查询、并让司机端揽货/送达操作携带备注与模拟附件写入轨迹,形成“司机执行 + 轨迹留痕”闭环。
2026-05-14 已按加速节奏成组推进后端基础能力:认证接口开始优先接入真实 sys_user/sys_role/sys_menu 数据,产品分类/产品、供应商、系统管理查询接口已统一补成“数据库优先,失败回退演示数据”链路,并补齐对应请求模型、仓储与服务层。
2026-05-14 已继续按高节奏收口客户模块:后端客户创建补齐真实参数校验、重复客户错误口径和详情返回字段;frontend/web-admin 基础资料页已改为优先请求真实 /api/customers/api/customers/{id},支持客户筛选、查看详情和新增客户,客户主线已从演示态推进到可联调状态。
2026-05-14 已继续扩展 frontend/web-admin 基础资料页的真实化范围:产品分类、产品、工厂/供应商三块已接入真实查询与新增接口;后端同步补齐分类/产品/供应商创建的必要参数校验、重复数据校验与数据库优先链路,基础资料主页面已从单一客户演示页推进为多模块真实联调页。
2026-05-14 已继续严格参照 02-API细化设计.md 推进系统管理模块:后端已补齐 /api/system/users/api/system/users/{user_id}/api/system/users/{user_id}/reset-password/api/system/roles/api/system/roles/{role_id}/api/system/menus/api/system/menus/{menu_id} 的真实请求模型、参数校验、数据库优先 service/repository 链路;frontend/web-adminSystemPage 已从演示页改为真实用户/角色/菜单联调页,支持列表查询与新增。
2026-05-14 已继续完成系统管理第二段联调闭环:frontend/web-adminSystemPage 已进一步补齐用户编辑、重置密码、角色编辑、菜单编辑操作,系统管理主页面已从“只可查询/新增”推进到“可查询/新增/编辑”的联调状态;角色授权仍待关系表结构与授权接口落地。
2026-05-14 已继续完成系统管理第三段联调闭环:后端已补齐 sys_role_menu 关系模型、/api/system/roles/{role_id}/menus 查询与保存接口,并让登录鉴权优先读取真实角色授权结果;frontend/web-adminSystemPage 已补齐角色授权面板,可直接勾选菜单并保存授权;数据库.sql 已同步补充角色菜单关联表定义。
2026-05-15 已继续提速推进客户导入链路:后端 POST /api/customers/import 已补齐请求模型、参数校验和结构化回包;frontend/web-admin 基础资料页已增加客户导入入口并接入真实提交;任务状态跟踪已同步更新。
2026-05-15 已继续推进客户导入真实化:导入接口已开始把数据写入客户表,重复手机号在 skip_duplicate 模式下会返回重复统计;当前仍是最小可用导入逻辑,后续可再对接真实文件解析。
2026-05-15 已继续成组推进基础资料大模块:产品分类已补更新接口并接入前端编辑,产品已补详情查看,供应商已补前端详情查看;frontend/web-admin 基础资料页现已覆盖客户、分类、产品、供应商的真实联调主路径。
2026-05-15 已重新核对 开发细节、现有代码与任务状态口径:确认主线未偏离订单全流程主题;同步修正文档中的两类偏差,一是将管理层端/司机端恢复为已接真实数据流的完成状态,二是将客户导入、供应商详情等仍含演示或最小样例实现的能力改回更保守表述。