徽章商城系统 – 完整使用说明书

🗄️ 核心数据表

📊 wp_medalshop_records (购买记录表)
   ├── id: 记录ID (主键)
   ├── user_id: 用户ID
   ├── medal_name: 徽章名称
   ├── price: 原价
   ├── discount: 折扣金额
   ├── final_price: 实际支付价
   ├── order_num: 订单号
   ├── purchase_time: 购买时间
   ├── status: 状态 (completed/refunded)
   └── meta: 元数据 (JSON格式)

📈 wp_medalshop_stats (统计表)
├── id: 统计ID (主键)
├── medal_name: 徽章名称 (唯一索引)
├── total_sales: 总销量
├── total_revenue: 总收入
├── today_sales: 今日销量
├── weekly_sales: 本周销量
├── monthly_sales: 本月销量
├── last_purchase: 最后购买时间
└── update_time: 更新时间

🔒 wp_medalshop_limits (购买限制表)
├── id: 限制ID (主键)
├── user_id: 用户ID
├── date: 日期
├── daily_count: 当日购买次数
├── weekly_count: 本周购买次数
└── last_purchase_date: 最后购买日期

🔄 完整的购买流程

1. 用户进入商城
   • 通过用户中心进入徽章商城
   • 查看余额和购买限制信息
2. 浏览徽章列表
   • 查看所有可购买徽章
   • 支持搜索和筛选功能
   • 显示徽章价格和折扣信息
3. 选择购买徽章
   • 点击徽章购买按钮
   • 系统检查用户余额和购买限制
   • 显示购买确认对话框
4. 执行购买操作
   • 扣除用户余额
   • 添加徽章到用户账户
   • 记录购买信息到数据库
   • 更新销售统计数据
5. 购买完成反馈
   • 显示购买成功提示
   • 发送站内通知消息
   • 刷新余额和徽章列表
   • 可选自动佩戴功能

🏪 徽章商城主面板

🛍️ 徽章购买页面

🏆 我的徽章管理

📊 销售统计分析

🏆 热销排行榜

⚙️ 商城配置管理

🔌 AJAX接口设计

💾 购买事务处理

1. 开始数据库事务
   └── $wpdb->query('START TRANSACTION')

2. 验证用户余额
   ├── 获取当前余额
   ├── 计算最终价格
   └── 验证余额是否充足

3. 扣除用户余额
   ├── 调用主题余额扣除函数
   └── 验证扣除结果

4. 添加徽章到用户账户
   ├── 调用主题徽章添加函数
   └── 验证添加结果

5. 记录购买信息
   ├── 插入购买记录表
   └── 生成唯一订单号

6. 更新统计信息
   ├── 更新徽章销售统计
   └── 更新热门徽章缓存

7. 更新购买限制
   ├── 更新日购买次数
   └── 更新周购买次数

8. 发送通知（异步）
   ├── 发送站内信通知
   └── 记录通知日志

9. 提交事务
   └── $wpdb->query('COMMIT')

10. 清理缓存
    ├── 清除徽章缓存
    └── 清除统计缓存

11. 返回成功响应
    ├── 返回购买结果
    └── 更新前端界面

12. 异常处理流程
    └── 回滚事务并返回错误信息

⚡ 性能优化指南

🔧 常见问题解决

🆘 技术支持与反馈

【问题报告】

插件版本：2.0.4
主题版本：[填写]
WordPress版本：[填写]
PHP版本：[填写]

问题描述：
[详细描述遇到的问题]

重现步骤：

1. 
2. 
3. 

错误信息：
[截图或错误日志]

系统信息：
[服务器环境信息]

联系方式：
[您的邮箱或联系方式]

🎉 开始使用Zibll徽章商城系统

创建徽章经济生态，提升用户互动与留存！

版本：2.0.4 | 作者：请叫我阿祖 | 专业的徽章商城系统