wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
51 lines
2.8 KiB
Markdown
51 lines
2.8 KiB
Markdown
# 📋 前端实现方案：未来 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` 展示可申请的贷款额度建议。
|