tianpu-ems/docs/Gitea账号管理说明.md

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" 的令牌，权限全选

然后用以下脚本批量创建：

# 设置变量
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	只读（可克隆不可推送）	外部评审人员