💼 Claude Cash Flow Story

B2B Financial Analytics Platform для автоматического расчета и визуализации финансовых показателей

🎯 Назначение

Инструмент для финансовых консультантов и аналитиков для:

• Быстрой демонстрации финансового анализа клиентам
• Автоматического расчета 21+ ключевых финансовых коэффициентов
• Визуализации трендов и сравнения периодов
• Генерации профессиональных отчетов

✨ Возможности

📊 Автоматические расчеты

• Рентабельность (6 метрик): валовая маржа, операционная прибыль, EBITDA, ROE, ROA
• Оборотный капитал (6 метрик): дни дебиторки/запасов/кредиторки, цикл оборотного капитала
• Эффективность капитала (9 метрик): оборачиваемость активов, леверидж, доходность капитала

🎨 Визуализация

• Интерактивные графики динамики показателей
• Сравнение с отраслевыми бенчмарками
• Цветовые индикаторы (хорошо/средне/плохо)

🔗 Шаринг

• Уникальные ссылки для каждого расчета
• Возможность поделиться результатами с клиентом
• Сохранение истории анализов

🏗️ Архитектура

┌─────────────────────────────────────────┐
│  Frontend (React + Vite)                │
│  - Форма ввода данных                   │
│  - Dashboard с графиками                │
│  - Демо на данных Rebeccas Coffee       │
└─────────────────────────────────────────┘
              ↕ REST API
┌─────────────────────────────────────────┐
│  Backend (Express.js)                   │
│  - Calculation Engine (21 формула)     │
│  - Save/Share результатов               │
│  - API для фронтенда                    │
└─────────────────────────────────────────┘
              ↕
┌─────────────────────────────────────────┐
│  PostgreSQL                              │
│  - Сохраненные расчеты                  │
│  - История анализов                     │
└─────────────────────────────────────────┘

🚀 Быстрый старт

Требования

• Node.js 18+
• PostgreSQL (опционально для начала)

Установка

# Клонировать репозиторий
git clone https://github.com/leval907/claude_cashflowstory.git
cd claude_cashflowstory

# Установить зависимости фронтенда
cd frontend
npm install

# Установить зависимости бэкенда
cd ../backend
npm install

# Запустить в режиме разработки
npm run dev

📁 Структура проекта

claude_cashflowstory/
├── frontend/           # React приложение
│   ├── src/
│   │   ├── components/ # UI компоненты
│   │   ├── pages/      # Страницы
│   │   ├── services/   # API клиент
│   │   └── utils/      # Хелперы
│   └── package.json
│
├── backend/            # Express API
│   ├── src/
│   │   ├── routes/     # API endpoints
│   │   ├── services/   # Бизнес-логика
│   │   ├── calculations/ # Формулы расчетов
│   │   └── models/     # Модели данных
│   └── package.json
│
├── docs/               # Документация
│   ├── FORMULAS.md     # Описание всех формул
│   ├── API.md          # API документация
│   └── DEPLOYMENT.md   # Инструкции по деплою
│
└── README.md

📊 Пример использования

Демо с Rebeccas Coffee

Заходим на /demo и видим готовый анализ кофейной сети за 2015-2018:

• Рост выручки с $3.4М → $6.6М (+95%)
• Валовая маржа 29%
• ROE 31%

Калькулятор для своих данных

1. Заходим на /calculator
2. Вводим финансовые данные компании
3. Получаем мгновенный анализ с 21 коэффициентом
4. Сохраняем и получаем ссылку для шаринга

🎯 Roadmap

MVP (Week 1-2)

• Создание репозитория
• Настройка проекта (frontend + backend)
• Реализация 21 формулы расчета
• Базовый UI для ввода данных
• Простой dashboard с результатами

v0.2 (Week 3-4)

• Демо страница с Rebeccas Coffee
• Графики динамики показателей
• Сохранение и шаринг результатов
• Деплой на Vercel + Render

v1.0 (Month 2)

• CSV/Excel импорт
• PDF экспорт отчетов
• Сравнение с бенчмарками
• Исторический анализ периодов

🛠️ Технологии

Frontend:

• React 18 + Vite
• Recharts (графики)
• Tailwind CSS (стили)
• React Hook Form (формы)

Backend:

• Express.js
• PostgreSQL
• Node.js 18+

DevOps:

• Vercel (frontend)
• Render.com (backend + DB)

📝 Лицензия

MIT License

👨‍💻 Автор

Создано для демонстрации финансового анализа клиентам

---

Вдохновлено Cash Flow Story