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

依据教务《异动类型管理（附件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`
- **新名字**：本系统无改名流水，固定返回 `null`
- **审核状态**：固定返回「已通过」

## 视图与 API

- 视图 DDL：`docs/设计文档/database/vw_jw_student_change_export.sql`
- 只读 API：`跟教务系统同步学生异动信息/api_service/app.py`
- 数据范围：按 **`异动生效时间` 所在自然年** 筛选（Query `year`，默认当前年）；**一次返回该年全部记录，不分页**