wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
45 lines
2.3 KiB
Markdown
45 lines
2.3 KiB
Markdown
# 前端集成蓝图：基于 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 预测报告的客户名单。
|