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

[BEL][已替代] 初始化 Bell 独立 GoAdmin 产品骨架 #9

New Issue
Closed
opened 2026-08-12 09:53:38 +08:00 by ila · 5 comments
ila commented 2026-08-12 09:53:38 +08:00
Owner
Copy Link
Copy Source

当前状态（2026-08-14）

已停止实施，已由 #62 替代。

旧实现及其历史证据保留在 explore 分支，仅用于追溯，不再作为 dev 的产品基线、后续工单前置或验收对象。不得从旧实现继续开发，也不得把其中自研的平台层、认证/RBAC、数据库封装或前端外壳复制回新基线。工单已于 2026-08-14 以“被替代”原因关闭，不记为新架构验收完成。

基本信息

  • 类型：需求
  • 任务类型：单项目
  • 主项目：Bell
  • 主 agent：Bell agent
  • 所属 Epic：#7
  • 所属 MVP / 版本：#8
  • 阶段：三项目首个独立纵切

依赖与并行

  • 前置工单：#3、#5；并要求本机或隔离环境具备 go-admin 技术基线规定的 Go 1.26.5、Node.js 22.22.1、pnpm 9.15.1 与 PostgreSQL
  • 是否允许与前置工单并行：否
  • 原因：骨架必须使用已验收的精简/复用规则和冻结上游基线；工具链不满足时保持待实施。

子项目影响

  • 仅影响的子项目 / 交付单元：Bell
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否；唯一事实来源：不适用，本工单只维护 Bell 内部实现
  • write_paths：Bell/server/go.mod、Bell/server/go.sum、Bell/server/main.go、Bell/server/cmd/**、Bell/server/config/**、Bell/server/internal/platform/**、Bell/web/package.json、Bell/web/pnpm-lock.yaml、Bell/web/vue.config.js、Bell/web/vite.config.js、Bell/web/src/bootstrap/**、Bell/web/src/layout/**、Bell/README.md、Bell/.env.example、Bell/LICENSE*
  • 各子项目需要执行的验证：仅执行 Bell 后端、前端及 PostgreSQL 测试；Sense/Brain 无需启动或验证

协同接口

  • 生产者：不适用
  • 消费者：不适用
  • 契约/共享事实源：不适用
  • 兼容策略：不适用
  • 被阻塞或需要适配的工单：不适用
  • 集成顺序：不适用

原始需求

  • 来源：用户对话、Epic #7、MVP #8、Product-Requirements、Product-Roadmap、Requirements-Migration-Matrix
  • 提出时间：2026-08-12
  • 关键原话或脱敏摘要：先创建三个项目各自独立任务的全部工单，标题包含项目英文简称；Bell 首个纵切须在 Sense/Brain 不在线时以合成事件完成 Event → Alert → ack → close。

要解决什么

Bell 当前只有目录规则，缺少可独立构建、运行、迁移和测试的产品骨架。需要从冻结 go-admin/go-admin-ui commit 建立 Bell 自有后端、前端、PostgreSQL 配置与最小产品外壳，为后续纵切提供稳定入口。

做什么 / 不做什么

  • 做：按 goadmin-baseline.json 派生独立 server/web；保留 MIT 许可证；建立 Bell 自有配置、数据库连接、迁移入口、健康检查、最小菜单外壳和可复制命令；隐藏框架演示及无关默认入口，并关闭不需要的后端访问能力。
  • 不做：不升级上游或工具链；不实现业务 Event/Alert；不修改根目录、contracts、Sense、Brain；不做根级部署；不永久删除默认模块。

已确认方案

Bell 代码完全落在 Bell/，拥有独立模块名、配置命名空间、数据库角色预期和发布产物。默认秘密不得入库，.env.example 只列变量名和安全占位。无关模块采用配置/菜单/路由/权限关闭，永久清理另行建单。

预计修改文件：

  • Bell/server/**
  • Bell/web/**
  • Bell/README.md
  • Bell/.env.example
  • Bell/LICENSE*

需求变化记录

日期 变化内容 原因 用户确认
2026-08-12 无 初始建单 是

文档影响

  • 不影响长期文档，原因：不适用
  • 更新项目档案或本地开发与验证
  • 更新架构与代码地图
  • 更新业务规则与术语
  • 更新常见修改或故障排查
  • 更新其他 Wiki 页面：Bell 独立构建、运行、配置、迁移、测试入口

交付文档影响

  • 无交付文档影响，原因：不适用
  • 更新已有交付文档，受众与页面：开发/实施人员，Bell 安装与本地运行说明
  • 新增交付文档，受众与页面：
  • 需要目标岗位或客户代表验证：否；验证方式：开发环境自动化验证

验收标准

  • 在全新 Bell PostgreSQL 数据库上可完成迁移、启动后端并通过健康检查
  • 前端可独立启动并连接 Bell 后端，不依赖 Sense/Brain
  • 框架演示页、无关菜单和无关后端能力不对普通用户开放
  • 仓库中无默认密码、固定 JWT secret、真实连接串或其他秘密
  • Go/Node/pnpm 与三个上游来源 commit 可被命令核验，MIT 声明保留
  • README 给出复制即可执行的构建、测试、运行、迁移和回退命令

验证方式

Set-Location Bell/server
go version
go test ./...
Set-Location ../web
node --version
pnpm --version
pnpm install --frozen-lockfile
pnpm lint
pnpm build:prod

另以独立 PostgreSQL 测试库执行 Bell README 中固化的迁移、启动和健康检查命令，并检查未授权的默认后端接口不可访问。

未验证边界：Sense/Brain 的正式事件生产、跨项目机器身份、共享事件/证据契约、根级部署与端到端链路不在本工单验证；这些内容留待独立协同工单。

风险和回退

风险：上游骨架可能带演示账户、默认秘密、MySQL 假设或无关权限；必须逐项关闭并以 PostgreSQL 验证。回退：删除本工单新增的 Bell 骨架文件与独立测试数据库即可，不触碰三个上游只读副本和其他项目。

后续协同需求摘要

不适用。

## 当前状态（2026-08-14） **已停止实施，已由 #62 替代。** 旧实现及其历史证据保留在 `explore` 分支，仅用于追溯，不再作为 `dev` 的产品基线、后续工单前置或验收对象。不得从旧实现继续开发，也不得把其中自研的平台层、认证/RBAC、数据库封装或前端外壳复制回新基线。工单已于 2026-08-14 以“被替代”原因关闭，不记为新架构验收完成。 ## 基本信息 - 类型：需求 - 任务类型：单项目 - 主项目：Bell - 主 agent：Bell agent - 所属 Epic：#7 - 所属 MVP / 版本：#8 - 阶段：三项目首个独立纵切 ## 依赖与并行 - 前置工单：#3、#5；并要求本机或隔离环境具备 go-admin 技术基线规定的 Go 1.26.5、Node.js 22.22.1、pnpm 9.15.1 与 PostgreSQL - 是否允许与前置工单并行：否 - 原因：骨架必须使用已验收的精简/复用规则和冻结上游基线；工具链不满足时保持待实施。 ## 子项目影响 - 仅影响的子项目 / 交付单元：Bell - 是否跨子项目：否 - 是否修改共享接口或契约：否；唯一事实来源：不适用，本工单只维护 Bell 内部实现 - write_paths：`Bell/server/go.mod`、`Bell/server/go.sum`、`Bell/server/main.go`、`Bell/server/cmd/**`、`Bell/server/config/**`、`Bell/server/internal/platform/**`、`Bell/web/package.json`、`Bell/web/pnpm-lock.yaml`、`Bell/web/vue.config.js`、`Bell/web/vite.config.js`、`Bell/web/src/bootstrap/**`、`Bell/web/src/layout/**`、`Bell/README.md`、`Bell/.env.example`、`Bell/LICENSE*` - 各子项目需要执行的验证：仅执行 Bell 后端、前端及 PostgreSQL 测试；Sense/Brain 无需启动或验证 ## 协同接口 - 生产者：不适用 - 消费者：不适用 - 契约/共享事实源：不适用 - 兼容策略：不适用 - 被阻塞或需要适配的工单：不适用 - 集成顺序：不适用 ## 原始需求 - 来源：用户对话、Epic #7、MVP #8、Product-Requirements、Product-Roadmap、Requirements-Migration-Matrix - 提出时间：2026-08-12 - 关键原话或脱敏摘要：先创建三个项目各自独立任务的全部工单，标题包含项目英文简称；Bell 首个纵切须在 Sense/Brain 不在线时以合成事件完成 Event → Alert → ack → close。 ## 要解决什么 Bell 当前只有目录规则，缺少可独立构建、运行、迁移和测试的产品骨架。需要从冻结 go-admin/go-admin-ui commit 建立 Bell 自有后端、前端、PostgreSQL 配置与最小产品外壳，为后续纵切提供稳定入口。 ## 做什么 / 不做什么 - 做：按 `goadmin-baseline.json` 派生独立 server/web；保留 MIT 许可证；建立 Bell 自有配置、数据库连接、迁移入口、健康检查、最小菜单外壳和可复制命令；隐藏框架演示及无关默认入口，并关闭不需要的后端访问能力。 - 不做：不升级上游或工具链；不实现业务 Event/Alert；不修改根目录、contracts、Sense、Brain；不做根级部署；不永久删除默认模块。 ## 已确认方案 Bell 代码完全落在 `Bell/`，拥有独立模块名、配置命名空间、数据库角色预期和发布产物。默认秘密不得入库，`.env.example` 只列变量名和安全占位。无关模块采用配置/菜单/路由/权限关闭，永久清理另行建单。 预计修改文件： - `Bell/server/**` - `Bell/web/**` - `Bell/README.md` - `Bell/.env.example` - `Bell/LICENSE*` ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | 2026-08-12 | 无 | 初始建单 | 是 | ## 文档影响 - [ ] 不影响长期文档，原因：不适用 - [x] 更新项目档案或本地开发与验证 - [x] 更新架构与代码地图 - [ ] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki 页面：Bell 独立构建、运行、配置、迁移、测试入口 ## 交付文档影响 - [ ] 无交付文档影响，原因：不适用 - [x] 更新已有交付文档，受众与页面：开发/实施人员，Bell 安装与本地运行说明 - [ ] 新增交付文档，受众与页面： - [x] 需要目标岗位或客户代表验证：否；验证方式：开发环境自动化验证 ## 验收标准 - [ ] 在全新 Bell PostgreSQL 数据库上可完成迁移、启动后端并通过健康检查 - [ ] 前端可独立启动并连接 Bell 后端，不依赖 Sense/Brain - [ ] 框架演示页、无关菜单和无关后端能力不对普通用户开放 - [ ] 仓库中无默认密码、固定 JWT secret、真实连接串或其他秘密 - [ ] Go/Node/pnpm 与三个上游来源 commit 可被命令核验，MIT 声明保留 - [ ] README 给出复制即可执行的构建、测试、运行、迁移和回退命令 ## 验证方式 ```powershell Set-Location Bell/server go version go test ./... Set-Location ../web node --version pnpm --version pnpm install --frozen-lockfile pnpm lint pnpm build:prod ``` 另以独立 PostgreSQL 测试库执行 Bell README 中固化的迁移、启动和健康检查命令，并检查未授权的默认后端接口不可访问。 未验证边界：Sense/Brain 的正式事件生产、跨项目机器身份、共享事件/证据契约、根级部署与端到端链路不在本工单验证；这些内容留待独立协同工单。 ## 风险和回退 风险：上游骨架可能带演示账户、默认秘密、MySQL 假设或无关权限；必须逐项关闭并以 PostgreSQL 验证。回退：删除本工单新增的 Bell 骨架文件与独立测试数据库即可，不触碰三个上游只读副本和其他项目。 ## 后续协同需求摘要 不适用。
ila added the kind/taskpriority/p0project/bellscope/independent labels 2026-08-12 09:58:41 +08:00
ila commented 2026-08-12 17:26:23 +08:00
Author
Owner
Copy Link
Copy Source

状态：进行中（2026-08-12）

已核对前置工单 #3、#5 均已验收关闭，并补齐隔离工具链：

  • Go 1.26.5（官方归档 SHA-256 已核验）
  • Node.js 22.22.1
  • pnpm 9.15.1（独立 Corepack 目录）
  • PostgreSQL 16.14（隔离二进制）

执行分支：agent/codex/9-bell-mvp
独立 worktree：D:\OPC\yovision-bell
本任务写入仅限 Bell/**。主工作区当前存在的 Sense 未提交修改与分支提交不属于本任务，将保持不变且不会混入 Bell 提交。

代码知识图 MCP 工具在本会话未提供，已按仓库规则回退为只读 Git/文件检查。开始按冻结 GoAdmin/go-admin-ui commit 初始化 Bell 独立骨架。

## 状态：进行中（2026-08-12） 已核对前置工单 #3、#5 均已验收关闭，并补齐隔离工具链： - Go 1.26.5（官方归档 SHA-256 已核验） - Node.js 22.22.1 - pnpm 9.15.1（独立 Corepack 目录） - PostgreSQL 16.14（隔离二进制） 执行分支：`agent/codex/9-bell-mvp` 独立 worktree：`D:\OPC\yovision-bell` 本任务写入仅限 `Bell/**`。主工作区当前存在的 Sense 未提交修改与分支提交不属于本任务，将保持不变且不会混入 Bell 提交。 代码知识图 MCP 工具在本会话未提供，已按仓库规则回退为只读 Git/文件检查。开始按冻结 GoAdmin/go-admin-ui commit 初始化 Bell 独立骨架。
ila commented 2026-08-12 17:36:31 +08:00
Author
Owner
Copy Link
Copy Source

实施完成，进入连续依赖验证

  • 实现提交：a5d846a
  • 分支：agent/codex/9-bell-mvp（已推送）
  • Go 1.26.5 / Node 22.22.1 / pnpm 9.15.1：版本核验通过
  • PostgreSQL 16.14 空库：迁移成功
  • /healthz：200；/readyz：200
  • 未注册 go-admin 演示接口：404
  • Go 测试、前端 lint、生产构建：通过（生产构建仅有 Element Plus vendor 体积提示）
  • Harness 严格检查：通过
  • 仓库 31 项测试：通过
  • git diff --check：通过
  • Sense/Brain：未启动、未修改

由于 #12 的真实技术前置是“已可运行的 Bell 独立骨架与数据库迁移入口”，现已满足。按用户要求不中断等待逐单人工验收，继续在此提交上实施 #12。工单仍保持打开，最终统一进入待验收。

## 实施完成，进入连续依赖验证 - 实现提交：`a5d846a` - 分支：`agent/codex/9-bell-mvp`（已推送） - Go 1.26.5 / Node 22.22.1 / pnpm 9.15.1：版本核验通过 - PostgreSQL 16.14 空库：迁移成功 - `/healthz`：200；`/readyz`：200 - 未注册 go-admin 演示接口：404 - Go 测试、前端 lint、生产构建：通过（生产构建仅有 Element Plus vendor 体积提示） - Harness 严格检查：通过 - 仓库 31 项测试：通过 - `git diff --check`：通过 - Sense/Brain：未启动、未修改 由于 #12 的真实技术前置是“已可运行的 Bell 独立骨架与数据库迁移入口”，现已满足。按用户要求不中断等待逐单人工验收，继续在此提交上实施 #12。工单仍保持打开，最终统一进入待验收。
ila commented 2026-08-12 18:26:35 +08:00
Author
Owner
Copy Link
Copy Source

最终证据：待验收

  • 实现提交：a5d846a（PR #35）
  • 长期文档与归档协调：#36 / PR #38
  • Wiki 归档 revision：affa26c4134a
  • 本地只读镜像：docs/task/9-Bell独立GoAdmin产品骨架.md
  • 文档镜像提交：e2a4345、3c245e1
  • 文档验证：36 个 Wiki 映射一致；DevHarness 通过；31 项 unittest 通过；git diff --check 通过

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

## 最终证据：待验收 - 实现提交：`a5d846a`（PR #35） - 长期文档与归档协调：#36 / PR #38 - Wiki 归档 revision：`affa26c4134a` - 本地只读镜像：`docs/task/9-Bell独立GoAdmin产品骨架.md` - 文档镜像提交：`e2a4345`、`3c245e1` - 文档验证：36 个 Wiki 映射一致；DevHarness 通过；31 项 unittest 通过；`git diff --check` 通过 实现、自动测试、Wiki、镜像、提交、推送与 PR 证据已齐。人工验收前本工单保持开启，不关闭、不勾选父工单。
ila changed title from [BEL] 初始化 Bell 独立 GoAdmin 产品骨架 to [BEL][已替代] 初始化 Bell 独立 GoAdmin 产品骨架 2026-08-14 09:40:24 +08:00
ila commented 2026-08-14 09:40:24 +08:00
Author
Owner
Copy Link
Copy Source

架构重建决定（2026-08-14）

本工单停止继续实施，由 #62 接替。原因是已确认后续必须从冻结 go-admin / go-admin-ui 完整应用源码真正派生，并参考 go-admin-doc；本工单产出的自研骨架只保留在 explore 用于追溯。当前不关闭工单，避免把“被替代”误记为用户验收通过。

## 架构重建决定（2026-08-14） 本工单停止继续实施，由 #62 接替。原因是已确认后续必须从冻结 go-admin / go-admin-ui 完整应用源码真正派生，并参考 go-admin-doc；本工单产出的自研骨架只保留在 `explore` 用于追溯。当前不关闭工单，避免把“被替代”误记为用户验收通过。
ila commented 2026-08-14 10:06:51 +08:00
Author
Owner
Copy Link
Copy Source

关闭原因：已被替代（2026-08-14）

本工单不记为新架构验收通过。其历史实现已保留在 explore，新的正式实施由 #62 接替；关闭本工单以避免继续作为后续开发前置。

## 关闭原因：已被替代（2026-08-14） 本工单不记为新架构验收通过。其历史实现已保留在 `explore`，新的正式实施由 #62 接替；关闭本工单以避免继续作为后续开发前置。
ila closed this issue 2026-08-14 10:06:51 +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 kind/task priority/p0 project/bell 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#9