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) <noreply@anthropic.com>
2026-04-03 22:22:47 +08:00
parent 32ff8b6619
commit 9d2c18af78
1 changed files with 141 additions and 0 deletions
--- a/docs/Gitea账号管理说明.md
+++ 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 | 只读（可克隆不可推送） | 外部评审人员 |