主题
通知公告
SYS-NOTICE-01 | 模块
system| 向全体或指定范围用户发布公告,支撑制度、变更、维护窗口等通知。
1. 使用角色与场景
角色:管理员、终端用户
- 发布系统升级公告并置顶
- 首页展示未读公告
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/notice/create | system:notice:create | 创建通知公告 | NoticeController#L39 |
| PUT | /system/notice/update | system:notice:update | 修改通知公告 | NoticeController#L47 |
| DELETE | /system/notice/delete | system:notice:delete | 删除通知公告 | NoticeController#L55 |
| DELETE | /system/notice/delete-list | system:notice:delete | 批量删除通知公告 | NoticeController#L64 |
| GET | /system/notice/page | system:notice:query | 获取通知公告列表 | NoticeController#L73 |
| GET | /system/notice/get | system:notice:query | 获得通知公告 | NoticeController#L81 |
| POST | /system/notice/push | system:notice:update | 推送通知公告 | NoticeController#L90 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/notice/NoticeController.java#L39 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/notice/NoticeDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_notice | NoticeDO |
5. 机制与配置
- 公告类型区分通知与公告;状态控制草稿与发布
6. 常见问题与排查
- 正文含富文本,需确认 XSS 过滤策略是否放行所需标签
7. 关联
- 需求原件:01-07-消息通知
- 相关卡片:SYS-NOTIFY-01