AI Прогнози ставок + Автоподача через партнерів (RevShare) + Реферальна система

SaaS-сервіс прогнозів на AI-моделях з підписками, автоматичною подачею ставок через партнерів БК (RevShare) та вбудованою реферальною програмою. Розгортання на сервері Dell PowerEdge R740 (Linux + Docker).

1) Функціонал MVP

1.1 Прогнози

• Збір матчів та статистики (історія, live-фіди).
• Коефіцієнти від 2–3 партнерських БК.
• Моделі ймовірностей та value: Elo/xG + Poisson/LightGBM/XGBoost.
• Вивід сигналів: Веб, Telegram-бот, Email.
• Історія прогнозів: ROI, Yield, графік PnL, фільтри за лігами/ринками.

1.2 Автоподача ставок (AutoBet)

• Прив'язка акаунта користувача в підтримуваних БК (офіційні/партнерські API).
• Стратегії стейкінга: фікс-сума, % від банку, Kelly (з «safety cap»).
• Ліміти: денний/тижневий, макс. ставка, стоп-лосс.
• Кнопка On/Off; лог всіх заявок та відповідей API.

1.3 Тарифи

• Basic — прогнози з затримкою, урізані ринки.
• Pro — повні прогнози + live-апдейти.
• AutoBet — весь доступ + автоподача.

2) Реферальна система (вбудована)

• Унікальні реф-ссилки та промокоди (рівень: користувач/партнер/агентство).
• Відстеження атрибуції: UTM + first/last touch, cookie + server-side.
• Начислення:
  • Модель A: % від підписки реферала (напр., 20% щомісячно, термін 12 міс).
  • Модель B: фікс-бонус (напр., €10) за оплачений перший місяць.
  • Опціонально 2-рівнева рефералка (10%/5%).
• Виплати: баланс партнера, вивід SEPA/PayPal раз на місяць з порогом (€50).
• Анти-фрод: дедуп по пристроях/IP, заборона самореферала, верифікація платежів, відкладене начислення (hold 14–30 днів).
• Дашборди:
  • Партнер: кліки, реєстрації, платячі, конверсія, начислення, статуси виплат.
  • Адмін: лідери, LTV по джерелах, скасування, підозрілі патерни.
• API/вебхуки: для партнерських трекерів та CPA-мереж.

3) Хостинг на Dell PowerEdge R740

• Апаратура: 40C/80T CPU, 544 GB RAM, диски 21.6 TB, GPU rtx a5000.
• OS/Стек: Ubuntu LTS, Docker/Compose (в перспективі k3s), Traefik/NGINX, LetsEncrypt.
• Сервіси:
  • Backend: FastAPI, Celery/Redis для задач.
  • DB: PostgreSQL (OLTP), ClickHouse (аналітика/агрегації).
  • Сховище: MinIO/S3 для датасетів/бекапів.
  • Моніторинг: Prometheus + Grafana, алерти в Telegram.
  • Логи/помилки: Sentry.
• Мережа: WireGuard VPN для DevOps та адмін-панелі; rate-limit та WAF (CrowdSec/Fail2ban).
• Резервування: щоденні бекапи (pg_dump/ClickHouse snapshot) → S3/зовнішній VPS, зберігання 30–90 днів.
• Масштабування: окремі worker-пули під ETL, інференс та автоподачу; горизонтальний шард Celery-воркерів.

4) Архітектура інтеграцій з БК

• Абстрактний шар BookmakerConnector (уніфіковані методи: login, odds, placeBet, status, cancel).
• Підтримка 2–3 партнерів на старті; додавання нового — без змін ядра (новий адаптер).
• Черга ставок: idempotency-ключі, ретраи з експоненційною паузою, дедуплікація, журнал відповідності (bet_id ↔ external_ticket).
• Фоллбек: якщо API недоступний — постановка в відкладену чергу з TTL та сповіщенням.

5) Безпека та відповідність

• HTTPS всюди, JWT + refresh, RBAC (Admin/Partner/User).
• Шифрування ключів БК: KMS/age + at-rest в БД (pgcrypto).
• Повний audit-лог дій та API-викликів.
• Responsible Gambling: ліміти, стоп-лосс, кнопка self-exclusion.
• Юр. частина: дотримання ToS партнерів; без обходу обмежень регіону/віку (KYC «у партнера»).

6) ЛК користувача

• Реєстрація/логін (Email/OTP, опц. OAuth).
• Перегляд прогнозів, фільтри, обране.
• Налаштування автоподачі/стратегій/лімітів.
• Історія ставок та прогнозів; ROI/Yield; експорт CSV.
• Реферальний розділ: посилання/код, статистика, вивід коштів.

7) Адмін-панель

• Користувачі, тарифи, активність, платежі.
• Моделі та їх версії; управління фічами, бэктест.
• Партнери БК: ключі, статуси, квоти.
• Реферальна аналітика та модерація фрода.
• Конфіг AutoBet (ризик-параметри, глобальні ліміти).

8) Монетизація 

• Basic — €19/міс
• Pro — €49/міс
• AutoBet — €99/міс (+ RevShare від БК)
• Реферальні виплати: 20% від підписки (12 міс) або €10 за актив.
• Промокоди (-20% на 1-й місяць / 7 днів Pro-trial).

9) KPI та звітність

• Точність моделей (hit-rate), ROI/Yield по ринках/лігах.
• Конверсія: візит → реєстрація → платіж → AutoBet on.
• Retention M1/M3/M6; CAC/LTV; частка RevShare в виручці.
• Аптайм сервісу, SLA відповіді API БК.

10) Етапи 

Етап 1 — MVP 

• ETL даних + 2 БК, базові моделі, сигнали (Web/Telegram), тарифи, платежі, ЛК, лог ставок (без авто-подачі), реф-ссилки (облік реєстрацій), деплой на R740, моніторинг/бекапи.

Етап 2 — AutoBet + рефералка 1.0 

• Коннектори 2 БК, черга ставок, стратегії стейкінга, ліміти, відкладені виплати рефералам, дашборди партнера, анти-фрод.

Етап 3 — Аналітика/масштабування 

• ClickHouse звіти, A/B моделей, промокоди, 2-рівнева партнерка, API для зовнішніх партнерів, оптимізації продуктивності.

11) Результати/хендовер

• Репозиторії (Backend/Frontend/Bot/Infra as Code).
• CI/CD, інструкції деплоя, .env-шаблони.
• Документація API (OpenAPI), схеми БД.
• Гайди по експлуатації R740 (бекапи, моніторинг, аварійні процедури).

Примітки для фрілансера

• Писати код модульно: коннектори БК, стратегії, рефералка — окремі пакети.
• Логи та метрики — must-have з першого дня.
• Дотримуватись вимог партнерів (rate-limits, KYC у БК, заборона мульти-акаунтів).
• Продуктивність орієнтувати на on-prem R740.