makemd/docs/blueprints/frontend-integration/membership-ltv-ui.md

前端集成蓝图：基于 LTV 预测的自动化会员治理 (LTV Membership)

[AI-3 @ 2026-03-14]：由后端 Agent 在完成 BIZ_MKT_60 逻辑后产出。

1. 业务意图 (Business Intent)

• 核心价值：根据 AGI 预测的客户长期价值 (LTV)，自动晋升等级并解锁对应权益，提升高价值客户粘性。
• 关联后端 Service：MembershipLTVService.ts

2. UI/UX 布局方案 (Layout Design)

• 页面入口：Console -> 客户成功 -> 会员等级管理
• 展示组件：
  • 客户 LTV 分布图：展示不同等级客户的预测 LTV 分布。
  • 晋升记录流：展示最近自动晋升的客户及其预测理由。
  • 等级权益看板：展示 BRONZE, SILVER, GOLD, PLATINUM 对应的权益。
• 交互草图：

  +-----------------------------------------------------------+
  | [Icon] 自动化会员等级管理 (LTV Membership)               |
  +-----------------------------------------------------------+
  | [ 客户 DID: DID-7890 ] [ 当前等级: GOLD ] [ 预测 LTV: $2,500 ] |
  +-----------------------------------------------------------+
  | 历史消费: $1,200 | 订单数: 15 | AGI 预测理由: "高复购潜力"    |
  +-----------------------------------------------------------+
  | [ AGI 权益建议 (Tier Benefits) ]                          |
  | "该客户已自动晋升至 GOLD 等级。已解锁：专属客服、         |
  | 满 $100 减 $20 优惠券、新品优先抢购权。"                  |
  +-----------------------------------------------------------+
  | [ 撤销晋升 ]                      [ 发送晋升通知给客户 ]   |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/marketing/membership/evaluate?did=DID-7890
• 关键字段映射
  • predicted_ltv -> 预测 LTV
  • tier -> 建议等级
  • historical_spend -> 历史消费额
• 状态流转：
  • 系统定时任务 -> 调用 MembershipLTVService.evaluateTier -> 更新 UI 中的等级状态。

4. 生产校验项 (FE Readiness)

• LTV 预测模型的参数可配置界面。
• 等级晋升的消息推送模板配置。
• 导出包含 LTV 预测报告的客户名单。