# 学生管理模块 - 开发任务清单 --- | 文档信息 | 内容 | |---------|------| | **文档版本** | V1.0 | | **项目名称** | 盘古用户平台（Pangu User Platform） | | **模块名称** | 学生管理模块 | | **编写团队** | pangu | | **创建日期** | 2026-01-31 | --- ## 1. 任务总览 ### 1.1 开发阶段划分 | 阶段 | 名称 | 任务数 | 主要内容 | |:----:|------|:------:|----------| | P1 | 基础功能开发 | 12 | 数据库、后端CRUD、前端列表和表单 | | P2 | 批量导入开发 | 8 | 模板生成、Excel解析、数据校验、会员关联 | | P3 | 联调与测试 | 6 | 前后端联调、功能测试、Bug修复 | | P4 | 验收与交付 | 4 | 文档完善、代码Review、验收评审 | ### 1.2 任务状态说明 | 状态 | 说明 | |------|------| | 待开始 | 任务未开始 | | 进行中 | 任务正在进行 | | 已完成 | 任务已完成 | | 阻塞 | 任务因依赖问题阻塞 | --- ## 2. P1：基础功能开发 ### 2.1 后端任务 | 任务编号 | 任务名称 | 任务描述 | 依赖 | 负责人 | 状态 | |---------|---------|----------|------|--------|:----:| | BE-001 | 创建数据库表 | 创建pg_student表，添加索引 | 无 | | 待开始 | | BE-002 | 初始化示例数据 | 插入学生示例数据 | BE-001 | | 待开始 | | BE-003 | 创建实体类 | Student.java及相关DTO/VO | BE-001 | | 待开始 | | BE-004 | 创建Mapper接口 | StudentMapper.java及XML映射 | BE-003 | | 待开始 | | BE-005 | 创建服务接口 | IStudentService.java | BE-004 | | 待开始 | | BE-006 | 实现列表查询 | selectStudentList方法 | BE-005 | | 待开始 | | BE-007 | 实现详情查询 | selectStudentById方法 | BE-005 | | 待开始 | | BE-008 | 实现新增功能 | insertStudent方法 | BE-005 | | 待开始 | | BE-009 | 实现修改功能 | updateStudent方法 | BE-005 | | 待开始 | | BE-010 | 实现删除功能 | deleteStudentById方法 | BE-005 | | 待开始 | | BE-011 | 创建控制器 | StudentController.java | BE-006~010 | | 待开始 | | BE-012 | 配置权限 | 菜单和权限标识配置 | BE-011 | | 待开始 | ### 2.2 前端任务 | 任务编号 | 任务名称 | 任务描述 | 依赖 | 负责人 | 状态 | |---------|---------|----------|------|--------|:----:| | FE-001 | 创建API接口 | src/api/student.js | 无 | | 待开始 | | FE-002 | 创建Mock数据 | src/mock/student.js | FE-001 | | 待开始 | | FE-003 | 更新Mock入口 | src/mock/index.js添加import | FE-002 | | 待开始 | | FE-004 | 创建主页面 | src/views/student/index.vue | FE-001 | | 待开始 | | FE-005 | 创建学校树组件 | components/SchoolTree.vue | FE-002 | | 待开始 | | FE-006 | 实现列表展示 | 表格、分页、搜索功能 | FE-004,005 | | 待开始 | | FE-007 | 创建学生弹窗 | components/StudentDialog.vue | FE-002 | | 待开始 | | FE-008 | 实现新增功能 | 表单校验、级联选择 | FE-007 | | 待开始 | | FE-009 | 实现编辑功能 | 数据回显、表单提交 | FE-007 | | 待开始 | | FE-010 | 实现删除功能 | 确认弹窗、删除请求 | FE-006 | | 待开始 | ### 2.3 交付物清单 | 序号 | 交付物 | 类型 | 说明 | |:----:|--------|------|------| | 1 | pg_student表 | 数据库 | 包含索引和示例数据 | | 2 | 后端代码 | Java | Controller/Service/Mapper | | 3 | 前端页面 | Vue | 列表页、学校树、新增/编辑弹窗 | | 4 | Mock数据 | JS | 开发测试用Mock | --- ## 3. P2：批量导入开发 ### 3.1 后端任务 | 任务编号 | 任务名称 | 任务描述 | 依赖 | 负责人 | 状态 | |---------|---------|----------|------|--------|:----:| | BE-013 | 集成EasyExcel | pom.xml添加依赖 | 无 | | 待开始 | | BE-014 | 创建导入DTO | StudentImportDTO.java | BE-013 | | 待开始 | | BE-015 | 实现模板下载 | downloadTemplate方法 | BE-014 | | 待开始 | | BE-016 | 实现Excel解析 | EasyExcel读取逻辑 | BE-014 | | 待开始 | | BE-017 | 实现数据校验 | 必填校验、业务校验 | BE-016 | | 待开始 | | BE-018 | 实现会员关联 | 查询或创建会员 | BE-017 | | 待开始 | | BE-019 | 实现批量保存 | 事务处理、错误收集 | BE-018 | | 待开始 | | BE-020 | 添加接口 | Controller导入接口 | BE-019 | | 待开始 | ### 3.2 前端任务 | 任务编号 | 任务名称 | 任务描述 | 依赖 | 负责人 | 状态 | |---------|---------|----------|------|--------|:----:| | FE-011 | 创建导入弹窗 | components/ImportDialog.vue | FE-001 | | 待开始 | | FE-012 | 实现步骤引导 | el-steps步骤组件 | FE-011 | | 待开始 | | FE-013 | 实现模板下载 | 调用下载接口 | FE-011 | | 待开始 | | FE-014 | 实现文件上传 | el-upload组件 | FE-011 | | 待开始 | | FE-015 | 实现结果展示 | 成功/失败数量、错误列表 | FE-014 | | 待开始 | | FE-016 | 主页面集成 | 添加导入按钮和弹窗 | FE-011~015 | | 待开始 | ### 3.3 交付物清单 | 序号 | 交付物 | 类型 | 说明 | |:----:|--------|------|------| | 1 | 导入模板 | Excel | 学生导入模板.xlsx | | 2 | 后端导入逻辑 | Java | Excel解析、校验、保存 | | 3 | 前端导入弹窗 | Vue | 步骤引导、上传、结果展示 | --- ## 4. P3：联调与测试 ### 4.1 联调任务 | 任务编号 | 任务名称 | 任务描述 | 依赖 | 负责人 | 状态 | |---------|---------|----------|------|--------|:----:| | INT-001 | 列表查询联调 | 前后端接口对接 | P1、P2完成 | | 待开始 | | INT-002 | 新增/编辑联调 | 表单提交对接 | INT-001 | | 待开始 | | INT-003 | 删除联调 | 删除接口对接 | INT-001 | | 待开始 | | INT-004 | 批量导入联调 | 上传和结果对接 | INT-001 | | 待开始 | | INT-005 | 数据权限联调 | 不同角色数据验证 | INT-001 | | 待开始 | ### 4.2 测试任务 | 任务编号 | 任务名称 | 任务描述 | 依赖 | 负责人 | 状态 | |---------|---------|----------|------|--------|:----:| | TEST-001 | 功能测试 | 执行功能测试用例 | INT-005 | | 待开始 | | TEST-002 | Bug修复 | 修复测试发现的Bug | TEST-001 | | 待开始 | | TEST-003 | 回归测试 | 验证Bug修复 | TEST-002 | | 待开始 | | TEST-004 | 性能测试 | 列表查询、批量导入性能 | TEST-003 | | 待开始 | ### 4.3 交付物清单 | 序号 | 交付物 | 类型 | 说明 | |:----:|--------|------|------| | 1 | 联调报告 | 文档 | 接口联调结果 | | 2 | 测试报告 | 文档 | 功能测试报告 | | 3 | Bug列表 | 文档 | 问题跟踪记录 | --- ## 5. P4：验收与交付 ### 5.1 验收任务 | 任务编号 | 任务名称 | 任务描述 | 依赖 | 负责人 | 状态 | |---------|---------|----------|------|--------|:----:| | ACC-001 | 代码Review | 代码规范检查 | P3完成 | | 待开始 | | ACC-002 | 文档完善 | 补充接口文档、操作手册 | ACC-001 | | 待开始 | | ACC-003 | 验收演示 | 功能演示给评审方 | ACC-002 | | 待开始 | | ACC-004 | 上线准备 | 生产环境配置、数据迁移 | ACC-003 | | 待开始 | ### 5.2 交付物清单 | 序号 | 交付物 | 类型 | 说明 | |:----:|--------|------|------| | 1 | 源代码 | 代码 | 通过Review的代码 | | 2 | 技术文档 | 文档 | 完整的技术方案文档 | | 3 | 接口文档 | 文档 | Swagger/接口说明 | | 4 | 操作手册 | 文档 | 用户操作指南 | --- ## 6. 任务依赖图 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 任务依赖关系 │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ P1：基础功能 │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ BE-001 ──► BE-002 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ BE-003 ──► BE-004 ──► BE-005 │ │ │ │ │ │ │ │ │ ┌────────┬────────┼────────┬────────┐ │ │ │ │ ▼ ▼ ▼ ▼ ▼ │ │ │ │ BE-006 BE-007 BE-008 BE-009 BE-010 │ │ │ │ │ │ │ │ │ │ │ │ │ └────────┴────────┴────────┴────────┘ │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ BE-011 ──► BE-012 │ │ │ │ │ │ │ │ FE-001 ──► FE-002 ──► FE-003 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ FE-004 ◄── FE-005 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ FE-006 ──► FE-007 ──► FE-008 ──► FE-009 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ FE-010 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ P2：批量导入 │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ BE-013 ──► BE-014 ──► BE-015 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ BE-016 ──► BE-017 ──► BE-018 ──► BE-019 ──► BE-020│ │ │ │ │ │ │ │ FE-011 ──► FE-012 ──► FE-013 │ │ │ │ │ │ │ │ │ │ ▼ ▼ │ │ │ │ FE-014 ──► FE-015 ──► FE-016 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ P3：联调测试 │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ INT-001 ──► INT-002 ──► INT-003 ──► INT-004 ──► INT-005 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ TEST-001 ──► TEST-002 ──► TEST-003 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ TEST-004 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ P4：验收交付 │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ ACC-001 ──► ACC-002 ──► ACC-003 ──► ACC-004 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 7. 任务检查清单 ### 7.1 代码规范检查 | 检查项 | 检查内容 | 状态 | |--------|----------|:----:| | 命名规范 | 类名、方法名、变量名符合规范 | ☐ | | 注释规范 | 关键代码有中文注释 | ☐ | | 日志规范 | 关键操作有日志记录 | ☐ | | 异常处理 | 异常捕获和处理完整 | ☐ | | 参数校验 | 入参有合法性校验 | ☐ | | SQL注入 | 使用参数化查询 | ☐ | ### 7.2 功能完整性检查 | 检查项 | 检查内容 | 状态 | |--------|----------|:----:| | 列表查询 | 多条件筛选、分页正确 | ☐ | | 学校树 | 树形结构正确、点击筛选有效 | ☐ | | 新增功能 | 表单校验、级联选择、保存成功 | ☐ | | 编辑功能 | 数据回显、修改保存成功 | ☐ | | 删除功能 | 确认提示、软删除成功 | ☐ | | 批量导入 | 模板下载、上传解析、结果展示 | ☐ | | 数据权限 | 不同角色数据隔离正确 | ☐ | ### 7.3 性能检查 | 检查项 | 检查内容 | 达标 | 状态 | |--------|----------|------|:----:| | 列表查询 | 响应时间 | ≤500ms | ☐ | | 学校树加载 | 首次加载时间 | ≤1s | ☐ | | 批量导入 | 1000条数据导入时间 | ≤30s | ☐ | | 页面加载 | 首屏加载时间 | ≤3s | ☐ | --- ## 8. 风险与问题跟踪 ### 8.1 风险登记 | 风险ID | 风险描述 | 影响 | 概率 | 应对措施 | 状态 | |--------|----------|------|------|----------|:----:| | R-001 | Excel大文件导入超时 | 中 | 中 | 使用流式读取、分批处理 | 待监控 | | R-002 | 数据校验规则复杂 | 中 | 中 | 设计完善校验规则 | 待监控 | | R-003 | 学校树数据量大 | 低 | 低 | 使用懒加载 | 待监控 | ### 8.2 问题跟踪 | 问题ID | 问题描述 | 发现阶段 | 负责人 | 状态 | 解决日期 | |--------|----------|----------|--------|:----:|----------| | - | - | - | - | - | - | --- *文档结束*