99 lines
19 KiB
Markdown
99 lines
19 KiB
Markdown
# 开发交接(2026-10-21)
|
||
|
||
## 本轮一级导航去重(最新状态)
|
||
|
||
用户指出订单中心、邮件批次同时存在左侧入口和顶部页签,属于重复设计。已将两页作为独立一级页面,移除重复顶部页签及“返回订单通知管理”;通知配置统一归入业务设置,相关四个配置子页正确高亮业务设置。原hash、筛选/页码缓存、前后退与离页保护保留。
|
||
|
||
代码提交d03a4cc。新增回归先红后绿,导航、分页与关联设置10文件64项全部通过;7个改动JS/CJS语法及差异检查通过。停服完整备份并验证后已npm start恢复原本机实例,双端口心跳与37项资源正常,原浏览器登录和页面读验收通过。原账号/密钥/31份样本及草稿/规则/业务历史/主设置/配对键/PDF台账摘要保持,两个自动开关仍false、version1。未发送真实邮件、未办理BPM、未操作服务机、未推送合并。详见[导航去重验收](leaf-navigation-verification-2026-10-21.md)。
|
||
|
||
## 全局优化已交付
|
||
|
||
|
||
用户在全局审查后要求“全部优化”,已按[本轮设计](superpowers/specs/2026-10-21-global-optimization-design.md)及[计划](superpowers/plans/2026-10-21-global-optimization.md)完成。业务执行/监听、统一首页/订单中心/邮件批次、分页与权限、归档纠正/恢复、账号交接、PDF历史保留、助手会话归档和受控备份均已验收;旧生产发送器与重复入口已退役。代码提交69583e8,前序84e2f0d/1148aa6及核心/监听提交均在本地codex/modular-refactor,未推送合并。
|
||
|
||
新鲜npm ci后最终完整640项:639通过、0失败、1可选ZCode CLI跳过;295个JS/CJS语法、8份文档50条本地链接及1个锚点、差异与暂存敏感文件检查通过。模块和最终复审门禁通过,中间失败及修复证据完整保留,见[全局优化验收](global-optimization-verification-2026-10-21.md)与[复审记录](reviews/2026-10-21-global-optimization-final-review.md)。
|
||
|
||
12:30已按原方式npm start恢复原本机测试实例;18765/18766双端口心跳和37项页面资源正常,原浏览器登录仍有效。原账号/原有受保护键/31份样本/31份字段草稿/规则/订单/批次/BPM托管账号摘要均保持;原发送计划等配置、扩展配对键和PDF台账核对保持。通知设置version1,enabled=false、processingEnabled=false、processingSince=null。实际界面已核对首页、订单、批次、BPM全局同步(原启用、5分钟)、系统健康/容量、团队账号及PDF台账。入口http://127.0.0.1:18766/#overview。
|
||
|
||
停服原始备份和新增受控备份均保留;新增备份C:/Users/ABS/AppData/Local/OrderNotificationAutomationBackups/global-optimization-verified-20261021-112248,8518文件5,704,104字节3个目录绑定vault,create/verify均退出0。换目录解密和PDF引用恢复以合成数据16项验证,未覆盖原状态,见[备份恢复指南](backup-restore-guide.md)。
|
||
|
||
现场项:当前BPM连接验证未通过/查询跳转,自动续登未开启;邮箱与SMB未配置,字段草稿尚待实际发布。服务可访问不代表真实业务链已联调。历史47次存储失败根因尚未证实,本轮确证的一次key_protect子进程15秒超时已加入受限重试及安全诊断,不能据此宣称历史故障根治。自动处理与发信继续暂停;未发真实邮件、未办理BPM、未操作服务机。
|
||
|
||
## 本轮同步设置与记录导航
|
||
|
||
用户明确要求实施[同步设置迁移与页签/分页优化](superpowers/plans/2026-10-20-records-navigation.md)。全局同步设置已迁入BPM连接页独立卡片,管理员保存、其他角色只读;记录页只保留摘要与手工同步。两页白名单状态写入hash和按账号隔离的sessionStorage,退出及认证失效清理;支持25/50/100条、数字页码、实际末页修正、加载禁重和失败重试。后台更新只提示,详情和列表不自动重画;显式查询不会把未应用输入混入翻页。
|
||
|
||
代码提交`c215e6e`。专项已验证页签/刷新/前后退/滚动位置、账号隔离、配置失败与保存离页、慢响应及详情清理;新鲜完整527项中526通过、0失败、1可选ZCode CLI跳过,254文件语法/6份文档36条本地链接/差异检查通过。18:35恢复原本机实例,双端口healthy、35项资源正常;原账号/密钥/31份采样和草稿/规则/订单/批次核对保持,自动发信false、version:1。备份与当前同步配置逐项相同:开启、每5分钟。实际已核对BPM设置卡片、16条到达记录及每页条数的刷新/往返恢复,核对后恢复25条默认;入口 http://127.0.0.1:18766/#records ,设置 http://127.0.0.1:18766/#bpm 。最终验收与服务恢复见[本轮记录](records-navigation-verification-2026-10-20.md)。不发送真实邮件、不办理BPM、不操作服务机、不推送合并。
|
||
|
||
## 本轮订单与导出记录台账
|
||
|
||
用户选择A台账方案,确认删除连接后记录自动进入历史归档、默认聚焦订单相关流程。已实现统一Tabler分段导航(`#records`/`#records-pdf`)、分页台账、来源与日期筛选、详情侧栏和窄屏布局。Workspace删除事务保留安全来源档案;旧孤立来源不猜账号。PDF导出状态、文件可用性和存储归档回执独立,缺失或越界文件不显示下载;不按订单号猜BPM连接归属。
|
||
|
||
代码提交`20bb686`。专项回归50项通过,最终页面回归7项通过,新鲜完整514项中513通过、0失败、1可选ZCode CLI跳过;249个JS/CJS文件语法、6份文档33条本地链接及差异检查通过。17:34已恢复原本机实例,双端口healthy、32项资源可用,原登录/账号/密钥/规则/31份采样和草稿/订单/批次核对保持;自动通知false、version:1。实际默认13条订单相关到达,历史归档4条,PDF0条;已只读检查详情与导航,入口 http://127.0.0.1:18766/#records 。最终结果和恢复记录见[台账验收](records-ledger-verification-2026-10-20.md),设计与步骤见[已确认设计](superpowers/specs/2026-10-20-records-ledger-design.md)及[实施计划](superpowers/plans/2026-10-20-records-ledger.md)。不发真实邮件、不办理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。旧阶段调研保留历史用途,不作为当前产品行为说明。
|