# 小程序二维码功能 - 快速开始

## 🚀 5分钟快速上手

### 第一步：配置小程序信息

1. 登录后台管理系统
2. 导航到：**渠道设置** → **微信小程序设置**
3. 填写以下信息：
   - **AppID**（必填）：小程序的AppID
   - **AppSecret**（必填）：小程序的AppSecret
4. 点击**保存**

> 💡 提示：AppID和AppSecret可以在微信公众平台获取
> 登录 https://mp.weixin.qq.com → 开发 → 开发管理 → 开发设置

### 第二步：生成二维码

1. 进入：**中医管理** → **诊断管理**
2. 找到任意患者记录
3. 点击操作列的 **"小程序二维码"** 按钮
4. 等待生成（通常1-2秒）
5. 二维码显示在弹窗中

### 第三步：扫码测试

1. 使用微信扫描生成的二维码
2. 应该跳转到小程序的挂号页面
3. 页面会收到患者ID和分享用户ID参数

---

## ❓ 遇到问题？

### 问题1：提示"小程序未配置"
**解决**：检查是否已填写AppID和AppSecret

### 问题2：生成失败，提示AccessToken错误
**解决**：运行清除缓存脚本
```bash
cd server
php clear_wx_token_cache.php
```

### 问题3：二维码无法显示
**解决**：检查uploads目录权限
```bash
chmod -R 755 server/public/uploads
```

### 问题4：扫码后无法跳转
**解决**：确认小程序中存在页面 `pages/order/monad/monad`

---

## 📋 检查清单

使用前请确认：
- ✅ 已配置小程序AppID和AppSecret
- ✅ 服务器能访问 https://api.weixin.qq.com
- ✅ uploads目录有写入权限
- ✅ 小程序已发布或在体验版
- ✅ 小程序中存在对应页面

---

## 🔧 常用命令

### 清除AccessToken缓存
```bash
cd server
php clear_wx_token_cache.php
```

### 查看日志
```bash
tail -f server/runtime/log/$(date +%Y%m%d).log
```

### 清除所有缓存
```bash
rm -rf server/runtime/cache/*
```

### 检查PHP语法
```bash
php -l server/app/adminapi/logic/tcm/DiagnosisLogic.php
```

---

## 📚 更多文档

- **功能详解**：`MINI_PROGRAM_QRCODE_FEATURE.md`
- **测试指南**：`TEST_MINI_PROGRAM_QRCODE.md`
- **问题排查**：`QRCODE_DEBUG_GUIDE.md`
- **实现总结**：`QRCODE_IMPLEMENTATION_SUMMARY.md`

---

## 💬 技术支持

如果以上方法都无法解决问题：
1. 查看完整日志：`server/runtime/log/`
2. 参考调试指南：`QRCODE_DEBUG_GUIDE.md`
3. 检查微信公众平台的错误码文档

---

## ✨ 功能特点

- 🚀 快速生成，1-2秒完成
- 💾 自动缓存AccessToken，提升性能
- 🔄 支持重新生成
- 📝 详细的日志记录
- 🛡️ 完善的错误处理
- 🔧 提供调试工具

---

**祝使用愉快！** 🎉