This commit is contained in:
Your Name
2026-03-06 14:27:24 +08:00
parent 9a1b67ca18
commit 52bb80e2f1
134 changed files with 5337 additions and 401 deletions
+121
View File
@@ -0,0 +1,121 @@
# 小程序二维码功能 - 快速开始
## 🚀 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,提升性能
- 🔄 支持重新生成
- 📝 详细的日志记录
- 🛡️ 完善的错误处理
- 🔧 提供调试工具
---
**祝使用愉快!** 🎉