48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
# 客服模块全量修复与数据库构建报告
|
||
|
||
## 摘要
|
||
本次对 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 角色）。
|