漫格智能台球系统
========================================
漫格智能台球系统 · 功能介绍
========================================
技术栈：ThinkPHP 8.3 + UniApp 3.x + MySQL 5.7 + LayAdmin
端覆盖：微信小程序 · 微信公众号 · H5 网页 · 后台管理
售后保障：7×12 技术客服 · 1 年免费 Bug 修复 · 终身功能升级 · 完整部署文档
========================================
01 · 门店管理
========================================
1. 门店添加与审核：后台直接新增 / 加盟商家自助提交入驻，含资质、坐标、营业时间、设施标签
2. 审核状态机：待审核 → 已通过 / 已驳回 / 已停业 / 恢复营业，完整状态流转
3. 门店分类体系：台球 / 棋牌 / 电竞 / 乒乓球 / 羽毛球 / KTV / 剧本杀 / 健身
4. 桌位冗余统计：每个门店自动聚合桌位总数 / 使用中 / 空闲 / 预订
5. 地理位置与营业时间：经纬度坐标 + 每周营业时段配置，小程序自动匹配附近门店
========================================
02 · 桌台管理
========================================
1. 桌位定义：桌号 / 类型（中式台/斯诺克/9球台/棋牌室）/ 区域 / 楼层 / 时价
2. 批量新增：弹窗一键批量创建 N 张桌位，快速初始化新门店
3. 实时状态看板：卡片式布局 + 60 秒自动刷新；5 种颜色区分空闲/使用中/预订/维护/下线
4. 桌位会话生命周期：手动开台 / 暂停 / 恢复 / 结算，完整记录每次消费
5. 手动开台：后台一键发起会话，关联客户姓名/手机/人数/备注
6. 手动结算兜底：即使前端支付回调丢失，管理员可手动结算每个会话
========================================
03 · 会员卡与储值
========================================
1. 会员卡套餐：月卡 / 季卡 / 年卡灵活配置，原价 / 现价 / 天数 / 排序
2. 会员到期提醒：到期前 N 天自动提示续费
3. 多渠道登录：手机 / 邮箱 / QQ / 微信 / 华为，统一账号体系
4. 会员专属价：不同卡等级享受不同时价折扣
========================================
04 · 积分系统 + 签到
========================================
1. 积分流水：完整记录每次积分变动（签到/消费返/抽奖消耗/后台调整/邀请奖励）
2. 手动调整：管理员可给任意用户加/扣积分，事务安全写入流水
3. 每日签到：独立签到记录 + 唯一索引防重复 + 自动连续天数统计
4. 连续签到奖励：自定义第 N 天额外积分，提升留存
5. 首页聚合：今日发放 / 今日扣减 / 总余额 / 签到概览实时看板
========================================
05 · 优惠券管理
========================================
1. 优惠券模板：满减券 / 折扣券 / 体验券，三种类型灵活配置
2. 有效期三种模式：领后 N 天 / 固定时间段 / 永久有效
3. 批量发放：按 UID / 手机 / 邮箱批量发放，每人可多发几张
4. 注册自动奖励：新用户注册时自动发券
5. 防误删：已发放的模板禁止删除，只能禁用
========================================
06 · 订单管理
========================================
1. 完整订单字段：商品类型/原价/优惠/最终价/支付方式/支付流水号/核销状态/退款状态/时间戳
2. 多支付方式：微信支付 / 支付宝 / 银行卡
3. 订单状态流转：待支付 → 已支付 → 进行中 → 已完成，退款独立状态机
4. 转化率统计：订单数 / 支付率 / 金额趋势一键生成
5. 订单详情：完整联系人/扩展数据/IP/UserAgent/备注查看
========================================
07 · 核销管理
========================================
1. 核销员体系：独立账号，绑定所属门店，累计核销次数统计
2. 核销操作中心：输入码 → 自动校验 → 确认核销 → 写流水。支持扫码枪回车自动校验
3. 事务安全：核销用 DB 行锁防止并发，扣次数+写流水+自动开桌位会话一气呵成
4. 撤销核销：支持指定撤销次数（如一次核销 3 张券可只撤销 1 张），码恢复部分可用
5. 核销日志：完整流水（码号/核销员/门店/IP/时间），按日期范围筛选
========================================
08 · 活动赛事
========================================
1. 官方/用户双发布：管理员直接发布 / 加盟商家提交活动申请，完整审核流程
2. 5 种活动类型：线下活动 / 线上直播 / 门店专属 / 体验课 / 赛事
3. 完整时间校验：报名截止 < 活动开始 < 活动结束，三重约束
4. 报名管理：独立审核通过/驳回 · 批量审核 · 自动生成签到核销码 · 容量扣减（事务安全）
5. 签到核销闭环：报名审核 → 自动生成签到码 → 扫码签到 → 同步核销日志
========================================
09 · 战绩 & 排行榜
========================================
1. 对战记录：双方玩家 UID / 比分 / 胜者（自动判定）/ 比赛类型（8ball/9ball/snooker/free）/ 抢 N 局
2. 聚合排行榜：按胜场/胜率/净胜分/累计积分排序，前三名金/银/铜高亮
3. 打球日历：用户个人月度出勤/对战/积分数据可视化
4. 多维度筛选：按门店/桌台/玩家/日期范围/比赛类型筛选战绩
========================================
10 · 合伙人体系
========================================
1. 三级分销：普通合伙人 / 金牌 / 钻石，不同等级不同佣金率
2. 上下级邀请码：8 位大写邀请码自动生成，邀请下级合伙人
3. 门店绑定：合伙人可归属门店或挂靠门店，单独佣金率配置
4. 结算记录：每笔佣金快照（订单/比例/金额/状态），支持批量结算
5. 提现申请：合伙人发起提现 → 管理员审核 → 打款流水号 → 状态流转
========================================
11 · 抽奖管理
========================================
1. 抽奖活动：独立活动页，消耗积分 / 每日次数限制 / 时间范围控制
2. 4 种奖品类型：积分 / 实物 / 优惠券 / 谢谢参与
3. 概率权重：百分比精确配置（建议总和 100%），库存 0 = 无限
4. 自动发放：抽中积分自动入余额+写流水；抽中优惠券自动下发给用户
5. 中奖记录：完整核销状态（待发放/已发放/已兑换），可手动标记已发放
========================================
12 · 三级地址管理
========================================
1. 自关联结构：parent_id 逐级下钻，支持不限层级扩展（省→市→区→街道）
2. 联动下拉 API：取所有省 / 指定省的市 / 指定市的区，供编辑页联动选择
3. 初始数据：34 个省级行政区已预置，市/区可随时追加
========================================
13 · 用户管理
========================================
1. 多端登录：手机 / 邮箱 / QQ OpenID / 微信 OpenID / 华为 OpenID，一套系统多端无缝
2. VIP 状态追踪：会员到期时间实时计算，过期自动降级
3. 用户统计：今日新增/本周/本月/总数/VIP 数/积分余额聚合
4. 优惠券统计：直接跳转到某用户的优惠券视图
========================================
14 · 系统运维 & 售后
========================================
1. 渐变数据看板：16+ 张统计卡（门店/用户/订单/积分/核销/合伙人/活动/抽奖/签到/桌位）
2. 安全中间件：后台 Cookie 鉴权 + 移动端 Bearer Token 双通道，白名单放行登录/上传
3. 数据库备份 SQL：全量 ims_ 前缀表结构导出，一键恢复
4. 反馈管理：用户提交反馈 · 管理员回复 · 完整状态跟踪
5. 7×12 技术支持：1 年免费 Bug 修复 · 终身功能升级 · 完整部署文档
