# 客服联系方式分组列表

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

## ✅ 已完成功能

### 后端接口
- ✅ 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. 刷新前端页面测试