Files
dacli/docs/cmd-review/bigscreen.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

4.1 KiB
Raw Blame History

dacli bigscreen 命令审计报告 (2026-06-25, 重新审计 v2)

v2 修正: 用户指出大屏 web 端源码不在主 webapp, 而在独立项目 jnpf/前端/jnpf-web-datascreen-vue3. 此版基于正确路径重新审计.

1. 命令清单

子命令 格式 用途
dacli bigscreen list [--keyword] [--category] [--json] 列出所有大屏(按 category 过滤)
dacli bigscreen info <id> [--json] 查看大屏详情(含 design JSON)
dacli bigscreen create --fullName --enCode --category --json 创建大屏基础记录
dacli bigscreen release <id> [--json] 发布大屏(state=1)

2. web 端对应 (正确路径)

正确路径: /home/ubuntu/ccWorkDir/jnpf/前端/jnpf-web-datascreen-vue3/

2.1 API 模块 (在 src/api/)

  • visual.js — 大屏 CRUD (list/copy/detail/save/update/remove)
  • category.js — 分类管理
  • components.js — 组件管理
  • glob.js — 全局变量
  • record.js — 访问记录

2.2 页面架构 (在 src/page/)

  • list/ — 大屏列表+分类+CRUD 对话框
  • build.vue — 大屏设计器(复杂 drag-drop 交互)
  • view.vue — 预览

2.3 关键端点 (web 端)

  • /visual/list GET — 列表
  • /visual/detail/{id} GET — 详情
  • /visual/save POST — 创建
  • /visual/update POST — 修改 (含 status=1 发布)
  • /visual/remove DELETE — 删除
  • /visual/copy POST — 复制
  • /category/* — 分类管理

2.4 严重不一致

  • dacli 走 /extend/BigData (主平台, 错误)
  • web 端走 /visual/*, /category/*, /glob/*, /record/* (独立项目, 正确)
  • 两套 API 返回数据结构不同 (data.list vs data.data.records)

3. 改/删/留 建议

[KEEP] 保留

  • list — 保留但需加 --webapi flag + 改端点
  • info — 保留但需重构 (走 /visual/detail/{id} 而非复用 list)
  • create — 保留但需补 width/height/category 参数
  • release — 保留但应改用 /visual/update status=1

[REFACTOR-WEBAPI] P0 重点

新建 src/webapi/visualdata.ts 镜像 web 端 API:

  • getVisualList (列表, /visual/list)
  • getVisualDetail (详情, /visual/detail/{id})
  • createVisual (创建, /visual/save)
  • updateVisual (修改+发布, /visual/update)
  • removeVisual (删除, /visual/remove)
  • copyVisual (复制, /visual/copy)

[DEPRECATE] 无

[NEW-CMD] P0 必补

  • dacli bigscreen update — 走 /visual/update POST
  • dacli bigscreen delete — 走 /visual/remove
  • dacli bigscreen category — 子命令组: list/add/update/delete
  • dacli bigscreen export/import — 跨 app 迁移
  • dacli bigscreen copy — 复制大屏

[NEW-CMD] P2

  • dacli bigscreen preview-token — 生成分享 token

4. AI 痛点评估

分类管理缺失

  • dacli 用硬编码 category=1
  • web 用 categoryValue 字符串键 (从 category.js 拉)
  • AI 不知道有效分类, 需补 bigscreen category list

设计器 drag-drop 无 webapi 化

  • 大屏设计器是复杂可视化交互 (build.vue)
  • 无法通过 API 完全复制设计器
  • AI 只能建空壳大屏, 设计需 web UI 兜底

数据源绑定闭环不全

  • 大屏依赖 DI 拉数据
  • dacli 创建的大屏无数据绑定 (web 端 setup/database.vue 管绑定)
  • 应增加 --dataInterfaceId 参数 + bigscreen binding 子命令

API 路径不一致

  • 这是 最严重盲点: dacli/web 走不同 API 路径, 数据结构不同
  • 修复: 切 webapi/visualdata.ts 走 web 端真实端点

核心结论 (v2): bigscreen 命令存在 API 路径严重不一致 (dacli 走主平台端点, web 走独立子项目端点). 当前 4 子命令可用但功能残缺, 缺 update/delete/copy + category 子命令组.

3 个最关键建议:

  1. [P0] 新建 webapi/visualdata.ts: 统一走 web 端 /visual/* 路径, 消除 API 不一致
  2. [P0] 实现 update/delete/copy 命令: 走 webapi, 补全 CRUD 闭环
  3. [P0] 解决数据源绑定闭环: 增加 --dataInterfaceId + bigscreen binding 子命令 (否则大屏无数据)