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