2.4 KiB
2.4 KiB
学工系统 → 教务系统 异动类型映射
依据教务《异动类型管理（附件1）》与本系统实际业务数据整理。
本系统产生的异动类型
| 本库来源 | 本库内部编码 / 标识 | 本库业务含义 | 教务系统异动类型名称 | 说明 |
|---|---|---|---|---|
xg_student_status_change.change_type |
TUI_XUE |
退学 | 退学 | 名称一致 |
xg_student_status_change.change_type |
XIU_XUE |
休学 | 休学 | 名称一致 |
xg_student_status_change.change_type |
FU_XUE |
复学 | 复学 | 名称一致 |
xg_student_class_change（已处理） |
— | 换班级 | 转班级 | 非 change_type 字段，视图层固定输出 |
本系统有、但不同步给教务的类型
| 本库来源 | 内部编码 | 本库业务含义 | 说明 |
|---|---|---|---|
xg_student_status_change.change_type |
BI_YE |
毕业 | 不传给教务（按对接约定排除） |
教务码表有、本系统暂不产生的类型
以下类型在教务附件中存在，本学工系统当前无对应业务流水，接口不会返回：
实习、转录失败+实习、肄业、提前毕业、死亡、开除学籍、转系、转专业、转学(转出)、保留学籍、取消学籍、恢复学籍、取消入学资格、恢复入学资格、保留入学资格、停学、跳级、降级、留级、改名
接口约定
- 对外字段名：异动类型
- 字段值：上表「教务系统异动类型名称」列的中文名称（非本库内部编码）
- 异动生效学期、新名字：本系统无数据，固定返回
null - 异动前/后所在校区：班级
campus_id→xg_dorm_campus.campus_name，再回退班级campus_name - 异动前/后院系/专业：优先
college_id、major_id→sys_dept.dept_name，再回退冗余名称 - 异动前/后班级：优先
xg_class_msg.class_name，再回退冗余名称 - 新名字：本系统无改名流水，固定返回
null - 审核状态：固定返回「已通过」
视图与 API
- 视图 DDL：
docs/设计文档/database/vw_jw_student_change_export.sql - 只读 API：
跟教务系统同步学生异动信息/api_service/app.py - 数据范围：按
异动生效时间所在自然年 筛选（Queryyear，默认当前年）；一次返回该年全部记录，不分页