CI/CD Pipeline / build-and-deploy (push) Successful in 28s

Details

README.md for humans (setup, config, deploy). ARCHITECTURE.md for
future AI sessions — data model, message flow, and a "gotchas"
section documenting real bugs/incidents from this session (session
capture timing, broken edge-tts-node package, OAuth origin/client-id
mixups, docker compose restart vs up -d, self-matching pkill) so they
don't get rediscovered the hard way.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-07-01 18:11:53 +00:00

6.4 KiB

Raw Blame History

Send2Streamer

Сервис для стримеров: зрители пишут сообщения через веб-страницу (вход через Google) — сообщения всплывают у стримера на оверлее в OBS/StreamLabs, с текстом и голосовой озвучкой. Опционально на сообщение может ответить ИИ (DeepSeek), тоже с озвучкой. Мат автоматически цензурится.

Быстрый старт

cp .env.example .env   # и заполнить реальными значениями (см. таблицу ниже)
docker compose up -d --build
docker compose logs -f

Сервис поднимется на http://localhost:3000.

Первичная настройка

Создать OAuth 2.0 Client ID (Web application) в Google Cloud Console, добавить в Authorized JavaScript origins домен, с которого открывается сайт (http://localhost:3000 для локальной разработки, плюс боевой домен). OAuth consent screen должен быть в статусе "In production", иначе войти смогут только явно добавленные test users.
(Опционально) Получить ключ DeepSeek API для функции "ответ от ИИ".
Открыть сайт → войти через Google как стример → на дашборде появятся две ссылки:
- Ссылка для OBS/StreamLabs — вставить в свойства Browser Source.
- Ссылка для зрителей — опубликовать, зрители сами авторизуются через Google и пишут сообщения.

Как это работает

graph LR
    Viewer[Зритель] -->|логин Google + текст| Send["/s/:token (send.js)"]
    Send -->|WebSocket send_message| Server[server.js]
    Server -->|censorText| Server
    Server -->|display_message| Overlay["/overlay/:token (overlay.js)"]
    Server -->|edge-tts CLI| TTS[edge-tts]
    TTS -->|mp3 base64| Server
    Server -->|display_audio| Overlay
    Server -.->|если включена галка| DeepSeek[DeepSeek API]
    DeepSeek -.->|текст ответа| Server
    Overlay -->|очередь: текст + голос| OBS[OBS / StreamLabs Browser Source]

Один процесс на несколько стримеров. Каждый стример получает пару уникальных токенов (overlay + sender), сообщения маршрутизируются через комнаты Socket.IO (streamer-<id>) — зрители одного стримера не видят сообщений другого.
Очередь на оверлее. Сообщения показываются по одному, каждое — заданное стримером время (по умолчанию 10 сек), а не перебивают друг друга.
Озвучка — edge-tts (бесплатный Microsoft Edge Read Aloud, тот же движок, что в t2sTelegramBot), CLI вызывается из Node дочерним процессом.
ИИ-ответ — опционален, только если у стримера настроен DEEPSEEK_API_KEY. Промпт-инструкция для ИИ лежит в ai-prompt.txt и редактируется без изменения кода.
Цензура мата (profanity.js) — при отправке применяется всегда: на экране матное слово превращается в ..., в озвучке — в "бип".

Структура проекта

.
├── server.js              # Express + Socket.IO, вся серверная логика
├── db.js                  # SQLite (node:sqlite) — стримеры, имена зрителей
├── profanity.js           # Цензура мата
├── ai-prompt.txt           # Системный промпт для ИИ-ответов (редактируется свободно)
├── public/
│   ├── index.html          # Лендинг + вход для стримера
│   ├── dashboard.html       # Личный кабинет стримера (ссылки, настройки)
│   ├── send.html/.js        # Страница отправки сообщений (для зрителей)
│   └── overlay.html/.js     # Страница для Browser Source в OBS/StreamLabs
├── Dockerfile
├── docker-compose.yml       # Локальная разработка (build: .)
├── docker-compose.prod.yml  # Прод (только image:, без build)
└── .forgejo/workflows/deploy.yml  # CI/CD: билд → push в registry → деплой по SSH

Конфигурация (.env)

Переменная	Описание
`PORT`	Порт сервера (по умолчанию 3000)
`GOOGLE_CLIENT_ID`	OAuth Client ID для входа через Google
`SESSION_SECRET`	Случайная строка для подписи сессионной cookie
`TTS_VOICE`	Голос по умолчанию для новых стримеров (`ru-RU-DmitryNeural`)
`DEEPSEEK_API_KEY`	Опционально — включает функцию "ответ от ИИ"
`AI_VOICE`	Голос для ИИ-ответов (`ru-RU-SvetlanaNeural` по умолчанию, отличается от голоса стримера)

Деплой

Пуш в main триггерит .forgejo/workflows/deploy.yml: сборка образа, smoke-test, push в локальный registry, затем SSH на прод-хост (docker pull + docker compose up -d). Прод-хост сам хранит свой .env (не через git) — при первом деплое его нужно создать вручную рядом с docker-compose.prod.yml.

Требования

Docker + Docker Compose
Доступ к accounts.google.com (логин), api.deepseek.com (если включён ИИ-ответ) и Microsoft edge-tts CDN (озвучка)

6.4 KiB Raw Blame History Unescape Escape