# 拼团 API 测试示例

## 实际数据结构（已验证）

### 1. 获取队伍列表
**接口**: `GET /api/v1/users/activity/group_buy/list`

**返回数据**:
```json
{
  "code": 200,
  "message": "Success",
  "data": {
    "group_buy_list": ["17670726110-5"],           // 所有队伍ID
    "lack_group_buy_list": ["17670726110-5"],      // 未满员队伍ID
    "success_group_buy_list": []                   // 已满员队伍ID
  }
}
```

**数据说明**:
- `group_buy_list`: 所有队伍的 ID 列表
- `lack_group_buy_list`: 人数不足的队伍 ID（进行中）
- `success_group_buy_list`: 已满员的队伍 ID（成功）
- 队伍 ID 格式: `时间戳-人数` (如 `17670726110-5` 表示5人队)

---

### 2. 创建队伍
**接口**: `POST /api/v1/admin/activity/group_buy/add_random_group`

**请求参数**:
```javascript
{
  name: "发士大夫",
  group_buy_type: 0  // 0=5人队, 1=10人队
}
```

**返回数据**:
```json
{
  "code": 200,
  "message": "Success",
  "data": {
    "group_buy_id": "17670733070-5",
    "name": "发士大夫",
    "maxPerson": 5,
    "createTime": "2025-12-30T13:41:47.216888773+08:00",
    "users": [{
      "user_id": 0,
      "user_name": "",
      "team_leader": true,
      "cover": "https://oss.hostidc.net/api-server/static/files/...",
      "idc_phone": "",
      "idc_uid": ""
    }]
  }
}
```

**数据说明**:
- 创建成功后会自动添加一个团长（伪人）
- `team_leader: true` 表示是团长
- 返回完整的队伍信息，包括初始成员

---

### 3. 获取队伍详情
**接口**: `GET /api/v1/users/activity/group_buy/detail/:id`

**返回数据**: 与创建队伍返回的数据结构相同

---

## 在代码中使用

### 完整流程示例

```vue
<script setup>
import { ref } from 'vue'
import { ElMessage } from 'element-plus'
import {
  getGroupBuyList,
  getGroupBuyDetail,
  addRandomGroup,
  addRandomUser,
  setOrder
} from '@/api/admin/activity.js'

// 1. 获取队伍列表
const fetchList = async () => {
  try {
    const res = await getGroupBuyList()
    console.log('队伍列表:', res)
    
    if (res.code === 200) {
      const allIds = res.data.group_buy_list || []
      const lackIds = res.data.lack_group_buy_list || []
      const successIds = res.data.success_group_buy_list || []
      
      console.log('所有队伍:', allIds)
      console.log('未满员:', lackIds)
      console.log('已满员:', successIds)
      
      ElMessage.success(`共 ${allIds.length} 个队伍`)
    }
  } catch (error) {
    console.error('获取失败:', error)
    ElMessage.error('获取失败')
  }
}

// 2. 创建队伍
const createTeam = async () => {
  try {
    const res = await addRandomGroup('测试队伍', 0) // 0=5人队
    console.log('创建结果:', res)
    
    if (res.code === 200) {
      const teamId = res.data.group_buy_id
      const teamName = res.data.name
      const memberCount = res.data.users?.length || 0
      
      ElMessage.success(`创建成功！队伍ID: ${teamId}，当前 ${memberCount} 人`)
      
      // 刷新列表
      await fetchList()
    }
  } catch (error) {
    console.error('创建失败:', error)
    ElMessage.error('创建失败')
  }
}

// 3. 获取队伍详情
const getDetail = async (teamId) => {
  try {
    const res = await getGroupBuyDetail(teamId)
    console.log('队伍详情:', res)
    
    if (res.code === 200) {
      const team = res.data
      console.log('队伍名称:', team.name)
      console.log('最大人数:', team.maxPerson)
      console.log('当前成员:', team.users)
    }
  } catch (error) {
    console.error('获取详情失败:', error)
  }
}

// 4. 添加伪人
const addFakeUser = async (teamId) => {
  try {
    const res = await addRandomUser(teamId)
    console.log('添加伪人结果:', res)
    
    if (res.code === 200) {
      ElMessage.success('添加伪人成功')
      // 刷新详情
      await getDetail(teamId)
    }
  } catch (error) {
    console.error('添加失败:', error)
    ElMessage.error('添加失败')
  }
}

// 5. 下发订单
const sendOrder = async (teamId) => {
  try {
    const res = await setOrder(teamId)
    console.log('下发订单结果:', res)
    
    if (res.code === 200) {
      ElMessage.success('订单下发成功')
    }
  } catch (error) {
    console.error('下发失败:', error)
    ElMessage.error('下发失败')
  }
}
</script>
```

---

## 测试步骤

### 步骤 1: 创建队伍
```javascript
await addRandomGroup('测试5人队', 0)
// 返回: { group_buy_id: "xxx-5", name: "测试5人队", maxPerson: 5, users: [1个团长] }
```

### 步骤 2: 查看列表
```javascript
await getGroupBuyList()
// 返回: { group_buy_list: ["xxx-5"], lack_group_buy_list: ["xxx-5"], success_group_buy_list: [] }
```

### 步骤 3: 添加伪人（重复4次，凑满5人）
```javascript
await addRandomUser("xxx-5")  // 第2人
await addRandomUser("xxx-5")  // 第3人
await addRandomUser("xxx-5")  // 第4人
await addRandomUser("xxx-5")  // 第5人
```

### 步骤 4: 再次查看列表
```javascript
await getGroupBuyList()
// 返回: { group_buy_list: ["xxx-5"], lack_group_buy_list: [], success_group_buy_list: ["xxx-5"] }
// 注意: 队伍从 lack_group_buy_list 移到了 success_group_buy_list
```

### 步骤 5: 下发订单
```javascript
await setOrder("xxx-5")
// 为满员队伍下发订单
```

---

## 队伍状态判断逻辑

```javascript
const getTeamStatus = (teamId, lackList, successList) => {
  if (successList.includes(teamId)) {
    return 'success'  // 已满员
  } else if (lackList.includes(teamId)) {
    return 'pending'  // 进行中（未满员）
  } else {
    return 'empty'    // 空队伍（理论上不会出现）
  }
}
```

---

## 队伍类型判断

根据队伍 ID 判断类型：
```javascript
const getTeamType = (teamId) => {
  if (teamId.includes('-5')) {
    return { type: 0, maxPerson: 5, typeName: '5人队' }
  } else if (teamId.includes('-10')) {
    return { type: 1, maxPerson: 10, typeName: '10人队' }
  }
  return { type: 0, maxPerson: 5, typeName: '未知' }
}
```

---

## 注意事项

1. **列表接口只返回 ID**：需要调用详情接口获取完整信息
2. **队伍 ID 格式**：`时间戳-人数`，可以从 ID 判断队伍类型
3. **状态判断**：通过 `lack_group_buy_list` 和 `success_group_buy_list` 判断队伍状态
4. **创建即有团长**：创建队伍时会自动添加一个团长（伪人）
5. **满员条件**：5人队需要5人，10人队需要10人
6. **下发订单**：只能对已满员的队伍下发订单

---

## 当前页面功能

`src/views/activity/GroupBuyActivity.vue` 已实现：

✅ 获取队伍列表（显示所有队伍及状态）
✅ 创建随机伪人队伍
✅ 添加随机伪人到队伍
✅ 查看队伍成员详情
✅ 为满员队伍下发订单
✅ 导出成功队伍信息
✅ 实时状态更新

所有功能都已根据实际 API 数据结构进行了适配！