AI Betting Predictions + Auto Submission through Partners (RevShare) + Referral System

SaaS service for AI model predictions with subscriptions, automatic bet placement through bookmaker partners (RevShare), and an integrated referral program. Deployment on a Dell PowerEdge R740 server (Linux + Docker).

1) MVP Functionality

1.1 Predictions

• Collection of matches and statistics (history, live feeds).
• Odds from 2–3 partner bookmakers.
• Probability models and value: Elo/xG + Poisson/LightGBM/XGBoost.
• Signal output: Web, Telegram bot, Email.
• Prediction history: ROI, Yield, PnL chart, filters by leagues/markets.

1.2 AutoBet

• Linking user accounts in supported bookmakers (official/partner APIs).
• Staking strategies: fixed amount, % of bankroll, Kelly (with "safety cap").
• Limits: daily/weekly, max bet, stop-loss.
• On/Off button; log of all requests and API responses.

1.3 Tariffs

• Basic — delayed predictions, limited markets.
• Pro — full predictions + live updates.
• AutoBet — full access + auto placement.

2) Referral System (integrated)

• Unique referral links and promo codes (level: user/partner/agency).
• Attribution tracking: UTM + first/last touch, cookie + server-side.
• Accruals:
  • Model A: % from referral subscription (e.g., 20% monthly, duration 12 months).
  • Model B: fixed bonus (e.g., €10) for the paid first month.
  • Optionally 2-level referral (10%/5%).
• Payments: partner balance, SEPA/PayPal withdrawal once a month with a threshold (€50).
• Anti-fraud: deduplication by devices/IP, self-referral prohibition, payment verification, delayed accrual (hold 14–30 days).
• Dashboards:
  • Partner: clicks, registrations, paying users, conversion, accruals, payment statuses.
  • Admin: leaders, LTV by sources, cancellations, suspicious patterns.
• API/webhooks: for partner trackers and CPA networks.

3) Hosting on Dell PowerEdge R740

• Hardware: 40C/80T CPU, 544 GB RAM, disks 21.6 TB, GPU rtx a5000.
• OS/Stack: Ubuntu LTS, Docker/Compose (in the future k3s), Traefik/NGINX, LetsEncrypt.
• Services:
  • Backend: FastAPI, Celery/Redis for tasks.
  • DB: PostgreSQL (OLTP), ClickHouse (analytics/aggregations).
  • Storage: MinIO/S3 for datasets/backups.
  • Monitoring: Prometheus + Grafana, alerts in Telegram.
  • Logs/errors: Sentry.
• Network: WireGuard VPN for DevOps and admin panel; rate-limit and WAF (CrowdSec/Fail2ban).
• Backup: daily backups (pg_dump/ClickHouse snapshot) → S3/external VPS, storage for 30–90 days.
• Scaling: separate worker pools for ETL, inference, and auto placement; horizontal sharding of Celery workers.

4) Integration Architecture with Bookmakers

• Abstract layer BookmakerConnector (unified methods: login, odds, placeBet, status, cancel).
• Support for 2–3 partners at launch; adding new ones — without changes to the core (new adapter).
• Bet queue: idempotency keys, retries with exponential backoff, deduplication, compliance log (bet_id ↔ external_ticket).
• Fallback: if API is unavailable — placing in a delayed queue with TTL and notification.

5) Security and Compliance

• HTTPS everywhere, JWT + refresh, RBAC (Admin/Partner/User).
• Encryption of bookmaker keys: KMS/age + at-rest in DB (pgcrypto).
• Complete audit log of actions and API calls.
• Responsible Gambling: limits, stop-loss, self-exclusion button.
• Legal part: adherence to partners' ToS; no circumvention of regional/age restrictions (KYC "at partner").

6) User Personal Account

• Registration/login (Email/OTP, optional OAuth).
• Viewing predictions, filters, favorites.
• Auto placement/settings/strategies/limits.
• Betting and prediction history; ROI/Yield; CSV export.
• Referral section: link/code, statistics, withdrawal.

7) Admin Panel

• Users, tariffs, activity, payments.
• Models and their versions; feature management, backtesting.
• Bookmaker partners: keys, statuses, quotas.
• Referral analytics and fraud moderation.
• AutoBet config (risk parameters, global limits).

8) Monetization

• Basic — €19/month
• Pro — €49/month
• AutoBet — €99/month (+ RevShare from bookmakers)
• Referral payments: 20% from subscription (12 months) or €10 per active.
• Promo codes (-20% on the first month / 7 days Pro trial).

9) KPIs and Reporting

• Model accuracy (hit-rate), ROI/Yield by markets/leagues.
• Conversion: visit → registration → payment → AutoBet on.
• Retention M1/M3/M6; CAC/LTV; share of RevShare in revenue.
• Service uptime, SLA response of bookmaker API.

10) Stages

Stage 1 — MVP

• ETL data + 2 bookmakers, basic models, signals (Web/Telegram), tariffs, payments, personal account, betting log (without auto placement), referral links (registration tracking), deployment on R740, monitoring/backups.

Stage 2 — AutoBet + referral 1.0

• Connectors for 2 bookmakers, bet queue, staking strategies, limits, delayed payments to referrals, partner dashboards, anti-fraud.

Stage 3 — Analytics/scaling

• ClickHouse reports, A/B testing of models, promo codes, 2-level partnership, API for external partners, performance optimizations.

11) Results/hand-over

• Repositories (Backend/Frontend/Bot/Infra as Code).
• CI/CD, deployment instructions, .env templates.
• API documentation (OpenAPI), DB schemas.
• Guides for operating R740 (backups, monitoring, emergency procedures).

Notes for the freelancer

• Write code modularly: bookmaker connectors, strategies, referrals — separate packages.
• Logs and metrics — must-have from day one.
• Comply with partner requirements (rate-limits, KYC at bookmakers, prohibition of multi-accounts).
• Performance should be oriented towards on-prem R740.