Files
dacli/docs/cmd-review/org.md
T
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 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]>
2026-06-25 14:58:32 +08:00

76 lines
2.9 KiB
Markdown

# dacli `org` 命令审计报告 (2026-06-25)
## 1. 命令清单
| 子命令 | 格式 | 用途 |
|--------|------|------|
| `dacli org list` | `[--keyword] [--json]` | 列出组织 (公司/部门) |
| `dacli org tree` | `[--json]` | 组织树形结构 |
| `dacli org create` | `--fullName --enCode --parentId --type [--json]` | 创建组织节点 |
## 2. web 端对应
- 组织页: `web/apps/jnpf-web-apps-main/src/views/permission/organize/` 或 `org/`
- 组织 API:
- `web/.../api/permission/organize.ts` (14 函数) — 公司/部门 CRUD
- `web/.../api/permission/position.ts` (13 函数) — 岗位
- `web/.../api/permission/userRelation.ts` — 组织-用户关系
- JNPF 后端: `POST /api/permission/Organize` (公司/部门) `/api/permission/Position` (岗位)
## 3. 改/删/留 建议
### [KEEP] 保留
- **list** — 列出组织
- **tree** — 树形结构
- **create** — 创建组织节点
### [REFACTOR-WEBAPI] **P0 必做**
新建 `webapi/organize.ts` (14 函数) + `webapi/position.ts` (13 函数)
- 消除当前硬编码端点, 与 v0.11+ 架构对齐
### [DEPRECATE] 无
### [NEW-CMD] **P0 必补** — CRUD 闭环
- **`dacli org update <id>`** — 改组织 (改名/移动/改类型)
- **`dacli org delete <id>`** — 删组织
- **`dacli org info <id>`** — 组织详情 (区别于 list)
### [NEW-CMD] **P0 必补** — 岗位模块 (完全缺失)
- **`dacli org position list`** — 岗位列表
- **`dacli org position create`** — 创建岗位
- **`dacli org position update <id>`** — 改岗位
- **`dacli org position delete <id>`** — 删岗位
- **`dacli org position info <id>`** — 岗位详情
### [NEW-CMD] **P0 必补** — selector
- **`dacli org selector`** — 组织选择器 (AI 引用 orgId 必需)
- **`dacli org position selector`** — 岗位选择器
### [NEW-CMD] P1
- **`dacli org user <orgId>`** — 组织下用户管理
- **`dacli org userRelation`** — 用户组织关系绑定
## 4. AI 痛点评估
### 5 类 AI 痛点
1. **闭环不完整** — 缺 update/delete/info
2. **岗位空白** — 完全缺 position 模块, user 无法赋岗
3. **无 selector** — 缺 orgId/positionId 选择器, AI 引用只能 list 拉全表解析
4. **与 user/role 关系断裂** — user create 需 orgId/positionId, 但需先 list 找
5. **多租户架构无法维护** — 多公司/多部门场景, 缺少体系化命令
### 业务场景
- AI 创建多租户/多部门应用, org 闭环不完整
- form 业务字段引用 orgId 时, AI 经常需要 list 找
- user create 必填 orgId + positionId, 当前 2 个空白
---
**核心结论**: dacli org 命令严重不完整 (3 命令), 但 web 端有 14+ 组织操作 + 13+ 岗位操作 + 用户关系管理.
**3 个最关键建议**:
1. **P0 [NEW-CMD]**: 新增 org update/delete/info + org position (5 子命令) + org selector
2. **P0 [REFACTOR-WEBAPI]**: 新建 webapi/organize.ts (14 函数) + webapi/position.ts (13 函数)
3. **P1 [NEW-CMD]**: 新增 org user + userRelation 管理