docs: document module boundaries and isolated review branch

This commit is contained in:
abaishu0730 committed 2026-10-19 08:56:52 +08:00
1 parent db98d78f6b
commit a6b8b53b8d
3 files changed
+21 -17

No files matched your search

+2 -1
View File
@@ -6,8 +6,9 @@
## 设计与部署入口
- [开发交接(2026-10-18)](docs/HANDOFF.md):接续分支、当前进度、启动命令、验证边界及下一步建议。
- [开发交接(2026-10-19)](docs/HANDOFF.md):接续分支、当前进度、启动命令、验证边界及下一步建议。
- [设计要求(当前基准)](docs/design-requirements.md):功能范围、架构、数据存储、权限、验收和实施顺序。
- [模块重构方案(2026-10-19)](docs/superpowers/specs/2026-10-19-modular-refactor-design.md):代码职责、兼容约束及七项鲁棒性修复。
- [部署说明](docs/deployment.md):安装、HTTPS、状态目录及备份。
- [后续业务资料整理表](docs/business-configuration.md):SMB 参数、来源字段和产业接口人需要整理的信息。
- [扫描验证记录](docs/bpm-scan-verification-2026-10-16.md):最近验证及实际范围。
+7 -9
View File
@@ -1,22 +1,20 @@
# 开发交接(2026-10-18)
# 开发交接(2026-10-19)
## 接续分支与运行
仓库:`https://git.simgreek.com/simgreek/order-notification-automation.git`。
当前开发分支是 **`codex/smb-storage`**,包含 SMB、预览、ZCode 和守护的全部工作;旧 `main` 不代表最新能力。最近实现提交:`9a23197` 服务守护和健康面板、`e2bd8c3` BPM 请求异常导致进程退出的修复、`3363a88` ZCode 接入、`fff2a29` 按真实订单号归档、`607b240` BPM 会话 SQLite 持久化。
本轮模块化重构位于本地分支 **`codex/modular-refactor`**,基于 `codex/smb-storage` 的 `9854d2d`。未推送、合并或部署。源码工作区为 `C:\Users\ABS\.codex\worktrees\modular-refactor\Order Notification Automation`;原 `Z:\Order Notification Automation` 工作区保持原源码。旧 `main` 不代表最新能力。
```powershell
git fetch origin
git switch codex/smb-storage
git pull --ff-only origin codex/smb-storage
git switch codex/modular-refactor
npm ci
npm start
npm test
```
新克隆尚无本地分支时用 `git switch --track origin/codex/smb-storage`。本机源码在 `F:\Sync Tool Skyworth\Work Maps\order`,依赖已安装,无须为继续开发重复安装。
新克隆仍以已发布分支为准;本地重构分支尚不可从远端检出。本轮验证复用原工作区和临时目录的依赖(通过 `NODE_PATH`),没有修改正式运行依赖或配置。模块职责及兼容约束见 [批准的重构方案](superpowers/specs/2026-10-19-modular-refactor-design.md)。
本机交接时守护正常,Windows 当前用户登录自启已启用。工作台 `http://127.0.0.1:18766`,健康页 `/#health`,助手 `/#assistant`。
2026-10-18 的交接记录为守护正常、当前用户登录自启已启用;本轮没有操作或重新核实正式服务。默认工作台 `http://127.0.0.1:18766`,健康页 `/#health`,助手 `/#assistant`。
| 命令 | 用途 |
|---|---|
@@ -48,7 +46,7 @@ npm start
## 下一步建议(尚未实施)
用户本轮确认并完成的是“服务守护+健康面板”。以下只是后续建议:
本轮授权范围为模块化重构与七项审查问题修复。以下业务功能仍属后续建议:
1. **批量导出/归档与持久任务记录**:从扫描列表人工勾选,自动打开详情、采集可见字段、生成 PDF、按真实订单号归档;显示进度、支持取消及失败步骤重试。
2. **统一订单任务中心**:按订单号和业务版本关联扫描、导出、归档及独立通知状态,保持 PDF 和通知两条链路独立。
+12 -7
View File
@@ -49,13 +49,18 @@ flowchart LR
| 代码位置 | 职责 |
|---|---|
| `src/server.cjs`、`src/dashboard*.cjs` | 启动、桥接、Web 路由、工作台身份与设置 |
| `src/workspace-*.cjs` | 日历、异常、连接、监管配置与审计 |
| `src/bpm-*.cjs` | 会话加密、远程输入、续登、列表读取、扫描存储与 API |
| `src/mail-*.cjs` | 邮箱存储、收发服务、模板解析与审核 API |
| `src/exporter.cjs`、`extension/` | 可见字段采集、静态快照、PDF 输出 |
| `web/` | 工作台页面及交互 |
| `tests/` | 隔离数据、HTTP、浏览器与存储回归 |
| `src/server.cjs`、`src/app/` | 正式入口、生命周期装配、扩展桥接与 HTTP 公共处理 |
| `src/modules/dashboard/` | 工作台认证、账号、设置、任务记录与业务路由 |
| `src/modules/workspace/` | 日历、异常、连接、监管配置与审计 |
| `src/modules/bpm/` | 远程输入、安全登录表单、续登、列表读取、扫描存储与 API |
| `src/modules/mail/` | 邮箱存储、收发服务、模板解析与审核 API |
| `src/modules/storage/` | SMB 隔离工作进程、文件边界、归档与预览 |
| `src/modules/notifications/` | 来源映射、通知事务、时段发送及人工核验/恢复 |
| `src/modules/assistant/`、`src/modules/health/` | 受控模型对话与只读运行健康 |
| `src/modules/pdf/`、`extension/` | 可见字段采集、静态快照、PDF 输出 |
| `src/platform/`、`src/shared/` | 浏览器、加密、守护、自启动、状态目录独占与公共路径/脱敏/时段计算 |
| `web/modules/<业务>/` | 各业务页面与交互;公开资源 URL 保持兼容 |
| `tests/<业务>/`、`tests/fixtures/` | 按模块组织的隔离数据、HTTP、浏览器与工作进程回归 |
## 4. 角色、连接与登录