Методы для прогнозирования финансов организации на основе исторических данных. Используется математическая модель Theta, работающая от 2 точек анализа и не требующая настройки.
Возвращает массив точек для построения графика прогноза баланса. Исторические точки помечены is_actual: true, прогнозные — is_actual: false.
{
"status": true,
"message": "Forecast generated successfully",
"data": {
"method": "theta",
"points": [
{ "date": "2026-06-10", "balance": 45000.00, "is_actual": true },
{ "date": "2026-06-11", "balance": 52000.00, "is_actual": true },
{ "date": "2026-06-12", "balance": 48500.00, "is_actual": true },
{ "date": "2026-06-13", "balance": 51000.00, "is_actual": true },
{ "date": "2026-06-14", "balance": 52300.00, "is_actual": false },
{ "date": "2026-06-15", "balance": 53600.00, "is_actual": false }
],
"horizon": 30,
"data_points": 90,
"confidence": "high"
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/forecast/timeline",
"method": "GET"
}
}Возвращает сводные показатели прогноза: баланс, доходы, расходы, чистый поток и количество операций. Включает текущие показатели для сравнения.
{
"status": true,
"message": "Forecast summary generated successfully",
"data": {
"method": "theta",
"horizon": 30,
"data_points": 90,
"confidence": "high",
"predicted_balance": 72000.00,
"predicted_income": 35000.00,
"predicted_expense": 15000.00,
"predicted_net_flow": 20000.00,
"predicted_tx_count": 45,
"current_balance": 51000.00,
"current_income": 28500.00,
"current_expense": 12000.00,
"current_tx_count": 12
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/forecast/summary",
"method": "GET"
}
}