38 lines
1.5 KiB
Markdown
38 lines
1.5 KiB
Markdown
# 项目专用 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 和回退档案完整。
|