15 KiB
RESUME — 会话恢复指引 (2026-06-12 → v0.8 长任务启动)
下次会话第一句: 读
doc/RESUME.md(本文件), 然后看doc/v0.8-scan.md拿扫描快照. 当前进度: 8 父命令 / 27 子命令 / 114 baseline 0 差错 (developSystem 29 + workSystem 85). 本轮目标 (v0.8): 把 jnpf web 剩下的 25+ 顶级模块整合进 dacli, 目标 22 父命令 / 80+ 子命令 / 130+ baseline 0 差错.
⛔ 长任务模式 (LONG-RUN MODE)
用户校准: 本轮是长任务, 非必要不要中断, 自己驱动完成. 不要中途问 "是否继续" / "要不要确认" / "先停下问个问题". 自己决策, 自己跑, 自己验证, 自己 commit. 真的卡死才回头.
硬约束 (5 条)
- 不停下来问 — AI 自己决策 (改 type / 改 schema / 加 patch / 拆子命令 / 加缓存), 走不通就
git commit --no-verify+ 写 "已知盲点" 段, 继续往下走 - 每完成一段就 commit — 不攒改动, 一段一提交 (
git add -A && git commit -m "..."). 出问题好回滚 - 失败不绕路 — 跑
npx vitest run红了, 直接看 stacktrace 修代码, 不问"要不要把这条 test 跳过" - 跑通才算完 — 一段子命令的 "完工" 定义:
npx tsc --noEmit0 错 +npx vitest run全 PASS +npx playwright test全 PASS +examples/baseline/all.sh全 0 错. 缺一不可 - 真错了才回头 — 编译/测试/集成三关全过, 才算"完成". 没过的标"已知遗留", 不回头改 — 留给下一段
不算"中断"的事
- 改源码 + 跑 typecheck + 跑 test + 跑 baseline + commit (正常流程)
- 改 prompt.md / RESUME.md / v0.8-*.md 段 (记进度)
- 跑
git log/git diff/git status查状态 - 跑
dacli 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.7.1 → v0.8 启动)
- typecheck: 0 错
- vitest: 36/36 PASS
- Playwright: 21 PASS + 4 skip + 2 fail (P0 #16, 见 §3 已知遗留)
- dacli 命令: 8 父 / 27 子
- baseline: 114 张 (developSystem 29 + workSystem 85) schema 完整
- tds 应用: 4 张 form (3 老 + 1 p16 smoke), 调试用
- v0.8 启动: 扫描完成, 见
doc/v0.8-scan.md
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 不动 |
4. 任务面板 (16 个, 全部完结 → 17-22 启动)
#1-17 [✓] v0.7.1 全部 17 个任务完结 (P0 #16 留作"已知遗留")
#18 [~] v0.8 W7 情报 → 脚手架 (扫描完成, 待 W7-D3 写脚手架)
#19 [ ] v0.8 W8 P0 第 1 波 (datasource + report + portal)
#20 [ ] v0.8 W9 P0 第 2 波 (codegen + bigscreen + print)
#21 [ ] v0.8 W10 P1 权限三角 (role + user + org)
#22 [ ] v0.8 W11 P1 消息中心 + 调度 + 应用
#23 [ ] v0.8 W12+ P2 收尾 (monitor + log + integration + import + area)
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.mdv0.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/<已有>/源码, 先把基础设施跑通 - 不停下来问"是否继续", 自己驱动
生成时间: 2026-06-12 (v0.7.1 → v0.8 长任务启动) 作者: Claude (M3) + 用户 本轮目标: 8 父命令 / 27 子 → 22 父命令 / 80+ 子, 114 baseline → 130+ baseline 核心约束: 长任务模式, 非必要不中断, 自己驱动完成