beginning

2026-07-12 19:51:00 +03:00
parent 940d25435e
commit 5afea8238c
3 changed files with 473 additions and 169 deletions
@@ -0,0 +1,193 @@
+# CashFlow Forecast
+
+Простой open-source проект для построения и анализа личной финансовой модели с использованием Spreadsheet, Python и AI.
+
+## Идея
+
+Большинство приложений для учета финансов отвечают на вопрос:
+
+> "Что произошло?"
+
+Этот проект пытается ответить на другой вопрос:
+
+> "Что произойдет дальше?"
+
+Основная цель — построение прогнозной модели денежных потоков (Cash Flow Forecasting), позволяющей моделировать различные сценарии будущего.
+
+## Принципы
+
+- Spreadsheet используется как удобный визуальный редактор.
+- Python является вычислительным ядром системы.
+- JSON служит внутренним представлением модели данных.
+- AI используется как инструмент анализа и взаимодействия с моделью.
+- Все компоненты должны быть взаимозаменяемыми.
+
+## Архитектура
+
+```
+                User
+                 │
+                 ▼
+        Spreadsheet (UI)
+                 │
+        Synchronization Layer
+              (Python)
+                 │
+                 ▼
+          Financial Model
+              (JSON)
+                 │
+     ┌───────────┴───────────┐
+     ▼                       ▼
+ Forecast Engine        AI Assistant
+ Scenario Analysis      Data Analysis
+```
+
+Spreadsheet рассматривается как пользовательский интерфейс, а не как источник бизнес-логики.
+
+## Основные сущности
+
+```
+Accounts
+Transactions
+Assets
+Liabilities
+Recurring Cashflows
+Forecast Scenarios
+Parameters
+```
+
+### Account
+
+```
+id
+name
+currency
+balance
+```
+
+### Transaction
+
+```
+id
+date
+account
+category
+amount
+description
+```
+
+### Recurring Cashflow
+
+```
+id
+start_date
+end_date
+frequency
+amount
+category
+```
+
+### Asset
+
+```
+id
+name
+value
+growth_rate
+```
+
+### Liability
+
+```
+id
+name
+balance
+interest
+payment
+```
+
+## Основной цикл
+
+```
+Spreadsheet
+      │
+      ▼
+Python Import
+      │
+      ▼
+JSON Model
+      │
+      ▼
+Forecast Calculation
+      │
+      ▼
+Scenario Simulation
+      │
+      ▼
+AI Analysis
+      │
+      ▼
+Spreadsheet Export
+```
+
+## Возможности
+
+- прогноз денежных потоков;
+- моделирование бюджета;
+- сценарный анализ;
+- учет активов и обязательств;
+- прогноз ликвидности;
+- анализ финансовой устойчивости;
+- моделирование достижения финансовых целей;
+- анализ "что если" (What-if Analysis).
+    
+
+## Будущие возможности
+
+- Monte-Carlo Simulation;
+- FIRE Planning;
+- инвестиционный прогноз;
+- импорт банковских выписок;
+- импорт брокерских отчетов;
+- REST API;
+- Web UI;
+- Mobile App;
+- AI Financial Assistant.
+    
+
+## Структура репозитория
+
+```
+cashflow-forecast/
+
+├── README.md
+├── spreadsheet/
+│     model.xlsx
+│
+├── data/
+│     model.json
+│
+├── sync/
+│     excel_sync.py
+│
+├── engine/
+│     forecast.py
+│     scenarios.py
+│
+├── ai/
+│     prompts.py
+│     assistant.py
+│
+├── exports/
+│
+└── docs/
+```
+
+## Долгосрочная идея
+
+На ранних этапах Spreadsheet используется как быстрый инструмент проектирования финансовой модели.
+
+По мере развития проекта вычисления и логика постепенно переносятся в Python, а Spreadsheet превращается исключительно в средство отображения и редактирования данных.
+
+Конечной целью является независимый интерактивный open-source инструмент для персонального финансового планирования и прогнозирования денежных потоков, в котором AI выступает естественным интерфейсом для анализа и построения сценариев.