Files
makemd/archive/handover/membership-ltv-ui.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +08:00

2.3 KiB
Raw Blame History

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

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

1. 业务意图 (Business Intent)

  • 核心价值:根据 AGI 预测的客户长期价值 (LTV),自动晋升等级并解锁对应权益,提升高价值客户粘性。
  • 关联后端 ServiceMembershipLTVService.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 预测报告的客户名单。