docs: hand off order driven configuration code acceptance
This commit is contained in:
1 parent
5f389d73c4
commit
690883f32b
5 files changed
+529
-6
No files matched your search
+5
-1
@@ -14,12 +14,16 @@
|
||||
|
||||
真实采样已扩为窗口待办、全部待办配置采样、已办/历史配置采样。当前31版本、11,523字段,配置流程28/29覆盖;缺零售国内返工订单更改评审,另三种零售流程名称不猜分类。31份草稿检查通过但未生效;历史不进入执行或通知。详情见[采样记录](field-sampling-verification-2026-10-20.md)。ZCode 项目内技能及固定卡片见[接入说明](zcode-field-mapping-skill.md),不安装个人技能、不开放原生工具。
|
||||
|
||||
本轮完整435项:434通过、0失败、1可选CLI跳过;211文件语法通过。正式状态已于10:36停服备份,更新后双端口、原登录、样本/草稿/密钥摘要及BPM会话内容核验通过。ZCode技能已加载,模型仍未配置,自动通知仍false。正式页面保留31个检查通过版本供人工核对。
|
||||
前轮字段映射交付完整435项:434通过、0失败、1可选CLI跳过;211文件语法通过。正式状态已于10:36停服备份,更新后双端口、原登录、样本/草稿/密钥摘要及BPM会话内容核验通过。ZCode技能已加载,模型仍未配置,自动通知仍false。正式页面保留31个检查通过版本供人工核对。
|
||||
|
||||
## 当前要求
|
||||
|
||||
[设计要求](design-requirements.md)是当前权威入口,[操作清单](web-action-inventory.md)记录页面动作、权限、前置条件、结果、失败路径与验收。
|
||||
|
||||
2026-10-20新增待开发设计:用户指出配置仍需手工选择,要求改为“选择真实订单后自动带出流程、节点、版本和业务参数”,人工只核对歧义。本轮只整理计划,未修改业务代码、配置或正式服务;在新对话开发。先读[交互设计](superpowers/specs/2026-10-20-order-driven-configuration-design.md)和[实施计划与新对话启动文本](superpowers/plans/2026-10-20-order-driven-configuration.md)。此条是计划,不代表已上线;既有采样可复用,历史缺节点仍不能猜测,保存/检查/生效/分类发布继续分开。实际界面、接口、测试和部署结果由后续开发验收更新。
|
||||
|
||||
2026-10-20实施交付:已在本工作树完成真实订单选择器、只读识别提案、字段高级修正、精确配对显式加入及分类内就地字段配置。字段生效后同步规则版本并保留未保存输入,同字段并发修改需逐项核对;目录只取摘要,高级区按需读取字段。ZCode项目技能为1.1.0,与页面共用推荐/提案服务。代码验收版本5f389d7:完整470项中469通过、0失败、1可选CLI跳过,227文件语法通过。实际测试与交付版本见[本轮代码验收](order-driven-configuration-verification-2026-10-20.md)。正式服务更新另行安排;未改正式数据、未发真实邮件或办理BPM。收尾发现正式进程也从本工作树运行,已确认首页引用新脚本而旧资源路由返回401,前端与运行后台混用,未重启不代表运行隔离;处理方式等待用户安排,详见验收文档。只读核实正式自动通知enabled:false、version:1,未修改开关。上段为规划记录,本段与验收文档说明实施状态。
|
||||
|
||||
- 七项侧栏,新增一级“订单通知管理”(总览、执行、通知订单、批次、发送记录、通知配置);业务设置仅规则/字段映射。所有模块接入 Tabler nav-segmented 圆角横栏,通知配置内为计划/日历/模板/发送设置。团队账号管理员可见;个人改密右上角。助手接入配置移到系统设置。
|
||||
- Excel15类精确匹配流程/版本/节点,同窗口同类别一封。收件人由分类规则维护,模板显式关联类别;归档与附件要求以Excel类别为准。
|
||||
- 标题按订单号拆段提取。惠州额外通知待确认;BPM节点人工办理。
|
||||
|
||||
@@ -24,6 +24,8 @@ Excel 的15类规则是唯一业务分类。流程名称、版本、配置节点
|
||||
|
||||
字段映射按流程及表单版本维护,左侧流程目录、右侧四步配置。主订单来自表单,摘要固定提取标题全部订单;待办元数据只读。真实样本采集独立于执行;草稿保存、统一引擎检查、确认使用分离。参考配置不能授权真实执行。确认更新后关联已发布分类暂停,须重新检查发布;冻结批次保留。详见[字段映射说明](field-mappings-guide.md)及[实施方案](plans/2026-10-20-field-mappings.md)。
|
||||
|
||||
配置默认“选真实订单 → 自动识别 → 核对差异”。分类页与字段映射页共用授权证据目录和确定性提案;同版本草稿优先,其次唯一生效配置,最后才按当前字段唯一标签推荐。默认仅取目录摘要,完整字段在高级区按需读取。歧义可就地选择,流程/节点新增配对必须显式确认;历史不猜节点。纯预览不写草稿、检查、执行或发布凭据,保存/检查/生效/分类发布分开。就地生效映射后同步规则版本并保留本地输入,同字段并发修改须逐项核对;响应不明先查同次持久操作。详见[真实订单驱动设计](superpowers/specs/2026-10-20-order-driven-configuration-design.md)及[本轮验收](order-driven-configuration-verification-2026-10-20.md)。本轮代码交付,正式服务更新另行安排。
|
||||
|
||||
采样可从全部授权待办和明确选择的已办/历史补充字段证据,不能将旧订单入队。历史保留来源、未知节点及发起时间含义,仅可核对字段,分类发布仍要求真实通知待办。字段采集不证明PDF排版就绪。ZCode通过项目固定技能和受控卡片辅助采样、草稿与检查,不能自动生效或发布,不能接收完整表单值或任意脚本。
|
||||
|
||||
独立 order-execution 模块协调现有 BPM、规则、PDF、存储和邮件。真实待办包括任务、实例、修订、节点接收时间、流程版本。采集目录保存实际字段路径、中文标签、值及来源证据。管理员从目录选择映射,固定到流程版本;不能手工设置接入已就绪,不能将客户端提交路径/摘要当归档证据。未知版本、缺字段和冲突进入受阻状态并指向修复入口。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 真实订单驱动配置:代码与隔离验收
|
||||
|
||||
日期:2026-10-20(北京时间)。开发目录为 `C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation`,分支 `codex/modular-refactor`;基线 `d4070e0`。本轮交付代码,正式服务更新不在范围内。原 Z 盘源码、正式账号/数据库/加密身份及正式服务均未更新;不发送真实邮件、不办理 BPM 节点、不批量生效正式映射或发布正式分类。
|
||||
日期:2026-10-20(北京时间)。开发目录为 `C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation`,分支 `codex/modular-refactor`;基线 `d4070e0`。本轮交付代码,正式服务更新不在范围内。原 Z 盘源码、正式账号/数据库/加密身份未改动,未执行正式部署或重启;不发送真实邮件、不办理 BPM 节点、不批量生效正式映射或发布正式分类。
|
||||
|
||||
## 交付行为
|
||||
|
||||
@@ -46,14 +46,30 @@ node --test --test-concurrency=1 tests/assistant/field-skill.test.cjs tests/app/
|
||||
| 草稿、检查、生效、分类发布分离;并发三方合并/冲突解决;写入响应丢失/旧检查拒绝 | order-driven-mapping-ui、order-driven-rules-ui、field-mapping-ui |
|
||||
| 真实 Chromium PDF、文件大小/SHA256读回、本地 SMTP、新单自身值、任务去重及冻结不变 | app/order-execution-integration;原 window/batches/execution 覆盖两个时段、周一/公司调休及历史忽略 |
|
||||
|
||||
已实际修复并保留回归的边界:冲突解决按钮被后续提案刷新覆盖;同次请求核实误读旧 check;取消选择遗留正式检查样本;保存后仍显示旧推荐依据。原 Excel 导入、模板/目录选择、发布开关、旧地址及权限用例继续运行。
|
||||
已实际修复并保留回归的边界:冲突解决按钮被后续提案刷新覆盖;同次请求核实误读旧 check;取消选择遗留正式检查样本;保存后仍显示旧推荐依据;同步期间规则输入未锁定及可见版本未更新;搜索Enter误提交外层表单;通用请求把纯提案误标写入;后台目录错误覆盖保存/发布确认。原 Excel 导入、模板/目录选择、发布开关、旧地址及权限用例继续运行。
|
||||
|
||||
截图均为虚构数据:`output/verification/order-driven-mapping-desktop.png`、`order-driven-mapping-mobile.png`、`order-driven-rules-desktop.png`、`order-driven-rules-mobile.png`;已检查实际截图及390px整页无横向溢出。
|
||||
|
||||
## 全量结果与正式边界
|
||||
|
||||
最终 `npm ci`、新鲜完整 `npm test`、全部 JS/CJS 语法、文档链接及 `git diff --check` 的结果在完成后补入本节;不以旧435项记录代替。
|
||||
代码验收版本:`5f389d7`(其后仅交接文档更新)。环境:Windows x64、Node.js v24.19.0,依赖按锁文件重装,无新增运行依赖。
|
||||
|
||||
未部署、未推送、未合并;保留开发分支供验收。本轮没有启动/停止/重启正式守护,没有修改正式自动通知开关或登录。正式暂停要求继续保留;本地 SMTP 链路测试的启用状态仅存在于临时测试库,测试结束关闭并清理。
|
||||
| 最终检查 | 结果 |
|
||||
|---|---|
|
||||
| `npm ci` | 退出码0,安装345包;日志 `output-final-install.log`。现有依赖审计仍提示2项moderate,未执行越范围依赖升级。 |
|
||||
| 新鲜完整 `npm test` | 470项:469通过、0失败、1可选官方ZCode CLI测试跳过,退出码0;766274ms,日志 `output-full-verified-test.log`。 |
|
||||
| 全部JS/CJS语法 | src/web/scripts/tests共227文件通过,退出码0。 |
|
||||
| 文档与差异 | 30个文档相对链接有效;`git diff --check`通过。 |
|
||||
| 浏览器及业务链路 | 管理员/操作员/只读、桌面/390px、快速换单/401/冲突/写入核实;假BPM、真实Chromium PDF和本地SMTP链路通过。 |
|
||||
|
||||
现场仍须确认15类真实通知节点/字段、目录权限与邮箱/批次预览;已有采样缺口及流程名称歧义不能用合成用例或猜别名补齐。惠州额外通知未启用。正式更新须用户另行安排,届时再核实实际源码目录、停服一致性备份、原登录、双端口及暂停状态;本轮没有执行这些部署动作。
|
||||
完整套件包含新增的保存依据刷新、原子同步可见规则版本、搜索Enter不提交外层表单、已核实写入不残留结果不明提示、纯提案不触发写入核实,以及后台目录读取失败不覆盖保存/发布成功反馈。
|
||||
|
||||
未执行部署/重启、未推送、未合并;保留开发分支供验收。本轮没有启动/停止/重启正式守护,没有修改正式自动通知开关或登录。本地 SMTP 链路测试的启用状态仅存在于临时测试库,测试结束关闭并清理。
|
||||
|
||||
收尾只读核验发现:正式守护(PID 15000)和业务进程(PID 34744)的启动入口也在本开发工作树。该PID仅是本次检查时状态,不应作为后续操作目标。已核对 `scripts/service.cjs` 和 `src/server.cjs` 的实际进程入口;服务按路径读取静态资源,只读静态探测已确认首页200且引用新选择器脚本,而 `/field-sample-picker.js` 返回401:新页面与旧资源路由已混用。不能以“未重启”声称界面未受影响,也不能将这种组合当作正式验收。开工时未先核实实际运行源码目录属于本轮隔离疏漏,已向用户说明。
|
||||
|
||||
直接以 SQLite readOnly 模式读取既有 settings 记录,仅输出开关与版本;未实例化会写入/恢复批次的 RuleStore,未输出密钥、凭据或业务值。核验结果:正式自动通知 `enabled:false`、`version:1`。保留暂停状态。
|
||||
|
||||
已向用户说明共享目录冲突并列出处理方式:受控建立独立正式运行目录(原版本,不部署新功能)或先交付并另行安排隔离。未获明确授权前不停止服务或切换目录。此隔离问题必须在正式更新前解决;代码测试均在临时状态及随机本地端口完成,不能代替运行隔离。
|
||||
|
||||
现场仍须确认15类真实通知节点/字段、目录权限与邮箱/批次预览;已有采样缺口及流程名称歧义不能用合成用例或猜别名补齐。惠州额外通知未启用。正式更新须用户另行安排,届时先解决已确认的目录共用问题,再核实实际源码目录、停服一致性备份、原登录、双端口及暂停状态;本轮没有执行这些部署动作。
|
||||
@@ -0,0 +1,355 @@
|
||||
# 真实订单驱动的分类与字段配置 Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. 用户指定在新对话开发;本轮只写计划。未得到新的明确指令不开始实现,不自动创建子代理。
|
||||
|
||||
**Goal:** 管理员选择真实 BPM 订单后,系统自动带出流程、节点、版本和业务参数,核对后复用到后续同版本订单,默认不再逐项手工映射。
|
||||
|
||||
**Architecture:** 从现有只读采样和字段映射检查提取统一推荐/识别服务。分类规则与字段映射复用真实订单选择器和识别结果面板,沿用现有草稿、检查、生效、发布接口及页面生命周期;选择/预览与实际写入严格分开。
|
||||
|
||||
**Tech Stack:** Node.js 22.13+、CommonJS、既有加密SQLite状态、原生浏览器页面模块、Tabler 1.6.1、node:test、playwright-core;不新增框架或运行时依赖。
|
||||
|
||||
**Spec:** [通过真实订单配置分类与信息识别](../specs/2026-10-20-order-driven-configuration-design.md)。先阅读设计第3节的实际交互,再执行本计划。
|
||||
|
||||
## Global Constraints
|
||||
|
||||
- Node.js 22.13+;现有 Node CommonJS、SQLite加密状态、原生页面模块、Tabler 1.6.1;不新增前端框架或规则表达式语言。
|
||||
- 只在 `C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation` 的 `codex/modular-refactor` 工作;原 `Z:/Order Notification Automation` 源码不改。开工时重新确认分支和工作树。
|
||||
- 保留15类 Excel 业务规则、精确节点匹配、北京时间/公司日历/周一窗口、同窗口同类别一封、冻结批次、受控重试和结果不明核验。
|
||||
- 正式自动通知继续暂停;不发送真实邮件,不办理 BPM 节点;惠州额外通知仍待确认。
|
||||
- 保留账号、数据库、加密身份和原登录,不重置账号,不输出凭据,不安装个人 Codex 技能。
|
||||
- ZCode 复用项目内技能;不开放 Shell/浏览器/原生工具权限,不自动激活映射或发布规则。
|
||||
- 本轮仅编写计划。后续正式服务更新独立执行:通过验收后,先一致性备份,再检查双端口、原登录、页面和暂停状态;不得跳过现场核验。
|
||||
|
||||
## 本次执行记录
|
||||
|
||||
2026-10-20:用户已明确授权按本计划实施,指定先交付并验收代码、正式服务更新另行安排。任务1—6已实施并完成专项;任务7代码验证与交接已完成:完整470项,469通过、0失败、1可选CLI跳过;227文件语法通过。正式进程与开发共用目录导致静态资源混用已确认,隔离/恢复等待用户安排,不将未重启误称运行隔离。部署/备份/重启/回滚分支不在本次执行范围,保持未执行;不创建子代理、不推送、不合并。实际结果见[代码验收](../../order-driven-configuration-verification-2026-10-20.md)。
|
||||
|
||||
## 0. 新对话开工信息
|
||||
|
||||
计划基线:`d4070e0 feat: collect BPM field evidence and equip ZCode mapping assistant`。这不是要求重置到该提交;发现新提交或未提交改动先阅读差异,保留现有工作。计划文档可能尚未提交。
|
||||
|
||||
只编写计划,不代表功能已完成或正式服务已经更新。当前生产规则/映射状态需要重新查询;不用真实订单执行采集队列,不用正式邮箱做验收。用户若在新对话明确要求“按此计划实施”,即为开工授权,不要重复要求批准已写明的设计;新增范围或改变关键交互才重新确认。
|
||||
|
||||
先运行以下只读命令,确认工作树、依赖和现有模块;不先停正式服务:
|
||||
|
||||
```powershell
|
||||
Set-Location -LiteralPath 'C:\Users\ABS\.codex\worktrees\modular-refactor\Order Notification Automation'
|
||||
git status --short
|
||||
git branch --show-current
|
||||
git log -3 --oneline
|
||||
Get-Content -LiteralPath 'docs/HANDOFF.md'
|
||||
Get-Content -LiteralPath 'docs/superpowers/specs/2026-10-20-order-driven-configuration-design.md'
|
||||
```
|
||||
|
||||
执行顺序:任务1 → 2 → 3 → 4 → 5 → 6 → 7。用户需要先评审交互时,先展示设计中的虚构订单示例,不把生产业务值作为公开交互稿。
|
||||
|
||||
## 1. 文件和职责
|
||||
|
||||
路径均相对上述开发工作树。新建文件是计划接口,不能误称已存在。
|
||||
|
||||
| 文件 | 操作 | 单一职责 |
|
||||
|---|---|---|
|
||||
| `src/modules/order-rules/field-recommendation.cjs` | 新建 | 实际字段标签的确定性推荐与歧义说明 |
|
||||
| `src/modules/order-rules/recognition-proposal.cjs` | 新建 | 同版本配置选择、只读识别提案、匹配范围候选 |
|
||||
| `src/modules/order-rules/effects-preview.cjs` | 新建 | 从trial提取纯文件名/归档路径/邮件示例生成,无写入 |
|
||||
| `src/modules/order-rules/field-mappings.cjs` | 修改 | 导出内部统一检查函数,保持草稿/检查/生效协议 |
|
||||
| `src/modules/order-rules/trial.cjs` | 修改 | 复用纯effects函数,仍独占正式试运行凭据写入 |
|
||||
| `src/modules/order-rules/store.cjs` | 修改 | 暴露 `proposeMapping`,不改变已发布快照语义 |
|
||||
| `src/modules/order-execution/field-sample-catalog.cjs` | 新建 | 授权已采样目录、搜索与分页,返回摘要 |
|
||||
| `src/modules/order-execution/api.cjs` | 修改 | 只读目录与提案端点,权限边界 |
|
||||
| `src/modules/order-execution/field-samples.cjs` | 修改 | 列表中显式输出来源/时间类型;保持现有采集保护 |
|
||||
| `web/modules/field-mappings/sample-picker.js` | 新建 | 已采集/实时待办选择、读取进度、搜索分页和取消选择 |
|
||||
| `web/modules/field-mappings/recognition-panel.js` | 新建 | 中文业务值、问题及歧义候选;技术详情折叠 |
|
||||
| `web/modules/field-mappings/view.js` | 修改 | 字段配置页面编排;复用选择和结果模块 |
|
||||
| `web/modules/field-mappings/view.css` | 修改 | 选择区与识别卡片,390px布局 |
|
||||
| `web/modules/order-rules/view.js` | 修改 | 分类页编排、未保存状态、范围候选确认和预览失效 |
|
||||
| `web/modules/order-rules/editor.js` | 修改 | 四步文案与占位,不混入请求逻辑 |
|
||||
| `web/modules/order-rules/scope-editor.js` | 修改 | `setScopes`接口,配对增删去重,保留高级维护 |
|
||||
| `web/modules/order-rules/preview.js` | 修改 | 正式分类检查与只读提案状态区分 |
|
||||
| `src/app/assets.cjs`、`web/index.html` | 修改 | 显式加载新页面模块,避免部署漏文件 |
|
||||
| `src/modules/assistant/field-skill.cjs` | 修改 | 调用统一推荐服务,移除本地重复规则 |
|
||||
| `src/modules/assistant/skills/bpm-field-mapping/SKILL.md` | 修改 | 项目技能说明自动识别与歧义处理,不扩大权限 |
|
||||
|
||||
不全站重构,不修改无关导航/账号/SMTP/归档实现。现有 `field-sources.cjs`、`matching.cjs`、`title.cjs`、`trial.cjs` 仍是业务来源读取、标题和分类检查依据。
|
||||
|
||||
## 2. 新增接口的精确约定
|
||||
|
||||
### 2.1 统一推荐与只读提案
|
||||
|
||||
```js
|
||||
// field-recommendation.cjs
|
||||
recommendFields(fields) // fields: Array<{path, label, value}>
|
||||
// => {sources, issues: string[], candidates: Record<string, Array<{path,label,value}>>}
|
||||
// sources 只含当前真实目录内的唯一候选,brief 固定 {type:'title'}。
|
||||
|
||||
// field-mappings.cjs,从现有 evaluate 提取并导出,checkMapping 复用。
|
||||
evaluateMapping(store, draft, captured, {relatedRules} = {})
|
||||
// => 原有检查结果;只读,不保存 checkId,不持久化 verified。
|
||||
// relatedRules: Array<{id,draft}>,省略时沿用现有关联类别;提案可用已校验ruleDraft替换当前类别。
|
||||
|
||||
// effects-preview.cjs,从 trial.cjs 的 effects 原样提取。
|
||||
previewEffects(rule, event, store)
|
||||
// => {simulation:true,archiveVerified:false,filename,path,mail,issues,provisionalDate}
|
||||
// 只生成示例;trial 和 propose 共用,不生成真实归档或邮件。
|
||||
|
||||
// recognition-proposal.cjs;RuleStore 暴露同名方法。
|
||||
proposeMapping(store, input)
|
||||
// input: {sampleId, ruleId?, ruleVersion?, ruleDraft?, sources?}
|
||||
// ruleId 存在时 ruleVersion 必填;sources 和 ruleDraft 仅管理员可提交。
|
||||
// ruleDraft 必须有匹配的ruleId;按validateRule校验后仅用于本次预览。
|
||||
// => RecognitionProposal,结构见下。
|
||||
```
|
||||
|
||||
```js
|
||||
// RecognitionProposal
|
||||
{
|
||||
sampleId, evidenceHash, processName, processVersion,
|
||||
metadata: {source, nodeName, serialNum, receivedAt, capturedAt, timestampType},
|
||||
scopeCandidate: null /* 或 {processName, nodeName},仅真实待办可有 */,
|
||||
mapping: {
|
||||
basis: 'draft' /* 或 active / recommended / conflict */,
|
||||
id: null, draftVersion: 0, activeVersion: null, sources: {}
|
||||
},
|
||||
fields: [/* {key,label,state,source,value,candidates,reason} */],
|
||||
recognition: {valid, event, fieldTrace, issues, checks, filenames, publishEvidence: false},
|
||||
classification: {status: 'candidate', ruleId: null},
|
||||
effects: null,
|
||||
conflicts: [/* {ruleId,name,published} */],
|
||||
blockedReasons: [], warnings: []
|
||||
}
|
||||
// fields[].state 仅 recognized / ambiguous / missing / invalid。
|
||||
// classification.status 为 matched / candidate / conflict / history / none。
|
||||
// effects 仅明确命中当前草稿类别且字段可用时生成;始终标为未执行预览。
|
||||
// JSON 不带 undefined 属性,缺值用 null;不返回旧样本的实际值。
|
||||
```
|
||||
|
||||
`POST /api/order-rules/field-mappings/propose`:只读操作,只接受上述 input。服务端重新取真实采样证据;不接受客户端自造 metadata/字段值。所有角色可按原连接权限查看;非管理员提交 `sources` 或 `ruleDraft` 返回403。缺样本404、规则版本变化409、禁用/无权连接403;服务未就绪503。使用400拒绝未知参数。字段缺失/歧义等业务问题返回200及受阻结果,便于原位修复。
|
||||
|
||||
授权放在 `orderExecutionApi`,领域方法不信任外部样本。只读提案不能复用会写 `trialVersion` 的 `trial()`;不能偷偷调用 `saveMapping`、`checkMapping`、`activateMapping` 或 `publish`。只读预览内的临时映射不能进入 registry。
|
||||
|
||||
带 `ruleDraft` 时必须先比较 `ruleVersion` 与服务端草稿,调用 `validateRule(ruleDraft,record.draft)` 后把候选version设为服务端当前版本;不保存该候选。使用候选的filenameDate计算字段必填性,使用候选配对和其他规则检查分类冲突,再调用 `previewEffects` 展示未保存目录/模板/主题。字段识别 `recognition.valid` 不能代替 `classification.status==='matched'`;尚未确认加入配对时为candidate,历史为history。
|
||||
|
||||
### 2.2 已采样目录
|
||||
|
||||
`GET /api/order-rules/field-samples/catalog?connectionId=...&source=todo&q=...&processName=...&limit=20&cursor=...`
|
||||
|
||||
- `connectionId`、`q`、`processName`可省略;`source`为`todo|history|all`,默认`todo`;`limit`默认20、范围1—50,`q`最多200字符。只查已采样证据,不连接BPM,不生成配置。空查询不一次返回11,523字段。
|
||||
- 返回 `{items,nextCursor}`;item为 `{id,connectionId,processName,processVersion,source,nodeName,serialNum,receivedAt,capturedAt,timestampType,title,orderNo}`,`orderNo`不能唯一识别时为null。不得返回完整 `fields`、HTML、详情URL、旧检查结果或凭据。
|
||||
- 排序 `capturedAt desc, id asc`;游标为该排序键的base64url编码,按当前过滤结果定位;严格验证解码结构及长度,无效游标400。样本新增排在第一页,后续页使用排他排序键边界,不使用可偏移的数组下标。每次请求重新做连接授权,游标不授予权限。
|
||||
- 先过滤连接权限再搜索/分页,不能用总数、下一页或字段值泄露无权样本。管理员沿用现有连接访问政策,其他角色只访问自己拥有且未禁用的连接。
|
||||
- 搜索 title、serialNum 和可确定的主订单号,`processName`精确筛选;标题等以转义文本显示。
|
||||
|
||||
实时待办继续使用现有 `/field-samples/list` 和 `/capture`;在 `listView()` 输出 `source`、`configurationOnly`、`timestampType`,不改变15分钟有效期、登录/连接绑定和重新核对身份。默认配置入口用`scope:'configuration'`,历史仅在用户主动选择历史范围时读取。
|
||||
|
||||
### 2.3 可复用页面模块
|
||||
|
||||
```js
|
||||
window.FieldSamplePicker.mount(host, {
|
||||
api, esc, formatDate, user, isActive,
|
||||
processNames, connections,
|
||||
guardSelection, // (apply) => PageLifecycle.guard(apply)
|
||||
onSelect, // async ({sampleId}) => 提案查询;不自动写配置
|
||||
feedback
|
||||
}) // => {setContext({processNames}), dispose()}
|
||||
|
||||
window.FieldRecognitionPanel.render(host, proposal, {
|
||||
esc, admin,
|
||||
loadFields, // async ({sampleId}) => 当前样本的真实字段数组;展开高级区才调用
|
||||
onChangeSources // (sources) => 只更新页面草稿,旧检查失效
|
||||
}) // => {dispose()}
|
||||
|
||||
// scope-editor.js 的 bind() 新返回控制器;保留原方法兼容。
|
||||
window.OrderRuleScopes.bind(host, options)
|
||||
// => {setScopes(scopes), dispose()}
|
||||
// setScopes 去重后重绘,调用方显式调用 changed() 一次。
|
||||
```
|
||||
|
||||
目录列表没有完整字段;只有管理员展开“调整字段对应”时,沿用授权 `GET /order-rules/fields` 取得所选样本字段,不把全部字段下拉塞到默认页面。提案服务负责实际值和歧义候选,前端不再自行猜字段。
|
||||
|
||||
## Task 1: 提取统一字段推荐和只读识别提案
|
||||
|
||||
**Files:** 新建 `src/modules/order-rules/field-recommendation.cjs`、`recognition-proposal.cjs`、`effects-preview.cjs`;修改 `field-mappings.cjs`、`trial.cjs`、`store.cjs`、`src/modules/assistant/field-skill.cjs`;新建 `tests/order-rules/recognition-proposal.test.cjs`,回归 `tests/assistant/field-skill.test.cjs`。
|
||||
|
||||
**Consumes:** `store.get/all/adapters()`、真实 `capture-samples`、`sourcesFor`、现有 `evaluate`/`previewMatch`、助手标签集合。
|
||||
|
||||
**Produces:** 第2.1节四个函数及 `RuleStore.proposeMapping(input)`;助手原 `recommend(fields)` 保留兼容导出,代理到共享函数。
|
||||
|
||||
- [x] 先写推荐红测:唯一订单号、同名两个订单号、0数量、金额误配、泛称零部件数量、未映射可选项和不存在路径。最小核心断言:
|
||||
|
||||
```js
|
||||
const {recommendFields}=require('../../src/modules/order-rules/field-recommendation.cjs');
|
||||
const r=recommendFields([
|
||||
{path:'form.order',label:'订单号',value:'148396'},
|
||||
{path:'form.qty',label:'订单数量',value:0},
|
||||
{path:'form.amount',label:'总金额',value:500}
|
||||
]);
|
||||
assert.equal(r.sources.orderNo.path,'form.order');
|
||||
assert.equal(r.sources.quantity.path,'form.qty');
|
||||
assert.equal(r.sources.totalAmount.path,'form.amount');
|
||||
const ambiguous=recommendFields([
|
||||
{path:'one',label:'订单号',value:'148396'},
|
||||
{path:'two',label:'订单号',value:'HA148396'}
|
||||
]);
|
||||
assert.equal(ambiguous.sources.orderNo,undefined);
|
||||
assert.equal(ambiguous.candidates.orderNo.length,2);
|
||||
```
|
||||
|
||||
- [x] 运行 `node --test tests/order-rules/recognition-proposal.test.cjs`,确认失败来自缺少新模块/行为,而非测试环境。
|
||||
- [x] 将现有精确别名规则移到 `recommendFields`,保留数量防混用;提取 `evaluateMapping`,让现有 `checkMapping` 继续用它。构建提案优先级“草稿 → 唯一生效 → 当前样本唯一推荐”,不自动填已有草稿空项,不借参考映射授权。
|
||||
- [x] 从trial提取 `previewEffects`,保持原有日期、归档示例和模板解析行为;提案采用当前页面ruleDraft的日期用途、scope和预览设置,字段可用但配对未加入时只返回candidate,不生成命中成功。新测覆盖未保存日期改为appDate后必须检查日期,以及未保存主题/目录的纯预览;前后规则记录保持相同。
|
||||
- [x] 为缺主订单字段返回完整受阻结果,不调用会提前抛出保存校验错误的写入函数;人为提交的未知路径仍400。配置冲突、缺路径、主订单不在标题和未知版本须在问题区显示。
|
||||
- [x] 增加提案测试:第二条同版本订单显示第二条的值;新版本不复用旧映射;历史 `scopeCandidate===null`;已采样待办候选为真实配对;title保留HA;建议不产生写入。测试前后对 `rules`、`field-mapping-drafts`、`field-adapters`、`orders`、`batches`、`execution-tasks`、`field-mapping-requests` 的 `store.all(kind)` 深比较完全相等。
|
||||
- [x] 测试提案当前类别候选配对与其他草稿/发布类别冲突时列出类别,不能返回可发布状态;`recognition.publishEvidence`始终false。
|
||||
- [x] 运行 `node --test --test-concurrency=1 tests/order-rules/recognition-proposal.test.cjs tests/order-rules/field-mappings.test.cjs tests/assistant/field-skill.test.cjs`。通过后形成独立提交 `refactor: share evidence based field recognition`。
|
||||
|
||||
## Task 2: 接入授权目录、预览API与来源元数据
|
||||
|
||||
**Files:** 新建 `src/modules/order-execution/field-sample-catalog.cjs`、`tests/order-rules/sample-catalog.test.cjs`;修改 `src/modules/order-execution/api.cjs`、`field-samples.cjs`;扩展 `tests/order-rules/field-samples.test.cjs`。
|
||||
|
||||
**Consumes:** Task 1的 `RuleStore.proposeMapping`,现有 `execution.connection(id,principal)` 访问规则、`filterFieldEvidence` 行为和采集列表。
|
||||
|
||||
**Produces:** `catalogFieldSamples({store,workspace},query,principal)`;第2.1/2.2节HTTP接口;listView显式来源。
|
||||
|
||||
- [x] 写目录红测,临时RuleStore构造两个连接的样本。操作员只能搜到自有连接,禁用连接不能取值,跨连接查询403;管理员按现有政策可看;返回JSON不得含HTML、完整fields、Cookie、详情地址或未授权客户值。
|
||||
- [x] 写HTTP红测:GET目录可供三个角色授权读取;POST提案只读权限、非管理员覆盖sources或ruleDraft为403、未知字段400、规则版本冲突409、匿名401;现有 draft/check/activate 仍只允许管理员。新的 propose 分支放在现有viewer写入禁令之前,但仅这个纯读操作获准。
|
||||
- [x] 运行 `node --test tests/order-rules/sample-catalog.test.cjs tests/order-rules/field-samples.test.cjs`,确认预期失败。
|
||||
- [x] 实现严格查询解析、授权后过滤、限定搜索、稳定游标和摘要输出;分页使用排他排序键。只读提案每次重新验证连接,取当前采样证据,响应只包含所选有权样本的值。
|
||||
- [x] 扩展listView保留真实来源和时间类型;历史节点占位只展示,不能成为scopeCandidate。保留configuration/history只采字段、不创建执行任务的断言。
|
||||
- [x] 验证同名字段与主订单搜索不误用标题猜测,恶意HTML只作文本,分页期间新增样本不重复/跳过已有页面边界,权限变化后旧cursor不继续泄露。
|
||||
- [x] 运行 `node --test --test-concurrency=1 tests/order-rules/sample-catalog.test.cjs tests/order-rules/field-samples.test.cjs tests/order-rules/recognition-proposal.test.cjs`,通过后提交 `feat: expose authorized order recognition previews`。
|
||||
|
||||
## Task 3: 真实订单选择器与识别结果公共组件
|
||||
|
||||
**Files:** 新建 `web/modules/field-mappings/sample-picker.js`、`recognition-panel.js`、`tests/order-rules/sample-picker-ui.test.cjs`;修改 `web/modules/field-mappings/view.css`、`src/app/assets.cjs`、`web/index.html`。
|
||||
|
||||
**Consumes:** Task 2目录/提案接口、现有list/capture和PageLifecycle;接口精确按第2.3节。
|
||||
|
||||
**Produces:** `FieldSamplePicker`、`FieldRecognitionPanel`。静态路由分别为 `/field-sample-picker.js`、`/field-recognition-panel.js`,在field-mappings/order-rules页面脚本之前defer加载。
|
||||
|
||||
- [x] 用现有 `loadPlaywright()`/`browserOptions()`测试模式,给页面注入生命周期和新组件。先写“搜索已采集 → 下一页 → 选择订单仅触发onSelect”的红测;取消/返回/空结果均可操作。
|
||||
- [x] 增加实时路径红测:管理员选连接→读取全部授权待办配置列表→点击一单→只采此单→回调sampleId。操作员/只读成员无采集按钮;无连接显示配置入口;15分钟过期给“重新读取”,不自动重放capture。
|
||||
- [x] 运行 `node --test tests/order-rules/sample-picker-ui.test.cjs` 确认失败,再实现选择器。搜索防抖250ms;每个读请求独立revision,切换连接/来源/类别、关闭或dispose时使旧响应失效;采集期间锁同一操作并保存幂等键。
|
||||
- [x] 实现结果面板:主界面显示实际值和业务问题,歧义项给中文标签+当前值;选择候选只调用onChangeSources,不写配置;普通成功项无需打开下拉。高级字段选择与技术路径折叠,非法值标在对应业务项。高级区通过loadFields只在展开时读取所选样本目录,加载失败保留现有来源,dispose/换单使旧加载响应失效。
|
||||
- [x] 业务值使用textContent或统一esc转义;不插入BPM HTML。实时范围与历史范围文案不同;采集只显示“样本已读取”,不能叫“订单已执行”。
|
||||
- [x] “取消选择/关闭”只是不采用选中结果并使页面响应失效,不能声称中止服务端采集。已开始的只读采集可能完成并留下字段证据;采集期间显示真实状态,不提供未实现的“取消采集”按钮。
|
||||
- [x] UI断言示例:
|
||||
|
||||
```js
|
||||
await page.getByLabel('搜索订单号、流水号或标题').fill('148396');
|
||||
await page.getByRole('button',{name:'选择订单 S-1',exact:true}).click();
|
||||
assert.deepEqual(await page.evaluate(()=>window.selectedSamples),[{sampleId:'s1'}]);
|
||||
assert.equal(await page.evaluate(()=>window.writeCalls.length),0);
|
||||
await page.setViewportSize({width:390,height:844});
|
||||
assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth<=innerWidth),true);
|
||||
```
|
||||
|
||||
- [x] 验证键盘选择/焦点、分页失败重试、快速搜A再搜B、快速换单、dispose后旧返回、401登录失效、重复点击与390px无溢出。确认搜索/预览不触发未保存保护。通过后提交 `feat: add reusable BPM order selection and recognition panels`。
|
||||
|
||||
## Task 4: 字段映射页面改为选单后自动识别
|
||||
|
||||
**Files:** 修改 `web/modules/field-mappings/view.js`、`view.css`;扩展 `tests/order-rules/field-mapping-ui.test.cjs`;新建 `tests/order-rules/order-driven-mapping-ui.test.cjs`。
|
||||
|
||||
**Consumes:** Tasks 1—3、原 `/field-mappings/draft|check|activate`,目录状态和PageLifecycle。
|
||||
|
||||
**Produces:** 左侧流程/版本覆盖保留,右侧以订单识别结果为默认视图;原手工字段编辑成为高级修正工具。
|
||||
|
||||
- [x] 先写红测:选择真实订单后自动定位实际流程/版本,显示主订单、0数量及HA标题段落;不手动select任何字段即可看到结果;仅选择不保存、不检查、不激活。
|
||||
- [x] 运行 `node --test tests/order-rules/order-driven-mapping-ui.test.cjs` 确认失败;用公共组件替换默认逐项字段表单,原字段搜索/path详情保留在高级区;缺样本流程仍可见并有采集入口。
|
||||
- [x] 分清“自动提案”和“当前已保存草稿”基线:未保存的新推荐可显示“尚未保存”,但只读选择本身不算用户编辑;点击保存才生成v1。改动来源后才dirty,原有check立即失效。切换有未保存来源的上下文必须先走PageLifecycle.guard。
|
||||
- [x] 沿用三个显式动作;首次保存字段来源后检查当前真实sampleId,再明确确认生效。已有草稿不可自动覆盖;已有生效配置且来源未改变时,换样本不创建新版本。预览通过不能解锁activate,必须有当前draftVersion、sampleId、evidenceHash绑定的服务端check。
|
||||
- [x] 将原有自动推荐仅作为候选的测试更新为新预览行为;保留原有角色、版本冲突、参考配置不能授权、保存成功刷新失败、离页请求失效、重复提交保护断言。
|
||||
- [x] 增加故障用例:save已成功但响应丢失,先GET fields对照sampleId/sources/version及持久check/active状态,再显示真实结果;不因超时新建一版或再次activate。无法确定则停在“结果待核实”。
|
||||
- [x] 运行 `node --test --test-concurrency=1 tests/order-rules/field-mapping-ui.test.cjs tests/order-rules/order-driven-mapping-ui.test.cjs tests/order-rules/field-mappings.test.cjs`,通过后提交 `feat: configure field recognition by selecting real orders`。
|
||||
|
||||
## Task 5: 分类规则联动选单、精确范围与就地字段配置
|
||||
|
||||
**Files:** 修改 `web/modules/order-rules/view.js`、`editor.js`、`scope-editor.js`、`preview.js`;新建 `tests/order-rules/order-driven-rules-ui.test.cjs`;回归 `tests/order-rules/workbench-ui.test.cjs`、`business-config-ui.test.cjs`。
|
||||
|
||||
**Consumes:** Tasks 1—4;既有scope配对与规则保存/trial/publish。RuleStore数据结构继续兼容旧规则及Excel导入。
|
||||
|
||||
**Produces:** 分类第01步选单自动显示真实流程/节点,第02步自动业务值;新增scope仅显式确认,字段配置可就地维护。
|
||||
|
||||
- [x] 先写红测:选择当前类别已有精确配对的订单显示流程/节点/版本,scope不重复、页面不dirty;选择另一个真实待办仅显示候选,点击“将此流程与节点加入当前类别”才增一对,旧配对/收件人/目录/模板全部保留。
|
||||
- [x] 再写历史/冲突红测:历史能看字段但无加入节点按钮,历史占位不进scope下拉;真实非通知节点清楚展示实际节点,绝不因“知会”状态自动选通知书节点;冲突列出其他分类和修复入口。
|
||||
- [x] 运行 `node --test tests/order-rules/order-driven-rules-ui.test.cjs` 确认失败;重构editor只生成布局,view负责选单与提案请求,scope-editor提供setScopes去重重绘。保留高级范围维护,不把request逻辑塞到editor。
|
||||
- [x] 第02步展示提案并标明basis和生效状态;缺字段或未生效时展开复用配置面板,操作仍调用既有三个写入接口。第04步正式规则trial仍只用注册生效映射和真实待办;不能用提案临时映射或历史样本生成publication凭据。
|
||||
- [x] 将当前页面 `read()` 的ruleDraft连同ruleId/ruleVersion提交提案;第04步可自动显示纯effects预览并标明未保存/未执行,正式“检查并用于发布”仍独立调用trial。历史不能伪装通知节点;已有规则若含历史占位配对,显示受阻并要求管理员修正,不静默改存量规则。
|
||||
- [x] 为“字段生效后关联规则版本可能增加”实现保留输入的同步:读取服务器新规则版本,把旧基线/用户修改/新服务端基线对照。仅当用户字段与新服务端字段各自不冲突时合并版本和adapterIds;同字段被并发修改则列出冲突并阻塞save,保留用户值。禁止全页reload丢弃收件人、目录等未保存内容。
|
||||
- [x] 检查换单/换类别的请求身份包括routeRevision、ruleId、ruleVersion、sampleId;任何字段、scope、用途日期或模板改动使旧提案/trial显示失效。样本预览无写入,正式trial成功才能按旧逻辑写凭据。
|
||||
- [x] 关键回归断言:
|
||||
|
||||
```js
|
||||
const before=structuredClone(runtime.orderRules.get('rules','bs-change'));
|
||||
// 通过页面选择样本并等待自动提案,不点击任何保存/生效/发布。
|
||||
assert.deepEqual(runtime.orderRules.get('rules','bs-change'),before);
|
||||
assert.equal(runtime.orderRules.settings().enabled,false);
|
||||
assert.deepEqual(runtime.orderRules.all('orders'),[]);
|
||||
assert.deepEqual(runtime.orderRules.all('batches'),[]);
|
||||
```
|
||||
|
||||
- [x] 验证主标签/侧栏/前进后退/刷新/快速换单/重复确认/失败保留输入;旧地址、Excel导入、左侧开关和邮件预览不退化。运行 `node --test --test-concurrency=1 tests/order-rules/order-driven-rules-ui.test.cjs tests/order-rules/workbench-ui.test.cjs tests/order-rules/business-config-ui.test.cjs tests/order-rules/workbench.test.cjs`,通过后提交 `feat: derive rule scope and business values from selected orders`。
|
||||
|
||||
## Task 6: ZCode一致性、完整链路和操作验收
|
||||
|
||||
**Files:** 修改项目 `assistant/skills/bpm-field-mapping/SKILL.md`、`docs/field-mappings-guide.md`、`order-rules-guide.md`、`zcode-field-mapping-skill.md`、`web-action-inventory.md`;扩展 `tests/assistant/field-skill.test.cjs`、`tests/app/order-execution-integration.test.cjs`;新建 `docs/order-driven-configuration-verification-2026-10-20.md`。
|
||||
|
||||
**Consumes:** Tasks 1—5的同一推荐/识别服务及原业务执行闭环。
|
||||
|
||||
**Produces:** 页面与项目助手识别一致;所有新增控件有权限、前置、结果、失败与验收记录。文档日期按实际开发日修改。
|
||||
|
||||
- [x] 写一致性红测:对同一已采样fields,助手recommend与页面提案的推荐来源一致;已有草稿不被自动覆盖,歧义导致needs-selection或blocked;准备卡片不能激活映射/发布/发信。
|
||||
- [x] 更新项目技能采用“选真实订单→自动候选→核对差异”,保持安全摘要和固定操作卡,不向模型发送完整表单。未知版本、历史缺节点与同名候选必须明确说明。
|
||||
- [x] 扩展隔离端到端:只读选单→识别提案→确认范围→保存/检查/生效映射→重新保存/检查/发布规则→隔离BPM新订单→临时存储PDF校验→本地SMTP分类汇总。测试继续使用临时stateDir、假BPM和本地SMTP,绝不接入正式邮箱或写真实BPM。
|
||||
- [x] 为15类各验证主订单来源和摘要,特别是通知/更改差异、多订单HA、PDF附件差异、两个时段、周一/调休、历史忽略及任务去重;尽量扩展现有整链路fixture,避免复制另一套引擎。
|
||||
- [x] 验证映射更新后关联已发布类别暂停、旧检查失效,旧冻结批次深比较不变;新订单读取自己的值而不是配置样本值。
|
||||
- [x] 为选择器搜索/清空/筛选/上一页下一页/读取/选中/取消、高级候选调整/保存/检查/确认、配对增删/返回逐项更新操作清单;不能以按钮有响应代替业务验收。
|
||||
- [x] 专项命令 `node --test --test-concurrency=1 tests/assistant/field-skill.test.cjs tests/app/order-execution-integration.test.cjs tests/order-rules/order-driven-mapping-ui.test.cjs tests/order-rules/order-driven-rules-ui.test.cjs`。记录管理员/操作员/只读、桌面/390px及故障结果,成功后提交 `test: verify order driven configuration lifecycle`。
|
||||
|
||||
## Task 7: 全量验证、交接与受控正式更新
|
||||
|
||||
**Files:** 修改 `docs/HANDOFF.md`、`docs/design-requirements.md`;完善Task 6验收文档。服务更新不改业务开关。
|
||||
|
||||
**Consumes:** 所有实现与专项结果;现有 `scripts/service.cjs` 和正式状态备份规则。
|
||||
|
||||
**Produces:** 有新鲜测试证据的可交付版本。只有用户本次开发指令包含正式更新时才部署,否则停在可评审代码和验收记录。
|
||||
|
||||
- [x] 在开发工作树运行 `npm ci`,完成后运行新鲜完整 `npm test`。记录通过/失败/跳过数与退出码;旧435项记录不能代替本次。失败先定位,不删断言、放宽加密或降低权限来过测试。
|
||||
- [x] 运行以下语法与差异检查;修改的文档链接逐一检查存在,未创建的计划目标不能写成已完成:
|
||||
|
||||
```powershell
|
||||
$syntaxFiles = rg --files src web scripts tests -g '*.js' -g '*.cjs'
|
||||
foreach ($syntaxFile in $syntaxFiles) { node --check $syntaxFile; if ($LASTEXITCODE -ne 0) { throw "Syntax check failed: $syntaxFile" } }
|
||||
git diff --check
|
||||
```
|
||||
|
||||
- [x] 使用隔离服务核验浏览器真实页面:新旧地址、横栏高亮、三个角色、390px、快速切换、401、失效列表、并发版本冲突、写入超时核实和保存成功刷新失败。记录截图在忽略目录output/verification,私有业务值不提交。
|
||||
- [ ] 如果获准正式更新:先核实守护实际源码目录;`npm run service:status`读取状态,使用既有service:stop确认停止后,一致性备份 `%LOCALAPPDATA%/OrderNotificationAutomation`、本机配置和实际PDF输出目录至带时间戳备份目录。保留DPAPI密钥;SQLite integrity_check通过。未确认停服或备份不完整不继续。
|
||||
- [ ] 用测试通过的工作树更新,`npm start`启动守护;验证18766工作台和18765合法配对桥接健康、原账号登录、原样本/草稿/数据数量及身份保持。不得用无配对桥接401误判健康,也不得为测健康放宽鉴权。
|
||||
- [ ] 核验正式选单页面只读结果、历史限制、分类配对候选和高级字段入口;除用户明确确认的实际配置外不把任何推荐草稿批量生效。验证自动通知仍false,惠州额外邮件未启用,BPM节点未办理。
|
||||
- [ ] 如果失败,停止服务后恢复本次一致性备份及原代码版本,再验证原登录和暂停状态;不拼接不同时间点数据库与密钥。没有正式更新授权时记录“未部署”即可,不索取多余凭据。
|
||||
- [x] 更新交接,列出实际版本、测试结果、已完成控件、未通过项和现场阻塞。用户已明确要新对话开发,本轮不创建新对话、不推送、不合并;之后按会话实际授权处理代码提交。
|
||||
|
||||
## 3. 验收覆盖索引
|
||||
|
||||
| 设计要求 | 实现/验证任务 |
|
||||
|---|---|
|
||||
| 选单带流程/节点/实际参数,不手填路径 | 1、2、3、4、5 |
|
||||
| 主订单表单来源、标题全段/HA、0数量/金额区分 | 1、4、6 |
|
||||
| 已有草稿/生效优先级、未知版本/歧义阻塞 | 1、2、4 |
|
||||
| 只读提案无写入;保存/检查/生效/发布分开 | 1、4、5、6 |
|
||||
| 历史不猜节点、不授权分类发布、不加入执行 | 1、2、3、5、6 |
|
||||
| 精确配对、显式加入、保留旧范围和业务配置 | 1、5 |
|
||||
| 权限/来源泄露/注入/过期/幂等 | 2、3、4、6 |
|
||||
| 未保存保护、离页响应、并发版本、超时核实 | 3、4、5、7 |
|
||||
| 页面与ZCode共用;兼容旧数据/Excel/批次 | 1、5、6 |
|
||||
| 三角色、桌面/390px、全量验证、备份/暂停 | 3、4、5、6、7 |
|
||||
|
||||
## 4. 新对话启动文本
|
||||
|
||||
```text
|
||||
请在 C:\Users\ABS\.codex\worktrees\modular-refactor\Order Notification Automation 继续开发,分支 codex/modular-refactor。
|
||||
先读取 docs/HANDOFF.md、docs/superpowers/specs/2026-10-20-order-driven-configuration-design.md 和 docs/superpowers/plans/2026-10-20-order-driven-configuration.md,再按计划实施;保留当前未提交文档及其他已有改动,不改原Z盘源码。
|
||||
本次目标是选一条真实BPM订单,自动带出流程、真实节点、表单版本及业务参数,人工只核对歧义;保存可复用识别方法,不能把样本值固定给后续订单。已采集证据优先复用。
|
||||
使用Superpowers executing-plans逐项开发,先复述用户实际操作流程,按计划完成专项和全量测试,不自动创建子代理。正式自动发信继续暂停,不发送真实邮件、不办理BPM节点、不猜历史节点或流程别名,不自动批量生效/发布。
|
||||
先交付并验证代码;正式服务更新在完成验收后再由我明确安排。
|
||||
```
|
||||
@@ -0,0 +1,146 @@
|
||||
# 通过真实订单配置分类与信息识别
|
||||
|
||||
日期:2026-10-20。状态:用户已授权实施,代码与隔离专项/完整验证已完成(470项:469通过、0失败、1可选跳过);未执行正式部署或重启;收尾发现运行目录与开发共用,详见验收中的隔离问题。原规划记录和边界保留,实际交付结果见[代码验收](../../order-driven-configuration-verification-2026-10-20.md)。
|
||||
|
||||
## 1. 要解决的问题
|
||||
|
||||
用户期望:选择一条真实 BPM 订单后,自动带出流程、节点、表单版本和需要的业务参数,核对结果后配置同类订单。现有分类规则先选择流程/节点,字段映射又要求逐项选择来源,已采样证据没有成为主要操作入口。
|
||||
|
||||
本次统一操作方式:**选择真实订单 → 自动识别 → 核对差异 → 保存配置**。保存可复用的来源对应与精确流程节点条件,不保存示例订单值作为以后订单的固定值。
|
||||
|
||||
这是一项围绕现有规则配置的改进,不重做执行、调度、归档和发信系统。
|
||||
|
||||
## 2. 方案选择
|
||||
|
||||
| 方案 | 结果 | 决定 |
|
||||
|---|---|---|
|
||||
| 保留逐字段表单,仅加“推荐”按钮 | 仍需理解字段配置,分类条件与样本分离 | 不采用 |
|
||||
| 真实订单驱动,复用现有配置,缺项给出候选 | 能直接核对实际值,沿用已实现的检查和生效保护 | 采用 |
|
||||
| 由模型直接判断分类并自动生效 | 不同节点、同名字段及历史证据容易混淆,缺少确定依据 | 不采用 |
|
||||
|
||||
自动识别使用服务端确定性逻辑,不依赖配置大模型。ZCode 复用同一服务。
|
||||
|
||||
## 3. 具体界面与操作
|
||||
|
||||
### 分类通知规则 `#order-rules`
|
||||
|
||||
保留左侧 Excel 类别和启停开关,右侧仍为四步。
|
||||
|
||||
| 步骤 | 内容 | 人工动作 |
|
||||
|---|---|---|
|
||||
| 01 选择对应的 BPM 订单 | 搜索已采集订单,或从授权连接读取待办、选择一单只读采集;显示真实流程、当前节点、版本、流水号与时间 | 选择订单;新增匹配范围时确认加入 |
|
||||
| 02 核对自动识别的信息 | 业务名称、实际识别值、来源状态;主订单号、标题全部订单、客户、数量、日期、更改信息 | 仅处理缺项、冲突或多个候选 |
|
||||
| 03 设置通知与归档 | 沿用模板、服务器/目录、收件人、附件及文件名日期配置 | 配置本类别的业务要求 |
|
||||
| 04 查看处理结果 | 展示类别命中、标题段落、PDF文件名/路径和邮件预览,以及保存/生效/发布状态 | 核对后按现有步骤保存、检查、确认生效和发布 |
|
||||
|
||||
第01步采用内嵌选择区,不另开一个复杂工作台。默认搜索当前类别关联流程的已采集证据,可主动切换“查看其他流程”。搜索条件覆盖标题、流水号、已能确定的主订单号;实时待办尚未读取表单时只能搜索列表已有标题/流水号,不声称能搜索未采集字段。列表显示来源、流程、版本和真实节点,不能只给一串订单号。
|
||||
|
||||
选择订单后立即发起只读识别请求,无需手动填写流程名、节点名或字段路径。展示示例:
|
||||
|
||||
```text
|
||||
01 选择订单 [搜索订单号/流水号/标题……] [从 BPM 选择]
|
||||
流程:备损订单更改评审 节点:订单专员(订单通知书) 版本:1.4
|
||||
此流程与节点已在当前类别内/[将此流程与节点加入当前类别]
|
||||
|
||||
02 已识别的信息
|
||||
主订单号 148396 来自:表单“订单号”
|
||||
数量 0 来自:表单“订单数量”
|
||||
通知摘要 148396、HA148396 两段标题订单
|
||||
客户 需要选择 [销售客户 · 示例甲] [结算客户 · 示例乙]
|
||||
[调整字段对应(高级)]
|
||||
```
|
||||
|
||||
示例值为虚构验收值。主订单号仍取表单明确字段;标题里的 HA 订单保留在摘要,不能据此生成第二份 PDF 或额外邮件。
|
||||
|
||||
选择样本本身不修改规则。新增的“流程+节点”显示为候选,点击“加入当前类别”才改变页面草稿;同一配对已存在则不重复添加,也不把表单置为未保存。已有其他配对保留,绝不因换一条样本而替换整类适用范围。删除及特殊维护收进“调整匹配范围”,保留原配对语义。
|
||||
|
||||
如果候选同时命中其他类别,列出冲突类别及入口,不自动移动订单、不猜类别、不允许把冲突当作检查通过。按 Excel 分类维护的规则仍是分类依据,选中的订单不能改变收件人、模板、目录、附件要求和发送开关。
|
||||
|
||||
### 字段映射 `#rule-fields`
|
||||
|
||||
保留左侧流程/版本目录以便查看覆盖,右侧默认从真实订单展示自动识别结果。选择器可选当前流程版本的样本,也能“从其他订单定位流程”,选定后自动定位左侧实际流程/版本。
|
||||
|
||||
默认显示业务值和问题;搜索字段标签/实际值、全部字段下拉和技术路径收进“调整字段对应(高级)”。存在歧义的字段在主视图直接给出少量实际候选,不要求先打开技术表单。高级区仍可从当前样本全部真实字段选择,支持搜索。
|
||||
|
||||
管理员能维护;操作员和只读成员仅查看有权访问的样本及识别结果,不出现可提交的配置动作。实时列表读取/采集仍只向管理员开放,不扩大原角色权限。
|
||||
|
||||
## 4. 信息来源和自动识别
|
||||
|
||||
| 信息 | 固定规则 |
|
||||
|---|---|
|
||||
| 流程、版本、节点、流水号、接收时间 | 真实待办元数据,只读;不从标题或模型猜测 |
|
||||
| 主订单号 | 表单明确字段,用于同一任务的一份 PDF;必须出现在标题提取的订单号中 |
|
||||
| 通知摘要 | 标题订单提取,保留全部订单段落和 HA 订单 |
|
||||
| 客户、数量、金额、申请日期、更改原因/内容等 | 复用同版本配置,或依据真实字段唯一中文标签生成候选 |
|
||||
| 分类、收件人、附件要求 | Excel 分类规则;不能用字段推荐反推 |
|
||||
|
||||
配置选择优先级:
|
||||
|
||||
1. 当前流程/版本存在保存草稿时,以该草稿为配置候选,标明“待确认草稿”或“与生效配置不同”。重新用所选订单检查,不直接沿用另一单的旧检查结果。不自动覆盖或填充已有草稿中人为留空的可选项。
|
||||
2. 没有草稿且存在唯一有效映射时,按该映射读取当前订单实际值,标明生效版本。
|
||||
3. 两者都没有时,依据当前真实字段生成唯一候选。内置参考配置只作参考,不能优先覆盖真实配置或充当生效依据。
|
||||
4. 多个有效映射、同名多字段、路径不存在、字段值冲突或版本未知,明确受阻。不同流程名不猜别名,不用其他版本配置兜底。
|
||||
|
||||
推荐规则先复用现有 `assistant/field-skill.cjs` 的精确标签集合,移入领域模块,禁止页面和助手各维护一套。主订单号只接受唯一明确候选;标题一致性用于核对,不能单凭标题猜一个来源。数量为0合法;金额字段不得用于数量;泛称“数量”的零部件字段不自动当成订单数量。未映射且业务未使用的可选字段可留空;被文件名等用途使用的字段必须有效。
|
||||
|
||||
不支持脚本、表达式、自造字段路径或采集页面上不存在的值。需要新增别名时增加可审查规则和回归样本。
|
||||
|
||||
## 5. 待办与历史证据分开
|
||||
|
||||
- 真实待办可提供实际当前节点,但不是所有当前节点都应触发通知。必须明确确认把哪个真实“流程+节点”加入分类,不能以“知会”状态代替节点名称。
|
||||
- 默认配置采样使用 `configuration`,可以读取全部授权待办,避免“必须先有分类条件才能发现配置订单”的循环。此范围仅用于配置,不改变正式执行窗口。
|
||||
- 历史样本仅核对字段。历史列表没有办理节点和通知接收时间时,节点显示“未提供”,不能把“历史查看(未提供办理节点)”加入分类条件。其发起时间不能伪称通知接收时间。
|
||||
- 历史可核验字段映射,但不能作为分类发布的真实通知待办凭据;即使已有历史草稿检查通过也一样。
|
||||
- 显示采集时间和来源;已采集待办是采集时证据,不声称是当前实时状态。读取新待办后重新验证版本、身份与列表有效期。
|
||||
- 已采集样本不会被重复用于新建执行任务、归档或邮件。冻结批次和更早历史处理规则不变。
|
||||
|
||||
## 6. 只读预览、草稿、生效与发布
|
||||
|
||||
自动识别是只读预览,不写配置,不生成检查凭据,不生效、不发布。推荐结果即使内容正确,也要明确显示“当前订单识别结果/配置尚未生效”。
|
||||
|
||||
字段识别通过与分类命中分开展示:候选配对尚未加入当前类别时,只能显示“字段已识别,尚未加入此类别”,不能显示分类已通过。当前页面未保存的文件名日期、目录、模板或配对改变时,预览应采用当前草稿并明确标注未保存;复用纯预览函数生成文件名和邮件示例,不能借用会写发布凭据的正式试运行操作。缺模板、未命中或配置不足时显示问题,不用虚构成功结果填满预览。
|
||||
|
||||
沿用三个独立映射操作:保存草稿、服务端检查、确认生效。界面可在当前规则页展开配置面板完成,避免跳转字段页面后再重新找单;后端仍分别执行既有接口,不做隐式连续写入或一键全启用。
|
||||
|
||||
已有生效映射且没有配置变动时,换一条订单查看不产生新的映射版本。配置未生效时,在第02步给出就地处理入口。真正激活新配置后仍按既有规则暂停关联已发布类别、废弃旧检查;完成分类真实待办检查后由管理员发布。字段映射确认不能顺带发布分类。
|
||||
|
||||
未保存的规则编辑与字段编辑分别记录。只选择/搜索/预览不算修改;点击加入配对、修改字段来源才变为未保存。切换类别、流程、样本上下文或离页时,已有修改仍受统一保护。保存字段配置刷新关联规则时,若规则存在未保存内容,保留页面值并合并版本元数据;不能用整页 reload 丢弃输入。并发修改导致服务端版本冲突时保留本地输入,提示对照后重新检查。
|
||||
|
||||
查询超时可重试。保存/检查/激活超时先读持久状态核实同次操作,不能当作失败立即重放;分别显示“保存成功”和“刷新失败”。过期响应不得覆盖当前类别、样本或新登录状态。
|
||||
|
||||
## 7. 后端与前端边界
|
||||
|
||||
复用只读样本 list/capture、字段映射 draft/check/activate、规则保存/trial/publish。只新增样本目录查询与只读识别预览;不新增执行/发送捷径。
|
||||
|
||||
后端职责:授权样本检索、唯一字段候选、同版本配置选择、统一识别及候选匹配范围检查。前端职责:选择真实订单、展示服务端结果、确认改变页面草稿、保持生命周期。完整表单值只留在授权本机页面/服务端,ZCode 模型仍只收到安全摘要。
|
||||
|
||||
## 8. 不变的约束
|
||||
|
||||
- Node.js 22.13+;现有 Node CommonJS、SQLite加密状态、原生页面模块、Tabler 1.6.1;不新增前端框架或规则表达式语言。
|
||||
- 只在 `C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation` 的 `codex/modular-refactor` 工作;原 `Z:/Order Notification Automation` 源码不改。开工时重新确认分支和工作树。
|
||||
- 保留15类 Excel 业务规则、精确节点匹配、北京时间/公司日历/周一窗口、同窗口同类别一封、冻结批次、受控重试和结果不明核验。
|
||||
- 正式自动通知继续暂停;不发送真实邮件,不办理 BPM 节点;惠州额外通知仍待确认。
|
||||
- 保留账号、数据库、加密身份和原登录,不重置账号,不输出凭据,不安装个人 Codex 技能。
|
||||
- ZCode 复用项目内技能;不开放 Shell/浏览器/原生工具权限,不自动激活映射或发布规则。
|
||||
- 本轮仅编写计划。后续正式服务更新独立执行:通过验收后,先一致性备份,再检查双端口、原登录、页面和暂停状态;不得跳过现场核验。
|
||||
|
||||
## 9. 验收标准
|
||||
|
||||
1. 管理员选一条有完整证据的订单,不手填流程、节点、路径即可看到实际业务值和完整标题订单;确认加入范围后只增一条精确配对。
|
||||
2. 选同版本第二条订单读取第二条的值,既有映射不生成新版本;新版本不沿用旧配置。
|
||||
3. 两个同名主订单号字段时不给默认值,主界面可看实际候选并确认;缺必填/来源消失/标题冲突/非法日期阻塞,0数量合法,金额与数量不混用。
|
||||
4. 历史只核字段,不能自动带出触发节点、生成发布凭据、加入执行队列;非通知待办不会被悄悄纳入通知分类。
|
||||
5. 选单、搜索和预览没有配置写入/执行/邮件副作用。确认保存、生效和分类发布分开;关联类别失效及冻结批次不变规则保持。
|
||||
6. 管理员、操作员、只读成员的权限及连接权限均在服务端校验;不能从目录、草稿检查结果或候选中泄露其他连接样本实际值。
|
||||
7. 桌面和390px可用,移动端无整页横向溢出;搜索、空结果、分页、失败重试、未保存保护、快速换单、登录失效、重复点击和写入超时都有实际验收。
|
||||
8. 页面与ZCode调用同一推荐/识别模块;现有草稿、已发布规则、旧地址和Excel导入保持兼容。
|
||||
|
||||
## 10. 参考与交接
|
||||
|
||||
- [可执行开发计划](../plans/2026-10-20-order-driven-configuration.md)
|
||||
- [现有字段映射指南](../../field-mappings-guide.md)
|
||||
- [真实采样记录](../../field-sampling-verification-2026-10-20.md)
|
||||
- [现有分类规则指南](../../order-rules-guide.md)
|
||||
- [现有交接](../../HANDOFF.md)
|
||||
|
||||
截至计划编写时,采样记录记载31份样本/31版本、11,523字段、31份检查通过草稿、0份生效映射;这是2026-10-20已有记录,开发开工时应重新查询持久状态,不将此数值当作不变前提。缺少“零售国内返工订单更改评审”样本,三个零售实际流程名尚未确认分类关系;本次交互调整不能通过猜别名补齐。
|
||||
Reference in new issue
Block a user