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

docs/h5_ui/interactions/customer-detail.md

@@ -0,0 +1,71 @@
+# 页面名：customer-detail（客户详情）
+
+> PRD 参考：P9 `docs/prd/specs/P9-miniapp-fe-details.md`
+> 已实现：否
+
+## 页面说明
+展示客户全信息、消费记录（三种样式）、指数总览、备注、AI 维客线索、AI 客户分析。纯静态展示页（原型中无复杂交互函数）。
+
+## 状态变量
+| 变量名 | 类型 | 初始值 | 说明 |
+|--------|------|--------|------|
+| customerInfo | object | null | 客户信息（昵称、手机、会员卡等级、余额、注册日期） |
+| indexes | object | null | 指数总览（WBI/NCI/SPI + 爱心 icon） |
+| consumptionRecords | array | [] | 消费记录列表 |
+| consumptionPage | number | 1 | 消费记录当前页 |
+| hasMoreRecords | boolean | true | 是否还有更多消费记录 |
+| retentionClues | array | [] | AI 维客线索（应用 8） |
+| customerAnalysis | object | null | AI 客户分析（应用 7） |
+| notes | array | [] | 备注列表 |
+| loading | boolean | true | 数据加载中 |
+| error | boolean | false | 加载失败 |
+| loadingMore | boolean | false | 加载更多消费记录中 |
+
+## 用户操作 → 响应（忠于原型 HTML）
+| 操作 | 触发条件 | 响应行为 | 目标状态 |
+|------|----------|----------|----------|
+| 页面加载 | 进入页面 | 请求客户详情+指数+消费记录+AI 数据 | loading→false |
+| 滚动到底部 | hasMoreRecords=true | GET 消费记录下一页（每次 10 条） | loadingMore=true→false |
+| 点击"问问助手" | 底部按钮 | navigateTo chat（`window.location.href='chat.html'`） | — |
+| 点击返回 | 顶部导航栏 | navigateBack（`history.back()`） | — |
+
+> 原型 HTML 中仅有两个内联事件：顶部返回 `history.back()` 和底部"问问助手" `window.location.href='chat.html'`，无其他动态交互函数。
+
+## 消费记录三种样式
+1. 台桌结账：下沉到 `dwd_table_fee_log`，每条台费详情，关联总金额汇总
+2. 商城订单：助教列表（花名+级别+课程类型+服务时长+定档绩效）、支付金额、食品酒水总金额
+3. 充值：充值金额、支付方式
+
+## 消费记录展示规则
+- 默认 10 条，拉到底懒加载（每次 10 条）
+- 金额为 0 的项不展示
+- 有团购/折扣时展示正价+实付
+- 总金额仅在消费条目 >1 时出现
+
+## AI 区域展示
+- 维客线索（应用 8）：Emoji 二级标签，提供者逗号分隔（By:系统/By:备注）
+- 客户分析（应用 7，`cache_type=app7_customer_analysis`）：运营策略数组 + 总结
+  - 触发时机（PRD 补充）：客户结账单出现后自动生成
+  - 应用 3 与应用 7 共用同一 cache_type，应用 3 为简版摘要，应用 7 为完整分析
+
+## 页面状态枚举
+| 状态名 | 视觉表现 | 触发条件 |
+|--------|----------|----------|
+| 加载中 | 区域文案"加载中..." | loading=true |
+| 正常态 | 完整客户详情 | 有数据 |
+| 错误态 | "加载失败，请点击重试" + 重试按钮 | error=true |
+
+## 后端 API 依赖
+| API | 方法 | 说明 |
+|-----|------|------|
+| `GET /api/customers/:id` | GET | 客户详情 |
+| `GET /api/customers/:id/consumption-records` | GET | 消费记录（分页，懒加载） |
+| `GET /api/customers/:id/indexes` | GET | 客户指数总览 |
+
+## 页面导航
+- 来源：board-customer（点击客户卡片）/ task-detail / performance
+- 去向：chat（问问助手）
+
+## 全局组件
+- 自定义顶部导航栏（返回按钮 + "客户详情"）
+- AI 悬浮按钮