# 小程序后端接口配置完成

## 已创建的文件

### 1. 控制器
`server/app/api/controller/TcmController.php`

```php
<?php
namespace app\api\controller;

use app\adminapi\logic\tcm\DiagnosisLogic;

class TcmController extends BaseApiController
{
    public function getPatientSignature()
    {
        $patientId = $this->request->get('patient_id');
        
        if (!$patientId) {
            return $this->fail('患者ID不能为空');
        }
        
        $result = DiagnosisLogic::getPatientSignature($patientId);
        
        if ($result === false) {
            return $this->fail(DiagnosisLogic::getError());
        }
        
        return $this->data($result);
    }
}
```

### 2. 逻辑层方法
已在 `server/app/adminapi/logic/tcm/DiagnosisLogic.php` 中添加：

```php
public static function getPatientSignature(int $patientId)
{
    // 生成患者的 UserSig
    // 返回 sdkAppId, userId, userSig
}
```

## API 接口信息

### 接口地址
```
GET /api/tcm/getPatientSignature
```

### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| patient_id | int | 是 | 患者ID |

### 请求示例
```
GET http://your-domain.com/api/tcm/getPatientSignature?patient_id=2
```

### 响应示例

**成功响应：**
```json
{
  "code": 1,
  "msg": "success",
  "data": {
    "sdkAppId": 1400123456,
    "userId": "patient_2",
    "userSig": "eJwtzMsKgj...",
    "expireTime": 86400
  }
}
```

**失败响应：**
```json
{
  "code": 0,
  "msg": "患者ID不能为空",
  "data": []
}
```

## 小程序端配置

### 修改 API 地址

在 `wx/TUICallKit/pages/call.vue` 中，修改第47行：

```javascript
// 开发环境
url: 'http://localhost:8000/api/tcm/getPatientSignature',

// 或生产环境
url: 'https://your-domain.com/api/tcm/getPatientSignature',
```

### 完整的小程序端代码

```javascript
// 从后端获取签名
const getSignatureFromServer = async (patientId) => {
  return new Promise((resolve, reject) => {
    uni.request({
      url: 'http://your-domain.com/api/tcm/getPatientSignature',
      method: 'GET',
      data: {
        patient_id: patientId
      },
      success: (res) => {
        if (res.data && res.data.code === 1) {
          resolve(res.data.data);
        } else {
          reject(new Error(res.data.msg || '获取签名失败'));
        }
      },
      fail: (err) => {
        reject(err);
      }
    });
  });
};
```

## 测试步骤

### 1. 测试后端接口

使用浏览器或 Postman 测试：

```
http://localhost:8000/api/tcm/getPatientSignature?patient_id=2
```

**预期响应：**
```json
{
  "code": 1,
  "msg": "success",
  "data": {
    "sdkAppId": 1400xxx,
    "userId": "patient_2",
    "userSig": "xxx...",
    "expireTime": 86400
  }
}
```

### 2. 测试小程序端登录

1. 打开微信开发者工具
2. 打开小程序项目
3. 进入通话页面
4. 输入患者ID: `2`
5. 点击"登录"按钮
6. 查看控制台日志

**预期日志：**
```
获取签名成功: { sdkAppId: xxx, userId: 'patient_2', userSig: 'xxx' }
TUICallKit 初始化成功, userId: patient_2
```

### 3. 测试 Web 端呼叫小程序

1. 确保小程序端已登录（患者ID: 2）
2. 在 Web 端医生后台，找到患者ID为2的诊单
3. 点击"视频通话"按钮
4. 小程序端应该收到来电通知

## 常见问题

### 问题1: 接口404

**症状：**
```
GET http://localhost:8000/api/tcm/getPatientSignature?patient_id=2
404 Not Found
```

**解决方案：**
1. 检查控制器文件是否存在：`server/app/api/controller/TcmController.php`
2. 检查命名空间是否正确：`namespace app\api\controller;`
3. 清除缓存：`php think clear`
4. 重启服务器

### 问题2: 获取签名失败

**症状：**
```json
{
  "code": 0,
  "msg": "请先配置腾讯云TRTC参数",
  "data": []
}
```

**解决方案：**
在后台配置腾讯云 TRTC 参数（SDKAppID 和 SecretKey）

### 问题3: 跨域问题

**症状：**
```
Access to XMLHttpRequest at 'http://localhost:8000/api/tcm/getPatientSignature' 
from origin 'http://localhost:5173' has been blocked by CORS policy
```

**解决方案：**
在后端配置 CORS 允许跨域访问

### 问题4: 小程序请求失败

**症状：**
```
request:fail url not in domain list
```

**解决方案：**
1. 在微信公众平台配置服务器域名
2. 或在微信开发者工具中勾选"不校验合法域名"

## 完整流程图

```
小程序端                    后端服务器                    Web端
   |                           |                           |
   |-- 1. 输入患者ID: 2         |                           |
   |                           |                           |
   |-- 2. 请求签名 ------------>|                           |
   |   GET /api/tcm/           |                           |
   |   getPatientSignature     |                           |
   |   ?patient_id=2           |                           |
   |                           |                           |
   |                           |-- 3. 生成 UserSig         |
   |                           |   userId: patient_2       |
   |                           |                           |
   |<-- 4. 返回签名 ------------|                           |
   |   { userId: patient_2,    |                           |
   |     userSig: xxx }        |                           |
   |                           |                           |
   |-- 5. 初始化 TUICallKit     |                           |
   |   登录 IM                  |                           |
   |                           |                           |
   |-- 6. 保持在线              |                           |
   |                           |                           |
   |                           |                           |-- 7. 医生点击"视频通话"
   |                           |                           |
   |                           |<-- 8. 请求签名 -----------|
   |                           |   POST /adminapi/tcm.     |
   |                           |   diagnosis/              |
   |                           |   getCallSignature        |
   |                           |                           |
   |                           |-- 9. 返回签名 ----------->|
   |                           |   { patientUserId:        |
   |                           |     patient_2 }           |
   |                           |                           |
   |                           |                           |-- 10. 发起通话
   |                           |                           |    目标: patient_2
   |                           |                           |
   |<-- 11. 收到来电 ------------------------------------ IM服务器
   |                           |                           |
   |-- 12. 接听/拒绝            |                           |
   |                           |                           |
```

## 下一步

1. ✅ 后端接口已创建
2. ✅ 逻辑层方法已添加
3. ⏳ 修改小程序端 API 地址
4. ⏳ 测试后端接口
5. ⏳ 测试小程序端登录
6. ⏳ 测试 Web 端呼叫小程序

## 注意事项

1. **API 地址**：根据实际部署环境修改
2. **跨域配置**：如果小程序和后端不在同一域名，需要配置 CORS
3. **HTTPS**：生产环境必须使用 HTTPS
4. **域名白名单**：小程序需要在微信公众平台配置服务器域名
5. **日志记录**：已添加详细日志，方便调试

## 相关文件

- 控制器：`server/app/api/controller/TcmController.php`
- 逻辑层：`server/app/adminapi/logic/tcm/DiagnosisLogic.php`
- 小程序端：`wx/TUICallKit/pages/call.vue`
- 配置指南：`MINIPROGRAM_SETUP_GUIDE.md`