makemd/docs/blueprints/frontend-integration/platform-fee-watcher-ui.md

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

  {
    "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