立项原因与业务背景：培训机构的日常运营涉及校长、教务、财务、教师、学生及家长。随着班级和校区增加，依赖 Excel、纸质签到与群消息的管理方式，容易出现信息分散、更新不及时、排课冲突和月底对账困难。因此，项目围绕“课程售卖到教学交付”的完整流程建设统一平台。
解决的问题与应用场景：教务通过系统安排教师、教室和班级课次；学生报名后冻结对应课时，上课有效签到后完成消课；财务依据课时流水处理退款，教师依据已完成课次核对课酬。总部和校区人员按各自权限处理业务，减少重复录入和跨岗位反复核对。
例如，学生购买英语课时并报名某个班级后，家长可在手机端查看课表，教师完成签到和课后点评，后台同步记录课时消耗与课酬明细，形成可追踪的教学服务记录。
功能模块 主要功能
工作台 集中展示今日课次、排课冲突、签到异常、待审退款和本月课酬等信息。
基础资料 管理校区、教室、课节、课程、班级、学生和教师，维护机构业务基础数据。
排课中心 提供周课表及教师、班级、教室、直播间视图，支持排课、调课和资源冲突提示。
签到消课 记录师生签到，校验签到时间和位置，支持异常复核、补签及课时消耗。
财务中心 管理充值订单、课时账户、购课批次、课时流水、退款试算及审核处理。
绩效工资 根据课次完成情况与教师有效签到生成课酬明细，支持查看和结算。
直播课堂 管理直播场次、参与记录、观看达标判断及回放归档等教务业务。
学生移动端 提供选课报名、课表查询、签到、消息、课时账户和课后心得等功能。
教师移动端 提供今日课程、个人课表、签到、课件、学生点评和课酬查询。
权限与智能服务 管理账号、角色和数据范围，提供 IM 沟通及带工具调用、审计能力的 AI 助手。
个人职责示例：
“我主要负责项目的业务流程梳理、数据库设计、前后端核心功能开发及接口联调。前端完成管理后台和师生移动端页面，后端实现报名冻结课时、签到消课、退款审核与课酬结算等核心业务，同时编写业务规则测试和端到端测试，验证主要流程。”
技术架构：
系统采用“React 前端 → REST API → Spring Boot 业务服务 → MySQL”的分层架构。后端以模块化单体组织代码，分别处理查询、课时、考勤、退款、直播、IM 和 AI 助手等业务；通过 JdbcTemplate 访问数据库，使用事务组织关键写操作，并通过 Flyway 维护数据库版本，而非采用微服务架构。
实现难点一：课时与财务状态的一致性。
同一笔课时需要经历可用、报名冻结、上课消耗和退款锁定等状态，不同购买批次还可能对应不同单价。项目通过课时账户、购课批次、报名记录及流水关联业务，结合事务、状态校验和幂等记录处理关键操作；退款按批次 FIFO 试算金额，使课时变化和退款依据能够追溯。
实现难点二：签到、消课与课酬的业务联动。
签到记录不能直接等同于完成教学，需要区分正常签到、异常签到、补签和缺勤。系统在消课前校验教师有效签到，再按学生有效到课情况处理冻结课时，并关联生成教师课酬，将考勤事实、课时扣减与工资核算连接起来。
评论