002
Archive 002Инструмент
RobinSystem · Twitch-платформа
SaaS для стримеров: чат-бот, оверлеи OBS, TTS, уровни, викторины, розыгрыши, магазин и аналитика — один кабинет вместо пяти сервисов
01 /О проекте
SaaS для стримеров: чат-бот, оверлеи OBS, TTS, уровни, викторины, розыгрыши, магазин и аналитика — один кабинет вместо пяти сервисов.
02 /🎯 Суть проекта
- 01RobinSystem (RSystemBot) — платформа для Twitch-стримеров: бот, оверлеи, монетизация и аналитика в одном кабинете
- 02Один OAuth через Twitch — подключение канала за минуту, без ручной настройки IRC и EventSub
- 03Модульная модель: каждый инструмент (бот, TTS, магазин, оверлеи…) включается отдельно и ограничивается тарифом
- 04Тарифы Free / Premium / Ultra с лимитами на розыгрыши, товары, аналитику и API-доступ
- 05Публичные поверхности: viewer-панель для зрителей, магазин канала, мини-сайт стримера, browser-source оверлеи для OBS
03 /🏗️ Архитектура (backend/ + frontend2/)
- 01Split-runtime: api (HTTP + Socket.IO), bot (Twitch IRC/EventSub), realtime (overlay gateway), telegram (webhook)
- 02backend/ — Express + TypeScript, PostgreSQL как source of truth, Redis для pub/sub, кэша, проекций и lock/state
- 03API не вызывает bot runtime напрямую: write-path через EventBus + durable fallback, read-path через проекции (botStateStore, quizStateStore)
- 04frontend2/ — Next.js 14 App Router: production-логика из frontend/ + визуал RobinDesign 2 (coral palette, floating sidebar)
- 05Docker Compose: postgres, redis, api, bot, telegram, frontend; отдельный realtime gateway при масштабировании
04 /🤖 Чат-бот и модерация
- 01tmi.js IRC + EventSub WebSocket shard pool: follow, subscribe, raid, live-only attach с observability
- 02Кастомные команды с переменными, cooldown, правами и алиасами; категории и лимиты по тарифу
- 03Авто-ответчик (triggers): реакция на ключевые слова, фразы и события чата
- 04Авто-модерация: фильтры, спам-контроль, логирование действий в dashboard
- 05Планировщик сообщений: таймеры по cron, правила для online/offline, интеграция с викториной
- 06Консоль чата в dashboard с live-лентой через Socket.IO и bot event bridge
05 /🎮 Вовлечение зрителей
- 01RPG-система уровней: XP за сообщения и watch time, ранги, лидерборды, исключения из топа
- 02Викторина (!quiz): автозапуск, несколько вариантов ответа, начисление очков и channel points
- 03Угадай слово (word-guess): отдельный модуль с настройками и статистикой
- 04Розыгрыши: участие через чат, reroll с исключением неподтвердивших, IRC first-message tracking
- 05Дуэли между зрителями, награды канала (Twitch rewards), переменные для команд
06 /📺 Оверлеи и OBS
- 01Browser-source виджеты: chat, followers, TTS, donation-goal, predictions, alerts, music-spotify, faceit
- 02Публичные URL /overlay/* с ключами доступа; realtime gateway доставляет события без polling
- 03Craft.js редактор для FaceIT start overlay: drag-and-drop кастомизация сцен
- 04Загрузка медиа (изображения/видео) для donation-goal, followers, giveaway и public-site
- 05Тестовые триггеры из dashboard — проверка алертов до эфира
07 /🔊 TTS и озвучка
- 01Озвучка сообщений за channel points или внутренний баланс зрителя
- 02Интеграции ElevenLabs и Fish Audio с platform API keys и пользовательскими настройками
- 03TTS overlay для OBS: очередь, голоса, фильтрация и модерация текста
- 04Viewer-модуль viewerTtsVoices — выбор голоса со стороны зрителя (по тарифу)
08 /💰 Донаты и монетизация
- 01DonationAlerts, DonateX, DonatePay — единый поток алертов через donation worker pool
- 02Donation-goal overlay с авто-сбросом и конвертацией валют (auto-currency settings)
- 03Подписки Free / Premium / Ultra: Platega, Enot, CryptoCloud, NicePay с идемпотентными callbacks
- 04Внутренний баланс пользователя, биллинг-история, промокоды
- 05Магазин канала: товары за баллы/валюту, комиссии, лимиты по tier, публичная витрина /shop/[username]
09 /📊 Аналитика
- 01Dashboard analytics: активные зрители, тренды команд, часы пика, timeline событий
- 02Watch time tracking, message streaks, сегменты аудитории
- 03Глубина истории зависит от тарифа (7 / 14 / 30 дней)
- 04Monitoring endpoints и EventSub observability для faceadmin
10 /👥 Viewer-панель и публичные API
- 01/viewer/[channel] — панель зрителя: баланс, прогресс уровней, заказы из магазина
- 02/site/[streamer] — публичный мини-сайт канала с настраиваемым контентом
- 03Public User API (/api/public/v1): stats, viewers, balance — с API keys и scopes (Ultra)
- 04OAuth delegation и assistants — доступ помощникам к модулям канала
11 /🔗 Интеграции
- 01Twitch OAuth + Helix API через TwitchApiBase: rate limit, circuit breaker, keep-alive
- 02FaceIT: lobby overlay, webhook, виджеты для CS2-стримеров
- 03Spotify: now-playing overlay для OBS
- 04Telegram: уведомления, webhook runtime, live-alerts для стримера
- 05Follower tracking и алерты новых подписчиков
12 /🛠️ Админ и операции
- 01Faceadmin: глобальные site settings, module-access gating, maintenance mode, платформенные API keys
- 02Реферальная программа: заявки, attribution, ledger, payout hold/release
- 03Backup/import настроек, переменные канала, tutorial onboarding
- 04i18n (ru/en) через next-intl; SEO-лендинги (/twitch-analytics, /twitch-giveaway-bot, …)
- 05Swagger /api-docs в dev, health checks, graceful shutdown, process crash diagnostics
13 /🖥️ Frontend2 (RobinDesign 2)
- 01Next.js 14 App Router, Tailwind с design tokens (rs-*), шрифты Outfit + JetBrains Mono
- 02Лендинг RobinDesign: hero с live-preview чата, bento features, pricing, FAQ, отзывы
- 03Dashboard shell: floating island sidebar, mesh background, постепенный reskin модулей
- 04Axios + cookies same-origin /api/*, Socket.IO client, Craft.js + react-moveable для overlay editor
- 0567+ роутов: dashboard-модули, overlay preview, payment callbacks, viewer/shop/site surfaces
14 /🧩 Технические особенности
- 01170+ SQL-миграций PostgreSQL, bcrypt/JWT/session auth, express-rate-limit + helmet
- 02Redis adapter для Socket.IO horizontal scaling; @socket.io/redis-adapter
- 03Module tier requirements: streamer/viewer modules gated per free/premium/ultra
- 04Idempotent payment callbacks, transactional money operations, referral hold cycle
- 05Pino structured logging, metrics store, bot runtime reconcile и channel restore on crash
15 /Галерея





