psvt-miniprogram/api-doc/psvt-patient-api-doc.md

# PSVT患者模块接口文档

## 一、小程序端接口

### 1.1 初始化登录 `GET ?r=psvt/user/init-login`

**说明**: 小程序端通过wx.login获取code，发送到服务端完成登录初始化，返回登录态及用户状态信息。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | string | 是 | wx.login获取的登录凭证 |
| channelId | int | 否 | 扫码渠道ID |

**响应示例**:
```json
{
  "code": 0,
  "data": {
    "loginState": "xxx",
    "isLogin": true,
    "isReg": true,
    "userId": "xxx",
    "openId": "xxx",
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| loginState | string | 登录态凭证，后续接口需携带 |
| isLogin | bool | 是否已登录 |
| userId | string | 用户ID |
| openId | string | 小程序OpenId |
| isPhoneRegistered | bool | 是否已手机号注册 |
| isInfoSubmitted | bool | 是否已提交信息 |

**业务逻辑**:
1. 调用微信接口获取openid和session_key
2. 创建/更新PSVT用户记录（t_psvt_user_info）
3. 若有channelId参数，更新ScanChannelId（最终渠道，每次扫码都更新）
4. 首次打开时记录FirstOpenTime
5. 返回用户状态信息（isPhoneRegistered、isInfoSubmitted）

---

### 1.2 手机号授权注册 `POST ?r=psvt/patient/phone-register`

**说明**: 解密微信加密数据获取手机号，完成手机号注册。事务操作。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| encryptedData | string | 是 | 微信加密手机号数据 |
| iv | string | 是 | 微信加密iv |
| channelId | int | 否 | 手机号注册时的渠道ID |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "telephone": "138xxxx1234",
    "isPhoneRegistered": true
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| telephone | string | 注册的手机号 |
| isPhoneRegistered | bool | 是否已手机号注册 |

**业务逻辑**:
1. 解密微信加密数据获取手机号
2. 更新t_psvt_user_info的Telephone、IsPhoneRegistered=1、PhoneRegisterTime
3. 若有channelId，记录TelChannelId（首次手机号注册渠道，仅记录首次，不更新）
4. 若有channelId，记录邀约记录（InviteType=2手机号注册）并更新统计表
5. 更新IsFirstOpenPhoneRegistered（首次打开时间和手机号注册时间是同一天时为1）
6. 更新IsPhoneRegisteredNotLost（手机号注册时间和提交信息时间是同一天时为1）
7. 使用事务

---

### 1.3 患者信息提交注册 `POST ?r=psvt/patient/register`

**说明**: 提交年龄段、性别、确诊状态、手术状态等信息完成注册。事务操作。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ageRange | int | 是 | 年龄段：1-18~28岁，2-29~40岁，3-41~50岁，4-50岁以上 |
| gender | int | 是 | 性别：1-男，2-女 |
| provinceId | int | 否 | 省份ID |
| provinceName | string | 否 | 省份名称 |
| cityId | int | 否 | 市ID |
| cityName | string | 否 | 市名称 |
| diagnosisStatus | int | 是 | 确诊状态：1-疑似PSVT正在了解中，2-已确诊PSVT，3-心悸/心跳过快 尚未就诊，4-亲友相关 想了解更多 |
| diagnosisTime | string | 否 | 确诊时间（YYYY-MM格式） |
| surgeryStatus | int | 是 | 手术状态：1-已接收射频消融/相关手术，2-尚未接收手术，3-正在评估 |
| channelId | int | 否 | 提交信息渠道ID |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "userId": "xxx",
    "nickName": "abcd12345678",
    "avatar": "https://psvt.example.com/avatar/3.png",
    "isRegistered": true
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| userId | string | 用户ID |
| nickName | string | 随机生成的昵称（4字母+8数字） |
| avatar | string | 随机分配的头像URL |
| isRegistered | bool | 是否已注册 |

**业务逻辑**:
1. 生成随机昵称（4随机字母+8随机数字）
2. 随机分配头像（10张图片池中随机选1）
3. 创建t_psvt_patient_info记录（患者属性）
4. 更新t_psvt_user_info的PatientId、IsInfoSubmitted=1、InfoSubmitTime、SubmitChannelId
5. 更新IsFirstOpenInfoSubmitted（首次打开时间和信息提交时间是同一天时为1）
6. 更新IsPhoneRegisteredNotLost（手机号注册时间和信息提交时间是同一天时为1）
7. 若有channelId，记录邀约记录（InviteType=3信息提交）并更新统计表
8. 使用事务

---

### 1.4 获取我的信息 `GET ?r=psvt/patient/my-info`

**说明**: 返回当前登录用户的完整信息（用户信息+患者属性），小驼峰格式。

**请求参数**: 无（通过loginState获取userId）

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "userId": "xxx",
    "openId": "xxx",
    "telephone": "138xxxx1234",
    "isPhoneRegistered": true,
    "isInfoSubmitted": true,
    "isHeartRateTips": true,
    "firstOpenTime": "2023-01-01 10:00:00",
    "phoneRegisterTime": "2023-01-01 10:05:00",
    "infoSubmitTime": "2023-01-01 10:10:00",
    "nickName": "abcd12345678",
    "avatar": "https://psvt.example.com/avatar/3.png",
    "ageRange": 1,
    "gender": 1,
    "provinceName": "北京",
    "cityName": "北京",
    "diagnosisStatus": 2,
    "diagnosisTime": "2023-06",
    "surgeryStatus": 1
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| userId | string | 用户ID |
| openId | string | 小程序OpenId |
| telephone | string | 手机号 |
| isPhoneRegistered | bool | 是否已手机号注册 |
| isInfoSubmitted | bool | 是否已提交信息 |
| isHeartRateTips | bool | 是否开启心率提醒 |
| firstOpenTime | string | 首次打开时间 |
| phoneRegisterTime | string | 手机号注册时间 |
| infoSubmitTime | string | 信息提交时间 |
| nickName | string | 昵称（未提交信息时为null） |
| avatar | string | 头像URL（未提交信息时为null） |
| ageRange | int | 年龄段（未提交信息时为null） |
| gender | int | 性别（未提交信息时为null） |
| provinceName | string | 省份名称（未提交信息时为null） |
| cityName | string | 市名称（未提交信息时为null） |
| diagnosisStatus | int | 确诊状态（未提交信息时为null） |
| diagnosisTime | string | 确诊时间（未提交信息时为null） |
| surgeryStatus | int | 手术状态（未提交信息时为null） |

---

### 1.5 更新我的信息 `POST ?r=psvt/patient/update-my-info`

**说明**: 更新当前登录用户的个人信息。若已确诊PSVT(DiagnosisStatus=2)，确诊状态和手术状态不可修改。事务操作。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| avatar | string | 否 | 头像URL |
| nickName | string | 否 | 昵称 |
| telephone | string | 否 | 手机号 |
| ageRange | int | 否 | 年龄段 |
| gender | int | 否 | 性别 |
| provinceId | int | 否 | 省份ID |
| provinceName | string | 否 | 省份名称 |
| cityId | int | 否 | 市ID |
| cityName | string | 否 | 市名称 |
| diagnosisStatus | int | 否 | 确诊状态（已确诊PSVT后不可修改） |
| diagnosisTime | string | 否 | 确诊时间 |
| surgeryStatus | int | 否 | 手术状态（已确诊PSVT后不可修改） |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "userId": "xxx",
    "openId": "xxx",
    "telephone": "138xxxx1234",
    "isPhoneRegistered": true,
    "isInfoSubmitted": true,
    "isHeartRateTips": true,
    "firstOpenTime": "2023-01-01 10:00:00",
    "phoneRegisterTime": "2023-01-01 10:05:00",
    "infoSubmitTime": "2023-01-01 10:10:00",
    "nickName": "newNickname",
    "avatar": "https://...",
    "ageRange": 2,
    "gender": 1,
    "provinceName": "上海",
    "cityName": "上海",
    "diagnosisStatus": 2,
    "diagnosisTime": "2023-06",
    "surgeryStatus": 1
  }
}
```

**响应字段说明**: 同1.4获取我的信息

**业务逻辑**:
1. 若已确诊PSVT（DiagnosisStatus=2），则diagnosisStatus和surgeryStatus不可修改
2. 更新t_psvt_patient_info患者属性
3. 若更新了手机号，同步更新t_psvt_user_info的Telephone
4. 使用事务

---

### 1.6 渠道码扫码记录 `POST ?r=psvt/?r=channel/scan-channel`

**说明**: 记录扫码渠道信息，更新用户的ScanChannelId。事务操作。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channelId | int | 是 | 渠道码ID |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "recorded": true
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| recorded | bool | 是否记录成功 |

**业务逻辑**:
1. 验证渠道码存在
2. 更新用户ScanChannelId（最终渠道，每次扫码都更新）
3. 记录邀约记录（InviteType=1用户打开）
4. 更新统计表
5. 使用事务

---

### 1.7 获取基础数据列表 `GET ?r=psvt/patient/base-data`

**说明**: 返回性别、年龄段、确诊状态、手术状态等枚举数据，供前端渲染下拉选项。

**请求参数**: 无

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "genderList": [{"1": "男"}, {"2": "女"}],
    "ageRangeList": [{"1": "18~28岁"}, {"2": "29~40岁"}, {"3": "41~50岁"}, {"4": "50岁以上"}],
    "diagnosisStatusList": [{"1": "疑似PSVT正在了解中"}, {"2": "已确诊PSVT"}, {"3": "心悸/心跳过快 尚未就诊"}, {"4": "亲友相关 想了解更多"}],
    "surgeryStatusList": [{"1": "已接收射频消融/相关手术"}, {"2": "尚未接收手术"}, {"3": "正在评估"}]
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| genderList | array | 性别列表，每项为 {value: "label"} |
| ageRangeList | array | 年龄段列表，每项为 {value: "label"} |
| diagnosisStatusList | array | 确诊状态列表，每项为 {value: "label"} |
| surgeryStatusList | array | 手术状态列表，每项为 {value: "label"} |

**genderList值说明**:

| 值 | 说明 |
|---|---|
| 1 | 男 |
| 2 | 女 |

**ageRangeList值说明**:

| 值 | 说明 |
|---|---|
| 1 | 18~28岁 |
| 2 | 29~40岁 |
| 3 | 41~50岁 |
| 4 | 50岁以上 |

**diagnosisStatusList值说明**:

| 值 | 说明 |
|---|---|
| 1 | 疑似PSVT正在了解中 |
| 2 | 已确诊PSVT |
| 3 | 心悸/心跳过快 尚未就诊 |
| 4 | 亲友相关 想了解更多 |

**surgeryStatusList值说明**:

| 值 | 说明 |
|---|---|
| 1 | 已接收射频消融/相关手术 |
| 2 | 尚未接收手术 |
| 3 | 正在评估 |

---

## 二、后台管理端接口

### 2.1 患者列表 `GET ?r=patient/list`

**说明**: 获取PSVT患者列表，含分页、搜索、渠道筛选及汇总统计。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| search | string | 否 | 搜索关键字（手机号/UserId/省市） |
| channelId | int | 否 | 渠道ID筛选 |
| page | int | 否 | 页码，默认1 |
| count | int | 否 | 每页数量，默认10 |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "page": 1,
    "pages": 10,
    "count": 100,
    "summary": {
      "totalOpenCount": 1920,
      "phoneRegisteredCount": 1900,
      "phoneRegisteredRate": "19.9%",
      "infoSubmittedCount": 1082,
      "infoSubmittedRate": "56.3%",
      "diagnosedPsvtCount": 980,
      "diagnosedPsvtRate": "90.2%",
      "firstOpenPhoneRegisteredCount": 800,
      "firstOpenInfoSubmittedCount": 800,
      "phoneRegisteredNotLostCount": 700
    },
    "list": [
      {
        "userId": "xxx",
        "telephone": "138xxxx1234",
        "nickName": "abcd12345678",
        "avatar": "https://...",
        "ageRange": 1,
        "gender": 1,
        "provinceName": "北京",
        "cityName": "北京",
        "diagnosisStatus": 2,
        "diagnosisTime": "2023-06",
        "surgeryStatus": 1,
        "firstOpenTime": "2023-01-01 10:00:00",
        "phoneRegisterTime": "2023-01-01 10:05:00",
        "infoSubmitTime": "2023-01-01 10:10:00",
        "isFirstOpenPhoneRegistered": true,
        "isFirstOpenInfoSubmitted": true,
        "isPhoneRegisteredNotLost": true,
        "scanChannelId": 1,
        "scanChannelName": "渠道A",
        "telChannelId": 2,
        "telChannelName": "渠道B",
        "submitChannelId": 3,
        "submitChannelName": "渠道C"
      }
    ]
  }
}
```

**响应字段说明（data层级）**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| page | int | 当前页码 |
| pages | int | 总页数 |
| count | int | 总记录数 |
| summary | object | 汇合统计数据 |
| list | array | 患者列表 |

**summary字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| totalOpenCount | int | 总打开数 |
| phoneRegisteredCount | int | 手机号注册数 |
| phoneRegisteredRate | string | 手机号注册率（百分比） |
| infoSubmittedCount | int | 信息提交数 |
| infoSubmittedRate | string | 信息提交率（百分比） |
| diagnosedPsvtCount | int | 确诊PSVT数 |
| diagnosedPsvtRate | string | 确诊PSVT率（百分比） |
| firstOpenPhoneRegisteredCount | int | 首次打开完成手机号注册数 |
| firstOpenInfoSubmittedCount | int | 首次打开完成信息填写数 |
| phoneRegisteredNotLostCount | int | 手机号注册后未流失数 |

**list行字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| userId | string | 用户ID |
| telephone | string | 手机号 |
| nickName | string | 昵称 |
| avatar | string | 头像URL |
| ageRange | int | 年龄段 |
| gender | int | 性别 |
| provinceName | string | 省份名称 |
| cityName | string | 市名称 |
| diagnosisStatus | int | 确诊状态 |
| diagnosisTime | string | 确诊时间 |
| surgeryStatus | int | 手术状态 |
| firstOpenTime | string | 首次打开时间 |
| phoneRegisterTime | string | 手机号注册时间 |
| infoSubmitTime | string | 信息提交时间 |
| isFirstOpenPhoneRegistered | bool | 首次打开完成手机号注册 |
| isFirstOpenInfoSubmitted | bool | 首次打开完成信息填写 |
| isPhoneRegisteredNotLost | bool | 手机号注册后未流失 |
| scanChannelId | int | 扫码渠道ID |
| scanChannelName | string | 扫码渠道名称 |
| telChannelId | int | 手机号注册渠道ID |
| telChannelName | string | 手机号注册渠道名称 |
| submitChannelId | int | 提交信息渠道ID |
| submitChannelName | string | 提交信息渠道名称 |

---

### 2.2 患者详情 `GET ?r=patient/detail`

**说明**: 根据用户信息表ID获取完整的用户+患者详情数据。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 用户信息表ID |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "userId": "xxx",
    "openId": "xxx",
    "telephone": "138xxxx1234",
    "isPhoneRegistered": true,
    "isInfoSubmitted": true,
    "isHeartRateTips": true,
    "firstOpenTime": "2023-01-01 10:00:00",
    "phoneRegisterTime": "2023-01-01 10:05:00",
    "infoSubmitTime": "2023-01-01 10:10:00",
    "nickName": "abcd12345678",
    "avatar": "https://...",
    "ageRange": 1,
    "gender": 1,
    "provinceName": "北京",
    "cityName": "北京",
    "diagnosisStatus": 2,
    "diagnosisTime": "2023-06",
    "surgeryStatus": 1,
    "scanChannelId": 1,
    "scanChannelName": "渠道A",
    "telChannelId": 2,
    "telChannelName": "渠道B",
    "submitChannelId": 3,
    "submitChannelName": "渠道C"
  }
}
```

**响应字段说明**: 同1.4获取我的信息，额外包含渠道信息字段（scanChannelId/scanChannelName、telChannelId/telChannelName、submitChannelId/submitChannelName）

---

### 2.3 渠道码列表 `GET ?r=?r=channel/list`

**说明**: 获取所有有效渠道码列表。

**请求参数**: 无

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "channelId": 1,
      "channelName": "渠道A",
      "channelDesc": "渠道A说明",
      "miniCodeUrl": "https://xxx/minicode_1.png"
    }
  ]
}
```

**响应字段说明（每行）**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| channelId | int | 渠道ID |
| channelName | string | 渠道名称 |
| channelDesc | string | 渠道码说明 |
| miniCodeUrl | string | 小程序码图片URL |

---

### 2.4 创建渠道码 `POST ?r=channel/create`

**说明**: 创建新的渠道码。事务操作。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channelName | string | 是 | 渠道名称 |
| channelDesc | string | 否 | 渠道码说明 |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "channelId": 1,
    "channelName": "渠道A"
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| channelId | int | 新创建的渠道ID |
| channelName | string | 渠道名称 |

---

### 2.5 更新渠道码 `POST ?r=channel/update`

**说明**: 更新渠道码信息。事务操作。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channelId | int | 是 | 渠道ID |
| channelName | string | 否 | 渠道名称 |
| channelDesc | string | 否 | 渠道码说明 |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "channelId": 1,
    "channelName": "渠道A（已更新）"
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| channelId | int | 渠道ID |
| channelName | string | 更新后的渠道名称 |

---

### 2.6 获取小程序渠道码 `GET ?r=channel/get-minicode`

**说明**: 根据渠道ID获取或生成小程序码图片URL。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channelId | int | 是 | 渠道ID |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "channelId": 1,
    "channelName": "渠道A",
    "miniCodeUrl": "https://xxx/minicode_1.png"
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| channelId | int | 渠道ID |
| channelName | string | 渠道名称 |
| miniCodeUrl | string | 小程序码图片URL |

**业务逻辑**:
1. 若渠道已有小程序码URL（MiniCodeUrl），直接返回
2. 若没有，调用微信接口生成小程序码（scene参数包含渠道ID）
3. 保存生成的MiniCodeUrl到渠道记录

---

### 2.7 渠道码统计 `GET ?r=channel/stat`

**说明**: 根据日期范围和渠道ID获取渠道统计数据，从统计表获取。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| inviteDateBegin | string | 否 | 邀约日期开始（YYYY-MM-DD） |
| inviteDateEnd | string | 否 | 邀约日期结束（YYYY-MM-DD） |
| channelIds | string | 否 | 渠道ID筛选，逗号分隔（如"1,2,3"） |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "statDate": "2023-01-01",
      "channelId": 1,
      "channelName": "渠道A",
      "openPatientCount": 100,
      "phoneRegisteredCount": 80,
      "infoSubmittedCount": 50,
      "diagnosedPsvtCount": 30
    }
  ]
}
```

**响应字段说明（每行）**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| statDate | string | 统计日期 |
| channelId | int | 渠道ID |
| channelName | string | 渠道名称 |
| openPatientCount | int | 邀约打开患者数 |
| phoneRegisteredCount | int | 邀约注册手机号患者数 |
| infoSubmittedCount | int | 邀约提交信息患者数 |
| diagnosedPsvtCount | int | 确诊PSVT患者数 |

---

### 2.8 渠道码原始数据列表 `GET ?r=channel/raw-list`

**说明**: 获取渠道邀约的原始记录列表，支持分页。通过JOIN t_psvt_user_info和t_psvt_patient_info获取用户属性和患者属性，不冗余存储。

**请求参数**:

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| inviteDateBegin | string | 否 | 邀约日期开始（YYYY-MM-DD） |
| inviteDateEnd | string | 否 | 邀约日期结束（YYYY-MM-DD） |
| channelId | int | 否 | 渠道ID筛选 |
| inviteType | int | 否 | 邀约类型筛选：1-用户打开，2-手机号注册，3-信息提交 |
| page | int | 否 | 页码，默认1 |
| count | int | 否 | 每页数量，默认10 |

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "page": 1,
    "pages": 10,
    "count": 100,
    "list": [
      {
        "id": 1,
        "inviteTime": "2023-01-01 10:00:00",
        "channelId": 1,
        "channelName": "渠道A",
        "inviteType": 1,
        "userId": "xxx",
        "patientId": 5,
        "nickName": "abcd12345678",
        "gender": 1,
        "ageRange": 1,
        "provinceName": "北京",
        "cityName": "北京",
        "diagnosisStatus": 2,
        "diagnosisTime": "2023-06",
        "surgeryStatus": 1,
        "telephone": "138xxxx1234",
        "firstOpenTime": "2023-01-01 10:00:00",
        "phoneRegisterTime": "2023-01-01 10:05:00",
        "infoSubmitTime": "2023-01-01 10:10:00",
        "isFirstOpenPhoneRegistered": true,
        "isFirstOpenInfoSubmitted": true,
        "isPhoneRegisteredNotLost": true,
        "scanChannelId": 1,
        "scanChannelName": "渠道A",
        "telChannelId": 2,
        "telChannelName": "渠道B",
        "submitChannelId": 3,
        "submitChannelName": "渠道C"
      }
    ]
  }
}
```

**响应字段说明（data层级）**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| page | int | 当前页码 |
| pages | int | 总页数 |
| count | int | 总记录数 |
| list | array | 原始数据列表 |

**list行字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| id | int | 记录ID |
| inviteTime | string | 邀约时间 |
| channelId | int | 渠道ID |
| channelName | string | 渠道名称 |
| inviteType | int | 邀约类型 |
| userId | string | 用户ID |
| patientId | int | 患者ID |
| nickName | string | 昵称 |
| gender | int | 性别 |
| ageRange | int | 年龄段 |
| provinceName | string | 省份名称 |
| cityName | string | 市名称 |
| diagnosisStatus | int | 确诊状态 |
| diagnosisTime | string | 确诊时间 |
| surgeryStatus | int | 手术状态 |
| telephone | string | 手机号 |
| firstOpenTime | string | 首次打开时间 |
| phoneRegisterTime | string | 手机号注册时间 |
| infoSubmitTime | string | 信息提交时间 |
| isFirstOpenPhoneRegistered | bool | 首次打开完成手机号注册 |
| isFirstOpenInfoSubmitted | bool | 首次打开完成信息填写 |
| isPhoneRegisteredNotLost | bool | 手机号注册后未流失 |
| scanChannelId | int | 扫码渠道ID |
| scanChannelName | string | 扫码渠道名称 |
| telChannelId | int | 手机号注册渠道ID |
| telChannelName | string | 手机号注册渠道名称 |
| submitChannelId | int | 提交信息渠道ID |
| submitChannelName | string | 提交信息渠道名称 |

---

### 2.9 获取基础数据列表 `GET ?r=patient/base-data`

**说明**: 返回性别、年龄段、确诊状态、手术状态等枚举数据，供后台管理端渲染下拉选项。

**请求参数**: 无

**响应示例**:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "genderList": [{"1": "男"}, {"2": "女"}],
    "ageRangeList": [{"1": "18~28岁"}, {"2": "29~40岁"}, {"3": "41~50岁"}, {"4": "50岁以上"}],
    "diagnosisStatusList": [{"1": "疑似PSVT正在了解中"}, {"2": "已确诊PSVT"}, {"3": "心悸/心跳过快 尚未就诊"}, {"4": "亲友相关 想了解更多"}],
    "surgeryStatusList": [{"1": "已接收射频消融/相关手术"}, {"2": "尚未接收手术"}, {"3": "正在评估"}]
  }
}
```

**响应字段说明**:

| 字段名 | 类型 | 说明 |
|---|---|---|
| genderList | array | 性别列表，每项为 {value: "label"} |
| ageRangeList | array | 年龄段列表，每项为 {value: "label"} |
| diagnosisStatusList | array | 确诊状态列表，每项为 {value: "label"} |
| surgeryStatusList | array | 手术状态列表，每项为 {value: "label"} |

---