提交

跟教务系统同步学生异动信息/api_service/README.md

@@ -106,8 +106,8 @@ gunicorn -w 2 -b 0.0.0.0:5050 app:app
 | 异动生效学期 | 本系统无数据，为 `null` |
 | 异动类型 | **教务中文名称**（退学、休学、复学、转班级） |
 | 申请人学号 / 姓名 | |
-| 异动前/后 年级、院系、专业、班级、学制 | 学籍异动「前」优先取处理前快照 |
-| 异动前/后 所在校区 | 本系统无数据，为 `null` |
+| 异动前/后 年级、院系、专业、班级、学制 | 院系/专业优先 `sys_dept`；班级优先 `xg_class_msg`；学籍异动「前」优先历史快照 |
+| 异动前/后 所在校区 | 班级 `campus_id` → `xg_dorm_campus.campus_name`，再回退班级 `campus_name` |
 | 异动后班主任工号 / 姓名 | |
 | 新名字 | 本系统无改名流水，为 `null` |
 | 审核状态 | 固定「已通过」 |

跟教务系统同步学生异动信息/api_service/学生信息接口和学生异动接口调用说明.md

@@ -144,18 +144,18 @@ while True:
 | 联系电话 | 否 | |
 | 身份证件类型 | 否 | 有身份证号时为「居民身份证」，否则 `null` |
 | 身份证件号 | 否 | |
-| 班级信息 | 是 | 班级名称 |
-| 所在校区 | 是 | 有宿舍分配时取校区名，否则 `null` |
+| 班级信息 | 是 | `class_id` → `xg_class_msg.class_name`（优先班级表，再回退学生表冗余字段） |
+| 所在校区 | 是 | 学生 `class_id` → 班级 `campus_id` → `xg_dorm_campus.campus_name`，再回退班级 `campus_name`；无班级或未设置时为 `null` |
 | 所在年级 | 是 | |
 | 入学年份 | 是 | 整数，如 `2024` |
-| 系部信息 | 是 | 院系名称 |
-| 专业信息 | 是 | 专业名称 |
+| 系部信息 | 是 | `college_id` → `sys_dept.dept_name`（优先学生表 ID，其次班级表 ID，再回退冗余 `college_name`） |
+| 专业信息 | 是 | `major_id` → `sys_dept.dept_name`（优先学生表 ID，其次班级表 ID，再回退冗余 `major_name`） |
 | 班主任工号 | 是 | |
 | 班主任姓名 | 是 | |
 | 学生当前状态 | 是 | 教务中文名：在读、休学、复学、退学、毕业、结业、停学、其他 |
 | 学生是否在校 | 是 | 「在校」或「不在校」；退学、毕业为不在校 |
 | 异动类型 | 否 | 固定 `null` |
-| 培养层次 | 否 | 如三年制技师、六年制技师等 |
+| 培养层次 | 否 | 班级 `class_type` 字典值（`zsjy_education_level`）：`0` 三年制中级技工、`1` 三年制技师、`2` 四年制高级工、`3` 五年制高级技工、`4` 六年制技师、`5` 中高职一体；无班级或未设置时为 `null` |
 | 学制 | 是 | 年数，整数 |
 | 毕业时间 | 是 | **年份**整数；已毕业取异动生效年，否则按入学年+学制推算 |
 | 毕业学年学期 | 是 | 如 `2025-2026-2`；无法推算时为 `null` |
@@ -198,7 +198,7 @@ while True:
       "学生当前状态": "在读",
       "学生是否在校": "在校",
       "异动类型": null,
-      "培养层次": "三年制技师",
+      "培养层次": "1",
       "学制": 3,
       "毕业时间": 2027,
       "毕业学年学期": "2026-2027-2",
@@ -260,10 +260,10 @@ X-Jw-Cx-Key: JWCX001
 | 异动类型 | 教务中文名：**退学、休学、复学、转班级** |
 | 申请人学号 | |
 | 姓名 | |
-| 异动前所在年级 / 院系 / 专业 / 班级 / 学制 | |
-| 异动前所在校区 | 固定 `null` |
-| 异动后所在年级 / 班级 / 院系 / 专业 / 学制 | |
-| 异动后所在校区 | 固定 `null` |
+| 异动前所在年级 / 院系 / 专业 / 班级 / 学制 | 院系/专业优先 `sys_dept`；班级优先 `xg_class_msg`；再回退快照冗余名称 |
+| 异动前所在校区 | 异动前班级 `campus_id` → `xg_dorm_campus.campus_name`，再回退班级 `campus_name` |
+| 异动后所在年级 / 班级 / 院系 / 专业 / 学制 | 同上（异动后取当前学生/新班级） |
+| 异动后所在校区 | 异动后班级 `campus_id` → `xg_dorm_campus.campus_name`，再回退班级 `campus_name` |
 | 异动后班主任工号 / 姓名 | |
 | 新名字 | 固定 `null` |
 | 审核状态 | 固定「已通过」 |
@@ -293,12 +293,12 @@ X-Jw-Cx-Key: JWCX001
       "申请人学号": "2024010101",
       "姓名": "张三",
       "异动前所在年级": "2024",
-      "异动前所在校区": null,
+      "异动前所在校区": "西溪校区",
       "异动前所在院系": "电气工程系",
       "异动前所在专业": "电气工程",
       "异动前所在班级": "24技师1班",
       "异动前学制": 3,
-      "异动后所在校区": null,
+      "异动后所在校区": "西溪校区",
       "异动后所在年级": "2024",
       "异动后所在班级": "24技师1班",
       "异动后所在院系": "电气工程系",

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

@@ -27,7 +27,10 @@
 
 - 对外字段名：**异动类型**
 - 字段值：上表「教务系统异动类型名称」列的中文名称（非本库内部编码）
-- **异动生效学期**、**异动前/后所在校区**：本系统无数据，固定返回 `null`
+- **异动生效学期**、**新名字**：本系统无数据，固定返回 `null`
+- **异动前/后所在校区**：班级 `campus_id` → `xg_dorm_campus.campus_name`，再回退班级 `campus_name`
+- **异动前/后院系/专业**：优先 `college_id`、`major_id` → `sys_dept.dept_name`，再回退冗余名称
+- **异动前/后班级**：优先 `xg_class_msg.class_name`，再回退冗余名称
 - **新名字**：本系统无改名流水，固定返回 `null`
 - **审核状态**：固定返回「已通过」