306 lines
17 KiB
Markdown
306 lines
17 KiB
Markdown
# 学生管理模块 - 开发任务清单
|
||
|
||
---
|
||
|
||
| 文档信息 | 内容 |
|
||
|---------|------|
|
||
| **文档版本** | 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 | 问题描述 | 发现阶段 | 负责人 | 状态 | 解决日期 |
|
||
|--------|----------|----------|--------|:----:|----------|
|
||
| - | - | - | - | - | - |
|
||
|
||
---
|
||
|
||
*文档结束*
|