更新 AdminLayout 以移除不必要的菜单项,添加公告管理功能,并调整路由权限检查逻辑以支持新功能。
This commit is contained in:
117
docs/公告管理使用说明.md
Normal file
117
docs/公告管理使用说明.md
Normal file
@@ -0,0 +1,117 @@
|
||||
# 公告管理使用说明
|
||||
|
||||
## 功能概述
|
||||
|
||||
公告管理模块提供了完整的公告信息管理功能,包括公告的创建、编辑、删除、启用/禁用等操作。
|
||||
|
||||
## 功能特性
|
||||
|
||||
- ✅ 公告列表查看(支持分页)
|
||||
- ✅ 按标题/内容关键词搜索
|
||||
- ✅ 按启用状态筛选
|
||||
- ✅ 创建新公告
|
||||
- ✅ 编辑现有公告
|
||||
- ✅ 删除公告
|
||||
- ✅ 一键启用/禁用公告
|
||||
- ✅ 支持跳转链接设置
|
||||
- ✅ 权限控制(管理员和代理商不同权限)
|
||||
|
||||
## 权限说明
|
||||
|
||||
### 管理员权限
|
||||
- 查看公告列表
|
||||
- 创建新公告
|
||||
- 编辑现有公告
|
||||
- 删除公告
|
||||
- 启用/禁用公告
|
||||
|
||||
### 代理商权限
|
||||
- 查看公告列表(只读)
|
||||
|
||||
## 使用步骤
|
||||
|
||||
### 1. 访问公告管理
|
||||
- 登录管理后台
|
||||
- 在左侧导航菜单中点击"公告管理"
|
||||
|
||||
### 2. 查看公告列表
|
||||
- 公告列表显示所有公告信息
|
||||
- 支持按关键词搜索(标题或内容)
|
||||
- 支持按启用状态筛选
|
||||
- 支持分页浏览
|
||||
|
||||
### 3. 创建新公告
|
||||
1. 点击"新增公告"按钮
|
||||
2. 填写公告信息:
|
||||
- **标题**:必填,公告标题
|
||||
- **内容**:必填,公告详细内容
|
||||
- **跳转链接**:可选,点击公告后跳转的URL
|
||||
- **状态**:选择是否启用
|
||||
3. 点击"保存"完成创建
|
||||
|
||||
### 4. 编辑公告
|
||||
1. 在公告列表中找到要编辑的公告
|
||||
2. 点击"编辑"按钮
|
||||
3. 修改公告信息
|
||||
4. 点击"保存"完成修改
|
||||
|
||||
### 5. 删除公告
|
||||
1. 在公告列表中找到要删除的公告
|
||||
2. 点击"删除"按钮
|
||||
3. 确认删除操作
|
||||
|
||||
### 6. 启用/禁用公告
|
||||
- 在公告列表中,直接点击状态开关即可快速启用或禁用公告
|
||||
- 只有启用的公告才会对用户可见
|
||||
|
||||
## 字段说明
|
||||
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| 标题 | 文本 | 是 | 公告标题,用于列表显示 |
|
||||
| 内容 | 文本 | 是 | 公告详细内容 |
|
||||
| 跳转链接 | URL | 否 | 点击公告后跳转的链接地址 |
|
||||
| 状态 | 布尔 | 是 | 是否启用,只有启用的公告用户才能看到 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **权限控制**:只有具备相应权限的用户才能进行相应操作
|
||||
2. **数据验证**:标题和内容为必填字段
|
||||
3. **URL验证**:跳转链接必须是有效的URL格式(以http://或https://开头)
|
||||
4. **状态控制**:只有启用的公告才会在前端显示给用户
|
||||
5. **操作记录**:所有操作都会记录创建时间和更新时间
|
||||
|
||||
## API接口
|
||||
|
||||
公告管理使用以下API接口:
|
||||
|
||||
- `GET /api/admin/announcement/list` - 获取公告列表
|
||||
- `POST /api/admin/announcement` - 创建公告
|
||||
- `PUT /api/admin/announcement/{id}` - 更新公告
|
||||
- `DELETE /api/admin/announcement/{id}` - 删除公告
|
||||
- `PUT /api/admin/announcement/{id}/enabled` - 更新启用状态
|
||||
- `GET /api/admin/announcement/enabled` - 获取启用的公告
|
||||
|
||||
详细的API文档请参考项目根目录的接口文档。
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
1. **无法访问公告管理页面**
|
||||
- 检查用户是否有相应权限
|
||||
- 确认已正确登录
|
||||
|
||||
2. **创建公告失败**
|
||||
- 检查标题和内容是否已填写
|
||||
- 检查跳转链接格式是否正确
|
||||
|
||||
3. **状态切换失败**
|
||||
- 检查网络连接
|
||||
- 确认用户有编辑权限
|
||||
|
||||
4. **搜索无结果**
|
||||
- 检查搜索关键词是否正确
|
||||
- 尝试重置搜索条件
|
||||
|
||||
如有其他问题,请联系系统管理员。
|
||||
Reference in New Issue
Block a user