From 4e47386e5637c49085050844206ad2c9c6457f01 Mon Sep 17 00:00:00 2001 From: taiyi Date: Tue, 19 May 2026 18:44:47 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96=E4=B8=80=E4=B8=8B=E5=B1=A5?= =?UTF-8?q?=E7=BA=A6=E9=A1=B5=E9=9D=A2=E7=9A=84=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- frontend/web-admin/src/views/BusinessPage.vue | 388 +++++++++------- .../web-admin/src/views/MasterDataPage.vue | 35 +- frontend/web-admin/src/views/SystemPage.vue | 22 +- 未完成功能清单.md | 363 +++++++++++++++ 缺口定位清单.md | 431 ++++++++++++++++++ 5 files changed, 1059 insertions(+), 180 deletions(-) create mode 100644 未完成功能清单.md create mode 100644 缺口定位清单.md diff --git a/frontend/web-admin/src/views/BusinessPage.vue b/frontend/web-admin/src/views/BusinessPage.vue index 634cda7..ebc85d6 100644 --- a/frontend/web-admin/src/views/BusinessPage.vue +++ b/frontend/web-admin/src/views/BusinessPage.vue @@ -90,105 +90,135 @@ {{ message }} -
-
-
-

待发厂订单

- 仅展示已审批或待发厂订单 +
+
+
+

业务分层导航

+

所有核心操作都通过弹窗完成，主页面只保留入口与概览。

-

正在加载待发厂订单...

-
当前没有待发厂订单
-
- - - - - - - - - - - - - - - - - - - - - -
订单编号客户姓名状态订单来源金额操作
{{ row.orderNo }}{{ row.customerName }}{{ row.statusText }}{{ row.orderSource }}{{ row.amount }} - 详情 - - - -
+ 内容分层 +
+
+ + +
+
+ +
+
+
+
+

订单处理

+ 订单列表、发厂动作与创建司机任务都在这里处理 +
+ +
+
+
+
+

待发厂订单

+ 仅展示已审批或待发厂订单 +
+

正在加载待发厂订单...

+
当前没有待发厂订单
+
+ + + + + + + + + + + + + + + + + + + + + +
订单编号客户姓名状态订单来源金额操作
{{ row.orderNo }}{{ row.customerName }}{{ row.statusText }}{{ row.orderSource }}{{ row.amount }} + 详情 + + + +
+
+
+ +
+
+

创建司机任务

+ 从已确认发厂订单直接下发司机任务 +
+
+ + + + + + + + + +
+
+ +
+
+
-
-
-

创建司机任务

- 从已确认发厂订单直接下发司机任务 -
-
- - - - - - - - - -
-
- -
-
- -
-
-

司机任务列表

- 展示真实任务状态与创建结果 +
+
+
+
+

司机任务列表

+ 集中查看司机任务状态与创建结果 +
+

正在加载司机任务...

当前没有司机任务
@@ -203,6 +233,7 @@ 任务状态 提货内容 创建时间 + 操作 @@ -212,10 +243,11 @@ {{ row.driver_name }} {{ row.factory_name || "-" }} {{ mapTaskStatus(row.status) }} - {{ row.pickup_content }} + {{ row.pickup_content }} {{ row.created_at || "-" }} 详情 + - @@ -247,11 +279,10 @@ const actionLoading = ref(""); const creatingTask = ref(false); const message = ref(""); const messageType = ref("success"); -const filters = reactive({ - orderStatus: "", - taskStatus: "", -}); +const filters = reactive({ orderStatus: "", taskStatus: "" }); const latestTaskId = ref(null); +const showOrderModal = ref(false); +const showTaskModal = ref(false); const taskForm = reactive({ order_id: null, order_no: "", @@ -279,6 +310,19 @@ function canCreateTask(orderStatus) { return orderStatus === "pending_factory"; } +function openOrderModal() { + showOrderModal.value = true; +} +function openTaskModal() { + showTaskModal.value = true; +} +function closeOrderModal() { + showOrderModal.value = false; +} +function closeTaskModal() { + showTaskModal.value = false; +} + function resetTaskForm() { taskForm.order_id = null; taskForm.order_no = ""; @@ -300,6 +344,7 @@ function prepareTask(row) { taskForm.pickup_content = `${row.customerName} 订单货物`; taskForm.quantity = 1; taskForm.remark = "管理端调度创建"; + showTaskModal.value = true; message.value = `已带入订单 ${row.orderNo}，请确认司机任务信息后提交。`; messageType.value = "success"; } @@ -309,24 +354,16 @@ async function loadPendingOrders() { pendingOrders.value = filters.orderStatus ? data.rows.filter((item) => item.orderStatus === filters.orderStatus) : data.rows; isMock.value = Boolean(data.isMock); } - async function loadTasks() { const data = await fetchLogisticsTasks({ status: filters.taskStatus }); taskRows.value = data.rows; isMock.value = Boolean(data.isMock); } - async function refreshAll() { await Promise.all([loadPendingOrders(), loadTasks()]); } - -async function handleRefreshOrders() { - await loadPendingOrders(); -} - -async function handleRefreshTasks() { - await loadTasks(); -} +async function handleRefreshOrders() { await loadPendingOrders(); } +async function handleRefreshTasks() { await loadTasks(); } async function handleGenerateText(row) { actionLoading.value = `text-${row.orderId}`; @@ -342,16 +379,11 @@ async function handleGenerateText(row) { actionLoading.value = ""; } } - async function handleConfirmFactory(row) { actionLoading.value = `confirm-${row.orderId}`; message.value = ""; try { - await confirmSupplierText(row.orderId, { - supplier_id: 1001, - text_content: `订单 ${row.orderNo} 请安排生产与发货`, - remark: "管理端确认发厂", - }); + await confirmSupplierText(row.orderId, { supplier_id: 1001, text_content: `订单 ${row.orderNo} 请安排生产与发货`, remark: "管理端确认发厂" }); await refreshAll(); message.value = `订单 ${row.orderNo} 已确认下发工厂，可继续创建司机任务。`; messageType.value = "success"; @@ -362,19 +394,11 @@ async function handleConfirmFactory(row) { actionLoading.value = ""; } } - async function handleCreateTask() { - if (!taskForm.order_id) { - message.value = "请先从待发厂订单中选择一笔订单"; - messageType.value = "error"; - return; - } + if (!taskForm.order_id) { message.value = "请先从待发厂订单中选择一笔订单"; messageType.value = "error"; return; } if (!taskForm.pickup_address.trim() || !taskForm.delivery_address.trim() || !taskForm.pickup_content.trim()) { - message.value = "请补全取货地址、送达地址和提货内容"; - messageType.value = "error"; - return; + message.value = "请补全取货地址、送达地址和提货内容"; messageType.value = "error"; return; } - creatingTask.value = true; message.value = ""; try { @@ -392,9 +416,7 @@ async function handleCreateTask() { await refreshAll(); message.value = `司机任务 ${result.task_no} 创建成功，订单已进入待司机接单状态。`; messageType.value = "success"; - if (result.task_id) { - message.value += ` 可点击任务详情继续查看。`; - } + if (result.task_id) message.value += " 可点击任务详情继续查看。"; resetTaskForm(); } catch (error) { message.value = error.message || "创建司机任务失败"; @@ -415,56 +437,104 @@ onMounted(async () => { + \ No newline at end of file diff --git a/frontend/web-admin/src/views/MasterDataPage.vue b/frontend/web-admin/src/views/MasterDataPage.vue index d9cc1da..f2d8464 100644 --- a/frontend/web-admin/src/views/MasterDataPage.vue +++ b/frontend/web-admin/src/views/MasterDataPage.vue @@ -278,11 +278,11 @@
- - - + +
@@ -433,11 +433,11 @@
- - - + +
@@ -591,11 +591,11 @@
- - - + +
@@ -1423,7 +1423,8 @@ h2 { margin: 0 0 6px; font-size: 24px; } textarea, .link-btn, .ghost-btn, -.primary-btn { +.primary-btn, +.modal-close { border-radius: 12px; padding: 10px 12px; min-width: 0; @@ -1439,7 +1440,7 @@ textarea, background: #fff; } .primary-btn { border: 1px solid #2563eb; background: #2563eb; color: #fff; } -.ghost-btn { color: #334155; } +.ghost-btn { background: #f8fafc; color: #334155; } .toolbar-actions { display: flex; gap: 10px; align-items: end; flex-wrap: wrap; } .loading { margin: 0; color: #6b7280; } .empty-state { padding: 24px; border: 1px dashed #cbd5e1; border-radius: 16px; color: #64748b; text-align: center; background: #fff; } @@ -1459,23 +1460,25 @@ th { color: #334155; font-size: 13px; background: #f8fafc; } .modal-panel-wide { width: min(980px, 100%); } .detail-modal { width: min(860px, 100%); } .modal-mask { position: fixed; inset: 0; z-index: 50; display: flex; align-items: center; justify-content: center; padding: 24px; background: rgba(15, 23, 42, 0.48); backdrop-filter: blur(2px); } -.modal-panel { width: min(720px, 100%); max-height: min(85vh, 860px); overflow: auto; border-radius: 20px; border: 1px solid #dbe3ef; background: #fff; padding: 20px; box-shadow: 0 24px 80px rgba(15, 23, 42, 0.24); } +.modal-panel { width: min(760px, 100%); max-height: min(88vh, 860px); overflow: auto; border-radius: 20px; border: 1px solid #dbe3ef; background: #fff; padding: 24px; box-shadow: 0 24px 80px rgba(15, 23, 42, 0.24); } .modal-header { display: flex; justify-content: space-between; align-items: flex-start; gap: 12px; margin-bottom: 16px; } .modal-header h4 { margin: 0 0 6px; font-size: 18px; } .modal-header span { color: #64748b; font-size: 13px; } -.modal-close { width: 36px; height: 36px; border-radius: 999px; border: 1px solid #d1d5db; background: #f8fafc; font-size: 22px; line-height: 1; color: #334155; } +.modal-close { width: 36px; height: 36px; border: 1px solid #d1d5db; background: #f8fafc; font-size: 22px; line-height: 1; color: #334155; } .link-btn { color: #2563eb; cursor: pointer; } .link-btn:disabled { color: #9ca3af; background: #f3f4f6; cursor: not-allowed; } @media (max-width: 1200px) { - .toolbar-4, .toolbar-3 { grid-template-columns: repeat(2, minmax(0, 1fr)); } + .toolbar-4, .toolbar-3, .toolbar-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); } .toolbar-actions { grid-column: 1 / -1; } + .modal-panel, .detail-modal, .modal-panel-wide { width: min(100%, 760px); } } @media (max-width: 768px) { - .page-header, .panel-header { flex-direction: column; align-items: stretch; } + .page-header, .panel-header, .action-row.split { flex-direction: column; align-items: stretch; } .toolbar, .form-grid, .detail-grid, .toolbar-2, .toolbar-3, .toolbar-4 { grid-template-columns: 1fr; } - .modal-panel { padding: 16px; } + .modal-mask { padding: 12px; } + .modal-panel, .detail-modal, .modal-panel-wide { width: 100%; max-height: 92vh; padding: 18px; } table { min-width: 780px; } } diff --git a/frontend/web-admin/src/views/SystemPage.vue b/frontend/web-admin/src/views/SystemPage.vue index 0e6e6bc..de15139 100644 --- a/frontend/web-admin/src/views/SystemPage.vue +++ b/frontend/web-admin/src/views/SystemPage.vue @@ -1236,15 +1236,26 @@ h2 { margin: 0 0 6px; font-size: 24px; } .form-grid select, textarea, .ghost-btn, -.link-btn { - border: 1px solid #cbd5e1; +.link-btn, +.primary-btn, +.modal-close { border-radius: 12px; padding: 10px 12px; + min-width: 0; +} +.toolbar input, +.toolbar select, +.form-grid input, +.form-grid select, +textarea, +.ghost-btn, +.link-btn { + border: 1px solid #cbd5e1; background: #fff; } .primary-btn { border: 1px solid #2563eb; background: #2563eb; color: #fff; } .ghost-btn { background: #f8fafc; color: #334155; } -.toolbar-actions { display: flex; gap: 10px; align-items: end; } +.toolbar-actions { display: flex; gap: 10px; align-items: end; flex-wrap: wrap; } .loading { margin: 0; color: #6b7280; } .empty-state { padding: 24px; border: 1px dashed #cbd5e1; border-radius: 16px; color: #64748b; text-align: center; background: #fff; } .table-wrap { overflow-x: auto; } @@ -1257,12 +1268,13 @@ th { color: #334155; font-size: 13px; background: #f8fafc; } .action-row.split { justify-content: space-between; align-items: center; } .inline-actions { display: flex; gap: 10px; flex-wrap: wrap; } .modal-mask { position: fixed; inset: 0; z-index: 50; display: flex; align-items: center; justify-content: center; padding: 24px; background: rgba(15, 23, 42, 0.48); backdrop-filter: blur(2px); } -.modal-panel { width: min(720px, 100%); max-height: min(85vh, 860px); overflow: auto; border-radius: 20px; border: 1px solid #dbe3ef; background: #fff; padding: 20px; box-shadow: 0 24px 80px rgba(15, 23, 42, 0.24); } +.modal-panel { width: min(760px, 100%); max-height: min(88vh, 860px); overflow: auto; border-radius: 20px; border: 1px solid #dbe3ef; background: #fff; padding: 24px; box-shadow: 0 24px 80px rgba(15, 23, 42, 0.24); } .modal-panel-wide { width: min(980px, 100%); } +.detail-modal { width: min(860px, 100%); } .modal-header { display: flex; justify-content: space-between; align-items: flex-start; gap: 12px; margin-bottom: 16px; } .modal-header h4 { margin: 0 0 6px; font-size: 18px; } .modal-header span { color: #64748b; font-size: 13px; } -.modal-close { width: 36px; height: 36px; border-radius: 999px; border: 1px solid #d1d5db; background: #f8fafc; font-size: 22px; line-height: 1; color: #334155; } +.modal-close { width: 36px; height: 36px; border: 1px solid #d1d5db; background: #f8fafc; font-size: 22px; line-height: 1; color: #334155; } .permission-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; } .permission-item { display: grid; gap: 4px; padding: 12px; border: 1px solid #dbe3ef; border-radius: 14px; background: #f8fbff; } .permission-item small { color: #64748b; } diff --git a/未完成功能清单.md b/未完成功能清单.md new file mode 100644 index 0000000..4d38576 --- /dev/null +++ b/未完成功能清单.md @@ -0,0 +1,363 @@ +# 未完成功能清单 + +> 说明：本清单基于《确定版需求说明书.md》《开发细节/》系列文档，并结合当前系统代码扫描结果，从“需求应有能力”与“现有代码实现”两侧做差集整理。这里把“未完成”定义为：需求已明确、文档已细化，但当前代码中缺少实现、只做了占位、只实现了部分链路、或实现与需求存在明显偏差的功能。 + +--- + +## 1. 结论摘要 + +当前系统已经覆盖了订单、客户、产品、工厂、司机任务、提醒、报表、配置、审计、系统用户与角色菜单等主干模块，但**仍有不少关键能力处于“半成品”或“缺失”状态**。 + +最核心的未完成项集中在以下几类： + +1. **订单流程未闭环**：提交、审批、取消、确认下发工厂、司机履约之间的状态和数据联动还不完整。 +2. **权限与字段隔离不完整**：部分端/角色的字段可见性、数据范围、按钮权限仍有缺口。 +3. **系统管理不完整**：菜单、角色、用户、授权虽已存在，但分页、筛选、CRUD 完整性仍不足。 +4. **物流、AI、提醒、报表等高级能力大多为“有接口壳、缺实际业务联动”**。 +5. **数据库级、审计级、配置级要求尚未完全落实到代码行为中**。 + +--- + +## 2. 按需求域整理的未完成功能 + +### 2.1 登录鉴权与权限体系 + +#### 未完成项 + +- **角色登录态与菜单/按钮权限的完整联动不足** + - 需求要求登录后返回 `menus`、`permissions`，并由前端动态控制页面入口和按钮权限。 + - 当前代码里有登录和权限校验，但从端到端看，权限菜单树、按钮权限、角色授权后的即时生效链路仍不够完整。 + +- **权限体系存在“接口有了，细粒度控制未完全落地”的问题** + - 例如订单详情、列表、司机任务详情等接口在需求中要求按角色隐藏不同字段，但目前更多是业务员端做了简单过滤，其他端的字段隔离与页面级按钮联动还不充分。 + +- **管理员/管理层/业务员/司机的角色能力边界尚未完全收敛** + - 需求里每个角色的可见范围、可操作范围定义较明确，但当前实现中仍可能存在接口共享、前端页面复用过宽的情况。 + +--- + +### 2.2 系统用户、角色、菜单管理 + +#### 未完成项 + +- **用户管理的分页、筛选与完整 CRUD 仍不完整** + - 目前代码中已有用户列表、新增、更新、重置密码，但列表分页是由外层切片实现，接口层未形成完整分页查询能力。 + - 删除、停用/启用切换等操作在需求中被提到，但代码层未形成完整闭环。 + +- **角色管理缺少完整生命周期操作** + - 目前可新增、更新、授权菜单，但缺少更完整的角色停用/启用流程与异常约束的全量实现。 + +- **菜单管理未完全覆盖需求字段** + - 需求细化中提到 `icon`、`sort_no`、`status`、多级菜单等能力；现有实现虽有菜单树，但仍偏基础。 + +- **角色授权后的“权限码 + 菜单树”同步返回与前端刷新机制不完整** + - 需求要求授权后登录刷新生效，但代码层没有看到完整的权限缓存刷新、会话失效或即时同步机制。 + +--- + +### 2.3 客户管理 + +#### 未完成项 + +- **客户导入能力未见完整代码闭环** + - 需求要求支持导入模板、去重、重复提示、失败行返回等。 + - 当前代码里客户创建、列表、详情有实现，但导入链路在代码中没有看到完整接口/服务实现。 + +- **客户去重规则未完全按“姓名 + 手机号”强约束落地** + - 需求明确要求以“姓名 + 手机号”做重复校验，并用于新客户自动同步。 + - 代码在订单创建时会查找客户，但是否在所有客户新增/导入路径统一强校验，还不完整。 + +- **月结信息、欠款信息的维护和展示不完整** + - 客户资料中要求有结算方式、账期起算口径、欠款金额等字段。 + - 现有实现中可见基础字段，但围绕欠款、结算模式、账期配置的管理页面与联动还不完整。 + +--- + +### 2.4 产品与产品分类管理 + +#### 未完成项 + +- **产品分类独立管理虽已出现接口痕迹，但整体功能仍不完整** + - 需求明确要有独立 `product_category` 及其维护页面。 + - 目前代码虽出现产品分类相关 API，但前端页面、联动选择、停用约束、导入/展示等未形成完整闭环。 + +- **产品状态对订单下单的约束不足** + - 需求测试中要求禁用产品不可下单。 + - 当前代码中未见订单创建时对产品启用状态、分类状态的完整校验链路。 + +- **产品快照机制未完全前置到所有场景** + - 需求要求订单明细保存名称、规格、单位快照，历史订单不随产品变化。 + - 当前订单明细读取已有快照字段，但产品维护、价格变更、分类变更后的历史一致性校验仍不完整。 + +--- + +### 2.5 工厂/供应商管理与下发文本 + +#### 未完成项 + +- **工厂下发文本的“生成 + 确认 + 留痕”链路未完全闭环** + - 需求要求审批通过后生成可复制文本，且需要确认下发、记录文本日志。 + - 当前 `get_supplier_text` / `confirm_supplier_text` 已有基础实现，但： + - 下发文本历史记录表的实际持久化链路不完整； + - 按不同工厂模板生成内容的规则还偏简单； + - “复制文本体验”前端未完全落实。 + +- **工厂模板类型的业务差异未完全实现** + - 需求强调不同工厂可有不同模板，但本期以文本复制为主。 + - 当前实现多为统一模板拼接，模板可配置性不足。 + +--- + +### 2.6 销售订单录入、提交、审批 + +#### 未完成项 + +- **订单创建接口与需求字段存在明显缺口** + - 需求要求订单录入包括客户、物流、回扣、费用、订单明细等完整结构。 + - 当前创建接口虽然支持核心字段，但很多需求中的派生字段、校验细节、权限字段和审核前信息展示仍不完整。 + +- **订单编辑/草稿保存的完整能力未完全实现** + - 需求中明确有“保存草稿”“编辑草稿”“保存并提交”等页面操作。 + - 代码目前主要看到创建、提交、取消、审批，缺少完整的更新/编辑接口和前端联动。 + +- **订单提交审核的完整校验不充分** + - 需求要求提交时检查明细完整性、客户匹配、新客户入库、状态流转、通知等。 + - 当前已实现基础提交，但订单完整性校验和通知联动不全面。 + +- **审批页所需的利润计算过程展示未完全落地** + - 需求要求管理层审批时看到利润、利润率以及计算过程。 + - 当前接口能返回结果值，但“计算过程明细”和页面级展示还未完整实现。 + +- **审批退回后的业务员通知未完整落地** + - 需求明确要求退回后通知业务员。 + - 代码中有审计写入，但通知中心/消息推送联动不完整。 + +- **订单取消的特殊审批逻辑未完全实现** + - 需求要求：草稿、待审核直接取消；已通过后需何总确认；履约阶段走特殊审批。 + - 当前实现中有 `cancel_pending`，但特殊审批规则、履约中分支和状态恢复链路还不够完整。 + +- **取消原因/意见/前状态的审计留痕不够完整** + - 数据库设计要求保存取消前状态、申请人、申请时间等。 + - 代码有部分字段更新，但与取消审批、恢复状态、日志完整链路仍未完全闭环。 + +- **订单状态机仍是“部分可改状态”，不是完整流程驱动** + - 需求中状态流转非常明确。 + - 当前代码允许通过一个通用状态变更接口改到多个状态，但缺少严密的状态机约束与自动联动。 + +- **订单通知规则未完整实现** + - 需求要求订单状态变化时相关角色收到通知。 + - 目前只有订单事件写审计，未见完整消息通知写入、推送或站内信列表。 + +--- + +### 2.7 司机任务管理与履约 + +#### 未完成项 + +- **司机任务的创建、分配与订单状态联动不完整** + - 需求要求管理层或后台创建任务，订单审批后进入司机接单环节。 + - 目前虽有物流任务相关模块，但任务创建的完整接口、分配策略与状态联动还不充分。 + +- **司机任务列表/详情的可见性控制未完全细化** + - 需求要求司机仅能看取货地址、取件内容、数量、工厂、部分业务员信息。 + - 当前已有脱敏思路，但司机端显示字段、接口过滤与页面控制并未完全统一。 + +- **司机接单、揽货、送达的业务约束不完整** + - 需求要求： + - 接单后才能揽货； + - 揽货需图片上传； + - 提交前可撤回，提交后不可撤回； + - 送达后更新任务和订单状态。 + - 当前代码可能存在基本状态流转，但“提交前可撤回、提交后不可撤回”与图片必填约束还未完整闭环。 + +- **COS/OSS 图片存储与附件管理未完全统一** + - 需求对图片上传、附件元数据、存储路径、类型有明确约束。 + - 当前文件服务存在，但司机揽货上传、附件表、对象存储元信息的统一落实仍不足。 + +- **微信订阅消息通知未实现** + - 需求明确提到通过微信订阅消息通知相关人员。 + - 当前没有看到实际推送实现。 + +--- + +### 2.8 物流与 AI 辅助识别 + +#### 未完成项 + +- **物流轨迹对接快递100的完整实现未落地** + - 需求要求物流信息对接快递100接口。 + - 当前代码更像是手动维护/查询轨迹的雏形，第三方对接、失败重试、节点同步尚未完整。 + +- **物流超时提醒的“一次性提醒”策略未完全实现** + - 需求要求首个物流节点超过 2 天无流转仅提醒一次。 + - 目前提醒模块存在，但是否按“首节点 + 仅一次 + 去重”规则执行，还需补齐。 + +- **AI 图片识别链路不完整** + - 需求要求：AI 仅做辅助识别，保留原始结果与人工修正结果。 + - 当前已有 AI 接口和记录思路，但： + - OCR/识别结果人工确认界面未完全实现； + - 相似订单人工判断流程未完全实现； + - 原始结果与修正结果的可追踪展示不够完整。 + +- **识别失败、置信度过低、结果冲突的人工兜底流程未闭环** + - 需求强调最终由人工确认。 + - 目前更多是接口层记录，缺少业务流程层兜底。 + +--- + +### 2.9 提醒中心、欠款提醒、长时间未下单提醒 + +#### 未完成项 + +- **提醒中心页面与接口联动不完整** + - 需求中提醒中心应支持列表、查看、标记已读、筛选等。 + - 目前虽有提醒接口，但页面展示和状态流转未见完整实现。 + +- **欠款提醒的起算规则未完全落地** + - 需求允许按订单日期、对账日期、发货日期配置起算口径。 + - 现有代码中欠款同步逻辑存在，但不同口径切换与账期计算未完整实现。 + +- **欠款提醒“提醒对象为业务员”的规则未完全验证** + - 需要确保提醒分发给对应业务员，而不是泛化通知。 + - 当前缺少完整的接收人策略展示。 + +- **长时间未下单提醒的金额阈值和沉默周期配置未完全形成业务闭环** + - 需求要求低于金额阈值的小客户不纳入提醒。 + - 代码中配置接口和提醒接口有，但定时检查、筛选逻辑、重复提醒控制未完全看到。 + +--- + +### 2.10 业绩统计报表 + +#### 未完成项 + +- **报表口径统一还未完全消除差异** + - 需求要求按月/季/年、工业品/日用品拆分统计，剔除电商订单，支持提成核对。 + - 代码中已有报表接口，但分类映射、来源标签剔除、提成核对字段的完整统计口径仍需联调。 + +- **报表导出能力可能仍是简化版本** + - 需求要求支持导出文件，并与页面一致。 + - 目前可见报表接口和导出路径，但异步导出、文件持久化、权限控制和大数据量性能处理不足。 + +- **报表图表与明细维度未完全实现** + - 页面原型要求柱状图、折线图、表格等。 + - 代码中更多是数据接口层，前端图表表现仍需补齐。 + +--- + +### 2.11 配置管理 + +#### 未完成项 + +- **系统配置项仅覆盖基础字段，未形成统一配置中心体验** + - 需求要求支持物流超时、沉默客户周期、欠款起算、金额阈值、报表分类映射等。 + - 代码中有配置服务，但配置项的初始化、展示、编辑、即时生效和审计闭环未完全统一。 + +- **敏感配置的安全存储未完全体现** + - 例如 OSS、AI 凭证不应进入明文配置。 + - 当前代码层尚未完整体现环境变量/密钥管理策略。 + +--- + +### 2.12 审计日志 + +#### 未完成项 + +- **审计日志写入覆盖面仍不够全面** + - 需求要求所有新增、修改、删除、提交、审批、取消、接单、揽货、送达等关键操作都写日志。 + - 目前订单、系统用户、角色、菜单等有部分写入，但物流任务、提醒、导入、导出、AI 修正等关键动作未完全覆盖。 + +- **审计日志查询和前后值展示未完整落地** + - 需求要求能查看前后值差异。 + - 现有代码更偏基础查询，前后值 diff 展示与页面化浏览未完整实现。 + +--- + +### 2.13 前端各端页面 + +#### 未完成项 + +- **WEB 业务员端仍有较多页面是“能用但不完整”** + - 订单列表、录单、详情、提醒页有基础结构，但按钮状态、字段脱敏、草稿编辑、审批后文本复制等体验未完全落地。 + +- **WEB 管理后台的业务面板未完全覆盖需求页面** + - 用户、角色、菜单、客户、产品、工厂、订单、任务、提醒、报表、配置、审计等页面需要统一入口和联动。 + - 当前页面结构存在，但细节操作、分页筛选、批量导入、导出、权限控制仍有缺口。 + +- **微信小程序管理层端存在若干页面仅实现骨架** + - 审批列表、审批详情、取消审批、下发文本、任务创建、经营数据等页面基本存在，但与真实接口和业务规则的深度联动不足。 + +- **微信小程序司机端页面需要补齐“任务状态驱动 UI”** + - 任务列表、任务详情、接单、揽货、送达、附件上传等页面的状态控制还不够严谨。 + +--- + +## 3. 按“第一性原理”归纳的本质缺口 + +从第一性原理看，当前系统真正未完成的，不是“某几个按钮没做”，而是以下 6 个基础闭环还没完全建立： + +### 3.1 数据闭环未闭合 + +- 订单创建后，客户、产品、工厂、任务、附件、审计、提醒、报表之间的关联没有完全形成单一事实来源。 +- 许多模块是“各自能查”，但还没有做到“一个事件触发全链路更新”。 + +### 3.2 状态机未完全收敛 + +- 订单状态、任务状态、提醒状态、欠款状态、审批状态之间存在多个可变点。 +- 目前更像“允许改状态”，而不是“严格按状态机推进”。 + +### 3.3 权限隔离未完全落地 + +- 需求要求不同角色看到不同字段、不同按钮、不同菜单、不同数据范围。 +- 现在已有角色判断，但字段级、按钮级、行级的权限隔离还不彻底。 + +### 3.4 配置驱动未完全实现 + +- 需求中大量规则本应由配置驱动，例如提醒周期、欠款起算、报表分类、模板类型。 +- 当前仍有不少规则写死或半写死。 + +### 3.5 外部能力未完全接通 + +- 快递100、AI OCR、OSS、微信订阅消息等外部能力多数停留在接口壳或简化实现。 +- 真实生产可用需要：鉴权、失败重试、幂等、日志、降级、人工兜底。 + +### 3.6 体验层未完全收口 + +- 页面原型要求的可见字段、按钮时机、复制体验、导出体验、空态/错误态、权限态，还没有完全体现在前端。 + +--- + +## 4. 建议优先级 + +### P0：必须优先补齐 + +1. 订单编辑/草稿保存 +2. 订单取消特殊审批闭环 +3. 订单下发工厂文本日志化与确认闭环 +4. 司机任务创建、接单、揽货、送达状态联动 +5. 物流轨迹与超时提醒一次性去重 +6. 欠款生成口径与提醒对象规则 +7. 字段级权限与角色数据隔离 + +### P1：尽快补齐 + +1. 客户导入与去重 +2. 产品分类完整 CRUD +3. 审批退回通知 +4. AI 识别结果人工修正页面 +5. 报表口径统一与导出 +6. 配置中心完整化 + +### P2：体验与增强 + +1. 工厂文本复制体验优化 +2. 审计日志前后值展示 +3. 通知中心/消息中心 +4. 页面空态、加载态、错误态统一 +5. 报表图表化展示 + +--- + +## 5. 结语 + +如果把当前系统理解成一条业务流水线，那么现在已经有了“入口、若干节点、若干出口”，但**真正还没完全完成的是“状态驱动的完整闭环”**。建议后续优先围绕订单状态机、任务状态机、提醒状态机、权限隔离、配置驱动这五条主线补齐。 diff --git a/缺口定位清单.md b/缺口定位清单.md new file mode 100644 index 0000000..5cd28c9 --- /dev/null +++ b/缺口定位清单.md @@ -0,0 +1,431 @@ +# 缺口定位清单 + +> 说明：本清单基于《确定版需求说明书.md》《开发细节/》系列文档，并结合当前代码扫描结果，按“未完成项 → 具体文件 → 具体函数/页面位置”的方式定位。目的不是复述需求，而是明确“缺口落点在哪里”，方便后续逐项补齐。 + +--- + +## 1. 订单流程缺口 + +### 1.1 订单编辑 / 草稿保存已补齐部分闭环 + +- **当前状态**：已完成后端更新接口和服务层骨架，仍需继续补前端联动与更完整的状态校验。 +- **已落点文件**： + - `backend/app/api/orders.py` + - `backend/app/schemas/orders.py` + - `backend/app/services/order_service.py` + - `backend/app/repositories/order_repository.py` +- **已落点位置**： + - `backend/app/api/orders.py` 新增 `update_order()`，对应 `PUT /api/orders/{order_id}`。 + - `backend/app/schemas/orders.py` 新增 `UpdateOrderRequest`。 + - `backend/app/services/order_service.py` 新增 `OrderService.update_order()`，支持草稿/驳回单编辑。 + - `backend/app/repositories/order_repository.py` 新增 `update_order_with_items()`。 +- **仍待继续完善**： + - `frontend/web-sales/src/views/OrderFormPage.vue` + - `frontend/web-sales/src/views/OrdersPage.vue` + - `frontend/web-sales/src/views/OrderDetailPage.vue` +- **相关函数**： + - `OrderService.update_order()` + - `OrderRepository.update_order_with_items()` + - `OrderService.create_order()` + - `OrderService.submit_order()` + - `OrderService.cancel_order()` + +### 1.2 订单审批退回后的通知缺口 + +- **缺口描述**：需求要求审批退回后通知业务员；当前只有审批日志和审计日志，没有看到完整通知联动。 +- **定位文件**： + - `backend/app/services/order_service.py` + - `backend/app/services/reminder_service.py` + - `backend/app/api/reminders.py` +- **具体位置**： + - `OrderService.approve_order()` 里写了审批日志，但未触发提醒创建或消息推送。 + - `reminder_service` 目前只实现了欠款、沉默客户、物流超时三类提醒检查，没有订单审批通知入口。 +- **相关函数**： + - `OrderService.approve_order()` + - `ReminderService.check_all()` + - `ReminderService.list_reminders()` + +### 1.3 取消订单的特殊审批链路仍不完整 + +- **缺口描述**：需求要求草稿/待审直接取消，已通过/履约中进入 `cancel_pending`，并支持取消审批通过/驳回恢复原状态；当前逻辑有状态字段，但完整业务规则还不够严密。 +- **定位文件**： + - `backend/app/api/orders.py` + - `backend/app/services/order_service.py` + - `backend/app/repositories/order_repository.py` +- **具体位置**： + - `backend/app/services/order_service.py` 中 `cancel_order()`、`cancel_approve_order()` 已有基础实现，但对 `cancel_previous_status`、审批拒绝恢复、流程通知的闭环不完整。 + - `backend/app/api/orders.py` 中虽有 `/cancel` 与 `/cancel-approve`，但前端取消弹窗、审批页与状态机联动仍需补齐。 +- **相关函数**： + - `OrderService.cancel_order()` + - `OrderService.cancel_approve_order()` + - `OrderRepository.update_cancel_fields()` + +### 1.4 确认下发工厂文本的落库与留痕缺口 + +- **缺口描述**：需求要求生成工厂文本、复制、确认下发，并记录文本日志；当前接口返回文本和确认结果，但日志表/历史记录链路未完全形成闭环。 +- **定位文件**： + - `backend/app/api/orders.py` + - `backend/app/services/order_service.py` + - `backend/app/repositories/order_repository.py` + - `frontend/mini-manager/pages/supplier-text.js` +- **具体位置**： + - `OrderService.get_supplier_text()` 仅返回文本内容，没有看到明确写入 `order_supplier_text_log` 的持久化动作。 + - `OrderService.confirm_supplier_text()` 只更新订单状态，文本内容、模板类型、确认人/时间的完整日志留痕还不充分。 + - `frontend/mini-manager/pages/supplier-text.js` 需要对照确认下发流程做页面联动。 +- **相关函数**： + - `OrderService.get_supplier_text()` + - `OrderService.confirm_supplier_text()` + +### 1.5 订单状态机仍偏“手动改状态” + +- **缺口描述**：需求中的订单状态是严格流程型状态机；当前有通用状态变更接口，但校验和联动不足。 +- **定位文件**： + - `backend/app/services/order_service.py` + - `backend/app/api/orders.py` +- **具体位置**： + - `OrderService.change_order_status()` 允许多个目标状态直接切换，但没有严格限制状态路径。 + - `backend/app/api/orders.py` 的 `/status` 接口暴露了通用状态修改能力。 +- **相关函数**： + - `OrderService.change_order_status()` + +--- + +## 2. 司机任务与物流缺口 + +### 2.1 司机任务创建后订单联动已补齐部分闭环 + +- **当前状态**：已补充任务取消接口，并继续强化创建/接单/揽货/送达的状态联动与审计。 +- **已落点文件**： + - `backend/app/api/logistics.py` + - `backend/app/services/logistics_service.py` + - `backend/app/repositories/logistics_repository.py` + - `backend/app/models/business.py` +- **已落点位置**： + - `LogisticsService.create_task()`：创建任务后将订单状态切到 `pending_driver`。 + - `LogisticsService.accept_task()` / `pickup_task()` / `deliver_task()`：形成司机状态流转闭环。 + - `LogisticsService.cancel_task()`：新增任务取消入口，并回写订单状态。 + - `backend/app/api/logistics.py` 新增 `/api/logistics/tasks/{task_id}/cancel`。 + - `backend/app/models/business.py` 新增 `OrderSupplierTextLog` 之外的任务取消字段模型支撑。 +- **仍待继续完善**： + - `frontend/mini-manager/pages/task-create.js` + - `frontend/web-admin/src/views/BusinessPage.vue` + - `frontend/mini-driver/pages/task-list.js` + - `frontend/mini-driver/pages/task-detail.js` +- **相关函数**： + - `LogisticsService.create_task()` + - `LogisticsService.accept_task()` + - `LogisticsService.pickup_task()` + - `LogisticsService.deliver_task()` + - `LogisticsService.cancel_task()` + +### 2.2 司机端任务可见字段与权限隔离仍需加强 + +- **缺口描述**：司机只能看到本人任务和脱敏信息；目前有基础限制，但页面与接口的字段控制仍不完全统一。 +- **定位文件**： + - `backend/app/services/logistics_service.py` + - `backend/app/api/logistics.py` + - `frontend/mini-driver/pages/task-detail.js` + - `frontend/mini-driver/pages/task-list.js` +- **具体位置**： + - `LogisticsService._ensure_task_access()`、`LogisticsService._ensure_trace_access()` 已做基础权限控制。 + - `LogisticsService._map_task_detail()` 仍返回较多业务字段，司机端页面是否完全隐藏敏感字段需要继续核对。 +- **相关函数**： + - `LogisticsService._ensure_task_access()` + - `LogisticsService._ensure_trace_access()` + - `LogisticsService._map_task_detail()` + +### 2.3 物流轨迹第三方对接未完整上线 + +- **缺口描述**：需求提到快递100/第三方物流轨迹；当前代码仅保留了远程抓取能力，更多是占位式接入。 +- **定位文件**： + - `backend/app/services/logistics_service.py` + - `backend/app/repositories/logistics_repository.py` +- **具体位置**： + - `LogisticsService._load_third_party_traces()` + - `LogisticsService._fetch_remote_traces()` + - `LogisticsService.get_trace()` +- **相关函数**： + - `LogisticsService._fetch_remote_traces()` + - `LogisticsService._merge_trace_list()` + +### 2.4 司机揽货附件上传与 OSS 元数据未完全统一 + +- **缺口描述**：需求要求图片/视频上传到 OSS，写入附件元数据；当前已有附件写入，但字段级元数据与实际 OSS 约束仍需核对。 +- **定位文件**： + - `backend/app/services/logistics_service.py` + - `backend/app/services/file_service.py` + - `backend/app/api/files.py` +- **具体位置**： + - `LogisticsService._persist_task_attachments()` 将图片/视频落到附件表，但未完全看出对 `storage_provider`、`bucket_name`、`object_key` 的全链路使用。 + - `file_service` 负责附件封装，需核对是否满足需求中的 OSS 字段。 +- **相关函数**： + - `LogisticsService._persist_task_attachments()` + - `FileService.build_attachment_payload()` + +--- + +## 3. 提醒与配置缺口 + +### 3.1 提醒中心页面与接口联动已补齐 + +- **当前状态**：提醒列表筛选与已读操作已补齐前端联动，后端读接口已接通。 +- **已落点文件**： + - `backend/app/api/reminders.py` + - `backend/app/services/reminder_service.py` + - `frontend/web-sales/src/views/RemindersPage.vue` + - `frontend/web-sales/src/mockApi.js` +- **已落点位置**： + - `ReminderService.list_reminders()`、`ReminderService.read_reminder()` 已支持列表与已读闭环。 + - `frontend/web-sales/src/views/RemindersPage.vue` 已支持筛选和标记已读。 +- **相关函数**： + - `ReminderService.list_reminders()` + - `ReminderService.read_reminder()` + - `readReminder()` + +### 3.2 欠款生成与提醒口径未完全固化 + +- **缺口描述**：需求明确欠款按 `shipped/delivered` 配置生成，且提醒只生成一次；当前提醒逻辑有雏形，但需要和订单状态/欠款状态完全对齐。 +- **定位文件**： + - `backend/app/services/reminder_service.py` + - `backend/app/services/arrears_service.py` + - `backend/app/repositories/config_repository.py` + - `backend/app/api/configs.py` +- **具体位置**： + - `ReminderService.check_arrears()`、`check_inactive_customers()`、`check_logistics_timeout()` 有基本规则。 + - 配置读取依赖 `ConfigRepository.get_by_key()`，需要确认欠款起算、物流超时、沉默客户阈值已在所有业务点统一引用。 +- **相关函数**： + - `ReminderService.check_arrears()` + - `ReminderService.check_inactive_customers()` + - `ReminderService.check_logistics_timeout()` + - `ReminderService._get_config_value()` + +### 3.3 配置中心页面与即时生效闭环不足 + +- **缺口描述**：需求要求系统配置可视化管理并即时生效；当前后端有配置服务，但页面与缓存刷新未完全闭合。 +- **定位文件**： + - `backend/app/api/configs.py` + - `backend/app/services/config_service.py` + - `frontend/web-admin/src/views/SystemPage.vue` +- **具体位置**： + - `ConfigService` 负责读取/写入配置，但前端系统配置页是否覆盖全部配置项、是否支持联动刷新，还需继续补齐。 +- **相关函数**： + - `ConfigService.get_config()` + - `ConfigService.update_config()` + +--- + +## 4. 客户、产品、供应商缺口 + +### 4.1 客户导入接口未形成完整闭环 + +- **缺口描述**：需求要求客户导入、去重、失败返回；当前代码中客户创建和详情存在，但导入链路缺口明显。 +- **定位文件**： + - `backend/app/api/customers.py` + - `backend/app/services/customer_service.py` + - `frontend/web-admin/src/views/BusinessPage.vue` +- **具体位置**： + - `CustomerService` 需要核对是否存在批量导入函数；从当前代码扫描看，导入链路未形成完整页面与接口闭环。 +- **相关函数**： + - `CustomerService.create_customer()` + - `CustomerService.list_customers()` + - `CustomerService.get_customer()` + +### 4.2 产品分类独立维护未完全落地 + +- **缺口描述**：需求要求独立产品分类管理页面和接口；当前产品模块存在分类字段，但独立 CRUD 与前端页面还需补齐。 +- **定位文件**： + - `backend/app/api/products.py` + - `backend/app/services/product_service.py` + - `backend/app/repositories/product_repository.py` + - `frontend/web-admin/src/views/MasterDataPage.vue` +- **具体位置**： + - `ProductService` 负责产品列表/详情/创建，但分类独立维护能力仍需核对。 + - `frontend/web-admin/src/views/MasterDataPage.vue` 承担主数据页，分类管理是否完整展示需要补齐。 +- **相关函数**： + - `ProductService.list_products()` + - `ProductService.create_product()` + - `ProductService.get_product()` + +### 4.3 工厂/供应商模板类型差异未完全实现 + +- **缺口描述**：需求要求工厂模板类型可配置并参与下发文案生成；当前只有基础 supplier 管理。 +- **定位文件**： + - `backend/app/api/suppliers.py` + - `backend/app/services/supplier_service.py` + - `backend/app/repositories/supplier_repository.py` +- **具体位置**： + - `SupplierService` 负责供应商 CRUD，但模板类型、下发文本模板差异的业务规则需要继续确认。 +- **相关函数**： + - `SupplierService.list_suppliers()` + - `SupplierService.create_supplier()` + - `SupplierService.update_supplier()` + +--- + +## 5. 系统管理缺口 + +### 5.1 用户管理列表分页已补齐前端联动，后端仍保留简化分页 + +- **当前状态**：前端用户/角色/菜单管理页已接通真实接口；后端仍采用接口层切片分页，但已满足当前功能闭环。 +- **已落点文件**： + - `backend/app/api/system.py` + - `backend/app/services/system_service.py` + - `frontend/web-admin/src/views/SystemPage.vue` + - `frontend/web-admin/src/mockApi.js` +- **已落点位置**： + - `SystemPage.vue` 已支持用户、角色、菜单的查询、新增、编辑、授权、重置密码。 + - `mockApi.js` 已按真实接口路径完成联调封装。 +- **相关函数**： + - `SystemService.list_users()` + - `SystemService.list_roles()` + - `SystemService.list_menus()` + +### 5.2 用户停用/启用与重置密码以外的生命周期未完整 + +- **缺口描述**：需求要求用户、角色、菜单的停用启用、权限变更、异常约束完整；当前实现还偏基础。 +- **定位文件**： + - `backend/app/services/system_service.py` + - `backend/app/api/system.py` +- **具体位置**： + - `SystemService.create_user()`、`update_user()`、`reset_password()` 有实现，但用户停用/启用、批量操作等未完整。 + - `SystemService.update_role()` 已拦截管理员角色停用，但其他角色生命周期还需补齐。 +- **相关函数**： + - `SystemService.create_user()` + - `SystemService.update_user()` + - `SystemService.reset_password()` + - `SystemService.update_role()` + +### 5.3 菜单权限即时生效/缓存刷新缺口 + +- **缺口描述**：需求要求角色授权后菜单和按钮权限立即生效；当前代码能授权，但没有看到 token/缓存层的即时刷新。 +- **定位文件**： + - `backend/app/services/system_service.py` + - `backend/app/api/auth.py` + - `frontend/web-admin/src/store.js` +- **具体位置**： + - `SystemService.assign_role_menus()` 写库后未见缓存失效逻辑。 + - 登录后前端 store/路由刷新机制需继续核对。 +- **相关函数**： + - `SystemService.assign_role_menus()` + - `SystemService.get_role_menu_assignment()` + +--- + +## 6. 报表、审计、导出缺口 + +### 6.1 报表口径与导出前端闭环已接通，细分口径仍可继续优化 + +- **当前状态**：报表查询与导出接口已接通前端；口径统一已作为后续优化项保留。 +- **已落点文件**： + - `backend/app/api/reports.py` + - `backend/app/services/report_service.py` + - `backend/app/repositories/report_repository.py` + - `frontend/web-admin/src/views/ReportsPage.vue` + - `frontend/web-admin/src/mockApi.js` +- **已落点位置**： + - `ReportService.get_performance_report()` + - `ReportService.export_performance_report()` + - `fetchPerformanceReport()` + - `exportPerformanceReport()` +- **相关函数**： + - `ReportService.get_performance_report()` + - `ReportService.export_performance_report()` + +### 6.2 审计日志覆盖面已覆盖主要闭环，细节仍可继续增强 + +- **当前状态**：订单、物流、提醒、系统管理、报表导出均已具备审计写入；后续可继续扩展到更多细粒度场景。 +- **已落点文件**： + - `backend/app/services/audit_service.py` + - `backend/app/api/audit_logs.py` + - `backend/app/services/order_service.py` + - `backend/app/services/logistics_service.py` + - `backend/app/services/reminder_service.py` + - `backend/app/services/report_service.py` + - `backend/app/services/system_service.py` +- **已落点位置**： + - `OrderService.create_order()` / `approve_order()` / `cancel_order()` / `update_order()` + - `LogisticsService.create_task()` / `_persist_task_attachments()` / `cancel_task()` + - `ReminderService.read_reminder()` + - `ReportService.export_performance_report()` + - `SystemService.create_user()` / `update_user()` / `reset_password()` / `create_role()` / `update_role()` / `assign_role_menus()` / `create_menu()` / `update_menu()` +- **相关函数**： + - `audit_service.write_log()` 的各调用点 + +--- + +## 7. 前端页面缺口 + +### 7.1 业务员端订单编辑与提醒中心已补齐主要闭环 + +- **当前状态**：业务员端已支持订单新建、编辑、详情、提交、取消，以及提醒筛选和已读。 +- **已落点文件**： + - `frontend/web-sales/src/views/OrderFormPage.vue` + - `frontend/web-sales/src/views/OrdersPage.vue` + - `frontend/web-sales/src/views/OrderDetailPage.vue` + - `frontend/web-sales/src/views/RemindersPage.vue` +- **已落点位置**： + - 订单编辑/草稿保存按钮已接通更新链路。 + - 订单详情页已补充编辑入口。 + - 提醒中心已补充筛选、已读和状态展示。 + +### 7.2 管理后台主数据、业务、系统页已补入订单相关信息 + +- **当前状态**：管理后台已补入订单业务入口、订单详情入口和物流调度信息，不再只停留在客户/产品/系统配置层。 +- **已落点文件**： + - `frontend/web-admin/src/views/MasterDataPage.vue` + - `frontend/web-admin/src/views/SystemPage.vue` + - `frontend/web-admin/src/views/BusinessPage.vue` + - `frontend/web-admin/src/views/ReportsPage.vue` + - `frontend/web-admin/src/views/ApprovalDetailPage.vue` +- **已落点位置**： + - `BusinessPage.vue` 现可查看待发厂订单、订单详情入口、生成发厂文案、确认下发、创建司机任务，并支持订单/任务状态筛选。 + - `SystemPage.vue` 已覆盖用户、角色、菜单的查询、新增、编辑、授权、重置密码。 + - `ReportsPage.vue` 已接通真实导出查看入口。 + - `MasterDataPage.vue` 已新增订单快捷入口，客户详情可直达审批与履约。 + - `ApprovalDetailPage.vue` 已补充取消上下文、审批后去向说明及订单/履约/报表联动入口。 +- **仍待继续优化**： + - 主数据页的分类/产品细节与订单联动统计 + - 任务详情页与业务调度页的更深跳转联动 + +### 7.3 小程序管理层与司机端页面已接入主流程，仍可继续细化 + +- **当前状态**：管理层小程序和司机端已接入发厂文案、司机任务创建与执行主流程。 +- **定位文件**： + - `frontend/mini-manager/pages/approve-list.js` + - `frontend/mini-manager/pages/approve-detail.js` + - `frontend/mini-manager/pages/supplier-text.js` + - `frontend/mini-manager/pages/task-create.js` + - `frontend/mini-manager/pages/dashboard.js` + - `frontend/mini-driver/pages/task-list.js` + - `frontend/mini-driver/pages/task-detail.js` +- **仍待继续优化**： + - 按订单状态控制按钮显隐 + - 附件上传的错误提示与重试 + - 审批意见与取消上下文的展示密度 + +--- + +## 8. 可直接作为后续开发入口的优先文件 + +如果要按优先级补齐，建议先从以下文件开始： + +1. `backend/app/services/order_service.py` +2. `backend/app/api/orders.py` +3. `backend/app/services/logistics_service.py` +4. `backend/app/api/logistics.py` +5. `backend/app/services/reminder_service.py` +6. `backend/app/services/system_service.py` +7. `frontend/web-sales/src/views/OrderFormPage.vue` +8. `frontend/web-admin/src/views/SystemPage.vue` +9. `frontend/mini-manager/pages/supplier-text.js` +10. `frontend/mini-driver/pages/task-detail.js` + +--- + +## 9. 说明 + +本清单是“定位清单”，不是最终修复方案。下一步如果需要，我可以继续把这些缺口整理成： + +- **按 P0/P1/P2 排序的修复计划** +- **按文件拆分的改造任务卡** +- **按模块输出的逐项代码修改建议**