书法产品系统Vibe Coding

面向书法教育培训机构的家校协同小程序，打通「机构—老师—家长」三方：

机构/老师侧：管理在读学员、记录学习成长、发布点评与投票、推送课程/试听提醒、展示师资。
家长侧：绑定孩子、查看积分与点评（含视频）、接收消息通知、预约试听、参与班级投票。
核心痛点：传统书法培训家校沟通靠微信群，学员成长记录分散、试听转化无数据、课程与通知无沉淀。小程序把"点评—积分—课程—消息"统一到一个可信载体，并保留全量可回溯数据。

学员档案与绑定（家长绑定学员、归属校验）
积分体系：账本、批量加分（≤50 人幂等）、冲正（反向流水+原子守卫+幂等）
点评：文字 + 图片，M8 起支持视频双栏播放（N1 规划增强为"点评直接传视频+图片"）
试听预约（家长申请 / 老师管理）
师资展示（师资列表，N3 规划升级为单份 PDF 师资介绍）
课程设置 / 我的课程（多学员切换、在读班级卡）
消息中心 + 微信订阅消息（站内信 + 额度制 + 降级，TRIAL 已拆独立模板）
数据埋点（M13：周活跃家长、绑定率、视频观看率、点评覆盖率、试听转化，旁路不阻断）
每个字生成 二维码视频

前端：原生微信小程序（WXML + WXSS + JavaScript，非 Taro/uni-app），miniprogram/ 下 pages/ 为家长端、packageTeacher/ 为老师分包。
后端：腾讯云开发云函数（Node.js，CommonJS）​，cloudfunctions/api/ 按业务拆 modules/（comment、points、notice、trial、teacher、student、enroll、analytics、video…）。
数据层：云开发文档型数据库（NoSQL）​，无自建服务器；集合与索引由 scripts/cloud-init.js 声明初始化。
关键设计

鉴权与越权防护：wx-server-sdk 取 OPENID，guard/assertStudentAccess 做归属校验（家长只能看自己孩子）。
数据一致性：applyBalanceDelta 乐观锁 + 流水 + 软删除（deletedAt）；批量/冲正逐人幂等（batchKey/requestId）。
工程约束（技术约定）：返回统一 {list,total}、文档即契约、跳转路径规范（CI 强制校验）、错误码规范。
测试基建：scripts/_mock.js（内存 DB mock，已做深拷贝并发升级）+ test-*.js 套件 + verify-project.js 全量门禁（669 项断言 0 失败，含财务不变量与跳转校验）。
里程碑：M4 积分 → M6 师资 → M8 视频 → M10 积分增强(批量/冲正) → M11 消息订阅 → M12 设置/我的课程 → M13 埋点 → M14 投票(规划)。