| 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 |
已继续推进订单审批主线：approve 与 cancel-approve 开始走真实数据库状态更新路径。 |
| 2026-05-14 |
已继续收紧订单/客户主线：补齐订单提交、审批、取消审批的状态合法性校验；客户列表已支持 customer_name/mobile/customer_type/settlement_type/salesman_id 筛选，并完成核心文件编译与导入校验。 |
| 2026-05-14 |
已继续补齐订单详情与发厂主线：订单详情开始返回真实 factory_name；supplier-text 与 supplier-text/confirm 已接入真实 service/repository 路径，并在确认后将订单状态流转到 pending_factory。 |
| 2026-05-14 |
已继续推进审批主线真实化：新增订单审批日志模型与仓储；approve、cancel-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-admin 的 SystemPage 已从演示页改为真实用户/角色/菜单联调页，支持列表查询与新增。 |
| 2026-05-14 |
已继续完成系统管理第二段联调闭环：frontend/web-admin 的 SystemPage 已进一步补齐用户编辑、重置密码、角色编辑、菜单编辑操作，系统管理主页面已从“只可查询/新增”推进到“可查询/新增/编辑”的联调状态；角色授权仍待关系表结构与授权接口落地。 |
| 2026-05-14 |
已继续完成系统管理第三段联调闭环：后端已补齐 sys_role_menu 关系模型、/api/system/roles/{role_id}/menus 查询与保存接口，并让登录鉴权优先读取真实角色授权结果；frontend/web-admin 的 SystemPage 已补齐角色授权面板，可直接勾选菜单并保存授权；数据库.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 |
已重新核对 开发细节、现有代码与任务状态口径：确认主线未偏离订单全流程主题；同步修正文档中的两类偏差，一是将管理层端/司机端恢复为已接真实数据流的完成状态，二是将客户导入、供应商详情等仍含演示或最小样例实现的能力改回更保守表述。 |
| 2026-05-15 |
已继续按 02-API细化设计.md 推进文件接口主线：补齐 file_attachment 模型、仓储与数据库优先保存链路，上传凭证开始按 OSS Bucket / 公网域名 / 文件分类 / 大小限制生成结构化返回；当前仍未对接真实 OSS 签名服务。 |
| 2026-05-15 |
已继续按 02-API细化设计.md 推进报表接口主线：/api/reports/performance 已接入真实数据库优先聚合，支持 month/quarter/year、日期区间和产品分类过滤，并统计订单金额、分类金额与固定提成；导出接口已与查询参数口径对齐，但仍未生成真实导出文件。 |
| 2026-05-15 |
已继续按 02-API细化设计.md 推进配置接口主线：/api/configs/{config_key} 查询与更新已接入 system_config 数据库优先链路，补齐 arrears_generate_mode、物流超时、沉默客户周期和金额阈值等核心配置校验；审计接口仍保持“订单审批日志优先”范围。 |
| 2026-05-15 |
已继续按 02-API细化设计.md 推进提醒接口主线：/api/reminders 列表、已读、欠款提醒检查、沉默客户提醒检查已接入 system_reminder / customer_arrears 数据库优先链路，并按配置完成基础去重和阈值判断；欠款记录自动生成与物流超时提醒仍待继续补。 |
| 2026-05-15 |
已继续成组推进“欠款生成 + 物流轨迹”主线：新增订单状态变更接口，订单进入 shipped/delivered 等节点时会按 arrears_generate_mode 自动生成 customer_arrears；/api/logistics/{order_id}/trace 已改为数据库优先查询与写入，司机接单/揽货/送达会同步留下真实轨迹记录。 |
| 2026-05-15 |
已继续成组推进审计主线：补齐 audit_log 模型、仓储和真实查询入口，并让订单状态变更、配置新增/更新、附件保存、提醒已读等关键写操作开始写入真实审计日志；审批、系统管理更多操作仍可继续补齐覆盖面。 |
| 2026-05-15 |
已继续按 02-API细化设计.md 推进 AI 接口主线：/api/ai/recognize 与 /api/ai/recognize/{log_id}/correct 已补齐请求模型、数据库优先 service/repository 链路、识别记录落库、人工修正落库与审计留痕；当前识别结果仍为后端 mock provider，未接真实阿里云 OCR。 |
| 2026-05-15 |
已继续按 02-API细化设计.md 推进报表导出主线：/api/reports/performance/export 已开始基于真实统计结果生成 CSV 导出文件，并通过附件保存链路写入导出记录与审计日志；当前返回的是本地文件路径，后续可再切到 OSS 公网发布。 |
| 2026-05-15 |
已继续成组推进系统管理审计主线：用户新增/编辑/重置密码、角色新增/编辑、角色授权、菜单新增/编辑等系统管理关键写操作已开始写入 audit_log，系统管理模块已从“有写接口”推进到“有写接口且可追溯”。 |
| 2026-05-15 |
已继续成组推进认证主线：数据库优先登录已切到密码哈希校验与签名 token，/api/auth/me 已支持 token 解析和过期判断，/api/auth/logout 已接入基础失效处理；当前仍未统一补到所有业务接口的角色/数据范围拦截。 |
| 2026-05-15 |
已继续成组推进“统一鉴权 + 数据范围控制”主线：新增通用 token 鉴权依赖，订单/客户/司机任务/系统管理关键接口已补齐角色限制；业务员现仅可访问本人订单与客户，司机现仅可访问本人任务与轨迹，订单详情已按接口文档对业务员隐藏成本/利润等敏感字段。 |
| 2026-05-15 |
已继续完成基础资料与登录联调大功能：客户导入已从最小样例升级为本地 csv/xlsx/xls 真实解析导入，支持逐行校验、跳过重复和覆盖重复；供应商详情接口已接入真实数据库优先链路；web-admin 与 web-sales 已补真实登录入口、token 持久化与请求透传，以适配后端已启用的统一鉴权。 |
| 2026-05-15 |
已继续完成数据库迁移与初始化大功能：补齐 Alembic 初始迁移，覆盖系统、基础资料、订单、物流、附件、提醒、AI 等核心表；初始化脚本已从摘要输出升级为可执行写库脚本，可初始化角色、菜单、授权关系、系统配置、默认分类和管理员账号；backend/README.md 已同步补齐迁移和初始化说明。 |
| 2026-05-15 |
已继续完成“统一对象存储发布链路”大功能：新增独立存储服务，文件上传凭证已统一返回 OSS URL、对象 key、bucket 与过期时间；报表导出已从本地路径返回升级为“真实 CSV + 本地对象存储模拟目录发布 + OSS 公网 URL 口径回包 + 附件落库 + 审计日志”的完整链路；backend/README.md 已同步补齐当前阶段的 OSS 口径说明。 |
| 2026-05-15 |
已修正第三项“后端接口”状态口径：产品与分类接口、供应商接口、配置与审计接口已按真实联调闭环更新为“已完成”；同时确认认证、订单、客户、文件、物流与 AI 等条目仍存在待收口事项，继续保留为“待完成”。 |
| 2026-05-15 |
已继续推进 AI/OCR 主线：backend/app/services/ai_service.py 已从固定 mock 适配器升级为可切换 provider 结构，支持 AI_PROVIDER=aliyun 时按配置发起真实 OCR HTTP 请求，配置缺失或第三方失败会明确返回错误，并保留识别落库、人工修正和审计链路。 |
| 2026-05-15 |
已继续收口客户接口：客户导入除本地 csv/xlsx/xls 外，已兼容系统统一对象存储 OSS URL 口径文件来源；frontend/web-admin 客户导入入口文案已同步改为支持本地路径或 OSS 公网 URL。 |
| 2026-05-15 |
已继续收口认证与提醒主线：/api/auth/logout 已补 token 持久化失效存储，避免服务重启后 token 恢复可用；订单与系统管理关键接口已补权限码校验；提醒模块已新增 /api/reminders/logistics-timeout/check 与 /api/reminders/check-all 统一触发入口。 |
| 2026-05-15 |
已继续推进报表导出主线：/api/reports/performance/export 已补 export_format=csv/xlsx 双格式导出，xlsx 文件会生成基础表头样式与列宽；任务状态跟踪中“更完整导出格式”待办已同步收口。 |
| 2026-05-15 |
已继续收口文件接口：/api/files/upload-token 已改为按 OSS V1 预签名 URL 规则生成真实 PUT 上传地址；/api/files/attachments 已补文件大小、对象 key 与文件名匹配校验，文件接口主链路已更新为“已完成”。 |
