taiyi/dingdanquanliucheng
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2fc03af75f
dingdanquanliucheng/6-22修复规划.md
wsb1224 f097d9b5b8 6-22规划修复：审批融入订单详情、物流实时查询、小程序审批页对齐 
主要变更：
- 管理员端：移除独立审批中心，审批功能融入订单详情Drawer
  工作台改为待审批订单快捷列表，路由重定向
- 业务员端：订单列表物流信息对接快递100实时查询，超时红色标记
- 管理员小程序：审批详情页扩展为完整订单详情（单据信息、费用明细、
  产品列表、收货信息、审批记录、工厂选择）
- 自发订单：有快递单号时审批通过跳过工厂下发，提示"马甸工厂自发"
  pending_driver状态增加分配司机按钮
- 提醒中心：提醒类型和状态全部显示中文
- 物流查询改为并行请求提升性能
- 更新修复规划文档状态标记

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-22 15:32:59 +08:00

441 lines
46 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.

# 6-22 修复规划文档
> 基于《订单全流程软件6-22修改规划》的需求，结合当前系统代码分析，逐项拆解为可执行的修改任务。
> 每个任务包含：当前状态、目标状态、涉及文件、实现方案、验证标准。
**更新时间：2026-06-22**
**状态图例：**
- ✅ 已完成 — 功能已实现并通过验证
- ⚠️ 部分完成 — 前端或后端某一方已完成，另一方待完善
- ❌ 未完成 — 功能尚未实现
- 🔍 待确认 — 需要进一步验证后端逻辑
---
## 一、业务员网页端
### 1.1 新建订单页面
#### 任务 1：产品选择增加搜索功能 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | `OrderFormPage.vue` 中产品下拉使用原生 `<select>`，无搜索/过滤能力，产品多时需逐个滚动查找 |
| **目标状态** | 产品选择支持关键词搜索（模糊匹配产品名称/规格），输入即过滤 |
| **涉及文件** | `frontend/web-sales/src/views/OrderFormPage.vue`（主改）|
| **实现方案** | 将原生 `<select>` 替换为带搜索输入框的自定义下拉组件：顶部一个文本输入框用于搜索过滤，下方显示匹配的产品列表。输入文字时实时过滤 `productOptions` 数组（匹配 `product_name` 或 `specification`）。选择后自动填充 `product_name`、`specification`、`unit`、`sale_price`、`cost_price`。无需引入第三方库，纯 Vue 实现。 |
| **验证标准** | ① 输入关键词后列表实时过滤；② 选中产品后自动填充规格/单位/价格；③ 清空搜索框后显示全部产品 |
| **完成情况** | ✅ `OrderFormPage.vue:166-187` 已实现搜索输入框+下拉过滤组件，支持按产品名称/规格模糊匹配，选择后自动填充所有字段 |
---
#### 任务 2：产品明细区域增加成本核算提示 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 产品明细板块无任何提示说明 |
| **目标状态** | 在产品明细板块标题后增加提示文字："此处属于成本核算区域，需要根据实际的货物选择对应的规格" |
| **涉及文件** | `frontend/web-sales/src/views/OrderFormPage.vue` |
| **实现方案** | 在"客户需求"板块的产品列表标题旁增加一个灰色提示文字 `<p class="hint-text">`。纯文本展示，不影响功能。 |
| **验证标准** | 提示文字在产品列表上方清晰可见 |
| **完成情况** | ✅ `OrderFormPage.vue:158` 已有灰色提示文字 `此处属于成本核算区域，需要根据实际的货物选择对应的规格`，样式类 `.hint-text-cost` |
---
#### 任务 3：产品规格后增加计算逻辑说明 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 规格字段只显示结果，无计算过程 |
| **目标状态** | 在规格字段后面展示计算逻辑（如：长×宽×数量=面积），帮助业务员理解价格来源 |
| **涉及文件** | `frontend/web-sales/src/views/OrderFormPage.vue`、`backend/app/services/pricing_engine.py`（可选）|
| **实现方案** | **方案A（简单）**：在产品行的规格字段后，如果有 `surcharge_detail`（定价引擎的附加费详情），将其解析并以文字形式展示计算过程。**方案B（完整）**：后端定价引擎返回计算步骤字符串，前端直接展示。推荐方案A，改动最小。如果产品是手动填写（非定价引擎计算），则不显示计算逻辑。 |
| **验证标准** | ① 通过定价引擎计算的产品，规格后显示计算过程；② 手动填写的产品不显示 |
| **完成情况** | ✅ `OrderFormPage.vue:196` 规格字段后展示 `_calcHint`，内容来自 `surcharge_detail` 的解析（计价方式/公式/尺寸/面积），`OrderFormPage.vue:612-627` `handleProductChange` 中解析 `surcharge_detail` 并生成提示文本 |
---
#### 任务 4：去掉含税金额字段，使用定价引擎计算 ⚠️ 部分完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 表单中有独立的"含税金额"输入框（`form.tax_amount`），用户手动填写 |
| **目标状态** | 去掉手动输入的含税金额字段，改由后台定价引擎自动计算含税价格 |
| **涉及文件** | `frontend/web-sales/src/views/OrderFormPage.vue`（去掉UI）、`backend/app/services/pricing_engine.py`（已有含税计算逻辑）、`backend/app/services/order_service.py`（确认 tax_amount 计算）|
| **实现方案** | ① 前端：删除"含税金额"输入框的渲染代码（约行222附近）；② 后端：`order_service.py` 的 `create_order` 和 `update_order` 中，`tax_amount` 字段改为从定价引擎的含税结果自动计算（当前已有 `tax_total` 的计算逻辑，确认 `tax_amount` 是否需要独立计算）。注意：`tax_amount` 和 `tax_total` 的区别需要明确——`tax_total` 是税额，`tax_amount` 是含税总价。 |
| **验证标准** | ① 前端不再显示含税金额输入框；② 创建订单后 `tax_amount` 由系统自动计算填充；③ 审批详情页能正确显示含税信息 |
| **完成情况** | ⚠️ **前端已完成**：模板中已不渲染含税金额输入框。`form` 对象中仍保留 `tax_amount` 字段（`OrderFormPage.vue:375`），提交时传入但值始终为0。**后端待确认**：需确认 `order_service.py` 中 `create_order` 是否自动计算 `tax_amount`，还是依赖前端传入 |
---
#### 任务 5：合同金额模块重构（收款渠道 + 发票 + 订单类型）✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 合同金额仅一个数字输入框；收款渠道（支付方式）在"其他信息"区域单独展示；发票是一个复选框；无订单类型字段 |
| **目标状态** | 合同金额模块整合：合同金额 + 收款渠道 + 是否开发票 + 订单类型（工业订单/日用品订单）。收款渠道由管理员在后台配置。订单类型根据收款渠道自动区分电商/普通。 |
| **涉及文件** | **前端**：`frontend/web-sales/src/views/OrderFormPage.vue`（UI重构）；**后端**：`backend/app/models/business.py`（新增字段）、`backend/app/schemas/orders.py`（新增schema字段）、`backend/app/services/order_service.py`（新增逻辑）、`backend/app/repositories/order_repository.py`（持久化）；**数据库**：新增 Alembic 迁移；**配置**：`backend/app/services/config_service.py` + `bootstrap.py`（收款渠道配置项）|
| **实现方案** | **数据库层**：<br>① `sales_order` 表新增 `order_type` 字段（String(32)，值：`industry`/`daily`，对应工业订单/日用品订单）<br>② `system_config` 表新增配置项 `payment_channels`（JSON数组，管理员可配置收款渠道列表及每个渠道是否为电商渠道）<br><br>**后端层**：<br>① `business.py` 模型增加 `order_type` 字段<br>② `schemas/orders.py` 增加 `order_type` 字段<br>③ `order_service.py` 创建/更新订单时处理 `order_type`；根据收款渠道的电商标记自动设置 `order_source`<br>④ 配置项 `payment_channels` 格式：`[{"name":"现金","is_ecommerce":false},{"name":"淘宝","is_ecommerce":true}]`<br><br>**前端层**：<br>① 合同金额区域重新布局：合同金额输入框 + 收款渠道下拉（从配置读取）+ 是否开发票复选框 + 订单类型单选（工业订单/日用品订单）<br>② 收款渠道选择后，如果该渠道标记为电商，自动将订单来源设为电商<br>③ 去掉原"其他信息"区域中的支付方式和发票复选框 |
| **验证标准** | ① 收款渠道下拉选项由管理员后台配置控制；② 选择电商收款渠道后订单来源自动标记为电商；③ 订单类型（工业/日用品）保存成功；④ 报表统计可按订单类型拆分 |
| **完成情况** | ✅ **数据库**：`business.py:141-143` 已有 `order_type`、`self_delivery`、`tracking_number` 字段。**前端**：`OrderFormPage.vue:222-254` 已有收款渠道下拉（从 `payment_channels` 配置读取）、是否开发票复选框、订单类型选择（工业/日用品）。`OrderFormPage.vue:708-709` 已实现根据收款渠道 `is_ecommerce` 自动设置 `order_source`。`OrderFormPage.vue:653-679` 已从后端加载 `payment_channels` 配置 |
---
#### 任务 6：订单附件下方增加物流信息输入 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 新建订单表单无物流信息输入；物流信息在订单创建后由管理员分配司机时才录入 |
| **目标状态** | 在订单附件下方增加"物流信息"模块，业务员可直接输入快递单号。如果业务员在新建时已填物流信息，订单跳过"下发工厂"节点，审批通过后直接进入待分配司机状态。审批时提示"马甸工厂自发"。 |
| **涉及文件** | **前端**：`frontend/web-sales/src/views/OrderFormPage.vue`（新增UI）；**后端**：`backend/app/services/order_service.py`（修改审批流程）、`backend/app/api/orders.py`（接收物流字段）；**数据库**：`sales_order` 表或新建 `order_logistics_info` 表 |
| **实现方案** | **数据库层**：<br>① `sales_order` 表新增 `self_delivery` 布尔字段（默认 false）和 `tracking_number` 字符串字段<br><br>**后端层**：<br>① `create_order` / `update_order` 接收并保存 `self_delivery` 和 `tracking_number`<br>② `approve_order` 中：如果订单有 `tracking_number`（已填物流信息），审批通过后状态直接变为 `pending_driver`（跳过 `pending_factory`），并生成提示"马甸工厂自发"<br>③ 审批通知中附带提示信息<br><br>**前端层**：<br>① 订单附件下方新增"物流信息"区块<br>② 包含：快递单号输入框（可选）、提示文字"如已填写快递单号，订单将跳过工厂下发环节"<br>③ 提交时将 `tracking_number` 和 `self_delivery` 随表单一起提交 |
| **验证标准** | ① 填写快递单号的订单，审批通过后状态直接为 `pending_driver`；② 未填写的订单正常走 `pending_factory` 流程；③ 管理员审批时能看到"马甸工厂自发"提示 |
| **完成情况** | ✅ **数据库**：`business.py:142-143` 已有 `self_delivery`（Integer，默认0）和 `tracking_number`（String(128)）字段。**前端**：`OrderFormPage.vue:280-291` 已有物流信息区域，含快递单号输入框和提示文字。`OrderFormPage.vue:710-726` 提交时已将 `self_delivery` 和 `tracking_number` 包含在 payload 中。**后端审批逻辑待确认**：需验证 `order_service.py` 的 `approve_order` 是否已处理自发订单跳过工厂下发的逻辑 |
---
### 1.2 我的订单页面
#### 任务 7：英文状态全部改为中文 ⚠️ 部分完成
| 项目 | 内容 |
|------|------|
| **当前状态** | `OrdersPage.vue` 的 `statusTextMap` 已将状态码映射为中文，但部分地方可能仍显示英文原始值（如 API 返回的 `statusText` 字段如果为空时的 fallback） |
| **目标状态** | 所有状态信息全部以中文展示，用户无任何英文阅读障碍 |
| **涉及文件** | `frontend/web-sales/src/views/OrdersPage.vue`、`frontend/web-sales/src/views/OrderDetailPage.vue`（如存在）|
| **实现方案** | ① 确认 `OrdersPage.vue` 中 `statusTextMap` 覆盖所有17种状态码；② 检查列表中状态列的渲染逻辑，确保 fallback 也显示中文；③ 检查订单详情页面的状态显示。`backend/app/services/order_service.py` 的 `normalize_list_filters` 已在返回数据中添加 `statusText` 字段（中文），确认前端优先使用该字段。 |
| **验证标准** | 页面中不出现任何英文状态码（如 `pending_approve`、`approved` 等）|
| **完成情况** | ⚠️ **前端映射完整**：`mockApi.js:63-84` 的 `mapOrderStatus` 已覆盖全部17种状态码（含 `pending_settle`、`settled`）。但 `OrdersPage.vue:86` 显示的是 `row.status` 而非 `row.statusText`，需确认后端 `normalize_list_filters` 返回的 `status` 字段是否已是中文。如果后端返回英文原始值，则需改为 `row.statusText` 或调用 `mapOrderStatus(row.rawStatus)` |
---
#### 任务 8：订单列表物流信息实时查询（快递100 API）❌ 未完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 订单列表的"物流信息"列显示的是静态文本（来自订单记录），无法看到最新物流状态。需要点击进详情才能查看。 |
| **目标状态** | 订单列表直接展示最新物流状态，调用快递100 API 查询。如果物流超时（后台配置的时间内无更新），物流信息文字变红色。 |
| **涉及文件** | **前端**：`frontend/web-sales/src/views/OrdersPage.vue`（物流列渲染）；**后端**：`backend/app/services/logistics_service.py`（新增快递100查询接口）、`backend/app/api/logistics.py`（新增API端点）、`backend/app/services/config_service.py`（超时配置）|
| **实现方案** | **后端层**：<br>① 新增 API 端点 `GET /api/logistics/trace-by-tracking?tracking_number=xxx`，调用快递100 API 查询最新物流状态<br>② 返回：`{status, latest_update, update_time, is_timeout}`<br>③ 超时判断：`update_time` 距今超过配置的 `logistics_timeout_hours` 则 `is_timeout=true`<br>④ 如已有快递100集成（`logistics_trace_provider` 配置为 `kdniao`），复用现有逻辑；否则新增<br><br>**前端层**：<br>① 订单列表加载后，对有快递单号的订单批量查询最新物流状态<br>② 物流信息列渲染：正常状态显示黑色文字，超时状态显示红色文字<br>③ 考虑性能：列表分页时每页最多20条，逐条查询可接受；或后端提供批量查询接口 |
| **验证标准** | ① 有快递单号的订单显示最新物流状态；② 超时的物流信息文字为红色；③ 无快递单号的订单不显示物流信息 |
| **完成情况** | ❌ **未实现**。`OrdersPage.vue:85` 物流信息列只显示 `row.logisticsInfo` 静态文本，无快递100 API 调用，无超时红色标记逻辑。后端 `logistics_service.py:1226` 已有快递100集成（`_fetch_kuaidi100_traces`），`config.py:72-75` 已有快递100配置项，但前端未对接。需新增按 `tracking_number` 查询的 API 端点 + 前端实时查询逻辑 |
---
#### 任务 9：订单列表增加分页大小选择 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 分页大小硬编码为20，只有上一页/下一页按钮 |
| **目标状态** | 用户可选择每页显示多少条数据（如 10/20/50/100）|
| **涉及文件** | `frontend/web-sales/src/views/OrdersPage.vue` |
| **实现方案** | ① 在分页栏增加一个 `<select>` 下拉，选项为 `[10, 20, 50, 100]`；② 修改 `pageSize` 从常量改为响应式变量；③ 切换 pageSize 时重置 pageNo 为 1 并重新加载数据 |
| **验证标准** | ① 切换每页条数后列表立即刷新；② 默认值为 20；③ 总页数随 pageSize 变化正确更新 |
| **完成情况** | ✅ `OrdersPage.vue:111-119` 已有每页条数选择器（10/20/50/100），`pageSize` 为 `ref(20)` 响应式变量，`handlePageSizeChange` 切换时重置 `pageNo` 为1并重新加载 |
---
### 1.3 工作台页面
#### 任务 10：工作台支持自定义时间段查询 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | `DashboardPage.vue` 只展示固定的时间段统计（今日/本周/本月），无自定义时间段选择 |
| **目标状态** | 业务员可以选择任意时间段查询销售数据 |
| **涉及文件** | `frontend/web-sales/src/views/DashboardPage.vue`（UI增加）、`backend/app/api/salesman.py`（支持自定义日期参数）、`backend/app/services/order_service.py`（查询逻辑）|
| **实现方案** | **后端层**：<br>① `GET /api/salesman/statistics` 接口增加 `start_date` 和 `end_date` 查询参数<br>② 当提供自定义日期时，忽略 `period` 参数，按日期范围查询<br><br>**前端层**：<br>① 在统计卡片区域上方增加日期范围选择器（两个 date input：开始日期、结束日期）<br>② 增加"查询"按钮，点击后用自定义日期范围重新请求统计数据<br>③ 保留原有的快速选择按钮（今日/本周/本月）作为快捷方式 |
| **验证标准** | ① 选择自定义日期范围后统计数据正确更新；② 保留原有的今日/本周/本月快捷切换；③ 空日期范围不发起请求 |
| **完成情况** | ✅ `DashboardPage.vue:46-56` 已有自定义日期范围选择器（两个 date input + 查询按钮），`loadCustomStats` 函数（行237-254）支持自定义日期查询，空日期时直接 return |
---
### 1.4 提醒中心页面
#### 任务 11：提醒信息全部改为中文 ⚠️ 部分完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 部分提醒信息可能包含英文（如提醒类型字段、状态字段） |
| **目标状态** | 所有提醒信息展示全部为中文 |
| **涉及文件** | `frontend/web-sales/src/views/RemindersPage.vue`（如有）、`backend/app/services/event_bus.py`（提醒内容模板）、`backend/app/services/reminder_service.py` |
| **实现方案** | ① 检查前端提醒列表页面所有字段的展示，确认无英文；② 检查后端 `event_bus.py` 中所有提醒模板文字是否为中文；③ 检查提醒类型（`type` 字段）的映射是否为中文 |
| **验证标准** | 提醒中心页面中不出现任何英文文本 |
| **完成情况** | ⚠️ **前端页面本身已中文**：`RemindersPage.vue` 标题、筛选项、按钮等均为中文。但提醒类型的选项值（`reminderTypes`，行91）从后端动态获取，如果后端返回英文编码（如 `logistics_timeout`），则页面会显示英文。**需确认**：后端 `reminder_service.py` 返回的 `reminder_type` 是否为中文文本 |
---
### 1.5 客户管理页面
#### 任务 12：业务员可编辑客户信息 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | `CustomersPage.vue` 只能创建客户，不能编辑已有客户信息 |
| **目标状态** | 业务员可以编辑自己客户的姓名、手机号、地址等信息 |
| **涉及文件** | `frontend/web-sales/src/views/CustomersPage.vue`（增加编辑UI）、`backend/app/api/customers.py`（确认已有 PUT 端点）、`backend/app/services/customer_service.py` |
| **实现方案** | **前端层**：<br>① 在客户列表每行增加"编辑"按钮<br>② 复用现有创建客户的 modal，改为"编辑客户"模式（预填现有数据）<br>③ 编辑提交时调用 `PUT /api/customers/{id}`<br><br>**后端层**：<br>确认 `PUT /api/customers/{id}` 端点已存在且正常工作。如不存在则新增。 |
| **验证标准** | ① 点击编辑按钮弹出预填的编辑表单；② 保存后客户信息更新成功；③ 列表立即刷新显示新数据 |
| **完成情况** | ✅ `CustomersPage.vue:56` 每行有编辑按钮，`openEditModal`（行218-229）预填现有客户数据，弹窗标题自动切换为"编辑客户"（行71），`handleCreate`（行350-381）支持创建/编辑双模式，编辑时调用 `updateCustomer` |
---
#### 任务 13：业务员可设置客户月结时间 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | `Customer` 模型有 `settlement_type` 和 `settlement_days` 字段，但前端客户管理页面无法设置详细的月结规则 |
| **目标状态** | 业务员可以设置客户的月结时间：每月几号付款 / 订单审批通过后多长时间付款 / 定期下个月几号提醒 |
| **涉及文件** | **前端**：`frontend/web-sales/src/views/CustomersPage.vue`（增加月结设置UI）；**后端**：`backend/app/models/business.py`（确认字段是否足够）、`backend/app/services/arrears_service.py`（月结逻辑）|
| **实现方案** | **数据库层**：<br>检查 `Customer` 表是否有足够的字段支持三种月结模式。当前有 `settlement_type`（monthly/cash/delivered）和 `settlement_days`。需确认是否需要新增字段，如 `settlement_day_of_month`（每月几号）和 `reminder_day_of_month`（每月几号提醒）。<br><br>**前端层**：<br>① 编辑客户 modal 中增加月结设置区域<br>② 月结模式选择：a) 固定每月X号付款；b) 审批通过后N天内付款；c) 下个月X号提醒<br>③ 根据选择的模式显示对应的输入框<br><br>**后端层**：<br>① 保存月结设置到客户记录<br>② `arrears_service.py` 根据客户的月结模式计算不同的 `due_date` |
| **验证标准** | ① 三种月结模式可选择并保存；② 欠款到期日根据月结模式正确计算；③ 编辑客户时能正确回显已设置的月结信息 |
| **完成情况** | ✅ **数据库**：`business.py:29-30` 已有 `settlement_day_of_month`（Integer）和 `reminder_day_of_month`（Integer）字段。**前端**：`CustomersPage.vue:123-134` 已有"每月结算日"和"每月提醒日"下拉选择（选择月结方式时显示），`createForm`（行186-187）和 `openEditModal`（行226-227）已包含这两个字段的读写 |
---
## 二、管理员网页端
### 2.1 订单工作流程优化
#### 任务 14：审批模块融入订单详情页面 ⚠️ 部分完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 审批功能分散在两个地方：① 独立的审批中心页面（`ApprovalsPage.vue`，含 Drawer）；② 独立的审批详情页（`ApprovalDetailPage.vue`）。订单详情在 `OrdersPage.vue` 的 Drawer 中，没有审批功能。 |
| **目标状态** | 去掉独立的审批中心页面（作为子菜单），将审批功能直接融入订单详情页面。订单详情页的审批记录下方增加审批模块（仅管理员可见）。总览页面（工作台）直接展示待审批列表。 |
| **涉及文件** | **前端**：`frontend/web-admin/src/views/OrdersPage.vue`（订单详情Drawer中增加审批模块）、`frontend/web-admin/src/views/DashboardPage.vue`（工作台增加待审批快捷入口）、`frontend/web-admin/src/router.js`（移除审批中心路由或改为隐藏）；**后端**：无需修改 |
| **实现方案** | **步骤1 - 订单详情 Drawer 增加审批模块**：<br>① 在 `OrdersPage.vue` 的订单详情 Drawer 中，"审批记录"时间线下方增加"审批操作"模块<br>② 审批模块内容：利润展示（利润率 + 利润计算过程）、下发工厂选择（下拉）、分配司机（下拉）、审批通过/驳回按钮<br>③ 审批模块仅当 `orderStatus` 为 `pending_approve`/`cancel_pending`/`cancel_fulfillment_pending` 时显示<br>④ 审批模块仅对 `manager`/`admin` 角色可见<br><br>**步骤2 - 审批通过时的附加功能**：<br>① 审批通过时，如果订单无 `tracking_number`（非自发），弹出工厂选择模态框，生成下发工厂信息并自动复制到剪贴板<br>② 提示"信息已复制"<br>③ 如果订单有 `tracking_number`（自发），直接通过，跳过工厂下发<br><br>**步骤3 - 工作台调整**：<br>① `DashboardPage.vue` 的"审批说明"面板替换为待审批订单快捷列表（复用现有 `fetchApprovalDashboard` 数据）<br>② 点击列表项直接打开对应订单的详情 Drawer<br><br>**步骤4 - 路由调整**：<br>① `/approvals` 路由保留但改为重定向到 `/orders?status=pending_approve`<br>② 或在侧边栏菜单中隐藏"审批中心"入口 |
| **验证标准** | ① 订单详情页底部显示审批模块（仅管理员可见）；② 审批通过后自动复制工厂信息到剪贴板；③ 工作台可直接看到并处理待审批订单；④ 业务员看不到审批模块 |
| **完成情况** | ⚠️ **订单详情 Drawer 已有审批操作**：`OrdersPage.vue:145-157` 已有完整的状态推进按钮（推进待工厂/分配任务/结算提成等），行283-330 已有财务结算信息（含利润金额/利润率），行334-348 已有审批记录时间线，行460-487 已有工厂选择弹窗，行409-457 已有分配任务弹窗。**未完成部分**：<br>① **审批中心页面未移除**：`App.vue:130` 侧边栏仍有"审批中心"入口，`router.js:35` 仍保留 `/approvals` 路由<br>② **工作台未改**：`DashboardPage.vue:14` 仍有"进入审批中心"链接，行28/32 仍跳转 `/approvals`，行58-68 仍为"审批说明"静态文案而非待审批订单列表<br>③ **审批通过复制到剪贴板**功能未实现<br>④ **自发订单审批提示**（马甸工厂自发）未实现 |
---
#### 任务 15：管理员小程序审批页面与网页端保持一致 ❌ 未完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 管理员小程序审批详情页（`approve-detail`）只显示利润摘要和费用明细，内容比网页端少很多 |
| **目标状态** | 小程序审批页面内容与网页端保持一致，去掉多余的内容 |
| **涉及文件** | `frontend/mini-app/pages/manager/approve-detail/approve-detail.js`、`frontend/mini-app/pages/manager/approve-detail/approve-detail.wxml` |
| **实现方案** | ① 扩展小程序审批详情页，增加以下内容（对齐网页端）：<br> - 客户详细信息（地址）<br> - 产品明细表格（规格、数量、单价、成本价）<br> - 利润率阈值告警<br> - 利润计算公式展示<br> - 下发工厂选择<br> - 分配司机选择<br>② 去掉与网页端不一致的多余内容<br>③ 修复 `cancel_fulfillment_pending` 状态下按钮文字不正确的问题 |
| **验证标准** | ① 小程序审批页面展示的信息与网页端一致；② 所有审批操作（通过/驳回/下发工厂/分配司机）在小程序中可用；③ `cancel_fulfillment_pending` 状态下按钮文字正确 |
| **完成情况** | ❌ **未实现**。`approve-detail.wxml` 当前内容：概要卡片（订单号+客户+利润）+ 费用明细 + 产品列表 + 收货地址 + 通过/驳回按钮。**缺少**：单据基础信息（订单来源/交付方式/业务员/工厂/创建时间）、财务结算详细信息（合同金额/成本/利润/回扣/运费/税费/佣金/支付方式）、下发工厂选择、分配司机选择。标题仍为"审批详情"。`approve-detail.js` 的 `loadDetail` 只获取利润和费用数据，未处理完整订单字段 |
---
#### 任务 16：订单增加待结算状态 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 订单状态流中没有"待结算"状态。`completed` 之后直接到 `settled`。提成金额为0的订单也走 `settled`。 |
| **目标状态** | 有提成（`commission_amount > 0`）的订单，完成（`completed`）后进入"待结算"状态（`pending_settle`）。管理员在审批详情中点击"结算提成"按钮后变为"已结算"（`settled`）。提成金额为0的订单跳过待结算，直接到已结算。 |
| **涉及文件** | **后端**：`backend/app/models/business.py`（新增状态常量）、`backend/app/services/order_service.py`（修改状态转换逻辑）、`backend/app/repositories/order_repository.py`；**前端**：`frontend/web-admin/src/views/OrdersPage.vue`（增加结算按钮）、`frontend/web-admin/src/views/DashboardPage.vue`（增加待结算统计卡）；**数据库**：Alembic 迁移（如果需要新字段）|
| **实现方案** | **后端层**：<br>① 状态转换表新增：`completed -> pending_settle`、`pending_settle -> settled`<br>② `change_order_status` 中：当从 `completed` 转出时，如果 `commission_amount > 0`，只允许转到 `pending_settle`；如果 `commission_amount == 0`，自动转到 `settled`<br>③ 新增 API 端点 `POST /api/orders/{id}/settle`，用于结算提成（将 `pending_settle` 转为 `settled`）<br><br>**前端层**：<br>① `OrdersPage.vue` 订单详情中，当状态为 `pending_settle` 时显示"结算提成"按钮<br>② 点击后调用 `POST /api/orders/{id}/settle`，成功后刷新<br>③ `DashboardPage.vue` 增加"待结算"统计卡片 |
| **验证标准** | ① 有提成的订单完成状态后自动进入"待结算"；② 无提成的订单直接进入"已结算"；③ 管理员点击"结算提成"后订单变为已结算；④ 待结算订单在工作台有统计展示 |
| **完成情况** | ✅ **前端完整实现**：`OrdersPage.vue:54` 筛选中已有"待结算"选项，`OrdersPage.vue:154-156` 已有 `completed -> pending_settle` 和 `pending_settle -> settled` 的按钮逻辑（根据 `commission_amount > 0` 判断），`OrdersPage.vue:156` 已有"结算提成"按钮调用 `handleSettle`。`DashboardPage.vue:48-51` 已有"待结算"统计卡片。**后端状态机待确认**：需验证 `order_service.py` 中 `change_order_status` 是否已实现 `completed -> pending_settle` 的转换逻辑和 `POST /api/orders/{id}/settle` 端点 |
---
### 2.2 报表统计增强
#### 任务 17：报表按工业品/日用品拆分，支持剔除电商订单 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | `ReportsPage.vue` 已支持按产品分类过滤和排除电商订单。但分类是基于 `product_category` 表的，不是"工业品/日用品"维度。 |
| **目标状态** | 报表可按"工业订单"和"日用品订单"拆分统计。可选择剔除电商平台的订单。 |
| **涉及文件** | **前端**：`frontend/web-admin/src/views/ReportsPage.vue`（增加订单类型过滤）；**后端**：`backend/app/repositories/report_repository.py`（增加按 `order_type` 过滤）、`backend/app/api/reports.py`（增加查询参数）|
| **实现方案** | **后端层**：<br>① `report_repository.py` 的查询方法增加 `order_type` 过滤条件<br>② `reports.py` API 增加 `order_type` 查询参数（值：`industry`/`daily`/空）<br>③ 返回数据中增加按订单类型分组的金额汇总<br><br>**前端层**：<br>① 过滤工具栏增加"订单类型"下拉选择（全部/工业订单/日用品订单）<br>② 结果表格中增加订单类型列或按类型拆分的金额列<br>③ 保留现有的"排除电商订单"复选框 |
| **验证标准** | ① 选择"工业订单"后只统计工业订单数据；② 选择"日用品订单"后只统计日用品订单数据；③ 勾选"排除电商"后电商订单被剔除；④ 两种过滤条件可组合使用 |
| **完成情况** | ✅ `ReportsPage.vue:79-83` 已有订单类型下拉（全部/工业订单/日用品订单），行86-87 已有"剔除电商订单"复选框，`filters.order_type` 和 `filters.exclude_ecommerce` 已在查询参数中 |
---
#### 任务 18：报表展示每个订单的详细信息 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 报表只展示按时间段汇总的数据（每月一行），无法看到每个订单的详细信息 |
| **目标状态** | 报表中可以展开查看每个时间段内所有订单的详细信息 |
| **涉及文件** | `frontend/web-admin/src/views/ReportsPage.vue`（增加行展开功能）、`backend/app/api/reports.py`（增加订单明细接口）、`backend/app/repositories/report_repository.py`（查询逻辑）|
| **实现方案** | **方案A（行展开）**：<br>① 结果表格每行可展开，展开后显示该时间段内所有订单的明细列表<br>② 明细列：订单号、客户、产品、金额、利润、提成、订单类型、创建时间<br>③ 后端新增 `GET /api/reports/performance/details?period=xxx&start_date=xxx&end_date=xxx` 接口<br><br>**方案B（独立明细表）**：<br>① 在报表下方增加"订单明细"表格，展示当前过滤条件下的所有订单<br>② 支持排序和导出<br><br>推荐方案A，交互更清晰。 |
| **验证标准** | ① 点击时间段行可展开查看该时段所有订单；② 订单明细包含完整的订单信息；③ 展开的数据受当前过滤条件影响 |
| **完成情况** | ✅ `ReportsPage.vue:122-170` 已实现行展开功能（点击行切换 `expandedRow`），展开后显示子表格（订单号/客户/产品/数量/金额/利润/提成/类型/日期），行123 有展开图标切换 |
---
### 2.3 后台配置修复
#### 任务 19：修复配置保存后刷新丢失的问题（BUG FIX）✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 用户在后台配置页面修改配置（如将提醒方式改为微信提醒）后保存，刷新页面配置恢复为默认值 |
| **目标状态** | 配置修改后持久化保存，重启应用或刷新页面后配置值不变 |
| **根本原因** | `backend/scripts/bootstrap_data.py` 的 `seed_configs` 函数在每次应用启动时，对已存在的配置项**无条件覆盖** `config_value` 为默认值 |
| **涉及文件** | `backend/scripts/bootstrap_data.py`（核心修复）、`backend/app/startup/db_init.py`（可选优化）|
| **实现方案** | **修复 `seed_configs` 函数**（`bootstrap_data.py` 第153-164行）：<br>```python<br>def seed_configs(session) -> None:<br> for item in DEFAULT_CONFIGS:<br> existed = session.execute(<br> select(SystemConfig).where(<br> SystemConfig.config_key == item["config_key"]<br> )<br> ).scalar_one_or_none()<br> if existed is None:<br> session.add(SystemConfig(**item))<br> continue<br> # 只更新元数据，不覆盖用户修改过的 config_value 和 status<br> existed.config_name = item["config_name"]<br> existed.remark = item.get("remark")<br>```<br>关键改动：删除 `existed.config_value = item["config_value"]` 和 `existed.status = item.get("status", 1)` 这两行。只在新记录不存在时插入默认值。 |
| **验证标准** | ① 修改配置后保存，刷新页面配置值不变；② 重启应用后配置值不变；③ 新增的配置项在首次启动时正确初始化 |
| **完成情况** | ✅ `bootstrap_data.py:153-166` 已修复。`seed_configs` 函数现在仅在配置不存在时插入默认值（行160-162），已存在的配置只更新 `config_name` 和 `remark`（行164-165），不覆盖 `config_value` 和 `status` |
---
## 三、司机小程序端
#### 任务 20：司机任务详情页面修改 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 任务详情页显示取货地址和送达地址；"工厂"标签为"工厂"；照片标签为"现场照片"；运单信息为必选 |
| **目标状态** | ① 去掉取货地址和送达地址（司机直接去工厂取货）；② "工厂"改为"取件工厂"；③ "现场照片"改为"货物照片"；④ "运单信息"改为非必选 |
| **涉及文件** | `frontend/mini-app/pages/driver/task-detail/task-detail.wxml`、`frontend/mini-app/pages/driver/task-detail/task-detail.js` |
| **实现方案** | **WXML 修改**：<br>① 删除或隐藏取货地址和送达地址的展示区域（地址卡片区域约第22-38行）<br>② 将"工厂"文字改为"取件工厂"（约第46行）<br>③ 将"现场照片"文字改为"货物照片"（约第98行）<br><br>**JS 修改**：<br>④ 将运单信息的 `needWaybill` 标记改为 `false`，或在确认揽货时移除运单必填校验<br>⑤ 保留运单信息的录入功能，但改为可选 |
| **验证标准** | ① 页面不再显示取货/送达地址；② 工厂标签显示为"取件工厂"；③ 照片标签显示为"货物照片"；④ 不填写运单信息也可以确认揽货 |
| **完成情况** | ✅ `task-detail.wxml:29` 已改为"取件工厂"，行81 已改为"货物照片"。取货/送达地址已移除（无地址卡片区域）。运单信息在 `accepted` 状态下才显示（行47），为可选项 |
---
## 四、管理员小程序端
#### 任务 21：小程序登录持久化 ✅ 已完成
| 项目 | 内容 |
|------|------|
| **当前状态** | 每次打开小程序都需要重新登录。`auth.js` 使用 `wx.setStorageSync` 保存 token，`app.js` 的 `onLaunch` 会恢复 token，但 `checkLogin` 在每次页面 `onShow` 时检查，可能因 token 过期或其他原因导致频繁重新登录。 |
| **目标状态** | 用户只登录一次，之后打开小程序自动使用已保存的登录信息 |
| **涉及文件** | `frontend/mini-app/utils/auth.js`、`frontend/mini-app/app.js`、`frontend/mini-app/pages/login/login.js`、`frontend/mini-app/pages/my/my.js`（及其他页面的 `onShow` 中的 `checkLogin` 调用）|
| **实现方案** | **方案**：<br>① `auth.js` 中增加 token 有效期存储：登录成功时保存 `expires_at`（当前时间 + token有效期）<br>② `isLoggedIn()` 改为：检查 token 存在且未过期<br>③ `app.js` 的 `onLaunch` 中：如果 token 存在且未过期，直接设置 `globalData.authToken`，不跳转登录页<br>④ 各页面的 `checkLogin` 调用改为：只有在 `isLoggedIn()` 返回 false 时才跳转登录页<br>⑤ API 请求的 401 响应处理：清除本地 token + 跳转登录页（在 `request.js` 中统一处理）<br>⑥ 后端 `auth_service.py` 确认 token 有效期是否足够长（建议30天以上） |
| **验证标准** | ① 首次登录后关闭小程序再打开，无需重新登录；② token 过期后自动跳转登录页；③ 网络请求返回 401 时自动跳转登录页 |
| **完成情况** | ✅ `auth.js` 已实现完整方案：`TOKEN_EXP_KEY` 存储过期时间（行8），`setToken` 接收 `expiresInSeconds` 参数并计算过期时间戳（行14-21），`isLoggedIn` 检查 token 是否过期（行36-47），过期自动调用 `logout` 清理 |
---
#### 任务 22：小程序审批页面改为订单详情页 ❌ 未完成（与任务15合并）
| 项目 | 内容 |
|------|------|
| **当前状态** | 小程序有独立的审批列表（`approve-list`）和审批详情（`approve-detail`）页面 |
| **目标状态** | 审批页面直接改为订单详情页面，与网页端的订单详情页面保持一致 |
| **涉及文件** | `frontend/mini-app/pages/manager/approve-detail/approve-detail.js`、`frontend/mini-app/pages/manager/approve-detail/approve-detail.wxml`（重命名为 order-detail 或大幅扩展）|
| **实现方案** | ① 将 `approve-detail` 页面扩展为完整的订单详情页面<br>② 增加以下内容（对齐网页端 `OrdersPage.vue` 的 Drawer 内容）：<br> - 基本信息（订单号、来源、发货方式、业务员、工厂、创建时间、备注）<br> - 产品明细表格<br> - 客户收货信息<br> - 财务结算信息<br> - 审批记录时间线<br> - 物流信息（如有）<br> - 审批操作模块（仅管理员可见，仅待审批状态显示）<br>③ 更新页面标题为"订单详情" |
| **验证标准** | ① 小程序订单详情展示的信息量与网页端一致；② 审批操作在订单详情页底部可完成；③ 页面标题为"订单详情" |
| **完成情况** | ❌ **未实现，建议与任务15合并实施**。`approve-detail.wxml` 标题仍为"审批详情"，内容仅为利润摘要+费用明细+产品列表+收货地址。保持现有页面路径不变（避免改动路由和跳转），只更新标题和内容为最优方案 |
---
#### 任务 23：小程序"我的"页面修复 ⚠️ 部分完成
| 项目 | 内容 |
|------|------|
| **当前状态** | ① "我的"页面没有底部导航栏；② 页面中有"下发工厂"和"分配任务"菜单项（已不需要）；③ 管理员统计数据不完整（approved/rejected 始终为0） |
| **目标状态** | ① "我的"页面有底部导航栏；② 去掉"下发工厂"和"分配任务"选项；③ 统计数据正确显示 |
| **涉及文件** | `frontend/mini-app/pages/my/my.js`、`frontend/mini-app/pages/my/my.wxml`、`frontend/mini-app/app.json`（tabBar配置）|
| **实现方案** | **底部导航栏**：<br>① 确认 `app.json` 的 `tabBar` 配置中是否包含"我的"页面路径。如果页面路径不在 tabBar.list 中，需要添加。或检查自定义 tabBar 组件（`custom-tab-bar`）是否正确渲染。<br><br>**去掉多余菜单**：<br>② `my.wxml` 中删除"下发工厂"和"分配任务"两个菜单项<br><br>**修复统计数据**：<br>③ `my.js` 的 `loadManagerStats` 中，除了查询总数外，增加查询今日已审批和已驳回的订单数<br>④ 调用 `GET /api/orders?order_status=approved&start_date=today&end_date=today` 获取今日审批数<br>⑤ 调用 `GET /api/orders?order_status=rejected&start_date=today&end_date=today` 获取今日驳回数 |
| **验证标准** | ① "我的"页面底部有导航栏；② 不再显示"下发工厂"和"分配任务"菜单；③ 管理员统计数据正确显示今日审批/驳回/总数 |
| **完成情况** | ⚠️ **底部导航栏已修复**：`app.json:28` tabBar.list 已包含 `pages/my/my`（"我的"标签）。**菜单已清理**：`my.wxml` 中无"下发工厂"和"分配任务"菜单项。**统计数据待确认**：`my.wxml:31-46` 已有"今日已审批"、"今日已退回"、"累计订单"三个统计卡片，但需确认 `my.js` 中 `loadManagerStats` 的 API 调用是否正确查询了今日数据 |
---
## 五、实施优先级建议
### P0 - 紧急修复（影响核心功能）
| 序号 | 任务 | 状态 | 原因 |
|------|------|------|------|
| 19 | 配置保存丢失 BUG | ✅ 已完成 | 用户修改配置后丢失，严重影响信任度 |
| 21 | 小程序登录持久化 | ✅ 已完成 | 每次重新登录严重影响使用体验 |
### P1 - 重要功能（核心业务流程优化）
| 序号 | 任务 | 状态 | 原因 |
|------|------|------|------|
| 14 | 审批融入订单详情 | ⚠️ 部分完成 | 简化管理员操作流程，减少页面切换。**剩余**：移除审批中心入口、工作台改版、剪贴板复制、自发提示 |
| 16 | 待结算状态 | ✅ 已完成（后端待确认） | 影响提成结算的准确性 |
| 5 | 合同金额模块重构 | ✅ 已完成 | 影响订单分类和报表统计 |
| 6 | 物流信息前置录入 | ✅ 已完成（审批逻辑待确认） | 优化自发订单流程 |
| 22 | 小程序审批改订单详情 | ❌ 未完成 | 与网页端保持一致（合并任务15） |
### P2 - 功能增强
| 序号 | 任务 | 状态 | 原因 |
|------|------|------|------|
| 1 | 产品搜索 | ✅ 已完成 | 提升产品多时的录入效率 |
| 8 | 物流信息实时查询 | ❌ 未完成 | 提升物流状态可视化。**最大未完成项** |
| 12 | 客户编辑 | ✅ 已完成 | 补全客户管理功能 |
| 13 | 月结时间设置 | ✅ 已完成 | 支持灵活的结算规则 |
| 17 | 报表按类型拆分 | ✅ 已完成 | 支持业务分析 |
| 18 | 报表订单明细 | ✅ 已完成 | 支持数据下钻 |
| 23 | 小程序"我的"页面修复 | ⚠️ 部分完成 | 修复导航和统计问题 |
### P3 - 体验优化
| 序号 | 任务 | 状态 | 原因 |
|------|------|------|------|
| 2 | 成本核算提示 | ✅ 已完成 | 帮助业务员理解表单 |
| 3 | 计算逻辑展示 | ✅ 已完成 | 提升透明度 |
| 4 | 去掉含税金额输入 | ⚠️ 前端完成 | 简化表单（后端自动计算待确认） |
| 7 | 英文状态改中文 | ⚠️ 部分完成 | 消除语言障碍（需确认后端返回值） |
| 9 | 分页大小选择 | ✅ 已完成 | 提升列表操作体验 |
| 10 | 自定义时间段查询 | ✅ 已完成 | 提升数据分析灵活性 |
| 11 | 提醒信息改中文 | ⚠️ 部分完成 | 消除语言障碍（需确认后端提醒类型值） |
| 15 | 小程序审批对齐网页端 | ❌ 未完成 | 一致性（合并任务22） |
| 20 | 司机页面标签修改 | ✅ 已完成 | 文案优化 |
---
## 六、数据库变更汇总
需要执行的数据库变更：
| 变更 | 说明 | 影响表 | 状态 |
|------|------|--------|------|
| 新增 `order_type` 字段 | String(32)，值：`industry`/`daily` | `sales_order` | ✅ 已存在 |
| 新增 `self_delivery` 字段 | Boolean，默认 false | `sales_order` | ✅ 已存在 |
| 新增 `tracking_number` 字段 | String(128)，可空 | `sales_order` | ✅ 已存在 |
| 新增 `payment_channels` 配置项 | JSON数组 | `system_config` | 🔍 待确认是否已添加 |
| 新增 `pending_settle` 状态 | 状态机扩展 | 状态常量 | 🔍 待确认后端是否已支持 |
| 新增 `settlement_day_of_month` 字段 | Integer，可空 | `customer` | ✅ 已存在 |
| 新增 `reminder_day_of_month` 字段 | Integer，可空 | `customer` | ✅ 已存在 |
---
## 七、API 变更汇总
| 变更类型 | 端点 | 说明 | 状态 |
|----------|------|------|------|
| 新增 | `GET /api/logistics/trace-by-tracking` | 快递100物流查询 | ❌ 未实现 |
| 新增 | `POST /api/orders/{id}/settle` | 结算提成 | 🔍 待确认 |
| 新增 | `GET /api/reports/performance/details` | 报表订单明细 | 🔍 待确认 |
| 修改 | `GET /api/salesman/statistics` | 增加 `start_date`/`end_date` 参数 | 🔍 待确认 |
| 修改 | `GET /api/reports/performance` | 增加 `order_type` 参数 | 🔍 待确认 |
| 修改 | `POST /api/orders` | 增加 `order_type`/`self_delivery`/`tracking_number` 字段 | ✅ 前端已传参 |
| 修改 | `PUT /api/orders/{id}` | 增加 `order_type`/`self_delivery`/`tracking_number` 字段 | 🔍 待确认 |
| 修改 | `POST /api/orders/{id}/approve` | 支持自发订单跳过工厂下发 | 🔍 待确认 |
---
## 八、后续更新计划
### 第一轮（优先级最高）
| 任务 | 说明 | 预计工作量 |
|------|------|------------|
| **任务14** 审批中心融入 | 移除侧边栏审批中心入口，工作台改版为待审批快捷列表，审批通过增加剪贴板复制和自发提示 | 1天 |
| **任务8** 物流实时查询 | 后端新增按 tracking_number 查询端点，前端列表对接快递100 API，超时红色标记 | 1天 |
### 第二轮
| 任务 | 说明 | 预计工作量 |
|------|------|------------|
| **任务15+22** 小程序审批页 | 扩展 approve-detail 页面为完整订单详情，增加工厂/司机选择，与网页端对齐 | 1天 |
| **任务4** 含税金额后端 | 确认后端 `tax_amount` 自动计算逻辑，必要时修改 `order_service.py` | 0.5天 |
### 第三轮（验证与微调）
| 任务 | 说明 | 预计工作量 |
|------|------|------------|
| **任务7** 状态中文 | 确认后端返回值，必要时前端改为使用 `mapOrderStatus` | 0.5天 |
| **任务11** 提醒中文 | 确认后端提醒类型值，必要时添加前端映射 | 0.5天 |
| **任务23** 统计确认 | 确认 my.js 的 loadManagerStats API 调用 | 0.5天 |
Reference in New Issue View Git Blame Copy Permalink