Automation Systems EsenliteM

Разработка ПО и системы автоматизации

Система управления гостиницей EsenliteM Plaza

Техническая документация · Версия 1.4

Правообладатель: ООО «ЭсенЛайт»

ОГРН: 1213600017135 · ИНН: 3665816130

Адрес: 394048, г. Воронеж, ул. Долинная, д. 9

Контакты: info@esenlite.com · 8-960-110-80-40

1. Назначение

«Система управления гостиницей EsenliteM Plaza» — программное обеспечение для комплексной автоматизации работы предприятий сферы гостеприимства: гостиниц, отелей, апартаментов, пансионатов. Система объединяет обслуживание гостей, координацию работы персонала, управление рестораном и дополнительными услугами, а в расширенной конфигурации — управление инженерным оборудованием помещений.

Программное обеспечение работает автономно в локальной сети объекта и не требует постоянного подключения к сети Интернет.

2. Функциональные характеристики

Обслуживание гостей

приём заявок из номера: заказ еды, вызов персонала, уборка, техническая помощь;
бронирование услуг и трансфера, экстренный вызов;
отображение статуса исполнения заявок для гостя.

Управление номерным фондом

ведение номеров и их характеристик, контроль статусов;
заселение и выселение с учётом сроков проживания;
формирование задач на уборку.

Управление персоналом

ведение сотрудников и ролей, учёт рабочих смен;
автоматическое распределение заявок по компетенциям;
контроль сроков исполнения, выявление просроченных заявок.

Управление рестораном

ведение меню по категориям и позициям с фотографиями;
обработка заказов по цепочке «повар — официант»;
управление залом, столами и бронированием.

Дополнительные услуги и администрирование

управление объектами инфраструктуры, учёт трансфера, формирование счетов;
мастер первоначальной настройки;
сводная панель состояния гостиницы в реальном времени;
разграничение доступа для персонала и администратора.

Управление инженерным оборудованием (расширенная конфигурация)

приём данных от датчиков и управление оборудованием по протоколу MQTT;
взаимодействие с оборудованием по открытым протоколам без привязки к производителю.

Конфигурации поставки

Вариант 1 «Сервис» — обслуживание гостей без управления оборудованием;
Вариант 2 «Сервис и управление» — полный функционал с управлением инженерным оборудованием помещений.

3. Системные требования

серверная операционная система: Linux, включая российские дистрибутивы (Astra Linux, РЕД ОС и совместимые);
среда развёртывания: Docker;
клиентская часть: любое устройство с современным веб-браузером (планшет, компьютер, мобильное устройство);
работа в локальной сети без подключения к Интернету.

4. Установка и настройка

развёртывание выполняется из комплекта поставки через контейнеризацию Docker;
первичная настройка производится через встроенный мастер: выбор конфигурации, ввод параметров объекта, заведение номеров, ролей и персонала;
активация выполняется лицензионным ключом с привязкой к оборудованию;
подробная инструкция входит в комплект поставки (руководство по установке).

5. Эксплуатация

Гость — через интерфейс номера подаёт заявки и видит их статус;
Персонал — получает распределённые заявки, отмечает исполнение;
Администратор — управляет настройками, видит сводную панель, формирует отчёты.

6. Техническая поддержка

Техническую поддержку, обновления и сопровождение осуществляет правообладатель — ООО «ЭсенЛайт». Все пароли, коды доступа и эксплуатационная документация передаются заказчику. Система остаётся полностью в управлении владельца объекта.

Контакты: info@esenlite.com, телефон 8-960-110-80-40.

Информация, необходимая для установки программного обеспечения

Настоящий раздел содержит полную информацию, необходимую для установки программного обеспечения «Система управления гостиницей EsenliteM Plaza», версия 1.4. Правообладатель — ООО «ЭсенЛайт» (ОГРН 1213600017135, ИНН 3665816130).

1. Состав комплекта поставки

plaza-1.4.tar.gz — файл системы в упакованном виде, около 72 МБ;
docker-compose.yml — описание запуска;
.env.example — образец файла настроек;
установить.sh — скрипт первичной установки;
запустить.sh, остановить.sh — скрипты управления;
проверить.sh — проверка готовности;
лицензия.sh — состояние лицензии;
копия.sh — резервное копирование;
очистить.sh — очистка рабочих данных;
журнал.sh — просмотр журнала работы.

2. Требования к среде

операционная система Linux, включая российские дистрибутивы Astra Linux и РЕД ОС;
установленные Docker и Docker Compose;
веб-браузер для доступа к интерфейсу системы.

3. Порядок установки

Все действия выполняются на компьютере (сервере), где будет постоянно работать система.

Скопируйте папку комплекта на компьютер в постоянное расположение, например в домашнюю папку пользователя.
Откройте командную строку сочетанием клавиш Ctrl+Alt+T.
Перейдите в папку с системой и проверьте содержимое:
```
cd ~/plaza-postavka
ls
```
Разрешите запуск скриптов:
```
chmod +x *.sh
```
Запустите установку:
```
./установить.sh
```
Программа запросит пароль учётной записи. Установка занимает около минуты. В конце выводится идентификатор сервера — длинная строка из букв и цифр.
Идентификатор сервера передаётся правообладателю для получения лицензионного ключа. Без ключа система работает в режиме просмотра.

4. Настройка

Заполните файл настроек командой nano .env и укажите параметры:

Параметр	Значение
`LICENSE_KEY`	лицензионный ключ формата ESL-XXXX-XXXX-XXXX-XXXX
`LICENSE_OBJECT`	название объекта внедрения
`MQTT_BROKER`	адрес контроллера в сети; если инженерное оборудование не используется — оставить по умолчанию
`APP_PORT`	порт приложения, по умолчанию 8000

Сохранение файла: Ctrl+O, Enter, Ctrl+X. Затем запустите систему: ./запустить.sh — на экране появится адрес для доступа к системе.

5. Первичная настройка через мастер

В браузере откройте адрес системы с окончанием /v2/setup/. Мастер проведёт по четырём шагам: параметры отеля, номера, сервисы, сотрудники.
Номера вводятся построчно по этажам.
После мастера заполняются справочники: персонал и PIN-коды, меню ресторана, расстановка зала, услуги отеля, направления трансфера.
Проверьте готовность командой ./проверить.sh. Строки с пометкой «ошибка» требуют устранения, с пометкой «внимание» — на усмотрение пользователя.
Планшеты в номерах: на карте системы по адресу с окончанием /v2/help/ перечислены номера со ссылками. На каждом планшете устанавливается браузер-киоск с прописанной ссылкой номера в качестве стартовой страницы.

Информация, необходимая для эксплуатации программного обеспечения

6. Повседневная работа

Управление системой выполняется скриптами из папки комплекта:

Команда	Назначение
`./запустить.sh`	включение системы
`./остановить.sh`	выключение системы
`./проверить.sh`	проверка настройки и готовности
`./лицензия.sh`	состояние лицензии
`./копия.sh`	создание резервной копии данных
`./журнал.sh`	просмотр журнала работы системы

Резервное копирование рекомендуется выполнять не реже одного раза в неделю с переносом архивов на другой носитель или в облачное хранилище.

7. Работа пользователей

Доступ к системе осуществляется через веб-браузер, установка дополнительного программного обеспечения на устройства пользователей не требуется. Сотрудники входят в систему по персональному PIN-коду и видят только разделы, доступные их роли.

Гость — планшет в номере: подача заявки на обслуживание, заказ питания, вызов персонала, дополнительные услуги.
Персонал — получение заявки, принятие в работу, отметка о выполнении.
Администратор — сводная панель состояния гостиницы, номерной фонд, справочники, отчёты, настройки.

8. Устранение типовых неполадок

Признак	Действия
Сообщение «Система не активирована»	Лицензия не подтверждена. Выполнить `./лицензия.sh`, передать идентификатор оборудования правообладателю, вписать полученный ключ в файл `.env`, перезапустить систему.
Система не открывается в браузере	Проверить работу командой `./журнал.sh`.
Заявка гостя не появляется у персонала	Не заведены сотрудники нужной роли. Выполнить `./проверить.sh`.
Планшет показывает «Нет доступа»	Прописана неверная ссылка. Взять корректную на странице `/v2/help/`.

9. Техническая поддержка

ООО «ЭсенЛайт», телефон 8 (960) 110-80-40, электронная почта info@esenlite.com, сайт esenlite.ru. Поддержка оказывается по вопросам установки, настройки и эксплуатации программного обеспечения.