# 会员教育信息重构方案

> 作者：湖北新华业务中台研发团队  
> 创建时间：2026-02-03  
> 状态：**已审核通过**

---

## 一、需求变更说明

### 1.1 变更内容

1. **去掉身份类型**：会员不再区分"家长"和"教师"
2. **重构会员信息表**：会员与教育信息变为**一对多**关系，一个会员可以有多个教育身份
3. **pg_member 表移除字段**：
   - `region_id` - 区域ID
   - `school_id` - 学校ID
   - `school_grade_id` - 年级ID
   - `school_class_id` - 班级ID
   - `identity_type` - 身份类型
   - ~~`union_id`~~ - **保留**（微信多应用打通需要）

### 1.2 变更原因

- 业务场景：一个用户可能同时是多个学校/班级的教师
- 简化会员模型：会员表只存储基础信息，教育信息独立管理

---

## 二、当前架构分析

### 2.1 现有数据结构

**pg_member 表**（部分字段）：

| 字段 | 类型 | 说明 | 变更 |
|------|------|------|------|
| member_id | bigint | 主键 | 保留 |
| member_code | varchar(32) | 会员编号 | 保留 |
| phone | varchar(20) | 手机号 | 保留 |
| password | varchar(100) | 密码 | 保留 |
| nickname | varchar(50) | 昵称 | 保留 |
| avatar | varchar(500) | 头像 | 保留 |
| gender | char(1) | 性别 | 保留 |
| birthday | date | 生日 | 保留 |
| **identity_type** | char(1) | 身份类型 | **删除** |
| open_id | varchar(100) | 微信OpenID | 保留 |
| union_id | varchar(100) | 微信UnionID | 保留 |
| **region_id** | bigint | 区域ID | **删除** |
| **school_id** | bigint | 学校ID | **删除** |
| **school_grade_id** | bigint | 年级ID | **删除** |
| **school_class_id** | bigint | 班级ID | **删除** |
| register_source | char(1) | 注册来源 | 保留 |
| register_time | datetime | 注册时间 | 保留 |
| status | char(1) | 状态 | 保留 |

### 2.2 现有关联关系

```
pg_member（会员）
    ├── 一对一：教育信息（存在会员表中）  ← 需要改为一对多
    └── 一对多：pg_student（学生）        ← 保持不变
```

---

## 三、目标架构设计

### 3.1 新数据结构

```
pg_member（会员）- 只存基础信息
    ├── 一对多：pg_member_education（会员教育信息）  ← 新建
    └── 一对多：pg_student（学生）                   ← 保持不变
```

### 3.2 新建表：pg_member_education

**设计理念**：一个教育身份 = 一个班级的教学关系

```
张老师教3个班 → 3条教育身份记录

教育身份1: 二中 - 高二 - 1班 - 数学
教育身份2: 二中 - 高二 - 2班 - 数学  
教育身份3: 二中 - 高二 - 3班 - 数学
```

```sql
CREATE TABLE pg_member_education (
    education_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '教育身份ID',
    member_id BIGINT NOT NULL COMMENT '会员ID',
    region_id BIGINT COMMENT '区域ID',
    school_id BIGINT NOT NULL COMMENT '学校ID',
    school_grade_id BIGINT NOT NULL COMMENT '年级ID（school_grade关联ID）',
    school_class_id BIGINT NOT NULL COMMENT '班级ID（school_class关联ID）',
    subject_id BIGINT COMMENT '学科ID',
    is_default CHAR(1) DEFAULT '0' COMMENT '是否默认身份（0否 1是）',
    status CHAR(1) DEFAULT '0' COMMENT '状态（0正常 1停用）',
    create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    del_flag CHAR(1) DEFAULT '0' COMMENT '删除标志',
    KEY idx_member_id (member_id),
    KEY idx_school_id (school_id),
    KEY idx_class_id (school_class_id)
) COMMENT '会员教育信息表';
```

### 3.3 最终关系图

```
pg_member（会员基础信息）
    │
    ├── 一对多 → pg_member_education（教育身份，每班一条）
    │
    └── 一对多 → pg_student（学生/孩子）
```

---

## 四、影响范围分析

### 4.1 数据库层

| 操作 | 对象 | 说明 |
|------|------|------|
| 修改 | pg_member | 删除5个字段 |
| 新建 | pg_member_education | 会员教育信息表（含班级字段） |
| 迁移 | 现有教育数据 | 迁移到新表 |

### 4.2 后端层

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `PgMember.java` | 修改 | 删除5个字段（保留unionId） |
| `PgMemberEducation.java` | 新建 | 教育身份实体 |
| `PgMemberEducationMapper.java` | 新建 | Mapper |
| `H5MemberServiceImpl.java` | 重构 | 教育相关逻辑 |
| `H5EducationDto.java` | 修改 | 添加educationId |
| `H5EducationVo.java` | 修改 | 添加educationId等字段 |
| `H5MemberController.java` | 修改 | 接口调整 |
| `H5MemberInfoVo.java` | 修改 | 删除identityType |
| `PgMemberController.java` | 修改 | 删除身份类型相关 |
| `PgMemberServiceImpl.java` | 修改 | 删除教育信息处理 |

### 4.3 管理后台前端

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `business/member/index.vue` | 修改 | 删除身份类型筛选和列 |
| `business/member/components/MemberDialog.vue` | 重构 | 删除身份类型和教师信息区块 |
| `business/member/components/EducationTab.vue` | **新建** | 教育身份管理Tab |
| `business/member/components/MemberDetail.vue` | **新建** | 会员详情页（含教育身份Tab） |
| `api/pangu/member.js` | 修改 | 删除/新增接口 |
| `api/pangu/memberEducation.js` | **新建** | 教育身份接口 |

### 4.4 H5前端

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `stores/user.ts` | 修改 | 删除 identityType |
| `views/userCenter/index.vue` | 修改 | 教育身份列表支持多个 |
| `components/TeacherIdentityForm.vue` | 修改 | 新增/编辑某个教育身份 |
| `api/user.js` | 修改 | 接口调整 |

---

## 五、接口变更

### 5.1 H5接口变更

#### 5.1.1 获取会员信息（修改）

**接口**：`GET /h5/member/info`

**响应变更**：

```json
// 修改前
{
  "code": 200,
  "data": {
    "consumerId": 1,
    "phone": "138****0000",
    "nickname": "测试用户",
    "identityType": "2",  // ← 删除
    "education": { ... },  // 单个
    "students": [...]
  }
}

// 修改后
{
  "code": 200,
  "data": {
    "consumerId": 1,
    "phone": "138****0000",
    "nickname": "测试用户",
    "educations": [...],  // 多个教育身份
    "students": [...]
  }
}
```

#### 5.1.2 教育身份列表（修改）

**接口**：`GET /h5/member/educations`

**响应**：

```json
{
  "code": 200,
  "data": [
    {
      "educationId": 1,
      "schoolId": 1,
      "schoolName": "武汉市第二中学",
      "schoolGradeId": 5,
      "gradeName": "高二",
      "schoolClassId": 104,
      "className": "1班",
      "subjectId": 1,
      "subjectName": "数学",
      "isDefault": "1"
    },
    {
      "educationId": 2,
      "schoolId": 1,
      "schoolName": "武汉市第二中学",
      "schoolGradeId": 5,
      "gradeName": "高二",
      "schoolClassId": 105,
      "className": "2班",
      "subjectId": 1,
      "subjectName": "数学",
      "isDefault": "0"
    }
  ]
}
```

#### 5.1.3 新增教育身份

**接口**：`POST /h5/member/educations`

**请求参数**：

```json
{
  "schoolId": 1,
  "schoolGradeId": 5,
  "schoolClassId": 104,
  "subjectId": 1
}
```

#### 5.1.4 编辑教育身份

**接口**：`PUT /h5/member/educations/{educationId}`

**请求参数**：

```json
{
  "schoolId": 1,
  "schoolGradeId": 5,
  "schoolClassId": 104,
  "subjectId": 1
}
```

#### 5.1.5 删除教育身份

**接口**：`DELETE /h5/member/educations/{educationId}`

#### 5.1.6 设置默认教育身份

**接口**：`PUT /h5/member/educations/{educationId}/default`

### 5.2 管理后台接口变更

#### 5.2.1 会员列表（修改）

- 删除 `identityType` 筛选参数
- 响应中删除 `identityType` 字段

#### 5.2.2 会员详情（修改）

- 删除教育信息字段
- 新增 `educations` 列表

#### 5.2.3 新增/编辑会员（修改）

- 删除 `identityType`、`regionId`、`schoolId`、`schoolGradeId`、`schoolClassId` 参数

#### 5.2.4 会员教育身份管理（新增）

| 接口 | 方法 | 说明 |
|------|------|------|
| `/business/member/{memberId}/educations` | GET | 获取会员教育身份列表 |
| `/business/member/{memberId}/education` | POST | 添加教育身份 |
| `/business/member/{memberId}/education/{educationId}` | PUT | 修改教育身份 |
| `/business/member/{memberId}/education/{educationId}` | DELETE | 删除教育身份 |

---

## 六、详细技术方案

### 6.1 数据库改造

#### 6.1.1 DDL脚本

```sql
-- 新建会员教育信息表（一个教育身份 = 一个班级的教学关系）
CREATE TABLE pg_member_education (
    education_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '教育身份ID',
    member_id BIGINT NOT NULL COMMENT '会员ID',
    region_id BIGINT COMMENT '区域ID',
    school_id BIGINT NOT NULL COMMENT '学校ID',
    school_grade_id BIGINT NOT NULL COMMENT '年级ID',
    school_class_id BIGINT NOT NULL COMMENT '班级ID',
    subject_id BIGINT COMMENT '学科ID',
    is_default CHAR(1) DEFAULT '0' COMMENT '是否默认身份（0否 1是）',
    status CHAR(1) DEFAULT '0' COMMENT '状态（0正常 1停用）',
    tenant_id VARCHAR(20) DEFAULT '000000' COMMENT '租户编号',
    create_dept BIGINT COMMENT '创建部门',
    create_by BIGINT COMMENT '创建者',
    create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    update_by BIGINT COMMENT '更新者',
    update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    del_flag CHAR(1) DEFAULT '0' COMMENT '删除标志',
    KEY idx_member_id (member_id),
    KEY idx_school_id (school_id),
    KEY idx_class_id (school_class_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='会员教育信息表';
```

#### 6.1.2 数据迁移脚本

```sql
-- 迁移现有教育数据（identity_type = '2' 的教师数据）
INSERT INTO pg_member_education (
    member_id, region_id, school_id, school_grade_id, school_class_id, subject_id, is_default, status, tenant_id, create_time
)
SELECT 
    member_id, region_id, school_id, school_grade_id, school_class_id, NULL, '1', '0', tenant_id, NOW()
FROM pg_member 
WHERE identity_type = '2' 
  AND school_id IS NOT NULL 
  AND school_class_id IS NOT NULL
  AND del_flag = '0';
```

#### 6.1.3 删除字段（迁移完成后执行）

```sql
-- 删除 pg_member 表中的字段（建议先备份）
-- 注意：union_id 保留，不删除
ALTER TABLE pg_member 
    DROP COLUMN identity_type,
    DROP COLUMN region_id,
    DROP COLUMN school_id,
    DROP COLUMN school_grade_id,
    DROP COLUMN school_class_id;
```

### 6.2 后端改造

#### 6.2.1 新建实体类

**PgMemberEducation.java**

```java
package org.dromara.pangu.member.domain;

@Data
@TableName("pg_member_education")
public class PgMemberEducation extends BaseEntity {
    @TableId(type = IdType.AUTO)
    private Long educationId;
    private Long memberId;
    private Long regionId;
    private Long schoolId;
    private Long schoolGradeId;
    private Long schoolClassId;
    private Long subjectId;
    private String isDefault;
    private String status;
    private String tenantId;
    @TableLogic
    private String delFlag;
    
    // 非数据库字段（用于VO展示）
    @TableField(exist = false)
    private String schoolName;
    @TableField(exist = false)
    private String gradeName;
    @TableField(exist = false)
    private String className;
    @TableField(exist = false)
    private String subjectName;
}
```

#### 6.2.2 修改 PgMember.java

删除以下字段：
- identityType
- regionId
- regionIds（@TableField(exist = false)）
- schoolId
- schoolGradeId
- schoolClassId

**保留字段**：
- unionId（微信多应用打通需要）

#### 6.2.3 新建 Mapper

- PgMemberEducationMapper.java

#### 6.2.4 修改 H5 Service

**H5MemberServiceImpl.java 主要改动**：

1. `getEducation()` → `getEducations()` 返回列表
2. `saveEducation()` 支持新增/编辑
3. `deleteEducation(Long educationId)` 按ID删除
4. 新增 `setDefaultEducation(Long educationId)` 设置默认

### 6.3 管理后台前端改造

#### 6.3.1 会员列表页（index.vue）

**删除内容**：

```vue
<!-- 删除：身份类型筛选 -->
<el-form-item label="身份类型">
  <el-select v-model="queryParams.identityType" ... />
</el-form-item>

<!-- 删除：身份类型列 -->
<el-table-column prop="identityType" label="身份类型" ... />
```

#### 6.3.2 会员编辑弹窗（MemberDialog.vue）

**删除内容**：

```vue
<!-- 删除：身份类型选择 -->
<el-form-item label="身份类型" prop="identityType">
  <el-radio-group v-model="form.identityType" ... />
</el-form-item>

<!-- 删除：教师信息区块 -->
<template v-if="form.identityType === '2'">
  <el-divider>学校信息（教师必填）</el-divider>
  <!-- 区域、学校、年级、班级选择 -->
</template>
```

#### 6.3.3 新建会员详情页

**MemberDetail.vue**（新建）

```vue
<template>
  <el-dialog v-model="visible" title="会员详情" width="900px">
    <el-tabs v-model="activeTab">
      <el-tab-pane label="基本信息" name="basic">
        <!-- 会员基本信息展示 -->
      </el-tab-pane>
      <el-tab-pane label="教育身份" name="education">
        <EducationTab :member-id="memberId" />
      </el-tab-pane>
      <el-tab-pane label="绑定学生" name="students">
        <!-- 学生列表 -->
      </el-tab-pane>
    </el-tabs>
  </el-dialog>
</template>
```

#### 6.3.4 新建教育身份Tab

**EducationTab.vue**（新建）

```vue
<template>
  <div>
    <el-button type="primary" @click="handleAdd">添加教育身份</el-button>
    <el-table :data="educationList">
      <el-table-column prop="schoolName" label="学校" />
      <el-table-column prop="gradeName" label="年级" />
      <el-table-column label="班级">
        <template #default="{ row }">
          {{ row.classNames?.join('、') }}
        </template>
      </el-table-column>
      <el-table-column prop="subjectName" label="学科" />
      <el-table-column prop="isDefault" label="默认" width="80">
        <template #default="{ row }">
          <el-tag v-if="row.isDefault === '1'" type="success">是</el-tag>
        </template>
      </el-table-column>
      <el-table-column label="操作" width="200">
        <template #default="{ row }">
          <el-button link @click="handleEdit(row)">编辑</el-button>
          <el-button link @click="handleSetDefault(row)">设为默认</el-button>
          <el-button link type="danger" @click="handleDelete(row)">删除</el-button>
        </template>
      </el-table-column>
    </el-table>
    
    <!-- 编辑弹窗 -->
    <EducationDialog ref="dialogRef" @success="loadData" />
  </div>
</template>
```

### 6.4 H5前端改造

#### 6.4.1 user.ts 修改

```typescript
// 删除
identityType: string

// 修改
education: any       // 单个 → 
educations: any[]    // 多个
```

#### 6.4.2 userCenter/index.vue 修改

支持展示多个教育身份，而不是只展示一个。

#### 6.4.3 TeacherIdentityForm.vue 修改

新增 `educationId` 字段用于编辑。

---

## 七、文件改动清单

### 7.1 数据库

| 文件/操作 | 类型 |
|-----------|------|
| DDL: pg_member_education | 新建表（含 school_class_id） |
| DML: 数据迁移脚本 | 执行 |
| DDL: pg_member 删除字段 | 修改表 |

### 7.2 后端（共 12+ 文件）

| 文件 | 类型 | 说明 |
|------|------|------|
| `member/domain/PgMember.java` | 修改 | 删除5个字段（保留unionId） |
| `member/domain/PgMemberEducation.java` | 新建 | |
| `member/mapper/PgMemberEducationMapper.java` | 新建 | |
| `member/service/PgMemberEducationService.java` | 新建 | |
| `member/service/impl/PgMemberEducationServiceImpl.java` | 新建 | |
| `member/controller/PgMemberController.java` | 修改 | 删除身份类型相关 |
| `member/service/impl/PgMemberServiceImpl.java` | 修改 | |
| `h5/domain/dto/H5EducationDto.java` | 修改 | 添加educationId |
| `h5/domain/vo/H5EducationVo.java` | 修改 | |
| `h5/domain/vo/H5MemberInfoVo.java` | 修改 | 删除identityType |
| `h5/controller/H5MemberController.java` | 修改 | 接口调整 |
| `h5/service/impl/H5MemberServiceImpl.java` | 重构 | 教育相关逻辑 |

### 7.3 管理后台前端（共 8+ 文件）

| 文件 | 类型 | 说明 |
|------|------|------|
| `views/business/member/index.vue` | 修改 | 删除身份类型 |
| `views/business/member/components/MemberDialog.vue` | 重构 | 删除教师信息 |
| `views/business/member/components/MemberDetail.vue` | 新建 | 会员详情 |
| `views/business/member/components/EducationTab.vue` | 新建 | 教育身份Tab |
| `views/business/member/components/EducationDialog.vue` | 新建 | 教育身份编辑 |
| `api/pangu/member.js` | 修改 | |
| `api/pangu/memberEducation.js` | 新建 | |

### 7.4 H5前端（共 5+ 文件）

| 文件 | 类型 | 说明 |
|------|------|------|
| `stores/user.ts` | 修改 | 删除identityType |
| `views/userCenter/index.vue` | 修改 | 支持多教育身份 |
| `components/TeacherIdentityForm.vue` | 修改 | 添加educationId |
| `api/user.js` | 修改 | 接口调整 |
| `views/register/index.vue` | 可能修改 | 如有身份类型相关 |

---

## 八、测试要点

| 场景 | 测试内容 |
|------|----------|
| 数据迁移 | 现有教师数据正确迁移到新表 |
| H5-新增教育身份 | 首次添加、多次添加（每班一条记录） |
| H5-编辑教育身份 | 修改学校/年级/班级/学科 |
| H5-删除教育身份 | 删除非默认、删除默认 |
| H5-设置默认 | 切换默认身份 |
| H5-多教育身份 | 一个老师添加多条教育身份（教多个班） |
| 管理后台-会员列表 | 不显示身份类型 |
| 管理后台-会员详情 | 查看多个教育身份 |
| 管理后台-教育身份管理 | 增删改查 |

---

## 九、上线计划

| 步骤 | 内容 | 说明 |
|------|------|------|
| 1 | 备份数据库 | 全量备份 pg_member |
| 2 | 执行建表DDL | 创建新表 |
| 3 | 执行数据迁移 | 迁移现有教育数据 |
| 4 | 部署后端 | 新代码 |
| 5 | 部署管理后台前端 | 新代码 |
| 6 | 部署H5前端 | 新代码 |
| 7 | 验证测试 | 回归测试 |
| 8 | 执行删除字段DDL | 确认无问题后 |

---

## 十、回滚方案

1. 后端代码回滚
2. 前端代码回滚
3. 数据库：
   - 从新表恢复数据到 pg_member
   - 删除新建的两张表

---

## 十一、风险评估

| 风险 | 等级 | 应对措施 |
|------|------|----------|
| 数据迁移丢失 | 高 | 完整备份，测试环境验证 |
| 接口不兼容 | 高 | 前后端同步上线 |
| 性能问题 | 低 | 新表已加索引 |
| 业务中断 | 中 | 选择低峰期上线 |

---

## 附录：现有数据统计（上线前执行）

```sql
-- 统计需要迁移的教育数据
SELECT COUNT(*) FROM pg_member 
WHERE identity_type = '2' AND school_id IS NOT NULL AND del_flag = '0';

-- 统计有班级信息的数据
SELECT COUNT(*) FROM pg_member 
WHERE identity_type = '2' AND school_class_id IS NOT NULL AND del_flag = '0';
```