Отчёты и система
Установка системы
Развёртывание состоит из двух частей: серверная часть на Linux и терминалы с принтерами и экранами. Все шаги автоматизированы скриптами; вручную настраиваются только параметры площадки.
Что нужно до начала
- Сервер Debian/Ubuntu (поддерживаются Астра Linux и РЕД ОС), доступ root.
- 2 ядра, 3 ГБ ОЗУ, SSD от 20 ГБ.
- Лицензионный ключ формата
XXXX-XXXX-NN. - Внешний IP или домен, если система должна быть доступна извне.
- Для терминала — сенсорный монитор, термопринтер и графическая сессия X11.
Серверная часть
- Передайте каталог проекта на сервер:
src,scripts,drivers, конфигурационные файлы. - Запустите установку от root:
sudo bash scripts/server/install.sh <ЛИЦЕНЗИОННЫЙ_КЛЮЧ> - Дождитесь завершения. Скрипт ставит Docker, PostgreSQL, Node.js, PM2, зависимости, применяет схему БД, создаёт пользователей и демо-данные.
- Сохраните сводку
reports/server-install.txt: в ней URL подключения и все логины/пароли. Они показываются один раз. - Проверьте URL в
deploy.conf— оттуда их читают скрипты терминалов. - Войдите в админку и пройдите быстрый старт.
install-server-docker.sh разворачивает приложение и базу внутри
одного контейнера. Поддерживаются режимы сети host и bridge, а также несколько
копий на одном сервере с разными портами.
URL в deploy.conf
После установки в корне проекта сохраняются адреса всех экранов:
SERVER_URL=https://<IP_СЕРВЕРА>:3001
TERMINAL_URL=https://<IP_СЕРВЕРА>:3001/terminal
DISPLAY_URL=https://<IP_СЕРВЕРА>:3001/display
DISPLAY2_URL=https://<IP_СЕРВЕРА>:3001/display2
BRAND_DISPLAY_URL=https://<IP_СЕРВЕРА>:3001/brand/display
EMPLOYEE_URL=https://<IP_СЕРВЕРА>:3001/employee
ADMIN_URL=https://<IP_СЕРВЕРА>:3001/admin
Приоритет: аргумент командной строки → переменная окружения →
deploy.conf → локальный адрес по умолчанию.
Терминал: принтер
- Подключите термопринтер по USB.
- Установите драйверы из локальной папки
drivers/:sudo bash scripts/kiosk/install_printer_drivers.sh - Проверьте тестовую страницу. Скрипт создаёт очередь CUPS для подключённого принтера и назначает её по умолчанию.
- Проверьте печать из системы: настройки печати и тестовый талон.
Скрипт не скачивает драйверы из интернета: архивы должны лежать в
drivers/. Очереди для неподключённых принтеров удаляются, чтобы
не путать выбор.
Терминал: экран и киоск
| Команда | Что делает |
|---|---|
assign_screens.sh | Основной мастер экрана: настраивает Chromium и автозапуск, распределяет URL по мониторам (например, терминал на сенсоре, табло на остальных). Адреса берутся из deploy.conf или передаются явно. |
calibrate_screen.sh | Калибровка сенсора: xinput_calibrator или четыре мишени; записывает kiosk.conf и конфиг X11. |
make_kiosk_toggle_shortcuts.sh | Создаёт ярлыки «Остановить экраны» и «Продолжить экраны» для временного снятия киоска на время работ. |
install_printer_drivers.sh | Драйверы термопринтеров из локальной папки drivers/ и тестовая страница. |
После настройки экран запускается автоматически при включении машины. Браузер открывается в режиме киоска, игнорирует самоподписанный сертификат и не показывает уведомления.
Проверка установки
- Админка открывается, вход работает.
- Терминал показывает услуги и печатает талон.
- Табло показывает вызов и озвучивает его.
- Сенсорный экран попадает в нажатия после калибровки.
- Сервисы PM2 запущены и восстанавливаются после перезагрузки.
- Самодиагностика не показывает критичных ошибок.
Обслуживание
| Задача | Скрипт или раздел |
|---|---|
| Переустановка с очисткой данных | scripts/server/reinstall.sh (создаёт страховочный дамп). |
| Полное удаление системы | scripts/server/uninstall.sh. |
| Восстановление базы | scripts/server/restore_db.sh или раздел «Резервное копирование». |
| Распознавание голосовых | scripts/server/install-stt-model.sh — опционально. |
| Несколько копий системы | Скрипт развёртывания копий с отдельными портами и базой. |