如约产品系统Vibe Coding

钢琴等艺术类培训机构，普遍还在用「微信群 + 纸质签到 + Excel 记课时」管理排课与课消：家长约课要在微信里找教务一对一协调，上课靠手写签到，剩余课时靠人工核算。一旦账对不上，家长会质疑"是不是多扣了"，前台只能一遍遍翻记录解释。

这类机构规模小、没有预算上大型教务系统，但课时纠纷和排课冲突是每天都在发生的事。本项目面向按课时收费的中小机构（器乐、美术、体育、瑜伽等），把「排课—约课—消课—课时流水」这条链路做成一套家长能自助操作、教师能一键消课的轻量小程序。

面向家长/成人学员端与教师端，共 23 个页面。

【家长端 18 页】机构落地页、微信一键登录、绑定与切换学员、选教师、可约时段池（可约/已被约/已满/不可约四种状态）、预约确认（三口径课时展示）、订阅提醒授权、预约成功、我的课表（周视图 + 月视图）、课次详情、请假与改期（实时计算是否扣课时）、我的课时（流水时间轴）、消息中心、我的。

【教师端 5 页】今日课表、消课确认（小组课逐个点名，未勾选按爽约处理）、周课表矩阵、我的学员、教师中心。

【核心模块】时段发布、教师+琴房双资源冲突校验、预约占用、消课扣减、课时流水（只增不改不删，修正以反向流水冲正）、缴费登记（线下登记，不接线上支付）。

独立完成需求梳理、信息架构、视觉设计到小程序开发的全过程。

【技术栈】微信小程序原生（WXML / WXSS / JavaScript）+ TDesign MiniProgram 组件库。用一份设计 Token（色板 / 字号 / 间距 / 圆角 / 阴影）通过 CSS 变量把组件库主题整体覆盖为深墨绿配色，保证 23 个页面视觉一致；数据层封装为独立 Mock 模块，页面只依赖 5 个数据方法，后续替换为 Go + MySQL 接口时页面代码无需改动。

【难点与取舍】
1. 教师 + 琴房双资源占用：时段必须两方同时空闲才放出，已被约 / 教师休息 / 琴房占用三种情况直接置灰不可点，从源头避免"两个人约到同一间琴房"。
2. 课时流水不可变：任何修正都追加一条反向流水，不修改原始记录，谁改的、几点改的全程留痕。
3. 课时口径拆分：把「已预约只占用、上课才扣减」做成三口径展示（本次占用 / 当前剩余 / 预约后剩余），从源头减少家长对账纠纷。
4. 主动砍掉线上支付与直播：改为线下缴费登记，降低资质与实现复杂度，把精力集中在排课与课消主链路。