Files

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

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

2026-03-16 01:31:26 +08:00

3.2 KiB

Raw Blame History

📋 前端实现方案：订单级 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/单）。

3.2 KiB Raw Blame History

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

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

2. 交互状态机 (Interaction FSM)

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

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

3.2 KiB

Raw Blame History