zhibo/archive/Zhibo/zhibo-1201/小张/待开发功能/客服联系方式分组列表.md

客服联系方式分组列表

功能说明

帮助中心 - 客服联系方式分组列表，用于展示客服的联系方式信息。

✅ 已完成功能

后端接口

• ✅ 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

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 - 每页数量
• 返回格式：

{
  "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. 刷新前端页面测试