微信小程序页面迁移校验之前 P5任务处理之前

2026-03-09 01:19:21 +08:00
parent 263bf96035
commit 6e20987d2f
1112 changed files with 153824 additions and 219694 deletions
--- a/docs/prd/specs/01-SPEC任务拆分总览.md
+++ b/docs/prd/specs/01-SPEC任务拆分总览.md
@@ -3,6 +3,13 @@
 > 生成日期：2026-02-23
 > 按依赖优先级排序，按 SPEC 边界分组，面向 Kiro SPEC 工作流

+> **数据字段权威参考**：各 SPEC 涉及的 DWD/DWS 层字段来源、金额口径、业务逻辑，
+> 以 `docs/reports/DWD-DOC/` 校准文档为准（数据快照 2026-03-06）。
+> 核心规则：
+> - `consume_money` 存在三种历史口径混合，不可直接使用；应使用 `items_sum`（= table_charge_money + goods_money + assistant_pd_money + assistant_cx_money + electricity_money）
+> - 收入结构拆分为台桌费、陪打费、超休费、商品费、电费五项，不使用笼统的 `service_fee`
+> - 详见 [consume_money 口径说明](../reports/DWD-DOC/consume/consume-money-caliber.md)、[财务全景](../reports/DWD-DOC/03-financial-panorama.md)
+
 ---

 ## 执行顺序总览
@@ -124,13 +131,13 @@ P11 部署与上线（环境配置 + 监控 + 灰度）
 4. 任务状态机：有效/无效 + 有效期机制
 5. 48 小时回访滞留逻辑
 6. 召回完成检测（ETL 数据到达后自动标记）
-7. 数据回溯机制（召回完成后回溯备注分类）
+7. 数据回溯机制（召回完成后回溯备注分类 + 触发 AI 备注分析）
 8. 任务置顶/放弃 API

 #### 备注系统
-9. 新建表：`biz.notes`（type 区分：普通/回访/生日/放弃原因）
-10. 备注 CRUD API
-11. 生日信息隔离存储（不被 ETL 数据覆盖）
+9. 新建表：`biz.notes`（type 区分：普通/回访/放弃原因，含星星评分字段 `rating_service_willingness`、`rating_revisit_likelihood` 各 1-5 可空）
+10. 备注 CRUD API（含星星评分的存储与读取）
+11. 生日信息已迁移至维客线索系统（`member_retention_clue`），不再作为 notes type

 #### 触发器机制
 12. 新建表：`biz.trigger_jobs`（触发器配置与执行日志）
@@ -148,7 +155,9 @@ P11 部署与上线（环境配置 + 监控 + 灰度）
 - 48 小时滞留机制正常工作
 - 召回完成后自动标记任务完成
 - 数据回溯正确将普通备注重分类为回访备注
- 备注 CRUD 正常，生日信息独立存储
+- 备注 CRUD 正常，维客线索独立于 ETL 数据
+- 备注星星评分正确存储（不参与完成判定，不参与应用 6 分析，仅辅助数据）
+- 回访任务默认展开评分区域，其他任务类型默认隐藏可手动展开

 ---

@@ -156,20 +165,29 @@ P11 部署与上线（环境配置 + 监控 + 灰度）

 ### SPEC 名称建议：`miniapp-ai-integration`

+### ⚠️ 两阶段交付策略（2026-03-07 评审决定）
+
+应用 3/4/5/6/7 的首条 Prompt JSON 结构包含占位符字段（`consumption_records`、`service_history`、`objective_data` 等），这些字段的具体结构取决于对应页面 API 的数据格式。因此 P5 拆分为两个阶段：
+
+- P5-A（当前阶段）：建表、百炼封装、缓存 API、SSE 框架 + Prompt 已确定的应用（应用 2、应用 8）+ 应用 3/4/5/6/7 的触发机制和调用骨架
+- P5-B（Prompt 细化）：分散到对应页面 spec 中同步完成（P6-T4 细化应用 4/5，P9-T1 细化应用 3/6/7）
+
 ### 需求概述
-对接阿里云百炼 6 个 AI 应用，实现对话系统、后台轮询缓存、备注含金量评分。
+对接阿里云百炼 8 个 AI 应用，实现对话系统、后台轮询缓存、备注分析。

 ### 关键交付物
 1. 新建表：`biz.ai_conversations`、`biz.ai_messages`、`biz.ai_cache`
 2. 百炼 API 封装：统一调用层（支持流式/非流式）
 3. 应用 1：通用对话 API（SSE 流式返回）
-4. 应用 2：财务洞察轮询任务（每日更新，多时间维度交叉）
-5. 应用 3：客户消费习惯分析轮询（客户新增消费时触发）
-6. 应用 4：客户-助教关系分析轮询（助教参与新结算时触发）
-7. 应用 5：话术参考（应用 4 调用时联动）
-8. 应用 6：备注含金量评分（回访任务完成时触发）
-9. AI 结果缓存读写 API
-10. 页面内容文本化工具（将页面数据转为 AI 可读文本）
+4. 应用 2：财务洞察轮询任务（每日更新，多时间维度交叉）【P5-A，Prompt 已确定】
+5. 应用 3：客户维客线索分析轮询（客户新增消费时触发）【P5-A 骨架 + P9-T1 细化 Prompt】
+6. 应用 4：客户-助教关系分析轮询（助教参与新结算时触发）【P5-A 骨架 + P6-T4 细化 Prompt】
+7. 应用 5：话术参考（应用 4 调用时联动）【P5-A 骨架 + P6-T4 细化 Prompt】
+8. 应用 6：备注分析（每个备注提交时触发）【P5-A 骨架 + P9-T1 细化 Prompt】
+9. 应用 7：客户分析（结账单触发）【P5-A 骨架 + P9-T1 细化 Prompt】
+10. 应用 8：维客线索整理（应用 3/6 产出后触发）【P5-A，Prompt 已确定】
+11. AI 结果缓存读写 API
+12. 页面内容文本化工具（随 P6-P9 各页面逐步实现）

 ### 依赖
 - P3（用户身份，AI 信息隔离需要传入身份参数）
@@ -178,8 +196,32 @@ P11 部署与上线（环境配置 + 监控 + 灰度）
 ### 验收标准
 - 应用 1 流式对话正常
 - 应用 2-5 轮询任务按条件触发并缓存结果
- 应用 6 在回访备注提交后自动评分，6 分以上标记完成
+- 应用 6 在每个备注提交后自动分析，返回评分+维客线索
+- 应用 7 在客户结账单出现后触发，生成运营策略
+- 应用 8 在应用 3/6 产出后触发，整合去重维客线索
 - 所有 AI 对话记录持久化（含系统调用）
+- P5-A 验收：应用 2/8 完整可用，应用 3/4/5/6/7 触发机制和调用框架就绪（Prompt 拼接为 TODO 接口）
+- P5-B 验收：随 P6-T4、P9-T1 完成后，对应应用的 Prompt 拼接函数实现并联调通过
+
+---
+
+## P5.1：MCP Server AI 扩展 — 查库手册 + 业务库接入
+
+### SPEC 名称建议：`mcp-server-ai-extension`
+
+### 分批执行（2026-03-07 评审决定）
+
+- 批次 A（立即可执行）：重写 ETL 库查库手册（DWD-DOC 已完成）
+- 批次 B（P5-A 之后）：MCP Server 新增 `zqyy_app` 连接 + 业务库手册
+- 批次 C（批次 B 后）：手册上传百炼验证
+
+### 需求概述
+扩展 MCP Server 支持 `zqyy_app` 业务库查询，重写查库手册供百炼平台 AI 应用作为知识库。
+
+### 依赖
+- 批次 A：无（DWD-DOC 已完成）
+- 批次 B：P1 + P4 + P5-A（biz 表已建）
+- 批次 C：批次 B

 ---

@@ -192,14 +234,16 @@ P11 部署与上线（环境配置 + 监控 + 灰度）

 ### 关键交付物
 1. task-list.html → 小程序页面：任务列表（按优先级分组）、长按操作（置顶/放弃/AI）、绩效计算展示、跳档激励
-2. task-detail.html → 小程序页面：任务详情、近期服务记录、备注入口、AI 分析展示（消费习惯/关系分析/话术/备注星级）
+2. task-detail.html → 小程序页面：任务详情、近期服务记录、备注入口（含星星评分）、AI 分析展示（维客线索/关系分析/话术/备注分析评分）
 3. notes.html → 小程序页面：备注列表、删除（二次确认）
 4. 通用组件：爱心 icon（💖🧡💛💙）、喜好标签（🎱斯🀅🎤）、跟/弃 icon、预估标记

 ### 依赖
 - P3（登录态）
 - P4（任务/备注 API）
- P5（AI 缓存数据展示）
+- P5-A（AI 缓存数据展示 + 应用 4/5 调用骨架）
+
+> P6-T4 同时承担 P5-B 的应用 4/5 Prompt 细化任务（服务记录结构确定后实现拼接函数）

 ---

@@ -259,9 +303,11 @@ P11 部署与上线（环境配置 + 监控 + 灰度）

 ### 依赖
 - P3（登录态）
- P5（AI 对话系统）
+- P5-A（AI 对话系统 + 应用 3/6/7 调用骨架）
 - P4（备注系统）

+> P9-T1 同时承担 P5-B 的应用 3/6/7 Prompt 细化任务（消费记录结构确定后实现拼接函数）
+
 ---

 ## P10：租户管理后台
@@ -273,7 +319,7 @@ P11 部署与上线（环境配置 + 监控 + 灰度）

 ### 关键交付物
 1. 独立 Web 应用（React + Vite + Ant Design，类似 `apps/admin-web/` 技术栈）
-2. 租户管理员登录（独立凭据体系）
+2. 租户管理员登录（独立凭据体系，账号由系统管理后台 `apps/admin-web/` 创建，不可自行注册）
 3. 用户审核页面：申请列表、状态筛选、关联建议（球房ID+手机号匹配助教）、审核操作
 4. 用户管理页面：用户列表、身份编辑、店铺归属编辑
 5. Excel 上传页面：4 种模板（财务支出/团购收入/助教奖罚/充值业绩归属）
@@ -281,15 +327,19 @@ P11 部署与上线（环境配置 + 监控 + 灰度）
 7. 冲突处理：前端 diff 交互（逐条确认替换/保留）
 8. 后端 API：Excel 解析、校验、冲突检测、确认写入
 9. 新建表：`biz.salary_adjustments`、`biz.excel_upload_log`
+10. 维客线索管理页面：按客户列出全部线索（标签/摘要/提供人/备注原文），支持修改、删除、隐藏操作

 ### 依赖
 - P1（数据库基础）
 - P3（用户体系，共享 `auth` Schema）
+- admin-web-console 需求 11（租户管理员账号管理功能，提供账号创建入口）

 ### 验收标准
- 租户管理员只能看到自己租户下的店铺数据
+- 租户管理员账号由系统管理后台创建，租户管理员不可自行注册
+- 租户管理员只能看到自己租户下的店铺数据（由 Operator 分配的 `site_id` 列表决定）
 - Excel 上传校验正确，冲突 diff 交互可用
 - 用户审核流程完整（申请→审核→分配身份→关联助教）
+- 维客线索管理：按客户查看全部线索，修改/删除/隐藏操作正常

 ---

@@ -320,14 +370,19 @@ P11 部署与上线（环境配置 + 监控 + 灰度）
 ```
 P1 ─────┬──→ P2 ──→ P7
        │          ↘
-        ├──→ P3 ──→ P4 ──→ P5 ──→ P6
-        │     │           ↗       ↘
-        │     └──→ P10    P8 ←── P9
+        ├──→ P3 ──→ P4 ──→ P5-A ──→ P6（含 P5-B 应用4/5 Prompt 细化）
+        │     │                  ↘
+        │     └──→ P10            P8
+        │                          ↘
+        │                      P9（含 P5-B 应用3/6/7 Prompt 细化）
        │
        └──→ P11（全部完成后）
 ```

+> P5-A 交付管道和骨架后，P6/P8/P9 即可启动。
+> P5-B 的 Prompt 细化任务嵌入 P6-T4（应用4/5）和 P9-T1（应用3/6/7），不作为独立阶段。
+
 可并行的 SPEC 组合：
 - P2 和 P3 可并行（无互相依赖）
- P6、P7、P8、P9 在后端 API 就绪后可部分并行
+- P6、P7、P8、P9 在 P5-A 完成后可部分并行
 - P10 在 P1+P3 完成后即可启动，与 P4-P9 并行