nifodea/README.md

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 выступает естественным интерфейсом для анализа и построения сценариев.