docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书

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

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