medical-mall/docs/ops/2026-02-11__admin__kefu-module-repaired-full.md

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

摘要

本次对 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 角色）。