# 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-отчётов
```