docs: archive branch governance reset (#58)

This commit is contained in:
QiuSW
2026-08-14 09:12:22 +08:00
parent 0ce30e53a4
commit 1e724e9731
2 changed files with 90 additions and 0 deletions
@@ -0,0 +1,86 @@
<!-- gitea-wiki-mirror:start -->
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
wiki_page: Task-58-建立explore-main-dev分支治理并重置GoAdmin开发基线
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-58-%E5%BB%BA%E7%AB%8Bexplore-main-dev%E5%88%86%E6%94%AF%E6%B2%BB%E7%90%86%E5%B9%B6%E9%87%8D%E7%BD%AEGoAdmin%E5%BC%80%E5%8F%91%E5%9F%BA%E7%BA%BF.-
wiki_revision: 24bd7ca1e2345313afc5628176be7310fe1c3377
synchronized_at: 2026-08-14T01:12:08Z
<!-- gitea-wiki-mirror:end -->
# 58 建立 explore/main/dev 分支治理并重置 GoAdmin 开发基线
- 类型:根级协调任务
- 状态:待验收
- 日期:2026-08-14
- Gitea 工单:https://git.ilapage.cn/ila/yovision/issues/58
## 背景与目标
用户确认保留当前实现作为历史快照,并将后续开发切换到 `dev`,只有用户审核后才能进入 `main`。同时纠正此前“仅参考 GoAdmin、自研基础框架”的偏差:新的 Sense、Bell 必须真正从冻结 go-admin 与 go-admin-ui 源码派生,开发时必须参考冻结 go-admin-doc。
## 最终方案
1. 创建 `explore` 聚合快照,合入 Sense 最新链、Bell MVP、Bell 任务归档和已确认原型;原来源分支全部保留。
2. 共享 Wiki 镜像冲突时,快照树保留 Sense 最新版本;Bell 独立任务归档保留在 `docs/task/`,Bell 共享文档仍可从来源提交完整读取。
3. 审计发现执行前 `main` 已经是最小治理基线,没有 Sense/Bell 产品实现,因此不制造删除或清空提交;只补充分支门禁、GoAdmin 源码派生门禁和更新后的 Wiki 镜像。
4. `dev` 从最终 `main` 创建,后续任务分支从 `dev` 派生,通过 PR 合回 `dev`;只有用户明确审核通过才能执行 `dev → main`。
5. “基于 GoAdmin”定义为从 `goadmin-baseline.json` 指定的完整 go-admin/go-admin-ui commit 导入或派生源码,保留许可证、启动链和通用框架能力。仅使用 Go、Vue、Element Plus、类似目录或视觉不算满足。
6. 每个 Sense/Bell 框架相关工单实施前必须读取相关 go-admin-doc,并记录文档主题/文件、继承路径、裁剪/隐藏模块和来源证据。
7. 当前旧产品实现不合入新 `main` / `dev`;迁移只从 `explore` 提取已确认业务需求和必要业务适配器。
## 分支与回退证据
- 重建前 main:`be2c1e3c81131b51ee9fba67394ae9928e41104c`
- explore 聚合提交:`9020b32`
- main 规则提交:`0ce30e5`
- Sense 来源:`a9f8a55`
- Bell 来源:`9ee06e3`
- Bell 文档来源:`3c245e1`
- 原型来源:`8d1875c`
所有来源分支均保留。需要回退分支治理时可把 main 恢复到重建前 SHA;需要读取旧产品时使用 `explore` 或对应来源分支。
## 测试
- `python dev_scripts/check_harness.py --strict`:通过。
- `python -m unittest discover -s tests -v`:31 项通过。
- `git diff --check`:通过。
- Gitea Wiki 的 Project-Profile、Development-Workflow、Architecture-and-Code-Map、Local-Development-and-Verification 已先更新并读取确认。
## 未自动完成的管理项
当前 MCP 未提供设置默认分支或分支保护的工具。代码与规则已建立审核门禁;Gitea 默认分支切换和 main/dev 保护状态需通过安全 API 或仓库设置完成并在工单记录真实结果,不得仅凭文档声称已保护。
## 遗留边界
本任务不导入新的 GoAdmin 产品源码,也不迁移旧业务功能。Sense/Bell 的真正源码派生和逐模块迁移应另建工单并在 `dev` 上实施。
## 修改文件
- 根级与子项目规则:`AGENTS.md`、`Sense/AGENTS.md`、`Bell/AGENTS.md`
- 分支说明:`README.md`
- Wiki 镜像:项目档案、开发工作流、架构与代码地图、本地开发与验证
- 任务归档镜像与映射:`docs/task/58-*.md`、`wiki-docs.json`
- explore 快照说明:`EXPLORE-SNAPSHOT.md`
## 验收结果
| 验收项 | 结果 |
|---|---|
| explore 聚合旧 Sense、Bell、原型和任务证据 | 通过 |
| 原来源分支保持存在 | 通过 |
| main 保持最小治理与重建基线 | 通过 |
| dev 从最终 main 创建 | 待最终推送核验 |
| GoAdmin/go-admin-ui 源码派生与 go-admin-doc 必查规则 | 通过 |
| 用户未跟踪文件未提交 | 通过 |
| Gitea main/dev 保护与默认分支 | 待管理 API/仓库设置验证 |
## 相关提交
- `9020b32`:记录 explore 快照来源
- `0ce30e5`:建立审核分支流和 GoAdmin 源码派生门禁
- 任务归档提交:完成本页镜像后补充到工单
## 未验证部分
- **未验证部分**:Gitea MCP 当前没有默认分支和分支保护设置工具;在通过安全 API 或仓库设置读取确认前,不声称 main 已被服务器端保护,也不声称 dev 已成为默认分支。分支规则已在仓库中生效,服务端保护属于待核验管理项。
+4
View File
@@ -83,6 +83,10 @@
{
"page": "Task-5-冻结Sense与Bell-GoAdmin技术基线",
"path": "docs/task/5-冻结Sense与Bell-GoAdmin技术基线.md"
},
{
"page": "Task-58-建立explore-main-dev分支治理并重置GoAdmin开发基线",
"path": "docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md"
}
]
}