# 通知功能实现方案

## 1. 需求分析

根据业务描述，通知系统需要支持以下功能：

### 1.1 系统通知
- 次级管理员增加/删除学校管理员 → 主要管理员可见
- 次级管理员增加/修改/删除套餐 → 主要管理员可见
- 老师的系统通知 → 主要管理员可见

### 1.2 管理员对用户通知（层级发送）

| 角色 | 可通知对象 | 说明 |
|------|-----------|------|
| 主要管理员(SUPER) | 次级管理员、学校管理员、学院管理员、老师、学生 | 可多选 |
| 次级管理员(SUPER1) | 学校管理员、学院管理员、老师、学生 | 可多选 |
| 学校管理员(SCHOOL_ADMIN) | 学院管理员、老师、学生 | 可多选 |
| 学院管理员(COLLEGE_ADMIN) | 老师、学生 | 可多选 |
| 老师(TEACHER) | 指定课程的学生 | 课程可多选 |
| 学生(STUDENT) | 仅收件箱 | 无发送权限 |

### 1.3 核心需求（用户明确）
1. **通知创建人** - 需要记录发送者信息
2. **发送目标** - 需要记录接收人信息
3. **通知类型** - 需要支持多种类型

---

## 2. 当前代码分析

### 2.1 现有通知实体 (`SysNotification`)

| 字段 | 类型 | 说明 | 当前状态 |
|------|------|------|----------|
| id | Long | 主键ID | ✅ 存在 |
| schoolId | Long | 学校ID（数据隔离） | ✅ 存在 |
| userId | Long | 用户ID | ✅ 存在（作为接收者ID） |
| title | String | 通知标题 | ✅ 存在 |
| content | String | 通知内容 | ✅ 存在 |
| type | Integer | 通知类型 | ✅ 存在（仅4种） |
| isRead | Integer | 是否已读 | ✅ 存在（用户表示可保留） |
| createTime | Date | 创建时间 | ✅ 存在 |

### 2.2 现有问题

| 问题 | 说明 |
|------|------|
| 缺少发送者信息 | 当前只有接收者ID(userId)，缺少发送者ID和姓名 |
| 通知类型不足 | 只有4种类型，缺少用户通知和课程通知 |
| 缺少批量发送功能 | 当前只能单条发送给单个用户 |
| 缺少角色层级控制 | 没有实现角色层级的发送权限控制 |

---

## 3. 实现方案（最小化修改）

### 3.1 数据库表结构调整

**新增字段到 `sys_notification` 表：**

| 字段名 | 类型 | 约束 | 说明 |
|--------|------|------|------|
| sender_id | BIGINT | NULL | 发送者用户ID |
| sender_name | VARCHAR(100) | NULL | 发送者姓名 |
| target_type | TINYINT(1) | DEFAULT 1 | 目标类型：1-单个用户，2-角色，3-课程 |

**更新通知类型定义：**

| 类型值 | 类型名称 | 说明 |
|--------|----------|------|
| 1 | 系统通知 | 系统自动生成的通知 |
| 2 | 作业通知 | 作业相关通知 |
| 3 | 考试通知 | 考试相关通知 |
| 4 | 考勤通知 | 考勤相关通知 |
| 5 | 用户通知 | 管理员发送给用户的通知 |
| 6 | 课程通知 | 老师发送给课程学生的通知 |

### 3.2 实体类修改 (`SysNotification.java`)

```java
// 新增字段
@Schema(description = "发送者用户ID")
private Long senderId;

@Schema(description = "发送者姓名")
private String senderName;

@Schema(description = "目标类型：1-单个用户，2-角色，3-课程")
private Integer targetType;
```

### 3.3 新增请求DTO

**`SendNotificationRequest.java`** - 发送通知请求

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| schoolId | Long | 是 | 学校ID |
| title | String | 是 | 通知标题 |
| content | String | 是 | 通知内容 |
| type | Integer | 是 | 通知类型(5-用户通知, 6-课程通知) |
| targetUserIds | List<Long> | 否 | 目标用户ID列表 |
| targetRoleTypes | List<Integer> | 否 | 目标角色类型列表 |
| courseIds | List<Long> | 否 | 课程ID列表（老师群发） |

### 3.4 Service层增强

**新增接口方法 (`SysNotificationService.java`)：**

```java
/**
 * 发送用户通知（批量发送给指定角色或用户）
 */
void sendUserNotification(Long schoolId, Long senderId, String senderName,
                          String title, String content,
                          List<Long> targetUserIds, List<Integer> targetRoleTypes);

/**
 * 发送课程通知（老师群发课程消息）
 */
void sendCourseNotification(Long schoolId, Long teacherId, String teacherName,
                            String title, String content, List<Long> courseIds);

/**
 * 发送系统通知给指定用户
 */
void sendSystemNotification(Long schoolId, List<Long> targetUserIds,
                            String title, String content);

/**
 * 获取当前用户可通知的下级角色类型
 */
List<Integer> getAvailableTargetRoles(Long currentUserId);

/**
 * 获取指定角色类型下的用户列表
 */
List<SysUser> getUsersByRoleTypes(Long schoolId, List<Integer> roleTypes);
```

### 3.5 Controller层增强

**新增接口 (`SysNotificationController.java`)：**

| 接口 | 方法 | 权限 | 说明 |
|------|------|------|------|
| `/api/notification/send-to-users` | POST | 管理员/老师 | 发送通知给指定用户 |
| `/api/notification/send-to-roles` | POST | 管理员/老师 | 发送通知给指定角色 |
| `/api/notification/send-to-course` | POST | TEACHER | 发送课程通知 |
| `/api/notification/available-targets` | GET | 登录用户 | 获取当前用户可通知的目标角色 |

### 3.6 角色层级权限控制

**角色层级关系与可通知范围：**

| 当前角色 | roleType | 可通知角色类型 |
|----------|----------|---------------|
| SUPER | 1 | [1, 2, 3, 4, 5] |
| SUPER1 | 1 | [2, 3, 4, 5] |
| SCHOOL_ADMIN | 2 | [3, 4, 5] |
| COLLEGE_ADMIN | 3 | [4, 5] |
| TEACHER | 4 | [5] (仅限自己课程的学生) |
| STUDENT | 5 | [] (无发送权限) |

---

## 4. 文件修改清单

| 文件路径 | 修改类型 | 说明 |
|----------|----------|------|
| `entity/SysNotification.java` | 修改 | 新增 senderId, senderName, targetType 字段 |
| `entity/request/SendNotificationRequest.java` | 新增 | 发送通知请求DTO |
| `service/SysNotificationService.java` | 修改 | 新增接口方法 |
| `service/impl/SysNotificationServiceImpl.java` | 修改 | 实现新增方法 |
| `controller/SysNotificationController.java` | 修改 | 新增接口 |
| `mapper/SysNotificationMapper.java` | 修改 | 新增批量插入方法 |
| `mapper/SysNotificationMapper.xml` | 修改 | 新增批量插入SQL |
| `db/create_edu_tables.sql` | 修改 | 添加新字段 |
| `db/sys_role_permission_data_init_merged.sql` | 修改 | 添加发送通知权限 |

---

## 5. 权限配置

**新增权限码：**

| 权限码 | 权限名称 | 适用角色 |
|--------|----------|----------|
| `notification:send:users` | 发送通知给用户 | SUPER, SUPER1, SCHOOL_ADMIN, COLLEGE_ADMIN |
| `notification:send:course` | 发送课程通知 | TEACHER |

---

## 6. 总结

**当前代码是否满足需求：**

| 需求 | 当前状态 | 需要修改 |
|------|----------|----------|
| 通知创建人 | ❌ 缺少发送者信息 | 新增 senderId, senderName |
| 发送目标 | ✅ userId作为接收者 | 支持批量发送 |
| 通知类型 | ❌ 只有4种 | 新增类型5和6 |
| 角色层级控制 | ❌ 未实现 | 新增权限验证逻辑 |

**结论：当前代码不满足需求，需要进行上述修改。**