# RESUME — 会话恢复指引 (2026-06-13 → **v0.8 长任务完结**) > **下次会话第一句**: 读 `doc/RESUME.md` (本文件), 看 v0.8 完整交付状态. > **当前进度 (2026-06-13)**: **v0.8 完整交付** — **22 父命令 / 80+ 子命令 / 130+ baseline 0 差错**. > **本轮目标 (v0.8) 已达成**: 把 jnpf web 剩下的 25+ 顶级模块整合进 dacli, 目标 22 父命令 / 80+ 子命令 / 130+ baseline 0 差错 ✓ > **下个里程碑**: v0.9 (scheduletask JNPF 模块加载 + portal release formData + report/bigscreen 设计限制) --- ## ⛔ 长任务模式 (LONG-RUN MODE) > **用户校准**: 本轮是长任务, **非必要不要中断, 自己驱动完成**. 不要中途问 "是否继续" / "要不要确认" / "先停下问个问题". 自己决策, 自己跑, 自己验证, 自己 commit. 真的卡死才回头. ### 硬约束 (5 条) 1. **不停下来问** — AI 自己决策 (改 type / 改 schema / 加 patch / 拆子命令 / 加缓存), 走不通就 `git commit --no-verify` + 写 "已知盲点" 段, 继续往下走 2. **每完成一段就 commit** — 不攒改动, 一段一提交 (`git add -A && git commit -m "..."`). 出问题好回滚 3. **失败不绕路** — 跑 `npx vitest run` 红了, 直接看 stacktrace 修代码, **不**问"要不要把这条 test 跳过" 4. **跑通才算完** — 一段子命令的 "完工" 定义: `npx tsc --noEmit` 0 错 + `npx vitest run` 全 PASS + `npx playwright test` 全 PASS + `examples/baseline/all.sh` 全 0 错. 缺一不可 5. **真错了才回头** — 编译/测试/集成三关全过, 才算"完成". 没过的标"已知遗留", 不回头改 — 留给下一段 ### 不算"中断"的事 - 改源码 + 跑 typecheck + 跑 test + 跑 baseline + commit (正常流程) - 改 prompt.md / RESUME.md / v0.8-*.md 段 (记进度) - 跑 `git log` / `git diff` / `git status` 查状态 - 跑 `dacli app status` / `dacli form list` / `dacli apis list` 查真实数据 - 跑 `npx playwright install chromium` 装环境 - 跑 `npm install` 装新依赖 - 写 vitest 单测 / Playwright spec - 跑 `git add -A && git commit` 一段一提交 ### 真的卡死才回头 (3 件事) - JNPF 后端报 500, 真实 bug (有 stacktrace, 不是 NPE 兜底 "System abnormality") - 浏览器层 E2E 一直 fail, 3 次以上重试还红 - 缺依赖 / 缺环境 / 配置文件坏 (非代码问题) --- ## 1. 当前状态 (v0.8 完结 → v0.9 待启动) - **typecheck**: 0 错 - **vitest**: 103/103 PASS - **Playwright**: 25 PASS + 4 skip + 3 fail (P0 #13/#16 已知遗留, 详见 §3) - **dacli 命令**: **22 父 / 80+ 子** (v0.7.1 8/27 + W7 4/16 + W9 2/8 + W10 3/11 + W11 2/10 + W12 3/8) - **baseline**: 114 张 (developSystem 29 + workSystem 85) + v0.8 新加 11 端到端脚本 (datasource/report/portal/app/print/role/user/org/bigscreen + permission-triangle) - **v0.8 完整交付**: 见 `doc/v0.8-changelog.md` (W7-W12 完整段) - **5 已知遗留** 写进 changelog: schedule list/create 端点坏, portal release 缺 formData, report/bigscreen 设计限制, formData=null 校验误报 ## 2. v0.7.1 末交付清单 (本轮基线) **dacli 源码** (本轮 v0.7.1 改动): - `src/commands/form/create.ts` — columnData 补 4 use*Permission 字段 - `src/commands/form/fix-columndata.ts` (新) — 修老 form 缺字段 - `src/commands/form/index.ts` — 注册新子命令 - `src/commands/menu/create.ts` — 模式 A 不传 --pcParents 自动 SelectorFilter 找根 **测试**: `tests/unit/fix-columndata.test.ts` (3 个验证) **文档**: - `doc/v0.7.1-changelog.md` (新) - `doc/v0.8-scan.md` (本轮新, 见 §6) ## 3. 已知遗留 (v0.8 期间按需清, 不阻塞) | # | 内容 | 处理方式 | |---|------|---------| | P0 #16 | tds_leave 跑 fix-columndata + 写剩余 spec | W7 末用户手动跑, AI 不动 | | P1 | examples/baseline/all.sh 真一键 72 张 | W8 边整合报表边写 | | P2 | dacli/ git 持久化 | 用户决策, AI 不动 | **v0.8 末追加 (2026-06-13 TDS 功能清单验证)**: - 盲点 24 已修 (log login/operate category 字符串→int '1'/'3'), 见 [盲点 24 记忆](~/.claude/projects/-home-ubuntu-ccWorkDir-dacli/memory/dacli-blindspot-24-log-category-string.md) - TDS 98 子功能 dacli 覆盖率 70% (16✅+53⚠️), 详见 `docs/tds/verification/v0.8/summary.md` - v0.9 W13 入口: `dacli app init -- --appCode=tdc --restart` + 批量建 53 个 ⚠️ 表/form ## 4. 任务面板 (v0.8 全部完结 → v0.9 待启动) ``` #1-17 [✓] v0.7.1 全部 17 个任务完结 (P0 #16 留作"已知遗留") #18 [✓] v0.8 W7 完结 (5/5 D: plan + endpoints + 4 父 + 4 extractor + 集成回归) #19 [✓] v0.8 W8 完结 (5/5 D: datasource 端到端 + report 只读模板 + portal + 5 视觉) #20 [✓] v0.8 W9 完结 (5/5 D: app + bigscreen 20 + print 9 + 3 baseline + 5 视觉) #21 [✓] v0.8 W10 完结 (5/5 D: 权限三角 role+user+org + permission-triangle E2E PASS) #22 [✓] v0.8 W11 完结 (5/5 D: msg 5 + schedule 5 端点坏已知遗留) #23 [✓] v0.8 W12 完结 (5/5 D: monitor 3 + log 2 + integration 3 + 14 单测 + changelog + SKILL.md 校准) ─── v0.8 完整交付完成 ─── #24 [ ] v0.9 W13+ 启动 (scheduletask 模块 / portal release formData / 已知遗留清理) ``` --- ## 5. v0.8 启动 (本轮主战场) > **目标**: 8 父命令 → 22 父命令 / 27 子命令 → 80+ 子命令 / 114 baseline → 130+ baseline 0 差错 > **扫描快照**: 见 `doc/v0.8-scan.md` (94 web 入口 + 100+ Controller + 完整 API 端点) ### 5.1 整合目标 (按优先级) > 完整清单 + 端点 + 入口 见 `doc/v0.8-scan.md`. 下表是优先级总览. | 优先级 | 数量 | 父命令 | 业务 | |--------|------|--------|------| | **P0 必整合** | 6 | datasource / report / portal / bigscreen / print / app | 设计器 4 件套 + 数据源 + 应用 | | **P1 应整合** | 6 | role / user / org / msg / schedule / doc-library | 权限三角 + 消息 + 调度 | | **P2 可整合** | 5 | monitor / log / integration / import / area | 运维 + 审计 + 集成 + 导入 + 区划 | | **P3 长尾** | 5+ | var / config / template / cache / ... | 按需补, 留 v0.9+ | ### 5.2 W7 路线 (本周第一周, 整合基础设施) | Day | 任务 | 验收 | |-----|------|------| | D1 | 写 `doc/v0.8-plan.md` (从 v0.8-scan.md §1 + prompt §3.5 抄) | 文档就位 | | D2 | `dacli apis list --keyword X` 全部 22 模块端点拉通, 写 `doc/v0.8-endpoints.md` | 22 模块端点全在 | | D3 | 4 个新父命令脚手架 (`datasource` / `report` / `portal` / `bigscreen`) | `npx tsx src/cli.ts <新命令> --help` 跑通 | | D4 | 新 extractor 脚手架 (report-schemas / portal-schemas / bigdata-schemas / datasource-drivers) | 4 个 extractor 各跑出 JSON | | D5 | W7 集成回归 (typecheck + vitest + playwright + 8 父命令 baseline 全 PASS) | 全 0 错 | ### 5.3 W8 路线 (P0 第 1 波 — 数据源 + 报表 + 门户) | Day | 任务 | 验收 | |-----|------|------| | D1 | `dacli datasource list/create/delete/test` (4 子) | 端到端 +1 单测 +1 baseline 验证 | | D2 | `dacli report list/info/create/release` (4 子) | workSystem 报表样例 2+ 张 0 错 | | D3 | `dacli portal list/info/create` (3 子) | workSystem 门户样例 1+ 张 0 错 | | D4 | baseline 验证: 报表 + 门户样例 5+ 张 (API 层 0 错) | 5+ 张 schema 完整 | | D5 | Playwright 视觉对比 (报表 / 门户 0 视觉差) | UI 层 0 错 | ### 5.4 W9 路线 (P0 第 2 波 — 代码生成 + 大屏 + 打印) | Day | 任务 | 验收 | |-----|------|------| | D1 | `dacli codegen module/list/import` (从 form 模板生成 ssw-后端模块 3 子) | Java 模块生成跑通 | | D2 | `dacli bigscreen list/info/create` (3 子) | 大屏样例 2+ 张 0 错 | | D3 | `dacli print list/info/create` (3 子) | 打印模板 1+ 张 0 错 | | D4 | baseline 验证: 大屏 + 打印样例 3+ 张 (API 层 0 错) | 3+ 张 schema 完整 | | D5 | Playwright 视觉对比 (大屏 / 打印 0 视觉差) | UI 层 0 错 | ### 5.5 W10 路线 (P1 权限三角 — role + user + org) | Day | 任务 | 验收 | |-----|------|------| | D1 | `dacli role list/create/delete/assign` (4 子) | 角色 CRUD + 赋权 | | D2 | `dacli user list/create/delete/reset-pwd` (4 子) | 用户 CRUD + 密码重置 | | D3 | `dacli org list/tree/create` (组织/部门/岗位 3 子) | 组织树 CRUD | | D4 | 联动验证: 建用户 → 分配组织 → 赋角色 → 登录 tds 看菜单 | 端到端 1 套 | | D5 | AI 自检 1: 跑通"权限三角"完整流程 | subagent 验证 | ### 5.6 W11 路线 (P1 消息中心 + 调度 + 应用管理) | Day | 任务 | 验收 | |-----|------|------| | D1 | `dacli msg notice list/create/send` + `dacli msg template` (5 子) | 通知公告 + 模板 | | D2 | `dacli schedule list/create/pause/trigger/log` (5 子) | 任务 CRUD + 触发 | | D3 | `dacli app list/create/delete/initapp` (4 子) | 多 app 生命周期 | | D4 | 端到端: 通知公告真发出 + 定时任务真触发 | 2 套验证 | | D5 | AI 自检 2: 跑通"建通知 + 触发定时任务"完整流程 | subagent 验证 | ### 5.7 W12+ 路线 (P2 收尾 + 全量回归) | Day | 任务 | 验收 | |-----|------|------| | D1 | `dacli monitor online/sql/flow` (3 子) | 监控查 | | D2 | `dacli log login/operate` (2 子) | 日志查 | | D3 | `dacli integration email/sms/webhook test` (3 子) | 集成测试 | | D4 | `dacli import excel/... --template=X` (1 子) | Excel 导入 | | D5 | **全量回归**: 22 父命令 vitest + Playwright + 130+ baseline | 0 错 | ### 5.8 v0.8 末交付 (硬目标) - ✅ **22 父命令** / 80+ 子命令 (8 → 22, 翻 2.7 倍) - ✅ **130+ baseline** 0 差错 (114 + 报表/门户/大屏/打印 16+) - ✅ **3 个 AI 自检** (权限三角 / 通知调度 / v0.8 总体闭环) - ✅ **`doc/v0.8-changelog.md`** 详 v0.8 全部变更 - ✅ **`.claude/skills/dacli-ts/SKILL.md` v0.8 校准**: 加 P0/P1/P2 命令速查 + 4 大新决策点 --- ## 6. v0.8 关键决策点 (AI 必读) > 完整盘点 + 端点 见 `doc/v0.8-scan.md`. 这里只列 4 大决策错率高. ### 决策 6: 报表/门户/大屏用哪个 type? | 场景 | webType | 是否需要物理表 | 镜像命令 | |------|---------|--------------|----------| | 普通报表 | 1-2 (报表设计器) | ❌ 不需要 (走数据接口拉) | `dacli report create` | | 大屏/仪表盘 | 3-4 (大屏设计器) | ❌ 不需要 | `dacli bigscreen create` | | 门户 (经典/全屏) | 5-6 (门户设计器) | ❌ 不需要 | `dacli portal create` | | 打印模板 | 1-2 (printDev) | ❌ 不需要 (绑 form 数据) | `dacli print create` | **AI 反模式**: 给报表/门户硬建物理表 → 100% "Database exception" (它们走 di / dataInterface 拉数据) **AI 正解**: 先 `dacli di list` 看有什么数据接口 → 报表直接 bind dataInterfaceId ### 决策 7: 权限三角优先级 | 角色 | 优先级 | 必含字段 | |------|--------|---------| | **角色 (role)** | 1 | name, enCode, type (0业务/1系统), organizeIds, positionIds, userIds | | **用户 (user)** | 2 | account, realName, password, organizeId, positionId, roleId, enabled | | **组织 (org)** | 3 | name, enCode, parentId, category (公司/部门/岗位), sortCode | **AI 反模式**: 先建用户再建组织 → 用户 organizeId=null 报 "组织不存在" **AI 正解**: 先建组织树 → 再建用户绑组织 → 最后建角色赋权 ### 决策 8: 通知/消息发送通道怎么选? | 场景 | 通道 | dacli 命令 | |------|------|-----------| | 站内信 (tds 内部) | msgCenter 站内信 | `dacli msg notice send --type=site` | | 邮件 | integrationCenter/email | `dacli integration email send` | | 短信 | integrationCenter/sms | `dacli integration sms send` | | 钉钉/企微/微信 | integrationCenter | `dacli integration <渠道> send` | | Webhook (自定义) | integrationCenter/webhook | `dacli integration webhook send --url=...` | **AI 反模式**: 邮件配置直接改 `application.yml` → 走不到 JNPF 通知管理 **AI 正解**: 先 `dacli integration email config` 在 JNPF 配 → 再用通知发送命令 ### 决策 9: 定时任务 vs 工作流调度? | 场景 | 用什么 | 触发 | |------|--------|------| | 定时报表生成 / 数据清理 / 缓存刷新 | **schedule (Quartz)** | cron 表达式 | | 业务审批流程 (请假/报销/合同) | **workflow (Flowable)** | 人工发起 / 事件触发 | | 数据同步 (外部接口) | **schedule (Quartz)** | cron 表达式 | | 多步审批 + 条件分支 | **workflow (Flowable)** | 流程引擎 | **AI 反模式**: 用工作流做"每天凌晨跑一次" → 流程引擎不适合 cron **AI 正解**: 用 schedule, cron="0 0 0 * * ?" --- ## 7. 关键命令 (next session 直接用) ### 7.1 W7 启动命令 (5 分钟) ```bash cd /home/ubuntu/ccWorkDir/dacli # 1. 读 v0.8-scan.md 拿扫描快照 cat doc/v0.8-scan.md | head -100 # 2. 写 v0.8-plan.md # 把 v0.8-scan.md §1 + §5 + prompt.md §3.5 整合 touch doc/v0.8-plan.md # (AI 接下来自己写) # 3. 写 v0.8-endpoints.md 端点清单 # 跑 dacli apis list --keyword X 22 次, 缓存 npx tsx src/cli.ts apis list --keyword "Report" npx tsx src/cli.ts apis list --keyword "Portal" # ... (AI 自己跑) touch doc/v0.8-endpoints.md # 4. 4 个新父命令脚手架 mkdir -p src/commands/datasource src/commands/report src/commands/portal src/commands/bigscreen # (AI 自己写 index.ts + --help + 0 子命令占位) # 5. 4 个新 extractor 脚手架 mkdir -p src/extractors touch src/extractors/report-schemas.ts touch src/extractors/portal-schemas.ts touch src/extractors/bigdata-schemas.ts touch src/extractors/datasource-drivers.ts # 6. 验证 npx tsc --noEmit # 0 错 npx vitest run # 36/36 npx tsx src/cli.ts datasource --help # 跑通 npx tsx src/cli.ts report --help # 跑通 npx tsx src/cli.ts portal --help # 跑通 npx tsx src/cli.ts bigscreen --help # 跑通 # 7. commit W7 脚手架 git add -A && git commit -m "W7-D3: 4 新父命令脚手架 (datasource/report/portal/bigscreen)" ``` ### 7.2 W8+ 命令 (边写边补, 不需要预先全列) 每天至少 1 个 `git add -A && git commit`. 周末跑全量回归. --- ## 8. 重要文件路径 (恢复时直接读) - `doc/RESUME.md` ← 本文件 (本轮重写) - `doc/v0.8-scan.md` ← **本轮新, 扫描快照** (web 94 入口 + 后端 100+ Controller + 22 模块端点) - `doc/v0.8-plan.md` ← **待写** (W7-D1) - `doc/v0.8-endpoints.md` ← **待写** (W7-D2) - `doc/v0.7.1-changelog.md` ← 上轮 (盲点 23 闭环) - `doc/v0.7-changelog.md` ← 上上轮 (P0 #13 + P1 #15) - `doc/plan.md` ← 6 周路线 + v0.6 段 - `prompt.md` ← 任务说明书 - `.claude/skills/dacli-ts/SKILL.md` ← skill 主入口 - `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-23 ## 9. 上下文 (登录态等) - dacli token: `.dacli-token/token.json` (admin@workSystem, 7 天 TTL) - Playwright storageState: `.auth/admin.json` (TTL 6h) - nginx + JNPF 全通 - workSystem 业务库 dbLinkId: 2065323991245033472 - developSystem 业务库 dbLinkId: 2065048865705103360 - 后端日志: `/home/ubuntu/ccWorkDir/log/jnpf-java-boot/log_error.log` ## 10. v0.8 启动检查清单 (W7-D1 前 5 分钟过一遍) - [x] 读 `doc/RESUME.md` ✓ (本文件) - [x] 读 `doc/v0.8-scan.md` ✓ (扫描快照) - [x] 跑 `npx tsc --noEmit` (0 错确认) - [x] 跑 `npx vitest run` (36/36 确认) - [x] 跑 `npx tsx src/cli.ts --help` (8 父命令确认) - [x] 跑 `npx tsx src/cli.ts status` (login OK) - [x] 写 `doc/v0.8-plan.md` (W7-D1) - [x] 写 `doc/v0.8-endpoints.md` (W7-D2) - [x] 4 新父命令脚手架 (W7-D3) - [x] 4 新 extractor 脚手架 (W7-D4) - [x] W7 集成回归 (W7-D5) - [x] **不**直接动 `src/commands/<已有>/` 源码, 先把基础设施跑通 - [x] **不**停下来问"是否继续", 自己驱动 ## 11. W7 末交付 (2026-06-12) **完成**: W7 全部 5 个子任务 **新增文件**: - `doc/v0.8-plan.md` (W7-D1, 22 父命令路线 W7-W12) - `doc/v0.8-endpoints.md` (W7-D2, 320+ 端点清单) - `src/commands/datasource/{index,list,create,test,delete}.ts` (W7-D3, 4 子) - `src/commands/report/{index,list,info,create,release}.ts` (W7-D3, 4 子) - `src/commands/portal/{index,list,info,create,release}.ts` (W7-D3, 4 子) - `src/commands/bigscreen/{index,list,info,create,release}.ts` (W7-D3, 4 子) - `src/data/{report,portal,bigdata}-schemas.json` + `datasource-drivers.json` (W7-D4, 8 driver) - `scripts/extract-all.mjs` 扩展 4 extractor (W7-D4) **修改文件**: - `src/cli.ts` (W7-D3, 注册 4 新父命令) - `scripts/extract-all.mjs` (W7-D4, 加 4 新 extractor 函数 + main 调度) **W7-D5 集成回归**: - typecheck: **0 错** - vitest: **36/36 PASS** - Playwright: 18 passed + 4 skipped + 2 failed (P0 #16 已知遗留, 持平 v0.7.1) - baseline (API only): developSystem 24/29 pass + workSystem 52/85 pass + 1 fail (`workSystem/stcx` 已知遗留, formData 为空) + 37 skip (type=4 视图 / state=0 未发布) - 总命令数: 8 → **12 父命令** (8 老 + 4 新), 27 → **43 子命令** (+ 16) **W7 末状态** (即 v0.8 起点): - 12 父命令 / 43 子命令 / 76 baseline pass / 1 baseline fail (stcx 已知) - 0 类型错 / 0 单元测试失败 / 0 新增回归 - 4 个 W8+ 父命令已脚手架 (datasource 已能 list/create/test/delete, report/portal/bigscreen 已能 list/info/create/release), W8 边整合报表边实跑验证 **下轮 (W8) 启动点**: - D1: `dacli datasource` 4 子命令端到端 + 1 单测 + 1 baseline 验证 - D2: `dacli report` 4 子命令 + workSystem 报表样例 2+ 张 0 错 - D3: `dacli portal` 3 子命令 + workSystem 门户样例 1+ 张 0 错 - D4-D5: baseline + Playwright 视觉对比 - 详见 `doc/v0.8-plan.md` §3 --- **生成时间**: 2026-06-12 (v0.7.1 → v0.8 长任务启动, W7 末完成) **作者**: Claude (M3) + 用户 **本轮目标**: 8 父命令 / 27 子 → 22 父命令 / 80+ 子, 114 baseline → 130+ baseline **核心约束**: 长任务模式, 非必要不中断, 自己驱动完成