65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
# 通知公告模块
|
||
|
||
## 功能概述
|
||
|
||
管理系统内部通知公告的发布、已读/未读状态管理。支持全员公告和指定用户通知。
|
||
|
||
## 通知类型
|
||
|
||
| 类型 | 说明 |
|
||
|------|------|
|
||
| `type=0` | 全员公告（仅平台管理员可发） |
|
||
| `type>0` | 指定用户通知 |
|
||
|
||
## 核心流程
|
||
|
||
```mermaid
|
||
graph TB
|
||
A[管理员发送通知] --> B{type=0?}
|
||
B -->|是| C[全员公告<br/>所有管理员可见]
|
||
B -->|否| D[指定用户通知<br/>仅选中用户可见]
|
||
C --> E[用户查看已读]
|
||
D --> E
|
||
E --> F{全部已读?}
|
||
F -->|是| G[通知状态标记为已读]
|
||
F -->|否| H[保持未读状态]
|
||
```
|
||
|
||
## 数据模型
|
||
|
||
| 模型 | 表名 | 说明 |
|
||
|------|------|------|
|
||
| `AdminNoticeModel` | `xk_admin_notice` | 通知主体（标题、内容、类型、发布人） |
|
||
| `AdminNoticeRelationsModel` | `xk_admin_notice_relations` | 通知-用户关联（已读状态） |
|
||
|
||
### 通知字段
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `title` | 通知标题 |
|
||
| `detail` | 摘要 |
|
||
| `content` | 详细内容 |
|
||
| `type` | 通知类型（0=全员） |
|
||
| `edit_type` | 编辑类型 |
|
||
| `user_id` | 发布人 ID |
|
||
| `status` | 全局已读状态（0=未全读, 1=全部已读） |
|
||
|
||
## 对应 API
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `api/admin/notice/list` | 通知列表（当前用户） |
|
||
| GET | `api/admin/notice/detail` | 通知详情（自动标记已读） |
|
||
| POST | `api/admin/notice/read` | 标记单条已读 |
|
||
| POST | `api/admin/notice/read-all` | 全部已读 |
|
||
| POST | `api/admin/notice/send` | 发送通知 |
|
||
| GET | `api/admin/notice/user-option` | 接收人下拉列表 |
|
||
|
||
## 关联类
|
||
|
||
| 类 | 路径 | 说明 |
|
||
|----|------|------|
|
||
| `NoticeController` | `app/Service/admin/notice/NoticeController.php` | 控制器 |
|
||
| `NoticeService` | `app/Service/admin/notice/NoticeService.php` | 服务层 |
|
||
| `SendToUserNoticeJob` | `app/Jobs/admin/notices/SendToUserNoticeJob.php` | 异步发送 Job |
|