广西电信智慧客服

**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 只返回首行导致统计失真的隐蔽缺陷；小程序端日历、底部弹层学员选择器等复杂交互的性能与体验平衡。