开发手册

本文档面向二次开发人员，介绍有学教育智慧教育管理平台的技术架构、API 接口规范及扩展开发指南。

技术架构

技术栈

系统模块

• admin 服务：管理后台 API，端口 19093
• user 服务：小程序用户端 API
• 排课引擎：AI 排课算法与冲突检测
• 课堂服务：直播课堂信令与录制
• 学情分析模块：数据采集与知识图谱计算

API 接口规范

统一响应格式

{
  "code": 20000,
  "message": "success",
  "data": { ... }
}

code 为 20000 表示成功，其他值表示失败。

认证方式

所有需要登录的接口需在请求头中携带 Authorization Token：

Authorization: Bearer {token}

核心接口列表

自定义排课约束开发

排课引擎支持自定义约束规则扩展，开发步骤如下：

1. 实现约束接口

@ConstraintType("TEACHER_TIME")
public class TeacherTimeConstraint implements ScheduleConstraint {
    @Override
    public boolean check(ScheduleContext context) {
        // 校验教师时间冲突
        return true;
    }
}

2. 注册约束

@Configuration
public class ScheduleConfig {
    @Bean
    public ScheduleConstraint teacherTimeConstraint() {
        return new TeacherTimeConstraint();
    }
}

3. 前端配置

在前端排课配置页中添加对应约束的参数配置组件。

第三方系统对接

对接教务系统

通过 HTTP 接口同步学生、教师、班级等基础数据：

// 同步学生数据
{
  "url": "https://edu.example.com/api/students",
  "method": "GET",
  "params": { "page": 1, "size": 100 }
}

对接短信平台

考试通知、成绩推送可通过回调接口对接短信平台：

@RestController
@RequestMapping("/notify")
public class NotifyController {
    @PostMapping("/examNotice")
    public void sendExamNotice(@RequestBody ExamNoticeEvent event) {
        // 发送考试通知短信
    }
}

部署扩展

集群部署

生产环境建议采用集群部署，通过 Nginx 负载均衡分发请求：

• 后端服务部署多实例，共享 Redis 和 MySQL
• 直播服务部署独立节点，支持横向扩展
• 使用 Nginx 做请求负载和静态资源分发

AI 学情分析配置

在 application.yml 中配置大模型 API：

ai:
  provider: dashscope  # dashscope / deepseek / openai
  api-key: your-api-key
  model: qwen-max
  max-tokens: 2048
  temperature: 0.3

常见问题