听课观察
API 事实来源:Django 后端自动文档
当前定位
observations 承载听课观察相关模板和记录模型。当前业务闭环较轻,扩展前应先补齐权限、提交流程和审计规则。
代码入口:
backend/apps/observations/models/backend/apps/observations/views/backend/apps/observations/schemas.pybackend/apps/observations/urls.py
模板与记录
模板定义在 schemas.py,用于前端生成听课表单。观察记录关联课程、课程实例、教室和观察人;其中课程实例关系是可选的,用来兼容历史或手工录入数据。
模板接口需要登录,但这不代表完整的观察记录 CRUD 已经开放。
扩展前需要定下来的规则
- 提交或审核能力:哪些角色可以创建、查看、修改和导出观察记录。
- 统计或考核:匿名规则、总分计算和历史模板兼容策略。
- 审计:复用
logs模块的log_operation()模式。
schemas.py 中包含业务表单结构,改字段会影响前端动态表单。