etms/EXAM_PAPER_REFACTOR_PLAN.md

# 考试与试卷数据模型重构方案

## 一、问题回顾

当前系统中 **考试(Exam)** 和 **试卷(Paper)** 共用同一数据对象 `et_exam_exampaper_and_editexampaper`，导致：
- 同一份试卷不能用于多次考试
- 考试时间属性绑定在试卷上
- 业务边界模糊，难以维护

---

## 二、试卷完整业务操作清单

> **重要**：确保数据拆分后不影响以下所有业务流程

### 2.1 试卷管理操作（17项）

| 操作类型 | 操作名称 | 涉及的数据库表/SQL | 影响分析 |
|---------|---------|-------------------|---------|
| **CRUD** | 试卷列表查询 | `et_exam_exampaper_and_editexampaper` | 需拆分为 paper + examinations |
| **CRUD** | 试卷新增 | INSERT 到视图 | 需改为 INSERT 到 `et_exam_paper` |
| **CRUD** | 试卷编辑 | UPDATE 视图 | 需改为 UPDATE `et_exam_paper` |
| **CRUD** | 试卷删除 | DELETE + 级联删除 | 需保留级联逻辑 |
| **CRUD** | 试卷详情查看 | JOIN 查询 | 需重新设计 JOIN |
| **预览** | 试卷预览 | `preview()` / `previewPage()` | 不涉及业务拆分 |
| **导入** | 试卷导入 | `fileImport()` | 不涉及业务拆分 |

### 2.2 试卷题目操作（12项）

| 操作类型 | 操作名称 | 涉及的SQL ID | 影响分析 |
|---------|---------|-------------|---------|
| **题目查询** | 获取试卷题目列表 | `getExampaperEditList` | 需改为 JOIN `et_exam_paper_question` |
| **题目统计** | 获取各题型数量 | `getCount` | 需改为统计 `et_exam_paper_question` |
| **历史问卷** | 保存历史问卷 | `insertHistoryExam` | 需复制到新试卷 |
| **随机组卷** | 随机添加试题 | `insertRandExam` | 需 INSERT 到 `et_exam_paper_question` |
| **序号更新** | 更新题目序号 | `updateRandExamNum` | 需更新 `et_exam_paper_question.num` |
| **题目查询** | 返回试卷信息 | `getExampaperReturn` | 需查询 `et_exam_paper` |
| **题目数量** | 获取题目数量 | `getQuestionNum` | 需 COUNT `et_exam_paper_question` |
| **题型数量** | 获取各题型数量 | `getNumber` | 需按 type_num 统计 |
| **序号修改** | 修改题目序号 | `updateOtherNumber` | 需更新 `et_exam_paper_question.num` |
| **单题修改** | 修改单题序号 | `updateNewNumber` | 需更新 `et_exam_paper_question.num` |
| **题目删除** | 删除试卷题目 | `DeleteExamQuestion` | 需 DELETE `et_exam_paper_question` |

### 2.3 发放范围（limitation）操作（16项）🔴 关键

> **这是与班级/课程关联的核心模块，必须完整保留**

| 操作类型 | 操作名称 | 涉及的SQL/URL | 关键字段 |
|---------|---------|--------------|---------|
| **发放范围** | 查询发放范围列表 | `limitationUrl` | `exam_id`, `limitation` |
| **全所发放** | 设置全所发放 | `saveLimitationUrl` (limitation=1) | 需关联 examination |
| **部门发放** | 添加部门发放范围 | `departmentAddUrl` | 需关联 examination |
| **人员发放** | 添加人员发放范围 | `saveLimitationUrl` (limitation=3) | 需关联 examination |
| **班级发放** | 添加班级发放范围 | `saveClassUrl` | `et_exam_limitation_class` |
| **课程发放** | 添加课程发放范围 | `saveCourseUrl` | `et_exam_limitation_course` |
| **删除发放** | 删除发放范围 | `deleteLimitationUrl` | 需 DELETE + 级联 |
| **删除其他** | 删除其他发放范围 | `deleteOtherUrl` | 需 DELETE + 级联 |
| **班级人员** | 获取班级人员列表 | `classComboxUrl` | 需关联 `v_class_user` |
| **课程人员** | 获取课程人员列表 | `courseComboxUrl` | 需关联课程学员 |
| **更新班级** | 更新班级对应人的exam_id | `updateClassUrl` | 需关联 examination |
| **更新课程** | 更新课程对应人的exam_id | `updateCourseUrl` | 需关联 examination |
| **更新limitation** | 更新limitation的exam_id | `updateLimitationUrl` | 需关联 examination |
| **删除limitation** | 依据试卷id删除limitation | `deleteLimitationExampaperUrl` | 需关联 examination |
| **删除人员** | 删除课程班级对应的人 | `deletePersonUrl` | 需关联 examination |
| **人员导入** | 发放范围人员导入 | `personImportUrl` | 需关联 examination |

### 2.4 考试执行操作（12项）

| 操作类型 | 操作名称 | 涉及的SQL/URL | 影响分析 |
|---------|---------|-------------|---------|
| **答题查询** | 获取考试题目列表 | `getExamTestList` | 需改为 JOIN examination |
| **成绩查询** | 获取考试成绩列表 | `getExamResultList` | 需 JOIN examination |
| **判卷列表** | 获取待判卷列表 | `getExamMarkList` | 需 JOIN examination |
| **成绩统计** | 获取个人成绩统计 | `getExamScoreList` | 需 JOIN examination |
| **提交查询** | 查询未提交用户 | `getIsNotSubmitList` | 需关联 examination |
| **机构详情** | 获取机构学员详情 | `getInstitutionDetail` | 需关联 examination |
| **部门详情** | 获取部门学员详情 | `getDepartmentDetail` | 需关联 examination |
| **个人详情** | 获取个人考试详情 | `getPersonDetail` | 需关联 examination |
| **班级详情** | 获取班级考试详情 | `getClassDetail` | 需关联 examination |
| **课程详情** | 获取课程考试详情 | `getCourseDetail` | 需关联 examination |
| **自动判卷** | 自动评分 | `updateUserScore` | 需 JOIN examination |
| **补考推送** | 推送补考人员 | `insertInstituteResit` 等 | 需关联 examination |

### 2.5 补考/重考操作（8项）

| 操作类型 | 操作名称 | 涉及的SQL ID | 关键逻辑 |
|---------|---------|-------------|---------|
| **插入补考** | 插入机构补考 | `insertInstituteResit` | 需创建新 examination |
| **插入补考** | 插入部门补考 | `insertDepartmentResit` | 需创建新 examination |
| **插入补考** | 插入个人补考 | `insertPersonResit` | 需创建新 examination |
| **插入补考** | 插入班级补考 | `insertClassResit` | 需创建新 examination |
| **插入补考** | 插入课程补考 | `insertCourseResit` | 需创建新 examination |
| **保存补考试卷** | 保存原试卷试题至补考 | `saveResitPaper` | 需复制 paper_question |
| **删除补考** | 删除临时试卷 | `deleteTemporaryExam` | 需关联 examination |
| **更新补考ID** | 更新补考exam_id | `updateLimitationExamId` | 需关联 examination |

### 2.6 发放范围类型详解

```
limitation 字段含义：
├── 1 = 全所（所有人员）
├── 2 = 部门（指定部门及下属人员）
├── 3 = 人员（指定个人）
├── 4 = 班级（指定班级的人员）→ 关联 et_exam_limitation_class
└── 5 = 课程（指定课程的人员）→ 关联 et_exam_limitation_course
```

### 2.7 关键业务流程依赖关系

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           试卷发放范围业务流程                                 │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  用户操作                   后端处理                    数据库操作            │
│  ─────────                  ────────                    ──────────           │
│                                                                             │
│  选择"班级发放"  ──────►  saveLimitationUrl  ──────►  INSERT et_exam_limitation  │
│       │                            │                        (limitation=4)   │
│       ▼                            ▼                                           │
│  选择班级  ─────────►  saveClassUrl    ──────►  INSERT et_exam_limitation_class  │
│       │                            │                        (展开班级人员)    │
│       ▼                            ▼                                           │
│  点击发布  ─────────►  updateClassUrl  ──────►  UPDATE et_exam_limitation_class  │
│                            │                           SET exam_id = 正式ID   │
│                            ▼                                           │
│                       发布成功              ──────►  班级学员可看到考试      │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

---

### 3.1 核心表结构设计

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           重构后数据模型                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────────┐         ┌─────────────────────┐                    │
│  │   et_exam_paper     │         │  et_exam_examination │                   │
│  │   （试卷主表）        │◄───────│   （考试主表）       │                   │
│  ├─────────────────────┤ paper_id├─────────────────────┤                    │
│  │ id (PK)             │         │ id (PK)              │                   │
│  │ name                │         │ paper_id (FK)        │                   │
│  │ description         │         │ name                 │                   │
│  │ category            │         │ starttime            │                   │
│  │ categoryid          │         │ endtime              │                   │
│  │ passpoint           │         │ duration             │                   │
│  │ totalpoints         │         │ shouldjoin           │                   │
│  │ creatperson         │         │ realjoin             │                   │
│  │ creatpersonid       │         │ leader               │                   │
│  │ createdepartment    │         │ leaderid             │                   │
│  │ edittime            │         │ createtime           │                   │
│  │ state               │         │ state                │                   │
│  │ pg (1考试/2问卷)     │         │ pg (1考试/2问卷)      │                   │
│  └─────────────────────┘         └─────────────────────┘                    │
│                                      │                                      │
│                                      │ exam_id                              │
│                                      ▼                                      │
│  ┌─────────────────────┐    ┌─────────────────────┐    ┌─────────────────┐  │
│  │ et_exam_question   │    │ et_exam_paper_question│    │et_exam_usertest│  │
│  │  （题目题库）       │◄───│  （试卷题目关联）    │◄───│ （用户答题）    │  │
│  ├─────────────────────┤    ├─────────────────────┤    ├─────────────────┤  │
│  │ id (PK)            │    │ id (PK)              │    │ id (PK)         │  │
│  │ type               │    │ paper_id (FK)        │    │ exam_id (FK)    │  │
│  │ subject            │    │ question_id (FK)     │    │ question_id(FK) │  │
│  │ answer             │    │ score                │    │ user_id         │  │
│  │ optionA~F          │    │ ismust               │    │ user_answer     │  │
│  │ ...                │    │ num                  │    │ user_score      │  │
│  └─────────────────────┘    └─────────────────────┘    │ mark_teacher    │  │
│                                                         └─────────────────┘  │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

### 3.2 新旧表字段对照

| 新表 et_exam_paper | 来自 | 新表 et_exam_examinations | 来自 |
|-------------------|------|--------------------------|------|
| id | - | id | - |
| name | exampaper.name | paper_id | exampaper.id |
| description | exampaper.description | name | 关联 paper.name + "第N次考试" |
| category | exampaper.category | starttime | exampaper.startdate |
| categoryid | exampaper.categoryid | endtime | exampaper.enddate |
| passpoint | exampaper.passpoint | duration | exampaper.sc |
| totalpoints | 计算得出 | shouldjoin | limitation.count |
| creatperson | exampaper.creatperson | realjoin | 计算得出 |
| creatpersonid | exampaper.creatpersonid | leader | exampaper.leader |
| createdepartment | exampaper.createdepartment | leaderid | exampaper.leaderid |
| edittime | exampaper.edittime | createtime | exampaper.edittime |
| state | exampaper.state | state | exampaper.state |
| pg | exampaper.pg | pg | exampaper.pg |

---

## 四、详细重构方案

### 4.1 第一阶段：数据库层重构

#### 3.1.1 创建新表

```sql
-- 1. 创建试卷主表
CREATE TABLE `et_exam_paper` (
  `id` varchar(32) NOT NULL COMMENT '试卷ID',
  `name` varchar(50) NOT NULL COMMENT '试卷名称',
  `description` varchar(500) DEFAULT NULL COMMENT '试卷描述',
  `category` varchar(20) DEFAULT NULL COMMENT '所属知识点',
  `categoryid` varchar(8) DEFAULT NULL COMMENT '知识点编码',
  `passpoint` int(8) DEFAULT NULL COMMENT '及格分数',
  `totalpoints` int(8) DEFAULT NULL COMMENT '试卷总分',
  `creatperson` varchar(10) DEFAULT NULL COMMENT '创建人',
  `creatpersonid` varchar(32) DEFAULT NULL COMMENT '创建人ID',
  `createdepartment` varchar(50) DEFAULT NULL COMMENT '部门',
  `edittime` datetime(6) DEFAULT NULL COMMENT '最后编辑时间',
  `state` int(8) DEFAULT 1 COMMENT '状态(1草稿/2已发布)',
  `pg` int(1) DEFAULT 1 COMMENT '类型(1考试/2问卷)',
  `isdeleted` int(1) DEFAULT 0 COMMENT '删除标记',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

-- 2. 创建考试主表
CREATE TABLE `et_exam_examinations` (
  `id` varchar(32) NOT NULL COMMENT '考试ID',
  `paper_id` varchar(32) NOT NULL COMMENT '关联试卷ID',
  `name` varchar(50) NOT NULL COMMENT '考试名称',
  `starttime` datetime(6) DEFAULT NULL COMMENT '开始时间',
  `endtime` datetime(6) DEFAULT NULL COMMENT '结束时间',
  `duration` int(8) DEFAULT NULL COMMENT '时长(分钟)',
  `shouldjoin` int(8) DEFAULT 0 COMMENT '应考人数',
  `realjoin` int(8) DEFAULT 0 COMMENT '实考人数',
  `leader` varchar(20) DEFAULT NULL COMMENT '负责人',
  `leaderid` varchar(32) DEFAULT NULL COMMENT '负责人ID',
  `createtime` datetime(6) DEFAULT NULL COMMENT '创建时间',
  `state` varchar(20) DEFAULT '未开始' COMMENT '状态',
  `pg` int(1) DEFAULT 1 COMMENT '类型(1考试/2问卷)',
  `isdeleted` int(1) DEFAULT 0 COMMENT '删除标记',
  PRIMARY KEY (`id`),
  KEY `idx_paper_id` (`paper_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

-- 3. 创建试卷题目关联表
CREATE TABLE `et_exam_paper_question` (
  `id` varchar(32) NOT NULL COMMENT 'ID',
  `paper_id` varchar(32) NOT NULL COMMENT '试卷ID',
  `question_id` varchar(32) NOT NULL COMMENT '题目ID',
  `score` int(8) DEFAULT NULL COMMENT '分值',
  `ismust` int(1) DEFAULT 1 COMMENT '是否必答',
  `num` int(8) DEFAULT NULL COMMENT '题目序号',
  `type` varchar(20) DEFAULT NULL COMMENT '题型',
  `type_num` int(8) DEFAULT NULL COMMENT '题型序号',
  PRIMARY KEY (`id`),
  KEY `idx_paper_id` (`paper_id`),
  KEY `idx_question_id` (`question_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

-- 4. 创建考试限制表（新）
CREATE TABLE `et_exam_examination_limitation` (
  `id` varchar(32) NOT NULL COMMENT 'ID',
  `exam_id` varchar(32) NOT NULL COMMENT '考试ID',
  `limitation` int(1) DEFAULT NULL COMMENT '发放范围类型',
  `user` varchar(20) DEFAULT NULL COMMENT '用户名',
  `user_id` varchar(32) DEFAULT NULL COMMENT '用户ID',
  PRIMARY KEY (`id`),
  KEY `idx_exam_id` (`exam_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

-- 5. 修改用户答题表
ALTER TABLE `et_exam_usertest`
  ADD COLUMN `exam_id` varchar(32) NOT NULL COMMENT '考试ID' AFTER `id`,
  DROP COLUMN `name`,
  DROP COLUMN `department`,
  MODIFY COLUMN `user_id` varchar(32) NOT NULL COMMENT '用户ID',
  ADD INDEX `idx_exam_id` (`exam_id`);
```

#### 3.1.2 数据迁移

```sql
-- =============================================
-- 数据迁移脚本
-- =============================================

-- 迁移试卷数据
INSERT INTO et_exam_paper (
  id, name, description, category, categoryid,
  passpoint, totalpoints, creatperson, creatpersonid,
  createdepartment, edittime, state, pg
)
SELECT
  id,
  name,
  description,
  category,
  categoryid,
  passpoint,
  (SELECT SUM(score) FROM et_exam_editexampaper WHERE edit_id = exampaper.id) AS totalpoints,
  creatperson,
  creatpersonid,
  createdepartment,
  edittime,
  state,
  pg
FROM et_exam_exampaper_and_editexampaper
WHERE pg IN (1, 2);

-- 迁移考试数据（每次唯一的试卷创建一条考试记录）
INSERT INTO et_exam_examinations (
  id, paper_id, name, starttime, endtime,
  duration, createtime, state, pg
)
SELECT
  id,                    -- 考试ID（复用原试卷ID）
  id AS paper_id,        -- 关联试卷ID（自关联，因为现在是1:1）
  CONCAT(name, '-首次考试') AS name,
  startdate,
  enddate,
  sc,
  edittime,
  state,
  pg
FROM et_exam_exampaper_and_editexampaper
WHERE pg IN (1, 2);

-- 迁移试卷题目关联
INSERT INTO et_exam_paper_question (
  id, paper_id, question_id, score, ismust, num, type, type_num
)
SELECT
  md5(UUID()) AS id,
  edit_id AS paper_id,
  id AS question_id,
  score,
  ismust,
  num,
  type,
  type_num
FROM et_exam_editexampaper;

-- 迁移考试限制数据
INSERT INTO et_exam_examination_limitation (
  id, exam_id, limitation, user, user_id
)
SELECT
  id,
  exam_id,
  limitation,
  user,
  user_id
FROM et_exam_limitation;

-- 迁移用户答题数据
UPDATE et_exam_usertest ut
INNER JOIN et_exam_editexampaper eq ON ut.question_id = eq.id
SET ut.exam_id = eq.edit_id;
```

---

### 4.2 第二阶段：SQL 映射层重构

#### 3.2.1 新建映射文件

创建 `et_exam_paper.map.xml`:

```xml
<?xml version="1.0" encoding="utf-8"?>
<dynamic-sql>
    <!-- 获取试卷列表 -->
    <sql id="getPaperList"><![CDATA[
        SELECT * FROM et_exam_paper
        WHERE isdeleted = 0 AND pg = ?
        <@p p=" AND name LIKE ?">name</@p>
        <@p p=" AND category LIKE ?">category</@p>
        <@p p=" AND createdepartment LIKE ?">createdepartment</@p>
    ]]></sql>

    <!-- 获取试卷详情（含题目） -->
    <sql id="getPaperDetail"><![CDATA[
        SELECT p.*, q.id AS ques_id, q.subject, q.type, q.score, q.num, q.ismust
        FROM et_exam_paper p
        INNER JOIN et_exam_paper_question pq ON p.id = pq.paper_id
        INNER JOIN et_exam_question q ON pq.question_id = q.id
        WHERE p.id = ?
        ORDER BY pq.num
    ]]></sql>
</dynamic-sql>
```

创建 `et_exam_examinations.map.xml`:

```xml
<?xml version="1.0" encoding="utf-8"?>
<dynamic-sql>
    <!-- 获取考试列表 -->
    <sql id="getExamList"><![CDATA[
        SELECT e.*, p.name AS paper_name, p.description AS paper_desc
        FROM et_exam_examinations e
        INNER JOIN et_exam_paper p ON e.paper_id = p.id
        WHERE e.isdeleted = 0 AND e.pg = ?
        <@p p=" AND e.name LIKE ?">name</@p>
    ]]></sql>

    <!-- 获取考试学员列表 -->
    <sql id="getExamUserList"><![CDATA[
        SELECT ut.*, u.username, u.orgname AS department
        FROM et_exam_usertest ut
        INNER JOIN et_train_baseuser u ON ut.user_id = u.usercode
        WHERE ut.exam_id = ?
        <@p p=" AND ut.user LIKE ?">name</@p>
    ]]></sql>
</dynamic-sql>
```

#### 3.2.2 修改现有映射文件

**修改 `et_exam_usertest.map.xml`**:

| 原 SQL | 修改为 |
|---------|--------|
| `from et_exam_exampaper_and_editexampaper` | `from et_exam_examinations e INNER JOIN et_exam_paper p ON e.paper_id = p.id` |
| `exampaper.id` | `e.id` |
| `exampaper.name` | `p.name` |
| `exampaper.sc` | `e.duration` |
| `et_exam_editexampaper.edit_id` | `et_exam_paper_question.paper_id` |

**修改 `et_exam_limitation.map.xml`**:

| 原 SQL | 修改为 |
|---------|--------|
| `et_exam_limitation.exam_id` | `et_exam_examination_limitation.exam_id` |
| `et_exam_exampaper_and_editexampaper.id` | `et_exam_examinations.paper_id` |

---

### 4.3 第三阶段：Java 控制器层重构

#### 3.3.1 新增控制器

```java
// 新增 ExamExaminationController.java
@Controller
@RequestMapping("/exam/examination")
public class ExamExaminationController {

    // 考试管理 CRUD
    // 考试发布/关闭
    // 考试时间修改
    // 考试统计
}
```

#### 3.3.2 修改现有控制器

**ExampaperController.java** 修改：
- 移除考试时间相关字段 (startdate, enddate, sc)
- 新增 `paper_id` 关联
- 保留试卷内容管理

**ExamController.java** 增强：
- 分离考试管理和试卷管理
- 新增"基于试卷创建考试"功能

---

### 4.4 第四阶段：前端页面重构

#### 3.4.1 页面拆分

```
原结构：
exam/exampaper.ftl          →  试卷+考试混用
  ├── exampaper_list.ftl    →  试卷列表
  ├── exampaper_edit.ftl   →  试卷+考试信息编辑

重构后：
exam/paper/
  ├── paper_list.ftl        →  试卷列表
  ├── paper_edit.ftl        →  试卷编辑（仅内容）
  ├── paper_detail.ftl      →  试卷预览

exam/examination/
  ├── exam_list.ftl         →  考试列表
  ├── exam_edit.ftl         →  考试编辑（仅时间/人员）
  ├── exam_start.ftl        →  开始答题
  └── exam_result.ftl       →  考试成绩
```

#### 3.4.2 新增"创建考试"功能

```html
<!-- exam/examination/exam_create.ftl -->
<div class="formTitle"><span class="icon icon_menu"></span>创建考试</div>
<table class="fromTable">
    <tr>
        <th>选择试卷：</th>
        <td>
            <select id="paperSelector" name="paper_id">
                <!-- 从 et_exam_paper 加载 -->
            </select>
        </td>
    </tr>
    <tr>
        <th>考试名称：</th>
        <td><input id="examName" name="name" type="text"/></td>
    </tr>
    <tr>
        <th>考试时间：</th>
        <td>
            <input id="starttime" name="starttime"/> -
            <input id="endtime" name="endtime"/>
        </td>
    </tr>
    <tr>
        <th>考试时长：</th>
        <td><input id="duration" name="duration" type="number"/> 分钟</td>
    </tr>
</table>
```

---

## 四、影响范围分析

### 4.1 涉及文件清单

| 类型 | 文件数 | 主要文件 |
|------|--------|----------|
| SQL 映射 | 6 | et_exam_*.map.xml |
| FTL 模板 | 18 | exam/*.ftl |
| Java 控制器 | 6 | Exam*Controller.class |
| Java Service | 4 | Exam*Service*.class |
| JavaScript | 3 | exam/*.js |
| 报表 | 3 | reportlets/exam*.cpt |

### 4.2 业务功能影响

| 功能模块 | 影响程度 | 说明 |
|----------|----------|------|
| 试卷管理 | 中 | 需分离考试时间字段 |
| 考试管理 | 高 | 完全重构 |
| 题库管理 | 低 | 无变化 |
| 答题功能 | 高 | 需关联考试ID |
| 成绩管理 | 中 | 需调整查询逻辑 |
| 统计分析 | 中 | 需新增统计维度 |
| 培训计划关联 | 高 | 需调整关联方式 |

---

## 五、重构风险评估

### 5.1 风险矩阵

| 风险项 | 可能性 | 影响 | 等级 | 缓解措施 |
|--------|--------|------|------|----------|
| 历史数据丢失 | 中 | 高 | 🔴 高 | 完整备份 + 试运行环境验证 |
| 业务逻辑遗漏 | 高 | 高 | 🔴 高 | 逐模块测试 + 功能清单核对 |
| 性能下降 | 低 | 中 | 🟡 中 | SQL 优化 + 索引添加 |
| 用户体验变化 | 中 | 中 | 🟡 中 | 保持 UI 一致 + 充分培训 |
| 报表不可用 | 中 | 中 | 🟡 中 | 同步更新 FineReport 模板 |
| 回滚困难 | 中 | 高 | 🔴 高 | 蓝绿部署 + 快速回滚脚本 |

### 5.2 回滚方案

```sql
-- 紧急回滚脚本（保留原表备份）
RENAME TABLE
  et_exam_paper TO et_exam_paper_backup_20260416,
  et_exam_examinations TO et_exam_examinations_backup_20260416,
  et_exam_paper_question TO et_exam_paper_question_backup_20260416,
  et_exam_examination_limitation TO et_exam_examination_limitation_backup_20260416;

-- 恢复旧表
RENAME TABLE
  et_exam_exampaper_backup TO et_exam_exampaper_and_editexampaper;
```

---

## 六、数据迁移详细方案

### 6.1 迁移前准备

```sql
-- 1. 完整备份（必须）
mysqldump -u root -p --single-transaction \
  --databases etms \
  > backup_etms_20260416.sql

-- 2. 创建迁移日志表
CREATE TABLE et_exam_migration_log (
  id INT AUTO_INCREMENT PRIMARY KEY,
  step_name VARCHAR(100),
  status VARCHAR(20),
  records_count INT,
  error_message TEXT,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```

### 6.2 分步迁移

```sql
-- Step 1: 创建新表结构（无数据）
CREATE TABLE `et_exam_paper` (...) -- 如上述

-- Step 2: 迁移试卷数据
INSERT INTO et_exam_migration_log (step_name, status, records_count)
VALUES ('migrate_paper', 'starting', 0);

INSERT INTO et_exam_paper (...) -- 如上述

INSERT INTO et_exam_migration_log (step_name, status, records_count)
SELECT 'migrate_paper', 'completed', COUNT(*) FROM et_exam_paper;

-- Step 3: 迁移考试数据
INSERT INTO et_exam_migration_log (step_name, status, records_count)
VALUES ('migrate_examination', 'starting', 0);

INSERT INTO et_exam_examinations (...) -- 如上述

INSERT INTO et_exam_migration_log (step_name, status, records_count)
SELECT 'migrate_examination', 'completed', COUNT(*) FROM et_exam_examinations;

-- Step 4: 迁移题目关联
INSERT INTO et_exam_paper_question (...)
SELECT ... FROM et_exam_editexampaper;

-- Step 5: 迁移用户答题数据
UPDATE et_exam_usertest ut
INNER JOIN et_exam_editexampaper eq ON ut.question_id = eq.id
SET ut.exam_id = eq.edit_id;

-- Step 6: 数据验证
SELECT
  (SELECT COUNT(*) FROM et_exam_paper) AS paper_count,
  (SELECT COUNT(*) FROM et_exam_examinations) AS exam_count,
  (SELECT COUNT(*) FROM et_exam_paper_question) AS question_count,
  (SELECT COUNT(*) FROM et_exam_usertest WHERE exam_id IS NOT NULL) AS user_answer_count;
```

### 6.3 发放范围迁移（班级/课程关联）🔴 重点

> 这是用户特别关心的业务场景，必须确保迁移后不影响现有功能

#### 6.3.1 发放范围数据结构

```
当前结构（存在问题）：
et_exam_limitation (exam_id 实际是试卷ID)
├── et_exam_limitation_class (exam_id 关联到试卷)
└── et_exam_limitation_course (exam_id 关联到试卷)

重构后结构：
et_exam_examination_limitation (exam_id 关联到考试ID)
├── et_exam_limitation_class (exam_id 关联到考试ID)
└── et_exam_limitation_course (exam_id 关联到考试ID)
```

#### 6.3.2 迁移 SQL

```sql
-- 1. 迁移 et_exam_limitation 表
-- 注意：exam_id 在原表中指向试卷，现在需要改为指向考试
-- 由于原表中 exam_id = 试卷ID，重构后 exam_id = 考试ID
-- 而考试ID = 试卷ID（首次迁移时1:1映射）

INSERT INTO et_exam_examination_limitation (
  id, exam_id, limitation, user, user_id
)
SELECT
  id,
  exam_id,              -- 考试ID（原试卷ID）
  limitation,           -- 发放范围类型
  user,                 -- 用户/部门名称
  user_id               -- 用户ID/部门代码
FROM et_exam_limitation
WHERE exam_id IS NOT NULL;

-- 2. 迁移 et_exam_limitation_class 表
-- 展开班级人员到 et_exam_examination_limitation

INSERT INTO et_exam_examination_limitation (
  id, exam_id, limitation, user, user_id
)
SELECT
  md5(UUID()) AS id,
  exam_id AS exam_id,   -- 考试ID（原试卷ID）
  4 AS limitation,      -- 班级类型
  class_person AS user, -- 班级人员姓名
  class_person_id AS user_id  -- 班级人员ID
FROM et_exam_limitation_class
WHERE exam_id IS NOT NULL;

-- 3. 迁移 et_exam_limitation_course 表
-- 展开课程人员到 et_exam_examination_limitation

INSERT INTO et_exam_examination_limitation (
  id, exam_id, limitation, user, user_id
)
SELECT
  md5(UUID()) AS id,
  exam_id AS exam_id,   -- 考试ID（原试卷ID）
  5 AS limitation,      -- 课程类型
  course_person AS user, -- 课程人员姓名
  course_person_id AS user_id  -- 课程人员ID
FROM et_exam_limitation_course
WHERE exam_id IS NOT NULL;
```

#### 6.3.3 迁移验证 SQL

```sql
-- 验证1：发放范围数据完整性
SELECT
  '原limitation' AS source_table,
  COUNT(*) AS record_count
FROM et_exam_limitation
UNION ALL
SELECT
  '原limitation_class' AS source_table,
  COUNT(*) AS record_count
FROM et_exam_limitation_class
UNION ALL
SELECT
  '原limitation_course' AS source_table,
  COUNT(*) AS record_count
FROM et_exam_limitation_course
UNION ALL
SELECT
  '新examination_limitation' AS source_table,
  COUNT(*) AS record_count
FROM et_exam_examination_limitation;

-- 验证2：各类型发放范围数量
SELECT
  limitation AS 类型,
  CASE limitation
    WHEN 1 THEN '全所'
    WHEN 2 THEN '部门'
    WHEN 3 THEN '人员'
    WHEN 4 THEN '班级'
    WHEN 5 THEN '课程'
  END AS 类型名称,
  COUNT(*) AS 数量
FROM et_exam_examination_limitation
GROUP BY limitation
ORDER BY limitation;

-- 验证3：检查 exam_id 是否都能关联到有效的考试记录
SELECT
  el.exam_id,
  COUNT(*) AS limitation_count,
  CASE
    WHEN e.id IS NOT NULL THEN '有效'
    ELSE '孤立数据'
  END AS status
FROM et_exam_examination_limitation el
LEFT JOIN et_exam_examinations e ON el.exam_id = e.id
GROUP BY el.exam_id, e.id;
```

### 6.4 迁移后验证

```sql
-- 1. 数据完整性检查
SELECT '试卷数据' AS check_item, COUNT(*) AS count FROM et_exam_paper
UNION ALL SELECT '考试数据', COUNT(*) FROM et_exam_examinations
UNION ALL SELECT '题目关联', COUNT(*) FROM et_exam_paper_question
UNION ALL SELECT '用户答题', COUNT(*) FROM et_exam_usertest
UNION ALL SELECT '答题关联', COUNT(*) FROM et_exam_usertest WHERE exam_id IS NOT NULL;

-- 2. 外键关系验证
SELECT '孤立考试' AS issue, COUNT(*) AS count
FROM et_exam_examinations e
LEFT JOIN et_exam_paper p ON e.paper_id = p.id
WHERE p.id IS NULL;

-- 3. 分数汇总验证
SELECT
  p.id, p.name,
  p.totalpoints AS stored_total,
  COALESCE(SUM(pq.score), 0) AS calculated_total,
  IF(p.totalpoints = COALESCE(SUM(pq.score), 0), 'OK', 'MISMATCH') AS check_result
FROM et_exam_paper p
LEFT JOIN et_exam_paper_question pq ON p.id = pq.paper_id
GROUP BY p.id;
```

---

## 七、实施计划

### 7.1 时间估算

| 阶段 | 工作内容 | 工期 | 累计 |
|------|----------|------|------|
| 第一阶段 | 数据库设计与建表 | 1天 | 1天 |
| 第二阶段 | 数据迁移脚本开发 | 2天 | 3天 |
| 第三阶段 | SQL 映射层重构 | 3天 | 6天 |
| 第四阶段 | Java 控制器重构 | 4天 | 10天 |
| 第五阶段 | 前端页面重构 | 3天 | 13天 |
| 第六阶段 | 报表适配 | 2天 | 15天 |
| 第七阶段 | 集成测试 | 3天 | 18天 |
| 第八阶段 | 性能测试与优化 | 2天 | 20天 |
| 第九阶段 | 培训与文档 | 2天 | 22天 |
| 第十阶段 | 灰度发布与上线 | 3天 | 25天 |

**总工期：约 25 个工作日（5 周）**

### 7.2 里程碑

| 里程碑 | 日期 | 交付物 |
|--------|------|--------|
| M1 - 数据库完成 | 第1天 | 新表结构 + 迁移脚本 |
| M2 - 后端完成 | 第10天 | 重构后的 Java 代码 |
| M3 - 前端完成 | 第13天 | 新页面 |
| M4 - 测试完成 | 第18天 | 测试报告 |
| M5 - 上线 | 第25天 | 正式环境 |

---

## 八、测试方案

### 8.1 测试用例清单

| 模块 | 测试项 | 优先级 |
|------|--------|--------|
| 试卷管理 | 创建试卷 | P0 |
| 试卷管理 | 编辑试卷内容 | P0 |
| 试卷管理 | 删除试卷 | P1 |
| 考试管理 | 基于试卷创建考试 | P0 |
| 考试管理 | 修改考试时间 | P0 |
| 考试管理 | 发布/关闭考试 | P0 |
| 答题功能 | 学员答题 | P0 |
| 答题功能 | 答题记录关联考试 | P0 |
| 成绩管理 | 成绩统计 | P0 |
| 统计分析 | 考试通过率 | P1 |
| 复用场景 | 同一试卷创建多次考试 | P0 |

### 8.2 回归测试重点

- [ ] 原有考试功能不受影响
- [ ] 问卷功能不受影响
- [ ] 与培训计划的关联正常
- [ ] 报表数据准确

---

## 九、部署方案

### 9.1 环境规划

| 环境 | 用途 | 数据 |
|------|------|------|
| 开发环境 | 开发调试 | 脱敏测试数据 |
| 测试环境 | 功能测试 | 生产数据副本（脱敏） |
| 预生产环境 | 灰度验证 | 生产数据副本 |
| 生产环境 | 正式运行 | 生产数据 |

### 9.2 部署步骤

```bash
# 1. 备份生产数据库
./backup_prod.sh

# 2. 执行数据迁移脚本
mysql -u root -p etms < migrate_exam_paper.sql

# 3. 部署应用
./deploy.sh --env=prod --module=exam

# 4. 健康检查
curl http://exam-api/health

# 5. 监控告警
# 检查 error.log, slow_query_log
```

---

## 十、附录

### 10.1 字段类型对照表

| 原字段 | 新位置 | 新字段 | 类型变化 |
|--------|--------|--------|----------|
| exampaper.name | 试卷表 | name | 保留 |
| exampaper.startdate | 考试表 | starttime | datetime |
| exampaper.enddate | 考试表 | endtime | datetime |
| exampaper.sc | 考试表 | duration | int |
| exampaper.state | 试卷表 | state | 保留 |
| limitation.exam_id | 新表 | exam_id | 重命名 |
| usertest.exam_id | 同表 | exam_id | 新增 |

### 10.2 SQL 变更清单

```sql
-- 需要执行的 DDL（按顺序）
1. CREATE TABLE et_exam_paper
2. CREATE TABLE et_exam_examinations
3. CREATE TABLE et_exam_paper_question
4. CREATE TABLE et_exam_examination_limitation
5. ALTER TABLE et_exam_usertest ADD exam_id
6. INSERT INTO et_exam_paper (...)
7. INSERT INTO et_exam_examinations (...)
8. INSERT INTO et_exam_paper_question (...)
9. INSERT INTO et_exam_examination_limitation (...)
10. UPDATE et_exam_usertest SET exam_id = ...
11. CREATE INDEX idx_paper_id ON et_exam_paper_question(paper_id)
12. CREATE INDEX idx_exam_id ON et_exam_usertest(exam_id)
```

---

*文档版本：v1.0*
*创建时间：2026-04-16*
*作者：AI 助手*