
核心亮点
- 会员 / 教练 / 管理员三角色,管理员可双角色切换视角测试
- 场地预约按时段定价,工作日与周末、日/夜场自动区分
- 微信支付订阅与课时充值,余额与剩余课时实时对账
- 教练端排课日历 + 每周固定排课 + 一键扣课扣费
- 扫码签到考勤,数据分析看板覆盖营收 / 课时 / 学员增长
技术栈
产品界面
开发成果 13/13
- 项目立项,小程序基础框架与会员端页面
- 微信登录 + 云函数集成
- 数据库迁移至 CloudBase MySQL,重构为数据中心模式
- 场地预约(时段定价 / 一周内限制 / 场地图片)
- 微信支付集成与课程订阅消息提醒
- 优惠券体系(场地券 / 课程券 / 赠送)
- 教练端:排课日历、请假、学员管理、数据统计
- 管理端:场地/价格、教练、会员、活动、优惠券、用户管理
- 数据分析看板(营收 / 课时趋势 / 收入排行)
- 上线前安全加固与调试代码清理
- 云函数瘦身(dbOperation 695→241 行)与 rdb 迁移
- 扫码签到考勤系统
- 学员风采页与每周固定排课
开发历程 20 条
项目交付使用
- 竞标接单、支付订阅完成。
- 扫码签到、私教预约完成。
- 已交付上线。
users 表补 uk_phone 唯一索引
- 同一手机号被重复建档,导致会员课时对不上。
- users 表补 uk_phone 唯一索引。
- 重复注册被拦在写入前。
云函数 initCheckIn / fixSchema 配置完成
- 部署扫码签到依赖的云函数 initCheckIn / fixSchema。
- 同时修正表结构。
- 目的:避免首次签到写库失败。
扫码签到考勤系统 + 修复新用户登录失败
- 首页加扫码签到,直接 wx.scanCode,支持带参二维码与小程序码 scene,结果弹窗反馈。
- 教练排课页加签到,按日期切换已签到/迟到/缺勤,只写变化记录。
- 新增 check_in_records 表,含 user_date、coach_date、course 三个索引。
- 独立签到页多一步跳转,删掉改首页直调。
- 上线遇登录 1062:uk_phone 空串冲突,删索引改业务层保证唯一。
学员风采页 + 每周固定排课 + 自定义扣课
- 课程购买页下线,换成「学员风采」朋友圈式 feed:管理员传图/写备注/删除,点图全屏预览,新建 student_showcase 表。
- 教练排课支持每周固定:自动生成 8 周日期,进页自动补齐快过期排课;排课时间延到 22:00,补上 18:00-19:00。
- 低课时预警:≤4 课时的学员顶部黄条 + 名字红标。
- 一键扣课支持自定义课时与金额,默认沿用上次金额。
- 用户管理新增备注字段,学员名统一显示为「备注 原名」。
踩坑:数据分析营收统计口径错误 + 缓存损坏
- 数据分析营收/消课/购课大量为 0,四个根因。
- 统计只查 orders,收入在 expense_records、coach_bookings、venue_bookings。
- 缓存 stats_json 写入 [object Object],解析必失败;existing 把 {data,error} 当数组。
- 修复:口径汇总四个收入源,缓存先删同日同类再插,动画值与 target 拆开。
- expense_records.amount 语义混乱(课时数 vs 金额)的历史数据一并修正。
踩坑:场地价格管理页与预约页不一致(三个独立根因)
- 管理页与预约页价格不一致,挖出三个独立根因。
- UTC 日期:toISOString 取 UTC,东八区凌晨差一天,查不到当日价回退模板价。
- 时段名 23:00-00:00 对 23:00-24:00 匹配失败,DB 21 条统一 UPDATE。
- 会员 8 折双重误差:预约页 price*0.8、管理页原价;日期改本地格式化,onLoad 先定价再算会员价。
- 价格定稿:高级场工作日 100/150/100、周末 150/100;普通场 80/100/80、周末 120/80。
余额与课时数据源统一到 members 表
- 余额与课时口径分散在 users 与 members 两张表,同一会员在不同页面数字不一致。
- 统一改用 members 表读写 balance + remaining_hours,users 不再承载这两个字段。
- 连带修复:新增/编辑会员与学员打通,教练扣课时同步扣余额并写消费流水。
- 价格模板表与每日实例表必须同步改;教练-学员关联改 members.coach_id;价格统一会员 400/时、非会员 440/时。




