# 急救模块移动端 API 文档

## 🆕 本次变更（前端联调）

| # | 接口 | 变更类型 | 说明                                                                           |
|---|------|:---:|------------------------------------------------------------------------------|
| 1 | `GET /createGroupMagFirstAider` | **废除** | 已废除，功能由 `createGroupMag` 承接                                                  |
| 2 | `GET /order/myParticipatedOrders` | **新增** | App端查询当前登录人参与的应急工单列表（sessionNow=1），返回被救助人信息                                  |


---

> **基础信息**  
> 网关地址: `http://{gateway-host}:{port}`（前端加 `/health-emergency` 前缀）  
> 服务直连: `http://{host}:7011`（调试用，不加前缀）  
> 认证方式: 请求头 `X-Access-Token: {token}`  
> Content-Type: `application/json; charset=utf-8`  
> 统一响应格式: `{"success": bool, "message": "...", "code": 200, "result": {...}, "timestamp": ...}`  
> 日期格式: `yyyy-MM-dd HH:mm:ss`（东八区）

---

## 目录

1. [应急群聊拉人](#1-应急群聊拉人-apiemergency)
2. [宣教资源](#2-宣教资源-apiemergencyfirstaidresource)
3. [工单列表](#3-工单列表-apiemergencyorder)

---

## 1. 应急群聊拉人 `api/emergency`

> 网关完整路径: `/health-emergency/api/emergency`

### 1.1 搜索专家（专业人员） `GET /order/searchExpert`

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| realname | String | 否 | 姓名，模糊搜索 |
| centerId | String | 否 | 应急中心ID |
| excludeSessionId | String | 否 | 群组ID，用于排除已在群中的人 |
| pageNo | Integer | 否 | 页码，默认1 |
| pageSize | Integer | 否 | 每页条数，默认10 |

```json
// 响应 result
{
  "records": [
    {
      "userId": "xxx", "realname": "张医生", "avatar": "https://...",
      "type": "6", "centerId": "xxx",
      "post": "主任医师", "school": "北京大学", "edu": "博士",
      "goodAt": "心血管内科", "deptName": "急诊科", "phone": "13800000001",
      "doctorName": "张医生", "doctorNo": "XJ-001", "photo": "https://...",
      "resourceName": "新疆人民医院", "departmentId": "xxx",
      "departmentName": "急诊科", "doctorTitle": "主任医师",
      "doctorJob": "科长", "doctorStatus": "1", "isAccept": "1",
      "doctorType": "1", "audioStatus": "1", "tfJumpHoliday": "0",
      "experience": "从事心血管内科临床工作20年...",
      "sort": 100, "tfRecommend": "1",
      "introduction": "擅长心血管疾病的诊治..."
    }
  ],
  "total": 50, "size": 10, "current": 1
}
```

| 字段 | 说明 |
|------|------|
| userId | 用户ID，邀请时传入 memberList |
| realname | 姓名 |
| avatar | 头像 |
| type | 类型，"6"=专业人员 |
| centerId | 应急中心ID |
| post | 职称 |
| school | 毕业院校 |
| edu | 学历 |
| goodAt | 擅长领域 |
| deptName | 科室 |
| phone | 手机号 |
| **↓ 以下字段来源于咨询服务专家表(qh_con_doctor)，非专家时为 null** |
| doctorName | 医生姓名 |
| doctorNo | 专家编号 |
| photo | 医生头像 |
| resourceName | 所属医院名称 |
| departmentId | 科室ID |
| departmentName | 科室名称 |
| doctorTitle | 职务(z_doct_lev 字典) |
| doctorJob | 职称(z_doct_job 字典) |
| doctorStatus | 专家状态(doc_status 字典) |
| isAccept | 是否开启咨询(z_doct_sta 字典: 1开启/3关闭) |
| doctorType | 专家类型(z_doct_typ 字典: 1收费/2免费/3其他/4义诊) |
| audioStatus | 是否提供音视频 |
| tfJumpHoliday | 是否跳过节假日 |
| experience | 执业经历 |
| sort | 排序 |
| tfRecommend | 是否推荐(0否/1是) |
| introduction | 简介 |

### 1.2 搜索员工 `GET /order/searchEmployee`

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| realname | String | 否 | 姓名，模糊搜索 |
| orgCode | String | 否 | 部门编码 |
| workNo | String | 否 | 工号 |
| phone | String | 否 | 手机号 |
| excludeSessionId | String | 否 | 群组ID，用于排除已在群中的人 |
| pageNo | Integer | 否 | 页码，默认1 |
| pageSize | Integer | 否 | 每页条数，默认10 |

```json
// 响应 result
{
  "records": [
    {
      "userId": "xxx", "realname": "张三", "avatar": "https://...",
      "orgCode": "650000001001", "orgName": "新疆油田公司",
      "deptName": "安全环保部", "phone": "13800000000", "workNo": "A00123"
    }
  ],
  "total": 200, "size": 10, "current": 1
}
```

| 字段 | 说明 |
|------|------|
| userId | 用户ID，邀请时传入 memberList |
| realname | 姓名 |
| avatar | 头像 |
| orgCode | 部门编码 |
| orgName | 单位名称（二级单位） |
| deptName | 部门名称 |
| phone | 手机号 |
| workNo | 工号 |

### 1.3 创建群聊 `GET /createGroupMag`

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| name | String | 是 | 群聊名称 |
| longitude | String | 是 | 经度 |
| latitude | String | 是 | 纬度 |
| type | String | 否 | 类型 |

> 返回 `groupId`（群组ID），作为后续拉人接口的入参。**此接口会发起音视频通话。**

### 1.4 创建群聊-急救员 `GET /createGroupMagFirstAider` ⚠️ 已废除

> ⚠️ 本接口已废除，功能由 `createGroupMag` 承接，请勿调用。

### 1.5 邀请进群 `POST /addGroupUser`

拉专家或员工加入应急群聊。

```json
// Request Body
{
  "groupId": "1907659384834752513",
  "memberList": ["userId1", "userId2"],
  "memberType": 1
}
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| groupId | String | 是 | 群组ID（即 `createGroupMag` 返回的 `groupId`） |
| memberList | List\<String\> | 是 | 要邀请的用户ID列表，最多100个 |
| memberType | Integer | 否 | `0`=专家/专业人员, `1`=员工，**默认0** |

```json
// 响应
{"success": true, "message": "", "result": true}
```

> 已在群中的人员会自动跳过，不会报错。所有选中的人都在群中时返回失败。

### 1.6 移除群成员 `POST /removeGroupUser`

```json
// Request Body
{ "groupId": "1907659384834752513", "memberList": ["userId1"] }
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| groupId | String | 是 | 群组ID |
| memberList | List\<String\> | 是 | 要移除的用户ID列表 |

```json
// 响应
{"success": true, "message": "", "result": true}
```

> 只能移除后续拉入的协助人员，不能移除发起人和初始操作/专业人员。

### 1.7 群成员列表 `GET /order/getGroupMemberList`

> ⚠️ 本接口仅查本地 DB，不验证腾讯 IM。**建议改用 1.8 `/order/getActualGroupMemberList`。**

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| sessionId | String | 是 | 群组ID |

```json
// 响应 result
[
  { "orderId": "...", "userId": "发起人id", "userName": "李四", "avatar": "https://...", "phone": "13800000001", "isGroupMember": 1, "memberType": -1 },
  { "orderId": "...", "userId": "操作人员id", "userName": "王五", "avatar": "https://...", "phone": "13800000002", "isGroupMember": 1, "memberType": 0 },
  { "orderId": "...", "userId": "专业人员id", "userName": "张医生", "avatar": "https://...", "phone": "13800000003", "isGroupMember": 1, "memberType": 1 },
  { "orderId": "...", "userId": "员工id", "userName": "张三", "avatar": "https://...", "phone": "13800000004", "isGroupMember": 1, "memberType": 2 },
  { "orderId": "...", "userId": "其他专业人id", "userName": "赵医生", "avatar": "https://...", "phone": "13800000005", "isGroupMember": 0, "memberType": 1 }
]
```

| 字段 | 说明 |
|------|------|
| orderId | 应急单ID |
| userId | 用户ID |
| userName | 姓名 |
| avatar | 头像 |
| phone | 手机号 |
| isGroupMember | `1`=在群中, `0`=可邀请 |
| memberType | `-1`=发起人, `0`=操作人员, `1`=专业人员, `2`=员工 |

### 1.8 实际群成员列表 `GET /order/getActualGroupMemberList` 🆕

> **与 1.7 的区别**：本接口先查本地参与人员，再调用腾讯 IM `get_group_member_info` API 获取群内实际成员，以 IM 成员为准取交集，确保返回的都是 IM 群中真实存在的成员。**不过滤本人，通过 `isSelf` 标识。**

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| sessionId | String | 是 | 群组ID |

```json
// 响应 result（与 getGroupMemberList 格式完全一致，但不过滤本人）
[
  { "orderId": "...", "userId": "当前用户id", "userName": "我", "avatar": "https://...", "phone": "13800000000", "isGroupMember": 1, "memberType": 0, "isSelf": 1 },
  { "orderId": "...", "userId": "发起人id", "userName": "李四", "avatar": "https://...", "phone": "13800000001", "isGroupMember": 1, "memberType": -1, "isSelf": 0 },
  { "orderId": "...", "userId": "专业人员id", "userName": "张医生", "avatar": "https://...", "phone": "13800000003", "isGroupMember": 1, "memberType": 1, "isSelf": 0 }
]
```

| 字段 | 说明 |
|------|------|
| orderId | 应急单ID |
| userId | 用户ID |
| userName | 姓名 |
| avatar | 头像 |
| phone | 手机号 |
| isGroupMember | 始终为 `1`（所有返回成员均经 IM 验证在群中） |
| memberType | `-1`=发起人, `0`=操作人员, `1`=专业人员, `2`=员工 |
| isSelf | `0`=不是本人, `1`=是本人 |

> **建议**：前端优先使用本接口获取群成员列表，1.7 接口后续可淘汰。

### 1.9 当前登录人参与的应急工单列表 `GET /order/myParticipatedOrders` 🆕

> App端接口：查询当前登录人参与过的、正在应急（`sessionNow=1`）的工单列表，返回被救助人信息。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| pageNo | Integer | 否 | 页码，默认1 |
| pageSize | Integer | 否 | 每页条数，默认10 |

```json
// 响应 result
{
  "records": [
    {
      "orderId": "2074305914885640194",
      "sessionId": "2074305910070706176",
      "salvageUserName": "张三",
      "salvageUserSex": "1",
      "salvageUserAvatar": "https://fileserver.yg.dt.io/xxx.png",
      "salvageUserAge": 35,
      "salvageUserMobile": "13800000000",
      "orgName": "新疆油田公司",
      "deptName": "安全环保部",
      "orderStatus": "1",
      "initTime": "2026-07-20 10:30:00"
    }
  ],
  "total": 5, "size": 10, "current": 1
}
```

| 字段 | 类型 | 说明 |
|------|------|------|
| orderId | String | 应急单ID |
| sessionId | String | 会话ID |
| salvageUserName | String | 被救助人姓名 |
| salvageUserSex | String | 被救助人性别（字典: sex2） |
| salvageUserAvatar | String | 被救助人头像 |
| salvageUserAge | Integer | 被救助人年龄 |
| salvageUserMobile | String | 被救助人手机号 |
| orgName | String | 单位名称（二级单位） |
| deptName | String | 部门名称 |
| orderStatus | String | 应急单状态（字典: emergency_order_status） |
| initTime | Date | 发起时间 |

### 1.10 memberType 字典

| 值 | 含义 | 场景 |
|:---:|------|------|
| -1 | 发起人 | 创建应急的人 |
| 0 | 操作人员 | 应急中心调度员 |
| 1 | 专业人员 | 专家/医生 |
| 2 | 员工 | 普通员工（被拉入群） |

### 典型调用流程

**应急就医（带音视频通话）**：
```
1. 创建群聊
   GET /health-emergency/api/emergency/createGroupMag?name=xxx&longitude=xxx&latitude=xxx

2. 查看当前成员 → 搜索要拉的人 → 确认邀请 → 移除成员 → 刷新列表
   GET /health-emergency/api/emergency/order/getActualGroupMemberList?sessionId={groupId}
   （以下步骤同急救员流程）
```

**急救员**：
```
1. 创建群聊
   GET /health-emergency/api/emergency/createGroupMag?name=xxx&longitude=xxx&latitude=xxx

2. 查看当前成员（🔀 替换原 /order/getGroupMemberList）
   GET /health-emergency/api/emergency/order/getActualGroupMemberList?sessionId={groupId}
   → 返回经腾讯IM验证的实际群成员，新增 isSelf 字段区分本人

3. 搜索要拉的人
   GET /health-emergency/api/emergency/order/searchExpert?realname=张&excludeSessionId={groupId}
   GET /health-emergency/api/emergency/order/searchEmployee?realname=李&excludeSessionId={groupId}
   → 展示搜索结果，用户勾选

4. 确认邀请
   POST /health-emergency/api/emergency/addGroupUser
   {"groupId": "{groupId}", "memberList": ["id1","id2"], "memberType": 0}

5. 移除成员
   POST /health-emergency/api/emergency/removeGroupUser
   {"groupId": "{groupId}", "memberList": ["id1"]}

6. 刷新成员列表（🔀 替换原 /order/getGroupMemberList）
   GET /health-emergency/api/emergency/order/getActualGroupMemberList?sessionId={groupId}
```

---

## 2. 宣教资源 `api/emergency/firstAid/resource`

> 网关完整路径: `/health-emergency/api/emergency/firstAid/resource`

### 2.1 根据宣教ID查询详情 `GET /resource/queryById`

| 参数 | 类型 | 必填 | 说明 |
|------|------|:---:|------|
| id | String | 是 | 宣教资源ID |

```json
// 响应 result
{
  "id": "...",
  "title": "心肺复苏指南",
  "summary": "摘要简介",
  "contentType": "IMAGE_TEXT",
  "categoryId": "cat1",
  "categoryName": "心肺复苏",
  "applicableScenario": "适用场景",
  "tags": "tag1,tag2",
  "tagNameList": ["成人", "初级"],
  "content": "<h1>富文本HTML正文</h1>",
  "coverImage": "https://example.com/cover.jpg",
  "fileUrl": "[\"https://example.com/file1.pdf\"]",
  "viewCount": 100,
  "favoriteCount": 20,
  "isFavorited": false,
  "effectiveTime": "2026-07-01 00:00:00",
  "expiryTime": "2026-12-31 23:59:59",
  "createTime": "2026-07-01 10:00:00",
  "updateTime": "2026-07-05 14:30:00"
}
```

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 资源ID |
| title | String | 标题 |
| summary | String | 摘要/简介 |
| contentType | String | 内容类型：`IMAGE_TEXT`/`VIDEO`/`AUDIO`/`PDF` |
| categoryId | String | 分类ID |
| categoryName | String | 分类名称 |
| applicableScenario | String | 适用场景 |
| tags | String | 标签ID（逗号分隔） |
| tagNameList | List\<String\> | 标签名称列表 |
| content | String | 富文本正文HTML |
| coverImage | String | 封面图URL |
| fileUrl | String | 附件URL列表（JSON数组字符串） |
| viewCount | Integer | 浏览次数 |
| favoriteCount | Integer | 收藏次数 |
| isFavorited | Boolean | 当前用户是否已收藏 |
| effectiveTime | Date | 生效时间 |
| expiryTime | Date | 失效时间 |
| createTime | Date | 创建时间 |
| updateTime | Date | 更新时间 |

---

## 3. 工单列表 `/api/emergency/order`

> 网关完整路径: `/health-emergency/api/emergency/order`

### 3.1 当前登录人参与的应急工单列表 `GET /myParticipatedOrders` 🆕

**业务逻辑**：
1. 查 `QH_EME_ORDER_OPERATOR` 表获取当前登录人参与的所有工单ID（去重）
2. 查 `QH_EME_ORDER` 表筛选 `sessionNow=1` 的工单，按创建时间倒序
3. 返回被救助人（`salvage` 字段）信息 + 单位/部门名称

> **调用时机**：登录用户在急救页面查看自己正在参与中的应急工单。仅返回 IM 会话进行中的工单（`sessionNow=1`）。

请求和响应格式见 **[1.9 当前登录人参与的应急工单列表](#19-当前登录人参与的应急工单列表-get-ordermyparticipatedorders-)**。