派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.
关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
* integration emailTest/smsTest
* msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)
下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)
Co-Authored-By: Claude <[email protected]>
78 lines
3.4 KiB
Markdown
78 lines
3.4 KiB
Markdown
# dacli `menu` 命令审计报告 (2026-06-25)
|
|
|
|
## 1. 命令清单 (8 个公开子命令)
|
|
|
|
| # | 命令 | 用途 | 状态 |
|
|
|---|------|------|------|
|
|
| 1 | `dacli menu list` | 列出菜单 (树形) | ✅ KEEP + webapi |
|
|
| 2 | `dacli menu info <id>` | 菜单详情 | ✅ KEEP |
|
|
| 3 | `dacli menu create` | 创建菜单 (支持 --formId 自动挂载) | ✅ KEEP |
|
|
| 4 | `dacli menu delete <id>` | 删菜单 (--cascade) | ✅ KEEP |
|
|
| 5 | `dacli menu releases` | 查已发布版本菜单 | ✅ KEEP |
|
|
| 6 | `dacli menu unrelease <id>` | 撤销发布 | ✅ KEEP |
|
|
| 7 | `dacli menu purge <id>` | 彻底清除 (含回收站) | ✅ KEEP |
|
|
| 8 | `dacli menu _helpers` | 内部辅助 (URL 修正等) | 内部 |
|
|
|
|
## 2. web 端对应
|
|
|
|
- 菜单页: `web/apps/jnpf-web-apps-main/src/views/permission/menu/` (或 `system/`)
|
|
- 菜单 API: `web/apps/jnpf-web-apps-main/src/api/permission/menu.ts` (15 函数)
|
|
- **webapi/menu.ts 已存在** (v0.11 Phase 1 已镜像, 15 函数)
|
|
|
|
## 3. 改/删/留 建议
|
|
|
|
### [KEEP] 全部 8 命令保留
|
|
覆盖全生命周期, 设计合理
|
|
|
|
### [REFACTOR-WEBAPI] **P0 重点** (webapi 使用率仅 1/15 = 6.7%)
|
|
6 个子命令应切到 `loadMenu.*`:
|
|
- **create.ts 低级模式**: `c.postJson('/system/Menu')` → `loadMenu.create(body)`
|
|
- **create.ts SelectorFilter**: `c.get('/system/Menu/SelectorFilter/0')` → `loadMenu.getMenuSelectorFilter()`
|
|
- **delete.ts**: `c.del('/system/Menu/{id}')` → `loadMenu.delMenu(id)`
|
|
- **info.ts**: `c.get('/system/Menu/{id}')` → `loadMenu.getInfo(id)`
|
|
- **purge.ts**: `c.del('/system/Menu/{id}')` → `loadMenu.delMenu(id)`
|
|
- 注: Actions/Module + getReleaseMenu 在 web visualDev.ts 不在 menu.ts, 保留原 API 合理
|
|
|
|
### [DEPRECATE] 无
|
|
|
|
### [NEW-CMD] **P1 必补**
|
|
- **`dacli menu update <id>`** — 改菜单 (改名/移动/属性改), webapi 已有 `update`
|
|
- **`dacli menu selector [--category] [--type]`** — 一步输出可挂载父菜单树, AI 友好 (webapi 有 getMenuSelector + getSelectorAll)
|
|
|
|
### [NEW-CMD] P2
|
|
- **`dacli menu export <id>` + `dacli menu import`** — 跨 app 迁移 (webapi 有 exportMenu)
|
|
- **`dacli menu move <id> --newParentId`** — 移动菜单 (可合并到 update)
|
|
- **`dacli menu permission <id>`** — 调试"菜单 403"
|
|
|
|
### [NEW-CMD] P3
|
|
- **`dacli menu fixDisplay --id`** — BS-43 一键补 7 必填字段
|
|
- **`dacli menu clone <id>`** — 克隆菜单变体
|
|
|
|
## 4. AI 痛点评估
|
|
|
|
### 菜单创建流程: 友好 ✅
|
|
- `--formId` 自动走 web Actions/Module, 后端自动构造 propertyJson + 授权
|
|
- D-12/BS-50 多层防护, create.ts 自动兜底 webType=4 + propertyJson.moduleId + urlAddress 反查
|
|
|
|
### D-12 防御: 较完善 ✅
|
|
- 三层防护 (create.ts D-9/D-12 反查 + guard BS-50 + D-4 fallback)
|
|
- 但 urlAddress 非 model/ 前缀时仍可能留空 moduleId, 建议加 ERROR 提示
|
|
|
|
### 菜单+form 联动: 基本闭环 ✅
|
|
- create/releases/purge 配合 form release 完整流程
|
|
- 缺 form 端选择器
|
|
|
|
### 父菜单查找: 仍繁琐 ⚠️
|
|
- create.ts v0.7.1 已自动 SelectorFilter 找 type=1 父
|
|
- AI 需特定父时仍需 list 找
|
|
- **应加 `menu selector` 命令**
|
|
|
|
---
|
|
|
|
**核心结论**: webapi/menu.ts 使用率仅 1/15 (6.7%), 6 个子命令切 webapi 收益大. CRUD 闭环缺 update, AI 改名/移动需 delete+create 浪费.
|
|
|
|
**Top 3 关键建议**:
|
|
1. **REFACTOR-WEBAPI** (P0): 6 命令切到 `loadMenu.*`, 消除 ~120 行硬编码
|
|
2. **NEW menu update** (P1): 补全 CRUD 闭环, 避免 delete+create 浪费
|
|
3. **NEW menu selector** (P1): 一步输出父菜单树, AI 体验大幅提升
|