Initial project plan and architecture

2026-06-20 18:01:54 +05:00
1 parent 95694c58c2
commit a55cf6026c
@@ -1,2 +1,166 @@
-# roi24
+# 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-отчётов
+```