# 📋 前端实现方案：未来 30 天现金流预测 (Cashflow Prediction)

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

```
+-------------------------------------------------------------------------+
| [Breadcrumb: Console > Finance > Cashflow Forecast]                     |
+-------------------------------------------------------------------------+
| [Current Cash: $50,000.00] [Projected Day 30: $12,450.00]               |
+-------------------------------------------------------------------------+
| [现金流瀑布图 (Cashflow Waterfall)]                                       |
| [Chart: 当前(柱) -> +待收(绿) -> -待付(红) -> 预计(柱)]                   |
|-------------------------------------------------------------------------|
| [收支详情 (Breakdown)]                                                   |
| +---------------------------------------------------------------------+ |
| | 类型 (Type)             | 金额 (Amount) | 关键来源 (Source)         | |
| |-------------------------|---------------|---------------------------| |
| | 待结回款 (Receivables)  | +$80,000.00   | Amazon/TikTok Shipped Orders| |
| | 供应商欠款 (Payables)   | -$110,000.00  | Pending Purchase Orders   | |
| | 运营成本 (OpEx)         | -$7,550.00    | Salaries/Tools/Server     | |
| |-------------------------|---------------|---------------------------| |
| | 预计净变化 (Net)        | -$37,550.00   |                           | |
| +---------------------------------------------------------------------+ |
+-------------------------------------------------------------------------+
| [风险预警 (Risk Alert)]                                                 |
| > [WARNING] 预计 25 天后现金余额将低于安全阈值 (20%)。建议推迟部分采购计划。   |
+-------------------------------------------------------------------------+
```

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

- **INIT**: 初始化加载。
- **PREDICTING**: 调用 `/api/finance/cashflow/predict`。
- **ALERTING**: 若 `projectedCash < 0` 触发全局红色顶栏告警。
- **SIMULATING**: 支持手动调整“待收回款比例”查看不同情景下的预测。

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

| 前端字段 (Frontend) | 后端 API 字段 (Backend) | 说明 (Description) |
| :--- | :--- | :--- |
| 当前可用现金 | `currentCash` | 实时账户余额 |
| 未来30天预计 | `projectedCash` | 计算后的期末余额 |
| 待收总额 | `totalReceivables` | 已发货未结算订单总额 |
| 待付总额 | `totalPayables` | 待支付采购单总额 |
| 风险等级 | `riskLevel` | LOW/WARNING/CRITICAL |

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

- **生存天数 (Burn Rate)**: 自动算出按当前净支出速度，现金还能支撑多少天。
- **资金缺口建议**: 联动 `SovereignCreditPoolService` 展示可申请的贷款额度建议。