Действующая сауна с реальным оборудованием: печь, насосы, баки воды, химия (хлор, коагулянт), вентиляция, механизмы бассейна (фильтр, гейзер, форсунки, фары), свет по зонам и десятки датчиков температуры, влажности и уровней. Управление держалось на старой самописной системе: PHP-админка примерно на 80 файлов, Perl-скрипты как транспорт к ModBus-оборудованию и логика на событиях и процедурах MySQL. Отдельно стояло видеонаблюдение: около 20 IP-камер на FFmpeg и HLS с задержкой в несколько секунд.
Проблемы legacy: систему тяжело поддерживать и развивать, нет наблюдаемости за оборудованием (не видно, живо ли железо и что оно отдаёт), устаревший интерфейс оператора, нет низколатентного видеонаблюдения, всё связано в один монолит без разделения на части.
Задача: перевести автоматизацию объекта на современный стек (Node.js, NestJS, React, TypeScript, MariaDB), разбить монолит на три подсистемы (управление оборудованием, видеонаблюдение, админ-панель оператора), поднять живой просмотр камер с субсекундной задержкой и сделать новую панель оператора. Главное ограничение: всё делается на живой, работающей сауне, где реле в реальном времени управляют печью и насосами. Простой оборудования недопустим, старая и новая системы должны уметь работать параллельно.
Собрал комплекс автоматизации из трёх подсистем на едином стеке: бэкенд на Node.js и NestJS (TypeScript, TypeORM), фронтенд на React (Vite, Tailwind). Развёрнуто на приватной инфраструктуре клиента: Proxmox VE, LXC-контейнеры, база MariaDB 10.11, PM2, nginx, CI/CD через GitHub Actions (сборка, деплой по SSH, миграции, проверка /health).
1. Управление оборудованием: демон на NestJS. Мост между базой MariaDB и железом по протоколу ModBus (RTU-over-TCP). На каждый шлюз одно общее соединение и сериализованная очередь команд, чтобы на общей шине не было коллизий. Двусторонние мосты с оборудованием (печь, блоки 16-IN / 16-OUT, механизмы бассейна, вентиляция, химия): датчики и входы пишутся в базу, команды из базы уходят на реле. По каждому слейву и параметру виден статус, последнее значение, время опроса и ошибка: наблюдаемость, которой в старой системе не было. Учётки MariaDB по принципу наименьших прав: чтение телеметрии и запись команд разведены, доступ к таблице реле закрыт для лишних пользователей.
2. Видеонаблюдение на WebRTC. Живой просмотр около 20 разнородных IP-камер (Hikvision, AXIS; H.264 / H.265 / MJPEG, две подсети) на веб-стене с субсекундной задержкой через MediaMTX (RTSP в WebRTC по WHEP). Самопишущийся генератор конфига проверяет доступность камеры, определяет кодек, нормализует поток в совместимый с браузером H.264, для тяжёлых 4K-камер берёт суб-поток, а недоступные камеры пропускает, чтобы одна мёртвая камера не роняла систему. Админка камер с ролями доступа, запись с расчётом ёмкости диска. Плеер и стена на React и TypeScript, nginx как reverse-proxy.
3. Админ-панель оператора на NestJS и React. Замена старого PHP-админа: пульт с живыми показаниями датчиков, календарь на 5 недель, карточка заказа с тарификацией по получасам (взрослые и дети по возрастам), оплаты, управление механизмами и светом, блок «Под Бассейном», таймер фильтра, уставки химии. Интерфейс воспроизведён 1:1 со старой админки: операторам на живом объекте не пришлось переучиваться. Панель пишет только «вход» (заказ и его уставки), исполняет его существующая автоматика: панель встроена в живой контур без изменения контракта с железом. Запись заказа одной транзакцией с проверкой пересечений по времени, журнал действий оператора, деплой с миграциями и smoke-проверкой /health, защита от записи в «не ту» базу на уровне кода.
Всё объединено общей инфраструктурой, единым стеком (NestJS, React, TypeScript, Node.js, MariaDB) и общей моделью данных: это связный комплекс автоматизации объекта, а не три отдельные работы.
Получился единый комплекс автоматизации сауны: оператор ведёт заказы и управляет оборудованием из современной админ-панели на React, команды доходят до реле через наблюдаемый ModBus-мост на NestJS, а территория и помещения видны в реальном времени на веб-стене камер по WebRTC.
Главное: всё сделано на живой, работающей сауне без остановки оборудования, миграция шла поверх действующего legacy, старая и новая админки могли работать параллельно. Видеонаблюдение стало субсекундным (было несколько секунд задержки на HLS). Появилась наблюдаемость за оборудованием: статусы, значения, ошибки по каждому слейву и параметру. Неподдерживаемый монолит на PHP, Perl и MySQL-событиях превратился в набор сервисов на современном стеке (Node.js, NestJS, React, TypeScript, MariaDB) с CI/CD, бэкапами и мониторингом.
Система работает на приватной инфраструктуре клиента (Proxmox VE, локальная сеть за NAT), поэтому публичной ссылки нет: в портфолио показаны интерфейсы подсистем и схема решения.