W7-D1+D2: 写 v0.8-plan.md (22 父命令路线) + v0.8-endpoints.md (320+ 端点)

This commit is contained in:
ssw committed 2026-06-12 21:01:27 +08:00
1 parent 2039d81b10
commit 456059b505
5 files changed
+1654 -140

No files matched your search

+285 -98
View File
@@ -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 <id>`**)
- `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
**核心约束**: 长任务模式, 非必要不中断, 自己驱动完成
+402
View File
@@ -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 <id>` / `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 <id>` / `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 <id>` / `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 <id>` / `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`
+291
View File
@@ -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
**核心约束**: 长任务模式, 非必要不中断, 自己驱动完成
+440
View File
@@ -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 (情报 → 脚手架)
+236 -42
View File
@@ -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 视觉差**