48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# 前端集成方案：多平台佣金比例变动自动抓取建议 (Platform Fees) - [BIZ_OPS_158]
|
||
|
||
## 1. 业务场景描述 (Business Context)
|
||
- **目标**：当电商平台（如 Amazon）调整佣金比例时，系统自动捕捉变化并评估其对商户利润的影响，提供精准的调价建议。
|
||
- **用户收益**：防止利润被无声侵蚀，确保每一笔交易都符合利润红线（B2C > 20%），自动化处理复杂的成本核算。
|
||
|
||
## 2. UI 布局草图 (UI Layout Sketch)
|
||
- **费用变动看板 (Fee Event Feed)**:
|
||
- 列表展示：平台、品类、旧费率、新费率、生效日期。
|
||
- 状态：`AUDITED`（已评估）、`ACTION_REQUIRED`（需要调价）。
|
||
- **利润侵蚀模拟器 (Margin Erosion Simulator)**:
|
||
- 展示受影响 SKU 的利润率跌幅。
|
||
- 对比图：调价前利润 vs 调价后利润。
|
||
- **调价建议表 (Adjustment Suggestions)**:
|
||
- 表格列：SKU、当前售价、建议新售价、预估利润率。
|
||
- 操作：`Batch Update Prices`（一键同步到各平台）。
|
||
|
||
## 3. 核心 API 字段映射 (API Mapping)
|
||
- **后端服务**: `PlatformFeeWatcher.auditFeeChanges(tenantId, updates)`
|
||
- **响应结构**:
|
||
```json
|
||
{
|
||
"success": true,
|
||
"suggestions": [
|
||
{
|
||
"productId": "SKU-AMZ-001",
|
||
"advice": "Amazon 佣金上调 1%，预计毛利降至 19.5%（跌破红线）。建议调价至 $59.99。"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
- **因果链呈现 (XAI Integration)**:
|
||
- 浮窗展示：`DecisionExplainabilityEngine.getDecisionNarrative`
|
||
- 叙述：“根据 V30.0 利润保护协议，B2C 利润率必须 > 20%。由于佣金上涨导致原 20.5% 的利润跌至 19.5%，系统自动生成保单建议。”
|
||
|
||
## 4. 交互状态机 (Interaction State Machine)
|
||
- **New Event**: 系统捕获到费率变动，图标闪烁预警。
|
||
- **Review**: 用户进入详情，查看受影响 SKU 列表。
|
||
- **Commit**: 点击“执行调价”，联动 `DynamicPricingService` 发起远程平台 API 调用。
|
||
|
||
## 5. ROI 可视化逻辑 (ROI Tracking)
|
||
- **利润挽回值**: 计算执行调价建议后，相比“不调价”挽回的净利润（$ Recovered Profit $）。
|
||
- **合规达标率**: 展示租户下所有 SKU 符合利润红线的比例。
|
||
|
||
---
|
||
**蓝图维护者**: AI-2 (Internal) | **版本**: V1.0
|
||
**相关任务**: [BIZ_OPS_158](file:///d:/trae_projects/crawlful-hub/docs/governance/collaboration-board.md)
|