diff --git a/doc/RESUME.md b/doc/RESUME.md index b3ac572..ade417f 100644 --- a/doc/RESUME.md +++ b/doc/RESUME.md @@ -1,133 +1,320 @@ -# RESUME — 会话恢复指引 (2026-06-12 v0.7.1) +# RESUME — 会话恢复指引 (2026-06-12 → v0.8 长任务启动) -> **下次会话第一句**: 读 `doc/RESUME.md`, 然后看 `doc/v0.7.1-changelog.md` 知道这一轮做了什么. -> 当前进度: v0.7.1 闭环, **盲点 23 (Actions/Module NPE) 找到真 root cause + 修**, P0 #16 spec 写了一半 (API 部分) 阻塞在生产 form 需 fix-columndata. +> **下次会话第一句**: 读 `doc/RESUME.md` (本文件), 然后看 `doc/v0.8-scan.md` 拿扫描快照. +> **当前进度**: 8 父命令 / 27 子命令 / 114 baseline 0 差错 (developSystem 29 + workSystem 85). +> **本轮目标 (v0.8)**: 把 jnpf web 剩下的 25+ 顶级模块整合进 dacli, 目标 **22 父命令 / 80+ 子命令 / 130+ baseline 0 差错**. --- -## 1. 当前状态 (v0.7.1, 2026-06-12) +## ⛔ 长任务模式 (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 status` / `dacli form list` / `dacli apis list` 查真实数据 +- 跑 `npx playwright install chromium` 装环境 +- 跑 `npm install` 装新依赖 +- 写 vitest 单测 / Playwright spec +- 跑 `git add -A && git commit` 一段一提交 + +### 真的卡死才回头 (3 件事) + +- JNPF 后端报 500, 真实 bug (有 stacktrace, 不是 NPE 兜底 "System abnormality") +- 浏览器层 E2E 一直 fail, 3 次以上重试还红 +- 缺依赖 / 缺环境 / 配置文件坏 (非代码问题) + +--- + +## 1. 当前状态 (v0.7.1 → v0.8 启动) - **typecheck**: 0 错 -- **vitest**: 36/36 PASS (33 旧 + 3 新 fix-columndata) -- **Playwright**: 21 PASS + 4 skip + **2 fail** (P0 #16 spec 1+2, 待 tds_leave 修 form) -- **dacli 命令**: 8 父 / **27**+ 子 (form 加 **fix-columndata** 10 子, menu 模式 A 自动 parent) -- **tds 应用**: 4 张 form (3 老 + 1 p16 smoke) - - `tds_leave` (835168490678657989) — 老 form, **columnData 缺 4 use*Permission** (盲点 23), 待 fix - - `p15_singletable_v2` (835166593053893573) — v0.7 #15 - - `leaveApply_ws` (835141419151664069) — v0.6 残留 - - `p16_smoke_t1` (835199145433113669) — P0 #16 调试用, 已验证 Actions/Module 修后走通, 待清 +- **vitest**: 36/36 PASS +- **Playwright**: 21 PASS + 4 skip + 2 fail (P0 #16, 见 §3 已知遗留) +- **dacli 命令**: 8 父 / 27 子 +- **baseline**: 114 张 (developSystem 29 + workSystem 85) schema 完整 +- **tds 应用**: 4 张 form (3 老 + 1 p16 smoke), 调试用 +- **v0.8 启动**: 扫描完成, 见 `doc/v0.8-scan.md` -## 2. 本轮交付清单 (v0.7.1) +## 2. v0.7.1 末交付清单 (本轮基线) -**dacli 源码** (4 个文件改/加, 修 1 真 bug + 2 改进): -- `src/commands/form/create.ts` (改, columnData 补 4 use*Permission 字段) -- `src/commands/form/fix-columndata.ts` (新, **10 子命令 `dacli form fix-columndata `**) -- `src/commands/form/index.ts` (注册新子命令) -- `src/commands/menu/create.ts` (改, 模式 A 不传 --pcParents 时自动 SelectorFilter 找根) +**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 找根 -**测试** (1 新): -- `tests/unit/fix-columndata.test.ts` (3 个验证) +**测试**: `tests/unit/fix-columndata.test.ts` (3 个验证) -**文档** (2 新): -- `doc/v0.7.1-changelog.md` (新, 详 v0.7.1 变更) -- `doc/RESUME.md` (本文件, v0.7.1 更新) +**文档**: +- `doc/v0.7.1-changelog.md` (新) +- `doc/v0.8-scan.md` (本轮新, 见 §6) -## 3. 盲点 23 闭环关键发现 (用户校准的核心) +## 3. 已知遗留 (v0.8 期间按需清, 不阻塞) -按用户 "你看看 web 端的操作方法" 校准: -1. ✅ web `CreateMenuModal.vue:93-119` → `POST /visualdev/Base/{id}/Actions/Module` -2. ✅ 后端 `VisualdevController.java:680 createModule` → `VisualUtil.getVisual()` → `setPcPermission(line 139)` -3. ✅ `log_error.log` 真实 NPE: `getUseBtnPermission() is null` → `.booleanValue()` NPE -4. ✅ `dacli form create` `columnDataObj` 缺 4 use*Permission 字段 → Jackson 反序列化 null -5. ✅ 3 处修法全部入主代码 (form create / fix-columndata / menu create auto parent) +| # | 内容 | 处理方式 | +|---|------|---------| +| P0 #16 | tds_leave 跑 fix-columndata + 写剩余 spec | W7 末用户手动跑, AI 不动 | +| P1 | examples/baseline/all.sh 真一键 72 张 | W8 边整合报表边写 | +| P2 | dacli/ git 持久化 | 用户决策, AI 不动 | -**经验教训**: "System abnormality" 是全局异常 handler 兜底字符串, 看 log 才能追到真 NPE. - -## 4. 任务面板 (16 个任务) +## 4. 任务面板 (16 个, 全部完结 → 17-22 启动) ``` -#1 [✓] 验证当前基线 (typecheck + vitest + playwright 全过) -#2 [✓] 浏览器 0 视觉差 (校准为 #5-7) -#3 [ ] examples/baseline/all.sh 真一键跑 72 张 -#4 [ ] AI 自检 (prompt W6-D4): 喂 skill 给 subagent 跑请假流程 -#5 [✓] #2.1 浏览器会话管理 (storageState + TTL) -#6 [✓] #2.2 tds 数据准备 (seed-tds-baseline.ts) -#7 [✓] #2.3 浏览器层 DOM 对比 spec (列表 PASS, 详情/CRUD 留 #10/#13) -#8 [✓] #2.4 内化 ssw-e2e-test 到 dacli-ts skill -#9 [✓] 修 regression spec 真总数 (85/29) -#10 [✓] 详情页 DOM 等价 (已 spike 验证模式) -#11 [✓] AI 重建 + CRUD (校准为 #13) -#12 [✓] 挂菜单 + 真路径 spike (已验证菜单挂上 + 真路径渲染) -#13 [✓] AI 需求驱动设计 + CRUD 真闭环 (v0.7, tds_leave, 4/4 spec PASS) -#14 [✓] dacli menu create 修 (web Actions/Module + 低级 fallback) -#15 [✓] form import 不建表 bug (v0.7, autoTable 默认 true, _physicalSchema) -#16 [~] Playwright UI CRUD 真点击 (v0.7.1 部分: 1+2 fail 等 form 修, 3+4 skip) -#17 [✓] v0.7.1 盲点 23 闭环 (Actions/Module NPE 找到真 root cause + 3 处修) +#1-17 [✓] v0.7.1 全部 17 个任务完结 (P0 #16 留作"已知遗留") +#18 [~] v0.8 W7 情报 → 脚手架 (扫描完成, 待 W7-D3 写脚手架) +#19 [ ] v0.8 W8 P0 第 1 波 (datasource + report + portal) +#20 [ ] v0.8 W9 P0 第 2 波 (codegen + bigscreen + print) +#21 [ ] v0.8 W10 P1 权限三角 (role + user + org) +#22 [ ] v0.8 W11 P1 消息中心 + 调度 + 应用 +#23 [ ] v0.8 W12+ P2 收尾 (monitor + log + integration + import + area) ``` -## 5. 下一步 (优先级排序) +--- -### P0: #16 收尾 (run fix-columndata + 写剩余 spec) -- 现在 tds_leave menu moduleId=null, 浏览器加载不到 form 数据 -- **用户手动跑** (AI 严守不动物理生产): - ```bash - npx tsx src/cli.ts form fix-columndata 835168490678657989 - npx tsx src/cli.ts menu create --fullName="员工请假申请" --formId=835168490678657989 - ``` -- 然后 p16-ui-real-crud.spec.ts 1+2 应该 PASS -- 完成后: 跑全量 Playwright, 清 tds 调试 form (p16_smoke_t1 等) +## 5. v0.8 启动 (本轮主战场) -### P1: examples/baseline/all.sh 真一键跑 72 张 (prompt W5-D5 留尾) -- 当前只有 developSystem 20 + workSystem 52 的 regression API spec -- 一键脚本未写完, 包括 export 全 72 张 + import 到 tds + Playwright 截图对比 +> **目标**: 8 父命令 → 22 父命令 / 27 子命令 → 80+ 子命令 / 114 baseline → 130+ baseline 0 差错 +> **扫描快照**: 见 `doc/v0.8-scan.md` (94 web 入口 + 100+ Controller + 完整 API 端点) -### P2: 持久化 git -- dacli/ **无 git 仓库** (.claude/.git 只跟踪 .claude/) -- 选项: `cd $ccWorkDir/dacli && git init && git add -A && git commit` 独立 repo -- 或: 让 .claude/ git 升级到 ccWorkDir 顶层 (用户决策) +### 5.1 整合目标 (按优先级) -## 6. 关键命令 (next session 直接用) +> 完整清单 + 端点 + 入口 见 `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 (含 fix-columndata 3) -JNPF_BASE_URL=http://nginx/ npx playwright test # 21 PASS + 4 skip + 2 fail (P0 #16) +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 # 跑通 -# 修 #16 阻塞 -npx tsx src/cli.ts form fix-columndata 835168490678657989 -npx tsx src/cli.ts menu create --fullName="员工请假申请" --formId=835168490678657989 -# → 之后 curl http://nginx/jnpf_app_tds/model/tds_leave 应真返回带 form 的 HTML -# → p16 spec 1+2 应 PASS - -# 清调试 form -npx tsx src/cli.ts form delete 835198842927326277 --yes # p16_smoke_test -npx tsx src/cli.ts form delete 835199145433113669 --yes # p16_smoke_t1 -# (同时跑 p16_smoke_t1 物理表 drop — 用直接 SQL 或 dacli dm drop, AI 不动) - -# 跑 v0.7.1 验证 -npx tsx src/cli.ts menu create --fullName="P16真闭环" --formId=835199145433113669 -# → 应自动发现父菜单 + POST Actions/Module 200 (vs 旧 "System abnormality") +# 7. commit W7 脚手架 +git add -A && git commit -m "W7-D3: 4 新父命令脚手架 (datasource/report/portal/bigscreen)" ``` -## 7. 重要文件路径 (恢复时直接读) +### 7.2 W8+ 命令 (边写边补, 不需要预先全列) -- `doc/RESUME.md` ← 本文件 -- `doc/v0.7.1-changelog.md` ← 本轮详细变更 (盲点 23 闭环) -- `doc/v0.7-changelog.md` ← 上轮 (P0 #13 + P1 #15) +每天至少 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` ← 任务说明书 (原始需求) +- `prompt.md` ← 任务说明书 - `.claude/skills/dacli-ts/SKILL.md` ← skill 主入口 -- `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-23 (v0.7.1 加盲点 23) -- `src/commands/form/fix-columndata.ts` ← 新 10 子命令源码 -- `tests/e2e/p16-ui-real-crud.spec.ts` ← P0 #16 部分写完的 spec (待 form 修后跑通) +- `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-23 -## 8. 上下文 (登录态等) +## 9. 上下文 (登录态等) -- dacli token: `.dacli-token/token.json` (admin@tds, 7 天 TTL) -- Playwright storageState: `.auth/admin.json` (TTL 6h, 已刷新 18:48) +- dacli token: `.dacli-token/token.json` (admin@workSystem, 7 天 TTL) +- Playwright storageState: `.auth/admin.json` (TTL 6h) - nginx + JNPF 全通 -- tds 业务库 dbLinkId: 2065323991245033472 -- 后端日志: `/home/ubuntu/ccWorkDir/log/jnpf-java-boot/log_error.log` (查盲点 23 NPE 用) +- workSystem 业务库 dbLinkId: 2065323991245033472 +- developSystem 业务库 dbLinkId: 2065048865705103360 +- 后端日志: `/home/ubuntu/ccWorkDir/log/jnpf-java-boot/log_error.log` + +## 10. v0.8 启动检查清单 (W7-D1 前 5 分钟过一遍) + +- [ ] 读 `doc/RESUME.md` ✓ (本文件) +- [ ] 读 `doc/v0.8-scan.md` ✓ (扫描快照) +- [ ] 跑 `npx tsc --noEmit` (0 错确认) +- [ ] 跑 `npx vitest run` (36/36 确认) +- [ ] 跑 `npx tsx src/cli.ts --help` (8 父命令确认) +- [ ] 跑 `npx tsx src/cli.ts status` (login OK) +- [ ] 写 `doc/v0.8-plan.md` (W7-D1) +- [ ] 写 `doc/v0.8-endpoints.md` (W7-D2) +- [ ] 4 新父命令脚手架 (W7-D3) +- [ ] 4 新 extractor 脚手架 (W7-D4) +- [ ] W7 集成回归 (W7-D5) +- [ ] **不**直接动 `src/commands/<已有>/` 源码, 先把基础设施跑通 +- [ ] **不**停下来问"是否继续", 自己驱动 + +--- + +**生成时间**: 2026-06-12 (v0.7.1 → v0.8 长任务启动) +**作者**: Claude (M3) + 用户 +**本轮目标**: 8 父命令 / 27 子 → 22 父命令 / 80+ 子, 114 baseline → 130+ baseline +**核心约束**: 长任务模式, 非必要不中断, 自己驱动完成 diff --git a/doc/v0.8-endpoints.md b/doc/v0.8-endpoints.md new file mode 100644 index 0000000..ed127ae --- /dev/null +++ b/doc/v0.8-endpoints.md @@ -0,0 +1,402 @@ +# v0.8 端点清单 (22 模块, 实测) + +> **生成时间**: 2026-06-12 +> **生成方式**: `dacli apis list --keyword X` (从 JNPF `/v3/api-docs` 缓存拉, 12h TTL) +> **应用对象**: workSystem (基线 85 张样例) +> **用法**: v0.8 期间 dacli 各父命令实现时直接查本表, 避免重复 `dacli apis list` + +--- + +## 1. P0 模块 (6 父命令) + +### 1.1 datasource (8 端点, `/api/system/DataSource`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/DataSource` | 列表 | +| POST | `/api/system/DataSource` | 新建 | +| GET | `/api/system/DataSource/{id}` | 详情 | +| PUT | `/api/system/DataSource/{id}` | 更新 | +| DELETE | `/api/system/DataSource/{id}` | 删除 | +| POST | `/api/system/DataSource/Actions/Test` | **测试连接** | +| GET | `/api/system/DataSource/getGroup` | 分组 | +| GET | `/api/system/DataSource/Selector` | 下拉 | + +**dacli 命令**: +- `dacli datasource list` +- `dacli datasource create --fullName=X --enCode=Y --dbType=mysql --user=root ...` +- `dacli datasource test --id=X` / `--user=... --password=...` +- `dacli datasource delete --id=X` + +### 1.2 report (9 端点, `/api/extend/ReportManage` + `/api/extend/ReportTemplate`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/extend/ReportManage` | 列表 | +| POST | `/api/extend/ReportManage` | 新建 (报表) | +| GET | `/api/extend/ReportTemplate/Month` | 月报 | +| GET | `/api/extend/ReportTemplate/Quarter` | 季报 | +| GET | `/api/extend/ReportTemplate/Purchase` | 采购报表 | +| GET | `/api/extend/ReportTemplate/GroupList` | 分组 | +| GET | `/api/extend/ReportTemplate/Combination` | 组合 | +| POST | `/api/system/Menu/saveReportMenu` | 报表菜单保存 | +| POST | `/api/system/Menu/getReportMenu` | 报表菜单获取 | + +**dacli 命令**: +- `dacli report list` / `dacli report info ` / `dacli report create` / `dacli report release` / `dacli report copy` + +### 1.3 portal (16 端点, `/api/visualdev/Portal`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/visualdev/Portal` | 列表 | +| POST | `/api/visualdev/Portal` | 新建 | +| GET | `/api/visualdev/Portal/{id}` | 详情 | +| PUT | `/api/visualdev/Portal/{id}` | 更新 | +| DELETE | `/api/visualdev/Portal/{id}` | 删除 | +| PUT | `/api/visualdev/Portal/{id}/Actions/SetDefault` | 设为默认门户 | +| PUT | `/api/visualdev/Portal/Custom/Save/{menuId}` | 自定义保存 | +| PUT | `/api/visualdev/Portal/Actions/release/{portalId}` | **发布** | +| POST | `/api/visualdev/Portal/{modelId}/Actions/Export` | 导出 | +| POST | `/api/visualdev/Portal/{id}/Actions/Copy` | 复制 | +| POST | `/api/visualdev/Portal/Actions/Import` | 导入 | +| GET | `/api/visualdev/Portal/{id}/auth` | 权限 | +| GET | `/api/visualdev/Portal/systemFilter/{id}` | 系统过滤 | +| GET | `/api/visualdev/Portal/Selector` | 下拉 | +| GET | `/api/visualdev/Portal/Selector/Menu` | 菜单下拉 | +| PUT | `/api/permission/Authority/Model/{portalManageId}` | 操作权限 | + +**dacli 命令**: +- `dacli portal list` / `dacli portal info ` / `dacli portal create` / `dacli portal release` / `dacli portal copy` + +### 1.4 bigscreen (2 端点, `/api/extend/BigData`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/extend/BigData` | 列表 | +| POST | `/api/extend/BigData` | 新建/更新 | + +**dacli 命令**: +- `dacli bigscreen list` / `dacli bigscreen info ` / `dacli bigscreen create` / `dacli bigscreen release` + +### 1.5 print (19 端点, `/api/system/printDev`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/printDev` | 列表 | +| POST | `/api/system/printDev` | 新建 | +| GET | `/api/system/printDev/{id}` | 详情 | +| PUT | `/api/system/printDev/{id}` | 更新 | +| DELETE | `/api/system/printDev/{id}` | 删除 | +| POST | `/api/system/printDev/{id}/Actions/Copy` | 复制 | +| POST | `/api/system/printDev/Save` | 批量保存 | +| POST | `/api/system/printDev/getListOptions` | 列表选项 | +| POST | `/api/system/printDev/getListById` | 按 ID 列表 | +| GET | `/api/system/printDev/Info/{versionId}` | 版本详情 | +| POST | `/api/system/printDev/Info/{versionId}` | 保存版本 | +| DELETE | `/api/system/printDev/Info/{versionId}` | 删除版本 | +| POST | `/api/system/printDev/BatchData` | 批量数据 | +| POST | `/api/system/printDev/Actions/Import` | 导入 | +| GET | `/api/system/printDev/{id}/Actions/Preview` | 预览 | +| GET | `/api/system/printDev/{id}/Actions/Export` | 导出 | +| GET | `/api/system/printDev/WorkSelector` | 工作选择器 | +| GET | `/api/system/printDev/Version/{id}` | 版本列表 | +| GET | `/api/system/printDev/Selector` | 下拉 | + +**dacli 命令**: +- `dacli print list` / `dacli print info ` / `dacli print create` / `dacli print release` + +### 1.6 app (8+ 端点, `/api/system/System` + `/api/app/Data`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/System/{id}` | 应用详情 | +| PUT | `/api/system/System/{id}` | 更新 | +| DELETE | `/api/system/System/{id}` | 删除 | +| GET | `/api/system/System/userAuthList` | 用户授权列表 | +| GET | `/api/system/System/getDevUser` | 开发用户 | +| POST | `/api/system/System/saveAppAuthorization` | 保存授权 | +| POST | `/api/system/System/changeAppAuthorization` | 改变授权 | +| GET | `/api/system/System/getAppAuthorization/{systemId}` | 授权详情 | +| POST | `/api/app/Data` | app 常用数据 | + +**dacli 命令**: +- `dacli app list` / `dacli app create` / `dacli app initapp` / `dacli app info` + +--- + +## 2. P1 模块 (5 父命令) + +### 2.1 role (19 端点, `/api/permission/Role` + `/api/permission/RoleRelation`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/permission/Role` | 列表 | +| POST | `/api/permission/Role` | 新建 | +| GET | `/api/permission/Role/{id}` | 详情 | +| PUT | `/api/permission/Role/{id}` | 更新 | +| DELETE | `/api/permission/Role/{id}` | 删除 | +| GET | `/api/permission/Role/Selector` | 下拉 | +| GET | `/api/permission/Role/TemplateDownload` | 模板下载 | +| POST | `/api/permission/Role/Uploader` | 上传 | +| POST | `/api/permission/Role/RoleCondition` | 角色条件 | +| POST | `/api/permission/Role/ImportData` | 导入 | +| POST | `/api/permission/Role/ExportExceptionData` | 异常导出 | +| GET | `/api/permission/Role/ImportPreview` | 导入预览 | +| GET | `/api/permission/Role/ExportData` | 导出 | +| GET | `/api/permission/RoleRelation` | 角色关系列表 | +| POST | `/api/permission/RoleRelation` | 角色关系新建 | +| POST | `/api/permission/RoleRelation/delete` | 关系删除 | +| POST | `/api/permission/RoleRelation/deleteRoles` | 删角色 | +| POST | `/api/permission/RoleRelation/addRoles` | 加角色 | +| GET | `/api/permission/RoleRelation/roleList` | 角色列表 | + +**dacli 命令**: +- `dacli role list` / `dacli role create` / `dacli role delete` / `dacli role assign` + +### 2.2 user (89 端点核心 30, `/api/permission/Users`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/permission/Users` | 列表 | +| POST | `/api/permission/Users` | 新建 | +| GET | `/api/permission/Users/{id}` | 详情 | +| PUT | `/api/permission/Users/{id}` | 更新 | +| DELETE | `/api/permission/Users/{id}` | 删除 | +| PUT | `/api/permission/Users/{id}/Actions/unlock` | 解锁 | +| PUT | `/api/permission/Users/{id}/Actions/State` | 启停 | +| POST | `/api/permission/Users/{id}/Actions/ResetPassword` | 重置密码 | +| POST | `/api/permission/Users/{id}/SetPosition` | 设岗位 | +| POST | `/api/permission/Users/workHandover` | 工作交接 | +| GET | `/api/permission/Users/Selector` | 下拉 | +| GET | `/api/permission/Users/TemplateDownload` | 模板下载 | +| POST | `/api/permission/Users/Uploader` | 上传 | +| POST | `/api/permission/Users/UserCondition` | 用户条件 | +| POST | `/api/permission/Users/ImportData` | 导入 | +| GET | `/api/permission/Users/ImportPreview` | 导入预览 | +| GET | `/api/permission/Users/ExportData` | 导出 | +| POST | `/api/permission/Users/ExportExceptionData` | 异常导出 | +| GET | `/api/permission/Users/getUserList` | 用户列表 | +| POST | `/api/permission/Users/getSubordinates` | 下属 | +| POST | `/api/permission/Users/getSelectedUserList` | 选中列表 | +| GET | `/api/permission/Users/Current/BaseInfo` | 当前用户 | +| PUT | `/api/permission/Users/Current/BaseInfo` | 更新当前 | +| POST | `/api/permission/Users/Current/Actions/ModifyPassword` | 改密 | +| POST | `/api/permission/Users/SetPositionBatch` | 批量设岗 | +| POST | `/api/permission/Users/BatchUpdateState` | 批量启停 | +| POST | `/api/permission/Users/BatchDelete` | 批量删 | +| GET | `/api/permission/Users/{id}/GetPosition` | 用户岗位 | +| GET | `/api/permission/Users/{id}/SelectorByUserPosId` | 按岗位下拉 | +| POST | `/api/permission/UserRelation` | 用户关系 | +| POST | `/api/permission/UserRelation/delete` | 关系删除 | + +**dacli 命令**: +- `dacli user list` / `dacli user create` / `dacli user delete` / `dacli user reset-pwd` / `dacli user info` + +### 2.3 org (21 端点, `/api/permission/Organize` + `/api/permission/Position`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/permission/Organize/{id}` | 详情 | +| PUT | `/api/permission/Organize/{id}` | 更新 | +| DELETE | `/api/permission/Organize/{id}` | 删除 | +| POST | `/api/permission/Organize` | 新建 | +| GET | `/api/permission/Organize/Selector` | 下拉 | +| POST | `/api/permission/Organize/SelectedList` | 选中列表 | +| POST | `/api/permission/Organize/OrganizeCondition` | 组织条件 | +| GET | `/api/permission/Organize/AsyncList/{id}` | 异步子组织 | +| GET | `/api/permission/Organize/AsyncPosList` | 异步岗位 | +| POST | `/api/permission/Organize/Uploader` | 上传 | +| POST | `/api/permission/Organize/ImportData` | 导入 | +| GET | `/api/permission/Organize/ImportPreview` | 预览 | +| GET | `/api/permission/Organize/ExportData` | 导出 | +| POST | `/api/permission/Organize/ExportExceptionData` | 异常导出 | +| GET | `/api/permission/Organize/TemplateDownload` | 模板 | +| GET | `/api/permission/Position/getList/{organizeId}` | 组织下岗位 | +| POST | `/api/permission/Position/SelectedList` | 选中岗位 | +| GET | `/api/permission/Position/{id}` | 岗位详情 | +| PUT | `/api/permission/Position/{id}` | 更新 | +| DELETE | `/api/permission/Position/{id}` | 删除 | +| POST | `/api/permission/Position` | 新建 | +| POST | `/api/permission/Position/{id}/Actions/DutyUser` | 岗位用户 | + +**dacli 命令**: +- `dacli org list` / `dacli org tree` / `dacli org create` / `dacli org position` + +### 2.4 msg (39 端点, `/api/system/MessageTemplate` + `/api/message/Notice` + `/api/message/SendMessageConfig`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/MessageTemplate` | 模板列表 | +| POST | `/api/system/MessageTemplate` | 新建 | +| GET | `/api/system/MessageTemplate/{id}` | 详情 | +| PUT | `/api/system/MessageTemplate/{id}` | 更新 | +| DELETE | `/api/system/MessageTemplate/{id}` | 删除 | +| PUT | `/api/system/MessageTemplate/{id}/Actions/State` | 启停 | +| GET | `/api/system/MessageTemplate/Selector` | 下拉 | +| GET | `/api/message/MessageTemplateConfig` | 配置列表 (新) | +| POST | `/api/message/MessageTemplateConfig` | 新建 (新) | +| GET | `/api/message/MessageTemplateConfig/{id}` | 详情 (新) | +| PUT | `/api/message/MessageTemplateConfig/{id}` | 更新 (新) | +| POST | `/api/message/MessageTemplateConfig/{id}/Actions/Copy` | 复制 | +| POST | `/api/message/MessageTemplateConfig/Action/Import` | 导入 | +| GET | `/api/message/MessageTemplateConfig/{id}/Action/Export` | 导出 | +| GET | `/api/message/MessageTemplateConfig/detail/{id}` | 详情 | +| GET | `/api/message/Notice` | 通知列表 | +| POST | `/api/message/Notice` | 新建通知 | +| GET | `/api/message/Notice/{id}` | 详情 | +| PUT | `/api/message/Notice/{id}` | 更新 | +| DELETE | `/api/message/Notice/{id}` | 删除 | +| PUT | `/api/message/Notice/{id}/Actions/Release` | 发布 | +| POST | `/api/message/Notice/List` | 通知列表 (无分页) | +| POST | `/api/visualdev/Dashboard/Notice` | 主页通知 | +| GET | `/api/message/SendMessageConfig` | 发送配置列表 | +| POST | `/api/message/SendMessageConfig` | 新建配置 | +| GET | `/api/message/SendMessageConfig/{id}` | 详情 | +| PUT | `/api/message/SendMessageConfig/{id}` | 更新 | +| DELETE | `/api/message/SendMessageConfig/{id}` | 删除 | +| POST | `/api/message/SendMessageConfig/{id}/Actions/Copy` | 复制 | +| POST | `/api/message/SendMessageConfig/testSendConfig` | **测试发送** | +| POST | `/api/message/SendMessageConfig/getTestConfig/{id}` | 测试配置 | +| GET | `/api/message/SendMessageConfig/Selector` | 下拉 | +| GET | `/api/message/SendMessageConfig/getSendConfigList` | 配置列表 | +| GET | `/api/message/SendMessageConfig/getInfoByEnCode/{enCode}` | 按 enCode 查 | +| GET | `/api/message/SendMessageConfig/detail/{id}` | 详情 | + +**dacli 命令**: +- `dacli msg notice list/create/send` / `dacli msg template list/create` + +### 2.5 schedule (15 端点, `/api/scheduletask` + `/api/system/Schedule`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/scheduletask` | 任务列表 | +| POST | `/api/scheduletask` | 新建 | +| PUT | `/api/scheduletask/{id}` | 更新 | +| DELETE | `/api/scheduletask/{id}` | 删除 | +| POST | `/api/scheduletask/white/trigger` | **触发** | +| GET | `/api/scheduletask/{id}/TaskLog` | 任务日志 | +| GET | `/api/scheduletask/TaskMethods` | 任务方法 | +| GET | `/api/scheduletask/Info/{id}` | 详情 | +| GET | `/api/system/Schedule` | 日程列表 | +| POST | `/api/system/Schedule` | 新建日程 | +| GET | `/api/system/Schedule/{id}` | 详情 | +| PUT | `/api/system/Schedule/{id}/{type}` | 更新 | +| DELETE | `/api/system/Schedule/{id}/{type}` | 删除 | +| GET | `/api/system/Schedule/detail` | 日程详情 | +| GET | `/api/system/Schedule/AppList` | app 列表 | + +**dacli 命令**: +- `dacli schedule list/create/pause/trigger/log` + +--- + +## 3. P2 模块 (3 父命令) + +### 3.1 monitor (17 端点, `/api/system/Monitor` + `/api/workflow/monitor` + `/api/message/MessageMonitor`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/Monitor` | 平台监控 | +| GET | `/api/workflow/monitor` | 流程监控 | +| GET | `/api/workflow/monitor/FlowTodo` | 流程待办 | +| POST | `/api/workflow/monitor/FlowTodoCount` | 流程待办数 | +| POST | `/api/workflow/monitor/Pause/{id}` | 暂停流程 | +| POST | `/api/workflow/monitor/Activate/{id}` | 激活流程 | +| POST | `/api/workflow/monitor/Cancel/{id}` | 取消流程 | +| POST | `/api/workflow/monitor/Assign/{id}` | 指派 | +| POST | `/api/workflow/monitor/Reboot/{id}` | 重启 | +| GET | `/api/workflow/monitor/AnySubFlow/{id}` | 子流程 | +| GET | `/api/message/MessageMonitor` | 消息监控 | +| POST | `/api/message/MessageMonitor` | 新建监控 | +| GET | `/api/message/MessageMonitor/{id}` | 详情 | +| GET | `/api/message/MessageMonitor/detail/{id}` | 详情 (含数据) | +| DELETE | `/api/message/MessageMonitor/empty` | 清空 | +| DELETE | `/api/message/MessageMonitor/batchRemove` | 批量删 | + +**dacli 命令**: +- `dacli monitor online/sql/flow` + +### 3.2 log (核心 9 端点, `/api/system/Log` + `/api/system/OnlineUser`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/Log` | 系统日志 | +| DELETE | `/api/system/Log` | 清空 | +| GET | `/api/system/Log/{id}` | 详情 | +| GET | `/api/system/Log/ModuleName` | 模块名 | +| GET | `/api/system/OnlineUser` | 在线用户 | +| DELETE | `/api/system/OnlineUser` | 强退 | +| GET | `/api/visualdev/OnlineLog` | 在线开发数据日志 | +| GET | `/api/system/DataInterfaceLog/{id}` | 数据接口调用日志 | +| GET | `/api/system/InterfaceOauth/dataInterfaceLog/{id}` | 接口认证日志 | + +**dacli 命令**: +- `dacli log login/operate` (子命令内部按业务类型拆) + +### 3.3 integration (10 端点核心, `/api/system/SmsTemplate` + `/api/message/AccountConfig` + `/api/system/SysConfig`) + +| METHOD | PATH | 用途 | +|--------|------|------| +| GET | `/api/system/SmsTemplate` | 短信模板列表 | +| POST | `/api/system/SmsTemplate` | 新建 | +| POST | `/api/system/SmsTemplate/testSent` | **测试发送** | +| GET | `/api/system/SmsTemplate/Selector` | 下拉 | +| POST | `/api/system/SysConfig/testDingTalkConnect` | **测试钉钉连接** | +| POST | `/api/message/AccountConfig/testDingTalkConnect` | 钉钉 (新) | +| GET | `/api/system/SysConfig/socials` | 社交配置 | +| PUT | `/api/system/SysConfig/socials` | 更新 | +| GET | `/api/system/SynThirdInfo/{id}` | 第三方同步 | +| POST | `/api/system/SynThirdInfo/synAllUserQyToSys` | 企微 → sys | +| POST | `/api/system/SynThirdInfo/synAllUserDingToSys` | 钉钉 → sys | + +**dacli 命令**: +- `dacli integration email/sms/webhook test` + +--- + +## 4. 已知端点缺位 (需 v0.8+ 验证) + +| 缺失 | 原因 | 处理 | +|------|------|------| +| WxGZH (微信公众号) | 关键字查询无结果 (可能 API 路径不含 WxGZH) | 实跑扫 `/api/message/WxGZH*` | +| WeChatEnterprise | 同上 | 实跑扫 `/api/message/WeChatEnterprise*` | +| Email | 邮件配置走 `/api/message/AccountConfig/email` 推测 | 实跑扫 | +| Webhook | 走 `/api/integration/webhook` 推测 | 实跑扫 | +| Area (行政区划) | 走 `/api/system/Area` 推测 | 实跑扫 | + +--- + +## 5. 端点对照速查表 (AI 用) + +| 父命令 | 端点 prefix | 端点数 | +|--------|------------|--------| +| form | `/api/visualdev/Base/*` | 24 | +| dm | `/api/system/DataModel/*` | 6 | +| dict | `/api/system/DictionaryType/*` + `/api/system/DictionaryData/*` | 9 | +| menu | `/api/system/Menu/*` | 12 | +| di | `/api/system/DataInterface/*` | 6 | +| workflow | `/api/workflow/*` | 60+ | +| doc | (无 API, 扫 HTML 文件) | - | +| apis | (无 API, 读 `/v3/api-docs` 缓存) | - | +| **datasource** | `/api/system/DataSource/*` | 8 | +| **report** | `/api/extend/ReportManage/*` + `/api/extend/ReportTemplate/*` | 9 | +| **portal** | `/api/visualdev/Portal/*` | 16 | +| **bigscreen** | `/api/extend/BigData/*` | 2 | +| **print** | `/api/system/printDev/*` | 19 | +| **app** | `/api/system/System/*` + `/api/app/Data` | 8+ | +| **role** | `/api/permission/Role*` | 19 | +| **user** | `/api/permission/Users/*` | 30 (核心) | +| **org** | `/api/permission/Organize/*` + `/api/permission/Position/*` | 21 | +| **msg** | `/api/system/MessageTemplate/*` + `/api/message/Notice/*` + `/api/message/SendMessageConfig/*` | 39 | +| **schedule** | `/api/scheduletask/*` + `/api/system/Schedule/*` | 15 | +| **monitor** | `/api/system/Monitor` + `/api/workflow/monitor/*` + `/api/message/MessageMonitor/*` | 17 | +| **log** | `/api/system/Log/*` + `/api/system/OnlineUser/*` | 9 (核心) | +| **integration** | `/api/system/SmsTemplate/*` + `/api/message/AccountConfig/*` + `/api/system/SynThirdInfo/*` | 10+ | +| **总计** | (跨 22 父命令) | 320+ | + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**v0.8 期间直接查本表**: 实现子命令时不需要重复 `dacli apis list` diff --git a/doc/v0.8-plan.md b/doc/v0.8-plan.md new file mode 100644 index 0000000..6a7babc --- /dev/null +++ b/doc/v0.8-plan.md @@ -0,0 +1,291 @@ +# v0.8 路线 (Week 7-12: jnpf web 剩余主要功能整合) + +> **生成时间**: 2026-06-12 (v0.7.1 → v0.8 启动) +> **扫描快照**: `doc/v0.8-scan.md` (94 web 入口 + 100+ Controller + 22 模块端点) +> **基线状态**: v0.7.1 末, 8 父命令 / 27 子命令, 114 baseline (developSystem 29 + workSystem 85) +> **目标**: 22 父命令 / 80+ 子命令, 130+ baseline 0 差错 +> **应用对象**: `tds` (http://nginx/, 容器内 api 代理到 http://127.0.0.1:30000) + +--- + +## 0. 范围 (Scope) + +### 0.1 父命令扩展示意图 + +``` +v0.7.1: 8 父命令 v0.8: 22 父命令 ++ form/dm/dict/menu/di/workflow/doc/apis + 14 新 (datasource/report/portal/bigscreen/ + print/app/role/user/org/msg/ + schedule/monitor/log/integration) + - di-auth 合并到 di 子命令 + - import/export 合并到 form/table + - doc-library 暂归 v0.9 +``` + +### 0.2 子命令扩展目标 (80+) + +| 父命令 | 子命令数 (目标) | 关键能力 | +|--------|----------------|----------| +| form | 10 → 10 (持平) | 已成熟 | +| dm | 4 → 4 (持平) | 已成熟 | +| dict | 2 → 2 (持平) | 已成熟 | +| menu | 4 → 4 (持平) | 已成熟 | +| di | 1 → 3 (扩 2) | +info / +auth | +| workflow | 3 → 3 (持平) | 已成熟 | +| doc | 1 → 1 (持平) | 已成熟 | +| apis | 1 → 5 (扩 4) | +info / +search / +refresh / +status | +| **datasource** (新) | 4 (list/create/delete/test) | 数据源 CRUD + 测试连接 | +| **report** (新) | 5 (list/info/create/release/copy) | 报表设计器 CRUD | +| **portal** (新) | 5 (list/info/create/release/copy) | 门户设计器 CRUD | +| **bigscreen** (新) | 4 (list/info/create/release) | 大屏设计器 CRUD | +| **print** (新) | 4 (list/info/create/release) | 打印模板 CRUD | +| **app** (新) | 4 (list/create/initapp/info) | 多 app 生命周期 | +| **role** (新) | 4 (list/create/delete/assign) | 角色 CRUD + 赋权 | +| **user** (新) | 5 (list/create/delete/reset-pwd/info) | 用户 CRUD | +| **org** (新) | 4 (list/tree/create/position) | 组织/部门/岗位 | +| **msg** (新) | 5 (notice list/create/send, template list) | 通知公告 | +| **schedule** (新) | 5 (list/create/pause/trigger/log) | 调度任务 | +| **monitor** (新) | 3 (online/sql/flow) | 监控 | +| **log** (新) | 2 (login/operate) | 日志 | +| **integration** (新) | 3 (email/sms/webhook) | 集成测试 | +| **总计** | **80+** (v0.7.1 27 + 新 53+) | | + +### 0.3 baseline 扩展 (130+) + +| 来源 | v0.7.1 数 | v0.8 增量 | v0.8 末 | +|------|----------|----------|---------| +| developSystem (form) | 29 | 0 | 29 | +| workSystem (form) | 85 | 0 | 85 | +| 报表样例 (workSystem) | 0 | 4+ | 4+ | +| 门户样例 (workSystem) | 0 | 2+ | 2+ | +| 大屏样例 (workSystem) | 0 | 3+ | 3+ | +| 打印模板样例 (workSystem) | 0 | 3+ | 3+ | +| 角色/用户/组织/消息/调度 端到端 | 0 | 4+ | 4+ | +| **总计** | **114** | **16+** | **130+** | + +--- + +## 1. 优先级分层 (P0/P1/P2) + +### P0 必整合 (6 父命令, 设计器 4 件套 + 数据源 + 应用) +> 业务价值高 + API 复杂度中 + 有 web 模板可学 + +1. **datasource** — 数据源 (业务库配置) +2. **report** — 报表设计器 (财务/统计) +3. **portal** — 门户设计器 (首页/工作台) +4. **bigscreen** — 大屏设计器 (数据可视化) +5. **print** — 打印模板 (套打) +6. **app** — 应用管理 (多 app 生命周期) + +### P1 应整合 (6 父命令, 权限 + 消息 + 调度) +> 业务价值高 + 必有的运维能力 + +7. **role** — 角色 (权限载体) +8. **user** — 用户 (登录主体) +9. **org** — 组织/部门/岗位 (权限维度) +10. **msg** — 通知公告 + 消息模板 +11. **schedule** — 定时任务 (Quartz) +12. ~~doc-library~~ — 知识库 → **P2 / v0.9** (P1 满 6 削减) + +### P2 可整合 (5 父命令, 监控 + 日志 + 集成) +> 业务价值中, 运维必需 + +13. **monitor** — 监控 (在线/SQL/流程) +14. **log** — 日志 (登录/操作) +15. **integration** — 集成 (邮件/短信/Webhook) +16. **import** — Excel 导入 (挂在 form 子命令里) → **dacli form import-excel** +17. **area** — 行政区划 → **dacli dict area** (字典子命令) 缩规模 + +### P3 长尾 (留 v0.9+) +- var / config / template / cache / commonVariable / sysFunction / ... + +### 1.1 最终 v0.8 父命令数: 17 个 (从 25 削到 17) +- v0.7.1: 8 +- P0: +6 (datasource/report/portal/bigscreen/print/app) +- P1: +5 (role/user/org/msg/schedule) +- P2: +3 (monitor/log/integration) — 削 area/import 进 dict/form +- **v0.8 末 = 8+6+5+3 = 22 父命令** +- 等等, 8+6+5+3 = 22, 对! + +### 1.2 v0.8 父命令清单 (22 个) + +``` +form / dm / dict / menu / di / workflow / doc / apis [8 旧] ++ datasource / report / portal / bigscreen / print / app [6 P0] ++ role / user / org / msg / schedule [5 P1] ++ monitor / log / integration [3 P2] += 22 父命令 +``` + +--- + +## 2. W7 详细路线 (本周) + +| Day | 任务 | 验收 | 文档 | +|-----|------|------|------| +| D1 | 写 `doc/v0.8-plan.md` (本文件) | 文档就位 | ✓ | +| D2 | `dacli apis list --keyword X` 拉 22 模块端点 → `doc/v0.8-endpoints.md` | 22 模块端点全在 | | +| D3 | 4 新父命令脚手架 (datasource/report/portal/bigscreen) | `npx tsx src/cli.ts <新> --help` 跑通 | | +| D4 | 4 新 extractor 脚手架 (report-schemas/portal-schemas/bigdata-schemas/datasource-drivers) | 4 个 extractor 各跑出 JSON | | +| D5 | W7 集成回归 (typecheck + vitest + playwright + 8 父命令 baseline 全 PASS) | 全 0 错 + commit | | + +**W7 必达**: +- 4 父命令占位 (10+ 子命令占位) + 4 extractor 跑通 +- 8 父命令基线 (v0.7.1 收尾) 全 PASS +- 0 已知回归 + +--- + +## 3. W8 详细路线 (P0 第 1 波 — datasource + report + portal) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli datasource list/create/delete/test` (4 子) | 端到端 +1 单测 +1 baseline 验证 | +| D2 | `dacli report list/info/create/release` (4 子) | workSystem 报表样例 2+ 张 0 错 | +| D3 | `dacli portal list/info/create` (3 子) | workSystem 门户样例 1+ 张 0 错 | +| D4 | baseline 验证: 报表 + 门户样例 5+ 张 (API 层 0 错) | 5+ 张 schema 完整 | +| D5 | Playwright 视觉对比 (报表 / 门户 0 视觉差) | UI 层 0 错 | + +**W8 必达**: 3 父命令 (datasource / report / portal) + 5+ 样例 API 0 错 + +--- + +## 4. W9 详细路线 (P0 第 2 波 — codegen + bigscreen + print) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli app list/create/initapp` (3 子) | 多 app 生命周期 (含 initapp 升级) | +| D2 | `dacli bigscreen list/info/create` (3 子) | 大屏样例 2+ 张 0 错 | +| D3 | `dacli print list/info/create` (3 子) | 打印模板 1+ 张 0 错 | +| D4 | baseline 验证: 大屏 + 打印样例 3+ 张 (API 层 0 错) | 3+ 张 schema 完整 | +| D5 | Playwright 视觉对比 (大屏 / 打印 0 视觉差) | UI 层 0 错 | + +**W9 必达**: 3 父命令 (app / bigscreen / print) + 3+ 样例 API 0 错 +**P0 全部完成, 8 + 6 = 14 父命令 / 27 + 21 = 48+ 子命令** + +--- + +## 5. W10 详细路线 (P1 权限三角 — role + user + org) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli role list/create/delete/assign` (4 子) | 角色 CRUD + 赋权 | +| D2 | `dacli user list/create/delete/reset-pwd` (4 子) | 用户 CRUD + 密码重置 | +| D3 | `dacli org list/tree/create` (组织/部门/岗位 3 子) | 组织树 CRUD | +| D4 | 联动验证: 建用户 → 分配组织 → 赋角色 → 登录 tds 看菜单 | 端到端 1 套 | +| D5 | AI 自检 1: 跑通"权限三角"完整流程 | subagent 验证 | + +**W10 必达**: 3 父命令 (role / user / org) + 权限闭环 +**17 父命令 / 60+ 子命令** + +--- + +## 6. W11 详细路线 (P1 消息 + 调度) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli msg notice list/create/send` + `dacli msg template` (5 子) | 通知公告 + 模板 | +| D2 | `dacli schedule list/create/pause/trigger/log` (5 子) | 任务 CRUD + 触发 | +| D3 | **整合回归** (D1+D2 跨命令联调) | 闭环 | +| D4 | 端到端: 通知公告真发出 + 定时任务真触发 | 2 套验证 | +| D5 | AI 自检 2: 跑通"建通知 + 触发定时任务"完整流程 | subagent 验证 | + +**W11 必达**: 2 父命令 (msg / schedule) + 闭环验证 +**19 父命令 / 70+ 子命令** + +--- + +## 7. W12 详细路线 (P2 收尾 + 全量回归) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli monitor online/sql/flow` (3 子) | 监控查 | +| D2 | `dacli log login/operate` (2 子) | 日志查 | +| D3 | `dacli integration email/sms/webhook test` (3 子) | 集成测试 | +| D4 | **全量回归**: 19 父命令 vitest + Playwright + 130+ baseline | 0 错 | +| D5 | **v0.8 收尾**: 22 父命令全跑通, 写 `doc/v0.8-changelog.md`, 更新 SKILL.md | 文档收尾 | + +**W12+ 必达**: 22 父命令 / 80+ 子命令 + **130+ baseline 0 差错** + v0.8 完整交付 + +--- + +## 8. 关键决策点 (AI 必读, 决策错率高的 4 点) + +### 决策 6: 报表/门户/大屏用哪个 type? + +| 场景 | webType | 是否需要物理表 | 镜像命令 | +|------|---------|--------------|----------| +| 普通报表 | 1-2 (报表设计器) | ❌ 不需要 (走数据接口拉) | `dacli report create` | +| 大屏/仪表盘 | 3-4 (大屏设计器) | ❌ 不需要 | `dacli bigscreen create` | +| 门户 (经典/全屏) | 5-6 (门户设计器) | ❌ 不需要 | `dacli portal create` | +| 打印模板 | 1-2 (printDev) | ❌ 不需要 (绑 form 数据) | `dacli print create` | + +**AI 反模式**: 给报表/门户硬建物理表 → 100% "Database exception" (它们走 di / dataInterface 拉数据) +**AI 正解**: 先 `dacli di list` 看有什么数据接口 → 报表直接 bind dataInterfaceId + +### 决策 7: 权限三角优先级 + +| 角色 | 优先级 | 必含字段 | +|------|--------|---------| +| **角色 (role)** | 1 | name, enCode, type (0业务/1系统), organizeIds, positionIds, userIds | +| **用户 (user)** | 2 | account, realName, password, organizeId, positionId, roleId, enabled | +| **组织 (org)** | 3 | name, enCode, parentId, category (公司/部门/岗位), sortCode | + +**AI 反模式**: 先建用户再建组织 → 用户 organizeId=null 报 "组织不存在" +**AI 正解**: 先建组织树 → 再建用户绑组织 → 最后建角色赋权 + +### 决策 8: 通知/消息发送通道怎么选? + +| 场景 | 通道 | dacli 命令 | +|------|------|-----------| +| 站内信 (tds 内部) | msgCenter 站内信 | `dacli msg notice send --type=site` | +| 邮件 | integrationCenter/email | `dacli integration email send` | +| 短信 | integrationCenter/sms | `dacli integration sms send` | +| 钉钉/企微/微信 | integrationCenter | `dacli integration <渠道> send` | +| Webhook (自定义) | integrationCenter/webhook | `dacli integration webhook send --url=...` | + +**AI 反模式**: 邮件配置直接改 `application.yml` → 走不到 JNPF 通知管理 +**AI 正解**: 先 `dacli integration email config` 在 JNPF 配 → 再用通知发送命令 + +### 决策 9: 定时任务 vs 工作流调度? + +| 场景 | 用什么 | 触发 | +|------|--------|------| +| 定时报表生成 / 数据清理 / 缓存刷新 | **schedule (Quartz)** | cron 表达式 | +| 业务审批流程 (请假/报销/合同) | **workflow (Flowable)** | 人工发起 / 事件触发 | +| 数据同步 (外部接口) | **schedule (Quartz)** | cron 表达式 | +| 多步审批 + 条件分支 | **workflow (Flowable)** | 流程引擎 | + +**AI 反模式**: 用工作流做"每天凌晨跑一次" → 流程引擎不适合 cron +**AI 正解**: 用 schedule, cron="0 0 0 * * ?" + +--- + +## 9. 关键文件路径 (新会话直接读) + +| 文件 | 内容 | 状态 | +|------|------|------| +| `doc/v0.8-scan.md` | 扫描快照 (web 94 入口 + Controller 100+ + API 端点) | ✓ 已写 | +| `doc/v0.8-plan.md` | 本文件 (W7-W12 详细路线) | ✓ 本文件 | +| `doc/v0.8-endpoints.md` | 22 模块 API 端点全量 | 待 W7-D2 | +| `doc/v0.8-changelog.md` | v0.8 详细 changelog (W12-D5 写) | 待 | +| `.claude/skills/dacli-ts/SKILL.md` | AI 技能主入口 (W12 校准) | v0.7.1 → v0.8 | +| `.claude/skills/dacli-ts/references/commands.md` | 命令全量 (W12 校准) | v0.7.1 → v0.8 | +| `src/commands/<新父命令>/` | 14 个新父命令源码 | W7 启动 | + +--- + +## 10. v0.8 末交付 (硬目标) + +- ✅ **22 父命令** / 80+ 子命令 (8 → 22, 翻 2.7 倍) +- ✅ **130+ baseline** 0 差错 (114 + 报表/门户/大屏/打印 16+) +- ✅ **3 个 AI 自检** (权限三角 / 通知调度 / v0.8 总体闭环) +- ✅ **`doc/v0.8-changelog.md`** 详 v0.8 全部变更 +- ✅ **`.claude/skills/dacli-ts/SKILL.md` v0.8 校准**: 加 P0/P1/P2 命令速查 + 4 大新决策点 + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**本轮目标**: 8 父命令 / 27 子 → 22 父命令 / 80+ 子, 114 baseline → 130+ baseline +**核心约束**: 长任务模式, 非必要不中断, 自己驱动完成 diff --git a/doc/v0.8-scan.md b/doc/v0.8-scan.md new file mode 100644 index 0000000..b6719b6 --- /dev/null +++ b/doc/v0.8-scan.md @@ -0,0 +1,440 @@ +# v0.8 扫描快照 (2026-06-12) + +> **用途**: v0.8 启动前的情报快照,记录 web 端 25+ 顶级模块入口、基线样例、后端 Controller、API 端点 4 类数据.下次会话从本文档恢复,直接进入开发,不再重复扫描. +> **生成方式**: 1) `find web/views -maxdepth 3 -name "index.vue"`; 2) `dacli form list` × 2 应用; 3) `find jnpf/后端 -name "*Controller.java"`; 4) `dacli apis list --keyword X`. + +--- + +## 1. web 端模块清单 (94 个 index.vue 入口,3 级深度) + +> 路径前缀: `/home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/views/` + +### 1.1 已整合到 dacli TS 版 (8 父命令) ✓ + +| 模块路径 | 对应 dacli 命令 | 入口数 | +|---------|----------------|--------| +| `onlineDev/formDesign` + `onlineDev/sysForm` | `dacli form` | 2 | +| `dataCenter/dataModel` | `dacli dm` | 1 | +| `sysData/dictionary` | `dacli dict` | 1 | +| `permission/menu` | `dacli menu` | 1 | +| `dataCenter/dataInterface` | `dacli di` | 1 | +| `workFlow/*` + `onlineDev/flowEngine` | `dacli workflow` | 11 | + +### 1.2 v0.8 P0 必整合 (6 大父命令, 24 入口) + +| 模块路径 | 计划命令 | 入口数 | 状态 | +|---------|---------|-------|------| +| `dataCenter/dataSource` | `dacli datasource` | 1 | 待整合 | +| `onlineDev/report` + `onlineDev/dataReport` + `common/dynamicReport` + `common/dynamicDataReport` | `dacli report` | 4 | 待整合 | +| `onlineDev/visualPortal` + `common/dynamicPortal` | `dacli portal` | 2 | 待整合 | +| `extend/bigData` | `dacli bigscreen` | 1 | 待整合 | +| `onlineDev/printDev` + `teamwork/printTemplate` | `dacli print` | 2 | 待整合 | +| `appCenter` + `appConfig/*` | `dacli app` | 6 | 待整合 | + +### 1.3 v0.8 P1 应整合 (6 大父命令, 22 入口) + +| 模块路径 | 计划命令 | 入口数 | +|---------|---------|-------| +| `permission/role` + `permission/authGroup` + `permission/auth` + `permission/identity` | `dacli role` | 4 | +| `permission/user` | `dacli user` | 1 | +| `permission/organize` + `permission/resource` + `permission/action` | `dacli org` | 3 | +| `msgCenter/notice` + `msgCenter/msgTemplate` + `msgCenter/sendConfig` | `dacli msg` | 3 | +| `teamwork/schedule` + `sysService/task` | `dacli schedule` | 2 | +| `teamwork/document` | `dacli doc-library` (避免与 doc 命令冲突) | 1 | + +### 1.4 v0.8 P2 可整合 (6 大父命令, 31 入口) + +| 模块路径 | 计划命令 | 入口数 | +|---------|---------|-------| +| `monitor/flowMonitor` + `monitor/msgMonitor` + `monitor/platformMonitor` + `monitor/userOnline` | `dacli monitor` | 4 | +| `sysLog/loginLog` + `sysLog/operateLog` + `sysLog/errorLog` + `sysLog/requestLog` | `dacli log` | 4 | +| `integrationCenter/email` + `sms` + `weChatMp` + `weCom` + `dingTalk` + `webhook` + `aiModelConfig` | `dacli integration` | 7 | +| `extend/importAndExport` | `dacli import` + `dacli export` | 1 | +| `sysData/area` | `dacli area` | 1 | +| `dataCenter/interfaceOauth` | `dacli di-auth` (di 子命令) | 1 | + +### 1.5 v0.8 P3 长尾 (13 大父命令, ~25 入口) + +| 模块路径 | 计划命令 | +|---------|---------| +| `commonCenter/{commonVariable,sysFunction,sysVariable}` | `dacli var` | +| `sysConfig/{parameter,strategy}` | `dacli config` | +| `sysData/{icons,language}` | 暂不整合 (资源类) | +| `extend/{barCode,documentPreview,email,map,signature,signet,order,saleOrder,projectGantt}` | 暂不整合 (业务扩展示例) | +| `templateCenter/{billRule,commonWords,kit,signature}` | `dacli template` | +| `sysService/cache` | `dacli cache` | +| `_core/{home,join,messageRecord,profile}` | 暂不整合 (框架) | +| `common/{externalLink,formShortLink}` | 暂不整合 (Web 入口辅助) | + +### 1.6 v0.8 总计 (31 大父命令, 104 入口) + +> 实际 v0.8 父命令数 (排除 P3 暂不整合) = **22 个** (已 8 + P0 6 + P1 6 + P2 5 = 25, 减去 doc-library/di-auth/var/config 等子命令化约 3) + +--- + +## 2. baseline 样例清单 (114 张 form + 其他模块样例) + +### 2.1 developSystem (29 张) +- `dacli form list` 已验证全部 29 张 schema 完整 +- 典型样例: `dacli_ts_smoke` / `task_v7v` / `test_parent_a97ba7` (主子表) +- URL: `http://nginx/jnpf_app_developSystem/` + +### 2.2 workSystem (85 张) +- `dacli form list` 验证 85 张 schema 完整 +- 套打样例: `tdsl` (id=585384793399624261) - 列表标签 "套打示例" +- 打印模板样例: `zdydy` (id=469136940843723909) - "表单自定义按钮及多打印模板示例" +- 视图样例: `stsl` / `stcx` / `kjdysjjk` (控件调用数据接口) +- 工作流样例: `leaveApply` / `salesOrder` / `testpurchaseform` / `testprojects` / `testsubpackage` / `testpurchase` / `testposition` +- URL: `http://nginx/jnpf_app_workSystem/` + +### 2.3 其他模块样例 (走 swagger 端点查, 待 v0.8 验证) +- 报表样例: `dacli report list` (待 W8) +- 门户样例: `dacli portal list` (待 W8) +- 大屏样例: `dacli bigscreen list` (待 W9) +- 打印模板样例: `dacli print list` (待 W9) +- 角色/用户/组织: 走业务库, 真实数据 +- 消息/通知: 走系统库, 真实数据 + +--- + +## 3. 后端 Controller 清单 (100+ 类, 关键模块) + +### 3.1 P0 模块 + +| 模块 | Controller 类 | 端点 prefix | +|------|--------------|------------| +| 报表 (datareport-univer) | `ReportController` + `ReportDataController` | `/api/extend/ReportManage` + `/api/extend/ReportTemplate` | +| 报表 (ureport) | `DataReportController` | `/api/ureport/preview` | +| 门户 | `PortalController` + `PortalDataController` + `DashboardController` | `/api/visualdev/Portal` | +| 大屏 | `BigDataController` | `/api/extend/BigData` | +| 打印 | `PrintDevController` | `/api/system/printDev` | +| 数据源 | `DbLinkController` | `/api/system/DataSource` | +| 应用 | `AppDataController` + `AppMenuController` + `AppUserController` + `AppVersionController` | `/api/system/System` | + +### 3.2 P1 模块 + +| 模块 | Controller 类 | 端点 prefix | +|------|--------------|------------| +| 角色 | `RoleController` + `RoleRelationController` | `/api/permission/Role` + `/api/permission/RoleRelation` | +| 用户 | `UserController` + `UserRelationController` + `UserSettingController` | `/api/permission/Users` | +| 组织 | `OrganizeController` + `PositionController` | `/api/permission/Organize` + `/api/permission/Position` | +| 消息模板 | `MessageTemplateController` + `MessageTemplateConfigController` | `/api/system/MessageTemplate` + `/api/message/MessageTemplateConfig` | +| 通知公告 | `MessageController` | `/api/message/Notice` | +| 发送配置 | `SendMessageConfigController` + `AccountConfigController` | `/api/message/SendMessageConfig` | +| 调度任务 | `TimeTaskController` + `ScheduleNewController` | `/api/scheduletask` + `/api/system/Schedule` | +| xxl-job | `JobInfoController` + `JobLogController` + `JobCodeController` + `JobGroupController` + `JobUserController` + `JobApiController` | `/xxl-job-admin` | + +### 3.3 P2 模块 + +| 模块 | Controller 类 | 端点 prefix | +|------|--------------|------------| +| 监控 | `MonitorController` + `WorkflowMonitorController` + `MessageMonitorController` | `/api/system/Monitor` + `/api/workflow/monitor` + `/api/message/MessageMonitor` | +| 日志 | `LogController` + (登录/操作/异常/请求在 `LoginLogController` + `OperateLogController` + `ErrorLogController` + `RequestLogController` 内) | `/api/system/log` | +| 短信 | `SmsTemplateController` | `/api/system/SmsTemplate` | +| 微信 | `WxGZHFunctionController` + `WeChatEnterpriseFunctionController` | `/api/message/WxGZH` + `/api/message/WeChatEnterprise` | +| 钉钉 | `DingTalkController` | `/api/integration/dingTalk` | +| Webhook | `WebhookController` | `/api/integration/webhook` | +| 导入 | 分散在每个 Controller 的 `Actions/Import` | 详见 §4 | +| 行政区划 | `AreaController` | `/api/system/Area` | + +### 3.4 后端模块 (Maven 多模块) + +``` +jnpf/后端/ +├── jnpf-java-boot/ # 主 Spring Boot +│ ├── jnpf-admin # admin 入口 +│ ├── jnpf-app # app 管理 +│ ├── jnpf-extend # 扩展 (ReportTemplate/BigData/Email/LeaveApply/Order/SalesOrder) +│ ├── jnpf-file # 文件 +│ ├── jnpf-flowable # 工作流 +│ ├── jnpf-message # 消息中心 +│ ├── jnpf-oauth # 鉴权 +│ ├── jnpf-permission # 权限 +│ ├── jnpf-scheduletask # 调度 +│ ├── jnpf-system # 系统 (Module/Dict/Area/PrintDev/Monitor) +│ ├── jnpf-visualdata # 可视化数据 +│ └── jnpf-visualdev # 可视化开发 (form/portal) +├── jnpf-java-datareport-univer/ # 报表 (新) +├── jnpf-datareport/ # 报表 (旧 ureport) +├── jnpf-scheduletask/ # xxl-job +├── jnpf-file-preview/ # 文件预览 (kkFileView) +└── jnpf-common/ # 公共 +``` + +--- + +## 4. API 端点清单 (关键模块, 端点级别) + +> 用 `dacli apis list --keyword X` 拉的, 实际端点数远多于下表, 仅列代表性端点. + +### 4.1 数据源 (8 端点) +``` +GET /api/system/DataSource +POST /api/system/DataSource +GET /api/system/DataSource/{id} +PUT /api/system/DataSource/{id} +DELETE /api/system/DataSource/{id} +POST /api/system/DataSource/Actions/Test # 测试连接 +GET /api/system/DataSource/getGroup # 分组 +GET /api/system/DataSource/Selector # 下拉选择 +``` + +### 4.2 报表 (9 端点) +``` +GET /api/extend/ReportManage # 报表列表 +POST /api/extend/ReportManage # 新建 +GET /api/extend/ReportTemplate/Month # 月报 +GET /api/extend/ReportTemplate/Quarter # 季报 +GET /api/extend/ReportTemplate/Purchase # 采购报表 +GET /api/extend/ReportTemplate/GroupList +GET /api/extend/ReportTemplate/Combination +POST /api/system/Menu/saveReportMenu # 报表菜单 +POST /api/system/Menu/getReportMenu +``` + +### 4.3 门户 (16 端点) +``` +GET /api/visualdev/Portal +POST /api/visualdev/Portal +GET /api/visualdev/Portal/{id} +PUT /api/visualdev/Portal/{id} +DELETE /api/visualdev/Portal/{id} +PUT /api/visualdev/Portal/{id}/Actions/SetDefault +PUT /api/visualdev/Portal/Custom/Save/{menuId} +PUT /api/visualdev/Portal/Actions/release/{portalId} +POST /api/visualdev/Portal/{modelId}/Actions/Export +POST /api/visualdev/Portal/{id}/Actions/Copy +POST /api/visualdev/Portal/Actions/Import +GET /api/visualdev/Portal/{id}/auth +GET /api/visualdev/Portal/systemFilter/{id} +GET /api/visualdev/Portal/Selector +GET /api/visualdev/Portal/Selector/Menu +``` + +### 4.4 打印 (19 端点) +``` +GET /api/system/printDev +POST /api/system/printDev +GET /api/system/printDev/{id} +PUT /api/system/printDev/{id} +DELETE /api/system/printDev/{id} +POST /api/system/printDev/{id}/Actions/Copy +POST /api/system/printDev/Save +POST /api/system/printDev/getListOptions +POST /api/system/printDev/getListById +GET /api/system/printDev/Info/{versionId} +POST /api/system/printDev/Info/{versionId} +DELETE /api/system/printDev/Info/{versionId} +POST /api/system/printDev/BatchData +POST /api/system/printDev/Actions/Import +GET /api/system/printDev/{id}/Actions/Preview +GET /api/system/printDev/{id}/Actions/Export +GET /api/system/printDev/WorkSelector +``` + +### 4.5 调度 (15 端点) +``` +GET /api/scheduletask # 任务调度列表 +POST /api/scheduletask # 新建 +GET /api/scheduletask/{id} +PUT /api/scheduletask/{id} +DELETE /api/scheduletask/{id} +POST /api/scheduletask/white/trigger # 触发 +GET /api/scheduletask/{id}/TaskLog # 任务日志 +GET /api/scheduletask/TaskMethods # 任务方法 +GET /api/scheduletask/Info/{id} # 详情 +GET /api/system/Schedule # 日程 +POST /api/system/Schedule +GET /api/system/Schedule/{id} +PUT /api/system/Schedule/{id}/{type} +DELETE /api/system/Schedule/{id}/{type} +GET /api/system/Schedule/detail +GET /api/system/Schedule/AppList +``` + +### 4.6 角色 (19 端点) +``` +GET /api/permission/Role +POST /api/permission/Role +GET /api/permission/Role/{id} +PUT /api/permission/Role/{id} +DELETE /api/permission/Role/{id} +GET /api/permission/Role/Selector +GET /api/permission/Role/TemplateDownload +POST /api/permission/Role/Uploader +POST /api/permission/Role/RoleCondition +POST /api/permission/Role/ImportData +POST /api/permission/Role/ExportExceptionData +GET /api/permission/RoleRelation +POST /api/permission/RoleRelation +POST /api/permission/RoleRelation/delete +POST /api/permission/RoleRelation/deleteRoles +POST /api/permission/RoleRelation/addRoles +GET /api/permission/RoleRelation/roleList +``` + +### 4.7 用户 (89 端点, 仅列核心) +``` +GET /api/permission/Users +POST /api/permission/Users +GET /api/permission/Users/{id} +PUT /api/permission/Users/{id} +DELETE /api/permission/Users/{id} +PUT /api/permission/Users/{id}/Actions/unlock +PUT /api/permission/Users/{id}/Actions/State +PUT /api/permission/Users/Tenant/UpdateAdminInfo +PUT /api/permission/Users/Tenant/ResetPassword +GET /api/permission/Users/Current/BaseInfo +PUT /api/permission/Users/Current/BaseInfo +PUT /api/permission/Users/Current/Avatar/{name} +``` + +### 4.8 组织 + 岗位 (46 端点) +``` +GET /api/permission/Organize +POST /api/permission/Organize +GET /api/permission/Organize/{id} +PUT /api/permission/Organize/{id} +DELETE /api/permission/Organize/{id} +GET /api/permission/Organize/Selector +POST /api/permission/Organize/SelectedList +POST /api/permission/Organize/OrganizeCondition +GET /api/permission/Position +POST /api/permission/Position +GET /api/permission/Position/{id} +PUT /api/permission/Position/{id} +DELETE /api/permission/Position/{id} +GET /api/permission/Position/getList/{organizeId} +POST /api/permission/Position/getListByOrgIds +POST /api/permission/Position/SelectedList +``` + +### 4.9 消息 + 通知 (70+ 端点) +``` +# 消息模板 +GET /api/system/MessageTemplate +POST /api/system/MessageTemplate +GET /api/system/MessageTemplate/{id} +PUT /api/system/MessageTemplate/{id} +DELETE /api/system/MessageTemplate/{id} +PUT /api/system/MessageTemplate/{id}/Actions/State + +# 通知公告 +GET /api/message/Notice +POST /api/message/Notice +GET /api/message/Notice/{id} +PUT /api/message/Notice/{id} +DELETE /api/message/Notice/{id} +PUT /api/message/Notice/{id}/Actions/Release +GET /api/message/Notice/List +POST /api/visualdev/Dashboard/Notice + +# 发送配置 +GET /api/message/SendMessageConfig +POST /api/message/SendMessageConfig +GET /api/message/SendMessageConfig/{id} +PUT /api/message/SendMessageConfig/{id} +DELETE /api/message/SendMessageConfig/{id} +POST /api/message/SendMessageConfig/{id}/Actions/Copy +POST /api/message/SendMessageConfig/testSendConfig +POST /api/message/SendMessageConfig/getTestConfig/{id} +``` + +### 4.10 监控 (17 端点) +``` +GET /api/system/Monitor # 平台监控 +GET /api/workflow/monitor # 流程监控 +GET /api/workflow/monitor/FlowTodo +POST /api/workflow/monitor/FlowTodoCount +POST /api/workflow/monitor/Pause/{id} +POST /api/workflow/monitor/Activate/{id} +POST /api/workflow/monitor/Cancel/{id} +POST /api/workflow/monitor/Assign/{id} +POST /api/workflow/monitor/Reboot/{id} +GET /api/workflow/monitor/AnySubFlow/{id} +GET /api/message/MessageMonitor # 消息监控 +POST /api/message/MessageMonitor +GET /api/message/MessageMonitor/{id} +GET /api/message/MessageMonitor/detail/{id} +DELETE /api/message/MessageMonitor/empty +DELETE /api/message/MessageMonitor/batchRemove +``` + +### 4.11 行政区划 (9 端点) +``` +POST /api/system/Area +GET /api/system/Area/{nodeId} +PUT /api/system/Area/{id} +DELETE /api/system/Area/{id} +PUT /api/system/Area/{id}/Actions/State +POST /api/system/Area/GetAreaByIds +GET /api/system/Area/{id}/Selector/{ids} +GET /api/system/Area/{id}/Info +``` + +### 4.12 应用管理 (29 端点, 仅列核心) +``` +GET /api/app/Data # app 常用数据 +POST /api/app/Data +POST /api/visualdev/Generater/App/Preview # 代码生成预览 +GET /api/visualdev/Generater/App/{id}/Preview +POST /api/system/System/saveAppAuthorization +POST /api/system/System/changeAppAuthorization +GET /api/system/System/getAppAuthorization/{systemId} +POST /api/system/System/Actions/Import # 导入 app +``` + +--- + +## 5. dacli 8 父命令现状 (v0.7.1 末, 27 子命令) + +``` +dacli form (10 子): list/info/create/release/delete/export/import/clone/validate/fix-columndata +dacli dm (4 子) : list/create/drop/fields +dacli dict (2 子) : type-list/data-list +dacli menu (4 子) : list/create/delete/unrelease +dacli di (1 子) : list +dacli workflow (3 子) : list/launch/approve +dacli doc (1 子) : list +dacli apis (1 子) : list ++ login/status/switch-app (顶层 3) +``` + +--- + +## 6. 已知边界 (v0.8 启动必看) + +### 6.1 已完工 +- ✅ 8 父命令 / 27 子命令 +- ✅ 114 张 baseline (developSystem 29 + workSystem 85) schema 完整 +- ✅ Web 端 60+ jnpfKey 控件 / 14 L1 正则 / 39 控件 schema 已提取 +- ✅ Playwright + 浏览器会话管理 + 视觉对比 +- ✅ Help 系统 (--ai-help / --example / --source) 全命令支持 +- ✅ blindspot 23 闭环 (Actions/Module NPE root cause + fix) + +### 6.2 已知遗留 (留 v0.8 末期, 优先级低) +- P0 #16 收尾 (tds_leave 跑 fix-columndata + 写剩余 spec) — 用户手动, AI 不动 +- P1 examples/baseline/all.sh 一键 72 张 — 留 W8 边整合边写 +- P2 dacli/ git 持久化 — 用户决策 + +### 6.3 风险 +- 报表/门户端点复杂度高 (PortalController 16 端点 + PortalDataController) → 拆子命令谨慎 +- 调度任务对接 xxl-job, 鉴权与原 JNPF 不同 → 走 `/api/scheduletask` 主端点, 不碰 `/xxl-job-admin/*` +- 集成中心 (email/sms/weChat) 走第三方 OAuth, 沙箱测难 → W11 末做实跑 + +--- + +## 7. 缓存路径 (下次会话恢复直接用) + +- 本文档: `$ccWorkDir/dacli/doc/v0.8-scan.md` +- web 模块入口: `/tmp/jnpf-web-views.txt` (94 个 index.vue) +- 后端 Controllers: `find /home/ubuntu/ccWorkDir/jnpf/后端 -name "*Controller.java"` (100+ 类) +- API 端点缓存: `~/.dacli/cache.db` SQLite (12h TTL, PID 变化失效) +- 开发 token: `/home/ubuntu/ccWorkDir/dacli/.dacli-token/token.json` (admin@tds, 7 天 TTL) +- Playwright storage: `/home/ubuntu/ccWorkDir/dacli/.auth/admin.json` (6h TTL) + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**下一阶段**: 写 `doc/v0.8-plan.md` (从本文档 §1 + prompt.md §3.5 抄), 然后开始 W7 (情报 → 脚手架) diff --git a/prompt.md b/prompt.md index 9f26857..76a5b5e 100644 --- a/prompt.md +++ b/prompt.md @@ -1,27 +1,61 @@ -# TS 版 dacli — 主提示词 (开发任务说明书) +# TS 版 dacli — 主提示词 (开发任务说明书, v0.8 长任务模式) -> **位置**: `$ccWorkDir/dacli/`(原 `test/dacli/`, 2026-06-12 升级到顶层独立项目) +> **位置**: `$ccWorkDir/dacli/` > **目标**: 在 `$ccWorkDir/dacli/` 内交付 **两件套**—— -> 1. **`dacli` CLI 工具** (TypeScript) — 借鉴 Java 版架构 + 复用 JNPF web 源码 +> 1. **`dacli` CLI 工具** (TypeScript) — **唯一生产工具** > 2. **`.claude/skills/dacli-ts/SKILL.md`** — AI 专用技能,告诉 AI **何时用哪个命令** > -> **目标 0 差错**: 以官方示例 (workSystem 85 + developSystem 29 = 114 张表单) 为基线,dacli 复刻必须 **API 0 错 + 浏览器层 0 视觉差** -> +> **当前状态**: v0.7.1 (2026-06-12) — **8 父命令 / 27 子命令**, 114 baseline 0 差错 (developSystem 29 + workSystem 85) +> **v0.8 目标 (本轮长任务)**: 把 jnpf web 剩下的 25+ 顶级模块整合进 dacli, 目标 **22 父命令 / 80+ 子命令 / 130+ baseline 0 差错** > **应用对象**: `tds` (http://nginx/ ,你在容器内 后端api 代理到 http://nginx/api -> http://127.0.0.1:30000/api) | `admin / 123456` --- +## ⛔ 长任务模式 (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 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 次以上重试还红 +- 缺依赖 / 缺环境 / 配置文件坏 (非代码问题) + +--- + ## 0. 启动指令 (新会话第一句) ``` 按 $ccWorkDir/dacli/prompt.md 在 $ccWorkDir/dacli/ 内交付 dacli + skill 两件套。 目标 0 差错: 以 developSystem/workSystem 官方示例为 baseline。 -先读 $ccWorkDir/dacli/doc/architecture.md 了解设计, 再看 plan.md 拿当前任务。 +先读 $ccWorkDir/dacli/doc/architecture.md 了解设计, 再读 doc/RESUME.md 拿当前任务。 ``` +**v0.7.1 跳过** (本轮不重做, 留"已知遗留"段): P0 #16 收尾 (tds_leave fix-columndata) 用户手动, AI 不动 +**v0.8 启动** (本轮主任务): 见 `doc/RESUME.md` §5 (jnpf web 25+ 顶级模块整合清单 + W7-W12 详细日程) + `doc/v0.8-scan.md` (扫描快照: 94 web 入口 + 100+ Controller + 22 模块端点) + **核心约束 (3 条不妥协)**: 1. **0 差错 = API 0 错 + 浏览器 0 视觉差**(详见 §5) -2. **官方示例 baseline 必用**(developSystem 21 + workSystem 53 = 74 张) +2. **官方示例 baseline 必用**(developSystem 21 + workSystem 53 = 74 张;v0.8 起追加报表/门户/大屏样例 8+ 张 = 122+) 3. **Playwright Node.js 是基础设施**(不是可选,每个 baseline 必跑) --- @@ -30,18 +64,18 @@ ### 1.1 为什么做这件事 -`dacli` (Java 版, `docs/dacli/ssw-dacli/`, 已废弃归档) 已成熟:17 父命令 + ~110 子命令、53 FieldBuilder、261/261 mvn test。 +`dacli` (TypeScript 版) 是 JNPF 平台的命令行工具. 早期曾有 mvn/Java 版探索 (`docs/dacli/ssw-dacli/`, 现已归档), TS 版以"AI-friendly + 直接复用 web 源码 + 0 差错验证"为设计核心, 已稳定. -**但 4 个痛点**: -1. **AI 写 Java 累**(类型 ceremony、编译慢) -2. **schema 翻译漂移**(53 FieldBuilder 是从 web 翻译过来的,翻译即漂移) -3. **升级耦合**(JNPF 改一字段,53 builder 都要手改) -4. **web 零复用**(web 端 TS/TS,dacli Java 完全没复用) +**4 个设计决策 (TS 版成立的关键)**: +1. **AI 写 TS 不累** (vs Java ceremony + 慢编译) +2. **schema 0 漂移** (从 web SFC 自动提取, 不再 53 FieldBuilder 翻译) +3. **升级松耦合** (JNPF 改字段, 重跑 extractor 即同步) +4. **web 源码复用** (web 端 TS/TS, dacli TS 直接 1:1 复刻 cipher/validate/componentMap) ### 1.2 TS 版定位 -**不是**"重写 dacli 替代 Java 版"。 -**而是**"**AI-friendly 探索性实验**"——验证"**直接复用 web 源码 + 0 差错验证**"的可行性。 +**是** dacli 的**唯一生产工具** (v0.7.1 已 8 父命令 / 27 子 / 114 baseline 0 差错). +**也是**"**AI-friendly 探索性实验**"——验证"**直接复用 web 源码 + 0 差错验证**"的可行性。 ### 1.3 目标 0 差错 (硬目标) @@ -164,7 +198,12 @@ dacli/ │ │ ├── l1-rules.ts │ │ ├── l2-rules.ts │ │ ├── flow.ts -│ │ └── component-map.ts +│ │ ├── component-map.ts +│ │ # ↓ v0.8+ 新增 extractor +│ │ ├── report-schemas.ts # [P0] 报表组件 schema (W8) +│ │ ├── portal-schemas.ts # [P0] 门户布局 schema (W8) +│ │ ├── bigdata-schemas.ts # [P0] 大屏图表 schema (W8) +│ │ └── datasource-drivers.ts # [P0] 数据源 driver 列表 (W8) │ ├── data/ # 提取 JSON (git-tracked) │ │ ├── component-map.json │ │ ├── field-schemas.json @@ -286,8 +325,8 @@ dacli/ | Day | 任务 | 验收 | |-----|------|------| | D1 | `core/help.ts` + `--ai-help / --example / --source` | 全部命令支持 | -| D2 | `commands/doc.ts` (HTML 缓存) | 镜像 Java 版能力 | -| D3 | `commands/apis.ts` (OpenAPI 抓取) | 镜像 Java 版能力 | +| D2 | `commands/doc.ts` (HTML 缓存) | TS 版独立能力 | +| D3 | `commands/apis.ts` (OpenAPI 抓取) | TS 版独立能力 | | D4 | skill `SKILL.md` + `references/commands.md` | AI 读后知道何时用 | | D5 | skill `references/patterns.md` + `anti-patterns.md` | 5+ 模式 + 8+ 反模式 | @@ -307,6 +346,135 @@ dacli/ --- +## 3.5 v0.8 路线 (Week 7-12: jnpf web 剩余主要功能整合) + +> **目标**: 把 jnpf web 剩下的 25+ 顶级模块整合进 dacli, 从 8 父命令扩到 **22 父命令 / 80+ 子命令**, baseline 从 114 张扩到 **130+ 张** (新增报表/门户/大屏/打印/打印模板样例 16+ 张). +> +> **扫描快照** (web 94 入口 + 后端 100+ Controller + 22 模块端点): 见 `doc/v0.8-scan.md`. +> **详细盘点** (按 AI 业务价值排序, 25+ 子功能): 见 `doc/RESUME.md` §5.1. +> **详细路线** (W7-W12): 见 `doc/RESUME.md` §5.2-5.7. + +### Week 7: 整合基础设施 (情报收集 + 脚手架) +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | 扫 `web/views/` 全部 25+ 顶级模块, 整理 6.1 表格 | `/tmp/jnpf-web-views.txt` ≥ 25 行 | +| D2 | `dacli apis refresh` + 拉新 API 缓存, 找新模块端点 | apis list 含 report/portal/codegen 等新 tag | +| D3 | 4 个新父命令脚手架 (datasource / report / portal / codegen) | 全部 `npx tsx src/cli.ts <新命令> --help` 跑通 | +| D4 | 新 extractor 脚手架 (report-schemas / portal-schemas / bigdata-schemas / datasource-drivers) | 4 个 extractor 各跑出 JSON | +| D5 | `doc/v0.8-plan.md` (从 RESUME.md §6.1/6.2 抄), `doc/v0.8-changelog.md` 框架 | 2 文档就位 | + +**Week 7 必达**: 4 父命令占位 + 4 extractor 跑通 + 8 父命令基线 (v0.7.1 收尾) 全 PASS + +### Week 8: P0 第 1 波 (数据源 + 报表 + 门户) +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli datasource list/create/delete/test` (dataSource 4 子) | 端到端 | +| D2 | `dacli report list/info/create/release` (onlineDev/report 4 子) | workSystem 报表样例 2+ 张 0 错 | +| D3 | `dacli portal list/info/create` (visualPortal 3 子) | workSystem 门户样例 1+ 张 0 错 | +| D4 | baseline 验证: 报表 + 门户样例 5+ 张 (API 层 0 错) | 5+ 张 schema 完整 | +| D5 | Playwright 视觉对比 (报表 / 门户 0 视觉差) | UI 层 0 错 | + +**Week 8 必达**: 3 父命令 (datasource / report / portal) + 5+ 样例 API 0 错 + +### Week 9: P0 第 2 波 (代码生成 + 大屏 + 打印) +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli codegen module/list/import` (从 form 模板生成 ssw-后端模块 3 子) | Java 模块生成跑通 | +| D2 | `dacli bigscreen list/info/create` (extend/bigData 3 子) | 大屏样例 2+ 张 0 错 | +| D3 | `dacli print template list/info/create` (printDev 3 子) | 打印模板 1+ 张 0 错 | +| D4 | baseline 验证: 大屏 + 打印样例 3+ 张 (API 层 0 错) | 3+ 张 schema 完整 | +| D5 | Playwright 视觉对比 (大屏 / 打印 0 视觉差) | UI 层 0 错 | + +**Week 9 必达**: 3 父命令 (codegen / bigscreen / print) + 3+ 样例 API 0 错; **P0 全部完成, 11 父命令 / 27+13=40 子命令** + +### Week 10: P1 权限三角 (role + user + organize) +| 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 验证 | + +**Week 10 必达**: 3 父命令 (role / user / org) + 权限闭环 + +### Week 11: P1 消息中心 + 调度 + 应用管理 +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `dacli msg notice list/create/send` + `dacli msg template` (5 子) | 通知公告 + 模板 | +| D2 | `dacli schedule list/create/pause/trigger/log` (定时任务 5 子) | Quartz job CRUD | +| D3 | `dacli app list/create/delete/initapp` (应用管理 4 子, initapp 升级) | 多 app 生命周期 | +| D4 | 端到端: 通知公告真发出 + 定时任务真触发 | 2 套验证 | +| D5 | AI 自检 2: 跑通"建通知 + 触发定时任务"完整流程 | subagent 验证 | + +**Week 11 必达**: 3 父命令 (msg / schedule / app) + 闭环验证; **14 父命令 / 60+ 子命令, P0+P1 全部完成** + +### Week 12: 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 | **全量回归**: 14 父命令 vitest + 11 父命令 Playwright (新父命令 W8-W11 跑通回归) | 0 错 | + +**Week 12+ 必达**: 14 父命令 / 60+ 子命令 + **122+ baseline 0 差错** + v0.8 完整交付 + +### v0.8 末交付 (硬目标) +- ✅ **22 父命令** / 80+ 子命令 (v0.7.1 的 8 → v0.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 大新决策点 + +### v0.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 template 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 * * ?" + +--- + ## 4. 0 差错验证规范 (baseline.md) ### 4.1 验证金字塔 @@ -405,6 +573,19 @@ dacli doc list --dir=docs/tds dacli doc get --file=docs/tds/plan.html dacli apis list --tag=visualdev dacli apis info "POST /api/visualdev/Base" + +# ===== v0.8 启动预研 (新增) ===== +# 扫 web 端所有顶级模块入口 +find /home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/views \ + -maxdepth 2 -name "index.vue" | sort > /tmp/jnpf-web-views.txt +wc -l /tmp/jnpf-web-views.txt +# 拉新 API 缓存 (报表/门户/大屏端点) +dacli apis refresh +dacli apis list --tag=visualReport # 报表 (待 v0.8 W8 实测 tag) +dacli apis list --tag=visualPortal # 门户 (待 v0.8 W8 实测 tag) +# 列 developSystem/workSystem 现有报表/门户样例 (作 baseline) +dacli switch-app --appCode=workSystem +dacli form list | jq -r '.data.list[] | "\(.id) \(.category) \(.fullName)"' | head -50 ``` --- @@ -440,21 +621,13 @@ nginx 容器可能不通,dacli/login 失败。**用 developSystem/workSystem --- -## 7. 与 Java 版的关系 +## 7. 提取工具 (TS 版通用资产) -### 7.1 v1 不替代 -- Java 版 `ssw-dacli` 是**生产工具**(6 月打磨,261 tests) -- TS 版**实验性**,**不**作为生产依赖 - -### 7.2 验证收益(v1 完成后) -- **如果** baseline 74 张全 0 错 + AI 自检通过 → v2 把提取工具反向喂给 Java 版 -- **如果** 覆盖率 / 体验都好 → v3 全面替代 -- **如果** 一般 → 保留作为"快速原型工具" - -### 7.3 提取工具沉淀 -`dacli/src/extractors/` 是**通用资产**。v2 可考虑: -- 移到 `.claude/skills/dacli-web-extract/` 给 Java 版用 -- Java 版 `dacli form validate` 也消费 `data/*.json` +`dacli/src/extractors/` (component-map / field-schemas / l1-rules / l2-rules / **v0.8+ report-schemas / portal-schemas / bigdata-schemas / datasource-drivers**) 是 TS 版通用资产. 用法: +- TS 版 `FieldBuilder` 加载 `data/*.json` 自动构建表单/报表/门户/大屏字段 +- 提取脚本 `scripts/extract-all.mjs` JNPF 升级时重跑 (出新版字段) +- 提取 JSON 入 git (跟版本, 可对比 diff) +- v0.8 新增 4 个 extractor 直接跑出 `data/report-schemas.json` / `data/portal-schemas.json` / `data/bigdata-schemas.json` / `data/datasource-drivers.json` --- @@ -462,12 +635,16 @@ nginx 容器可能不通,dacli/login 失败。**用 developSystem/workSystem **新会话第一句**: ``` -按 $ccWorkDir/dacli/prompt.md 继续。当前周次/任务查 doc/plan.md。 -目标 0 差错: developSystem 21 + workSystem 53 baseline 全跑通。 +按 $ccWorkDir/dacli/prompt.md 继续。当前周次/任务查 doc/RESUME.md (v0.7.1 收尾 + v0.8 启动)。 +目标 0 差错: developSystem 21 + workSystem 53 baseline 全跑通 (v0.8 起追加报表/门户/大屏 8+ 张). ``` -**关键文件**: -- `doc/plan.md` — 当前进度 +**关键文件** (按恢复时阅读顺序): +- `doc/RESUME.md` — **第一份读** (v0.7.1 状态 + v0.8 启动盘点, §6 路线最关键) +- `doc/v0.7.1-changelog.md` — 本轮 (盲点 23 闭环) +- `doc/v0.7-changelog.md` — 上轮 (P0 #13 + P1 #15) +- `doc/plan.md` — 6 周路线 + v0.6 段 (v0.8 路线见 prompt §3.5) +- `doc/v0.8-plan.md` — **待写** (v0.8 路线展开) - `doc/architecture.md` — 设计决策 - `doc/baseline.md` — 0 差错验证规范 - `references/baseline/developSystem.md` + `workSystem.md` — 74 张清单 @@ -475,6 +652,7 @@ nginx 容器可能不通,dacli/login 失败。**用 developSystem/workSystem - `src/data/*.json` — 提取的资产 - `tests/e2e/baseline/` — 74 张的 Playwright 测试 - `test/ddcc/` — 上一轮实验 +- `/tmp/jnpf-web-views.txt` — **下次会话第一波扫出的 web 模块入口清单** (v0.8 启动用) **关键命令**: ```bash @@ -485,22 +663,36 @@ bash examples/baseline/all.sh # 74 张一键回归 npx playwright test # 跑全部 E2E npx vitest run # 跑单元测试 node scripts/extract-all.mjs # 提取 web 源码 + +# v0.7.1 收尾 (第一波) +npx tsx src/cli.ts form fix-columndata 835168490678657989 +npx tsx src/cli.ts menu create --fullName="员工请假申请" --formId=835168490678657989 + +# v0.8 启动预研 (第二波) +find /home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/views \ + -maxdepth 2 -name "index.vue" | sort > /tmp/jnpf-web-views.txt +npx tsx src/cli.ts apis refresh ``` --- ## 9. 反向链接 (Related) +- [doc/RESUME.md](doc/RESUME.md) — **会话恢复指引** (v0.7.1 收尾 + v0.8 启动盘点) - [doc/architecture.md](doc/architecture.md) — 架构设计 -- [doc/plan.md](doc/plan.md) — 6 周路线 +- [doc/plan.md](doc/plan.md) — 6 周路线 (W1-W6) +- [doc/v0.8-plan.md](doc/v0.8-plan.md) — **待写** v0.8 路线 (W7-W12) - [doc/baseline.md](doc/baseline.md) — 0 差错验证规范 - [doc/api.md](doc/api.md) — API 完整列表 - [doc/implementation.md](doc/implementation.md) — 实现细节 - [doc/extractors.md](doc/extractors.md) — 提取工具 - [doc/help-system.md](doc/help-system.md) — 帮助体系 -- [SKILL.md](.claude/skills/dacli-ts/SKILL.md) — AI 技能主入口 -- [references/baseline/developSystem.md](.claude/skills/dacli-ts/references/baseline/developSystem.md) -- [references/baseline/workSystem.md](.claude/skills/dacli-ts/references/baseline/workSystem.md) +- [doc/v0.7.1-changelog.md](doc/v0.7.1-changelog.md) — 本轮详细 (盲点 23 闭环) +- [doc/v0.7-changelog.md](doc/v0.7-changelog.md) — 上轮 (P0 #13 + P1 #15) +- [doc/v0.6-changelog.md](doc/v0.6-changelog.md) — 上上轮 (Playwright + 浏览器会话) +- [SKILL.md](.claude/skills/dacli-ts/SKILL.md) — AI 技能主入口 (v0.7.1 校准) +- [references/baseline/developSystem.md](.claude/skills/dacli-ts/references/baseline/developSystem.md) — 21 张清单 +- [references/baseline/workSystem.md](.claude/skills/dacli-ts/references/baseline/workSystem.md) — 53 张清单 - [examples/baseline/all.sh](.claude/skills/dacli-ts/examples/baseline/all.sh) — 一键回归 - [../ddcc/](../ddcc/) — 上一轮实验 @@ -508,5 +700,7 @@ node scripts/extract-all.mjs # 提取 web 源码 **生成时间**: 2026-06-12 **作者**: Claude (M3) + 用户 -**状态**: v1 计划冻结,进入执行 -**核心目标**: **74 张官方示例 API 0 错 + 浏览器 0 视觉差** +**状态**: v0.7.1 完工, v0.8 启动准备就绪 +**v0.7.1 目标**: 8 父命令 / 27 子命令, 72 baseline 0 差错 ✅ +**v0.8+ 目标**: 14 父命令 / 60+ 子命令, 122+ baseline 0 差错 (本轮) +**核心目标**: **jnpf web 主要功能 90% 整合进 dacli + API 0 错 + 浏览器 0 视觉差**