# 前端集成方案：多平台佣金比例变动自动抓取建议 (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)