all-project/跟教务系统同步学生异动信息/异动类型映射说明.md

学工系统 → 教务系统 异动类型映射

依据教务《异动类型管理（附件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
• 数据范围：按 异动生效时间 所在自然年 筛选（Query year，默认当前年）；一次返回该年全部记录，不分页