# 📚 用户导入和课程分配操作指南

> 最后更新：2025-12-11
> 目的：确保用户导入和课程分配数据一致性

---

## 📋 目录

1. [导入前准备](#导入前准备)
2. [执行导入](#执行导入)
3. [导入后验证](#导入后验证)
4. [常见问题](#常见问题)
5. [数据修复](#数据修复)

---

## 🔧 导入前准备

### 第一步：数据备份（必须！）

```bash
# 运行备份脚本
双击运行：导入前数据备份.bat
```

**备份内容：**
- `sys_user` - 用户表
- `student_class` - 班级关联表
- `class` - 班级表

**备份位置：** `log\backup\backup_YYYYMMDD_HHMMSS\`

---

### 第二步：检查当前数据状态

```bash
# 运行检查脚本
双击运行：检查班级数据一致性.bat
```

**检查项目：**
1. ✅ 各班级学生数量（有效 vs 总数）
2. ✅ 存在问题的班级
3. ✅ 学生重复分配情况
4. ✅ 孤儿记录（已删除学生的分配记录）

**如果检查发现问题：**
```bash
# 先修复现有数据
双击运行：修复所有班级status问题.bat
```

---

### 第三步：准备导入文件

**Excel格式要求：**

| 信息编号 | 罪犯姓名 | 监狱 | 监区 | 性别 | 民族 | 文化程度 | 罪名 | 刑期 | 刑期起日 | 刑期止日 | 入监日期 | 班级名称 | 学员状态 |
|---------|---------|-----|------|------|------|---------|------|------|---------|---------|---------|---------|---------|
| 101 | 张三 | 某监狱 | 一监区 | 男 | 汉族 | 初中 | 盗窃 | 3年 | 2023-01-01 | 2026-01-01 | 2023-01-01 | 攻坚转换班2班 | 在押 |

**⚠️ 重要字段说明：**

1. **信息编号**：必填，纯数字，作为用户ID
2. **罪犯姓名**：必填
3. **监区**：必填
4. **班级名称**：
   - 可选
   - 如果填写，必须是系统中已存在的班级名称
   - 如果班级不存在，导入会失败
5. **学员状态**：可选，默认为"在押"

**班级名称验证：**
```sql
-- 查询所有可用班级
SELECT id, class_name, prison_area 
FROM class 
ORDER BY class_name;
```

---

## 📥 执行导入

### 方式1：后台管理系统导入（推荐）

1. 登录后台管理系统
2. 进入 **学生管理** 页面
3. 点击 **导入** 按钮
4. 选择Excel文件
5. 选择导入模式：
   - **不更新**：只导入新用户，跳过已存在的
   - **覆盖更新**：更新已存在的用户信息

**导入逻辑：**
- 根据 `信息编号` 判断用户是否存在
- 新用户：创建用户 → 分配角色 → 分配班级（status=1）✅
- 已存在用户（更新模式）：
  - 更新用户信息
  - 移除旧班级（status=0）
  - 分配新班级（status=1）✅

**异步处理：**
- 大批量导入（>100条）会异步处理
- 可在页面查看实时进度
- 支持中途取消

---

### 方式2：数据库直接导入

⚠️ **不推荐**，仅用于紧急情况或批量修复。

```sql
-- 1. 导入用户数据
LOAD DATA INFILE 'path/to/users.csv'
INTO TABLE sys_user
FIELDS TERMINATED BY ',' 
ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 ROWS;

-- 2. 批量分配班级（status必须设为1）
INSERT INTO student_class (student_id, class_id, status, join_time)
SELECT u.user_id, 9, 1, NOW()
FROM sys_user u
WHERE u.prison_area = '一监区' 
  AND u.del_flag = '0'
  AND NOT EXISTS (
    SELECT 1 FROM student_class sc 
    WHERE sc.student_id = u.user_id AND sc.status = 1
  );
```

---

## ✅ 导入后验证

### 第一步：检查导入结果

**后台管理系统：**
1. 查看导入任务结果
2. 记录成功数、更新数、失败数

**命令行检查：**
```bash
# 运行检查脚本
双击运行：检查班级数据一致性.bat
```

---

### 第二步：验证关键数据

```bash
# 运行统计脚本
双击运行：统计课程分配情况.bat
```

**验证要点：**
1. ✅ 各班级学生数是否正确
2. ✅ 学生管理显示人数 = 课程分配显示人数
3. ✅ 监区筛选结果准确
4. ✅ 没有学生同时在多个有效班级（status=1）

---

### 第三步：前端界面验证

**学生管理页面：**
```
筛选条件：一监区 + 攻坚转换班2班
预期结果：显示所有该班级的学生（12人或14人等）
```

**课程分配页面：**
```
选择课程 → 选择监区：一监区 → 选择班级：攻坚转换班2班
预期结果：显示的学生数与学生管理页面一致
```

**⚠️ 如果不一致：**
```bash
# 运行修复脚本
双击运行：修复所有班级status问题.bat
```

---

## ❓ 常见问题

### Q1: 导入后人数不一致怎么办？

**症状：**
- 学生管理筛选：12人
- 课程分配显示：14人

**原因：**
- 存在 `status=0` 的无效分配记录
- 学生管理只统计 `status=1`
- 课程分配可能统计了所有记录

**解决：**
```bash
双击运行：修复所有班级status问题.bat
```

---

### Q2: 导入时提示"班级不存在"？

**原因：**
- Excel中的班级名称在系统中不存在
- 班级名称拼写错误

**解决：**
1. 检查班级是否存在：
   ```sql
   SELECT id, class_name FROM class 
   WHERE class_name LIKE '%攻坚%';
   ```
2. 修正Excel中的班级名称，或先创建班级

---

### Q3: 学生同时在多个班级？

**原因：**
- 历史遗留数据
- 多次导入未正确处理旧班级

**解决：**
```sql
-- 查询有多个有效班级的学生
SELECT u.user_id, u.nick_name, 
       GROUP_CONCAT(c.class_name) AS classes
FROM sys_user u
INNER JOIN student_class sc ON u.user_id = sc.student_id
INNER JOIN class c ON sc.class_id = c.id
WHERE sc.status = 1 AND u.del_flag = '0'
GROUP BY u.user_id, u.nick_name
HAVING COUNT(*) > 1;

-- 手动调整：保留最新的，移除旧的
UPDATE student_class 
SET status = 0 
WHERE id = XXX;  -- 旧记录的ID
```

---

### Q4: 导入后课程分配页面看不到学生？

**可能原因：**
1. 班级筛选条件不对
2. 学生的 `status` 字段不是 `0`（正常）
3. 学生的 `del_flag` 是 `2`（已删除）

**检查：**
```sql
SELECT u.user_id, u.nick_name, u.status AS 账号状态, 
       u.del_flag AS 删除标志, sc.status AS 班级状态
FROM sys_user u
LEFT JOIN student_class sc ON u.user_id = sc.student_id
WHERE u.user_id = XXX;  -- 具体学生ID
```

---

## 🔧 数据修复

### 修复所有status问题（推荐）

```bash
双击运行：修复所有班级status问题.bat
```

**修复内容：**
- 将所有正常学员的班级分配改为有效（status=1）
- 不影响已删除学员的记录

---

### 手动修复特定班级

```sql
-- 修复"攻坚转换班2班"
UPDATE student_class sc
INNER JOIN sys_user u ON sc.student_id = u.user_id
SET sc.status = 1
WHERE sc.class_id = 9  -- 班级ID
  AND u.del_flag = '0'
  AND sc.status = 0;
```

---

### 清理孤儿记录

```sql
-- 删除已删除学员的分配记录
DELETE sc FROM student_class sc
LEFT JOIN sys_user u ON sc.student_id = u.user_id
WHERE u.user_id IS NULL OR u.del_flag = '2';
```

---

## 📊 监控和维护

### 定期检查（建议每周一次）

```bash
# 1. 数据一致性检查
双击运行：检查班级数据一致性.bat

# 2. 课程分配统计
双击运行：统计课程分配情况.bat
```

### 数据库视图（高级）

```bash
# 创建辅助视图
mysql -u root -proot study < 创建辅助视图.sql

# 使用视图快速查询
USE study;
SELECT * FROM v_student_current_class;  -- 学生当前班级
SELECT * FROM v_class_statistics;       -- 班级统计
SELECT * FROM v_prison_area_statistics; -- 监区统计
```

---

## 🎯 最佳实践

### ✅ 导入前必做：
1. 备份数据（`导入前数据备份.bat`）
2. 检查数据状态（`检查班级数据一致性.bat`）
3. 验证Excel格式和班级名称

### ✅ 导入后必做：
1. 检查导入结果（成功数/失败数）
2. 运行数据一致性检查
3. 前端界面验证

### ✅ 遇到问题时：
1. 先运行 `检查班级数据一致性.bat` 定位问题
2. 运行 `修复所有班级status问题.bat` 修复
3. 如果问题仍存在，查看日志或联系技术支持

---

## 📞 技术支持

**相关文件位置：**
- 备份文件：`log\backup\`
- 日志文件：后台管理系统的日志目录
- 辅助脚本：项目根目录

**关键数据表：**
- `sys_user` - 用户表
- `student_class` - 学员-班级关联表（重点关注 `status` 字段）
- `class` - 班级表
- `course_assignment` - 课程分配表

**重要字段说明：**
- `student_class.status`：
  - `1` = 有效分配（正在读）
  - `0` = 无效分配（已移除）
- `sys_user.del_flag`：
  - `0` = 正常
  - `2` = 已删除
- `sys_user.status`：
  - `0` = 正常
  - `1` = 停用

---

## 🎉 总结

✅ **代码层面已完美解决**：
- 所有新导入都会正确设置 `status=1`
- 手动分配班级也会正确设置 `status=1`
- 历史遗留数据可通过脚本一键修复

✅ **配套工具完善**：
- 数据备份工具
- 一致性检查工具
- 自动修复工具
- 统计报表工具

✅ **操作流程清晰**：
- 导入前：备份 → 检查 → 准备
- 导入中：选择模式 → 执行 → 监控
- 导入后：验证 → 修复（如需） → 确认

**放心使用！** 🚀