Files
order-notification-automation/docs/modular-refactor-verification-2026-10-19.md
T

4.9 KiB
Raw Blame History

模块化重构与鲁棒性修复验证(2026-10-19)

本轮基于 9854d2d,开发分支 codex/modular-refactor。工作区为 C:\Users\ABS\.codex\worktrees\modular-refactor\Order Notification Automation;原工作区源码保持原状,未推送、合并或部署。

目录与职责

  • src/app/:生命周期装配、扩展桥接、HTTP、资源映射和请求约束;src/server.cjs 保留正式入口与三个导出。
  • src/modules/<业务>/:dashboard、workspace、bpm、mail、storage、notifications、assistant、health、pdf。
  • src/platform/:浏览器、加密与 Windows/守护能力;src/shared/:资源路径、时段和脱敏。
  • web/modules/ 与 tests/<业务>/ 对齐业务边界。通知拆为 store/service/mapping;登录表单交互从 BPM 会话编排中分离。

修复与故障回归

问题 修复 验证边界
第二实例恢复活动通知导致重发 在业务数据库初始化前获得状态目录独占;显式恢复;发送前事务核实完整预留归属 首实例停在假 SMTP verify,第二次 main 被拒且恢复调用为零;首实例继续只发送一次
已保存 SMB 操作无期限、无法停止 可取消工作进程、队列期限、等待实际退出、进程树终止、IPC 大小/二进制校验 真实本地子进程及其后代、挂起/错误响应、取消/超时、队列恢复、归档字节及摘要
浏览器断开后永久复用缓存 按浏览器与 Promise 身份失效缓存和租约,并发重建 本地真实无头 Chrome 关闭后重建、漏事件兜底、旧事件不清理新实例
通知次数耗尽无恢复出口 明确 exhausted;管理员填写依据单项重新入队;批次 CAS 与加密审计 假 SMTP 实际重试成功、角色权限、证据/重复/跨失败周期旧请求、未知发送结果保持人工核验
JSON/Cookie 等凭据脱敏遗漏 共享递归 JSON、敏感键规范化、完整头部脱敏,覆盖输入/回复/历史/摘要 虚构凭据实际传给 runtime 和写入加密历史前已去除,包含嵌套数组与转义 JSON
改端口后守护误杀健康替代进程 每次启动重读校验端口,失败状态明确;控制确认对应新重启状态 真实夹具子进程 A→B、未知占用不被终止、修正配置后真实 CLI 等待成功
中文自启动路径被 ANSI 转换 Unicode IShellLinkW/IPersistFile 创建与读取 本机代码页 1252 的中文项目/状态/启动路径、读回/隐藏执行/外来快捷方式保护

总复核另补两项生命周期缺口:关闭入口立即停止接受新导出,等待已接受渲染与自动归档结束再停止依赖并释放锁;数据库初始化中途失败时关闭已分配的句柄/加密资源。回归覆盖晚到请求体、同步渲染失败、重叠归档与新渲染,以及损坏的持久连接 JSON 修复后重新启动。

验证环境与范围

使用临时 SQLite、临时文件、假 SMTP、本地 HTTP 和真实本地 Chrome/Node 子进程。依赖版本及 package-lock.json 未改;测试通过以下进程级环境使用原工作区依赖和此前临时补齐的依赖,没有修改正式依赖:

$env:NODE_PATH='Z:\Order Notification Automation\node_modules;C:\Users\ABS\AppData\Local\Temp\order-review-deps-20261019\node_modules'
npm test

迁移静态检查已确认原有 49 个测试文件全部保留,74 个脚本语法正常,56 个模块可加载,18 个公开资源地址可定位。加密 vault 实现与迁移前逐字节相同;原路径、密钥身份与 AAD 保持兼容。

最终代码提交 a420d2d 的全量 npm test 正常退出(exit 0):222 项,221 通过、0 失败、1 跳过,236.10 秒。最终复核两项 P2 均关闭,任务规格与代码质量复核通过,无遗留重要问题。补修定向测试 15/15、受影响模块测试 135/135 通过。首轮集成全量为 207 项、206 通过、0 失败、1 跳过;上述最终结果包含其后新增的生命周期回归。

本地完整日志和复核记录保存在忽略目录 output/verification/modular-refactor-2026-10-19/,不随 Git 发布。54 个测试文件包含原有全部 49 个文件。计划六个任务均已完成;代码、方案与本记录保留在本地工作分支供审阅。

未访问真实 BPM、SMB、邮件或模型提供方,未操作正式服务/配置/业务数据。官方 ZCode CLI 测试需要显式提供 ORDER_TEST_ZCODE_CLI,未配置时保留跳过。硬终止 SMB 归档可能留下隐藏临时上传文件或已完整发布但未返回结果的文件;记录保持失败,同摘要重试可核对已有发布结果。

渲染任务若永不结束,正常停止会持续等待并保留独占权,避免旧任务在交接后继续写数据;守护仍保留已有的强制停止路径。本轮不代表公司 BPM→导出→SMB→通知的真实端到端验收,来源适配与自动详情/PDF 仍属后续业务工作。