Skip to content

听课观察

API 事实来源:Django 后端自动文档

当前定位

observations 承载听课观察相关模板和记录模型。当前业务闭环较轻,扩展前应先补齐权限、提交流程和审计规则。

代码入口:

  • backend/apps/observations/models/
  • backend/apps/observations/views/
  • backend/apps/observations/schemas.py
  • backend/apps/observations/urls.py

模板与记录

模板定义在 schemas.py,用于前端生成听课表单。观察记录关联课程、课程实例、教室和观察人;其中课程实例关系是可选的,用来兼容历史或手工录入数据。

模板接口需要登录,但这不代表完整的观察记录 CRUD 已经开放。

扩展前需要定下来的规则

  • 提交或审核能力:哪些角色可以创建、查看、修改和导出观察记录。
  • 统计或考核:匿名规则、总分计算和历史模板兼容策略。
  • 审计:复用 logs 模块的 log_operation() 模式。

schemas.py 中包含业务表单结构,改字段会影响前端动态表单。