roi24/README.md

ROI24 — Дашборды для бизнеса

Живые цифры бизнеса за 3 дня. Подключаем 1С, банк, рекламу — и собственник видит выручку, маржу и кассу в реальном времени.

---

План проекта

Фаза 1: MVP (неделя 1-2)

• 1.1. Архитектура — выбрать стек, спроектировать pipeline данных
  • Источники → Python-адаптер → PostgreSQL → FastAPI → HTML/ECharts
  • Без ClickHouse на старте, без React
• 1.2. Техническая база
  • Настроить PostgreSQL на VPS
  • Собрать базовый Docker-комPOSE (PostgreSQL + adminer)
  • Спроектировать схему БД для типового клиента
• 1.3. Лендинг-презентация
  • Одностраничный лендинг с примерами дашбордов (фейковые но реалистичные данные)
  • 5 сектов: hero → что это → примеры → как работает → CTA
  • Деплой на Gitea Pages

Фаза 2: Первые клиенты (неделя 2-6)

• 2.1. Outreach — написать 20 знакомым предпринимателям
• 2.2. TenChat — создать профиль, начать экспертный контент
• 2.3. Kwork / FL.ru — разместить 2-3 предложения
• 2.4. Первый бесплатный проект — кейс за фидбек
• 2.5. Сбор метрик — фиксировать источники, метрики, проблемы, время внедрения

Фаза 3: Первый платный проект (неделя 4-8)

• 3.1. Настройка pipeline для реального клиента
• 3.2. Адаптер 1С — парсинг через XML-RPC или прямой доступ к БД
• 3.3. Адаптер банка — выгрузка CSV/API (СберБизнес, Тинькофф, Точка)
• 3.4. Адаптер рекламы — Яндекс.Директ API, VK Ads
• 3.5. Дашборд — 3-5 ключевых метрик в одном HTML
• 3.6. Автообновление — cron-скрипт для обновления данных
• 3.7. Подписание договора + подписка

Фаза 4: Масштабирование (неделя 8-16)

• 4.1. Типизация клиентов — 2-3 профиля (интернет-магазин, услуги, B2B)
• 4.2. Шаблоны дашбордов — 3 готовых шаблона
• 4.3. Адаптер CRM — Битрикс24 API, amoCRM
• 4.4. Система подписок — разные тарифы, разная частота обновления
• 4.5. AI-фичи — базовые прогнозы (линейная регрессия на выручку)
• 4.6. Партнёрство с 1С-интеграторами

Фаза 5: Продукт (месяц 4-6+)

• 5.1. SaaS-платформа — мульти-тенантная архитектура
• 5.2. Self-service — клиент сам подключает источники через веб-интерфейс
• 5.3. Дашборд-конструктор — drag & drop для метрик
• 5.4. Telegram-уведомления — алерты при отклонении метрик
• 5.5. Когортный анализ — cohort analytics для e-commerce
• 5.6. Unit-экономика — LTV, CAC, churn rate

---

Технический стек

Компонент	Инструмент
Бэкенд	Python 3.12 + FastAPI
База данных	PostgreSQL 16
Визуализация	ECharts 5 / Chart.js
Контейнеризация	Docker + Docker Compose
Задачи	Celery + Redis / APScheduler
Деплой	VPS (Ubuntu 24.04) + Nginx
Фронтенд	HTML + JS (без фреймворков на старте)
CI/CD	Gitea Actions

Источники данных (адаптеры)

Приоритет 1 (MVP)

• 1С:Предприятие 8.3 (XML-RPC или HTTP API)
• Банковские выписки (CSV/API: СберБизнес, Тинькофф, Точка)
• Яндекс.Директ API

Приоритет 2 (Фаза 4)

• amoCRM API
• Битрикс24 API
• Wildberries / Ozon API

Приоритет 3 (Фаза 5)

• RetailCRM
• СБИС / Контур.Экстерн
• Прямые API маркетплейсов

Ключевые метрики по нишам

Интернет-магазин

• Выручка (день/неделя/месяц)
• Маржинальная прибыль
• Конверсия в покупку
• Средний чек (AOV)
• LTV / CAC
• Динамика по каналам трафика

Услуги / B2B

• Pipeline (воронка продаж)
• Конверсия по этапам
• Дебиторская задолженность
• Загруженность команды
• Выручка по менеджерам

Розничная торговля

• Продажи по точкам
• Товарный запас
• Оборачиваемость
• Средний чек
• Трафик в зале

Ценообразование

Тариф	Внедрение	Подписка/мес	Что входит
Старт	50 000 ₽	10 000 ₽	1С + банк, 3 дашборда, 1 обновление/день
Бизнес	100 000 ₽	25 000 ₽	1С + банк + CRM + реклама, 7 дашбордов, каждые 4ч
Под ключ	200 000 ₽	50 000 ₽	Все источники, кастомные метрики, AI-прогнозы, каждые 30мин

KPI проекта

Метрика	Целевое значение
CAC (стоимость привлечения)	< 30 000 ₽
LTV (пожизненная ценность)	> 300 000 ₽ (2 года подписки)
Churn rate	< 5% в месяц
Revenue per customer	> 25 000 ₽/мес
Время внедрения	< 3 рабочих дня

---

Файлы проекта

roi24/
├── README.md              ← этот файл (план проекта)
├── ARCHITECTURE.md        ← техническая архитектура
├── PIPELINE/
│   ├── README.md
│   ├── 1c_adapter/        ← адаптер 1С
│   ├── bank_adapter/      ← адаптеры банков
│   ├── ad_adapter/        ← адаптеры рекламы
│   └── crm_adapter/       ← адаптеры CRM
├── storage/
│   ├── schema.sql         ← схема БД
│   └── migrations/        ← миграции
├── api/
│   └── main.py            ← FastAPI приложение
├── dashboard/
│   ├── templates/         ← шаблоны дашбордов
│   │   ├── ecommerce.html
│   │   ├── services.html
│   │   └── retails.html
│   ├── static/            ← CSS, JS, images
│   └── utils/             ← helpers
├── landing/               ← лендинг-презентация
├── docker/
│   ├── docker-compose.yml
│   └── nginx/
└── scripts/
    ├── update_data.py     ← cron-скрипт обновления
    └── generate_report.py ← генерация PDF-отчётов