补习社crm管理系统产品系统

本项目立项源于补习社在多校区运营中，学生报名、排课、收费、课时消耗和家校信息分散管理的问题。系统面向课外培训机构的教务与CRM业务场景，支撑学生建档、家长维护、课程班级管理、报名缴费、课表排课、记上课、课时/学费统计及调课等流程，帮助机构提升教务协同效率和经营管理精度。

1.机构与基础资料管理：支持维护校区、教室、员工、年级、学期、学科、班级等基础信息，为后续排课、报名、统计和教务管理提供统一的数据基础。

2.学生与家长信息管理：支持建立学生档案，记录学生姓名、联系方式、所属校区、学习状态、来源渠道等信息，同时维护家长联系人资料，方便机构进行学员跟进和家校沟通。

3.学生报名与收费管理：支持学生选择课程班级进行报名，生成报名订单，记录收费方式、优惠金额、实付金额、支付状态、开始上课日期等信息，并支持未支付、已支付、部分支付等业务状态管理。

4.排课与课表管理：支持按校区、教室、教师、课程和班级进行排课，提供按周、按天查看课表的能力，并根据学生开始上课日期统计实际班级人数，方便教务人员安排课程资源。

5.记上课与报读管理：支持记录学生上课情况，扣减课时或统计已用天数，并在报读列表中展示学生课程、班级、剩余课时、剩余学费、支付状态等信息，同时支持调换课等后续教务处理。

1.我主要负责本项目所有模块的前后端模块实现与功能优化。项目采用前后端分离架构，前端基于 Vue3、Element Plus 实现业务页面和表格交互，后端基于 Spring Boot、MyBatis、MySQL 完成接口开发与数据查询。
2.技术实现亮点:
2.1 报名业务采用“订单主表 + 报名明细表”的设计，一个订单可以包含多个课程明细，每个明细独立记录课程、收费方式、课时数量、优惠金额、支付状态、开始上课日期等信息，能支撑多课程报名、部分支付、分批支付等复杂教务场景。
2.2 支付逻辑支持组合支付、余额支付、超额转余额和部分支付。后端通过事务控制订单、支付记录、学生账户余额、账户流水、明细支付状态等多张表的一致性，保证收费业务的完整性。
2.3 报读列表以报名明细为粒度展示，而不是只按订单展示，可以准确呈现学生每一门课程的报读状态、支付状态、剩余课时、剩余学费和开始上课日期，更贴合补习社实际管理方式。
2.4 课表模块支持按周、按天两种视图，并通过 SQL 动态生成周内课程日期，同时结合排课日期、星期、学生开始上课日期、订单状态等条件计算班级人数和学生名单，实现课表数据与报名数据联动。
3.技术实现难点
3.1 订单状态和课程明细状态容易混淆。订单有待支付、已支付、部分支付、作废等状态，课程明细又有独立支付状态，因此实付金额、报读状态、支付状态必须按不同业务口径分别计算，不能简单用订单状态代替课程状态。
3.2 报读列表的数据口径较复杂。系统既要让未付款报名立即出现在报读列表，又要排除已作废订单，还要支持按剩余课时、剩余天数、支付状态和报读状态筛选，对 SQL 条件和后端派生字段计算要求较高。
3.3 课时和学费剩余计算存在多种收费模式。按课时收费需要根据上课记录扣减课时，按周期/天数收费需要根据日期计算剩余天数，同时还要按剩余比例计算剩余学费，业务规则较细。