docs(GOV-001): 建立工程治理与追溯规范

docs/governance/version-control-and-gitea.md

@@ -0,0 +1,40 @@
+# Git 与 Gitea 规范
+
+## 1. 当前策略
+
+当前只使用本地 Git，不配置 GitHub、不创建 GitHub Actions，也不向任何第三方远程仓库推送。用户安装 Gitea 后，再显式配置 `origin`。
+
+## 2. 分支与提交
+
+- `main` 始终保持可验证和可回退。
+- 普通功能使用 `feature/<功能编号>-<短名称>`。
+- 修复使用 `fix/<功能编号>-<短名称>`。
+- 提交必须符合中文 Conventional Commit，仓库通过 `.githooks/commit-msg`检查。
+- 禁止强推共享 `main`，禁止使用破坏历史的回退方式处理已共享版本。
+
+首次克隆后执行：
+
+```bash
+git config core.hooksPath .githooks
+```
+
+## 3. Gitea 接入
+
+Gitea 安装并创建空仓库后，由用户确认地址，再执行：
+
+```bash
+git remote add origin <用户提供的Gitea仓库地址>
+git push -u origin main
+```
+
+建议在 Gitea 中保护 `main`：禁止强推、要求状态检查通过、要求变更说明关联功能编号。未得到用户提供的地址和授权前，任何代理不得自行添加远程或推送。
+
+## 4. 版本与标签
+
+发布使用带注释标签，例如：
+
+```bash
+git tag -a v0.1.0 -m "发布市场综合概览 v0.1.0"
+```
+
+标签必须指向通过验证的提交。应用回退优先选择既有标签和不可变构建产物，而不是重新拼装旧版本。