2.8 KiB
2.8 KiB
📋 前端实现方案：未来 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展示可申请的贷款额度建议。