docs(GOV-003): 配置项目专用 Gitea 远程仓库

2026-08-12 18:33:09 +08:00
parent 7c7190998b
commit b69023e3f8
24 changed files with 336 additions and 11 deletions
@@ -0,0 +1,37 @@
+# 项目专用 Gitea 远程仓库 PRD
+
+- 功能编号：GOV-003
+- PRD 版本：0.1
+- 状态：approved
+- 日期：2026-08-12
+
+## 问题
+
+项目已有可追溯的本地 Git 基线，但尚未关联用户自建 Gitea。接入过程中必须避免把项目凭据扩散到其他仓库，或把密码写入可提交文件和 Git 历史。
+
+## 目标
+
+- 将当前项目的 `origin` 指向指定 Gitea 仓库。
+- 所有 Git 设置只作用于当前项目，不修改全局配置。
+- 使用系统钥匙串保存未来交互式认证产生的凭据，并按仓库路径隔离。
+- 在治理文档中记录地址、账号、配置、验证和回退方法。
+
+## 非目标
+
+- 本次不向远程推送任何提交或标签。
+- 不在项目内保存密码或访问令牌。
+- 不配置 Gitea Actions、Webhook、分支保护或持续集成服务端规则。
+- 不修改其他项目的 Git 配置。
+
+## 用户流程
+
+项目维护者可以从文档确认唯一远程地址和项目账号；代理和开发者使用项目级配置进行读取。首次获得明确推送授权后，维护者在交互式终端完成认证，凭据由 macOS Keychain 管理。
+
+## 验收标准
+
+- `git remote -v` 的 fetch/push 均为指定仓库。
+- 项目级凭据助手为 `osxkeychain`，`credential.useHttpPath` 为 `true`。
+- 全局凭据助手与默认推送目标保持修改前状态。
+- 无密码进入文档、远程 URL、Git 配置或 Git 历史。
+- `git ls-remote origin` 可以建立只读连接。
+- PRD、设计、测试、Review 和回退档案完整。