all-project/docs/superpowers/plans/2026-09-01-class-msg-campus.md

班级信息「所在校区」Implementation Plan

For agentic workers: Implement task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 为班级信息增加选填「所在校区」，支持列表筛选、单条维护、批量设置、导入模板下拉与导入解析。

Architecture: xg_class_msg 增加 campus_id + campus_name；增改/批量由服务端按 xg_dorm_campus 回填名称；导入按校区名称解析；前端复用 listDormCampus。

Tech Stack: Spring Boot 3 + MyBatis-Plus、Vue 3 + Element Plus、FastExcel 下拉

Spec: docs/superpowers/specs/2026-09-01-class-msg-campus-design.md

---

File map

File	Responsibility
docs/数据库脚本/2026-09-01-xg_class_msg-add-campus.sql	加列+索引
XgClassMsg.java / Bo / Vo / ImportVo	字段与 Excel 列
XgClassCampusBatchBo.java	批量请求体
XgClassMsgController / Service / Impl	筛选、回填、batch、模板下拉
XgClassMsgImportListener	导入解析校区
XgClassMsgMapper.xml	resultMap + select 补字段
web/.../classMsg/types.ts + index.ts	类型与 batch API
web/.../classMsg/index.vue	搜索/列/表单/批量弹窗

---

Task 1: 数据库

• 编写并（在可连库时）执行增量 SQL

Task 2: 后端领域模型 + Mapper

• Entity/Bo/Vo 加 campusId/campusName；Vo 导出 Excel 列「所在校区」
• ImportVo 插入「所在校区」列并顺延后续 index
• Mapper.xml 补字段

Task 3: 服务与接口

• buildQueryWrapper 支持 campusId
• insert/update 前校验并回填 campusName（空则清空）
• updateCampusBatch + Controller PUT /campus/batch
• importTemplate 增加校区下拉

Task 4: 导入监听

• 按校区名称解析；空跳过；0/多匹配失败

Task 5: 前端

• types + updateClassCampusBatch
• 搜索、表格列、表单、批量弹窗

Task 6: 文档

• 更新 spec 状态为已实现；按需补业务/API 说明