# AI基座会议管理 API 参考

## 认证

### 获取 Token

```
POST https://gateway.pccpage.cn/auth/param-token
Content-Type: application/json
```

**请求体：**

| 字段      | 类型   | 说明             |
| --------- | ------ | ---------------- |
| userId    | string | 用户ID           |
| tenantId  | string | 租户ID           |
| appId     | string | 应用ID           |
| timestamp | string | 时间戳（毫秒级） |
| nonce     | string | 随机字符串       |
| signKey   | string | 签名密钥         |

**响应示例：**

```json
{
  "code": 200,
  "msg": "Success",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiJ9...",
    "tenantId": 1,
    "tenantName": "...",
    "tenantCode": "GZDGWLCM"
  }
}
```

**token 使用：** 将 token 放入后续请求的 Header 中，key 为 `Authorization`，值为 `Bearer <token>`。

---

## 会议管理

### 创建会议

```
POST https://gateway.pccpage.cn/gateway/oa-meeting/meetings
Content-Type: application/json
Authorization: Bearer <token>
```

**请求体：**

| 字段           | 类型     | 必填 | 说明                                               |
| -------------- | -------- | ---- | -------------------------------------------------- |
| title          | string   | 是   | 会议标题                                           |
| meetingType    | string   | 是   | 会议类型，可选值见下方                             |
| meetingRoomId  | number   | 是   | 会议室ID                                           |
| startTime      | string   | 是   | 开始时间（ISO 8601格式，如 `2026-04-15T09:00:00`） |
| endTime        | string   | 是   | 结束时间（ISO 8601格式）                           |
| urgencyLevel   | string   | 是   | 紧急程度，可选值见下方                             |
| description    | string   | 否   | 会议描述                                           |
| participantIds | number[] | 是   | 参会人ID数组                                       |

**meetingType 可选值：**

- `WORKSHOP` - 工作坊
- `MEETING` - 会议
- `TRAINING` - 培训
- `OTHER` - 其他

**urgencyLevel 可选值：**

- `HIGH` - 高
- `NORMAL` - 普通
- `LOW` - 低

**请求示例：**

```json
{
  "title": "项目周例会",
  "meetingType": "WORKSHOP",
  "meetingRoomId": 1,
  "startTime": "2026-04-15T09:00:00",
  "endTime": "2026-04-15T10:00:00",
  "urgencyLevel": "NORMAL",
  "description": "本周项目进度汇报",
  "participantIds": [101, 102, 103]
}
```

**成功响应：**

```json
{
  "code": 200,
  "message": "创建成功",
  "data": { ... }
}
```

---

### 查询会议列表

```
GET https://gateway.pccpage.cn/gateway/oa-meeting/meetings?keyword=&status=PLANNED&current=1&size=10
Authorization: Bearer <token>
```

**查询参数：**

| 参数    | 类型   | 必填 | 说明                       |
| ------- | ------ | ---- | -------------------------- |
| keyword | string | 否   | 搜索关键词（标题搜索）     |
| status  | string | 否   | 会议状态过滤，可选值见下方 |
| current | number | 否   | 当前页码（默认1）          |
| size    | number | 否   | 每页条数（默认10）         |

**status 可选值：**

- `PLANNED` - 已计划
- `IN_PROGRESS` - 进行中
- `COMPLETED` - 已完成
- `CANCELLED` - 已取消

**响应格式：**

```json
{
  "code": 200,
  "message": "查询成功",
  "data": {
    "total": 0,
    "records": [
      {
        "id": 1,
        "title": "项目周例会",
        "meetingType": "WORKSHOP",
        "meetingRoomId": 1,
        "startTime": "2026-04-15T09:00:00",
        "endTime": "2026-04-15T10:00:00",
        "urgencyLevel": "NORMAL",
        "description": "...",
        "status": "PLANNED",
        "creatorId": 5,
        "participantIds": [5]
      }
    ],
    "current": 1,
    "size": 10,
    "pages": 0
  }
}
```

---

## 错误码

| code | 说明                         |
| ---- | ---------------------------- |
| 200  | 成功                         |
| 400  | 请求参数错误                 |
| 401  | 认证失败（token 无效或过期） |
| 500  | 服务器内部错误               |
