Files
order-notification-automation/docs/HANDOFF.md
T

74 lines
14 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.
# 开发交接(2026-10-20)
## 本轮订单与导出记录台账
用户选择A台账方案,确认删除连接后记录自动进入历史归档、默认聚焦订单相关流程。已实现统一Tabler分段导航(`#records`/`#records-pdf`)、分页台账、来源与日期筛选、详情侧栏和窄屏布局。Workspace删除事务保留安全来源档案;旧孤立来源不猜账号。PDF导出状态、文件可用性和存储归档回执独立,缺失或越界文件不显示下载;不按订单号猜BPM连接归属。
专项回归50项通过,最终页面回归7项通过,新鲜完整514项中513通过、0失败、1可选ZCode CLI跳过;249个JS/CJS文件语法、6份文档33条本地链接及差异检查通过。本机实例已停服并保护备份,恢复核验随后补记。最终结果和恢复记录见[台账验收](records-ledger-verification-2026-10-20.md),设计与步骤见[已确认设计](superpowers/specs/2026-10-20-records-ledger-design.md)及[实施计划](superpowers/plans/2026-10-20-records-ledger.md)。保持自动通知false、version:1,不发真实邮件、不办理BPM、不操作服务机,保留账号/密钥/原业务数据和当前分支,不推送合并。
## 本轮BPM系统设置改造
用户已确认BPM可恢复启停、轻量连接检测和原生被动监听方案,本轮在既有本机测试工作树顺序实施。连接停用改为保留账号/会话的暂停,启用恢复检查;真正删除才清除身份。卡片分别显示登录会话、订单接口与到达监听状态,后台复用近期成功业务请求,明确区分认证过期、权限不足和网络失败。
原生SignalR仅接收已核实的待办/待阅变化线索;首次连接、重连与定期完整对账读取真实列表,事件合并、分页原子提交与来源隔离保留。新监听不触发PDF、归档、发信或BPM节点动作。真实系统已验证鉴权协商、JSON握手和心跳,尚未观察自然业务事件,不能宣称全部流程版本的自然到达已验收。细节见[研究证据与方案](bpm-connection-monitoring-research-2026-10-20.md)、[实施计划](superpowers/plans/2026-10-20-bpm-passive-monitoring.md)与[本轮验收](bpm-monitoring-verification-2026-10-20.md)。
代码提交 `8ca493d`。专项回归133项通过;新鲜完整504项中503通过、0失败、1可选ZCode CLI跳过,240个JS/CJS文件语法通过,8份相关文档31条本地链接和差异检查通过。16:19已通过 `npm start` 恢复原本机测试实例,18765/18766双端口与30项页面资源正常;原登录可用,BPM卡片显示登录会话/订单接口可用、推送已连接,初次只读对账完成;16:20手工轻量检查成功。原账号、密钥、规则、31份采样及草稿、订单、批次和设置核对保持,自动通知仍false、version:1。入口 http://127.0.0.1:18766/#bpm 。备份、证据和自然事件限制见本轮验收。不操作服务机,不发送真实邮件,不办理BPM,不推送或合并。
## 工作区与版本
当前本地开发分支为 codex/modular-refactor,工作区 C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation。原Z盘源码不改。未推送或合并;本轮导航及部署检查见[订单通知管理验收](notification-navigation-verification-2026-10-19.md),前次执行闭环见[执行闭环验收](web-closure-verification-2026-10-19.md)。
2026-10-20 13:36(北京时间)用户明确说明:此前称为“正式进程”的现有实例实际是本机测试进程,本机测试后才到服务机测试;要求沿用现有方式启动,不另建测试副本。已停服备份并通过 `npm start` 启动交付代码,保留原账号与数据,18765/18766双端口就绪;30项页面资源正常,原登录会话可用,分类与字段映射页面已打开核对。31份采样、31份字段草稿、规则、批次、订单、账号和密钥核对一致,自动通知仍为false、version:1。入口为 http://127.0.0.1:18766/#rule-fields 。本次仅更新本机测试实例,未操作服务机、未发真实邮件或办理BPM;下文早先的进程称呼和不重启决定是此次澄清前的记录。备份和检查细节见[本轮验收补充](order-driven-configuration-verification-2026-10-20.md#本机测试服务启动补充)。
源码模块:BPM会话与只读接口在src/modules/bpm;15类规则、窗口、冻结批次及受控发送在order-rules;执行协调与字段证据在order-execution;归档提供器在storage/order-archive.cjs。扩展原PDF四字段文件名保持兼容。web/modules/navigation/lifecycle.js负责页面生命周期。
分类规则目前为两栏:左侧分类卡片及已发布版本启停;右侧为适用通知、通知内容、归档要求、验证与发布。字段来源和生效只在字段映射维护,分类通过已生效接口验证业务分发。`scopes.cjs` 统一精确配对;`trial.cjs` 保持真实采集发布凭据;`import.cjs` 管理 Excel 预览/原子导入,`import-template.cjs` 导出当前规则;`mail/rule-template.cjs` 按规则快照选择模板,缺少新增字段时继续兼容原类别绑定。
前端 `scope-editor.js`、`editor.js`、`preview.js`、`resources.js`、`import-view.js`、`import-parser.js`/`import-worker.js` 与 `view.js` 分开负责范围、配置、中文结果、资源选择、Excel交互/解析及页面生命周期。首次启用仍需真实订单检查并发布;resume 只恢复已发布快照并校验草稿/发布/启停版本,不发布新草稿。旧发布版本首次恢复若没有保留真实采集凭据,需要重新检查发布。详见[分类业务配置验收](rule-business-config-verification-2026-10-19.md)。
字段映射已独立为 web/modules/field-mappings,标准摘要输出包含机芯号、型号、客户简称、出货方式、数量等,各订单段落仍关联原BPM事件。后端 field-mappings.cjs / field-sources.cjs 负责来源、草稿、检查、生效及分类失效;order-execution/field-samples.cjs 单独负责只读采集。旧 adapters 写入仅存草稿。参考映射不能用于真实订单识别/发布;主订单和标题必须一致,新映射摘要仅支持标题。完整说明见[字段映射指南](field-mappings-guide.md),本轮验证见[字段映射验收](field-mappings-verification-2026-10-20.md)。
真实采样已扩为窗口待办、全部待办配置采样、已办/历史配置采样。当前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个检查通过版本供人工核对。
2026-10-20业务职责调整:用户明确“识别BPM订单 → 页面PDF → 分类目录归档 → 每天两次同类汇总一封”,并提供海外实收邮件样例。本轮已完成分类与字段编辑分离、标题出货方式独立提取、海外默认正文按摘要与统一实际目录组织,以及兼容旧格式的新模板变量。全站24页职责、官方参考和后续整合建议见[逐页评审稿](superpowers/specs/2026-10-20-business-flow-and-page-responsibilities-review.md);当前验证及运行状态见[本轮验收](business-distribution-verification-2026-10-20.md)。业务代码版本c53da6f;新鲜完整475项中474通过、0失败、1可选CLI跳过,229文件语法通过。14:45已恢复本机测试服务,双端口与30项资源正常,原账号/密钥/31份采样及草稿/规则/批次保持,自动通知false、version:1;未操作服务机、真实邮件或BPM办理。本段为最新设计方向与运行记录,后文先前内嵌映射相关描述属于历史交付记录。
## 当前要求
[设计要求](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节点人工办理。
- 北京时间、公司日历,周一首封从上个发送工作日最后截止起,历史不自动处理/追补。
- 执行任务、归档证据、冻结批次、受控恢复和核验持久化;unknown禁止自动重发;管理员持依据逐批人工补发。
- 监管草稿、重复连接汇总、旧通用通知写入/调度已退役;旧数据保留查询、旧写入410。
## 真实系统已核验与阻塞
2026-10-19只读核验,门户实际待办接口为 /bpm/worklist 与 /skyworth/todo/v2/workflow/get_process_of_work_v4,读取33条;当前列表没有通知书目标节点。V4详情地址取 executionPointerId,收到时间取 startTime,流程版本取 processVersion。该证据不代表全部类别现场验收完成。
V4详情包含短期SSO入口。提供器只在内存保留入口凭据,持久任务仅保留不带凭据的Process地址;严格验证SSO → 相同tid/pid的Process → XForm跳转链。表单业务值由已观察的DataProvider只读GetFormProcessData加载;采集不执行页面脚本,不调用保存/审批。最近结构采集取得92个字段、48个非空值,但当前非目标节点样本不能替代15类真实通知字段核验。未知路径、版本和缺失业务字段仍受阻,不扩大远程登录白名单。
正式自动发信保持暂停,直到对应类别真实字段、目录、邮箱与批次预览完成现场核验。当前的隔离样本、真实Chromium PDF、临时FileArea与本地SMTP验证不能替代公司系统现场验收。
## 启动、数据与备份
Node.js22.13+、Chrome及锁定依赖,npm start后台启动;service:status/restart/stop管理守护。默认桥接127.0.0.1:18765,工作台0.0.0.0:18766。Windows登录自启沿用当前用户DPAPI及SMB身份,不是未登录运行的系统服务。
正式状态为%LOCALAPPDATA%/OrderNotificationAutomation,包含账号、会话、规则、执行、邮箱、存储、助手等SQLite及加密身份。更新前停止服务后完整备份;保留原数据/密钥/密码,不读取account-recovery。输出PDF需另备份。异机/异Windows用户恢复必须验证DPAPI条件。
运行npm test、JS语法及git diff --check后再更新正式服务,验证双端口、登录、横栏与paused状态。默认不发送真实邮件、不提交BPM。对外发布、推送与合并未获本轮授权。
## 故障处理约束
先查询实际持久状态再决定恢复;网络超时不表示未执行。会话失效与网络失败分开,网络故障不重复提交托管密码。SMTP部分接受/断线/崩溃均人工核验。SMB写入后读回校验路径/大小/SHA256,worker退出后才释放锁。页面离开后禁止旧响应覆盖新页面/新登录。
测试输出与截图位于忽略目录output/verification。原邮件、密码、Cookie、模型Key、数据库、业务PDF及加密密钥不得提交Git。旧阶段调研保留历史用途,不作为当前产品行为说明。