zyt/QRCODE_QUICK_START.md

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

🚀 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错误

解决：运行清除缓存脚本

cd server
php clear_wx_token_cache.php

问题3：二维码无法显示

解决：检查uploads目录权限

chmod -R 755 server/public/uploads

问题4：扫码后无法跳转

解决：确认小程序中存在页面 pages/order/monad/monad

---

📋 检查清单

使用前请确认：

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

---

🔧 常用命令

清除AccessToken缓存

cd server
php clear_wx_token_cache.php

查看日志

tail -f server/runtime/log/$(date +%Y%m%d).log

清除所有缓存

rm -rf server/runtime/cache/*

检查PHP语法

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，提升性能
• 🔄 支持重新生成
• 📝 详细的日志记录
• 🛡️ 完善的错误处理
• 🔧 提供调试工具

---

祝使用愉快！ 🎉