13 KiB
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 模板可学
- datasource — 数据源 (业务库配置)
- report — 报表设计器 (财务/统计)
- portal — 门户设计器 (首页/工作台)
- bigscreen — 大屏设计器 (数据可视化)
- print — 打印模板 (套打)
- app — 应用管理 (多 app 生命周期)
P1 应整合 (6 父命令, 权限 + 消息 + 调度)
业务价值高 + 必有的运维能力
- role — 角色 (权限载体)
- user — 用户 (登录主体)
- org — 组织/部门/岗位 (权限维度)
- msg — 通知公告 + 消息模板
- schedule — 定时任务 (Quartz)
doc-library— 知识库 → P2 / v0.9 (P1 满 6 削减)
P2 可整合 (5 父命令, 监控 + 日志 + 集成)
业务价值中, 运维必需
- monitor — 监控 (在线/SQL/流程)
- log — 日志 (登录/操作)
- integration — 集成 (邮件/短信/Webhook)
- import — Excel 导入 (挂在 form 子命令里) → dacli form import-excel
- 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.mdv0.8 校准: 加 P0/P1/P2 命令速查 + 4 大新决策点
生成时间: 2026-06-12 作者: Claude (M3) + 用户 本轮目标: 8 父命令 / 27 子 → 22 父命令 / 80+ 子, 114 baseline → 130+ baseline 核心约束: 长任务模式, 非必要不中断, 自己驱动完成