学校管理模块 - 技术文档
| 文档信息 |
内容 |
| 模块名称 |
学校管理模块 |
| 编写团队 |
pangu |
| 创建日期 |
2026-01-31 |
| 文档状态 |
待评审 |
文档清单
功能概览
核心功能
学校管理模块
├── 学校管理
│ ├── 学校列表查询（区域树 + 学校树）
│ ├── 新增学校
│ ├── 编辑学校
│ └── 删除学校
├── 年级挂载
│ ├── 为学校挂载年级
│ └── 删除学校年级
└── 班级挂载
├── 为年级挂载班级
└── 删除学校班级
业务规则摘要
| 规则 |
说明 |
| 编码生成 |
学校编码自动生成：SCH + 年份 + 4位序号 |
| 挂载模式 |
年级/班级采用选择挂载，非新建 |
| 删除校验 |
删除前检查子级和学生引用 |
| 软删除 |
所有删除操作均为软删除 |
工作量估算
| 类别 |
任务数 |
工时 |
| 后端开发 |
14 |
25h |
| 前端开发 |
10 |
23h |
| 测试 |
3 |
8h |
| 合计 |
27 |
56h |
预计开发周期：7-8个工作日
技术要点
前端关键点
- 左右分栏布局：左侧区域树 + 右侧学校树表格
- 树形表格：使用 el-table 的 tree-props 实现三级树
- 级联选择：所属区域使用 el-cascader 级联选择
- 多选挂载：年级/班级支持多选挂载
后端关键点
- 编码生成：SCH + 年份 + 4位序号，唯一索引保证
- 删除校验：检查子级、检查学生引用
- 树形查询：批量查询 + 内存组装，避免N+1问题
- 数据权限：@DataScope 注解实现分公司数据隔离
依赖关系
| 依赖模块 |
依赖说明 |
| 区域管理 |
学校必须关联区域 |
| 年级字典 |
年级挂载依赖年级字典 |
| 班级字典 |
班级挂载依赖班级字典 |
| 学生管理 |
删除校验需检查学生引用 |
评审检查清单
技术方案评审
| 检查项 |
评审意见 |
状态 |
| 需求覆盖完整性 |
|
☐ |
| 技术方案可行性 |
|
☐ |
| 前端组件设计合理性 |
|
☐ |
| 后端接口设计规范性 |
|
☐ |
| 数据库设计合理性 |
|
☐ |
| 数据权限设计正确性 |
|
☐ |
| 异常处理完整性 |
|
☐ |
| 性能考虑充分性 |
|
☐ |
任务分解评审
| 检查项 |
评审意见 |
状态 |
| 任务粒度合理性 |
|
☐ |
| 任务依赖关系正确 |
|
☐ |
| 工时估算合理性 |
|
☐ |
| 验收标准明确 |
|
☐ |
测试方案评审
| 检查项 |
评审意见 |
状态 |
| 用例覆盖完整性 |
|
☐ |
| 边界条件考虑 |
|
☐ |
| 测试数据准备 |
|
☐ |
| 验收标准明确 |
|
☐ |
评审记录
签字确认
| 角色 |
姓名 |
日期 |
签字 |
| 技术负责人 |
|
|
|
| 前端负责人 |
|
|
|
| 后端负责人 |
|
|
|
| 测试负责人 |
|
|
|
| 产品负责人 |
|
|
|
文档结束