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

[BEL] 对齐 Bell 原型至 go-admin-ui 与 Element Plus #31

New Issue
Closed
opened 2026-08-12 10:46:26 +08:00 by ila · 3 comments
ila commented 2026-08-12 10:46:26 +08:00
Owner
Copy Link
Copy Source

当前状态：已完成

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

基本信息

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

依赖与并行

  • 前置工单：#28；实现基线同时参考 #9、#12、#17–#20
  • 是否允许与前置工单并行：是，在 #28 验收前作为专项完善项追加到现有原型 PR
  • 原因：Bell 原型业务流程已具备，但应用外壳和通用组件尚未直接对齐冻结 go-admin-ui；本工单只调整 Bell 原型，不依赖 Sense/Brain 在线。

子项目影响

  • 影响的子项目 / 交付单元：Bell 原型，以及 Sense/Bell 共用的 go-admin-ui 原型适配器；Sense 仅切换等价共享资源，不改变页面和业务行为
  • 是否跨子项目：是，仅限原型展示层复用；不涉及产品代码、接口或契约
  • 是否修改共享接口或契约：否
  • write_paths：prototypes/bell/**、prototypes/assets/go-admin-ui.css、prototypes/assets/go-admin-shell.js、prototypes/assets/app.js、prototypes/sense/index.html、prototypes/sense/go-admin-ui.css、prototypes/sense/sense.js、prototypes/README.md
  • 各子项目需要执行的验证：Bell 执行桌面/移动布局、键盘导航和关键交互检查；Sense、Brain 做静态与入口回归

协同接口

  • 生产者：冻结的本地 go-admin-ui 基线与 Bell MVP 需求
  • 消费者：Bell 后续 Vue 3 + Element Plus 页面实施工单 #9、#12、#17–#20
  • 契约/共享事实源：不适用；原型不是 API、数据库或跨项目契约
  • 兼容策略：保留实时值班台、事件中心和规则策略信息架构；通用组件映射至 go-admin-ui / Element Plus
  • 被阻塞或需要适配的工单：#28 验收前完成；Bell 实施工单可将本原型作为页面落地参考
  • 集成顺序：先完成原型对齐并验收，再由 Bell 独立工单复用冻结组件实现
  • 上游只读参考：D:\github\goadmin\go-admin-ui，不得修改

原始需求

  • 来源：用户对话
  • 提出时间：2026-08-12
  • 关键原话或脱敏摘要：Bell 也以 go-admin-ui 为基础，需要按 Sense 相同原则更新原型。

要解决什么

当前 Bell 原型使用自定义 HTML/CSS 管理后台组件，尚未直接映射 go-admin-ui 的应用外壳、页面容器及 Element Plus 通用组件。目标是在保留 Event → Rule → Alert → ack → close 业务流程的前提下，降低后续 Bell 正式页面实现的二次设计与组件返工。

做什么 / 不做什么

  • 做：
    • 对齐 go-admin-ui 的 Sidebar、Navbar、TagsView、AppMain 和页面容器。
    • 将按钮、搜索表单、表格、分页、Dialog、Tag、Tabs 和权限按钮映射到 Element Plus / go-admin-ui 模式。
    • 保留实时值班台、事件中心、规则策略及合成事件入口。
    • 将 Alert 处置面板和审计时间线明确为 Bell 专用业务组件。
    • 在 README 中记录参考 commit、组件映射和专用组件边界。
  • 不做：
    • 不复制 go-admin-ui 源码或打包依赖，不修改 D:\github\goadmin。
    • 不创建正式 Vue 页面，不实现 API、RBAC、事件入站、规则引擎或真实通知。
    • 不修改 Sense/Brain 原型、跨项目事件契约或生产鉴权。

已确认方案

  • 原型继续使用可离线打开的 HTML/CSS/JavaScript，但结构、尺寸和交互语义直接对应 go-admin-ui + Element Plus。
  • 将 Sense 已验证的通用外壳适配器抽取到 prototypes/assets/，由 Sense/Bell 共同复用，避免复制通用组件实现。
  • 事件中心采用 go-admin-ui 标准 inline 搜索表单、权限操作栏、el-table 与 el-pagination。
  • 值班台通用卡片、Tag、Tabs 和按钮复用框架模式；AlertWorkbench 与 AlertAuditTimeline 作为 Bell 专用组件。
  • 注入合成事件使用 el-dialog / el-form 映射，并明确仅限开发测试。
  • 保留键盘选择 Alert、Escape 关闭 Dialog、减少动画偏好和移动端 44px 触控目标。

实际修改文件：

  • prototypes/bell/index.html
  • prototypes/bell/bell.css
  • prototypes/assets/go-admin-ui.css
  • prototypes/assets/go-admin-shell.js
  • prototypes/assets/app.js
  • prototypes/sense/index.html
  • prototypes/README.md
  • 删除已被共享适配器替代的 prototypes/sense/go-admin-ui.css 与 prototypes/sense/sense.js

需求变化记录

日期 变化内容 原因 用户确认
2026-08-12 Bell 原型升级为直接对齐冻结 go-admin-ui Bell 正式产品同样以 go-admin-ui 为基础，需降低实现返工 是

文档影响

  • 不影响长期产品文档，原因：调整版本绑定原型，不改变稳定业务需求
  • 更新项目档案或本地开发与验证
  • 更新架构与代码地图
  • 更新业务规则与术语
  • 更新常见修改或故障排查
  • 更新其他 Wiki 页面

交付文档影响

  • 无交付文档影响，原因：不适用
  • 更新已有交付文档，受众与页面：产品/开发/测试使用 prototypes/README.md
  • 新增交付文档
  • 需要目标岗位或客户代表验证：是；浏览器确认布局、组件映射与 Alert 处置流程

验收标准

  • Bell 应用外壳直接对应 go-admin-ui 的 Sidebar、Navbar、TagsView 与 AppMain/Page Container。
  • 通用控件可明确映射至 Element Plus 的 Button、Form、Input/Select、Table、Pagination、Dialog、Tag 和 Tabs。
  • 事件搜索区和权限操作区遵循 go-admin-ui 既有模式，开发测试入口和权限按钮边界明确。
  • 仅 AlertWorkbench 与 AlertAuditTimeline 等 Bell 业务交互作为新增组件，其余组件优先复用。
  • 实时值班台、事件中心、规则策略、合成事件、ack 和 close 交互保持可用。
  • 1440px、768px、375px 和手机横屏无页面级横向溢出；键盘选择、焦点、Escape 和减少动画偏好有效。
  • 无外部 CDN/生产依赖，未修改本地 go-admin-ui；Sense、Brain 原型无回归。
  • README 记录参考仓库、commit、通用组件映射和 Bell 专用组件边界。

验证方式

  • 对照 D:\github\goadmin\go-admin-ui\src\layout/、典型 src/views//index.vue 及 Pagination 组件
  • 静态资源引用、重复 ID、外部依赖和 JavaScript 语法检查
  • 浏览器验证 1440px、768px、375px 与手机横屏
  • 验证侧栏折叠、移动抽屉、TagsView、搜索/重置、分页、Dialog/Escape、Tabs、键盘选择、ack/close
  • Sense、Brain 入口和移动布局回归
  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • git diff --check

风险和回退

风险：通用 CRUD 风格可能削弱值班处置效率，原型 HTML 也可能被误认为真实 Element Plus。控制方式是通用组件对齐、Alert 处置与审计组件保持业务专用，并明确原型仅做组件映射。回退时仅回退本工单提交，恢复 #28 初版 Bell 原型。

## 当前状态：已完成 用户于 2026-08-14 明确验收通过。 ## 基本信息 - 类型：需求 - 任务类型：单项目 - 主项目：Bell - 主 agent：Codex / Bell UX - 所属 Epic：#7 - 所属 MVP / 版本：#8 - 阶段：原型确认 ## 依赖与并行 - 前置工单：#28；实现基线同时参考 #9、#12、#17–#20 - 是否允许与前置工单并行：是，在 #28 验收前作为专项完善项追加到现有原型 PR - 原因：Bell 原型业务流程已具备，但应用外壳和通用组件尚未直接对齐冻结 go-admin-ui；本工单只调整 Bell 原型，不依赖 Sense/Brain 在线。 ## 子项目影响 - 影响的子项目 / 交付单元：Bell 原型，以及 Sense/Bell 共用的 go-admin-ui 原型适配器；Sense 仅切换等价共享资源，不改变页面和业务行为 - 是否跨子项目：是，仅限原型展示层复用；不涉及产品代码、接口或契约 - 是否修改共享接口或契约：否 - write_paths：prototypes/bell/**、prototypes/assets/go-admin-ui.css、prototypes/assets/go-admin-shell.js、prototypes/assets/app.js、prototypes/sense/index.html、prototypes/sense/go-admin-ui.css、prototypes/sense/sense.js、prototypes/README.md - 各子项目需要执行的验证：Bell 执行桌面/移动布局、键盘导航和关键交互检查；Sense、Brain 做静态与入口回归 ## 协同接口 - 生产者：冻结的本地 go-admin-ui 基线与 Bell MVP 需求 - 消费者：Bell 后续 Vue 3 + Element Plus 页面实施工单 #9、#12、#17–#20 - 契约/共享事实源：不适用；原型不是 API、数据库或跨项目契约 - 兼容策略：保留实时值班台、事件中心和规则策略信息架构；通用组件映射至 go-admin-ui / Element Plus - 被阻塞或需要适配的工单：#28 验收前完成；Bell 实施工单可将本原型作为页面落地参考 - 集成顺序：先完成原型对齐并验收，再由 Bell 独立工单复用冻结组件实现 - 上游只读参考：D:\github\goadmin\go-admin-ui，不得修改 ## 原始需求 - 来源：用户对话 - 提出时间：2026-08-12 - 关键原话或脱敏摘要：Bell 也以 go-admin-ui 为基础，需要按 Sense 相同原则更新原型。 ## 要解决什么 当前 Bell 原型使用自定义 HTML/CSS 管理后台组件，尚未直接映射 go-admin-ui 的应用外壳、页面容器及 Element Plus 通用组件。目标是在保留 Event → Rule → Alert → ack → close 业务流程的前提下，降低后续 Bell 正式页面实现的二次设计与组件返工。 ## 做什么 / 不做什么 - 做： - 对齐 go-admin-ui 的 Sidebar、Navbar、TagsView、AppMain 和页面容器。 - 将按钮、搜索表单、表格、分页、Dialog、Tag、Tabs 和权限按钮映射到 Element Plus / go-admin-ui 模式。 - 保留实时值班台、事件中心、规则策略及合成事件入口。 - 将 Alert 处置面板和审计时间线明确为 Bell 专用业务组件。 - 在 README 中记录参考 commit、组件映射和专用组件边界。 - 不做： - 不复制 go-admin-ui 源码或打包依赖，不修改 D:\github\goadmin。 - 不创建正式 Vue 页面，不实现 API、RBAC、事件入站、规则引擎或真实通知。 - 不修改 Sense/Brain 原型、跨项目事件契约或生产鉴权。 ## 已确认方案 - 原型继续使用可离线打开的 HTML/CSS/JavaScript，但结构、尺寸和交互语义直接对应 go-admin-ui + Element Plus。 - 将 Sense 已验证的通用外壳适配器抽取到 prototypes/assets/，由 Sense/Bell 共同复用，避免复制通用组件实现。 - 事件中心采用 go-admin-ui 标准 inline 搜索表单、权限操作栏、el-table 与 el-pagination。 - 值班台通用卡片、Tag、Tabs 和按钮复用框架模式；AlertWorkbench 与 AlertAuditTimeline 作为 Bell 专用组件。 - 注入合成事件使用 el-dialog / el-form 映射，并明确仅限开发测试。 - 保留键盘选择 Alert、Escape 关闭 Dialog、减少动画偏好和移动端 44px 触控目标。 实际修改文件： - prototypes/bell/index.html - prototypes/bell/bell.css - prototypes/assets/go-admin-ui.css - prototypes/assets/go-admin-shell.js - prototypes/assets/app.js - prototypes/sense/index.html - prototypes/README.md - 删除已被共享适配器替代的 prototypes/sense/go-admin-ui.css 与 prototypes/sense/sense.js ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | 2026-08-12 | Bell 原型升级为直接对齐冻结 go-admin-ui | Bell 正式产品同样以 go-admin-ui 为基础，需降低实现返工 | 是 | ## 文档影响 - [x] 不影响长期产品文档，原因：调整版本绑定原型，不改变稳定业务需求 - [ ] 更新项目档案或本地开发与验证 - [ ] 更新架构与代码地图 - [ ] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [ ] 更新其他 Wiki 页面 ## 交付文档影响 - [ ] 无交付文档影响，原因：不适用 - [x] 更新已有交付文档，受众与页面：产品/开发/测试使用 prototypes/README.md - [ ] 新增交付文档 - [x] 需要目标岗位或客户代表验证：是；浏览器确认布局、组件映射与 Alert 处置流程 ## 验收标准 - [ ] Bell 应用外壳直接对应 go-admin-ui 的 Sidebar、Navbar、TagsView 与 AppMain/Page Container。 - [ ] 通用控件可明确映射至 Element Plus 的 Button、Form、Input/Select、Table、Pagination、Dialog、Tag 和 Tabs。 - [ ] 事件搜索区和权限操作区遵循 go-admin-ui 既有模式，开发测试入口和权限按钮边界明确。 - [ ] 仅 AlertWorkbench 与 AlertAuditTimeline 等 Bell 业务交互作为新增组件，其余组件优先复用。 - [ ] 实时值班台、事件中心、规则策略、合成事件、ack 和 close 交互保持可用。 - [ ] 1440px、768px、375px 和手机横屏无页面级横向溢出；键盘选择、焦点、Escape 和减少动画偏好有效。 - [ ] 无外部 CDN/生产依赖，未修改本地 go-admin-ui；Sense、Brain 原型无回归。 - [ ] README 记录参考仓库、commit、通用组件映射和 Bell 专用组件边界。 ## 验证方式 - 对照 D:\github\goadmin\go-admin-ui\src\layout/**、典型 src/views/**/index.vue 及 Pagination 组件 - 静态资源引用、重复 ID、外部依赖和 JavaScript 语法检查 - 浏览器验证 1440px、768px、375px 与手机横屏 - 验证侧栏折叠、移动抽屉、TagsView、搜索/重置、分页、Dialog/Escape、Tabs、键盘选择、ack/close - Sense、Brain 入口和移动布局回归 - python dev_scripts/check_harness.py --strict - python -m unittest discover -s tests -v - git diff --check ## 风险和回退 风险：通用 CRUD 风格可能削弱值班处置效率，原型 HTML 也可能被误认为真实 Element Plus。控制方式是通用组件对齐、Alert 处置与审计组件保持业务专用，并明确原型仅做组件映射。回退时仅回退本工单提交，恢复 #28 初版 Bell 原型。
ila added the kind/taskproject/bellscope/independentpriority/p0area/ux labels 2026-08-12 10:46:26 +08:00
ila added scope/coordination and removed scope/independent labels 2026-08-12 10:47:26 +08:00
ila commented 2026-08-12 10:56:39 +08:00
Author
Owner
Copy Link
Copy Source

状态：待验收

Bell 原型已按冻结的本地 go-admin-ui 基线完成直接对齐，并追加到现有 PR #29。

  • 实现提交：0bdd88b
  • PR：#29
  • 参考 go-admin-ui commit：67d393d713877572fab0b897296a4c1d525fc81d
  • 应用外壳：Sidebar、Navbar、TagsView、AppMain / 页面容器
  • 通用组件：Button、Form、Input/Select、Table、Pagination、Dialog、Tag、Tabs、搜索区和权限按钮
  • Bell 专用组件：AlertWorkbench、AlertAuditTimeline
  • 复用调整：Sense/Bell 共享 prototypes/assets/go-admin-ui.css 与 go-admin-shell.js，未复制通用外壳实现

验证结果：

  • Harness 严格检查通过
  • 仓库 25 项测试通过
  • JavaScript 语法与 git diff --check 通过
  • 1440px、768px、375px 和手机横屏无页面级横向溢出
  • 搜索/重置、Tabs、键盘选择 Alert、ack/close、时间线追加、Dialog/Escape、侧栏折叠与移动抽屉通过
  • 合成事件注入计数、加载文字恢复和 Dialog 自动关闭通过
  • 无重复 ID、无外部运行资源；全新浏览器会话控制台无错误
  • Sense 共享适配器回归与 Brain 375px 回归通过
  • 本地 go-admin-ui 参考仓库保持干净未修改

尚未完成产品/客户人工验收，因此不关闭工单。

## 状态：待验收 Bell 原型已按冻结的本地 go-admin-ui 基线完成直接对齐，并追加到现有 PR #29。 - 实现提交：0bdd88b - PR：https://git.ilapage.cn/ila/yovision/pulls/29 - 参考 go-admin-ui commit：67d393d713877572fab0b897296a4c1d525fc81d - 应用外壳：Sidebar、Navbar、TagsView、AppMain / 页面容器 - 通用组件：Button、Form、Input/Select、Table、Pagination、Dialog、Tag、Tabs、搜索区和权限按钮 - Bell 专用组件：AlertWorkbench、AlertAuditTimeline - 复用调整：Sense/Bell 共享 prototypes/assets/go-admin-ui.css 与 go-admin-shell.js，未复制通用外壳实现 验证结果： - Harness 严格检查通过 - 仓库 25 项测试通过 - JavaScript 语法与 git diff --check 通过 - 1440px、768px、375px 和手机横屏无页面级横向溢出 - 搜索/重置、Tabs、键盘选择 Alert、ack/close、时间线追加、Dialog/Escape、侧栏折叠与移动抽屉通过 - 合成事件注入计数、加载文字恢复和 Dialog 自动关闭通过 - 无重复 ID、无外部运行资源；全新浏览器会话控制台无错误 - Sense 共享适配器回归与 Brain 375px 回归通过 - 本地 go-admin-ui 参考仓库保持干净未修改 尚未完成产品/客户人工验收，因此不关闭工单。
ila commented 2026-08-12 18:26:36 +08:00
Author
Owner
Copy Link
Copy Source

最终证据：待验收

  • 实现提交：0bdd88b（PR #29）
  • 长期文档与归档协调：#36 / PR #38
  • Wiki 归档 revision：e3ceec7443b6
  • 本地只读镜像：docs/task/31-Bell原型对齐GoAdmin与Element-Plus.md
  • 文档镜像提交：e2a4345、3c245e1
  • 文档验证：36 个 Wiki 映射一致；DevHarness 通过；31 项 unittest 通过；git diff --check 通过

实现、自动测试、Wiki、镜像、提交、推送与 PR 证据已齐。人工验收前本工单保持开启，不关闭、不勾选父工单。

## 最终证据：待验收 - 实现提交：`0bdd88b`（PR #29） - 长期文档与归档协调：#36 / PR #38 - Wiki 归档 revision：`e3ceec7443b6` - 本地只读镜像：`docs/task/31-Bell原型对齐GoAdmin与Element-Plus.md` - 文档镜像提交：`e2a4345`、`3c245e1` - 文档验证：36 个 Wiki 映射一致；DevHarness 通过；31 项 unittest 通过；`git diff --check` 通过 实现、自动测试、Wiki、镜像、提交、推送与 PR 证据已齐。人工验收前本工单保持开启，不关闭、不勾选父工单。
ila commented 2026-08-14 10:06:47 +08:00
Author
Owner
Copy Link
Copy Source

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

用户已明确确认当前未验收工单通过验收。本工单的实现、测试与既有证据按记录接受，Wiki 归档状态已更新为“已完成”（revision 0358e52720df）。该交付属于重建前历史实现；Wiki 归档已完成，代码与原归档镜像继续保留在 explore 追溯。

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

## 用户验收通过（2026-08-14） 用户已明确确认当前未验收工单通过验收。本工单的实现、测试与既有证据按记录接受，Wiki 归档状态已更新为“已完成”（revision `0358e52720df`）。该交付属于重建前历史实现；Wiki 归档已完成，代码与原归档镜像继续保留在 `explore` 追溯。 此验收不改变 #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 project/bell 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#31