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

[UX] 生成三项目当前 MVP 交互原型 #28

New Issue
Closed
opened 2026-08-12 10:09:25 +08:00 by ila · 4 comments
ila commented 2026-08-12 10:09:25 +08:00
Owner
Copy Link
Copy Source

当前状态：已完成

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

基本信息

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

依赖与并行

  • 前置工单：无
  • 是否允许与前置工单并行：是
  • 原因：原型基于当前需求与已确认边界生成，不修改产品实现目录；可与 #3、#5 评审及三端独立工单并行。

子项目影响

  • 仅影响的子项目 / 交付单元：Sense、Brain、Bell 的需求展示；不修改三个项目实现目录
  • 是否跨子项目：是
  • 是否修改共享接口或契约：否；唯一事实来源：当前 Product-Requirements、Product-Roadmap 和各项目 AGENTS
  • write_paths：prototypes/**
  • 各子项目需要执行的验证：浏览器打开原型；桌面/移动布局；键盘导航；交互状态检查

协同接口

  • 生产者：当前产品需求与 MVP 独立工单
  • 消费者：Sense、Brain、Bell 后续页面和验收工单
  • 契约/共享事实源：不适用；原型不是 API 或实现事实来源
  • 兼容策略：不适用
  • 被阻塞或需要适配的工单：后续各端页面实施工单可引用原型，不作为强制代码依赖
  • 集成顺序：先确认原型，再由各项目独立实现；跨项目数据仍等待正式契约工单

原始需求

  • 来源：用户对话
  • 提出时间：2026-08-12
  • 关键原话或脱敏摘要：生成当前项目的原型文件。

要解决什么

当前仓库只有旧原型迁移说明，没有属于新产品边界的可打开原型。需要依据当前 MVP #8 和独立产品边界生成可交互 HTML，用于确认信息架构、页面状态和后续 UI 验收。

做什么 / 不做什么

  • 做：生成原型入口、Sense 管理端、Bell 管理端，以及 Brain 无界面交付单元的内部流程/运行状态展示；提供共享设计系统、响应式布局、键盘操作和关键交互。
  • 不做：不复制旧仓库整树，不生成产品业务代码，不实现 API/数据库，不把 Brain 设计成销售管理后台，不引入在线 CDN 或外部运行依赖。

已确认方案

  • 旧仓库 docs/design/* 仅作只读信息架构参考，页面范围以当前需求为准。
  • Sense 展示设备接入、实时监看、区域配置和运行状态。
  • Bell 展示合成事件、规则/Alert、详情时间线及 ack/close。
  • Brain 展示合成输入到匿名事件的内部流水线和诊断状态，并明确“无客户管理 UI”。
  • 采用共享 CSS/JS 和 SVG 图标，保持三套原型一致；不使用 emoji 作为结构图标。
  • 支持 375px 移动布局、桌面布局、可见焦点、减少动画偏好和不只依赖颜色的状态表达。

预计修改文件：prototypes/**。

需求变化记录

无。

文档影响

  • 不影响长期文档，原因：原型是与当前 MVP 版本绑定的设计资产；稳定产品需求仍以 Wiki 为主源。

交付文档影响

  • 新增交付文档，受众与页面：产品负责人/开发/测试使用 prototypes/README.md 与 HTML 原型
  • 需要目标岗位或客户代表验证：是；使用浏览器逐页确认流程、状态和术语

验收标准

  • prototypes/index.html 可导航到 Sense、Brain、Bell 原型。
  • Sense 覆盖独立纵切：设备接入、ONVIF/RTSP、MediaMTX、实时画面和区域配置。
  • Brain 覆盖合成输入、解码、匿名检测/跟踪、区域/越线和项目内事件，且明确无客户管理 UI。
  • Bell 覆盖合成事件、不可变 Event、规则/Alert、ack/close 和审计时间线。
  • 关键按钮、筛选、导航、抽屉/弹窗或状态切换可交互。
  • 桌面与 375px 宽度可用，键盘焦点清晰，减少动画偏好生效。
  • 不依赖外部 CDN，不修改旧仓库或产品实现目录。

验证方式

  • 静态链接与资源引用检查
  • HTML/CSS/JavaScript 基础语法检查
  • 本地 HTTP 服务打开并逐页交互
  • 375px、768px、1440px 布局检查
  • 键盘焦点与 prefers-reduced-motion 检查
  • git diff --check

风险和回退

原型可能被误认为正式实现，因此每页必须标注“交互原型 / 非生产数据”。回退时删除本工单新增的 prototypes/ 目录即可，不影响产品代码。

## 当前状态：已完成 用户于 2026-08-14 明确验收通过。 ## 基本信息 - 类型：需求 - 任务类型：协同 - 主项目：根级 - 主 agent：Codex / UX coordination agent - 所属 Epic：#7 - 所属 MVP / 版本：#8 - 阶段：原型确认 ## 依赖与并行 - 前置工单：无 - 是否允许与前置工单并行：是 - 原因：原型基于当前需求与已确认边界生成，不修改产品实现目录；可与 #3、#5 评审及三端独立工单并行。 ## 子项目影响 - 仅影响的子项目 / 交付单元：Sense、Brain、Bell 的需求展示；不修改三个项目实现目录 - 是否跨子项目：是 - 是否修改共享接口或契约：否；唯一事实来源：当前 Product-Requirements、Product-Roadmap 和各项目 AGENTS - write_paths：`prototypes/**` - 各子项目需要执行的验证：浏览器打开原型；桌面/移动布局；键盘导航；交互状态检查 ## 协同接口 - 生产者：当前产品需求与 MVP 独立工单 - 消费者：Sense、Brain、Bell 后续页面和验收工单 - 契约/共享事实源：不适用；原型不是 API 或实现事实来源 - 兼容策略：不适用 - 被阻塞或需要适配的工单：后续各端页面实施工单可引用原型，不作为强制代码依赖 - 集成顺序：先确认原型，再由各项目独立实现；跨项目数据仍等待正式契约工单 ## 原始需求 - 来源：用户对话 - 提出时间：2026-08-12 - 关键原话或脱敏摘要：生成当前项目的原型文件。 ## 要解决什么 当前仓库只有旧原型迁移说明，没有属于新产品边界的可打开原型。需要依据当前 MVP #8 和独立产品边界生成可交互 HTML，用于确认信息架构、页面状态和后续 UI 验收。 ## 做什么 / 不做什么 - 做：生成原型入口、Sense 管理端、Bell 管理端，以及 Brain 无界面交付单元的内部流程/运行状态展示；提供共享设计系统、响应式布局、键盘操作和关键交互。 - 不做：不复制旧仓库整树，不生成产品业务代码，不实现 API/数据库，不把 Brain 设计成销售管理后台，不引入在线 CDN 或外部运行依赖。 ## 已确认方案 - 旧仓库 `docs/design/*` 仅作只读信息架构参考，页面范围以当前需求为准。 - Sense 展示设备接入、实时监看、区域配置和运行状态。 - Bell 展示合成事件、规则/Alert、详情时间线及 ack/close。 - Brain 展示合成输入到匿名事件的内部流水线和诊断状态，并明确“无客户管理 UI”。 - 采用共享 CSS/JS 和 SVG 图标，保持三套原型一致；不使用 emoji 作为结构图标。 - 支持 375px 移动布局、桌面布局、可见焦点、减少动画偏好和不只依赖颜色的状态表达。 预计修改文件：`prototypes/**`。 ## 需求变化记录 无。 ## 文档影响 - [x] 不影响长期文档，原因：原型是与当前 MVP 版本绑定的设计资产；稳定产品需求仍以 Wiki 为主源。 ## 交付文档影响 - [x] 新增交付文档，受众与页面：产品负责人/开发/测试使用 `prototypes/README.md` 与 HTML 原型 - [x] 需要目标岗位或客户代表验证：是；使用浏览器逐页确认流程、状态和术语 ## 验收标准 - [ ] `prototypes/index.html` 可导航到 Sense、Brain、Bell 原型。 - [ ] Sense 覆盖独立纵切：设备接入、ONVIF/RTSP、MediaMTX、实时画面和区域配置。 - [ ] Brain 覆盖合成输入、解码、匿名检测/跟踪、区域/越线和项目内事件，且明确无客户管理 UI。 - [ ] Bell 覆盖合成事件、不可变 Event、规则/Alert、ack/close 和审计时间线。 - [ ] 关键按钮、筛选、导航、抽屉/弹窗或状态切换可交互。 - [ ] 桌面与 375px 宽度可用，键盘焦点清晰，减少动画偏好生效。 - [ ] 不依赖外部 CDN，不修改旧仓库或产品实现目录。 ## 验证方式 - 静态链接与资源引用检查 - HTML/CSS/JavaScript 基础语法检查 - 本地 HTTP 服务打开并逐页交互 - 375px、768px、1440px 布局检查 - 键盘焦点与 `prefers-reduced-motion` 检查 - `git diff --check` ## 风险和回退 原型可能被误认为正式实现，因此每页必须标注“交互原型 / 非生产数据”。回退时删除本工单新增的 `prototypes/` 目录即可，不影响产品代码。
ila added the area/uxkind/taskpriority/p0scope/coordination labels 2026-08-12 10:09:26 +08:00
ila commented 2026-08-12 10:23:19 +08:00
Author
Owner
Copy Link
Copy Source

状态：待验收

当前 MVP 交互原型已生成并推送。

  • 实现提交：533225d
  • Pull Request：#29
  • 原型入口：prototypes/index.html
  • 文件：8 个，共 4 个 HTML 页面及共享设计资产
  • 严格 Harness：通过
  • 仓库测试：25 项通过
  • Edge 桌面/375px 移动布局与关键交互：通过
  • 静态资源、JavaScript、键盘交互和减少动画检查：通过

未验证部分：尚未完成人工产品/客户原型评审；未验证真实视频、API、数据库、模型效果或跨项目契约。等待用户验收，验收前不合并 PR、不关闭工单。

## 状态：待验收 当前 MVP 交互原型已生成并推送。 - 实现提交：`533225d` - Pull Request：https://git.ilapage.cn/ila/yovision/pulls/29 - 原型入口：`prototypes/index.html` - 文件：8 个，共 4 个 HTML 页面及共享设计资产 - 严格 Harness：通过 - 仓库测试：25 项通过 - Edge 桌面/375px 移动布局与关键交互：通过 - 静态资源、JavaScript、键盘交互和减少动画检查：通过 **未验证部分**：尚未完成人工产品/客户原型评审；未验证真实视频、API、数据库、模型效果或跨项目契约。等待用户验收，验收前不合并 PR、不关闭工单。
ila commented 2026-08-12 10:42:00 +08:00
Author
Owner
Copy Link
Copy Source

#30 对齐更新

Sense 原型已在验收前完成 go-admin-ui / Element Plus 直接对齐，提交 1da77fe 已追加到 PR #29。

本次保留原有业务信息架构，仅调整 Sense 的应用外壳、通用组件、搜索/权限操作和响应式行为；Brain/Bell 未修改。详细验证记录见 #30。#28 继续保持待人工验收。

## #30 对齐更新 Sense 原型已在验收前完成 go-admin-ui / Element Plus 直接对齐，提交 1da77fe 已追加到 PR #29。 本次保留原有业务信息架构，仅调整 Sense 的应用外壳、通用组件、搜索/权限操作和响应式行为；Brain/Bell 未修改。详细验证记录见 #30。#28 继续保持待人工验收。
ila commented 2026-08-12 10:56:40 +08:00
Author
Owner
Copy Link
Copy Source

#31 Bell 对齐更新

Bell 原型已在验收前完成 go-admin-ui / Element Plus 直接对齐，提交 0bdd88b 已追加到 PR #29。

本次保留实时值班台、事件中心和规则策略业务信息架构；通用外壳与组件直接映射 go-admin-ui，Alert 工作台和审计时间线保留为 Bell 专用组件。Sense/Bell 现共同复用原型外壳适配器，Sense/Brain 回归通过。详细验证见 #31。#28 继续保持待人工验收。

## #31 Bell 对齐更新 Bell 原型已在验收前完成 go-admin-ui / Element Plus 直接对齐，提交 0bdd88b 已追加到 PR #29。 本次保留实时值班台、事件中心和规则策略业务信息架构；通用外壳与组件直接映射 go-admin-ui，Alert 工作台和审计时间线保留为 Bell 专用组件。Sense/Bell 现共同复用原型外壳适配器，Sense/Brain 回归通过。详细验证见 #31。#28 继续保持待人工验收。
ila commented 2026-08-14 10:06:47 +08:00
Author
Owner
Copy Link
Copy Source

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

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

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

## 用户验收通过（2026-08-14） 用户已明确确认当前未验收工单通过验收。本工单的实现、测试与既有证据按记录接受，Wiki 归档状态已更新为“已完成”（revision `47ef943ea870`）。验收镜像已通过 PR #63 合入 `dev`，merge commit `27f180c`。 此验收不改变 #58 的架构决定：旧自研基础框架不会恢复为 `dev` 基线，Sense/Bell 后续仍分别由 #61/#62 从冻结 GoAdmin 源码重建。
ila closed this issue 2026-08-14 10:06:47 +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 scope/coordination
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#28