blame | 历史 | 原始文档

常见问题管理模块 - 部署文档

功能概述

常见问题管理模块用于管理系统中的FAQ内容，支持问题的增删改查、排序、状态管理等功能。

部署步骤

1. 数据库配置

1.1 创建数据表

执行SQL脚本创建常见问题表：
bash # 路径：mx_charging_pile/sql/20260625_faq_management.sql

该脚本会创建：
- sys_faq 表：存储常见问题数据
- 包含3条示例数据

1.2 配置菜单权限

执行菜单配置脚本：
bash # 路径：mx_charging_pile/sql/20260625_faq_menu.sql

重要提示：
1. 执行前需要查询 sys_menu 表，找到"系统管理"的 menu_id
2. 将脚本中的 parent_id 修改为实际的系统管理菜单ID
3. 执行主菜单插入后，查询新插入的菜单ID
4. 将脚本中的 @@faqMenuId@@ 替换为实际的菜单ID
5. 然后执行按钮权限的插入语句

2. 后端部署

2.1 已创建的文件清单

mx_charging_pile/ruoyi-modules/ruoyi-system/src/main/java/com/ruoyi/system/
├── domain/
│   └── SysFaq.java                    # 实体类
├── mapper/
│   └── SysFaqMapper.java              # Mapper接口
├── service/
│   ├── ISysFaqService.java            # Service接口
│   └── impl/
│       └── SysFaqServiceImpl.java     # Service实现
└── controller/
    └── SysFaqController.java          # Controller控制器

mx_charging_pile/ruoyi-modules/ruoyi-system/src/main/resources/mapper/system/
└── SysFaqMapper.xml                    # MyBatis映射文件

2.2 重启服务

重启 ruoyi-system 模块：
bash cd mx_charging_pile # 根据实际部署方式重启服务

3. 前端部署

3.1 已创建的文件清单

mx_charging_pile/ruoyi-ui/src/
├── api/system/
│   └── faq.js                         # API接口
└── views/system/faq/
    └── index.vue                      # 页面组件

3.2 构建前端

cd mx_charging_pile/ruoyi-ui
npm run build:prod

4. 功能验证

4.1 登录系统

使用管理员账号登录系统

4.2 菜单访问

导航到：系统管理 -> 常见问题管理

4.3 功能测试

[ ] 查看列表：验证示例数据是否显示
[ ] 搜索功能：按问题标题搜索
[ ] 新增问题：添加新的常见问题
[ ] 编辑问题：修改已有问题
[ ] 删除问题：删除单个或批量删除
[ ] 状态切换：正常/停用状态切换
[ ] 排序功能：修改排序号验证排序
[ ] 导出功能：导出Excel文件

数据表结构

sys_faq 表字段说明

字段名	类型	说明
faq_id	bigint	问题ID（主键，自增）
question	varchar(500)	问题标题
answer	text	问题答案
sort_order	int	排序号
status	char(1)	状态（0正常 1停用）
create_by	varchar(64)	创建者
create_time	datetime	创建时间
update_by	varchar(64)	更新者
update_time	datetime	更新时间
remark	varchar(500)	备注
del_flag	char(1)	删除标志（0存在 2删除）

API接口说明

基础路径

/system/faq

接口列表

接口	方法	说明	权限
/list	GET	查询列表	system:faq:list
/{faqId}	GET	查询详情	system:faq:query
/	POST	新增	system:faq:add
/	PUT	修改	system:faq:edit
/{faqIds}	DELETE	删除	system:faq:remove
/export	POST	导出	system:faq:export

权限标识

system:faq:list    # 列表查询
system:faq:query   # 详情查询
system:faq:add     # 新增
system:faq:edit    # 修改
system:faq:remove  # 删除
system:faq:export  # 导出

注意事项

数据库执行顺序：先执行表结构SQL，再执行菜单SQL
菜单ID替换：务必替换菜单SQL中的占位符为实际ID
权限分配：执行完菜单SQL后，需要为相应角色分配权限
服务重启：后端代码修改后需要重启对应服务
前端构建：前端代码修改后需要重新构建部署

常见问题

Q1: 菜单不显示？

A: 检查以下几点：
- 菜单SQL是否正确执行
- 当前角色是否有对应菜单权限
- 前端路由配置是否正确

Q2: 接口调用失败？

A: 检查以下几点：
- 后端服务是否正常启动
- 网关配置是否正确
- 权限标识是否配置

Q3: 列表无数据？

A: 检查以下几点：
- 数据表SQL是否执行成功
- 示例数据是否插入
- del_flag字段是否为'0'

开发者信息

开发日期：2026-06-25
模块位置：ruoyi-system
数据库：charging_pile_other（根据实际情况）