Отчёты и система

Установка системы

Развёртывание состоит из двух частей: серверная часть на Linux и терминалы с принтерами и экранами. Все шаги автоматизированы скриптами; вручную настраиваются только параметры площадки.

scripts/server/install.sh scripts/kiosk/*

Что нужно до начала

  • Сервер Debian/Ubuntu (поддерживаются Астра Linux и РЕД ОС), доступ root.
  • 2 ядра, 3 ГБ ОЗУ, SSD от 20 ГБ.
  • Лицензионный ключ формата XXXX-XXXX-NN.
  • Внешний IP или домен, если система должна быть доступна извне.
  • Для терминала — сенсорный монитор, термопринтер и графическая сессия X11.

Серверная часть

  1. Передайте каталог проекта на сервер: src, scripts, drivers, конфигурационные файлы.
  2. Запустите установку от root:
    sudo bash scripts/server/install.sh <ЛИЦЕНЗИОННЫЙ_КЛЮЧ>
  3. Дождитесь завершения. Скрипт ставит Docker, PostgreSQL, Node.js, PM2, зависимости, применяет схему БД, создаёт пользователей и демо-данные.
  4. Сохраните сводку reports/server-install.txt: в ней URL подключения и все логины/пароли. Они показываются один раз.
  5. Проверьте URL в deploy.conf — оттуда их читают скрипты терминалов.
  6. Войдите в админку и пройдите быстрый старт.
Альтернатива: один Docker-контейнер. Скрипт 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 → локальный адрес по умолчанию.

Терминал: принтер

  1. Подключите термопринтер по USB.
  2. Установите драйверы из локальной папки drivers/:
    sudo bash scripts/kiosk/install_printer_drivers.sh
  3. Проверьте тестовую страницу. Скрипт создаёт очередь CUPS для подключённого принтера и назначает её по умолчанию.
  4. Проверьте печать из системы: настройки печати и тестовый талон.

Скрипт не скачивает драйверы из интернета: архивы должны лежать в 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 — опционально.
Несколько копий системыСкрипт развёртывания копий с отдельными портами и базой.
Не запускайте рабочую систему локально «для проверки». Настройка выполняется на сервере через админ-панель; локальный запуск не нужен и может привести к расхождению данных и конфигурации.