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

[ARCH] 建立 explore/main/dev 分支治理并重置 GoAdmin 开发基线 #58

New Issue
Closed
opened 2026-08-14 09:01:51 +08:00 by ila · 2 comments
ila commented 2026-08-14 09:01:51 +08:00
Owner
Copy Link
Copy Source

状态

已完成

原始需求

  • 来源：用户于 2026-08-14 确认。
  • 脱敏摘要：建立 explore 保存当前代码；将 main 收敛为最小治理基线；由 main 创建 dev，后续只在 dev 集成开发和测试，经用户审核后才能合入 main。
  • 强制要求：Sense、Bell 必须真正基于冻结的 go-admin 与 go-admin-ui 源码二次开发，开发时必须参考冻结的 go-admin-doc；不得再以仅参考交互、自研基础框架冒充 GoAdmin 二次开发。

目标

  1. 建立只读历史快照 explore，保存当前 Sense、Bell、原型、文档和相关历史。
  2. 将 main 变为最小、可审计的受控基线，只保留治理规则、许可证、DevHarness、冻结 GoAdmin 版本及重建入口，不保留当前产品实现。
  3. 从新 main 创建 dev，作为后续集成开发和测试分支。
  4. 固化分支流：功能分支 → dev → 测试 → 用户审核 → main。
  5. 固化 GoAdmin 来源和实现门禁：必须从 goadmin-baseline.json 记录的完整 commit 导入/派生上游源码，保留 MIT；go-admin-doc 是实施时必须核对的框架用法参考。

非目标

  • 本工单不迁移 Sense/Bell 业务功能到新 GoAdmin 骨架。
  • 不删除既有远端功能分支、工单、PR、Wiki 或 Git 历史。
  • 不关闭尚未验收的产品工单。
  • 不把用户未跟踪文件纳入版本库。
  • 不在本工单升级冻结的 Go/Node/pnpm 或上游 commit。

主 agent 与写入范围

  • 主 agent：root / Codex
  • 类型：根级协调任务
  • 影响：仓库分支治理、根级规则和最小基线
  • write_paths：
    • Git refs：explore、main、dev
    • AGENTS.md
    • CLAUDE.md
    • README.md
    • .gitignore
    • goadmin-baseline.json
    • dev_scripts/**
    • tests/**
    • templates/**
    • .gitea/**
    • 必要的最小 docs/** 与 wiki-docs.json
    • 上游许可证/来源声明
  • explore 快照可包含当前各分支已有文件，但本工单不改变其中产品行为。

已确认方案

  1. 先保留当前所有远端分支，不做删除。
  2. 生成 explore 聚合快照；若分支内容冲突，以“不丢失产品源码和任务证据”为原则保留，记录来源分支和 SHA。
  3. 使用普通可追溯提交将 main 收敛为最小基线，不抹除 Git 历史。
  4. 最小 main 保留项目治理、安全规则、DevHarness、冻结基线、许可证和重建说明；删除当前 Sense/Bell/Brain 产品实现及与旧实现绑定的生成镜像。
  5. 从收敛后的 main 创建 dev。
  6. 更新规则：禁止直接在 main 开发；所有功能从 dev 派生并通过 PR 返回 dev；只有用户明确审核通过才能将 dev 合入 main。
  7. 后续 GoAdmin 重建必须以完整上游 commit 为源码基础，不得只复用技术栈、视觉或目录名称；实施前必须核对 go-admin-doc。

风险与回退

  • 风险：聚合多个并行分支可能产生文档/映射冲突；先记录 SHA，并保留所有原分支。
  • 风险：最小 main 会暂时没有可运行产品；当前可运行实现由 explore 和原功能分支保留。
  • 风险：远端默认分支/保护规则可能需要 Gitea 管理设置；工具不可用时明确记录人工步骤，不伪称完成。
  • 回退：将 main 回退到本工单执行前 SHA be2c1e3c81131b51ee9fba67394ae9928e41104c；产品代码仍可从 explore 和原分支恢复。

验收标准

  • explore 存在，包含当前 Sense、Bell、原型与任务证据的可追溯快照。
  • 所有原远端分支仍存在。
  • main 只包含已确认的最小治理与重建基线，无当前产品实现。
  • dev 从新 main 创建。
  • 仓库规则明确 GoAdmin 源码派生、go-admin-ui 源码派生、go-admin-doc 必查及分支审核门禁。
  • 用户未跟踪文件未被提交。
  • 最小基线 Harness/测试通过，或真实阻塞已记录。
  • 远端分支 SHA、回退点和未自动配置的保护项已回写。

文档影响

更新 Gitea Wiki 的项目档案、开发工作流、架构/代码地图和本任务归档，再导出最小基线允许保留的镜像。

## 状态 已完成 ## 原始需求 - 来源：用户于 2026-08-14 确认。 - 脱敏摘要：建立 `explore` 保存当前代码；将 `main` 收敛为最小治理基线；由 `main` 创建 `dev`，后续只在 `dev` 集成开发和测试，经用户审核后才能合入 `main`。 - 强制要求：Sense、Bell 必须真正基于冻结的 `go-admin` 与 `go-admin-ui` 源码二次开发，开发时必须参考冻结的 `go-admin-doc`；不得再以仅参考交互、自研基础框架冒充 GoAdmin 二次开发。 ## 目标 1. 建立只读历史快照 `explore`，保存当前 Sense、Bell、原型、文档和相关历史。 2. 将 `main` 变为最小、可审计的受控基线，只保留治理规则、许可证、DevHarness、冻结 GoAdmin 版本及重建入口，不保留当前产品实现。 3. 从新 `main` 创建 `dev`，作为后续集成开发和测试分支。 4. 固化分支流：功能分支 → `dev` → 测试 → 用户审核 → `main`。 5. 固化 GoAdmin 来源和实现门禁：必须从 `goadmin-baseline.json` 记录的完整 commit 导入/派生上游源码，保留 MIT；`go-admin-doc` 是实施时必须核对的框架用法参考。 ## 非目标 - 本工单不迁移 Sense/Bell 业务功能到新 GoAdmin 骨架。 - 不删除既有远端功能分支、工单、PR、Wiki 或 Git 历史。 - 不关闭尚未验收的产品工单。 - 不把用户未跟踪文件纳入版本库。 - 不在本工单升级冻结的 Go/Node/pnpm 或上游 commit。 ## 主 agent 与写入范围 - 主 agent：root / Codex - 类型：根级协调任务 - 影响：仓库分支治理、根级规则和最小基线 - `write_paths`： - Git refs：`explore`、`main`、`dev` - `AGENTS.md` - `CLAUDE.md` - `README.md` - `.gitignore` - `goadmin-baseline.json` - `dev_scripts/**` - `tests/**` - `templates/**` - `.gitea/**` - 必要的最小 `docs/**` 与 `wiki-docs.json` - 上游许可证/来源声明 - `explore` 快照可包含当前各分支已有文件，但本工单不改变其中产品行为。 ## 已确认方案 1. 先保留当前所有远端分支，不做删除。 2. 生成 `explore` 聚合快照；若分支内容冲突，以“不丢失产品源码和任务证据”为原则保留，记录来源分支和 SHA。 3. 使用普通可追溯提交将 `main` 收敛为最小基线，不抹除 Git 历史。 4. 最小 `main` 保留项目治理、安全规则、DevHarness、冻结基线、许可证和重建说明；删除当前 Sense/Bell/Brain 产品实现及与旧实现绑定的生成镜像。 5. 从收敛后的 `main` 创建 `dev`。 6. 更新规则：禁止直接在 `main` 开发；所有功能从 `dev` 派生并通过 PR 返回 `dev`；只有用户明确审核通过才能将 `dev` 合入 `main`。 7. 后续 GoAdmin 重建必须以完整上游 commit 为源码基础，不得只复用技术栈、视觉或目录名称；实施前必须核对 `go-admin-doc`。 ## 风险与回退 - 风险：聚合多个并行分支可能产生文档/映射冲突；先记录 SHA，并保留所有原分支。 - 风险：最小 main 会暂时没有可运行产品；当前可运行实现由 `explore` 和原功能分支保留。 - 风险：远端默认分支/保护规则可能需要 Gitea 管理设置；工具不可用时明确记录人工步骤，不伪称完成。 - 回退：将 `main` 回退到本工单执行前 SHA `be2c1e3c81131b51ee9fba67394ae9928e41104c`；产品代码仍可从 `explore` 和原分支恢复。 ## 验收标准 - [x] `explore` 存在，包含当前 Sense、Bell、原型与任务证据的可追溯快照。 - [x] 所有原远端分支仍存在。 - [x] `main` 只包含已确认的最小治理与重建基线，无当前产品实现。 - [x] `dev` 从新 `main` 创建。 - [x] 仓库规则明确 GoAdmin 源码派生、go-admin-ui 源码派生、go-admin-doc 必查及分支审核门禁。 - [x] 用户未跟踪文件未被提交。 - [x] 最小基线 Harness/测试通过，或真实阻塞已记录。 - [x] 远端分支 SHA、回退点和未自动配置的保护项已回写。 ## 文档影响 更新 Gitea Wiki 的项目档案、开发工作流、架构/代码地图和本任务归档，再导出最小基线允许保留的镜像。
ila added the kind/taskpriority/p0scope/coordination labels 2026-08-14 09:01:51 +08:00
ila commented 2026-08-14 09:20:25 +08:00
Author
Owner
Copy Link
Copy Source

实施完成，等待用户验收

分支结果

  • explore：9020b32cd299d3431ff4266b8ea59a245b644755
    • 包含 Sense 最新链、Bell MVP、Bell 归档、已确认原型和 EXPLORE-SNAPSHOT.md
    • 原来源分支全部保留，未删除
    • 定位为只读迁移/回退快照
  • main：1e724e973189f0fa9bfba8109791658bacd08640
    • 审计确认执行前已经没有 Sense/Bell 产品实现，因此未制造无意义清空提交
    • 当前只保留治理、Wiki 镜像、DevHarness、冻结 GoAdmin 基线、许可证/来源规则和子项目 AGENTS.md
    • 未合入后续 dev 文档收口，符合“用户审核后才能进入 main”
  • dev：6b970ccf19cd5c84ab148890c3a5e1646dfee0cc
    • 从最终 main 创建
    • PR #59、#60 已按新流程合入 dev
    • 后续任务分支必须从 dev 创建并通过 PR 返回 dev

服务器端门禁（已读取确认）

  • 默认分支：dev
  • main：禁止直接 push、禁止 force push、要求 1 个审批
  • dev：禁止直接 push、禁止 force push；任务 PR 测试后可由 Agent 合并
  • 管理员覆盖仍保留用于用户明确审核后的操作；仓库规则禁止 Agent 未经用户确认执行 dev → main

GoAdmin 强制门禁

已写入根规则、Sense/Bell 子目录规则、README 和 Wiki：

  • Sense/Bell 必须从 goadmin-baseline.json 冻结的 go-admin 与 go-admin-ui 完整 commit 导入/派生源码
  • 仅使用 Go、Vue、Element Plus、相似布局或目录不算 GoAdmin 二次开发
  • 禁止以自建 HTTP、认证/RBAC、会话或管理端外壳替代上游后仍声称基于 GoAdmin
  • 实施工单前必须阅读相关 go-admin-doc，并记录参考主题/文件、继承路径、裁剪/隐藏模块、许可证和相对上游差异

验证

  • python dev_scripts/check_harness.py --strict：通过
  • python -m unittest discover -s tests -v：31 项通过
  • Wiki 全量镜像同步：通过
  • git diff --check：通过
  • explore 必要文件核验：Sense/Bell 入口、原型入口、快照清单均存在
  • main 产品路径核验：Sense/Bell/Brain 仅保留各自 AGENTS.md
  • 用户未跟踪文件 Sense/config/sense.zip、agent_sessions.txt 未提交、未修改

文档

  • Project-Profile：d32f00a86bb3127485b8ad4da8436bf2117352e0
  • Development-Workflow：2bb60b79073439babfda05140ce813d197de81d9
  • Architecture-and-Code-Map：119fb7b2a994d54e4d0a40f7bc2ef6238b162387
  • Local-Development-and-Verification：1730ec258fb54c1b4be15ce0f6e1a18e44281810
  • Business-Rules-and-Glossary：85ddfe99c2f9c97b18d5e39849a50b8c5fca276e
  • Troubleshooting：2be5d803b954df64e31085bcf097ee27f8611f9d
  • Task-58：67ec6d59eb55795e226d0a38cac57b3188d8fa52

工单保持 open / 待验收；未执行 dev → main。

## 实施完成，等待用户验收 ### 分支结果 - `explore`：`9020b32cd299d3431ff4266b8ea59a245b644755` - 包含 Sense 最新链、Bell MVP、Bell 归档、已确认原型和 `EXPLORE-SNAPSHOT.md` - 原来源分支全部保留，未删除 - 定位为只读迁移/回退快照 - `main`：`1e724e973189f0fa9bfba8109791658bacd08640` - 审计确认执行前已经没有 Sense/Bell 产品实现，因此未制造无意义清空提交 - 当前只保留治理、Wiki 镜像、DevHarness、冻结 GoAdmin 基线、许可证/来源规则和子项目 `AGENTS.md` - 未合入后续 dev 文档收口，符合“用户审核后才能进入 main” - `dev`：`6b970ccf19cd5c84ab148890c3a5e1646dfee0cc` - 从最终 main 创建 - PR #59、#60 已按新流程合入 dev - 后续任务分支必须从 dev 创建并通过 PR 返回 dev ### 服务器端门禁（已读取确认） - 默认分支：`dev` - `main`：禁止直接 push、禁止 force push、要求 1 个审批 - `dev`：禁止直接 push、禁止 force push；任务 PR 测试后可由 Agent 合并 - 管理员覆盖仍保留用于用户明确审核后的操作；仓库规则禁止 Agent 未经用户确认执行 `dev → main` ### GoAdmin 强制门禁 已写入根规则、Sense/Bell 子目录规则、README 和 Wiki： - Sense/Bell 必须从 `goadmin-baseline.json` 冻结的 go-admin 与 go-admin-ui 完整 commit 导入/派生源码 - 仅使用 Go、Vue、Element Plus、相似布局或目录不算 GoAdmin 二次开发 - 禁止以自建 HTTP、认证/RBAC、会话或管理端外壳替代上游后仍声称基于 GoAdmin - 实施工单前必须阅读相关 go-admin-doc，并记录参考主题/文件、继承路径、裁剪/隐藏模块、许可证和相对上游差异 ### 验证 - `python dev_scripts/check_harness.py --strict`：通过 - `python -m unittest discover -s tests -v`：31 项通过 - Wiki 全量镜像同步：通过 - `git diff --check`：通过 - explore 必要文件核验：Sense/Bell 入口、原型入口、快照清单均存在 - main 产品路径核验：Sense/Bell/Brain 仅保留各自 `AGENTS.md` - 用户未跟踪文件 `Sense/config/sense.zip`、`agent_sessions.txt` 未提交、未修改 ### 文档 - Project-Profile：`d32f00a86bb3127485b8ad4da8436bf2117352e0` - Development-Workflow：`2bb60b79073439babfda05140ce813d197de81d9` - Architecture-and-Code-Map：`119fb7b2a994d54e4d0a40f7bc2ef6238b162387` - Local-Development-and-Verification：`1730ec258fb54c1b4be15ce0f6e1a18e44281810` - Business-Rules-and-Glossary：`85ddfe99c2f9c97b18d5e39849a50b8c5fca276e` - Troubleshooting：`2be5d803b954df64e31085bcf097ee27f8611f9d` - Task-58：`67ec6d59eb55795e226d0a38cac57b3188d8fa52` 工单保持 open / 待验收；未执行 `dev → main`。
ila commented 2026-08-14 10:06:51 +08:00
Author
Owner
Copy Link
Copy Source

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

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

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

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