# 📋 前端实现方案：订单级 P&L 穿透分析 (Order P&L Analysis)

## 1. UI 布局草图 (UI Layout Sketch)

```
+-------------------------------------------------------------------------+
| [Breadcrumb: Console > Finance > Order Analysis]                        |
+-------------------------------------------------------------------------+
| [Order ID: #ORD-12345] [Status: Delivered] [Platform: Amazon US]        |
+-------------------------------------------------------------------------+
| +-------------------------+ +-------------------------+ +-------------+ |
| | 营收 (Revenue)          | | 基础净利 (Base Profit)  | | 真实毛利 (ROI) | |
| | $120.00                 | | $35.50                  | | 24.5%       | |
| +-------------------------+ +-------------------------+ +-------------+ |
+-------------------------------------------------------------------------+
| [穿透式成本拆解 (Deep Cost Breakdown)]                                    |
| +---------------------------------------------------------------------+ |
| | 项 (Item)               | 金额 (Amount) | 备注 (Note)               | |
| |-------------------------|---------------|---------------------------| |
| | 商品成本 (COGS)         | -$40.00       | 采购价 + 运费              | |
| | 平台佣金 (Fee)          | -$18.00       | Amazon Referral Fee (15%) | |
| | 物流费用 (Logistics)    | -$25.00       | Last-mile delivery        | |
| | 隐形成本 (Hidden Cost)  | -$1.50        | [ERP/工具费摊销] (Amortized)| |
| | 汇损/手续费 (FX/Bank)   | -$0.50        | 提现损耗                  | |
| |-------------------------|---------------|---------------------------| |
| | 最终真实净利 (Net)      | $35.00        | 剔除所有隐形成本           | |
| +---------------------------------------------------------------------+ |
+-------------------------------------------------------------------------+
| [AI 建议 (AI Insights)]                                                 |
| > 该订单隐形成本占比 1.25%，处于健康范围。建议保持当前物流路径。             |
+-------------------------------------------------------------------------+
```

## 2. 交互状态机 (Interaction FSM)

- **IDLE**: 页面初始加载。
- **LOADING**: 调用 `/api/finance/order-profit/:orderId` 获取穿透数据。
- **SUCCESS**: 渲染仪表盘与成本表格。
- **ERROR**: 弹出错误提示，支持“重试”按钮。

## 3. 核心 API 字段映射 (API Field Mapping)

| 前端字段 (Frontend) | 后端 API 字段 (Backend) | 说明 (Description) |
| :--- | :--- | :--- |
| 营收 | `platformAmount` | 订单总金额 |
| 基础净利 | `baseNetProfit` | 未剔除摊销前的利润 |
| 隐形成本 | `hiddenCost` | ERP/工具费等分摊成本 |
| 真实净利 | `realNetProfit` | 最终到手利润 |
| 真实毛利率 | `realMargin` | `realNetProfit / platformAmount` |

## 4. ROI 可视化逻辑 (ROI Visualization)

- **进度条**: 使用颜色渐变 (Red < 10% < Yellow < 20% < Green) 展示毛利率。
- **因果叙述**: 联动 `DecisionExplainabilityEngine` 展示隐形成本的计算依据（如：本月总工具费 $500 / 总订单 5000 = $0.1/单）。