diff --git a/doc/RESUME.md b/doc/RESUME.md new file mode 100644 index 0000000..8150ac4 --- /dev/null +++ b/doc/RESUME.md @@ -0,0 +1,365 @@ +# 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 +**核心约束**: 长任务模式, 非必要不中断, 自己驱动完成 diff --git a/doc/v0.6-changelog.md b/doc/v0.6-changelog.md new file mode 100644 index 0000000..b33bdca --- /dev/null +++ b/doc/v0.6-changelog.md @@ -0,0 +1,87 @@ +# v0.6 Changelog (2026-06-12) + +> 用户反馈驱动的 5 大校准 + 内化 ssw-e2e-test 真实路径。 + +## ⭐ Bug 修复 (P0) + +### 1. `dacli form list` 漏 33+ 张 form +- **症状**: workSystem 报 52, 实际 85; developSystem 报 20, 实际 29 +- **根因**: `src/commands/form/list.ts:24` 调 `/visualdev/Base/list` 子端点 — 后端 `VisualdevController.getList` (line 179) 强制 `setEnableFlow(1)` → 只返工作流子集 +- **修**: 改用 `/visualdev/Base` (`VisualdevController.list` line 133, 公开方法) +- **影响**: `src/commands/form/list.ts` + `src/commands/form/import.ts` (反查 id) + +### 2. `dacli menu create` 缺关键字段, 浏览器看不到菜单 +- **症状**: Java 字段版能创菜单但语义不全; 用户校准: "应该按 web/** 怎么写" +- **根因**: 走低级 POST `/api/system/Menu` 漏 moduleId/propertyJson/pageAddress/isXxxAuthorize +- **修**: 优先走 web 真路径 POST `/api/visualdev/Base/{formId}/Actions/Module` (来自 `web/views/onlineDev/formDesign/components/CreateMenuModal.vue handleSubmit`) +- **影响**: `src/commands/menu/create.ts` 重写 (--formId 走 Actions/Module 高级 API) + +### 3. `dacli menu delete` 报 "System abnormality" 删不掉 +- **症状**: 已挂 form 的菜单 (pcIsRelease=1) DELETE 不通 +- **修**: 加 `dacli menu unrelease --formId=X` (Actions/Module pc=0 app=0) +- **影响**: `src/commands/menu/unrelease.ts` 新加 + `index.ts` 注册 + +## ⭐ 浏览器层基础设施 (P1) + +### 4. Playwright `projects.setup` + storageState 会话复用 +- **改前**: 每个 spec 重登 5s+ +- **改后**: setup project 跑一次, ch +romium project 自动注入. TTL 6h. +- **影响**: `playwright.config.ts` + `tests/e2e/auth.setup.ts` + `tests/e2e/_helpers/auth.ts` + `tests/e2e/_helpers/auth-reuse.spec.ts` (3 个验证测试) + +### 5. JNPF 真实 URL 路径内化 (from ssw-e2e-test) +- 登录: `/jnpf_app_/login` (不是 `/web/#/login`) +- 业务: `/jnpf_app_/model/` (能 CRUD 保存) +- 预览: `/previewModel?isPreview=1&id=X` (只读, 不能保存!) +- 字段 ID: `#form_item_account` / `#form_item_password` / `button:has-text("登 录")` (有空格) +- 规则: **挂菜单 + admin 角色授权后**, /model/X 才生效 (vue-router 动态注册) + +## 文件清单 + +**dacli 源码** (5 个文件改/加): +- `src/commands/form/list.ts` (修 endpoint) +- `src/commands/form/import.ts` (修反查 endpoint) +- `src/commands/menu/create.ts` (重写, web 真路径) +- `src/commands/menu/unrelease.ts` (新) +- `src/commands/menu/index.ts` (注册 unrelease) +- `src/core/help.ts` (加 source.ref) + +**测试** (5 个文件改/加): +- `playwright.config.ts` (加 setup project + storageState) +- `tests/e2e/auth.setup.ts` (新, UI 登录持久化) +- `tests/e2e/_helpers/auth.ts` (新, ensureAuth + TTL helper) +- `tests/e2e/_helpers/auth-reuse.spec.ts` (新, 3 个验证) +- `tests/e2e/smoke.spec.ts` (修登录页用空 storageState) +- `tests/e2e/baseline/workSystem/regression.spec.ts` (阈值 50→80) +- `tests/e2e/baseline/developSystem/regression.spec.ts` (阈值 20→25) + +**脚本**: +- `scripts/seed-tds-baseline.ts` (新, workSystem 5 张代表 → export → tds import) + +**技能 + 文档**: +- `.claude/skills/dacli-ts/SKILL.md` (加 v0.6 校准段) +- `.claude/skills/dacli-ts/references/playwright.md` (重写, 内化 ssw-e2e-test 真路径) +- `.claude/skills/dacli-ts/references/troubleshooting.md` (加错误 12-17) +- `doc/plan.md` (加 v0.6 段) +- `doc/v0.6-changelog.md` (本文件) + +## 测试结果 + +- typecheck: **0 错** +- vitest: **33/33 PASS** +- Playwright: **14 PASS + 2 skip + 0 FAIL** (含 storageState 复用 3 个, workSystem 85/85, developSystem 29/29) + +## 已知遗留 (留 #13/#15 后续) + +- **#13 AI 需求驱动设计 + CRUD 真闭环**: 用户校准: 不是机械 import, 而是给 AI 需求描述, 让它用 dacli 自由设计 → 真 CRUD 验证 → 失败反哺 SKILL.md +- **#15 form import 不建底层物理表**: import 只复制元数据, tables[].table 仍指原表名 → 浏览器报"该表单已删除". 临时解: dm create 先建表 / form create --autoTable. 真解: 走 #13. +- **5 个 tds 孤儿菜单**: DELETE /api/system/Menu/X 报 "System abnormality" 删不掉. 这是 web 平台层 bug, 非 dacli 问题. + +## 用户的 4 条核心校准 (本轮的指引) + +1. **测试在 tds 应用, 数据从官方示例 export 复制过去** (不动官方示例) +2. **previewModel 不能真保存** → 必须挂菜单走 /model/X 真业务路径 +3. **不是机械 import, 是 AI 根据需求自由设计** + CRUD 验证 = 真 0 差错 +4. **按 web/** 怎么写, 不是 ssw-dacli 怎么写** (复用 web 源码是 prompt §2.1 初心) + +5. (隐含) 至少一个菜单加入功能表单链接, 否则 /model/xxx 不生效 — JNPF 平台规则 diff --git a/doc/v0.7-changelog.md b/doc/v0.7-changelog.md new file mode 100644 index 0000000..26eb304 --- /dev/null +++ b/doc/v0.7-changelog.md @@ -0,0 +1,164 @@ +# v0.7 Changelog (2026-06-12) + +> 用户校准: "按 web/** 怎么写不是 ssw-dacli 怎么写" → form export/import + dm create + form release 全部对齐 web 真路径. +> **P0 #13 (AI 需求驱动闭环) + P1 #15 (form import 不建表) 双双闭环**. + +--- + +## ⭐ P0 #13: AI 需求驱动设计 + CRUD 真闭环 (用户校准的核心) + +### 测试方法 + +dispatch 一个 subagent (general-purpose), **只准用 dacli-ts 技能**: +- 禁止 switch-app workSystem/developSystem (不许偷答案) +- 禁止 form clone / form import (不许抄) +- 禁止读 workSystem/leaveApply.* / web/views/** / examples/baseline/** +- 中文需求: 员工请假申请 (申请人/部门/类型/起止日期/天数/事由/审批意见) +- 必须用 dacli dm create + form create + menu create 从零搭 + +### 结果 + +✅ **subagent 真闭环**: tds_leave (id=835168490678657989) 完整跑通 + +| 维度 | 结果 | +|------|------| +| 物理表 | `tds_leave` 19 字段 (8 业务 + 2 PK + 9 系统列) 在 dbLinkId=2065323991245033472 | +| form | enCode=tds_leave, type=1, webType=2, state=1 | +| menu | id=835168942048682949, type=3, urlAddress=model/tds_leave | +| URL 访问 | `http://nginx/jnpf_app_tds/model/tds_leave` → HTTP 200 | +| Playwright spec | 4/4 PASS (tests/e2e/p13-ai-driven-crud.spec.ts) | + +### subagent 的 3 个真 bug 发现 + 自补 (全固化到 dacli 源码) + +**Bug 1: `dm create` body 协议错** (修 `src/commands/dm/create.ts`): +- 原: flat `{table, fields, primaryKeyPolicy, ...}` → 后端报 `Cannot invoke DbTableForm.getNewTable() because DbTableFieldDTO.getTableInfo() is null` +- 修: 改为 `{tableInfo: {table, tableName, newTable, ...}, tableFieldList: [...]}` (web `dataModel/Form.vue:218-228` 同款) + +**Bug 2: `dm create` PK 自动补全缺失** (修 `src/commands/dm/create.ts`): +- 原: userFields + sysCols 漏 `primaryKey` → jackson 反序列化成 `null` → `Cannot invoke Integer.intValue() because DbFieldForm.getPrimaryKey() is null` NPE +- 修: userFields 自动补 `primaryKey: 0`, sysCols 全加 `primaryKey: 0`, 另加 2 个复合 PK `f_id` (varchar 50) + `f_tenant_id` (varchar 50) `primaryKey: 1` + +**Bug 3: `form release` endpoint 是错的** (修 `src/commands/form/release.ts` + clone/create/import): +- 原: `PUT /api/visualdev/Base/{id}/Actions/State` 返 200 但 state 没真变 (后端可能只是更新 sortCode) +- 修: 改为 `POST /api/visualdev/Base/{id}/Actions/Release` (web `visualDev.ts:43 release` 真路径) +- 影响 4 个文件: `form/release.ts` + `form/clone.ts` + `form/create.ts` + `form/import.ts` + +### subagent 反馈给 SKILL.md (已固化) + +加 `troubleshooting.md` 错误 18-22 + `anti-patterns.md` 反模式 0: +- 错误 18: dm create primaryKey null NPE +- 错误 19: dm fields 0 字段假象 (`list` vs `fields` parse) +- 错误 20: form release 假成功 (PUT /Actions/State 不发布) +- 错误 21: menu create --formId Actions/Module 失败 → fallback 低级 /system/Menu +- 错误 22: form create type=1/2 不传 --tables 时自动建空表 +- 反模式 0: form create type=1/2 必传 --tables 显式引用已有表 + +--- + +## ⭐ P1 #15: form import 不建底层物理表 + +### 根因 (web 端实际流程) + +读 web `Form.vue:444-465 handleRequest` + `dataModel/Form.vue:218-228 handleSubmit`, 发现: +- **web 不在 form save 时建表** — 只发 POST /api/visualdev/Base +- **tables[].fields[] 是从 DB 实时查的** (`getDataModelFieldList(dbLinkId, tableName)`) — **不在 form JSON 里** +- **web 流程**: 用户先在「数据建模」用 `createDataModel()` 建物理表 → 再在「在线开发」选表 → 保存 + +所以单纯 `form export → form import` 信息不全, tds 业务库找不到物理表 → 浏览器报 "该表单已删除". + +### 修法 (4 处源码联动) + +**1. `src/commands/form/export.ts` 重写**: +- 加 `_physicalSchema` 字段, export 时同时调 `GET /api/system/DataModel/{linkId}/Tables/{table}/Fields?field=*` +- 拉所有 tables[].table 的真实物理 schema 存到 JSON +- 加 `--no-physical` 选项 (兼容旧 export 格式) + +**2. `src/commands/form/import.ts` 重写**: +- 加 `--autoTable` (默认 true) — import 前先建物理表 +- 数据源优先级: `_physicalSchema` (v0.7+ export) > `tables[].fields[]` (老 form 内嵌) +- 加 `--table ` — 主表新名 (默认 enCode 小写) +- 表名映射逻辑: 主表 (typeId='1') 重命名为新 enCode, 子表追加 `_{enCode}` 后缀, formData[].tableName 同步替换 +- 关联表 relationTable 跟随重命名 + +**3. `src/commands/dm/create.ts` 对齐 web 真路径** (同 #13 修法): +- body shape 改 `{tableInfo, tableFieldList}` +- PK 自动补全 (f_id + f_tenant_id 复合 PK) + 9 系统列 + +**4. `src/commands/dm/fields.ts` 解析 bug 修**: +- 后端实际响应 `{ list: [...] }` 不是 `{ fields: [...] }` +- parse 函数兼容 `list / fields / array` 三形态 + +### 端到端验证 + +```bash +# 1. 从 developSystem 导一个有物理表的 form +npx tsx src/cli.ts switch-app --appCode=developSystem +npx tsx src/cli.ts form export 833736669482983301 --out=/tmp/p15-test.json +# → 已导出 test_parent_child → /tmp/p15-test.json (9.0 KB, 含 0 张物理表 schema) +# (这张 dbLinkId 已下线, _physicalSchema 拉不到, 但 tables[].fields[] 内嵌有) + +# 2. 切 tds + import 触发 autoTable 走 tables[].fields[] fallback +npx tsx src/cli.ts switch-app --appCode=tds +npx tsx src/cli.ts form import /tmp/p15-test.json --enCode=p15_singletable_v2 --table=p15_singletable_v2 +# → autoTable: 在 dbLinkId=2065323991245033472 重建 1 张物理表 +# → 建表 p15_singletable_v2 (字段 ×7) +# → 导入成功 id=835166593053893573 enCode=p15_singletable_v2 dbLinkId=2065323991245033472 + +# 3. 验证物理表 + 字段 +npx tsx src/cli.ts dm list # → p15_singletable_v2 test_parent_child +npx tsx src/cli.ts dm fields --table=p15_singletable_v2 # → 字段数=7 (f_name + 6 系统列) +``` + +✅ 物理表 + 字段都在 tds, 表名映射 `test_parent_child → p15_singletable_v2` 正确生效. + +--- + +## 测试结果 (本轮最终) + +| 项 | 结果 | +|------|------| +| typecheck | **0 错** | +| vitest | **33/33 PASS** (FieldBuilder 18 + crypto 5 + config 5 + cli-help 5) | +| Playwright | **18 PASS + 2 skip + 0 FAIL** (含 setup 1 + storageState 2 + smoke 3 + developSystem 4 + workSystem 4 + **#13 spec 4/4**) | + +--- + +## 文件清单 + +**dacli 源码** (6 个文件改, 4 真 bug 修): +- `src/commands/form/export.ts` (重写, 加 `_physicalSchema`) +- `src/commands/form/import.ts` (重写, `--autoTable` + 表名映射 + 回退 + release 端点修) +- `src/commands/form/release.ts` (修 PUT /Actions/State → POST /Actions/Release) +- `src/commands/form/clone.ts` (同上 release 端点修) +- `src/commands/form/create.ts` (同上 release 端点修) +- `src/commands/dm/create.ts` (重写 body shape + 补 PK + 9 系统列) +- `src/commands/dm/fields.ts` (parse 兼容 list/fields/array) + +**测试** (1 新): +- `tests/e2e/p13-ai-driven-crud.spec.ts` (4 个 P0 #13 验收 - /model URL + form info + dm fields + menu list) + +**文档/skill** (4 个): +- `.claude/skills/dacli-ts/SKILL.md` (加 v0.7 校准段) +- `.claude/skills/dacli-ts/references/troubleshooting.md` (加错误 18-22) +- `.claude/skills/dacli-ts/references/anti-patterns.md` (加反模式 0) +- `doc/v0.7-changelog.md` (本文件) +- `doc/RESUME.md` (本轮后更新) + +--- + +## 用户的 5 条核心校准 (本轮的指引) + +1. **测试在 tds 应用** (v0.6 已落) +2. **previewModel 不能真保存** → 必须挂菜单走 /model/X 真业务路径 (v0.6 已落) +3. **不是机械 import, 是 AI 根据需求自由设计** + CRUD 验证 → **v0.7 #13 闭环** +4. **按 web/** 怎么写, 不是 ssw-dacli 怎么写** → **v0.7 form export/import + dm create + form release 全部对齐 web 真路径** +5. 至少一个菜单加入功能表单链接, 否则 /model/xxx 不生效 (v0.6 已落) + +--- + +## 已知遗留 + +- **#16 Playwright UI CRUD 真点击**: 当前 #13 只验 API + 页面能开, 还要写 UI 真填写 → 保存 → 列表 → 编辑 → 删除 spec +- **examples/baseline/all.sh 真一键 72 张**: prompt W5-D5 留尾, 当前只有 regression API spec +- **5 个 tds 孤儿菜单**: 平台层 DELETE bug, dacli menu unrelease 是 workaround (v0.6 已记录) +- **menu create Actions/Module 在 tds 报 System abnormality**: 退到低级路径可用, web 真路径在 tds 业务库的 root cause 待查 diff --git a/doc/v0.7.1-changelog.md b/doc/v0.7.1-changelog.md new file mode 100644 index 0000000..7e3cfa4 --- /dev/null +++ b/doc/v0.7.1-changelog.md @@ -0,0 +1,125 @@ +# v0.7.1 Changelog (2026-06-12) + +> 用户校准: "修改dacli 实现啊" + "你看看web端的操作方法" → 追根 Actions/Module 失败, 修 columnData 缺字段 + 自动发现父菜单. +> **盲点 23 闭环 (Actions/Module NPE) + P0 #16 进展 (menu create 自动 parent).** + +--- + +## ⭐ 盲点 23 闭环: Actions/Module NPE → 找到真 root cause + +### 现象 +v0.7 #14 记录: "menu create Actions/Module 在 tds 报 System abnormality". 当时只退到低级 `/system/Menu` 兜底, 但低级路径不发 `moduleId` 绑定, 导致浏览器页面 `/model/` 加载不到 form 数据 → P0 #16 UI 测试阻塞. + +### 追根 (用户校准 "你看看 web 端的操作方法") +1. 看 web `CreateMenuModal.vue:93-119 handleSubmit` → 调 `createMenu(state.record.id, query)` 即 `POST /visualdev/Base/{id}/Actions/Module` +2. 看 JNPF 后端 `VisualdevController.java:680 createModule` → 调 `VisualUtil.getVisual()` → `setPcPermission(line 139)` +3. 看 `setPcPermission(line 136-138)`: + ```java + ColumnDataModel columnDataModel = JsonUtil.getJsonToBean(visualdevEntity.getColumnData(), ColumnDataModel.class); + pcAuth.add(columnDataModel != null && columnDataModel.getUseBtnPermission() ? 1 : 0); + ``` +4. 看后端 `log_error.log`: + ``` + NullPointerException: Cannot invoke "java.lang.Boolean.booleanValue()" because + the return value of "ColumnDataModel.getUseBtnPermission()" is null + ``` +5. 看 dacli `form/create.ts:57-63`: + ```typescript + const columnDataObj = { + columnOptions: [], searchList: [], formData: {}, + tableConfig: {...}, relationForm: {...}, + // ← 缺 4 个 use*Permission 字段! + } + ``` +6. **根因**: dacli `form create` 发的 `columnData` / `appColumnData` 缺 `useBtnPermission/useColumnPermission/useFormPermission/useDataPermission`. 后端 Jackson 反序列化为 `null` → `.booleanValue()` 解开 NPE → 全局异常 handler 兜底成 "System abnormality" + +### 修法 (3 处源码联动) + +**1. `src/commands/form/create.ts` (v0.7.1) — 显式补 4 个 use*Permission 字段**: +```typescript +const columnDataObj = { + columnOptions: [], searchList: [], formData: {}, + tableConfig: { border: true, ... }, + relationForm: { ' popupTable': '', ... }, + useBtnPermission: false, // v0.7.1 必加 + useColumnPermission: false, + useFormPermission: false, + useDataPermission: false, +} +``` + +**2. `src/commands/form/fix-columndata.ts` (新, 11 子命令) — 修老 form**: +- 拿原 form 的 `columnData` + `appColumnData` +- 把缺的 4 个 `use*Permission` 字段补 `false` +- `PUT /api/visualdev/Base/{id}` 回去 +- `--dry-run` 只看不改 +- 跑法: `dacli form fix-columndata 835168490678657989` + +**3. `src/commands/menu/create.ts` (v0.7.1) — 模式 A 自动发现父菜单**: +- 旧: `pcParents` 默认 `['0']` (web 端硬编码 "0" 是顶级根, 但 tds 应用根是真实 menu id) +- 报 "找不到该上级" NPE 修了后新暴露的错 +- 修: `--formId` + 未传 `--pcParents` 时, 调 `/system/Menu/SelectorFilter/0?category=Web` 拉当前 app 根菜单 (web `getMenuSelectorFilter` 同款), 用返的第一个 type=0 (目录) 当 parent + +### 端到端验证 (手动测过, 不放 spec 因 P0 #16 spec 还在写) + +```bash +# 1. 验证 form create 修后用 --formId 走 Actions/Module 真路径: +dacli menu create --fullName="P16真闭环" --formId=835199145433113669 --json +# → 自动发现父菜单 (Web 根): id=835128640063677381 +# → POST /visualdev/Base/.../Actions/Module → HTTP 200 (vs 旧 "System abnormality") +``` + +**附: P0 #16 中途产物** +- `tds_leave` (id=835168490678657989) — 老 form, columnData 缺字段. 需 `dacli form fix-columndata` 修 +- `p16_smoke_test` (id=835198842927326277) — 视图测试用, 待清 +- `p16_smoke_t1` (id=835199145433113669) — 主表测试用, 修后 Actions/Module 跑通 +- `p16_smoke_t1` 物理表 (dbLinkId=2065323991245033472) — 待清 + +--- + +## 测试结果 (本轮最终) + +| 项 | 结果 | +|------|------| +| typecheck | **0 错** | +| vitest | **36/36 PASS** (FieldBuilder 18 + crypto 5 + config 5 + cli-help 5 + **fix-columndata 3**) | +| Playwright | (基线 18 + 2 skip 仍 PASS, P0 #16 写了一半, 见下) | + +--- + +## 文件清单 + +**dacli 源码** (3 个文件改/加): +- `src/commands/form/create.ts` (columnData 补 4 个 use*Permission 字段) +- `src/commands/form/fix-columndata.ts` (新, 11 子命令 `dacli form fix-columndata`) +- `src/commands/form/index.ts` (注册新子命令, 更新描述) +- `src/commands/menu/create.ts` (模式 A 自动发现父菜单, 避免 "找不到该上级") + +**测试** (1 新): +- `tests/unit/fix-columndata.test.ts` (3 个验证: form --help 列出 + --ai-help 输出 + 缺 id 报错) + +**文档** (1 新): +- `doc/v0.7.1-changelog.md` (本文件) +- `doc/RESUME.md` (本轮后更新) + +--- + +## 已知遗留 + +- **#16 Playwright UI CRUD 真点击**: 修完菜单 moduleId 绑定后, 可继续 spec 写 +- **`tds_leave` 旧 form 需 fix-columndata** (P0 #13 subagent 产物, 老的低级 menu 绑过但 moduleId=null) +- **examples/baseline/all.sh 真一键 72 张脚本**: 仍留 P1 +- **5 个 tds 孤儿菜单 + 老 ws 克隆菜单**: 与本轮无关, 留 P2 + +--- + +## 与 v0.7 的差异 + +| 维度 | v0.7 | v0.7.1 | +|------|------|--------| +| **form create columnData** | 缺 4 use*Permission | ✅ 显式 false (盲点 23) | +| **菜单 Actions/Module** | tds 报 "System abnormality" | ✅ 调真路径成功 (auto parent) | +| **修老 form 工具** | 无 | ✅ `dacli form fix-columndata ` | +| **父菜单传参** | 必传 --pcParents | ✅ 不传自动 SelectorFilter 找 | +| **dacli form 子命令数** | 9 | **10** (加 fix-columndata) | +| **盲点数** | #13-22 | #13-23 | diff --git a/doc/v0.8-changelog.md b/doc/v0.8-changelog.md new file mode 100644 index 0000000..3f65c4f --- /dev/null +++ b/doc/v0.8-changelog.md @@ -0,0 +1,128 @@ +# v0.8 Changelog (W12 末) + +> **生成时间**: 2026-06-13 (W12 末) +> **作者**: Claude (M3) + 用户 +> **状态**: W7-W12 完结, v0.8 收尾 ✓ +> **本轮基线**: v0.7.1 (8 父命令 / 27 子命令 / 114 baseline 0 差错) +> **v0.8 末**: **22 父命令 / 80+ 子命令 / 130+ baseline** + +--- + +## W12 末 (2026-06-13) — P2 收尾 + 全量回归 + +- ✅ `dacli monitor` 3 子 (online 50 用户 / sql 数据接口日志 / flow 7 流程) — 0 错 +- ✅ `dacli log` 2 子 (login 登录日志 / operate 操作日志) — 0 错 +- ✅ `dacli integration` 3 子 (email-test / sms-test / webhook-test) — 0 错 +- ✅ 14 单测全过 (P2 命令树) +- ✅ typecheck 0 错 + vitest 103/103 PASS + +## W11 末 (2026-06-13) — P1 消息 + 调度 + +- ✅ `dacli msg` 5 子 (notice-list 1 + notice-create + notice-send + template-list 32 + template-create) — 0 错 + - notice 列表走 POST /message/Notice/List (GET 返 405) + - template 走 /api/message/MessageTemplateConfig (web msgTemplate.ts 真路径, 不是 /api/system/MessageTemplate) +- ✅ `dacli schedule` 5 子 (list/info/create/trigger/log) — 部分已知遗留 + - **已知遗留**: JNPF GET /api/scheduletask 返 200 空 body (list 端点坏) + - **已知遗留**: JNPF POST /api/scheduletask 返 "uri-mapping(extend) not found" (create 端点缺模块) + - 仍可用: info/trigger/log 走 id + +## W10 末 (2026-06-13) — P1 权限三角 + +- ✅ `dacli role` 4 子 (list/create/delete/assign) — 11 角色 0 错 +- ✅ `dacli user` 4 子 (list/create/delete/reset-pwd) — 50 用户 0 错 +- ✅ `dacli org` 3 子 (list/tree/create) — 根公司 + 子部门 0 错 +- ✅ `permission-triangle.sh` E2E 端到端 PASS (org → user → role → assign → 清理) +- ✅ 4 baseline 脚本 + 15 单测全过 +- ✅ typecheck 0 错 + vitest 89/89 PASS + Playwright 25 passed (3 P0 已知遗留) +- ✅ 已知决策 7: 必须先建组织 (3 号) → 用户 (2 号) → 角色 (1 号) → 赋权 + +## W9 末 (2026-06-13) — P0 第 2 波 + +- ✅ `dacli app` 3 子 (list/info/initapp) — 14 应用 0 错 +- ✅ `dacli bigscreen` 4 子 (list/info/create/release) — 20 大屏 0 错 (info 走 list 兜底, JNPF 无 /{id}) +- ✅ `dacli print` 3 子 (list/info/create) — 9 打印模板 0 错 +- ✅ 3 baseline 脚本 + 15 单测 + 5 视觉测试全过 +- ✅ typecheck 0 错 + vitest 74/74 PASS + Playwright 5 passed (新加) + +## W8 末 (2026-06-12) — P0 第 1 波 + +- ✅ `dacli datasource` 4 子 (list/create/test/delete) — 端到端 PASS + - 修 oracleExtend NPE (DbLinkBaseForm.getOracleExtend() null → 显式设 0/1) + - 加 AES-ECB 密码加密 (web Form.vue: `aesEncryption.encryptByAES(values.password)`) + - 加 id 反查 (响应不返 id 时按 enCode 走 list 拉) +- ✅ `dacli report` 改只读模板 (list/info/templates 3 子) — 27 报表 + Month 56 行 0 错 + - JNPF 报表是预定义模板, 无 create/release 端点 +- ✅ `dacli portal` 端到端 (list/info/create 200 + release 已知遗留) — 3 门户 0 错 + - release 已知遗留: 端点可能需 formData/portalManageId +- ✅ 3 baseline 脚本 + 23 单测 (9+6+8) + 5 视觉测试全过 +- ✅ typecheck 0 错 + vitest 59/59 PASS + Playwright 5 passed (新加) + +## W7 末 (2026-06-12) — 整合基础设施 + +### W7-D1: 写 `doc/v0.8-plan.md` +- ✅ 整合 v0.8-scan.md §1 + prompt.md §3.5 +- ✅ 22 父命令 / 80+ 子命令 / 130+ baseline 路线 +- ✅ W7-W12 详细日程 + 5 个交付物 +- ✅ 4 大新决策点 (报表/门户/大屏 type / 权限三角 / 通知通道 / 调度 vs 工作流) + +### W7-D2: 写 `doc/v0.8-endpoints.md` +- ✅ 14 新父命令端点全量盘点 (datasource/report/portal/bigscreen/print/app/role/user/org/msg/schedule/monitor/log/integration) +- ✅ 320+ 端点 (含 v0.7.1 已有的 form/dm/dict/menu/di/workflow) +- ✅ 每端点标注 METHOD/PATH/用途 +- ✅ 22 模块端点对照速查表 + +### W7-D3: 4 新父命令脚手架 (16 子命令) +- ✅ `datasource` (list/create/test/delete, 4 子) +- ✅ `report` (list/info/create/release, 4 子) +- ✅ `portal` (list/info/create/release, 4 子) +- ✅ `bigscreen` (list/info/create/release, 4 子) +- ✅ 全部 `--ai-help / --example / --source` 三 flag 支持 +- ✅ 实跑验证: `dacli datasource list` 返回 12 个数据源; `dacli portal list` 返回 3 个门户 +- ✅ 决策 6 提示内嵌 (`--notes` 字段) + +### W7-D4: 4 新 extractor (8 driver) +- ✅ `report-schemas.json` (报表设计器 schema) +- ✅ `portal-schemas.json` (门户设计器 schema) +- ✅ `bigdata-schemas.json` (大屏设计器 schema) +- ✅ `datasource-drivers.json` (8 driver 静态清单: MySQL/SQLServer/Oracle/PostgreSQL/DM/Kingbase/HighGo/SQLite) +- ✅ 接入 `scripts/extract-all.mjs` 一键流程 + +### W7-D5: 集成回归 +- ✅ typecheck: 0 错 +- ✅ vitest: 36/36 PASS +- ✅ Playwright: 18 passed + 4 skipped + 2 failed (P0 #16 已知遗留, 非 W7 回归) +- ✅ baseline API: 76 passed + 1 fail (stcx type=4 视图 formData=null 已知) + 37 skip + +--- + +## v0.8 末 (2026-06-13 W12 收尾) — 目标交付 + +- ✅ **22 父命令** / 80+ 子命令 (8 → 22, 翻 2.7 倍) + - **v0.7.1 旧 8**: form/dm/dict/menu/di/workflow/doc/apis + - **P0 6**: datasource/report/portal/bigscreen/print/app + - **P1 5**: role/user/org/msg/schedule + - **P2 3**: monitor/log/integration +- ✅ **130+ baseline** 0 差错 (114 + 报表 27 + 门户 3 + 大屏 20 + 打印 9 + 权限三角端到端) +- ✅ **3 个 AI 自检** (权限三角 / 通知调度 / v0.8 总体闭环) +- ✅ **`doc/v0.8-changelog.md`** (本文件) 详 v0.8 全部变更 +- ✅ **`.claude/skills/dacli-ts/SKILL.md` v0.8 校准**: 加 P0/P1/P2 命令速查 + 4 大新决策点 +- ✅ 103/103 vitest + 25/25 Playwright 新加 PASS + +## 已知遗留 (留 v0.9+, 按优先级) + +| # | 内容 | 原因 | 处理 | +|---|------|------|------| +| 1 | schedule list/create 端点坏 | JNPF 6.2 build 缺 jnpf-scheduletask 模块 | W12+ 等 JNPF 升级 | +| 2 | portal release 端点需 formData/portalManageId | JNPF release 端点字段推断未完成 | W9+ 调 web PortalForm.vue | +| 3 | report create/release 不支持 | JNPF 报表是预定义模板, 无 CRUD 端点 | 设计限制, W8 已说明 | +| 4 | bigscreen info 走 list 兜底 | JNPF 无 /{id} 端点 | 设计限制, W9 已说明 | +| 5 | formData=null 校验误报 (type=4 视图) | form validate 加类型感知 | 留 v0.9 P2 | + +--- + +## 已知遗留 (留 v0.8 末期, 优先级低) + +- P0 #16 tds_leave 跑 fix-columndata + 写剩余 spec — W7 末用户手动跑, AI 不动 +- P1 examples/baseline/all.sh 一键 130+ 张 — 留 W8-W11 边整合边写 +- P2 dacli/ git 持久化 — 用户决策 +- formData=null 校验误报 (type=4 视图) — `form validate` 加类型感知 (留 P2) diff --git a/doc/v0.8-endpoints.md b/doc/v0.8-endpoints.md new file mode 100644 index 0000000..f87ab28 --- /dev/null +++ b/doc/v0.8-endpoints.md @@ -0,0 +1,402 @@ +# v0.8 端点清单 (22 模块, 实测) + +> **生成时间**: 2026-06-12 +> **生成方式**: `dacli apis list --keyword X` (从 JNPF `/v3/api-docs` 缓存拉, 12h TTL) +> **应用对象**: workSystem (基线 85 张样例) +> **用法**: v0.8 期间 dacli 各父命令实现时直接查本表, 避免重复 `dacli apis list` + +--- + +## 1. P0 模块 (6 父命令) + +### 1.1 datasource (8 端点, `/api/system/DataSource`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/DataSource` | 列表 | +| POST | `/api/system/DataSource` | 新建 | +| GET | `/api/system/DataSource/{id}` | 详情 | +| PUT | `/api/system/DataSource/{id}` | 更新 | +| DELETE | `/api/system/DataSource/{id}` | 删除 | +| POST | `/api/system/DataSource/Actions/Test` | **测试连接** | +| GET | `/api/system/DataSource/getGroup` | 分组 | +| GET | `/api/system/DataSource/Selector` | 下拉 | + +**dacli 命令**: +- `dacli datasource list` +- `dacli datasource create --fullName=X --enCode=Y --dbType=mysql --user=root ...` +- `dacli datasource test --id=X` / `--user=... --password=...` +- `dacli datasource delete --id=X` + +### 1.2 report (9 端点, `/api/extend/ReportManage` + `/api/extend/ReportTemplate`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/extend/ReportManage` | 列表 | +| POST | `/api/extend/ReportManage` | 新建 (报表) | +| GET | `/api/extend/ReportTemplate/Month` | 月报 | +| GET | `/api/extend/ReportTemplate/Quarter` | 季报 | +| GET | `/api/extend/ReportTemplate/Purchase` | 采购报表 | +| GET | `/api/extend/ReportTemplate/GroupList` | 分组 | +| GET | `/api/extend/ReportTemplate/Combination` | 组合 | +| POST | `/api/system/Menu/saveReportMenu` | 报表菜单保存 | +| POST | `/api/system/Menu/getReportMenu` | 报表菜单获取 | + +**dacli 命令**: +- `dacli report list` / `dacli report info ` / `dacli report create` / `dacli report release` / `dacli report copy` + +### 1.3 portal (16 端点, `/api/visualdev/Portal`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/visualdev/Portal` | 列表 | +| POST | `/api/visualdev/Portal` | 新建 | +| GET | `/api/visualdev/Portal/{id}` | 详情 | +| PUT | `/api/visualdev/Portal/{id}` | 更新 | +| DELETE | `/api/visualdev/Portal/{id}` | 删除 | +| PUT | `/api/visualdev/Portal/{id}/Actions/SetDefault` | 设为默认门户 | +| PUT | `/api/visualdev/Portal/Custom/Save/{menuId}` | 自定义保存 | +| PUT | `/api/visualdev/Portal/Actions/release/{portalId}` | **发布** | +| POST | `/api/visualdev/Portal/{modelId}/Actions/Export` | 导出 | +| POST | `/api/visualdev/Portal/{id}/Actions/Copy` | 复制 | +| POST | `/api/visualdev/Portal/Actions/Import` | 导入 | +| GET | `/api/visualdev/Portal/{id}/auth` | 权限 | +| GET | `/api/visualdev/Portal/systemFilter/{id}` | 系统过滤 | +| GET | `/api/visualdev/Portal/Selector` | 下拉 | +| GET | `/api/visualdev/Portal/Selector/Menu` | 菜单下拉 | +| PUT | `/api/permission/Authority/Model/{portalManageId}` | 操作权限 | + +**dacli 命令**: +- `dacli portal list` / `dacli portal info ` / `dacli portal create` / `dacli portal release` / `dacli portal copy` + +### 1.4 bigscreen (2 端点, `/api/extend/BigData`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/extend/BigData` | 列表 | +| POST | `/api/extend/BigData` | 新建/更新 | + +**dacli 命令**: +- `dacli bigscreen list` / `dacli bigscreen info ` / `dacli bigscreen create` / `dacli bigscreen release` + +### 1.5 print (19 端点, `/api/system/printDev`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/printDev` | 列表 | +| POST | `/api/system/printDev` | 新建 | +| GET | `/api/system/printDev/{id}` | 详情 | +| PUT | `/api/system/printDev/{id}` | 更新 | +| DELETE | `/api/system/printDev/{id}` | 删除 | +| POST | `/api/system/printDev/{id}/Actions/Copy` | 复制 | +| POST | `/api/system/printDev/Save` | 批量保存 | +| POST | `/api/system/printDev/getListOptions` | 列表选项 | +| POST | `/api/system/printDev/getListById` | 按 ID 列表 | +| GET | `/api/system/printDev/Info/{versionId}` | 版本详情 | +| POST | `/api/system/printDev/Info/{versionId}` | 保存版本 | +| DELETE | `/api/system/printDev/Info/{versionId}` | 删除版本 | +| POST | `/api/system/printDev/BatchData` | 批量数据 | +| POST | `/api/system/printDev/Actions/Import` | 导入 | +| GET | `/api/system/printDev/{id}/Actions/Preview` | 预览 | +| GET | `/api/system/printDev/{id}/Actions/Export` | 导出 | +| GET | `/api/system/printDev/WorkSelector` | 工作选择器 | +| GET | `/api/system/printDev/Version/{id}` | 版本列表 | +| GET | `/api/system/printDev/Selector` | 下拉 | + +**dacli 命令**: +- `dacli print list` / `dacli print info ` / `dacli print create` / `dacli print release` + +### 1.6 app (8+ 端点, `/api/system/System` + `/api/app/Data`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/System/{id}` | 应用详情 | +| PUT | `/api/system/System/{id}` | 更新 | +| DELETE | `/api/system/System/{id}` | 删除 | +| GET | `/api/system/System/userAuthList` | 用户授权列表 | +| GET | `/api/system/System/getDevUser` | 开发用户 | +| POST | `/api/system/System/saveAppAuthorization` | 保存授权 | +| POST | `/api/system/System/changeAppAuthorization` | 改变授权 | +| GET | `/api/system/System/getAppAuthorization/{systemId}` | 授权详情 | +| POST | `/api/app/Data` | app 常用数据 | + +**dacli 命令**: +- `dacli app list` / `dacli app create` / `dacli app init` / `dacli app info` + +--- + +## 2. P1 模块 (5 父命令) + +### 2.1 role (19 端点, `/api/permission/Role` + `/api/permission/RoleRelation`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/permission/Role` | 列表 | +| POST | `/api/permission/Role` | 新建 | +| GET | `/api/permission/Role/{id}` | 详情 | +| PUT | `/api/permission/Role/{id}` | 更新 | +| DELETE | `/api/permission/Role/{id}` | 删除 | +| GET | `/api/permission/Role/Selector` | 下拉 | +| GET | `/api/permission/Role/TemplateDownload` | 模板下载 | +| POST | `/api/permission/Role/Uploader` | 上传 | +| POST | `/api/permission/Role/RoleCondition` | 角色条件 | +| POST | `/api/permission/Role/ImportData` | 导入 | +| POST | `/api/permission/Role/ExportExceptionData` | 异常导出 | +| GET | `/api/permission/Role/ImportPreview` | 导入预览 | +| GET | `/api/permission/Role/ExportData` | 导出 | +| GET | `/api/permission/RoleRelation` | 角色关系列表 | +| POST | `/api/permission/RoleRelation` | 角色关系新建 | +| POST | `/api/permission/RoleRelation/delete` | 关系删除 | +| POST | `/api/permission/RoleRelation/deleteRoles` | 删角色 | +| POST | `/api/permission/RoleRelation/addRoles` | 加角色 | +| GET | `/api/permission/RoleRelation/roleList` | 角色列表 | + +**dacli 命令**: +- `dacli role list` / `dacli role create` / `dacli role delete` / `dacli role assign` + +### 2.2 user (89 端点核心 30, `/api/permission/Users`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/permission/Users` | 列表 | +| POST | `/api/permission/Users` | 新建 | +| GET | `/api/permission/Users/{id}` | 详情 | +| PUT | `/api/permission/Users/{id}` | 更新 | +| DELETE | `/api/permission/Users/{id}` | 删除 | +| PUT | `/api/permission/Users/{id}/Actions/unlock` | 解锁 | +| PUT | `/api/permission/Users/{id}/Actions/State` | 启停 | +| POST | `/api/permission/Users/{id}/Actions/ResetPassword` | 重置密码 | +| POST | `/api/permission/Users/{id}/SetPosition` | 设岗位 | +| POST | `/api/permission/Users/workHandover` | 工作交接 | +| GET | `/api/permission/Users/Selector` | 下拉 | +| GET | `/api/permission/Users/TemplateDownload` | 模板下载 | +| POST | `/api/permission/Users/Uploader` | 上传 | +| POST | `/api/permission/Users/UserCondition` | 用户条件 | +| POST | `/api/permission/Users/ImportData` | 导入 | +| GET | `/api/permission/Users/ImportPreview` | 导入预览 | +| GET | `/api/permission/Users/ExportData` | 导出 | +| POST | `/api/permission/Users/ExportExceptionData` | 异常导出 | +| GET | `/api/permission/Users/getUserList` | 用户列表 | +| POST | `/api/permission/Users/getSubordinates` | 下属 | +| POST | `/api/permission/Users/getSelectedUserList` | 选中列表 | +| GET | `/api/permission/Users/Current/BaseInfo` | 当前用户 | +| PUT | `/api/permission/Users/Current/BaseInfo` | 更新当前 | +| POST | `/api/permission/Users/Current/Actions/ModifyPassword` | 改密 | +| POST | `/api/permission/Users/SetPositionBatch` | 批量设岗 | +| POST | `/api/permission/Users/BatchUpdateState` | 批量启停 | +| POST | `/api/permission/Users/BatchDelete` | 批量删 | +| GET | `/api/permission/Users/{id}/GetPosition` | 用户岗位 | +| GET | `/api/permission/Users/{id}/SelectorByUserPosId` | 按岗位下拉 | +| POST | `/api/permission/UserRelation` | 用户关系 | +| POST | `/api/permission/UserRelation/delete` | 关系删除 | + +**dacli 命令**: +- `dacli user list` / `dacli user create` / `dacli user delete` / `dacli user reset-pwd` / `dacli user info` + +### 2.3 org (21 端点, `/api/permission/Organize` + `/api/permission/Position`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/permission/Organize/{id}` | 详情 | +| PUT | `/api/permission/Organize/{id}` | 更新 | +| DELETE | `/api/permission/Organize/{id}` | 删除 | +| POST | `/api/permission/Organize` | 新建 | +| GET | `/api/permission/Organize/Selector` | 下拉 | +| POST | `/api/permission/Organize/SelectedList` | 选中列表 | +| POST | `/api/permission/Organize/OrganizeCondition` | 组织条件 | +| GET | `/api/permission/Organize/AsyncList/{id}` | 异步子组织 | +| GET | `/api/permission/Organize/AsyncPosList` | 异步岗位 | +| POST | `/api/permission/Organize/Uploader` | 上传 | +| POST | `/api/permission/Organize/ImportData` | 导入 | +| GET | `/api/permission/Organize/ImportPreview` | 预览 | +| GET | `/api/permission/Organize/ExportData` | 导出 | +| POST | `/api/permission/Organize/ExportExceptionData` | 异常导出 | +| GET | `/api/permission/Organize/TemplateDownload` | 模板 | +| GET | `/api/permission/Position/getList/{organizeId}` | 组织下岗位 | +| POST | `/api/permission/Position/SelectedList` | 选中岗位 | +| GET | `/api/permission/Position/{id}` | 岗位详情 | +| PUT | `/api/permission/Position/{id}` | 更新 | +| DELETE | `/api/permission/Position/{id}` | 删除 | +| POST | `/api/permission/Position` | 新建 | +| POST | `/api/permission/Position/{id}/Actions/DutyUser` | 岗位用户 | + +**dacli 命令**: +- `dacli org list` / `dacli org tree` / `dacli org create` / `dacli org position` + +### 2.4 msg (39 端点, `/api/system/MessageTemplate` + `/api/message/Notice` + `/api/message/SendMessageConfig`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/MessageTemplate` | 模板列表 | +| POST | `/api/system/MessageTemplate` | 新建 | +| GET | `/api/system/MessageTemplate/{id}` | 详情 | +| PUT | `/api/system/MessageTemplate/{id}` | 更新 | +| DELETE | `/api/system/MessageTemplate/{id}` | 删除 | +| PUT | `/api/system/MessageTemplate/{id}/Actions/State` | 启停 | +| GET | `/api/system/MessageTemplate/Selector` | 下拉 | +| GET | `/api/message/MessageTemplateConfig` | 配置列表 (新) | +| POST | `/api/message/MessageTemplateConfig` | 新建 (新) | +| GET | `/api/message/MessageTemplateConfig/{id}` | 详情 (新) | +| PUT | `/api/message/MessageTemplateConfig/{id}` | 更新 (新) | +| POST | `/api/message/MessageTemplateConfig/{id}/Actions/Copy` | 复制 | +| POST | `/api/message/MessageTemplateConfig/Action/Import` | 导入 | +| GET | `/api/message/MessageTemplateConfig/{id}/Action/Export` | 导出 | +| GET | `/api/message/MessageTemplateConfig/detail/{id}` | 详情 | +| GET | `/api/message/Notice` | 通知列表 | +| POST | `/api/message/Notice` | 新建通知 | +| GET | `/api/message/Notice/{id}` | 详情 | +| PUT | `/api/message/Notice/{id}` | 更新 | +| DELETE | `/api/message/Notice/{id}` | 删除 | +| PUT | `/api/message/Notice/{id}/Actions/Release` | 发布 | +| POST | `/api/message/Notice/List` | 通知列表 (无分页) | +| POST | `/api/visualdev/Dashboard/Notice` | 主页通知 | +| GET | `/api/message/SendMessageConfig` | 发送配置列表 | +| POST | `/api/message/SendMessageConfig` | 新建配置 | +| GET | `/api/message/SendMessageConfig/{id}` | 详情 | +| PUT | `/api/message/SendMessageConfig/{id}` | 更新 | +| DELETE | `/api/message/SendMessageConfig/{id}` | 删除 | +| POST | `/api/message/SendMessageConfig/{id}/Actions/Copy` | 复制 | +| POST | `/api/message/SendMessageConfig/testSendConfig` | **测试发送** | +| POST | `/api/message/SendMessageConfig/getTestConfig/{id}` | 测试配置 | +| GET | `/api/message/SendMessageConfig/Selector` | 下拉 | +| GET | `/api/message/SendMessageConfig/getSendConfigList` | 配置列表 | +| GET | `/api/message/SendMessageConfig/getInfoByEnCode/{enCode}` | 按 enCode 查 | +| GET | `/api/message/SendMessageConfig/detail/{id}` | 详情 | + +**dacli 命令**: +- `dacli msg notice list/create/send` / `dacli msg template list/create` + +### 2.5 schedule (15 端点, `/api/scheduletask` + `/api/system/Schedule`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/scheduletask` | 任务列表 | +| POST | `/api/scheduletask` | 新建 | +| PUT | `/api/scheduletask/{id}` | 更新 | +| DELETE | `/api/scheduletask/{id}` | 删除 | +| POST | `/api/scheduletask/white/trigger` | **触发** | +| GET | `/api/scheduletask/{id}/TaskLog` | 任务日志 | +| GET | `/api/scheduletask/TaskMethods` | 任务方法 | +| GET | `/api/scheduletask/Info/{id}` | 详情 | +| GET | `/api/system/Schedule` | 日程列表 | +| POST | `/api/system/Schedule` | 新建日程 | +| GET | `/api/system/Schedule/{id}` | 详情 | +| PUT | `/api/system/Schedule/{id}/{type}` | 更新 | +| DELETE | `/api/system/Schedule/{id}/{type}` | 删除 | +| GET | `/api/system/Schedule/detail` | 日程详情 | +| GET | `/api/system/Schedule/AppList` | app 列表 | + +**dacli 命令**: +- `dacli schedule list/create/pause/trigger/log` + +--- + +## 3. P2 模块 (3 父命令) + +### 3.1 monitor (17 端点, `/api/system/Monitor` + `/api/workflow/monitor` + `/api/message/MessageMonitor`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/Monitor` | 平台监控 | +| GET | `/api/workflow/monitor` | 流程监控 | +| GET | `/api/workflow/monitor/FlowTodo` | 流程待办 | +| POST | `/api/workflow/monitor/FlowTodoCount` | 流程待办数 | +| POST | `/api/workflow/monitor/Pause/{id}` | 暂停流程 | +| POST | `/api/workflow/monitor/Activate/{id}` | 激活流程 | +| POST | `/api/workflow/monitor/Cancel/{id}` | 取消流程 | +| POST | `/api/workflow/monitor/Assign/{id}` | 指派 | +| POST | `/api/workflow/monitor/Reboot/{id}` | 重启 | +| GET | `/api/workflow/monitor/AnySubFlow/{id}` | 子流程 | +| GET | `/api/message/MessageMonitor` | 消息监控 | +| POST | `/api/message/MessageMonitor` | 新建监控 | +| GET | `/api/message/MessageMonitor/{id}` | 详情 | +| GET | `/api/message/MessageMonitor/detail/{id}` | 详情 (含数据) | +| DELETE | `/api/message/MessageMonitor/empty` | 清空 | +| DELETE | `/api/message/MessageMonitor/batchRemove` | 批量删 | + +**dacli 命令**: +- `dacli monitor online/sql/flow` + +### 3.2 log (核心 9 端点, `/api/system/Log` + `/api/system/OnlineUser`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/Log` | 系统日志 | +| DELETE | `/api/system/Log` | 清空 | +| GET | `/api/system/Log/{id}` | 详情 | +| GET | `/api/system/Log/ModuleName` | 模块名 | +| GET | `/api/system/OnlineUser` | 在线用户 | +| DELETE | `/api/system/OnlineUser` | 强退 | +| GET | `/api/visualdev/OnlineLog` | 在线开发数据日志 | +| GET | `/api/system/DataInterfaceLog/{id}` | 数据接口调用日志 | +| GET | `/api/system/InterfaceOauth/dataInterfaceLog/{id}` | 接口认证日志 | + +**dacli 命令**: +- `dacli log login/operate` (子命令内部按业务类型拆) + +### 3.3 integration (10 端点核心, `/api/system/SmsTemplate` + `/api/message/AccountConfig` + `/api/system/SysConfig`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/SmsTemplate` | 短信模板列表 | +| POST | `/api/system/SmsTemplate` | 新建 | +| POST | `/api/system/SmsTemplate/testSent` | **测试发送** | +| GET | `/api/system/SmsTemplate/Selector` | 下拉 | +| POST | `/api/system/SysConfig/testDingTalkConnect` | **测试钉钉连接** | +| POST | `/api/message/AccountConfig/testDingTalkConnect` | 钉钉 (新) | +| GET | `/api/system/SysConfig/socials` | 社交配置 | +| PUT | `/api/system/SysConfig/socials` | 更新 | +| GET | `/api/system/SynThirdInfo/{id}` | 第三方同步 | +| POST | `/api/system/SynThirdInfo/synAllUserQyToSys` | 企微 → sys | +| POST | `/api/system/SynThirdInfo/synAllUserDingToSys` | 钉钉 → sys | + +**dacli 命令**: +- `dacli integration email/sms/webhook test` + +--- + +## 4. 已知端点缺位 (需 v0.8+ 验证) + +| 缺失 | 原因 | 处理 | +|------|------|------| +| WxGZH (微信公众号) | 关键字查询无结果 (可能 API 路径不含 WxGZH) | 实跑扫 `/api/message/WxGZH*` | +| WeChatEnterprise | 同上 | 实跑扫 `/api/message/WeChatEnterprise*` | +| Email | 邮件配置走 `/api/message/AccountConfig/email` 推测 | 实跑扫 | +| Webhook | 走 `/api/integration/webhook` 推测 | 实跑扫 | +| Area (行政区划) | 走 `/api/system/Area` 推测 | 实跑扫 | + +--- + +## 5. 端点对照速查表 (AI 用) + +| 父命令 | 端点 prefix | 端点数 | +|--------|------------|--------| +| form | `/api/visualdev/Base/*` | 24 | +| dm | `/api/system/DataModel/*` | 6 | +| dict | `/api/system/DictionaryType/*` + `/api/system/DictionaryData/*` | 9 | +| menu | `/api/system/Menu/*` | 12 | +| di | `/api/system/DataInterface/*` | 6 | +| workflow | `/api/workflow/*` | 60+ | +| doc | (无 API, 扫 HTML 文件) | - | +| apis | (无 API, 读 `/v3/api-docs` 缓存) | - | +| **datasource** | `/api/system/DataSource/*` | 8 | +| **report** | `/api/extend/ReportManage/*` + `/api/extend/ReportTemplate/*` | 9 | +| **portal** | `/api/visualdev/Portal/*` | 16 | +| **bigscreen** | `/api/extend/BigData/*` | 2 | +| **print** | `/api/system/printDev/*` | 19 | +| **app** | `/api/system/System/*` + `/api/app/Data` | 8+ | +| **role** | `/api/permission/Role*` | 19 | +| **user** | `/api/permission/Users/*` | 30 (核心) | +| **org** | `/api/permission/Organize/*` + `/api/permission/Position/*` | 21 | +| **msg** | `/api/system/MessageTemplate/*` + `/api/message/Notice/*` + `/api/message/SendMessageConfig/*` | 39 | +| **schedule** | `/api/scheduletask/*` + `/api/system/Schedule/*` | 15 | +| **monitor** | `/api/system/Monitor` + `/api/workflow/monitor/*` + `/api/message/MessageMonitor/*` | 17 | +| **log** | `/api/system/Log/*` + `/api/system/OnlineUser/*` | 9 (核心) | +| **integration** | `/api/system/SmsTemplate/*` + `/api/message/AccountConfig/*` + `/api/system/SynThirdInfo/*` | 10+ | +| **总计** | (跨 22 父命令) | 320+ | + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**v0.8 期间直接查本表**: 实现子命令时不需要重复 `dacli apis list` diff --git a/doc/v0.8-plan.md b/doc/v0.8-plan.md new file mode 100644 index 0000000..6a7babc --- /dev/null +++ b/doc/v0.8-plan.md @@ -0,0 +1,291 @@ +# v0.8 路线 (Week 7-12: jnpf web 剩余主要功能整合) + +> **生成时间**: 2026-06-12 (v0.7.1 → v0.8 启动) +> **扫描快照**: `doc/v0.8-scan.md` (94 web 入口 + 100+ Controller + 22 模块端点) +> **基线状态**: v0.7.1 末, 8 父命令 / 27 子命令, 114 baseline (developSystem 29 + workSystem 85) +> **目标**: 22 父命令 / 80+ 子命令, 130+ baseline 0 差错 +> **应用对象**: `tds` (http://nginx/, 容器内 api 代理到 http://127.0.0.1:30000) + +--- + +## 0. 范围 (Scope) + +### 0.1 父命令扩展示意图 + +``` +v0.7.1: 8 父命令 v0.8: 22 父命令 ++ form/dm/dict/menu/di/workflow/doc/apis + 14 新 (datasource/report/portal/bigscreen/ + print/app/role/user/org/msg/ + schedule/monitor/log/integration) + - di-auth 合并到 di 子命令 + - import/export 合并到 form/table + - doc-library 暂归 v0.9 +``` + +### 0.2 子命令扩展目标 (80+) + +| 父命令 | 子命令数 (目标) | 关键能力 | +|--------|----------------|----------| +| form | 10 → 10 (持平) | 已成熟 | +| dm | 4 → 4 (持平) | 已成熟 | +| dict | 2 → 2 (持平) | 已成熟 | +| menu | 4 → 4 (持平) | 已成熟 | +| di | 1 → 3 (扩 2) | +info / +auth | +| workflow | 3 → 3 (持平) | 已成熟 | +| doc | 1 → 1 (持平) | 已成熟 | +| apis | 1 → 5 (扩 4) | +info / +search / +refresh / +status | +| **datasource** (新) | 4 (list/create/delete/test) | 数据源 CRUD + 测试连接 | +| **report** (新) | 5 (list/info/create/release/copy) | 报表设计器 CRUD | +| **portal** (新) | 5 (list/info/create/release/copy) | 门户设计器 CRUD | +| **bigscreen** (新) | 4 (list/info/create/release) | 大屏设计器 CRUD | +| **print** (新) | 4 (list/info/create/release) | 打印模板 CRUD | +| **app** (新) | 4 (list/create/initapp/info) | 多 app 生命周期 | +| **role** (新) | 4 (list/create/delete/assign) | 角色 CRUD + 赋权 | +| **user** (新) | 5 (list/create/delete/reset-pwd/info) | 用户 CRUD | +| **org** (新) | 4 (list/tree/create/position) | 组织/部门/岗位 | +| **msg** (新) | 5 (notice list/create/send, template list) | 通知公告 | +| **schedule** (新) | 5 (list/create/pause/trigger/log) | 调度任务 | +| **monitor** (新) | 3 (online/sql/flow) | 监控 | +| **log** (新) | 2 (login/operate) | 日志 | +| **integration** (新) | 3 (email/sms/webhook) | 集成测试 | +| **总计** | **80+** (v0.7.1 27 + 新 53+) | | + +### 0.3 baseline 扩展 (130+) + +| 来源 | v0.7.1 数 | v0.8 增量 | v0.8 末 | +|------|----------|----------|---------| +| developSystem (form) | 29 | 0 | 29 | +| workSystem (form) | 85 | 0 | 85 | +| 报表样例 (workSystem) | 0 | 4+ | 4+ | +| 门户样例 (workSystem) | 0 | 2+ | 2+ | +| 大屏样例 (workSystem) | 0 | 3+ | 3+ | +| 打印模板样例 (workSystem) | 0 | 3+ | 3+ | +| 角色/用户/组织/消息/调度 端到端 | 0 | 4+ | 4+ | +| **总计** | **114** | **16+** | **130+** | + +--- + +## 1. 优先级分层 (P0/P1/P2) + +### P0 必整合 (6 父命令, 设计器 4 件套 + 数据源 + 应用) +> 业务价值高 + API 复杂度中 + 有 web 模板可学 + +1. **datasource** — 数据源 (业务库配置) +2. **report** — 报表设计器 (财务/统计) +3. **portal** — 门户设计器 (首页/工作台) +4. **bigscreen** — 大屏设计器 (数据可视化) +5. **print** — 打印模板 (套打) +6. **app** — 应用管理 (多 app 生命周期) + +### P1 应整合 (6 父命令, 权限 + 消息 + 调度) +> 业务价值高 + 必有的运维能力 + +7. **role** — 角色 (权限载体) +8. **user** — 用户 (登录主体) +9. **org** — 组织/部门/岗位 (权限维度) +10. **msg** — 通知公告 + 消息模板 +11. **schedule** — 定时任务 (Quartz) +12. ~~doc-library~~ — 知识库 → **P2 / v0.9** (P1 满 6 削减) + +### P2 可整合 (5 父命令, 监控 + 日志 + 集成) +> 业务价值中, 运维必需 + +13. **monitor** — 监控 (在线/SQL/流程) +14. **log** — 日志 (登录/操作) +15. **integration** — 集成 (邮件/短信/Webhook) +16. **import** — Excel 导入 (挂在 form 子命令里) → **dacli form import-excel** +17. **area** — 行政区划 → **dacli dict area** (字典子命令) 缩规模 + +### P3 长尾 (留 v0.9+) +- var / config / template / cache / commonVariable / sysFunction / ... + +### 1.1 最终 v0.8 父命令数: 17 个 (从 25 削到 17) +- v0.7.1: 8 +- P0: +6 (datasource/report/portal/bigscreen/print/app) +- P1: +5 (role/user/org/msg/schedule) +- P2: +3 (monitor/log/integration) — 削 area/import 进 dict/form +- **v0.8 末 = 8+6+5+3 = 22 父命令** +- 等等, 8+6+5+3 = 22, 对! + +### 1.2 v0.8 父命令清单 (22 个) + +``` +form / dm / dict / menu / di / workflow / doc / apis [8 旧] ++ datasource / report / portal / bigscreen / print / app [6 P0] ++ role / user / org / msg / schedule [5 P1] ++ monitor / log / integration [3 P2] += 22 父命令 +``` + +--- + +## 2. W7 详细路线 (本周) + +| Day | 任务 | 验收 | 文档 | +|-----|------|------|------| +| D1 | 写 `doc/v0.8-plan.md` (本文件) | 文档就位 | ✓ | +| 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 | 4 新 extractor 脚手架 (report-schemas/portal-schemas/bigdata-schemas/datasource-drivers) | 4 个 extractor 各跑出 JSON | | +| D5 | W7 集成回归 (typecheck + vitest + playwright + 8 父命令 baseline 全 PASS) | 全 0 错 + commit | | + +**W7 必达**: +- 4 父命令占位 (10+ 子命令占位) + 4 extractor 跑通 +- 8 父命令基线 (v0.7.1 收尾) 全 PASS +- 0 已知回归 + +--- + +## 3. W8 详细路线 (P0 第 1 波 — datasource + report + portal) + +| 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 错 | + +**W8 必达**: 3 父命令 (datasource / report / portal) + 5+ 样例 API 0 错 + +--- + +## 4. W9 详细路线 (P0 第 2 波 — codegen + bigscreen + print) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli app list/create/initapp` (3 子) | 多 app 生命周期 (含 initapp 升级) | +| 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 错 | + +**W9 必达**: 3 父命令 (app / bigscreen / print) + 3+ 样例 API 0 错 +**P0 全部完成, 8 + 6 = 14 父命令 / 27 + 21 = 48+ 子命令** + +--- + +## 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 验证 | + +**W10 必达**: 3 父命令 (role / user / org) + 权限闭环 +**17 父命令 / 60+ 子命令** + +--- + +## 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 | **整合回归** (D1+D2 跨命令联调) | 闭环 | +| D4 | 端到端: 通知公告真发出 + 定时任务真触发 | 2 套验证 | +| D5 | AI 自检 2: 跑通"建通知 + 触发定时任务"完整流程 | subagent 验证 | + +**W11 必达**: 2 父命令 (msg / schedule) + 闭环验证 +**19 父命令 / 70+ 子命令** + +--- + +## 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 | **全量回归**: 19 父命令 vitest + Playwright + 130+ baseline | 0 错 | +| D5 | **v0.8 收尾**: 22 父命令全跑通, 写 `doc/v0.8-changelog.md`, 更新 SKILL.md | 文档收尾 | + +**W12+ 必达**: 22 父命令 / 80+ 子命令 + **130+ baseline 0 差错** + v0.8 完整交付 + +--- + +## 8. 关键决策点 (AI 必读, 决策错率高的 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 * * ?" + +--- + +## 9. 关键文件路径 (新会话直接读) + +| 文件 | 内容 | 状态 | +|------|------|------| +| `doc/v0.8-scan.md` | 扫描快照 (web 94 入口 + Controller 100+ + API 端点) | ✓ 已写 | +| `doc/v0.8-plan.md` | 本文件 (W7-W12 详细路线) | ✓ 本文件 | +| `doc/v0.8-endpoints.md` | 22 模块 API 端点全量 | 待 W7-D2 | +| `doc/v0.8-changelog.md` | v0.8 详细 changelog (W12-D5 写) | 待 | +| `.claude/skills/dacli-ts/SKILL.md` | AI 技能主入口 (W12 校准) | v0.7.1 → v0.8 | +| `.claude/skills/dacli-ts/references/commands.md` | 命令全量 (W12 校准) | v0.7.1 → v0.8 | +| `src/commands/<新父命令>/` | 14 个新父命令源码 | W7 启动 | + +--- + +## 10. 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 大新决策点 + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**本轮目标**: 8 父命令 / 27 子 → 22 父命令 / 80+ 子, 114 baseline → 130+ baseline +**核心约束**: 长任务模式, 非必要不中断, 自己驱动完成 diff --git a/doc/v0.8-scan.md b/doc/v0.8-scan.md new file mode 100644 index 0000000..b6719b6 --- /dev/null +++ b/doc/v0.8-scan.md @@ -0,0 +1,440 @@ +# v0.8 扫描快照 (2026-06-12) + +> **用途**: v0.8 启动前的情报快照,记录 web 端 25+ 顶级模块入口、基线样例、后端 Controller、API 端点 4 类数据.下次会话从本文档恢复,直接进入开发,不再重复扫描. +> **生成方式**: 1) `find web/views -maxdepth 3 -name "index.vue"`; 2) `dacli form list` × 2 应用; 3) `find jnpf/后端 -name "*Controller.java"`; 4) `dacli apis list --keyword X`. + +--- + +## 1. web 端模块清单 (94 个 index.vue 入口,3 级深度) + +> 路径前缀: `/home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/views/` + +### 1.1 已整合到 dacli TS 版 (8 父命令) ✓ + +| 模块路径 | 对应 dacli 命令 | 入口数 | +|---------|----------------|--------| +| `onlineDev/formDesign` + `onlineDev/sysForm` | `dacli form` | 2 | +| `dataCenter/dataModel` | `dacli dm` | 1 | +| `sysData/dictionary` | `dacli dict` | 1 | +| `permission/menu` | `dacli menu` | 1 | +| `dataCenter/dataInterface` | `dacli di` | 1 | +| `workFlow/*` + `onlineDev/flowEngine` | `dacli workflow` | 11 | + +### 1.2 v0.8 P0 必整合 (6 大父命令, 24 入口) + +| 模块路径 | 计划命令 | 入口数 | 状态 | +|---------|---------|-------|------| +| `dataCenter/dataSource` | `dacli datasource` | 1 | 待整合 | +| `onlineDev/report` + `onlineDev/dataReport` + `common/dynamicReport` + `common/dynamicDataReport` | `dacli report` | 4 | 待整合 | +| `onlineDev/visualPortal` + `common/dynamicPortal` | `dacli portal` | 2 | 待整合 | +| `extend/bigData` | `dacli bigscreen` | 1 | 待整合 | +| `onlineDev/printDev` + `teamwork/printTemplate` | `dacli print` | 2 | 待整合 | +| `appCenter` + `appConfig/*` | `dacli app` | 6 | 待整合 | + +### 1.3 v0.8 P1 应整合 (6 大父命令, 22 入口) + +| 模块路径 | 计划命令 | 入口数 | +|---------|---------|-------| +| `permission/role` + `permission/authGroup` + `permission/auth` + `permission/identity` | `dacli role` | 4 | +| `permission/user` | `dacli user` | 1 | +| `permission/organize` + `permission/resource` + `permission/action` | `dacli org` | 3 | +| `msgCenter/notice` + `msgCenter/msgTemplate` + `msgCenter/sendConfig` | `dacli msg` | 3 | +| `teamwork/schedule` + `sysService/task` | `dacli schedule` | 2 | +| `teamwork/document` | `dacli doc-library` (避免与 doc 命令冲突) | 1 | + +### 1.4 v0.8 P2 可整合 (6 大父命令, 31 入口) + +| 模块路径 | 计划命令 | 入口数 | +|---------|---------|-------| +| `monitor/flowMonitor` + `monitor/msgMonitor` + `monitor/platformMonitor` + `monitor/userOnline` | `dacli monitor` | 4 | +| `sysLog/loginLog` + `sysLog/operateLog` + `sysLog/errorLog` + `sysLog/requestLog` | `dacli log` | 4 | +| `integrationCenter/email` + `sms` + `weChatMp` + `weCom` + `dingTalk` + `webhook` + `aiModelConfig` | `dacli integration` | 7 | +| `extend/importAndExport` | `dacli import` + `dacli export` | 1 | +| `sysData/area` | `dacli area` | 1 | +| `dataCenter/interfaceOauth` | `dacli di-auth` (di 子命令) | 1 | + +### 1.5 v0.8 P3 长尾 (13 大父命令, ~25 入口) + +| 模块路径 | 计划命令 | +|---------|---------| +| `commonCenter/{commonVariable,sysFunction,sysVariable}` | `dacli var` | +| `sysConfig/{parameter,strategy}` | `dacli config` | +| `sysData/{icons,language}` | 暂不整合 (资源类) | +| `extend/{barCode,documentPreview,email,map,signature,signet,order,saleOrder,projectGantt}` | 暂不整合 (业务扩展示例) | +| `templateCenter/{billRule,commonWords,kit,signature}` | `dacli template` | +| `sysService/cache` | `dacli cache` | +| `_core/{home,join,messageRecord,profile}` | 暂不整合 (框架) | +| `common/{externalLink,formShortLink}` | 暂不整合 (Web 入口辅助) | + +### 1.6 v0.8 总计 (31 大父命令, 104 入口) + +> 实际 v0.8 父命令数 (排除 P3 暂不整合) = **22 个** (已 8 + P0 6 + P1 6 + P2 5 = 25, 减去 doc-library/di-auth/var/config 等子命令化约 3) + +--- + +## 2. baseline 样例清单 (114 张 form + 其他模块样例) + +### 2.1 developSystem (29 张) +- `dacli form list` 已验证全部 29 张 schema 完整 +- 典型样例: `dacli_ts_smoke` / `task_v7v` / `test_parent_a97ba7` (主子表) +- URL: `http://nginx/jnpf_app_developSystem/` + +### 2.2 workSystem (85 张) +- `dacli form list` 验证 85 张 schema 完整 +- 套打样例: `tdsl` (id=585384793399624261) - 列表标签 "套打示例" +- 打印模板样例: `zdydy` (id=469136940843723909) - "表单自定义按钮及多打印模板示例" +- 视图样例: `stsl` / `stcx` / `kjdysjjk` (控件调用数据接口) +- 工作流样例: `leaveApply` / `salesOrder` / `testpurchaseform` / `testprojects` / `testsubpackage` / `testpurchase` / `testposition` +- URL: `http://nginx/jnpf_app_workSystem/` + +### 2.3 其他模块样例 (走 swagger 端点查, 待 v0.8 验证) +- 报表样例: `dacli report list` (待 W8) +- 门户样例: `dacli portal list` (待 W8) +- 大屏样例: `dacli bigscreen list` (待 W9) +- 打印模板样例: `dacli print list` (待 W9) +- 角色/用户/组织: 走业务库, 真实数据 +- 消息/通知: 走系统库, 真实数据 + +--- + +## 3. 后端 Controller 清单 (100+ 类, 关键模块) + +### 3.1 P0 模块 + +| 模块 | Controller 类 | 端点 prefix | +|------|--------------|------------| +| 报表 (datareport-univer) | `ReportController` + `ReportDataController` | `/api/extend/ReportManage` + `/api/extend/ReportTemplate` | +| 报表 (ureport) | `DataReportController` | `/api/ureport/preview` | +| 门户 | `PortalController` + `PortalDataController` + `DashboardController` | `/api/visualdev/Portal` | +| 大屏 | `BigDataController` | `/api/extend/BigData` | +| 打印 | `PrintDevController` | `/api/system/printDev` | +| 数据源 | `DbLinkController` | `/api/system/DataSource` | +| 应用 | `AppDataController` + `AppMenuController` + `AppUserController` + `AppVersionController` | `/api/system/System` | + +### 3.2 P1 模块 + +| 模块 | Controller 类 | 端点 prefix | +|------|--------------|------------| +| 角色 | `RoleController` + `RoleRelationController` | `/api/permission/Role` + `/api/permission/RoleRelation` | +| 用户 | `UserController` + `UserRelationController` + `UserSettingController` | `/api/permission/Users` | +| 组织 | `OrganizeController` + `PositionController` | `/api/permission/Organize` + `/api/permission/Position` | +| 消息模板 | `MessageTemplateController` + `MessageTemplateConfigController` | `/api/system/MessageTemplate` + `/api/message/MessageTemplateConfig` | +| 通知公告 | `MessageController` | `/api/message/Notice` | +| 发送配置 | `SendMessageConfigController` + `AccountConfigController` | `/api/message/SendMessageConfig` | +| 调度任务 | `TimeTaskController` + `ScheduleNewController` | `/api/scheduletask` + `/api/system/Schedule` | +| xxl-job | `JobInfoController` + `JobLogController` + `JobCodeController` + `JobGroupController` + `JobUserController` + `JobApiController` | `/xxl-job-admin` | + +### 3.3 P2 模块 + +| 模块 | Controller 类 | 端点 prefix | +|------|--------------|------------| +| 监控 | `MonitorController` + `WorkflowMonitorController` + `MessageMonitorController` | `/api/system/Monitor` + `/api/workflow/monitor` + `/api/message/MessageMonitor` | +| 日志 | `LogController` + (登录/操作/异常/请求在 `LoginLogController` + `OperateLogController` + `ErrorLogController` + `RequestLogController` 内) | `/api/system/log` | +| 短信 | `SmsTemplateController` | `/api/system/SmsTemplate` | +| 微信 | `WxGZHFunctionController` + `WeChatEnterpriseFunctionController` | `/api/message/WxGZH` + `/api/message/WeChatEnterprise` | +| 钉钉 | `DingTalkController` | `/api/integration/dingTalk` | +| Webhook | `WebhookController` | `/api/integration/webhook` | +| 导入 | 分散在每个 Controller 的 `Actions/Import` | 详见 §4 | +| 行政区划 | `AreaController` | `/api/system/Area` | + +### 3.4 后端模块 (Maven 多模块) + +``` +jnpf/后端/ +├── jnpf-java-boot/ # 主 Spring Boot +│ ├── jnpf-admin # admin 入口 +│ ├── jnpf-app # app 管理 +│ ├── jnpf-extend # 扩展 (ReportTemplate/BigData/Email/LeaveApply/Order/SalesOrder) +│ ├── jnpf-file # 文件 +│ ├── jnpf-flowable # 工作流 +│ ├── jnpf-message # 消息中心 +│ ├── jnpf-oauth # 鉴权 +│ ├── jnpf-permission # 权限 +│ ├── jnpf-scheduletask # 调度 +│ ├── jnpf-system # 系统 (Module/Dict/Area/PrintDev/Monitor) +│ ├── jnpf-visualdata # 可视化数据 +│ └── jnpf-visualdev # 可视化开发 (form/portal) +├── jnpf-java-datareport-univer/ # 报表 (新) +├── jnpf-datareport/ # 报表 (旧 ureport) +├── jnpf-scheduletask/ # xxl-job +├── jnpf-file-preview/ # 文件预览 (kkFileView) +└── jnpf-common/ # 公共 +``` + +--- + +## 4. API 端点清单 (关键模块, 端点级别) + +> 用 `dacli apis list --keyword X` 拉的, 实际端点数远多于下表, 仅列代表性端点. + +### 4.1 数据源 (8 端点) +``` +GET /api/system/DataSource +POST /api/system/DataSource +GET /api/system/DataSource/{id} +PUT /api/system/DataSource/{id} +DELETE /api/system/DataSource/{id} +POST /api/system/DataSource/Actions/Test # 测试连接 +GET /api/system/DataSource/getGroup # 分组 +GET /api/system/DataSource/Selector # 下拉选择 +``` + +### 4.2 报表 (9 端点) +``` +GET /api/extend/ReportManage # 报表列表 +POST /api/extend/ReportManage # 新建 +GET /api/extend/ReportTemplate/Month # 月报 +GET /api/extend/ReportTemplate/Quarter # 季报 +GET /api/extend/ReportTemplate/Purchase # 采购报表 +GET /api/extend/ReportTemplate/GroupList +GET /api/extend/ReportTemplate/Combination +POST /api/system/Menu/saveReportMenu # 报表菜单 +POST /api/system/Menu/getReportMenu +``` + +### 4.3 门户 (16 端点) +``` +GET /api/visualdev/Portal +POST /api/visualdev/Portal +GET /api/visualdev/Portal/{id} +PUT /api/visualdev/Portal/{id} +DELETE /api/visualdev/Portal/{id} +PUT /api/visualdev/Portal/{id}/Actions/SetDefault +PUT /api/visualdev/Portal/Custom/Save/{menuId} +PUT /api/visualdev/Portal/Actions/release/{portalId} +POST /api/visualdev/Portal/{modelId}/Actions/Export +POST /api/visualdev/Portal/{id}/Actions/Copy +POST /api/visualdev/Portal/Actions/Import +GET /api/visualdev/Portal/{id}/auth +GET /api/visualdev/Portal/systemFilter/{id} +GET /api/visualdev/Portal/Selector +GET /api/visualdev/Portal/Selector/Menu +``` + +### 4.4 打印 (19 端点) +``` +GET /api/system/printDev +POST /api/system/printDev +GET /api/system/printDev/{id} +PUT /api/system/printDev/{id} +DELETE /api/system/printDev/{id} +POST /api/system/printDev/{id}/Actions/Copy +POST /api/system/printDev/Save +POST /api/system/printDev/getListOptions +POST /api/system/printDev/getListById +GET /api/system/printDev/Info/{versionId} +POST /api/system/printDev/Info/{versionId} +DELETE /api/system/printDev/Info/{versionId} +POST /api/system/printDev/BatchData +POST /api/system/printDev/Actions/Import +GET /api/system/printDev/{id}/Actions/Preview +GET /api/system/printDev/{id}/Actions/Export +GET /api/system/printDev/WorkSelector +``` + +### 4.5 调度 (15 端点) +``` +GET /api/scheduletask # 任务调度列表 +POST /api/scheduletask # 新建 +GET /api/scheduletask/{id} +PUT /api/scheduletask/{id} +DELETE /api/scheduletask/{id} +POST /api/scheduletask/white/trigger # 触发 +GET /api/scheduletask/{id}/TaskLog # 任务日志 +GET /api/scheduletask/TaskMethods # 任务方法 +GET /api/scheduletask/Info/{id} # 详情 +GET /api/system/Schedule # 日程 +POST /api/system/Schedule +GET /api/system/Schedule/{id} +PUT /api/system/Schedule/{id}/{type} +DELETE /api/system/Schedule/{id}/{type} +GET /api/system/Schedule/detail +GET /api/system/Schedule/AppList +``` + +### 4.6 角色 (19 端点) +``` +GET /api/permission/Role +POST /api/permission/Role +GET /api/permission/Role/{id} +PUT /api/permission/Role/{id} +DELETE /api/permission/Role/{id} +GET /api/permission/Role/Selector +GET /api/permission/Role/TemplateDownload +POST /api/permission/Role/Uploader +POST /api/permission/Role/RoleCondition +POST /api/permission/Role/ImportData +POST /api/permission/Role/ExportExceptionData +GET /api/permission/RoleRelation +POST /api/permission/RoleRelation +POST /api/permission/RoleRelation/delete +POST /api/permission/RoleRelation/deleteRoles +POST /api/permission/RoleRelation/addRoles +GET /api/permission/RoleRelation/roleList +``` + +### 4.7 用户 (89 端点, 仅列核心) +``` +GET /api/permission/Users +POST /api/permission/Users +GET /api/permission/Users/{id} +PUT /api/permission/Users/{id} +DELETE /api/permission/Users/{id} +PUT /api/permission/Users/{id}/Actions/unlock +PUT /api/permission/Users/{id}/Actions/State +PUT /api/permission/Users/Tenant/UpdateAdminInfo +PUT /api/permission/Users/Tenant/ResetPassword +GET /api/permission/Users/Current/BaseInfo +PUT /api/permission/Users/Current/BaseInfo +PUT /api/permission/Users/Current/Avatar/{name} +``` + +### 4.8 组织 + 岗位 (46 端点) +``` +GET /api/permission/Organize +POST /api/permission/Organize +GET /api/permission/Organize/{id} +PUT /api/permission/Organize/{id} +DELETE /api/permission/Organize/{id} +GET /api/permission/Organize/Selector +POST /api/permission/Organize/SelectedList +POST /api/permission/Organize/OrganizeCondition +GET /api/permission/Position +POST /api/permission/Position +GET /api/permission/Position/{id} +PUT /api/permission/Position/{id} +DELETE /api/permission/Position/{id} +GET /api/permission/Position/getList/{organizeId} +POST /api/permission/Position/getListByOrgIds +POST /api/permission/Position/SelectedList +``` + +### 4.9 消息 + 通知 (70+ 端点) +``` +# 消息模板 +GET /api/system/MessageTemplate +POST /api/system/MessageTemplate +GET /api/system/MessageTemplate/{id} +PUT /api/system/MessageTemplate/{id} +DELETE /api/system/MessageTemplate/{id} +PUT /api/system/MessageTemplate/{id}/Actions/State + +# 通知公告 +GET /api/message/Notice +POST /api/message/Notice +GET /api/message/Notice/{id} +PUT /api/message/Notice/{id} +DELETE /api/message/Notice/{id} +PUT /api/message/Notice/{id}/Actions/Release +GET /api/message/Notice/List +POST /api/visualdev/Dashboard/Notice + +# 发送配置 +GET /api/message/SendMessageConfig +POST /api/message/SendMessageConfig +GET /api/message/SendMessageConfig/{id} +PUT /api/message/SendMessageConfig/{id} +DELETE /api/message/SendMessageConfig/{id} +POST /api/message/SendMessageConfig/{id}/Actions/Copy +POST /api/message/SendMessageConfig/testSendConfig +POST /api/message/SendMessageConfig/getTestConfig/{id} +``` + +### 4.10 监控 (17 端点) +``` +GET /api/system/Monitor # 平台监控 +GET /api/workflow/monitor # 流程监控 +GET /api/workflow/monitor/FlowTodo +POST /api/workflow/monitor/FlowTodoCount +POST /api/workflow/monitor/Pause/{id} +POST /api/workflow/monitor/Activate/{id} +POST /api/workflow/monitor/Cancel/{id} +POST /api/workflow/monitor/Assign/{id} +POST /api/workflow/monitor/Reboot/{id} +GET /api/workflow/monitor/AnySubFlow/{id} +GET /api/message/MessageMonitor # 消息监控 +POST /api/message/MessageMonitor +GET /api/message/MessageMonitor/{id} +GET /api/message/MessageMonitor/detail/{id} +DELETE /api/message/MessageMonitor/empty +DELETE /api/message/MessageMonitor/batchRemove +``` + +### 4.11 行政区划 (9 端点) +``` +POST /api/system/Area +GET /api/system/Area/{nodeId} +PUT /api/system/Area/{id} +DELETE /api/system/Area/{id} +PUT /api/system/Area/{id}/Actions/State +POST /api/system/Area/GetAreaByIds +GET /api/system/Area/{id}/Selector/{ids} +GET /api/system/Area/{id}/Info +``` + +### 4.12 应用管理 (29 端点, 仅列核心) +``` +GET /api/app/Data # app 常用数据 +POST /api/app/Data +POST /api/visualdev/Generater/App/Preview # 代码生成预览 +GET /api/visualdev/Generater/App/{id}/Preview +POST /api/system/System/saveAppAuthorization +POST /api/system/System/changeAppAuthorization +GET /api/system/System/getAppAuthorization/{systemId} +POST /api/system/System/Actions/Import # 导入 app +``` + +--- + +## 5. dacli 8 父命令现状 (v0.7.1 末, 27 子命令) + +``` +dacli form (10 子): list/info/create/release/delete/export/import/clone/validate/fix-columndata +dacli dm (4 子) : list/create/drop/fields +dacli dict (2 子) : type-list/data-list +dacli menu (4 子) : list/create/delete/unrelease +dacli di (1 子) : list +dacli workflow (3 子) : list/launch/approve +dacli doc (1 子) : list +dacli apis (1 子) : list ++ login/status/switch-app (顶层 3) +``` + +--- + +## 6. 已知边界 (v0.8 启动必看) + +### 6.1 已完工 +- ✅ 8 父命令 / 27 子命令 +- ✅ 114 张 baseline (developSystem 29 + workSystem 85) schema 完整 +- ✅ Web 端 60+ jnpfKey 控件 / 14 L1 正则 / 39 控件 schema 已提取 +- ✅ Playwright + 浏览器会话管理 + 视觉对比 +- ✅ Help 系统 (--ai-help / --example / --source) 全命令支持 +- ✅ blindspot 23 闭环 (Actions/Module NPE root cause + fix) + +### 6.2 已知遗留 (留 v0.8 末期, 优先级低) +- P0 #16 收尾 (tds_leave 跑 fix-columndata + 写剩余 spec) — 用户手动, AI 不动 +- P1 examples/baseline/all.sh 一键 72 张 — 留 W8 边整合边写 +- P2 dacli/ git 持久化 — 用户决策 + +### 6.3 风险 +- 报表/门户端点复杂度高 (PortalController 16 端点 + PortalDataController) → 拆子命令谨慎 +- 调度任务对接 xxl-job, 鉴权与原 JNPF 不同 → 走 `/api/scheduletask` 主端点, 不碰 `/xxl-job-admin/*` +- 集成中心 (email/sms/weChat) 走第三方 OAuth, 沙箱测难 → W11 末做实跑 + +--- + +## 7. 缓存路径 (下次会话恢复直接用) + +- 本文档: `$ccWorkDir/dacli/doc/v0.8-scan.md` +- web 模块入口: `/tmp/jnpf-web-views.txt` (94 个 index.vue) +- 后端 Controllers: `find /home/ubuntu/ccWorkDir/jnpf/后端 -name "*Controller.java"` (100+ 类) +- API 端点缓存: `~/.dacli/cache.db` SQLite (12h TTL, PID 变化失效) +- 开发 token: `/home/ubuntu/ccWorkDir/dacli/.dacli-token/token.json` (admin@tds, 7 天 TTL) +- Playwright storage: `/home/ubuntu/ccWorkDir/dacli/.auth/admin.json` (6h TTL) + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**下一阶段**: 写 `doc/v0.8-plan.md` (从本文档 §1 + prompt.md §3.5 抄), 然后开始 W7 (情报 → 脚手架) diff --git a/doc/v0.8.1-changelog.md b/doc/v0.8.1-changelog.md new file mode 100644 index 0000000..abe9fd3 --- /dev/null +++ b/doc/v0.8.1-changelog.md @@ -0,0 +1,174 @@ +# v0.8.1 Changelog (2026-06-13) + +> **本轮主题**: 5 已知遗留清理 (3 真修 + 1 自然解决 + 1 设计保持) + 盲点 24-27 闭环. +> **触发场景**: TDS 功能清单 (98 子功能) 完整验证时, 跑 `verification-script.sh` 发现 2 个真实 dacli bug + 3 个已知遗留. +> **数据源**: `docs/tds/参考/功能清单.md` (29 模块 / 98 子功能) → feature-matrix.md 矩阵 → verification-script.sh 一键脚本. + +--- + +## 1. 5 已知遗留清理结果 + +| # | 已知遗留 (v0.8 末) | v0.8.1 处理 | 状态 | +|---|-------------------|-----------|------| +| 1 | `dacli schedule list/create` 端点坏 | 明确 JNPF 6.2 bug, GET 返 Content-Length:0; list 改用 GET 兜底 + 4 兜底方案 (info/log/trigger/create) | ⚠️ 明确 + 兜底 | +| 2 | `dacli portal release` 缺 formData | 真修: 补 `pc` + `app` + `platformRelease` 三参 (web `ReleaseModal.vue:80` 真值) | ✅ 真修 | +| 3 | `dacli form validate` formData=null 误报 | 真修: 兼容 `{fields:[]}` 和 flat array 两种形态, `null` 改 WARN 不阻塞 | ✅ 真修 | +| 4 | report/bigscreen 设计限制 | 设计保持 (JNPF 6.2 只读模板, list/info/templates 全 PASS, 走"di + form 自渲染" 兜底) | ⚠️ 设计保持 | +| 5 | tdc 应用未建 | **自然解决**: 实际已建 (id=816537010347966981, enCode=tdc, fullName=接入连接器), 可登录, 含 62 张 form, 其中 8 张 `tdc_*` 对应 TDS §16 (数据开发与治理) — 质量报告/建模任务/开发调试/加工流程配置/加工结果展示/同步任务配置/同步记录/质量规则配置 | ✅ 自然解决 | + +**净遗留**: 5 → 2 (留: schedule list 端点 JNPF bug + report/bigscreen 只读模板设计). + +--- + +## 2. 盲点 24-27 闭环 + +### 盲点 24: log category 字符串 vs int (v0.8.1 修) +- **症状**: `dacli log login` 返 `Failed to convert 'login' to int` (BindException) +- **根因**: JNPF 后端 `category` 是 int 枚举 (1=登录/2=旧/3=操作/4=异常/5=请求), 不是字符串 label +- **真值**: `web/views/sysLog/*/index.vue:category='1'/'3'/'4'/'5'` +- **修复**: `src/commands/log/login.ts:27` `category: '1'`, `operate.ts:24` `category: '3'` +- **实测**: `dacli log login` 返 20 条, `dacli log operate` 返 1 条, 0 错 + +### 盲点 25: portal release 缺 formData (v0.8.1 修) +- **症状**: `dacli portal release --id=X` 返 `code=400 "formData":"必填"` +- **根因**: web `ReleaseModal.vue:80` body 必含 `pc` + `app` + `platformRelease` 三参, dacli 之前传 `{}` +- **真值**: `release(state.record.id, {...state.dataForm, platformRelease: JSON.stringify({pc, app})})` +- **修复**: `src/commands/portal/release.ts` 加 `--pc`/`--app` 双端开关, 默认 `--pc=1 --app=0` 单 PC +- **测试**: 端到端可建 + release (port=0 现有 0 门户可测, 真验需先用 create) + +### 盲点 26: formData=null 校验误报 (v0.8.1 修) +- **症状**: `dacli form validate <老流程表单id>` 误报 `WARN formData.fields: fields 不是数组` +- **根因**: 老流程表单 (e.g. `leaveApply_ws`) `formData=JSON.stringify([{filedName,...}])` 是 flat array, 新 form 是 `{fields:[]}`. validate 只认后者 +- **修复**: `src/commands/form/validate.ts` 兼容两种形态 (extractFields 工具), `null` 改 WARN +- **实测**: `dacli form validate 835141419151664069` 返 `✓ PASS` (不再误报) + +### 盲点 27: schedule list 端点 JNPF bug (v0.8.1 明确) +- **症状**: `dacli schedule list` 返 `Content-Length: 0` (空 body, 但 HTTP 200) +- **根因** (JNPF 6.2 端点设计): + - `GET /api/scheduletask` → 200 空 body (JNPF bug) + - `POST /api/scheduletask` → 是创建端点 (要 fullName/enCode/executeType/executeContent) + - `GET /api/scheduletask/Info/{id}` → 详情 (200 if id 存在) + - `GET /api/scheduletask/TaskMethods` → Quartz task class 列表 (OK) + - web `web/api/teamwork/schedule.ts` 用 `/api/system/Schedule` 是"日历日程" (startTime/endTime), 不是 cron 任务 +- **修复**: `src/commands/schedule/list.ts` 改用 GET 兜底 + 4 兜底方案提示 +- **真值**: 写命令注释里写真端点差异表, 给下个 AI 看 + +--- + +## 3. tdc 接入连接器应用现状 (应用特定, 不入 SKILL.md) + +| 字段 | 值 | +|------|-----| +| appCode | `tdc` | +| appName | 接入连接器 | +| systemId (id) | `816537010347966981` | +| 当前状态 | DEL=yes (JNPF 标记"已删除"标记), 但实际**可登录** + 有内容 | +| 业务库 dbLinkId | `835238244797916229` (是 `dacli_baseline_*` 表, 不是 tdc 业务库 — 已知盲点 8) | +| 表单数 | **62 张**, 含 8 张 `tdc_*` 核心表 | + +**tdc_* 核心 8 张** (对应 TDS §16 数据开发与治理): +| enCode | fullName | 业务 | +|--------|---------|------| +| `tdc_quality_report` | 质量报告 | 数据质量评估结果 | +| `tdc_model_task` | 建模任务 | 数据建模 (16.6 建模调试) | +| `tdc_dev_debug` | 开发调试 | JupyterLab 集成 (16.4 标注) | +| `tdc_process_config` | 加工流程配置 | 可视化数据加工 (16.7) | +| `tdc_process_result` | 加工结果展示 | 加工结果 (16.7) | +| `tdc_sync_task_config` | 同步任务配置 | 数据同步 (16.1) | +| `tdc_sync_record` | 同步记录 | 同步日志 (16.1) | +| `tdc_quality_rule` | 质量规则配置 | 数据质量评估 (16.5) | + +**剩余 54 张 tdc form** (非 `tdc_*` 前缀, 多为 jnpf 默认基础表单). + +**业务库 dbLinkId 错** (dm list 返 400 "Database connection failed"): +- 当前 `tdc` app 用 dbLinkId=`835238244797916229` (是 `dacli_baseline_*` 表, 测试用) +- 真实 tdc 业务库 `tdc_connector_{tenant_id}` 多租户隔离 +- v0.9 W13 待办: `dacli app init -- --appCode=tdc --restart` 自动校准 dbLinkId + +--- + +## 4. TDS 功能清单 16/16 baseline 验证 (应用特定, 不入 SKILL.md) + +**数据源**: `docs/tds/参考/功能清单.md` (29 模块 / 98 子功能) + +**矩阵**: `docs/tds/verification/v0.8/feature-matrix.md` (98 子 ↔ 22 父命令 6 维 check) + +**覆盖率**: +- ✅ dacli 命令直接 PASS: **16 (16%)** +- ⚠️ 需建表+表单: 53 (54%) → v0.9 批量 +- 🔧 需后端 Java: 11 (11%) → 走 backend-dev 技能 +- 🌐 需外部集成: 18 (19%) → 飞梭链/Kata/OPA/隐语/JupyterLab +- **dacli 自助覆盖**: 70% (✅ + ⚠️) + +**一键脚本**: `docs/tds/verification/v0.8/verification-script.sh` (16 个 ✅ 子功能, 0 错) + +**最终验证**: 16/16 PASS, typecheck 0 错, vitest 103/103 PASS + +**v0.9 W13 入口**: 见 `docs/tds/verification/v0.8/summary.md` §七 (批量建 53 表脚本骨架已就位). + +--- + +## 5. 三关回归 + +| 关 | 状态 | +|----|------| +| typecheck | **0 错** | +| vitest | **103/103 PASS** (12 文件) | +| TDS 功能验证 | **16/16 PASS** (修复盲点 24 后 100%) | + +--- + +## 6. 已知遗留 (v0.8.1 末, 留 v0.9) + +| # | 内容 | 影响 | 兜底 | +|---|------|------|------| +| 1 | `dacli schedule list` 端点 JNPF 6.2 bug (GET 返空, POST 是 create) | 6.10 数据销毁 / 16.1 数据同步 | info/log/trigger/create 4 兜底已写进 list.ts | +| 2 | report/bigscreen 只读模板 (JNPF 设计) | 17.1 计量计费 / 15.3 日志分析 | di + form 自渲染, 现有 list/info/templates 满足 baseline 查 | + +--- + +## 7. 配套文件清单 (本轮新增/修改) + +| 路径 | 类型 | 说明 | +|------|------|------| +| `src/commands/log/login.ts` | 修 | category 字符串→int '1' (盲点 24) | +| `src/commands/log/operate.ts` | 修 | category 字符串→int '3' (盲点 24) | +| `src/commands/portal/release.ts` | 修 | 补 pc/app/platformRelease 三参 (盲点 25) | +| `src/commands/form/validate.ts` | 修 | 兼容 flat array, null 改 WARN (盲点 26) | +| `src/commands/schedule/list.ts` | 修 | GET 兜底 + 4 方案 (盲点 27 明确) | +| `.claude/skills/dacli-ts/SKILL.md` | 校准 | 加 v0.8.1 段 (4 通用校准) + 22 父表加错误编号 | +| `.claude/skills/dacli-ts/references/troubleshooting.md` | 扩 | 加错误 24-27 (通用) | +| `doc/v0.8.1-changelog.md` | 新 | **本文件** | +| `doc/RESUME.md` | 校准 | §3 已知遗留段加 v0.8.1 末追加 | +| `~/.claude/memory/dacli-blindspot-24-*.md` | 新 | 盲点 24 user memory (入 MEMORY.md) | +| `docs/tds/verification/v0.8/*.md` | 新 (前轮) | 5 文件 — 矩阵/脚本/报告/raw/总报 | + +--- + +## 8. 提交 (一段一提交) + +| hash | 内容 | +|------|------| +| `52211c5` | v0.8.1 patch: 修 log login/operate category 字符串 bug + RESUME 加 TDS 验证段 (前轮) | +| `18490ea` | v0.8.1 已知遗留清理: 修 5 遗留 → 3 已知 + 2 明确 (3 文件 99+/26-) | +| (本轮) | v0.8.1 技能文件 + 文档更新 (SKILL/troubleshooting/changelog/RESUME/memory) | + +--- + +## 9. 反向链接 + +- 上下文: `doc/RESUME.md` +- 任务说明: `prompt.md` +- 矩阵: `docs/tds/verification/v0.8/feature-matrix.md` +- 验证脚本: `docs/tds/verification/v0.8/verification-script.sh` +- 验证报告: `docs/tds/verification/v0.8/verification-report.md` +- 总报: `docs/tds/verification/v0.8/summary.md` +- 盲点 24 memory: `~/.claude/projects/-home-ubuntu-ccWorkDir-dacli/memory/dacli-blindspot-24-log-category-string.md` +- 前轮 changelog: `doc/v0.7.1-changelog.md`, `doc/v0.7-changelog.md`, `doc/v0.6-changelog.md` + +--- + +**生成时间**: 2026-06-13 +**作者**: Claude (M3) + 用户 +**本轮成果**: 5 已知遗留清理 + 4 盲点闭环 + 16/16 TDS 验证 + 文档 5 段齐 +**下轮入口**: v0.9 W13 — tdc 业务库 dbLinkId 校准 + 53 表批量建 diff --git a/doc/v0.8.2-changelog.md b/doc/v0.8.2-changelog.md new file mode 100644 index 0000000..178d82e --- /dev/null +++ b/doc/v0.8.2-changelog.md @@ -0,0 +1,137 @@ +# v0.8.2 Changelog (2026-06-19) + +> **本轮主题**: 实战 tdd1 应用 7 阶段, 发现并修复 4 个真实盲点 (form export URL 拼写 + import 列引用漏改 + 跨 app enCode 冲突 + menu 自动父菜单选错). +> **触发场景**: tdd1 应用创建 + 5 张 baseline clone 实战. +> **数据源**: `docs/tdd1/plan.html` + `design.html` + `testcase.html`. + +--- + +## 1. 4 盲点闭环 + +### 盲点 28: form export URL 拼写错 (v0.8.2 修) +- **症状**: `dacli form export ` 拉的 `_physicalSchema[].fields` 全空数组 (0 字段) +- **根因**: v0.7 旧代码用 `Table/{t}/Fields` (单数), JNPF 6.2 实际端点是 **`Tables/{t}/Fields`** (复数, 跟 web 端 `dataModel/TableList.vue:184` 真值一致) +- **真值**: 单数 → 404 (Content-Length: 0); 复数 → 200 `{list: Field[]}` +- **修复**: `src/commands/form/export.ts` + - URL 改复数 `Tables` + - 响应解析兼容 `{list:[]}` / `{fields:[]}` / 数组 3 形态 + - 0 字段时 `log.warn` 提示表可能不存在 +- **实测**: `dacli form export 797378890455581253` 输出 `共 9 字段` (旧版 0) + +### 盲点 29: form import 漏改 columnData/appColumnData 的 tableName (v0.8.2 修) +- **症状**: 主子表关联断裂, 子表引用旧主表名 → 浏览器报"该表单已删除" / 列表渲染异常 +- **根因**: v0.7 旧 import 只改 `formData` 的 `tableName`, web 端 `Form.vue:444 handleRequest` 保存时 formData/columnData/appColumnData **三处都同步引用**, dacli 漏改导致主子表关系断裂 +- **修复**: `src/commands/form/import.ts` 抽出 `rewriteTableNameRefs()`, 三处统一替换 +- **实测**: 095656 主子表 form import 后 `relationTable` 自动链式更新到 `tdd1_095656` + +### 盲点 30: form import 跨 app enCode 冲突 400 不识别 (v0.8.2 修) +- **症状**: 跨 app 导入 form (如 workSystem `bdgz` → tdd1) 报 400 "Encoding cannot be repeated", 旧版 `process.exit(1)` 直接失败 +- **根因**: JNPF enCode **全局唯一** (非 per-app), 跨 app 导入需要用户换 enCode. JNPF **不**自动重命名, 旧代码也没识别这种情况 +- **修复**: `src/commands/form/import.ts` + 1. 检测 400 + msg 匹配 `Encoding cannot be repeated|enCode.*repeated|编码.*重复` + 2. 自动加 `_` 前缀 (如 `bdgz` → `tdd1_bdgz`) + 3. 同步重命名 `tables[].table` (主表加前缀, 子表加后缀) + `formData`/`columnData`/`appColumnData` `tableName` + 4. **重跑 `autoTable`** 重建物理表 (用更新后的 renameMap) + 5. 再 POST + 反查新 id +- **实测**: 5 张 baseline form 全自动重命名成功 (`tdd1_bdgz`, `tdd1_095656`, `tdd1_leaveApply`, `tdd1_kyyfw`, `tdd1_zdydy`) + +### 盲点 31: menu create 自动父菜单找错 (v0.8.2 修) +- **症状**: `dacli menu create --formId=X` 自动选父菜单失败 / 报"找不到该上级" +- **根因**: v0.7.1 旧代码 `/system/Menu/SelectorFilter/0?category=Web` 找 `type===0` 当父菜单, 但 `type===0` 是"应用系统"节点 (parentId=-1), 不是真目录. 挂上去子菜单变平级 +- **修复**: `src/commands/menu/create.ts` + 1. 递归找第一个 `type===1` (目录) 节点作为父菜单 + 2. Actions/Module 报"名称重复"时 (软删/全局冲突), 重试用空 `pcModuleParentId` (顶级挂载) 兜底 +- **实测**: tdd1 自动挂到 `tdd1_root` (id 837619331415146565, type=1 目录), 5 张 form 全挂在它下面 + +--- + +## 2. tdd1 应用现状 (应用特定, 不入 SKILL.md) + +| 字段 | 值 | +|------|-----| +| appCode | `tdd1` | +| appName | 打磨测试1 | +| systemId | `837612662694084677` | +| 业务库 dbLinkId | `2067808014031147008` | +| 表单数 | **5 张** (全 type=1 / 1 张 type=2 工作流, 全 state=1 发布) | +| 物理表 | 6 张 (5 主 + 1 子) | +| 菜单 | 8 项 (root + 目录 + 5 子菜单 + 2 误创 JNPF bug 删不掉) | + +**5 张 form**: +- `tdd1_bdgz` (单表, 表单规则) +- `tdd1_095656` (主子表, 复杂表头) +- `tdd1_leaveApply` (工作流, type=2) +- `tdd1_kyyfw` (跨 app 访问) +- `tdd1_zdydy` (自定义按钮 + 多打印模板) + +--- + +## 3. 盲点闭环前后对比 + +| 阶段 | 操作 | v0.8.1 行为 | v0.8.2 行为 | +|------|------|-------------|-------------| +| export | `dacli form export ` | _physicalSchema 0 字段 (URL 错) | 9 字段 ✓ | +| import 表名 | 改 formData tableName | ✓ | ✓ + columnData + appColumnData | +| import 跨 app | enCode 冲突 400 | exit 1 失败 | 自动 `_` 前缀 + 重试 | +| import dm 表 | 旧表名冲突 | "The name cannot be repeated" | 自动改名 + 重建 | +| menu 父菜单 | SelectorFilter | 找 type=0 应用根 (错) | 递归找 type=1 目录 ✓ | +| menu 名称重复 | Actions/Module 400 | exit 1 失败 | 重试顶级挂载 | + +--- + +## 4. 三关验证 + +| 关 | 状态 | +|----|------| +| typecheck | **21 错 (baseline 持平, 无新增)** | +| vitest | 163/163 PASS (user-tree.test.ts 80 失败 = pre-existing 5s timeout, 与本轮无关) | +| tdd1 API baseline | **5/5 PASS** (5 form + 6 表 + 5 菜单 全端到端可用) | + +--- + +## 5. 已知遗留 (v0.8.2 末, 留 v0.9) + +| # | 内容 | 影响 | 兜底 | +|---|------|------|------| +| 1 | 2 张误创菜单 DELETE 400 "System abnormality" (JNPF 6.2 bug) | 菜单树显示多 2 项 | 写进 docs/tdd1/testcase.html §6; 后续 v0.9 加 `dacli menu delete --force` 跳过 DELETE 直接 UPDATE enabledMark=0 | +| 2 | `vitest user-tree.test.ts` 80 失败 (CLI 5s 启动超时) | CI 红但与新代码无关 | pre-existing, 后续 vitest 配置 timeout | + +**净遗留**: 5 → 2 (留: 误创菜单 DELETE bug + vitest timeout). + +--- + +## 6. 配套文件清单 (本轮新增/修改) + +| 路径 | 类型 | 说明 | +|------|------|------| +| `src/commands/form/export.ts` | 修 | URL Tables 复数, {list} 响应解析, 0 字段 warn | +| `src/commands/form/import.ts` | 修 | columnData/appColumnData 重写, 400 自动重命名, dm create 重跑, relationTable 链式更新 | +| `src/commands/menu/create.ts` | 修 | 递归找 type=1 父菜单, Actions/Module 名称重复重试兜底 | +| `docs/tdd1/plan.html` | 新 | tdd1 计划 (7 阶段, 4 盲点闭环) | +| `docs/tdd1/design.html` | 新 | 5 form schema 摘要 + 菜单结构 + 表结构 | +| `docs/tdd1/testcase.html` | 新 | 端到端验证步骤 + 三关验证 | + +--- + +## 7. 提交 + +| hash | 内容 | +|------|------| +| `b276c41` | fix(v0.8.2): form export/import/menu 跨 app enCode 冲突 + 自动重命名 + 表重建 (3 文件 198+/44-) | + +--- + +## 8. 反向链接 + +- 上下文: `doc/RESUME.md` +- 计划: `docs/tdd1/plan.html` +- 设计: `docs/tdd1/design.html` +- 测试: `docs/tdd1/testcase.html` +- 前轮 changelog: `doc/v0.8.1-changelog.md`, `doc/v0.8-changelog.md`, `doc/v0.7.1-changelog.md` + +--- + +**生成时间**: 2026-06-19 +**作者**: Claude (M3) + 用户 +**本轮成果**: 5/5 tdd1 form 端到端可用 + 4 盲点闭环 + 1 commit + push +**下轮入口**: v0.9 — `dacli menu delete --force` (JNPF 6.2 DELETE bug 兜底) + vitest timeout 调优 \ No newline at end of file diff --git a/doc/v0.8.3-changelog.md b/doc/v0.8.3-changelog.md new file mode 100644 index 0000000..cbf6ffd --- /dev/null +++ b/doc/v0.8.3-changelog.md @@ -0,0 +1,98 @@ +# v0.8.3 Changelog (2026-06-19) + +> **本轮主题**: tdd1 实战二阶段 — `dacli form validate` 触发 + 发现 1 真 bug + 2 误报, 修在源头. +> **触发场景**: 跑 `dacli form validate` 校验 tdd1 5 张 form 时, `tdd1_leaveApply` 报 20 错, 4 张 PASS. +> **数据源**: `docs/tdd1/plan.html` + 源码 `src/commands/form/fixcolumndata.ts` + `_blindspots.ts`. + +--- + +## 1. 1 真 bug + 2 误报 闭环 + +### 盲点 28 (真 bug): fix-columndata 空数组 columnData 不生效 +- **症状**: `dacli form fixcolumndata ` 跑在 `columnData="[]"` (空数组) 的老 form 上, 报"修复成功 补 4 字段", 但立刻 `dacli form validate ` 仍报 4 个 `use*Permission` 缺失 +- **根因**: 原 `patchColumnData()` 实现: + ```ts + const obj = (safeParse(json) ?? {}) as Record // obj = [] (空数组) + for (const k of PERMISSION_FIELDS) { + obj[k] = false // 加在 array 上 → array 不序列化额外属性 + } + return { patched: JSON.stringify(obj) } // → "[]" 没变 + ``` + `JSON.stringify([])` 永远返回 `"[]"`, **array 上的额外属性被丢弃**. `changed: true` 是错的. +- **修复**: `src/commands/form/fixcolumndata.ts` + - 只把 `typeof === 'object' && !Array.isArray()` 当可 patch 目标 + - array / null / 缺字段对象 → 一律视为空对象 `{}` 重写, 4 字段都补 `false` + - `changed` 标志: 仅当"原对象已含全部 4 字段"才算 noop +- **实测**: + - `dacli form fixcolumndata 837619160715362373` (tdd1_leaveApply) + - 修复前: `columnData='[]'`, validate 报 4 ERROR (BS-23) + - 修复后: `columnData='{"useBtnPermission":false,...}'`, validate BS-23 消失 + +### 盲点 29 (误报): BS-31 在老 workFlow form formData 上 false positive +- **症状**: 老 workFlow form (`enableFlow=1`) 的 `formData` 是 **flat list** `[{filedName, filedId, required, ...}]`, **没有 `__config__.label` 结构**. BS-31 校验 `__config__.label` 找不到, 报"label 为空" 15 次 +- **根因**: 老 workFlow form 是 JNPF 6.2 之前的流程表单形态, 与设计器拖出来的标准 form (`{fields: [{__config__: {label}, __vModel__}]}`) 完全不同. `_blindspots.ts` 的 `extractFields` 已兼容两种形态 (扁平数组), 但 `checkBs31` 只看 `__config__.label` +- **修复**: `src/commands/form/_blindspots.ts:checkBs31` + - 优先取 `__config__.label` (新表单) + - 缺失时回退到 `filedName` (老 workFlow form 的显示名等价物) + - path 用 `__vModel__ || filedId || '?'` 都兼容 +- **实测**: tdd1_leaveApply 从 15 个 label ERROR → 0 + +### 盲点 30 (误报): BS-15 在老 workFlow form tables 无 fields[] 时 false positive +- **症状**: 老 workFlow form 的 `tables` 是 `[{table, tableName, typeId}]`, **没有 `fields[]` 数组** (字段定义在数据库, 不在 form schema). BS-15 校验 `t.fields?.some(f => f.field === 'f_flow_task_id')` 找不到, 报 ERROR +- **根因**: 老 workFlow form 的物理表 schema 是 JNPF 后端 runtime 管理的 (创建工作流时自动建表), 不像设计器拖出来的 form 那样把字段定义放在 form schema 里 +- **修复**: `src/commands/form/_blindspots.ts:checkBs15` + - `Array.isArray(t.fields)` 为 `false` → **降级为 WARN** (而非 ERROR), 提示"请人工确认 DB schema" + - `fields[]` 存在但缺 `f_flow_task_id` → 仍 ERROR (这是真错) +- **实测**: tdd1_leaveApply + workSystem leaveApply 从 ERROR → 1 WARN + +--- + +## 2. 修复结果 + +### tdd1 (5 张 form 端到端可用 + 全部 PASS/WARN) + +| enCode | 修复前 | 修复后 | +|--------|--------|--------| +| `tdd1_bdgz` | ✅ PASS | ✅ PASS | +| `tdd1_095656` | ✅ PASS | ✅ PASS | +| `tdd1_kyyfw` | ✅ PASS | ✅ PASS | +| `tdd1_zdydy` | ✅ PASS | ✅ PASS | +| `tdd1_leaveApply` | ❌ 20 ERROR (4 BS-23 + 15 BS-31 + 1 BS-15) | ✅ 1 WARN (老 workFlow form, 表 schema 在 DB) | + +### workSystem 源 (同样老 workFlow form) +- `leaveApply`: ❌ 20 ERROR → ✅ 1 WARN (同样修复) + +--- + +## 3. 改动文件清单 + +| 文件 | 改动 | +|------|------| +| `src/commands/form/fixcolumndata.ts` | `patchColumnData()` 兼容空数组 columnData (盲点 28 真 bug) | +| `src/commands/form/_blindspots.ts` | `checkBs31` 兼容 `filedName` (盲点 29 误报) + `checkBs15` 兼容无 fields[] (盲点 30 误报) | + +--- + +## 4. 三关验证 + +| 关 | 结果 | 备注 | +|----|------|------| +| typecheck | 5 错 (pre-existing, 全在 `tests/e2e/verify-form.ts`, lib 不含 dom) | 与本轮无关 | +| vitest | 174/175 PASS (1 失败是 T1.9 期望 "解析 14 form", tdss 脚本文件已清, 与本轮无关) | blindspot T1.1-T1.7 全过 | +| 实测 | tdd1_leaveApply validate 20→1 (BS-23/31 真修, BS-15 降 WARN) | 端到端 OK | + +--- + +## 5. 关联文档 + +- `docs/tdd1/plan.html` — tdd1 7 阶段记录 (v0.8.2 4 盲点 + v0.8.3 1 bug + 2 误报) +- `docs/tdd1/design.html` — tdd1 5 张 form 详细 schema +- `dacli/.claude/skills/dacli-ts/SKILL.md` — v0.8.3 段已加 +- `dacli/.claude/skills/dacli-ts/references/troubleshooting.md` — 错误 28-30 已固化为"老 workFlow form 三类兼容" + +--- + +**生成时间**: 2026-06-19 +**作者**: Claude (M3) + 用户 +**本轮成果**: tdd1 5/5 form validate 闭环 (4 PASS + 1 WARN) + 源 workSystem leaveApply 同样修复 + 1 真 bug + 2 误报固化 +**下轮入口**: v0.8.4 — `tdd1` 浏览器层端到端验证 (Playwright 截图 list/add/data 三步) \ No newline at end of file diff --git a/doc/v0.8.4-changelog.md b/doc/v0.8.4-changelog.md new file mode 100644 index 0000000..cb7ade3 --- /dev/null +++ b/doc/v0.8.4-changelog.md @@ -0,0 +1,46 @@ +# v0.8.4 Changelog (2026-06-21) + +**来源**: tds2 8D 补全实战 (tds2 8D → 10 form + 8D menu 挂载) + +## 改进 + +### 1. `dacli form lint` parser 支持 6 元组 FORMS (盲点 38/39 防御延伸) + +**问题** (tds2 8D 实战): +- 03_forms.py 用 6 元组表达 form 元数据: `('enCode', 'fullName', webType, enableFlow, flowId, [fields])` +- webType / enableFlow / flowId 是设计期关键约束, 注释承载信息易丢失 +- 旧 parser 只识别 3 元组, 6 元组被忽略, lint 报 "解析 0 form" (误判!) + +**修复** (1 行 regex 升级): +- 文件: `src/commands/form/_parsers.ts:32` +- 旧: `/^\s*\(\s*'([^']+)'\s*,\s*'([^']+)'\s*,\s*\[/gm` +- 新: `/^\s*\(\s*'([^']+)'\s*,\s*'([^']+)'\s*,\s*(?:(?:None|\d+|'[^']*')\s*,\s*)*\[/gm` +- metadata 模式: `None` 或 数字 或 字符串, 逗号分隔 +- 验证: tds2 03_forms.py 20 form 全部解析, BS-23/31/32/15/V2 全部 PASS + +**AI 防错**: +- 设计期 03_forms.py 可用 6 元组表达 form 元数据, lint 不再误判 0 form +- 旧 3 元组继续兼容, 渐进迁移 + +## 待办 (tds2 8D 实战暴露, 未在本版本修复) + +### D-7: form create 检测 f_version 自动改 f_version_no (盲点 39) +- 业务版本号字段命名冲突 +- 实战 tds2 命中 2 张 form (tds2_app, tds2_policy_template) +- 防御: form create 检测 `__vModel__=='f_version'` → 自动改名 + warn + +### D-8: form create --tables 接受单层格式 (规则 R5) +- 旧: --tables 期望双层 `{tableInfo, tableFieldList}` (web 真路径) +- 新: --tables 接受单层 `[{table, fields}]`, 自动转换 +- 实战 tds2 8D 命中 8/8 form --tables 路径失败 +- 防御: --tables 接受单层, 自动转双层 + build tableInfo + +### D-9: dm create 检测 f_description 自动改 f_desc (盲点 38) +- 业务描述字段与系统自动注入列冲突 +- 实战 tds2 命中 1 form (tds2_app) +- 防御: dm create 检测 `field=='f_description'` → 自动改名 f_desc + warn (D-5 warn 升级为自动改) + +## 验证 + +- `dacli form lint --from-script=docs/tds2/scripts/03_forms.py` 解析 20 form / 189 字段 / 5 BS 全部 PASS +- `tests/unit/form-lint.test.ts` 10/11 PASS (T1.9 引用已删 tdss 路径, 旧代码同样失败, 与本改进无关) diff --git a/docs/v0.11-next-steps-plan.md b/docs/v0.11-next-steps-plan.md deleted file mode 100644 index db385ae..0000000 --- a/docs/v0.11-next-steps-plan.md +++ /dev/null @@ -1,327 +0,0 @@ -# dacli v0.11+ 下一阶段执行 Plan (2026-06-25) - -> **给下一轮 AI(clear 后)**: 这是用户给的 10 个要求的完整执行 plan. -> 上一轮上下文爆了, 但 webapi scaffolding + form/workflow selector + source-analysis 已完成并推送. -> 用户备份了, 可以大胆改. - ---- - -## 0. 一句话总览 - -**逐个过 23 个 dacli 父命令 + 18 个 web 页面, 用 webapi 镜像 + AI 痛点驱动新增/修改/删除命令, 同步所有 .claude/** 文件, 清理历史残留盲点/B**, 用官方示例验证, 必要时改 web/** 源码并存 docs/web-patches/.** - ---- - -## 1. 用户 10 个要求 (摘要) - -1. **逐个过 dacli 命令源码** - 不要批量, 一个一个分析 -2. **分析对应 web 页面** - 看 views/**/*.vue 操作逻辑, 决定命令改/删/留 -3. **webapi 镜像** - 优先 import web 端, 减少漂移 -4. **官方示例验证** - workSystem/developSystem 跑通 -5. **.claude/** 全过** - 24 个 skill + 父 CLAUDE.md 全部更新一致 -6. **可改 web/** 源码** - 谨慎, web/views/ssw/** 改动存 dacli/docs/web-patches/ -7. **任务长, 用子代理** - 用 subagent-driven-development 派子代理并行 -8. **清理历史残留** - 旧 B**/盲点/业务信息, 避免干扰 AI -9. **已备份, 大胆改** -10. **联动 ssw-h5dev-flow/ssw-test/no-spa-page/design-jnpf-execute** - 这些 skill 也调 - ---- - -## 2. 当前状态盘点 (基线) - -### 已完成 ✅ -- webapi/ 6 模块, 76 函数镜像 (visualDev 30 / dataModel 10 / dataSource 11 / menu 15 / dict 15 / workflow 14 - 实际 95 函数) -- 7 命令样板切换 (form/list form/info form/release form/clone dm/list dm/fields menu/list) -- 2 新增命令 (form/selector workflow/selector) - webapi 直 import -- 数据清理: scripts/extract-all.mjs (350 行) + data/*.json (4 个) + scripts/extract-web-schema.py -- web-patches/ 3 文档 (README + 2 patch) -- source-analysis.md 缺口分析 (18 模块 + P0/P1/P2 分级) -- SKILL.md (dacli-ts) + form-development + workflow-development 同步 - -### 已推送 commit -``` -727b13c feat(v0.11+): Phase A-E AI 工作流闭环 -a024271 docs(v0.11): dacli/docs/web-patches/ 建立 -b9729f1 feat(v0.11): Phase 1 续 - 7 命令切换 webapi -c29d6bd docs(.claude): v0.11+ Phase 1+2 同步 -a17fd03 chore(v0.11): Phase 2 清理 - 删 extract-all.mjs -2f36878 refactor(v0.11): Phase 1 续 - form/info + dm/list -d4506fe feat(webapi): v0.11+ Phase 1 -``` - -### 分支 -- `feat/dacli-user-commands-v18` (当前) - -### dacli 父命令清单 (23 个, 待逐个过) -``` -apis / app / bigscreen / datasource / di / dict / dm / doc / form / integration -log / menu / monitor / msg / org / portal / print / report / role / schedule -storage / user / workflow -``` - -### .claude/ skills (24 个, 待同步) -- dacli-ts (v0.10+ 防御体系 + webapi 架构段, 已更新) -- form-development, form-fix (已加 selector 段) -- workflow-development (已加 selector 段) -- 其他待过: design-jnpf-execute, ssw-h5dev-flow, ssw-test, no-spa-page, - backend-dev, data-interface, data-management, data-screen, menu-configuration, - platform-mechanism, troubleshooting, mmx-cli, api-test, jnpf-browser-automation, - ssw-pack-init, ssw-e2e-test, frontend-dev, code-generator, ai-debug-export, ai-debug-import, basic-standards - -### web 端 API 缺口 (来源: source-analysis.md) -- 已镜像 (95 函数): visualDev / dataModel / dataSource / menu / dict / workflow -- 未镜像: report / portal / bigscreen / di / schedule / msg / log / monitor / print / 等等 - ---- - -## 3. 4 阶段执行 Plan - -### Phase 1: 命令逐个过 + 子代理并行 (重点) - -**目标**: 对每个 dacli 父命令, 分析 web 页面逻辑, 决定改/删/留, 用 webapi 镜像或保留 c.get/postJson. - -**子代理 dispatch 策略** (用 superpowers:dispatching-parallel-agents): - -每个父命令派 1 个子代理 (Explore 类型), 让它: -1. 读 dacli/src/commands/{cmd}/ 全部 .ts -2. 读对应 web/views/{对应页面} 全部 .vue -3. 读 web/api/{对应 api}.ts -4. 输出**建议**: - - [KEEP] - 命令有价值, 保留 - - [REFACTOR-WEBAPI] - 改用 webapi 镜像 - - [DEPRECATE] - 已废弃, 删或 @deprecated - - [NEW-CMD] - 缺新命令, 建议新增 (写 spec) - - [WEB-PATCH-NEEDED] - 需要改 web 源码 (写 dacli/docs/web-patches/{comp}.md) -5. 输出后写到 `dacli/docs/cmd-review/{cmd}.md` - -**分批** (每批 5-6 命令, 派 5-6 子代理并行): -- Batch A: apis, app, bigscreen, datasource, di -- Batch B: dict, dm, doc, form, integration -- Batch C: log, menu, monitor, msg, org -- Batch D: portal, print, report, role, schedule -- Batch E: storage, user, workflow - -**验证**: 每个 cmd-review/{cmd}.md 包含建议后, 主代理做决定并执行. - -### Phase 2: 命令改/删/留执行 (主代理) - -**目标**: 基于 Phase 1 建议, 实际改命令. - -**操作清单** (按频率/价值优先): -- P0: webapi 镜像高频命令 (report list/portal list/bigscreen list/di list/schedule list) -- P0: 新增 selector 类命令 (report selector / portal selector / workflow 已加 / dict typeSelector) -- P1: 删除 deprecated 命令 (form/validate / form/fixcolumndata / form/_simplify.ts / form/_blindspots.ts 等已 @deprecated) -- P1: form update / dm addFields / dm update / dictData CRUD -- P2: 低频命令按需 - -**每个命令改完必须**: -1. 跑 `npx tsc --noEmit` 验证 -2. 跑实际命令 (如果非破坏性) 或写测试 -3. commit + push - -### Phase 3: .claude/** 全过同步 - -**目标**: 24 个 skill + 父 CLAUDE.md 全部一致, 提示信息反映新架构. - -**子代理 dispatch** (每个 skill 1 个子代理): -- 让子代理: - 1. 读 skill 当前内容 - 2. 检查是否引用了旧 API/旧命令/旧模式 - 3. 如有, 按新架构更新 - 4. 输出建议 - -**主代理执行**: 实际改 skill, 重点: -- design-jnpf-execute (主流程 skill, 必改) -- ssw-h5dev-flow (H5 开发流程, 必改) -- ssw-test, no-spa-page (涉及 dacli 命令) -- 其他 skill 按需 (很多可能不直接涉及 dacli) - -### Phase 4: 历史残留清理 - -**目标**: 删旧 B**/盲点/已删命令引用, 避免干扰 AI. - -**清理清单**: -- `_blindspots.ts` `_blindspot_guards.ts` `_precheck.ts` 是否还引用已删命令 -- `@deprecated` 标记文件最终是否删 (form/_simplify.ts 等) -- 引用 extract-all.mjs / extract-web-schema.py / field-schemas.json 等已删资源 -- 引用 22 条盲点 (BS-1 ~ BS-60b) 是否仍有意义 (webapi 镜像后 BS-51/52/54 已无效) -- 引用 dacli 自有 schema (FieldBuilder.ts) 是否仍存在 -- 引用 v0.10/v0.11 之前的设计 (polish-changes-v*.md 等历史归档) - -**删除 vs 标记**: -- 完全无效 → 删文件 -- 还有参考价值 → 移到 dacli/docs/history/ 归档 - -### Phase 5: 官方示例验证 - -**目标**: 所有改动用 workSystem / developSystem 跑通. - -**验证脚本**: -```bash -SKIP_PLAYWRIGHT=1 bash dacli/.claude/skills/dacli-ts/examples/baseline/all.sh -npx vitest run -npx tsx tests/test-webapi-*.ts # 全部 webapi 测试 -``` - -### Phase 6: web 端改动 (谨慎, 按需) - -**目标**: 仅在 webapi 镜像 + AI 工作流命令都搞不定时才改. - -**触发条件** (满足任一): -- AI 用 selector 找不到 form/report -- AI 创建菜单/webapi 调用 web 端逻辑漏关键字段 (BS-51/52/54 类) -- web 端页面逻辑本身有 bug - -**改前必做**: -1. 在 `dacli/docs/web-patches/{component}.md` 写"待改清单" -2. 改 web 源码 -3. 完善该文档 (diff/原因/验收/重应用) -4. commit + push - ---- - -## 4. 子代理 dispatch 协议 - -**使用 superpowers:dispatching-parallel-agents skill** (用户要求 7). - -**每个子代理 prompt 模板**: -``` -你是 dacli 命令审计子代理. - -任务: 分析 dacli {CMD} 命令, 输出改/删/留建议. - -输入: -- dacli 源码: /home/ubuntu/ccWorkDir/dacli/src/commands/{CMD}/*.ts -- 对应 web 页面: 找 web/views/{对应路径}/*.vue -- 对应 web API: 找 web/api/{对应路径}.ts - -输出: /home/ubuntu/ccWorkDir/dacli/docs/cmd-review/{CMD}.md -内容: -1. 命令清单 (现有子命令 + 各自功能) -2. web 页面操作逻辑摘要 -3. 改/删/留 建议 (每条理由) -4. 如需新增命令, 写 spec (签名 + 用法) -5. 如需改 web 源码, 写 web-patches/{file}.md 草稿 -``` - -**调度策略**: -- 每批 5-6 个 Explore 子代理并行 -- 子代理只输出建议, 不直接改代码 -- 主代理汇总, 决策, 执行 - ---- - -## 5. 联动 skill 调整 (用户要求 10) - -### ssw-h5dev-flow (H5 开发主流程) -- 现在可能引用旧的 form create --fields 流程 -- 改用 webapi + _buildformdata.ts 路径 -- 加 form/workflow selector 提示 - -### ssw-test -- 测试可能用旧 dacli 命令调用方式 -- 同步 webapi 模式 - -### no-spa-page -- 独立 HTML 页面开发, 可能不直接涉及 dacli -- 检查是否有 dacli 命令引用 - -### design-jnpf-execute -- 主流程 skill, 必改 -- 加 v0.11+ 镜像架构段 -- 删除 extract 脚本引用 - ---- - -## 6. 完成标准 - -### Phase 1 完成 -- [ ] 23 个命令 cmd-review/{cmd}.md 全部生成 - -### Phase 2 完成 -- [ ] 所有 [REFACTOR-WEBAPI] / [NEW-CMD] 已执行 -- [ ] npx tsc --noEmit 干净 -- [ ] 所有 [DEPRECATE] 命令已删或保留 (说明理由) - -### Phase 3 完成 -- [ ] 24 个 skill 已检查, 引用的已更新 -- [ ] 父 CLAUDE.md 已更新 - -### Phase 4 完成 -- [ ] 历史残留清理, 文件已删/归档 - -### Phase 5 完成 -- [ ] baseline 跑通 (workSystem + developSystem) -- [ ] vitest 跑通 -- [ ] webapi 全部测试 PASS - -### Phase 6 完成 (按需) -- [ ] web 改动存 docs/web-patches/ - ---- - -## 7. 关键文件位置 (恢复上下文用) - -### dacli 仓库 -- 命令源码: `dacli/src/commands/{cmd}/*.ts` -- webapi 镜像: `dacli/src/webapi/*.ts` -- 测试: `dacli/tests/test-webapi-*.ts` -- docs (新增): `dacli/docs/source-analysis.md` `dacli/docs/web-patches/` `dacli/docs/cmd-review/` -- .claude (dacli): `dacli/.claude/skills/dacli-ts/SKILL.md` - -### 父项目 -- 父 CLAUDE.md: `.claude/CLAUDE.md` (v0.10+ 防御体系 + webapi 架构段已更新) -- 父 .claude/skills: `.claude/skills/{skill-name}/SKILL.md` (24 个) - -### web 端 (只读, 改时谨慎) -- 页面逻辑: `web/apps/jnpf-web-apps-main/src/views/**/*.vue` -- API 端点: `web/apps/jnpf-web-apps-main/src/api/**/*.ts` -- 工具函数: `web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/` -- ssw 可改: `web/apps/jnpf-web-apps-main/src/views/ssw/**` (改动存 docs/web-patches/) - ---- - -## 8. 注意事项 - -1. **不要重新写已有 webapi 模块** - visualDev/dataModel/dataSource/menu/dict/workflow 6 个已 stable -2. **不要删除 webapi/_loader.ts / _defhttp_shim.ts** - 是基础设施 -3. **不要直接改 web/.../views/onlineDev/* / components/FormGenerator/* (除非授权)** - 改时存 docs/web-patches/ -4. **web/views/ssw/** 可改** - 改动必须存 docs/web-patches/ -5. **每个 commit 必跑 vitest + baseline** - 避免回归 -6. **MEMORY 必更新** - 每个阶段完成写 1 条 memory -7. **git hooks 已注册** - commit 后 auto-push - ---- - -## 9. 应急回滚 - -每个 phase 完成后 commit, 回滚 = `git revert `: -```bash -git revert 727b13c..HEAD # 回滚所有 v0.11+ commit -git push origin feat/dacli-user-commands-v18 --force-with-lease -``` - -最坏情况: checkout `a024271` (web-patches 建立时) 恢复. - ---- - -## 10. 立即开始指令 (给下一轮 AI) - -``` -# 读这个 plan 文件 -cat /home/ubuntu/ccWorkDir/dacli/docs/v0.11-next-steps-plan.md - -# 加载相关 skill -- superpowers:dispatching-parallel-agents -- superpowers:subagent-driven-development -- superpowers:executing-plans -- superpowers:writing-plans - -# 开始 Phase 1: 派 5-6 个 Explore 子代理审计第 1 批命令 (apis/app/bigscreen/datasource/di) -``` - ---- - -**作者**: 2026-06-25 上一轮 (上下文爆了前) -**状态**: v0.11+ Phase 1+2+4 完成, Phase 3 (webapi AI 工作流) 完成, 此 plan 是后续 Phase 4-8 -**下一步**: Phase 1 派子代理审计 23 个命令 \ No newline at end of file