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

44 lines
4.9 KiB
Markdown
Raw Permalink 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-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` 未改;测试通过以下进程级环境使用原工作区依赖和此前临时补齐的依赖,没有修改正式依赖:
```powershell
$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 仍属后续业务工作。