From 1e724e973189f0fa9bfba8109791658bacd08640 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Fri, 14 Aug 2026 09:12:22 +0800 Subject: [PATCH] docs: archive branch governance reset (#58) --- ...支治理并重置GoAdmin开发基线.md | 86 +++++++++++++++++++ wiki-docs.json | 4 + 2 files changed, 90 insertions(+) create mode 100644 docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md diff --git a/docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md b/docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md new file mode 100644 index 0000000..0c3a95c --- /dev/null +++ b/docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md @@ -0,0 +1,86 @@ + +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 + + +# 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 已成为默认分支。分支规则已在仓库中生效，服务端保护属于待核验管理项。 + diff --git a/wiki-docs.json b/wiki-docs.json index b62855a..7747167 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -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" } ] }