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

2.9 KiB

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 管理