pangu-user-platform/docs/05-模块技术方案/会员管理/会员管理开发计划_v1.0.md

# 会员管理模块 - 开发计划

---

| 文档信息 | 内容 |
|---------|------|
| **文档版本** | V1.0 |
| **模块名称** | 会员管理模块 |
| **编写团队** | pangu |
| **创建日期** | 2026-01-31 |

---

## 1. 项目概述

### 1.1 模块简介

会员管理模块是盘古用户平台的核心业务模块，负责管理前端用户（家长/教师）的信息维护、登录认证、学生绑定等功能。

### 1.2 开发目标

- 完成会员管理的全部功能开发
- 前后端联调通过
- 完成功能测试和修复
- 通过验收测试

---

## 2. 开发阶段划分

### 2.1 阶段总览

| 阶段 | 名称 | 主要任务 | 交付物 |
|:---:|-----|---------|--------|
| 1 | 后端开发 | 数据库、接口开发 | 可调用的API接口 |
| 2 | 前端开发 | 页面、组件开发 | 可操作的页面 |
| 3 | 联调测试 | 前后端联调、功能测试 | 测试报告 |
| 4 | 验收上线 | 验收测试、部署上线 | 生产环境运行 |

---

## 3. 阶段一：后端开发

### 3.1 任务清单

| 序号 | 任务名称 | 详细描述 | 优先级 | 负责人 | 状态 |
|:---:|---------|---------|:-----:|:-----:|:----:|
| 1.1 | 数据库表创建 | 创建pg_member表及索引 | P0 | - | 待开始 |
| 1.2 | 实体类开发 | Member、MemberVO、MemberDTO | P0 | - | 待开始 |
| 1.3 | 枚举类开发 | IdentityTypeEnum、RegisterSourceEnum | P1 | - | 待开始 |
| 1.4 | Mapper开发 | MemberMapper接口和XML | P0 | - | 待开始 |
| 1.5 | Service接口 | IMemberService接口定义 | P0 | - | 待开始 |
| 1.6 | Service实现 | MemberServiceImpl实现 | P0 | - | 待开始 |
| 1.7 | Controller开发 | MemberController接口 | P0 | - | 待开始 |
| 1.8 | 权限配置 | 菜单、按钮权限配置 | P0 | - | 待开始 |
| 1.9 | 接口测试 | Postman/Swagger测试 | P0 | - | 待开始 |
| 1.10 | 代码审查 | 后端代码Review | P1 | - | 待开始 |

### 3.2 详细任务说明

#### 3.2.1 数据库表创建（1.1）

**任务目标：** 创建会员表及相关索引

**具体内容：**
- 创建 pg_member 表
- 创建唯一索引：uk_member_code, uk_phone
- 创建普通索引：idx_open_id, idx_school_id, idx_identity_type

**验收标准：**
- 表结构符合设计文档
- 索引创建正确
- 初始数据插入成功

#### 3.2.2 实体类开发（1.2）

**任务目标：** 开发会员相关的实体类

**具体内容：**
- Member.java - 会员实体
- MemberVO.java - 视图对象
- MemberDTO.java - 数据传输对象
- StudentVO（内部类）- 学生视图

**验收标准：**
- 字段与数据库表对应
- 注解配置正确
- 通过编译

#### 3.2.3 Mapper开发（1.4）

**任务目标：** 开发数据访问层

**具体内容：**
- MemberMapper.java 接口
- MemberMapper.xml 映射文件
- 自定义查询方法

**验收标准：**
- CRUD功能正常
- 关联查询正确
- 分页查询正常

#### 3.2.4 Service开发（1.5, 1.6）

**任务目标：** 开发业务逻辑层

**具体内容：**
- 会员列表查询（带数据权限）
- 新增会员（含校验逻辑）
- 编辑会员
- 删除会员（检查绑定关系）
- 重置密码
- 状态切换
- 学生绑定/解绑

**验收标准：**
- 业务规则实现正确
- 异常处理完善
- 事务控制正确

#### 3.2.5 Controller开发（1.7）

**任务目标：** 开发REST接口

**接口清单：**
| 接口 | 方法 | 说明 |
|-----|------|------|
| /member/list | GET | 查询列表 |
| /member/{id} | GET | 获取详情 |
| /member | POST | 新增 |
| /member | PUT | 修改 |
| /member/{id} | DELETE | 删除 |
| /member/resetPwd/{id} | PUT | 重置密码 |
| /member/changeStatus | PUT | 修改状态 |
| /member/bindStudent | POST | 绑定学生 |
| /member/unbindStudent/{memberId}/{studentId} | DELETE | 解绑学生 |

**验收标准：**
- 接口路径规范
- 权限注解配置
- 日志注解配置
- Swagger文档生成

---

## 4. 阶段二：前端开发

### 4.1 任务清单

| 序号 | 任务名称 | 详细描述 | 优先级 | 负责人 | 状态 |
|:---:|---------|---------|:-----:|:-----:|:----:|
| 2.1 | API接口封装 | member.js接口定义 | P0 | - | 待开始 |
| 2.2 | 路由配置 | 会员管理路由 | P0 | - | 待开始 |
| 2.3 | 列表页开发 | index.vue | P0 | - | 待开始 |
| 2.4 | 搜索组件 | 搜索条件表单 | P0 | - | 待开始 |
| 2.5 | 表格组件 | 数据表格展示 | P0 | - | 待开始 |
| 2.6 | 编辑页开发 | form.vue | P0 | - | 待开始 |
| 2.7 | 学生绑定弹窗 | StudentBindDialog.vue | P0 | - | 待开始 |
| 2.8 | 密码显示弹窗 | PasswordDialog.vue | P1 | - | 待开始 |
| 2.9 | 工具函数 | utils/member.js | P1 | - | 待开始 |
| 2.10 | 样式调整 | UI样式优化 | P2 | - | 待开始 |
| 2.11 | 代码审查 | 前端代码Review | P1 | - | 待开始 |

### 4.2 详细任务说明

#### 4.2.1 列表页开发（2.3）

**页面功能：**
- 搜索条件：手机号、昵称、身份类型、状态、注册时间
- 操作按钮：新增
- 数据表格：显示会员列表
- 行操作：编辑、重置密码、删除
- 分页组件

**交互要求：**
- 手机号脱敏显示
- 状态开关可直接切换
- 删除需二次确认

#### 4.2.2 编辑页开发（2.6）

**页面功能：**
- 基本信息表单
- 教师信息表单（条件显示）
- 学生绑定列表
- 保存/取消按钮

**交互要求：**
- 身份类型切换时动态显示/隐藏教师信息
- 区域-学校-年级-班级级联选择
- 表单验证

#### 4.2.3 学生绑定弹窗（2.7）

**组件功能：**
- 学生搜索
- 学生列表（多选）
- 分页
- 确认选择

**交互要求：**
- 教师身份只显示本校学生
- 排除已绑定学生
- 多选确认

---

## 5. 阶段三：联调测试

### 5.1 任务清单

| 序号 | 任务名称 | 详细描述 | 优先级 | 负责人 | 状态 |
|:---:|---------|---------|:-----:|:-----:|:----:|
| 3.1 | 接口联调 | 前后端接口对接 | P0 | - | 待开始 |
| 3.2 | 功能测试 | 执行测试用例 | P0 | - | 待开始 |
| 3.3 | Bug修复 | 修复发现的问题 | P0 | - | 待开始 |
| 3.4 | 回归测试 | 验证Bug修复 | P0 | - | 待开始 |
| 3.5 | 权限测试 | 各角色权限验证 | P0 | - | 待开始 |
| 3.6 | 性能测试 | 响应时间、并发测试 | P1 | - | 待开始 |
| 3.7 | 兼容性测试 | 浏览器兼容性 | P2 | - | 待开始 |

### 5.2 测试重点

1. **业务规则验证**
   - 手机号唯一性
   - 教师必须绑定学校信息
   - 教师只能绑定本校学生
   - 有绑定学生的会员不能删除

2. **数据权限验证**
   - 超级管理员看全部
   - 分公司用户看所属区域
   - 学校用户看本校教师

3. **状态控制验证**
   - 禁用后无法登录
   - 状态切换生效

---

## 6. 阶段四：验收上线

### 6.1 任务清单

| 序号 | 任务名称 | 详细描述 | 优先级 | 负责人 | 状态 |
|:---:|---------|---------|:-----:|:-----:|:----:|
| 4.1 | UAT测试 | 用户验收测试 | P0 | - | 待开始 |
| 4.2 | 问题修复 | UAT问题修复 | P0 | - | 待开始 |
| 4.3 | 代码合并 | 合并到主分支 | P0 | - | 待开始 |
| 4.4 | 部署上线 | 生产环境部署 | P0 | - | 待开始 |
| 4.5 | 上线验证 | 生产环境验证 | P0 | - | 待开始 |
| 4.6 | 文档归档 | 技术文档归档 | P1 | - | 待开始 |

### 6.2 上线检查清单

| 检查项 | 状态 |
|-------|:----:|
| 数据库脚本准备 | □ |
| 菜单权限配置 | □ |
| 角色权限分配 | □ |
| 应用配置检查 | □ |
| 接口测试通过 | □ |
| 功能测试通过 | □ |
| 权限测试通过 | □ |
| 代码Review完成 | □ |
| 部署脚本准备 | □ |
| 回滚方案准备 | □ |

---

## 7. 风险识别

### 7.1 技术风险

| 风险项 | 风险等级 | 影响 | 应对措施 |
|-------|:-------:|------|---------|
| 数据权限实现复杂 | 中 | 进度延迟 | 提前熟悉RuoYi数据权限机制 |
| 前端组件复杂度高 | 中 | 开发周期延长 | 复用已有组件，分解任务 |
| 接口设计变更 | 低 | 返工 | 提前评审接口设计 |

### 7.2 业务风险

| 风险项 | 风险等级 | 影响 | 应对措施 |
|-------|:-------:|------|---------|
| 需求变更 | 中 | 返工 | 需求评审确认，变更流程管控 |
| 测试时间不足 | 中 | 质量问题 | 合理安排测试周期 |

---

## 8. 依赖项

### 8.1 模块依赖

| 依赖模块 | 依赖内容 | 影响 |
|---------|---------|------|
| 区域管理 | 区域树接口 | 教师信息选择 |
| 学校管理 | 学校/年级/班级接口 | 教师信息选择 |
| 学生管理 | 学生列表接口 | 学生绑定功能 |
| 系统管理 | 用户/角色/权限 | 权限控制 |

### 8.2 技术依赖

| 依赖项 | 说明 |
|-------|------|
| RuoYi框架 | 基础框架支持 |
| MyBatis Plus | ORM功能 |
| Spring Security | 权限控制 |
| Element Plus | UI组件 |

---

## 9. 交付物清单

### 9.1 文档交付物

| 文档名称 | 用途 |
|---------|------|
| 会员管理模块技术方案_v1.0.md | 总体技术方案 |
| 会员管理前端详细设计_v1.0.md | 前端设计文档 |
| 会员管理后端详细设计_v1.0.md | 后端设计文档 |
| 会员管理测试用例_v1.0.md | 测试用例 |
| 会员管理开发计划_v1.0.md | 开发计划 |

### 9.2 代码交付物

| 交付物 | 路径 |
|-------|------|
| 后端代码 | pangu-admin/src/main/java/com/pangu/member/ |
| 前端代码 | frontend/src/views/member/ |
| 数据库脚本 | sql/pg_member.sql |
| 菜单配置 | sql/pg_member_menu.sql |

### 9.3 测试交付物

| 交付物 | 说明 |
|-------|------|
| 测试报告 | 功能测试报告 |
| Bug清单 | 问题跟踪记录 |
| 验收报告 | UAT验收报告 |

---

## 10. 附录

### 10.1 相关文档

| 文档 | 路径 |
|-----|------|
| 需求规格说明书 | docs/01-需求文档/需求规格说明书_v1.0.md |
| 系统设计文档 | docs/02-系统设计/系统设计文档_v1.0.md |
| 数据库设计文档 | docs/03-数据库设计/数据库设计文档_v1.0.md |
| 接口设计文档 | docs/04-接口文档/接口设计文档_v1.0.md |

### 10.2 参考资料

| 资料 | 说明 |
|-----|------|
| RuoYi-Vue文档 | http://doc.ruoyi.vip |
| Vue 3文档 | https://vuejs.org |
| Element Plus文档 | https://element-plus.org |
| MyBatis Plus文档 | https://baomidou.com |

---

*文档结束*