Neo-ZQYY/docs/h5_ui/interactions/customer-detail.md

页面名：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 悬浮按钮