From 9d2c18af788df3283d072f244d533f26bc9bbecf Mon Sep 17 00:00:00 2001 From: Du Wenbo Date: Fri, 3 Apr 2026 22:22:47 +0800 Subject: [PATCH] docs: add Gitea account management guide for admin - Batch account creation script via API - Web UI manual creation steps - Team-based permission management - Developer notification template Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/Gitea账号管理说明.md | 141 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 141 insertions(+) create mode 100644 docs/Gitea账号管理说明.md diff --git a/docs/Gitea账号管理说明.md b/docs/Gitea账号管理说明.md new file mode 100644 index 0000000..756fa3c --- /dev/null +++ b/docs/Gitea账号管理说明.md @@ -0,0 +1,141 @@ +# Gitea 账号管理说明（管理员操作） + +> 本文档供项目经理/管理员使用，用于批量创建开发者账号和管理仓库权限。 + +--- + +## 管理员登录信息 + +| 项目 | 值 | +|------|-----| +| 管理后台 | https://ailabmac-studio.tail954f11.ts.net/git/-/admin | +| 管理员账号 | tianpu | +| 管理员密码 | TianpuGit2026! | +| 仓库地址 | https://ailabmac-studio.tail954f11.ts.net/git/tianpu/tianpu-ems | + +--- + +## 方式一：网页手动创建账号 + +1. 登录管理员账号 +2. 点击右上角头像 → **网站管理** → **用户账户** → **创建用户** +3. 填写信息： + - 用户名：开发者指定的用户名 + - 邮箱：开发者邮箱（可以用 username@tianpu.com） + - 密码：设置初始密码（建议统一用 `Tianpu2026!`，要求首次登录修改） + - 勾选：☑ 要求用户修改密码 +4. 点击「创建用户」 +5. 然后到仓库设置中添加协作者： + - 打开仓库 → **设置** → **协作者** → 输入用户名 → 选择权限（Write）→ 添加 + +## 方式二：API批量创建（推荐） + +用管理员 Token 通过 API 批量创建。先获取 Token： + +1. 登录管理员账号 +2. 右上角头像 → **设置** → **应用** → **生成令牌** +3. 创建一个名为 "admin-api" 的令牌，权限全选 + +然后用以下脚本批量创建： + +```bash +# 设置变量 +GITEA_URL="https://ailabmac-studio.tail954f11.ts.net/git" +ADMIN_TOKEN="你的管理员Token" +REPO_OWNER="tianpu" +REPO_NAME="tianpu-ems" + +# ============================================= +# 在这里修改开发者名单 +# 格式: "用户名 邮箱 全名" +# ============================================= +DEVELOPERS=( + "zhangsan zhangsan@tianpu.com 张三" + "lisi lisi@tianpu.com 李四" + "wangwu wangwu@tianpu.com 王五" + "zhaoliu zhaoliu@tianpu.com 赵六" +) + +# 初始密码（首次登录需修改） +INIT_PASSWORD="Tianpu2026!" + +# 批量创建账号 +for DEV in "${DEVELOPERS[@]}"; do + read -r USERNAME EMAIL FULLNAME <<< "$DEV" + echo "创建账号: $USERNAME ($FULLNAME)" + + curl -s -X POST "$GITEA_URL/api/v1/admin/users" \ + -H "Authorization: token $ADMIN_TOKEN" \ + -H "Content-Type: application/json" \ + -d "{ + \"username\": \"$USERNAME\", + \"email\": \"$EMAIL\", + \"full_name\": \"$FULLNAME\", + \"password\": \"$INIT_PASSWORD\", + \"must_change_password\": true, + \"login_name\": \"$USERNAME\", + \"source_id\": 0, + \"visibility\": \"public\" + }" | python -c "import sys,json; d=json.load(sys.stdin); print(f' ✅ 创建成功: {d.get(\"login\",\"ERROR\")}') if 'id' in d else print(f' ❌ 失败: {d}')" + + # 添加为仓库协作者（Write权限） + curl -s -X PUT "$GITEA_URL/api/v1/repos/$REPO_OWNER/$REPO_NAME/collaborators/$USERNAME" \ + -H "Authorization: token $ADMIN_TOKEN" \ + -H "Content-Type: application/json" \ + -d '{"permission": "write"}' \ + && echo " ✅ 已添加仓库权限" + + echo "" +done + +echo "=============================" +echo "全部完成！" +echo "开发者登录地址: $GITEA_URL" +echo "初始密码: $INIT_PASSWORD（首次登录需修改）" +echo "仓库克隆命令: git clone $GITEA_URL/$REPO_OWNER/$REPO_NAME.git" +echo "=============================" +``` + +--- + +## 方式三：创建团队并用组织管理（可选，适合大团队） + +如果团队人多，可以在 Gitea 中创建组织和团队： + +1. **创建组织**：网站管理 → 组织 → 创建 "tianpu-org" +2. **创建团队**： + - `core-platform`（核心平台组）→ 权限：Write → 添加仓库 tianpu-ems + - `delivery-app`（交付应用组）→ 权限：Write → 添加仓库 tianpu-ems +3. **添加成员**：把后端开发加入 core-platform，前端开发加入 delivery-app + +--- + +## 创建完成后通知开发者 + +将以下信息发给每位开发者： + +``` +【天普EMS开发环境信息】 + +Git仓库地址: https://ailabmac-studio.tail954f11.ts.net/git/tianpu/tianpu-ems +你的账号: {用户名} +初始密码: Tianpu2026!（首次登录请修改密码） + +克隆代码: +git clone https://ailabmac-studio.tail954f11.ts.net/git/tianpu/tianpu-ems.git + +详细环境搭建步骤请参考仓库中的: +docs/开发者环境搭建指南.md + +如有问题请在开发群内提问。 +``` + +--- + +## 权限说明 + +| 权限级别 | 说明 | 建议分配给 | +|---------|------|-----------| +| Admin | 仓库管理（删除/设置） | 项目经理 | +| Write | 推送代码、创建分支 | 所有开发者 | +| Read | 只读（可克隆不可推送） | 外部评审人员 |