feat(admin): complete full integration of kefu, finance, product and order modules with real RPC data streams

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

@@ -0,0 +1,47 @@
+# 客服模块全量修复与数据库构建报告
+
+## 摘要
+本次对 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 角色）。