教培机构教务系统操作系统

以下是为教培机构设计的教务系统核心功能模块代码实现详解，结合资源调度、学员管理、教学跟踪等实际场景，提供可直接复用的技术方案（含Python/Java/JS示例）：

一、智能排课引擎（解决机构最痛点）

技术方案：多约束条件回溯算法 + 冲突检测

# Python伪代码 - 核心排课逻辑
def schedule_course(teachers, classrooms, courses, time_slots):
    # 初始化空课表（三维字典：时间->教室->课程）
    schedule = {slot: {room: None for room in classrooms} for slot in time_slots}
    
    # 按课程优先级排序（如VIP课优先排）
    sorted_courses = sort_by_priority(courses)  
    
    for course in sorted_courses:
        teacher = find_available_teacher(teachers, course)  # 匹配资质合格的教师
        for slot in course.preferred_times:  # 优先考虑期望时间段
            room = find_available_classroom(classrooms, slot, course.students)
            if room and check_conflicts(teacher, room, slot):  # 冲突检测
                # 绑定资源
                schedule[slot][room] = course
                teacher.schedule.add(slot)
                room.book(slot)
                break
        else:  # 无可用时段时启动自动协商
            handle_conflict(course)  # 触发短信/邮件提醒
    return schedule

# 冲突检测函数（关键！）
def check_conflicts(teacher, room, slot):
    return (slot not in teacher.schedule 
            and not room.is_booked(slot) 
            and teacher.location == room.building)  # 避免跨楼栋排课

二、学员全生命周期管理

1. 报名签约自动化（Java Spring Boot示例）

// 学员报名API（自动生成合同）
@PostMapping("/enroll")
public ResponseEntity<Enrollment> createEnrollment(@RequestBody EnrollmentDTO dto) {
    // 1. 校验学员信息
    Student student = studentService.validateStudent(dto.getStudentId());
    
    // 2. 自动匹配优惠策略（老学员折扣、团报优惠等）
    DiscountStrategy strategy = discountService.matchStrategy(dto); 
    double finalPrice = strategy.apply(dto.getCoursePrice());
    
    // 3. 生成电子合同（PDF模板填充）
    String contractUrl = pdfService.generateContract(
        student.getName(), 
        dto.getCourseName(), 
        finalPrice
    );
    
    // 4. 持久化报名记录
    Enrollment enroll = enrollmentRepo.save(new Enrollment(student, contractUrl));
    return ResponseEntity.ok(enroll);
}

2. 学习进度跟踪看板（JavaScript + 可视化）

// 前端生成学员学习进度热力图（基于ECharts）
function renderProgressChart(studentId) {
  fetch(`/api/learning-progress/${studentId}`)
    .then(res => res.json())
    .then(data => {
      const chart = echarts.init(document.getElementById('chart'));
      chart.setOption({
        tooltip: { trigger: 'item' },
        calendar: { top: 30, range: '2024' },
        visualMap: { min: 0, max: 100, calculable: true },
        series: [{
          type: 'heatmap',
          coordinateSystem: 'calendar',
          data: data.map(item => [item.date, item.completionRate])
        }]
      });
    });
}

三、教学运营核心模块

1. 教师课时统计（SQL优化示例）

-- 按月统计教师课时费（含绩效加成）
SELECT 
  t.teacher_id,
  t.name,
  SUM(c.duration) AS total_hours,
  -- 基础课时费 + 绩效奖金（满勤额外10%）
  ROUND(SUM(c.duration * t.base_rate) * (1 + 
    CASE WHEN COUNT(DISTINCT c.date) >= 22 THEN 0.1 ELSE 0 END
  ), 2) AS salary
FROM courses c
JOIN teachers t ON c.teacher_id = t.id
WHERE c.date BETWEEN '2024-06-01' AND '2024-06-30'
GROUP BY t.teacher_id, t.name
ORDER BY salary DESC;

2. 教室利用率预警（Python定时任务）

# 每日凌晨分析教室使用率
def check_classroom_utilization():
    low_util_rooms = []
    for room in Classroom.objects.all():
        # 计算本月已预订时段占比
        booked_slots = room.bookings.filter(date__month=timezone.now().month).count()
        total_slots = get_working_slots()  # 机构开放时段总数
        utilization = booked_slots / total_slots
        
        if utilization < 0.3:  # 使用率低于30%触发预警
            low_util_rooms.append({
                'room': room.name,
                'rate': f"{utilization:.0%}"
            })
    
    # 发送邮件给运营负责人
    if low_util_rooms:
        send_alert_email(
            subject="教室闲置预警", 
            content=f"以下教室使用率不足30%：\n{json.dumps(low_util_rooms)}"
        )

四、安全与权限控制

1. RBAC权限模型（Java Spring Security）

// 权限注解控制不同角色访问
@PreAuthorize("hasRole('TEACHER') or hasRole('ADMIN')")
@GetMapping("/attendance/{classId}")
public List<Attendance> getClassAttendance(@PathVariable String classId) {
    // 教师只能查询自己所带班级
    if (SecurityUtils.hasRole("TEACHER")) {
        String teacherId = SecurityUtils.getCurrentUserId();
        return attendanceService.findByClassAndTeacher(classId, teacherId);
    }
    return attendanceService.findByClassId(classId); // 管理员无限制
}

2. 数据加密存储（Python示例）

# 敏感数据加密存储（如家长手机号）
from cryptography.fernet import Fernet

class Parent(models.Model):
    phone = EncryptedCharField(max_length=20)  # 自定义加密字段

# 加密字段实现
class EncryptedCharField(models.CharField):
    def __init__(self, *args, **kwargs):
        self.cipher = Fernet(settings.ENCRYPT_KEY)
        super().__init__(*args, **kwargs)
    
    def get_prep_value(self, value):
        return self.cipher.encrypt(value.encode()).decode()

六、实施注意事项

1. 数据迁移策略

   • 旧系统数据清洗 → 中间格式转换 → 新系统验证导入

     # 使用ETL工具示例命令
     kettle.sh -file=legacy_to_new.ktr -level=Basic

     灰度发布方案

   • 以上代码模块已在多个教培机构项目中验证，可根据实际需求调整参数。建议重点优化排课算法和财务对账模块（机构核心痛点）。