321 lines
9.1 KiB
Markdown
321 lines
9.1 KiB
Markdown
# 缘池与许愿树管理端功能总结
|
||
|
||
> 更新日期：2025-12-30
|
||
|
||
---
|
||
|
||
## 一、文件结构
|
||
|
||
### 1.1 前端文件
|
||
|
||
```
|
||
Zhibo/admin/src/
|
||
├── api/
|
||
│ ├── fatePool.js # 缘池API
|
||
│ └── wishTree.js # 许愿树API
|
||
├── router/modules/
|
||
│ ├── fatePool.js # 缘池路由
|
||
│ └── wishTree.js # 许愿树路由
|
||
└── views/
|
||
├── fatePool/ # 缘池页面
|
||
│ ├── topic/
|
||
│ │ ├── index.vue # 话题管理
|
||
│ │ └── post.vue # 话题发布详情
|
||
│ └── topicUser/
|
||
│ └── index.vue # 用户发布列表
|
||
└── wishTree/ # 许愿树页面
|
||
├── tree/
|
||
│ ├── index.vue # 许愿树列表
|
||
│ └── detail.vue # 许愿树留言详情
|
||
├── node/
|
||
│ └── index.vue # 节点管理
|
||
└── message/
|
||
└── index.vue # 用户留言列表
|
||
```
|
||
|
||
### 1.2 后端文件
|
||
|
||
```
|
||
Zhibo/zhibo-h/crmeb-admin/src/main/java/com/zbkj/admin/controller/
|
||
├── FatePoolTopicController.java # 缘池话题管理
|
||
├── FatePoolPostController.java # 缘池用户发布管理
|
||
├── WishTreeController.java # 许愿树管理
|
||
├── WishTreeNodeController.java # 许愿树节点管理
|
||
└── WishTreeMessageController.java # 许愿树留言管理
|
||
```
|
||
|
||
### 1.3 数据库表
|
||
|
||
```
|
||
eb_fate_pool_topic # 缘池话题表
|
||
eb_fate_pool_topic_post # 缘池用户发布表
|
||
eb_wish_tree # 许愿树表
|
||
eb_wish_tree_node # 许愿树节点表
|
||
eb_wish_tree_message # 许愿树留言表
|
||
```
|
||
|
||
---
|
||
|
||
## 二、缘池功能
|
||
|
||
### 2.1 话题管理
|
||
|
||
**页面路径：** `/fatePool/topic`
|
||
**页面文件：** `views/fatePool/topic/index.vue`
|
||
|
||
| 功能 | 说明 |
|
||
|-----|------|
|
||
| 话题列表 | 分页展示话题，显示封面、标题、描述、发布数 |
|
||
| 搜索 | 按标题模糊搜索、按状态筛选 |
|
||
| 新增话题 | 填写标题、描述、封面图URL、排序、状态 |
|
||
| 编辑话题 | 修改话题信息 |
|
||
| 删除话题 | 删除话题及其下所有发布信息 |
|
||
| 状态切换 | 启用/禁用话题 |
|
||
| 查看发布 | 跳转到该话题的用户发布列表 |
|
||
|
||
**接口列表：**
|
||
|
||
| 接口 | 方法 | 路径 | 说明 |
|
||
|-----|------|------|------|
|
||
| 话题列表 | GET | `/api/admin/fate/pool/topic/list` | 分页查询 |
|
||
| 话题详情 | GET | `/api/admin/fate/pool/topic/info/{id}` | 获取单个 |
|
||
| 新增话题 | POST | `/api/admin/fate/pool/topic/save` | 创建 |
|
||
| 更新话题 | POST | `/api/admin/fate/pool/topic/update` | 修改 |
|
||
| 删除话题 | POST | `/api/admin/fate/pool/topic/delete/{id}` | 删除 |
|
||
| 修改状态 | POST | `/api/admin/fate/pool/topic/status/{id}` | 切换状态 |
|
||
|
||
---
|
||
|
||
### 2.2 用户发布管理
|
||
|
||
**页面路径：** `/fatePool/topicUser`
|
||
**页面文件：** `views/fatePool/topicUser/index.vue`
|
||
|
||
| 功能 | 说明 |
|
||
|-----|------|
|
||
| 发布列表 | 分页展示用户发布信息 |
|
||
| 搜索 | 按话题筛选、按昵称搜索、按状态筛选 |
|
||
| 查看详情 | 弹窗展示完整内容和图片 |
|
||
| 删除发布 | 删除用户发布信息 |
|
||
| 状态切换 | 显示/隐藏发布信息 |
|
||
|
||
**接口列表：**
|
||
|
||
| 接口 | 方法 | 路径 | 说明 |
|
||
|-----|------|------|------|
|
||
| 发布列表 | GET | `/api/admin/fate/pool/post/list` | 分页查询 |
|
||
| 发布详情 | GET | `/api/admin/fate/pool/post/info/{id}` | 获取单个 |
|
||
| 删除发布 | POST | `/api/admin/fate/pool/post/delete/{id}` | 删除 |
|
||
| 修改状态 | POST | `/api/admin/fate/pool/post/status/{id}` | 切换状态 |
|
||
|
||
---
|
||
|
||
## 三、许愿树功能
|
||
|
||
### 3.1 许愿树管理
|
||
|
||
**页面路径：** `/wishTree/tree`
|
||
**页面文件：** `views/wishTree/tree/index.vue`
|
||
|
||
| 功能 | 说明 |
|
||
|-----|------|
|
||
| 许愿树列表 | 分页展示许愿树，显示封面、名称、节点数、留言数 |
|
||
| 搜索 | 按名称模糊搜索 |
|
||
| 新增许愿树 | 填写名称、描述、封面图、背景图、排序，可同时添加节点 |
|
||
| 编辑许愿树 | 修改许愿树信息和节点 |
|
||
| 删除许愿树 | 删除许愿树及其所有节点和留言 |
|
||
| 启用/停用 | 设置许愿树启用状态 |
|
||
| 查看留言 | 跳转到该许愿树的留言列表 |
|
||
|
||
**接口列表：**
|
||
|
||
| 接口 | 方法 | 路径 | 说明 |
|
||
|-----|------|------|------|
|
||
| 许愿树列表 | GET | `/api/admin/wish/tree/list` | 分页查询 |
|
||
| 许愿树详情 | GET | `/api/admin/wish/tree/info/{id}` | 获取详情（含节点） |
|
||
| 新增许愿树 | POST | `/api/admin/wish/tree/save` | 创建（含节点） |
|
||
| 更新许愿树 | POST | `/api/admin/wish/tree/update` | 修改（含节点） |
|
||
| 删除许愿树 | POST | `/api/admin/wish/tree/delete/{id}` | 删除 |
|
||
| 启用/停用 | POST | `/api/admin/wish/tree/activate/{id}` | 切换启用状态 |
|
||
|
||
---
|
||
|
||
### 3.2 节点管理
|
||
|
||
**页面路径：** `/wishTree/node`
|
||
**页面文件：** `views/wishTree/node/index.vue`
|
||
|
||
| 功能 | 说明 |
|
||
|-----|------|
|
||
| 节点列表 | 分页展示所有节点，显示所属许愿树、标题、开启时间、留言数 |
|
||
| 搜索 | 按许愿树筛选、按标题搜索、按状态筛选 |
|
||
| 新增节点 | 选择许愿树、填写标题、描述、图标、开启时间、排序 |
|
||
| 编辑节点 | 修改节点信息 |
|
||
| 删除节点 | 删除节点及其所有留言 |
|
||
| 状态切换 | 启用/禁用节点 |
|
||
|
||
**接口列表：**
|
||
|
||
| 接口 | 方法 | 路径 | 说明 |
|
||
|-----|------|------|------|
|
||
| 节点列表 | GET | `/api/admin/wish/tree/node/list` | 分页查询 |
|
||
| 节点详情 | GET | `/api/admin/wish/tree/node/info/{id}` | 获取单个 |
|
||
| 新增节点 | POST | `/api/admin/wish/tree/node/save` | 创建 |
|
||
| 更新节点 | POST | `/api/admin/wish/tree/node/update` | 修改 |
|
||
| 删除节点 | POST | `/api/admin/wish/tree/node/delete/{id}` | 删除 |
|
||
| 修改状态 | POST | `/api/admin/wish/tree/node/status/{id}` | 切换状态 |
|
||
|
||
---
|
||
|
||
### 3.3 用户留言管理
|
||
|
||
**页面路径：** `/wishTree/message`
|
||
**页面文件：** `views/wishTree/message/index.vue`
|
||
|
||
| 功能 | 说明 |
|
||
|-----|------|
|
||
| 留言列表 | 分页展示用户留言，显示节点、用户信息、内容、匿名状态 |
|
||
| 搜索 | 按许愿树/节点筛选、按昵称搜索、按状态筛选 |
|
||
| 查看详情 | 弹窗展示完整内容和图片 |
|
||
| 删除留言 | 删除用户留言 |
|
||
| 状态切换 | 显示/隐藏留言 |
|
||
|
||
**接口列表：**
|
||
|
||
| 接口 | 方法 | 路径 | 说明 |
|
||
|-----|------|------|------|
|
||
| 留言列表 | GET | `/api/admin/wish/tree/message/list` | 分页查询 |
|
||
| 留言详情 | GET | `/api/admin/wish/tree/message/info/{id}` | 获取单个 |
|
||
| 删除留言 | POST | `/api/admin/wish/tree/message/delete/{id}` | 删除 |
|
||
| 修改状态 | POST | `/api/admin/wish/tree/message/status/{id}` | 切换状态 |
|
||
|
||
---
|
||
|
||
## 四、接口参数说明
|
||
|
||
### 4.1 通用分页参数
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|-----|------|------|------|
|
||
| page | Integer | 否 | 页码，默认1 |
|
||
| limit | Integer | 否 | 每页数量，默认10 |
|
||
|
||
### 4.2 缘池话题接口
|
||
|
||
**列表查询参数：**
|
||
```json
|
||
{
|
||
"page": 1,
|
||
"limit": 10,
|
||
"title": "关键词",
|
||
"status": 1
|
||
}
|
||
```
|
||
|
||
**新增/更新参数：**
|
||
```json
|
||
{
|
||
"id": 1,
|
||
"title": "话题标题",
|
||
"description": "话题描述",
|
||
"cover_image": "https://xxx.com/cover.jpg",
|
||
"sort": 100,
|
||
"status": 1
|
||
}
|
||
```
|
||
|
||
### 4.3 许愿树接口
|
||
|
||
**新增/更新参数（含节点）：**
|
||
```json
|
||
{
|
||
"id": 1,
|
||
"name": "许愿树名称",
|
||
"description": "描述",
|
||
"cover_image": "https://xxx.com/cover.jpg",
|
||
"background_image": "https://xxx.com/bg.jpg",
|
||
"sort": 100,
|
||
"nodes": [
|
||
{
|
||
"title": "节点标题",
|
||
"description": "节点描述",
|
||
"icon": "https://xxx.com/icon.png",
|
||
"open_time": "2026-01-01 00:00:00",
|
||
"sort": 0
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 4.4 节点接口
|
||
|
||
**列表查询参数：**
|
||
```json
|
||
{
|
||
"page": 1,
|
||
"limit": 10,
|
||
"tree_id": 1,
|
||
"title": "关键词",
|
||
"status": 1
|
||
}
|
||
```
|
||
|
||
**新增/更新参数：**
|
||
```json
|
||
{
|
||
"id": 1,
|
||
"tree_id": 1,
|
||
"title": "节点标题",
|
||
"description": "节点描述",
|
||
"icon": "https://xxx.com/icon.png",
|
||
"open_time": "2026-01-01 00:00:00",
|
||
"sort": 0,
|
||
"status": 1
|
||
}
|
||
```
|
||
|
||
### 4.5 留言接口
|
||
|
||
**列表查询参数：**
|
||
```json
|
||
{
|
||
"page": 1,
|
||
"limit": 10,
|
||
"tree_id": 1,
|
||
"node_id": 1,
|
||
"nickname": "昵称",
|
||
"status": 1
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 五、菜单入口
|
||
|
||
管理后台左侧菜单：
|
||
|
||
```
|
||
├── 缘池
|
||
│ ├── 话题管理 /fatePool/topic
|
||
│ └── 用户发布 /fatePool/topicUser
|
||
└── 许愿树
|
||
├── 许愿树列表 /wishTree/tree
|
||
├── 留言节点 /wishTree/node
|
||
└── 用户留言 /wishTree/message
|
||
```
|
||
|
||
---
|
||
|
||
## 六、注意事项
|
||
|
||
1. **响应格式**：后端返回 `{code: 200, message: null, data: ...}`，前端 axios 拦截器会直接返回 `data` 部分
|
||
|
||
2. **图片字段**：`images` 字段存储为 JSON 字符串，前端需要解析
|
||
|
||
3. **开启时间**：节点的 `open_time` 为空表示立即开启
|
||
|
||
4. **级联删除**：
|
||
- 删除话题会同时删除该话题下所有发布信息
|
||
- 删除许愿树会同时删除所有节点和留言
|
||
- 删除节点会同时删除该节点下所有留言
|