diff --git a/doc/RESUME.md b/doc/RESUME.md deleted file mode 100644 index 8150ac4..0000000 --- a/doc/RESUME.md +++ /dev/null @@ -1,365 +0,0 @@ -# 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 deleted file mode 100644 index b33bdca..0000000 --- a/doc/v0.6-changelog.md +++ /dev/null @@ -1,87 +0,0 @@ -# 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 deleted file mode 100644 index 26eb304..0000000 --- a/doc/v0.7-changelog.md +++ /dev/null @@ -1,164 +0,0 @@ -# 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 deleted file mode 100644 index 7e3cfa4..0000000 --- a/doc/v0.7.1-changelog.md +++ /dev/null @@ -1,125 +0,0 @@ -# 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 deleted file mode 100644 index 3f65c4f..0000000 --- a/doc/v0.8-changelog.md +++ /dev/null @@ -1,128 +0,0 @@ -# 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 deleted file mode 100644 index f87ab28..0000000 --- a/doc/v0.8-endpoints.md +++ /dev/null @@ -1,402 +0,0 @@ -# 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 deleted file mode 100644 index 6a7babc..0000000 --- a/doc/v0.8-plan.md +++ /dev/null @@ -1,291 +0,0 @@ -# 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 deleted file mode 100644 index b6719b6..0000000 --- a/doc/v0.8-scan.md +++ /dev/null @@ -1,440 +0,0 @@ -# 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 deleted file mode 100644 index abe9fd3..0000000 --- a/doc/v0.8.1-changelog.md +++ /dev/null @@ -1,174 +0,0 @@ -# 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 deleted file mode 100644 index 178d82e..0000000 --- a/doc/v0.8.2-changelog.md +++ /dev/null @@ -1,137 +0,0 @@ -# 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 deleted file mode 100644 index cbf6ffd..0000000 --- a/doc/v0.8.3-changelog.md +++ /dev/null @@ -1,98 +0,0 @@ -# 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 deleted file mode 100644 index cb7ade3..0000000 --- a/doc/v0.8.4-changelog.md +++ /dev/null @@ -1,46 +0,0 @@ -# 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 new file mode 100644 index 0000000..db385ae --- /dev/null +++ b/docs/v0.11-next-steps-plan.md @@ -0,0 +1,327 @@ +# 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