# Gerrit 添加团队成员账号指南

## 方法一：让团队成员自己注册（推荐，最简单）

在开发模式下（`DEVELOPMENT_BECOME_ANY_ACCOUNT`），团队成员可以自己注册账号。

### 操作步骤：

1. **团队成员访问 Gerrit**
   - 打开浏览器
   - 访问：`http://101.43.95.130:8080`

2. **注册账号**
   - 点击 "Sign In"
   - 在登录页面，点击 "New Account" 按钮
   - 系统会自动创建账户并登录

3. **管理员添加用户到组**
   - 管理员登录后，访问：`http://101.43.95.130:8080/#/admin/groups`
   - 创建或选择用户组（例如：`Developers`）
   - 添加团队成员到组中

## 方法二：管理员通过 Web 界面添加用户到组

### 步骤 1：创建用户组（如果需要）

1. 访问：`http://101.43.95.130:8080/#/admin/groups`
2. 点击 "CREATE NEW" 按钮
3. 输入组名（例如：`Developers`）
4. 点击 "CREATE"

### 步骤 2：添加用户到组

1. 访问：`http://101.43.95.130:8080/#/admin/groups/Developers,members`
   - 将 `Developers` 替换为您创建的组名
2. 点击 "Add" 或 "+" 按钮
3. 输入用户名（团队成员注册时使用的用户名）
4. 点击 "Add" 保存

### 步骤 3：配置项目权限

1. 访问项目页面：`http://101.43.95.130:8080/#/admin/projects/项目名称,access`
2. 点击 "Edit" 按钮
3. 添加权限规则：
   - **Reference**: `refs/heads/*`
   - **Permission**: `Read`
   - **Group**: `Developers`（或您创建的组名）
   - 点击 "Add"
4. 添加评审权限：
   - **Reference**: `refs/for/*`
   - **Permission**: `Label Code-Review`
   - **Group**: `Developers`
   - **Value**: `-2..+2`（允许 -2 到 +2 的评审）
   - 点击 "Add"
5. 点击 "Save Changes" 保存

## 方法三：通过命令行添加用户（如果 SSH 配置正确）

```bash
# 添加用户到组
ssh -p 29418 admin@101.43.95.130 gerrit set-members --add 用户名 Developers

# 查看组成员
ssh -p 29418 admin@101.43.95.130 gerrit ls-members Developers
```

## 推荐的权限配置

### 给开发组配置的权限：

1. **读取权限**：
   - Reference: `refs/heads/*`
   - Permission: `Read`
   - Group: `Developers`

2. **代码评审权限**：
   - Reference: `refs/for/*`
   - Permission: `Label Code-Review`
   - Group: `Developers`
   - Value: `-2..+2`

3. **提交权限**（如果需要）：
   - Reference: `refs/heads/*`
   - Permission: `Push`
   - Group: `Developers`

## 快速操作流程

### 管理员操作：

1. **创建开发组**：
   ```
   访问: http://101.43.95.130:8080/#/admin/groups
   点击 "CREATE NEW"
   输入组名: Developers
   点击 "CREATE"
   ```

2. **添加团队成员**：
   ```
   访问: http://101.43.95.130:8080/#/admin/groups/Developers,members
   点击 "Add"
   输入用户名（团队成员注册时使用的用户名）
   点击 "Add"
   ```

3. **配置项目权限**：
   ```
   访问: http://101.43.95.130:8080/#/admin/projects/项目名称,access
   点击 "Edit"
   添加权限规则（参考上面的推荐配置）
   点击 "Save Changes"
   ```

### 团队成员操作：

1. 访问：`http://101.43.95.130:8080`
2. 点击 "Sign In"
3. 点击 "New Account"
4. 填写用户名等信息
5. 等待管理员添加到组中

## 验证配置

### 检查组成员：

访问：`http://101.43.95.130:8080/#/admin/groups/Developers,members`

应该能看到所有团队成员的用户名。

### 检查项目权限：

访问：`http://101.43.95.130:8080/#/admin/projects/项目名称,access`

应该能看到配置的权限规则。

## 常见问题

### Q: 用户注册后看不到项目？

**A:** 需要：
1. 将用户添加到有权限的组
2. 在项目权限中给该组配置 Read 权限

### Q: 用户无法进行代码评审？

**A:** 需要：
1. 在项目权限中给组配置 `Label Code-Review` 权限
2. 设置合适的值范围（例如：`-2..+2`）

### Q: 如何给用户 +2 权限？

**A:** 在项目权限中：
- Reference: `refs/heads/*` 或 `refs/for/*`
- Permission: `Label Code-Review`
- Group/User: 选择用户或组
- Value: `+2`

## 示例：完整的权限配置

```
项目: zhini_im

权限规则：
1. refs/heads/*
   - Read: Developers
   - Push: Administrators
   - Label Code-Review +2: Administrators

2. refs/for/*
   - Read: Developers
   - Label Code-Review -2..+2: Developers
   - Label Code-Review +2: Administrators
```

这样配置后：
- Developers 组的成员可以读取代码、创建变更、进行评审（-2 到 +2）
- Administrators 可以 +2 并直接合并代码