Files
dacli/doc/RESUME.md
T

18 KiB

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 记忆
  • 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 分钟)

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 分钟过一遍)

  • 读 doc/RESUME.md ✓ (本文件)
  • 读 doc/v0.8-scan.md ✓ (扫描快照)
  • 跑 npx tsc --noEmit (0 错确认)
  • 跑 npx vitest run (36/36 确认)
  • 跑 npx tsx src/cli.ts --help (8 父命令确认)
  • 跑 npx tsx src/cli.ts status (login OK)
  • 写 doc/v0.8-plan.md (W7-D1)
  • 写 doc/v0.8-endpoints.md (W7-D2)
  • 4 新父命令脚手架 (W7-D3)
  • 4 新 extractor 脚手架 (W7-D4)
  • W7 集成回归 (W7-D5)
  • 不直接动 src/commands/<已有>/ 源码, 先把基础设施跑通
  • 不停下来问"是否继续", 自己驱动

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 核心约束: 长任务模式, 非必要不中断, 自己驱动完成