72 lines
3.4 KiB
Markdown
72 lines
3.4 KiB
Markdown
# 页面名：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 悬浮按钮
|