**行业背景**:随着传统文化复兴与"双减"政策落地,书法教育成为素质教培的热门赛道,线下书法培训机构数量快速增长。但多数中小机构仍依赖纸质登记和微信群管理,排课混乱、课时统计易错、家校沟通低效,数字化工具需求迫切。同时,咖啡社交空间与书法体验结合的"新中式"业态兴起,为教学、练习、社交一体化平台提供了天然场景。
点击空白处退出提示
**行业背景**:随着传统文化复兴与"双减"政策落地,书法教育成为素质教培的热门赛道,线下书法培训机构数量快速增长。但多数中小机构仍依赖纸质登记和微信群管理,排课混乱、课时统计易错、家校沟通低效,数字化工具需求迫切。同时,咖啡社交空间与书法体验结合的"新中式"业态兴起,为教学、练习、社交一体化平台提供了天然场景。
**咖啡书法社区**是一个融合咖啡社交与书法教育的综合性平台,包含 Web 管理端和微信小程序(学员端 + 教师工作台)。核心功能涵盖:书法课程管理与排课(单日/周期批量)、学员预约与课时卡管理、上课点名考勤(签到/请假/缺勤)、作业发布与批改点评、班级群组与学习打卡、学习报告生成发布、体验课预约转化、积分等级体系(签到/发帖激励)、作品社区互动(发帖/评论/点赞)以及咖啡商品商城。教师可通过工作台一站式完成排课、点名、批改、课时预警等教务工作,管理员通过 Web 端进行用户、课程、公告、数据的全方位运营管理。
**1、"我"负责的具体任务**
我主要负责书法教务模块的全栈开发:小程序教师工作台整体设计与实现(工作台入口化改造、教务宫格导航、教师统计卡片);学员管理(学生列表、添加学生、课时充值与课时预警);排课系统(单日排课、日历视图、周期批量排课的小程序端与 Web 端实现);上课考勤(今日课表、点名签到/请假/缺勤/课时结算、向排课中添加学员);作业批改列表;班级打卡后端补全与统计页;体验课预约处理与学习报告发布;以及 Web 端首页快捷入口改造、课时记录联动跳转、工作台统计口径修正等配套后端接口开发。
**2、技术栈、架构与亮点难点**
技术栈与架构:后端基于 RuoYi-Vue-Plus(Spring Boot 3.5 + Java 17 + MyBatis-Plus + Sa-Token)多模块架构,MySQL 8 + Redis + OSS 对象存储;Web 管理端 Vue 3 + Element Plus + Vite + TypeScript;微信小程序 uni-app。架构上坚持小程序与 Web 端复用同一套后端业务接口,教师端专属接口按角色隔离,降低维护成本。
亮点:课时/库存全部采用原子 SQL 更新防止超卖与并发错账;积分与奖励按业务三元组幂等;课时卡与学员账户双向同步;支付回调显式激活课时卡、退款自动恢复商品上架,保证资金链路闭环;班级打卡在汇总表半成品的情况下改为成员表实时关联统计,零脏数据上线。
难点:周期批量排课的冲突检测(学员、教师、教室三维度时间重叠校验与结果回执);考勤状态机流转与课时扣退的一致性(请假退课时、完成才结算);修复 MyBatis-Plus selectCount 配合 groupBy 只返回首行导致统计失真的隐蔽缺陷;小程序端日历、底部弹层学员选择器等复杂交互的性能与体验平衡。



评论