Инфраструктура
- Docker-compose на Linux VPS (2+ GB RAM)
- MySQL 8 — данные на сервере клиента
- HTTPS, runbook деплоя
Архитектура
Технологии и архитектура
Архитектура без SaaS и vendor lock-in. Платформа разворачивается на VPS заказчика, данные остаются в его инфраструктуре, а стек собран из стандартных технологий, которые сможет поддерживать любая DevOps-команда. Конфигурации VPS и типичные ошибки деплоя — в материале о требования к серверу; юридический контур — в разделе 152-ФЗ и персональные данные.
Backend
- Node.js 20, Express 4
- REST API (/api/…), публичные /api/public/*
- AES-256-GCM для ПД, audit log
Frontend
- React 18, TypeScript, Vite
- Публичные страницы регистрации
- SSR-ready static
Интеграции
- API ФНС kkt-online (Промо.Про)
- ЮKassa (Тикет.Поинт)
- OCR Tesseract.js (fallback)
Инженерные артефакты
Что получает команда заказчика
На внедрении почти никогда не хватает слов “мы всё настроим”. DevOps хочет runbook, ИБ спрашивает роли и выгрузки, менеджер проекта просит чеклист запуска. Поэтому вместе с инстансом отдаём рабочие артефакты, а не только доступы.
Runbook деплоя
Команды запуска, переменные окружения, настройка HTTPS, порядок обновления и rollback-план.
Smoke-чеклист
Проверка публичной формы, QR-регистрации, входа в кабинет, выгрузки и ключевых интеграций.
Схема ролей и доступов
Кто видит ПД, кто модерирует заявки, кто выгружает базу и кто отвечает за настройки сценария.
Описание API
Контракты публичных endpoints, webhooks и точки для интеграции с CRM, сайтом или ботом.
Почему стек собран именно так
Без vendor lock-in
Если через полгода заказчик уходит к другому хостеру, проект не должен переезжать “на авось”. Поэтому образ обычный, без привязки к одному облаку. Данные переносятся стандартно, не через экспорт из закрытого SaaS.
Данные остаются у вас
Это важно не для красивой формулировки “данные ваши”. Это важно, когда служба ИБ спрашивает, кто реально может зайти в прод и кто увидит выгрузку участников. После деплоя доступ остаётся под вашим контролем.
Стандартный стек
Node.js, MySQL и Docker выбраны не ради модности, а потому что с ними умеют работать почти любые штатные DevOps и интеграторы. Это уменьшает стоимость поддержки после запуска.
Минимальные требования к VPS
- ОСUbuntu 22.04 LTS или Debian 12
- CPU2 vCPU (4 vCPU рекомендуется)
- RAM2 GB (4 GB для Промо.Про с OCR)
- Диск20 GB SSD (50 GB для production)
- СетьСтатический IP или домен с A-записью
- HTTPSLet's Encrypt — настраивается в runbook
Хостеры РФ: Selectel, Timeweb Cloud, Beget VPS, МТС Cloud, Яндекс Cloud
Нет своего DevOps?
Поднимем compose на вашем VPS, HTTPS, smoke-test. Нужен только SSH. Сервер остаётся у вас.
45 000 ₽
Turnkey-внедрение под ключ
REST API для интеграций
Интеграции почти всегда появляются после первого запуска: CRM, бот, внутренняя форма, отчётность. Поэтому есть публичные /api/public/*. Если нужен нестандартный обмен, scope лучше фиксировать отдельно, иначе “маленькая доработка” быстро превращается в отдельный проект.