# SAE部署微信服务号（完整步骤）

> **预计用时**: 10-15分钟  
> **目标**: 将微信服务号功能部署到生产环境  
> **域名**: https://iit.xunzhengyixue.com

---

## 📋 Step 1: 在SAE配置环境变量（5分钟）

### 1.1 登录阿里云SAE控制台

访问：https://sae.console.aliyun.com/

### 1.2 进入应用配置

```
应用列表 → 选择应用 → 配置管理 → 环境变量
```

### 1.3 添加以下4个环境变量

点击 **"添加环境变量"**，逐个添加：

| 变量名 | 变量值 | 说明 |
|--------|--------|------|
| `WECHAT_MP_APP_ID` | `wx062568ff49e4570c` | 微信服务号AppID |
| `WECHAT_MP_APP_SECRET` | `c0d19435d1a1e948939c16d767ec0faf` | 微信服务号AppSecret |
| `WECHAT_MP_TOKEN` | `IitPatientWechat2026JanToken` | 回调Token |
| `WECHAT_MP_ENCODING_AES_KEY` | `VIzwMGRG4Ll8Sd7fPxPXLlBaWdsh2rK2qIGpyaEoc1v` | 消息加密密钥 |

### 1.4 保存配置

点击 **"保存"** 按钮

⚠️ **注意**：保存后需要重启应用才能生效

---

## 📋 Step 2: 部署代码到SAE（5-10分钟）

### 2.1 执行部署脚本

```powershell
cd D:\MyCursor\AIclinicalresearch\backend
.\deploy-to-sae.ps1
```

### 2.2 等待部署完成

部署过程大约需要5-10分钟，等待日志显示：

```
✅ 部署成功
应用状态: Running
实例数: 1
```

### 2.3 验证部署

访问健康检查接口：

```
https://iit.xunzhengyixue.com/api/v1/iit/health
```

**期望返回**：
```json
{
  "status": "ok",
  "module": "iit-manager",
  "version": "1.1.0"
}
```

---

## 📋 Step 3: 配置微信公众平台（3分钟）

### 3.1 登录微信公众平台

访问：https://mp.weixin.qq.com/

使用管理员微信扫码登录

### 3.2 进入服务器配置

```
左侧菜单 → 设置与开发 → 基本配置 → 服务器配置 → 修改配置
```

### 3.3 填写配置信息

| 配置项 | 值 |
|--------|-----|
| **URL** | `https://iit.xunzhengyixue.com/wechat/patient/callback` |
| **Token** | `IitPatientWechat2026JanToken` |
| **EncodingAESKey** | `VIzwMGRG4Ll8Sd7fPxPXLlBaWdsh2rK2qIGpyaEoc1v` |
| **消息加解密方式** | **安全模式（推荐）** |
| **数据格式** | **XML** |

### 3.4 提交验证

1. 点击 **"提交"** 按钮
2. 微信会发送GET请求到您的服务器验证
3. 应该显示 **"配置成功"**

### 3.5 启用配置

点击 **"启用"** 按钮

---

## 📋 Step 4: 验证功能（3分钟）

### 4.1 查看SAE日志

1. 登录阿里云SAE控制台
2. 应用管理 → 选择应用 → 实例管理
3. 点击 **"日志"** → **"实时日志"**

**期望看到**：
```
📥 收到微信服务号 URL 验证请求
✅ URL 验证成功，返回 echostr
```

### 4.2 测试关注事件

1. 用微信扫码关注公众号：**AI for 临床研究**
2. 查看SAE日志

**期望看到**：
```
📥 收到微信服务号回调消息
🔐 检测到加密消息，开始解密...
✅ 消息解密成功
🎯 处理事件消息: subscribe
👤 用户关注公众号: oXXXXXXX
```

### 4.3 测试文本消息

1. 在公众号对话框发送：**你好**
2. 查看SAE日志

**期望看到**：
```
📥 收到微信服务号回调消息
✅ 消息解密成功
💬 处理文本消息: 你好
📝 文本消息已记录
```

---

## ✅ 成功标志

- ✅ SAE环境变量配置完成
- ✅ 代码部署成功
- ✅ 健康检查接口返回正常
- ✅ 微信公众平台配置成功并启用
- ✅ 关注事件日志正常
- ✅ 文本消息日志正常

---

## 🎉 完成！

微信服务号已成功集成到IIT Manager Agent系统！

### 已实现功能

- ✅ URL验证（安全模式）
- ✅ 消息加解密
- ✅ 事件处理（关注/取消关注）
- ✅ 文本消息接收
- ✅ 模板消息推送（Service已就绪）
- ✅ 客服消息推送（Service已就绪）

### 后续开发

- [ ] 患者绑定功能（H5页面 + 数据表）
- [ ] 访视提醒定时任务
- [ ] 智能对话回复
- [ ] 微信小程序开发

---

## ⚠️ 重要提示

1. **环境变量**：修改后必须重启SAE应用
2. **日志查看**：通过SAE控制台实时日志查看
3. **域名**：生产环境使用 `iit.xunzhengyixue.com`
4. **Token和密钥**：不要泄露，不要提交到Git

---

## 📞 需要帮助？

- 查看SAE日志排查问题
- 检查环境变量配置
- 确认微信公众平台配置正确

---

**创建时间**: 2026-01-04  
**文档版本**: v1.0  
**状态**: 等待部署