122 lines
2.6 KiB
Markdown
122 lines
2.6 KiB
Markdown
# 小程序二维码功能 - 快速开始
|
||
|
||
## 🚀 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，提升性能
|
||
- 🔄 支持重新生成
|
||
- 📝 详细的日志记录
|
||
- 🛡️ 完善的错误处理
|
||
- 🔧 提供调试工具
|
||
|
||
---
|
||
|
||
**祝使用愉快！** 🎉
|