ila/yovision
1
0
Fork 0
Code Issues 14 Pull Requests 14 Actions Packages Projects Releases Wiki Activity

[SEN] 按网管与非技术人员视角优化 Sense 原型 #32

New Issue
Closed
opened 2026-08-12 11:10:52 +08:00 by ila · 2 comments
ila commented 2026-08-12 11:10:52 +08:00
Owner
Copy Link
Copy Source

当前状态：已完成

用户于 2026-08-14 明确验收通过。

基本信息

  • 类型：需求
  • 任务类型：单项目
  • 主项目：Sense
  • 主 agent：Codex / Sense UX
  • 所属 Epic：#7
  • 所属 MVP / 版本：#8
  • 阶段：原型确认

依赖与并行

  • 前置工单：#28、#30
  • 是否允许与前置工单并行：是；#30/#31 的实现已存在于当前原型分支，本工单在其待验收基线上继续收敛用户视角
  • 原因：#30 已实现并提供稳定外壳；本工单只调整 Sense 用户语言和业务流程，不依赖 Brain、Bell 在线，也不需要等待 #30 人工验收后才获得技术基线。

子项目影响

  • 仅影响：Sense 原型
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否
  • write_paths：prototypes/sense/**
  • 验证：Sense 执行目标岗位走查、响应式和键盘交互；Brain、Bell 无需修改

协同接口

  • 生产者：Sense MVP 需求及网管/非技术设备管理员使用场景
  • 消费者：Sense 实施工单 #21–#27
  • 共享事实：后端 ONVIF、RTSP Profile、MediaMTX、RBAC 模型保持不变，仅改变界面术语和层级
  • 兼容策略：普通模式使用任务语言；高级信息按需展开且不得丢失
  • 集成顺序：先验收用户化原型，再实施正式 Vue 页面
  • 上游只读参考：D:\github\goadmin\go-admin-ui，不得修改

原始需求

  • 来源：用户对话
  • 提出时间：2026-08-12
  • 摘要：Sense 面向网管或非技术人员，模块名称和处理逻辑必须从他们的角度设计。

要解决什么

当前一级模块接近业务语言，但页面仍直接暴露 MediaMTX、ONVIF、Profile、RBAC、Adapter 等实现术语；添加设备一次展示技术字段，故障状态缺少明确恢复动作。目标是让非技术人员无需理解流媒体实现即可接入摄像头、查看画面、配置警戒区域并恢复常见故障，同时让网管仍可查看高级诊断信息。

做什么 / 不做什么

  • 做：
    • 一级导航调整为设备概况、摄像头管理、实时画面、警戒区域。
    • 技术术语收纳到“高级信息/系统诊断”，默认折叠。
    • 添加摄像头改为：自动发现或手工添加 → 选择设备 → 输入账号 → 测试连接 → 预览画面 → 完成。
    • 对认证失败、网络不可达、码流未选择、区域需重校准展示原因、影响和恢复按钮。
    • 使用“添加摄像头、重新输入账号密码、测试连接、选择清晰度、重新校准”等直白文案。
    • 保持 go-admin-ui 外壳、Element Plus 映射和渐进披露。
  • 不做：
    • 不修改后端模型、API、安全边界或跨项目契约。
    • 不删除网管所需技术信息，只改变默认层级。
    • 不修改 Brain、Bell、prototypes/assets/** 或 D:\github\goadmin。

已确认方案

  • 默认视图服务非技术人员，高级视图服务网管，两者共享同一事实状态。
  • 页面先回答“是否正常、哪里有问题、下一步做什么”，技术详情后置。
  • 接入向导可返回、取消并显示进度；系统能自动判断时提供推荐默认值。
  • 故障信息必须包含“原因 + 影响 + 恢复动作”。

预计修改文件：

  • prototypes/sense/index.html
  • prototypes/sense/sense.css（如需要）
  • prototypes/sense/sense.js（如需要）

需求变化记录

日期 变化内容 原因 用户确认
2026-08-12 从技术验收视角调整为网管/非技术人员任务视角 降低学习成本与现场误操作 是

文档影响

  • 更新业务规则与术语：形成普通语言与技术术语映射
  • 更新常见故障处理：覆盖设备接入恢复动作
  • 其他长期文档或 Wiki

交付文档影响

  • 无交付文档影响：只调整项目专用原型
  • 需要目标岗位代表验证：无需开发人员解释完成核心任务

验收标准

  • 一级导航使用设备概况、摄像头管理、实时画面、警戒区域。
  • 默认页面不要求理解 MediaMTX、Profile、MainStream、RBAC、Adapter/Connector；高级区域仍可查看。
  • 引导流程覆盖发现/手工添加、账号、连接测试、画面预览和完成接入。
  • 认证失败、网络不可达、码流未选择、区域需重校准均提供原因、影响与恢复动作。
  • 普通用户无需判断可自动选择的技术值，系统提供推荐默认值。
  • 高级视图保留地址、协议、码流、分辨率和服务状态。
  • 保持 #30 的 go-admin-ui/Element Plus、响应式、键盘和无障碍能力。
  • 不修改其他项目及共享资产；Brain、Bell 离线可验收。
  • 目标岗位代表完成“添加摄像头 → 恢复认证失败 → 查看画面 → 配置警戒区域”走查。

验证方式

  • 目标岗位无提示任务走查
  • 检查默认技术术语与高级信息渐进披露
  • 验证向导前进、返回、取消、校验、失败和重试
  • 验证 1440px、768px、375px、手机横屏、键盘、焦点与 Escape
  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • git diff --check

风险和回退

过度简化可能隐藏诊断依据，分步向导可能降低熟练用户效率。通过保留高级信息、手工入口和推荐值覆盖进行控制。回退时恢复 #30 基线。

## 当前状态：已完成 用户于 2026-08-14 明确验收通过。 ## 基本信息 - 类型：需求 - 任务类型：单项目 - 主项目：Sense - 主 agent：Codex / Sense UX - 所属 Epic：#7 - 所属 MVP / 版本：#8 - 阶段：原型确认 ## 依赖与并行 - 前置工单：#28、#30 - 是否允许与前置工单并行：是；#30/#31 的实现已存在于当前原型分支，本工单在其待验收基线上继续收敛用户视角 - 原因：#30 已实现并提供稳定外壳；本工单只调整 Sense 用户语言和业务流程，不依赖 Brain、Bell 在线，也不需要等待 #30 人工验收后才获得技术基线。 ## 子项目影响 - 仅影响：Sense 原型 - 是否跨子项目：否 - 是否修改共享接口或契约：否 - write_paths：prototypes/sense/** - 验证：Sense 执行目标岗位走查、响应式和键盘交互；Brain、Bell 无需修改 ## 协同接口 - 生产者：Sense MVP 需求及网管/非技术设备管理员使用场景 - 消费者：Sense 实施工单 #21–#27 - 共享事实：后端 ONVIF、RTSP Profile、MediaMTX、RBAC 模型保持不变，仅改变界面术语和层级 - 兼容策略：普通模式使用任务语言；高级信息按需展开且不得丢失 - 集成顺序：先验收用户化原型，再实施正式 Vue 页面 - 上游只读参考：D:\github\goadmin\go-admin-ui，不得修改 ## 原始需求 - 来源：用户对话 - 提出时间：2026-08-12 - 摘要：Sense 面向网管或非技术人员，模块名称和处理逻辑必须从他们的角度设计。 ## 要解决什么 当前一级模块接近业务语言，但页面仍直接暴露 MediaMTX、ONVIF、Profile、RBAC、Adapter 等实现术语；添加设备一次展示技术字段，故障状态缺少明确恢复动作。目标是让非技术人员无需理解流媒体实现即可接入摄像头、查看画面、配置警戒区域并恢复常见故障，同时让网管仍可查看高级诊断信息。 ## 做什么 / 不做什么 - 做： - 一级导航调整为设备概况、摄像头管理、实时画面、警戒区域。 - 技术术语收纳到“高级信息/系统诊断”，默认折叠。 - 添加摄像头改为：自动发现或手工添加 → 选择设备 → 输入账号 → 测试连接 → 预览画面 → 完成。 - 对认证失败、网络不可达、码流未选择、区域需重校准展示原因、影响和恢复按钮。 - 使用“添加摄像头、重新输入账号密码、测试连接、选择清晰度、重新校准”等直白文案。 - 保持 go-admin-ui 外壳、Element Plus 映射和渐进披露。 - 不做： - 不修改后端模型、API、安全边界或跨项目契约。 - 不删除网管所需技术信息，只改变默认层级。 - 不修改 Brain、Bell、prototypes/assets/** 或 D:\github\goadmin。 ## 已确认方案 - 默认视图服务非技术人员，高级视图服务网管，两者共享同一事实状态。 - 页面先回答“是否正常、哪里有问题、下一步做什么”，技术详情后置。 - 接入向导可返回、取消并显示进度；系统能自动判断时提供推荐默认值。 - 故障信息必须包含“原因 + 影响 + 恢复动作”。 预计修改文件： - prototypes/sense/index.html - prototypes/sense/sense.css（如需要） - prototypes/sense/sense.js（如需要） ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | 2026-08-12 | 从技术验收视角调整为网管/非技术人员任务视角 | 降低学习成本与现场误操作 | 是 | ## 文档影响 - [x] 更新业务规则与术语：形成普通语言与技术术语映射 - [x] 更新常见故障处理：覆盖设备接入恢复动作 - [ ] 其他长期文档或 Wiki ## 交付文档影响 - [x] 无交付文档影响：只调整项目专用原型 - [x] 需要目标岗位代表验证：无需开发人员解释完成核心任务 ## 验收标准 - [ ] 一级导航使用设备概况、摄像头管理、实时画面、警戒区域。 - [ ] 默认页面不要求理解 MediaMTX、Profile、MainStream、RBAC、Adapter/Connector；高级区域仍可查看。 - [ ] 引导流程覆盖发现/手工添加、账号、连接测试、画面预览和完成接入。 - [ ] 认证失败、网络不可达、码流未选择、区域需重校准均提供原因、影响与恢复动作。 - [ ] 普通用户无需判断可自动选择的技术值，系统提供推荐默认值。 - [ ] 高级视图保留地址、协议、码流、分辨率和服务状态。 - [ ] 保持 #30 的 go-admin-ui/Element Plus、响应式、键盘和无障碍能力。 - [ ] 不修改其他项目及共享资产；Brain、Bell 离线可验收。 - [ ] 目标岗位代表完成“添加摄像头 → 恢复认证失败 → 查看画面 → 配置警戒区域”走查。 ## 验证方式 - 目标岗位无提示任务走查 - 检查默认技术术语与高级信息渐进披露 - 验证向导前进、返回、取消、校验、失败和重试 - 验证 1440px、768px、375px、手机横屏、键盘、焦点与 Escape - python dev_scripts/check_harness.py --strict - python -m unittest discover -s tests -v - git diff --check ## 风险和回退 过度简化可能隐藏诊断依据，分步向导可能降低熟练用户效率。通过保留高级信息、手工入口和推荐值覆盖进行控制。回退时恢复 #30 基线。
ila added the kind/taskproject/sensescope/independentpriority/p0area/ux labels 2026-08-12 11:10:52 +08:00
ila commented 2026-08-12 11:30:19 +08:00
Author
Owner
Copy Link
Copy Source

状态：待验收

已按网管与非技术设备管理员视角完成 Sense 原型优化。

  • 实现提交：25c2534
  • PR：#29
  • 一级导航：设备概况、摄像头管理、实时画面、警戒区域
  • 接入流程：自动发现/手工添加 → 选择设备 → 输入账号 → 测试连接 → 预览 → 完成
  • 故障恢复：账号验证失败提供原因、影响、字段就地校验、重新测试和保存恢复
  • 渐进披露：MediaMTX、ONVIF、Profile、码流和连接器等内容默认收纳在高级信息中
  • 写路径仅为 prototypes/sense/**，未修改共享外壳及其他项目

验证结果：

  • 向导测试门禁、失败恢复、自动/手工入口和完成流程通过
  • 认证恢复的必填校验、连接成功及保存启用通过
  • 375/768/1440 与 812×375 无页面级横向溢出
  • 移动抽屉、Escape、键盘焦点与减少动画偏好有效
  • Harness 严格检查通过；25 项测试通过；JavaScript 语法、重复 ID、外部资源与 git diff --check 通过
  • Bell、Brain 移动布局回归通过；全新浏览器会话无控制台错误

未完成：需要网管或非技术设备管理员进行无提示人工走查。工单保持打开，不关闭。
文档说明：本工单无长期产品文档变更；sync_wiki_docs.py --check 被任务开始前已存在的 docs/00-project-profile.md Wiki revision/正文差异阻断，未擅自覆盖该镜像。

## 状态：待验收 已按网管与非技术设备管理员视角完成 Sense 原型优化。 - 实现提交：`25c2534` - PR：https://git.ilapage.cn/ila/yovision/pulls/29 - 一级导航：设备概况、摄像头管理、实时画面、警戒区域 - 接入流程：自动发现/手工添加 → 选择设备 → 输入账号 → 测试连接 → 预览 → 完成 - 故障恢复：账号验证失败提供原因、影响、字段就地校验、重新测试和保存恢复 - 渐进披露：MediaMTX、ONVIF、Profile、码流和连接器等内容默认收纳在高级信息中 - 写路径仅为 `prototypes/sense/**`，未修改共享外壳及其他项目 验证结果： - 向导测试门禁、失败恢复、自动/手工入口和完成流程通过 - 认证恢复的必填校验、连接成功及保存启用通过 - 375/768/1440 与 812×375 无页面级横向溢出 - 移动抽屉、Escape、键盘焦点与减少动画偏好有效 - Harness 严格检查通过；25 项测试通过；JavaScript 语法、重复 ID、外部资源与 `git diff --check` 通过 - Bell、Brain 移动布局回归通过；全新浏览器会话无控制台错误 未完成：需要网管或非技术设备管理员进行无提示人工走查。工单保持打开，不关闭。 文档说明：本工单无长期产品文档变更；`sync_wiki_docs.py --check` 被任务开始前已存在的 `docs/00-project-profile.md` Wiki revision/正文差异阻断，未擅自覆盖该镜像。
ila commented 2026-08-14 10:06:48 +08:00
Author
Owner
Copy Link
Copy Source

用户验收通过（2026-08-14）

用户已明确确认当前未验收工单通过验收。本工单的实现、测试与既有证据按记录接受，Wiki 归档状态已更新为“已完成”（revision 4c91b1e89414）。验收镜像已通过 PR #63 合入 dev，merge commit 27f180c。

此验收不改变 #58 的架构决定：旧自研基础框架不会恢复为 dev 基线，Sense/Bell 后续仍分别由 #61/#62 从冻结 GoAdmin 源码重建。

## 用户验收通过（2026-08-14） 用户已明确确认当前未验收工单通过验收。本工单的实现、测试与既有证据按记录接受，Wiki 归档状态已更新为“已完成”（revision `4c91b1e89414`）。验收镜像已通过 PR #63 合入 `dev`，merge commit `27f180c`。 此验收不改变 #58 的架构决定：旧自研基础框架不会恢复为 `dev` 基线，Sense/Bell 后续仍分别由 #61/#62 从冻结 GoAdmin 源码重建。
ila closed this issue 2026-08-14 10:06:48 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/ux
UI/UX 与交互原型
 kind/epic
长期产品目标
 kind/mvp
可独立验收的最小版本
 kind/task
单元实施任务
 priority/p0
首个纵切必需能力
 project/bell
Bell 项目
 project/brain
Brain 项目
 project/sense
Sense 项目
 scope/coordination
跨项目协调任务
 scope/independent
不依赖其他项目在线的项目内任务
No labels area/ux kind/task priority/p0 project/sense scope/independent
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ila/yovision#32