# 客服模块全量修复与数据库构建报告

## 摘要
本次对 Admin 侧客服模块（Kefu Module）进行了深度的端到端修复，补齐了该模块完全缺失的数据库表结构、行级安全策略（RLS）以及管理端 RPC 接口。同时重构了前端 5 个核心页面，彻底解决了该模块此前全量 Mock 的问题。

## 修复范围

### 1. 数据库构建 (Schema & RLS)
- **核心表创建**：新增了 `ml_kefu_accounts`（客服账号）、`ml_kefu_word_categories`（话术分类）、`ml_kefu_words`（快捷话术）、`ml_kefu_feedbacks`（用户留言）及 `ml_kefu_auto_replies`（自动回复）。
- **安全隔离**：配置了 RLS 策略，确保普通用户仅能提交及查看个人留言，Admin 侧通过 RPC 拥有管理权限。

### 2. RPC 接口补全 (SECURITY DEFINER)
- 实现了 11 个标准 RPC 接口，涵盖：
    - 客服账号的分页查询、状态切换及删除。
    - 话术分类的 CRUD 联动。
    - 用户留言的处理与回复。
    - 关键词自动回复的配置管理。
    - 客服全局配置的读取与持久化。

### 3. 前端页面重构 (去 Mock)
- **客服列表 (`list.uvue`)**：接入账号管理 RPC，支持实时状态同步。
- **客服话术 (`words.uvue`)**：实现了左侧分类树联动右侧话术列表的真实交互。
- **用户留言 (`feedback.uvue`)**：实现了留言分页列表及弹窗快捷回复处理。
- **自动回复 (`auto_reply.uvue`)**：补全了关键词配置的增删改查逻辑。
- **客服配置 (`config.uvue`)**：实现了三种客服模式（系统/电话/链接）的真实存取。

## 变更清单

### 数据库 SQL
- `docs/sql/10_schema/kefu/ml_kefu_tables_v1.sql` (新增)
- `docs/sql/20_rls/kefu/ml_kefu_rls_v1.sql` (新增)
- `docs/sql/30_rpc/kefu/` (新增 11 个接口文件)

### 前端代码
- `services/admin/kefuService.uts` (新增)
- `pages/mall/admin/kefu/` 目录下 5 个 `.uvue` 文件的逻辑与 UI 重构。

## 验证说明
1. **数据库执行**：需依次执行 `10_schema` -> `20_rls` -> `30_rpc` 下的客服模块脚本。
2. **功能验证**：
   - 话术管理：确认添加分类后，新增话术能正确关联并显示。
   - 留言处理：确认点击处理并输入回复后，状态能变为“已处理”。
   - 状态切换：确认客服列表的开关能真实修改数据库状态。

## 关联规范
- 遵循 `AGENT_PROJECT_SPEC.md` 规范。
- 遵循统一的 RPC 入口鉴权（admin/analytics 角色）。