96 lines
3.0 KiB
Markdown
96 lines
3.0 KiB
Markdown
# 客服联系方式分组列表
|
||
|
||
## 功能说明
|
||
帮助中心 - 客服联系方式分组列表，用于展示客服的联系方式信息。
|
||
|
||
## ✅ 已完成功能
|
||
|
||
### 后端接口
|
||
- ✅ Model层：`CustomerServiceGroup.java` - 客服联系方式分组实体
|
||
- ✅ Dao层：`CustomerServiceGroupDao.java` - Dao接口
|
||
- ✅ Service层：`CustomerServiceGroupService.java` - 服务接口
|
||
- ✅ Service实现：`CustomerServiceGroupServiceImpl.java` - 服务实现
|
||
- ✅ Controller层：`CustomerServiceGroupController.java` - 控制器
|
||
- ✅ Mapper XML：`CustomerServiceGroupMapper.xml` - Mapper配置
|
||
|
||
### 前端实现
|
||
- ✅ 前端界面：`admin/src/views/help/customerServiceGroup/index.vue`
|
||
- ✅ 前端API：`admin/src/api/customerServiceGroup.js`
|
||
- ✅ 前端路由：`admin/src/router/modules/help.js`
|
||
- ✅ 菜单配置：已添加到"帮助中心"菜单
|
||
|
||
## 📊 数据库表结构
|
||
|
||
### 表名：eb_customer_service_group
|
||
|
||
```sql
|
||
CREATE TABLE `eb_customer_service_group` (
|
||
`id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||
`group_name` varchar(100) NOT NULL DEFAULT '' COMMENT '用户组名称',
|
||
`avatar` varchar(255) DEFAULT NULL COMMENT '用户头像',
|
||
`contact` varchar(100) NOT NULL DEFAULT '' COMMENT '联系电话或微信',
|
||
`contact_type` tinyint(2) DEFAULT '1' COMMENT '联系类型：1-电话 2-微信',
|
||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||
PRIMARY KEY (`id`),
|
||
KEY `idx_group_name` (`group_name`),
|
||
KEY `idx_create_time` (`create_time`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='客服联系方式分组表';
|
||
```
|
||
|
||
### 字段说明
|
||
- `id` - 主键ID
|
||
- `group_name` - 用户组名称
|
||
- `avatar` - 用户头像URL
|
||
- `contact` - 联系电话或微信
|
||
- `contact_type` - 联系类型（1-电话 2-微信）
|
||
- `create_time` - 创建时间
|
||
- `update_time` - 更新时间
|
||
|
||
## 🔌 API接口
|
||
|
||
### 列表查询
|
||
- **接口地址**：`GET /api/admin/help/customer-service-group/list`
|
||
- **请求参数**：
|
||
- `groupName` - 用户组名称（可选，模糊搜索）
|
||
- `page` - 页码
|
||
- `limit` - 每页数量
|
||
- **返回格式**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"list": [
|
||
{
|
||
"id": 1,
|
||
"groupName": "技术支持",
|
||
"avatar": "http://example.com/avatar.jpg",
|
||
"contact": "13800138000",
|
||
"contactType": 1,
|
||
"createTime": "2025-11-29 19:50:49"
|
||
}
|
||
],
|
||
"total": 111
|
||
}
|
||
}
|
||
```
|
||
|
||
## 🎯 界面功能
|
||
- ✅ 搜索功能（按用户组名称）
|
||
- ✅ 列表展示（id、用户组、用户头像、联系电话或微信、创建时间）
|
||
- ✅ 分页功能
|
||
- ✅ 连接真实数据库
|
||
|
||
## ⚠️ 注意事项
|
||
1. 目前只实现列表查询和展示功能
|
||
2. 暂未实现增删改查操作
|
||
3. 需要在数据库中执行建表SQL
|
||
4. 需要授权数据库访问权限
|
||
|
||
## 🔄 下一步
|
||
1. 执行建表SQL创建数据库表
|
||
2. 插入测试数据
|
||
3. 重启后端服务
|
||
4. 刷新前端页面测试
|