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

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

docs/blueprints/frontend-integration/order-profit-analysis.md

@@ -0,0 +1,54 @@
+# 📋 前端实现方案：订单级 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/单）。