docs: archive branch governance reset (#58)
This commit is contained in:
@@ -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 已成为默认分支。分支规则已在仓库中生效,服务端保护属于待核验管理项。
|
||||
|
||||
@@ -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"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user