# 前端集成蓝图：基于 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 对应的权益。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [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 预测报告的客户名单。