Перейти к содержанию

Подготовка справочников отеля: руководство пользователя

Где находится

  • Список типов: "Конфигуратор" → "Типы"
  • Удобства: "Конфигуратор" → "Удобства"
  • Категории: "Конфигуратор" → "Категории"

Пошаговое руководство

Шаг 1: Переход к справочникам

  1. Откройте веб-приложение Аура в браузере и войдите под учётной записью с ролью "ADMIN" или выше
  2. В боковом меню выберите раздел "Конфигуратор"

  3. В зависимости от типа справочника выберите:

    • "Типы" - откроет страницу "Список типов" для системных справочников (замки, документы, гости, события, правила заезда/выезда, Modbus-шлюзы, Modbus-устройства)
    • "Удобства" - для управления удобствами номеров
    • "Категории" - для управления категориями номеров

Шаг 2: Работа с системными справочниками ("Список типов")

2.1. Выбор категории справочника

В разделе "Список типов" доступны следующие категории:

  • Замки - управление моделями электронных замков
  • Документы - классификация документов гостей и сотрудников
  • Гости - типы гостей (VIP, резидент, разовый и т.д.)
  • Правила заезда/выезда - настройка правил обработки раннего заезда и позднего выезда с возможностью установки различных типов расчёта
  • События - типы событий при срабатывании триггера. На каждый тип события в разделе "Мониторинг" в боковом меню можно назначить триггер - правило, которое определяет, как система отреагирует на событие
  • Modbus-шлюзы - оборудование для преобразования протокола связи (TCP, RTU, ASCII) в протокол Modbus
  • Modbus-устройства - оборудование, работающее по протоколу Modbus

Пример

При событии "Тревога в номере" триггер, реагирующий на данный тип событий, может отправить вам уведомление (подробнее см. в разделе "Мониторинг состояния отеля")

2.2. Создание нового типа (общий флоу)

Для категорий "Замки", "Документы", "Гости", "Modbus-шлюзы" процесс создания одинаков:

  1. Выберите нужную категорию из списка
  2. Нажмите кнопку "+ Добавить тип" в блоке "Список типов" - система автоматически создаст новый тип с временным названием (например, "Замок 11") и добавит его в список

  3. Отредактируйте поля для нового типа:

    • Активность: переключатель в правом верхнем углу - у нового типа включён по умолчанию, можно деактивировать
    • Название типа: введите уникальное название или код типа (обязательное поле)
    • Описание: введите понятное описание типа (для некоторых категорий, например "Замки", это обязательное поле - ориентируйтесь на звёздочку в форме)

  4. Нажмите кнопку "Сохранить"

  5. Чтобы удалить тип, нажмите на иконку корзины рядом с его названием в списке

2.3. Настройка правил раннего заезда/позднего выезда

В отличие от остальных справочников, список правил здесь фиксированный - добавить новое правило или удалить существующее нельзя, можно только настроить параметры каждого из шести правил:

  1. Выберите "Правила заезда/выезда" в списке типов

  2. В блоке "Список правил" выберите одно из правил:

    • Фиксированная плата (ранний заезд / поздний выезд)
    • Почасовая оплата (ранний заезд / поздний выезд)
    • Процент от стоимости ночи (ранний заезд / поздний выезд)

  3. Заполните параметры правила (например, для "Фиксированная плата ранний заезд": "Время заезда" и "Цена")

  4. Нажмите кнопку "Сохранить"

Примечание

Состав полей формы зависит от типа правила. Скриншотом подтверждены только поля для "Фиксированная плата ранний заезд" - для остальных пяти правил состав полей не проверен, рекомендую сверить при следующих скриншотах

2.4. Управление типами Modbus-устройств

Эта категория настраивается иначе остальных - помимо названия и описания здесь задаётся протокольная карта устройства (команды и переменные)

  1. Выберите "Modbus-устройства" в списке типов
  2. Нажмите "+ Добавить тип"

  3. Заполните параметры устройства:

    • Активность: переключатель в правом верхнем углу
    • Название типа: уникальное название (например, WP8026ADAM) (обязательное поле)
    • Преднастроенный Modbus-адрес: адрес устройства на шине Modbus (обязательное поле)
    • Тип события: тип события, связанный с устройством (обязательное поле)
    • Описание: (опционально)

Команды и переменные

Настройка команд устройства и переменных (привязка бит регистра к значениям) подробно расписана со схемами в отдельном документе - см. "Команды и переменные Modbus-устройств"

Шаг 3: Управление удобствами номеров

3.1. Список удобств

  1. В боковом меню выберите раздел "Конфигуратор" → "Удобства"
  2. Откроется страница "Удобства номеров" со списком всех удобств отеля (код, название, статус)
  3. Используйте поле "Поиск по коду или названию" для быстрого поиска
  4. Нажмите на значок шестерёнки в правом верхнем углу таблицы, чтобы настроить отображаемые столбцы

3.2. Создание нового удобства

  1. Нажмите кнопку "+ Добавить удобство"

  2. В открывшемся окне "Создать удобство" заполните:

    • Активность: переключатель - включён по умолчанию
    • Код удобства: введите уникальный код (например, LOUNGE_CARPET) (обязательное поле)
    • Название удобства: введите понятное название (например, "Ковёр в гостиной") (обязательное поле)
    • Описание удобства: введите подробное описание (необязательно)

  3. Нажмите кнопку "Сохранить" (или "Отмена")

Шаг 4: Управление категориями номеров

4.1. Список категорий

  1. В боковом меню выберите раздел "Конфигуратор" → "Категории"
  2. Откроется страница "Категории номеров" со списком всех категорий: название, описание, тип зоны, места, бронь, цена за взрослого/ребёнка, доп. места, доп. цена, удобства, статус
  3. Используйте поле "Поиск по названию" или кнопку-фильтр (значок воронки) рядом с "+ Добавить категорию"
  4. В столбце "Удобства" нажмите на значок с числом (например, 39), чтобы посмотреть полный список удобств, привязанных к категории, без открытия формы редактирования

4.2. Создание новой категории

  1. Нажмите кнопку "+ Добавить категорию"

  2. В открывшемся окне "Добавить категорию" заполните блок "Основное":

    • Активно: переключатель - включён по умолчанию
    • Бронирование разрешено: переключатель - определяет, можно ли бронировать номера этой категории (отображается в столбце "Бронь" таблицы)
    • Название категории: введите название (например, "Стандарт с видом на сад") (обязательное поле)
    • Тип зоны для категории: выберите тип зоны, к которой применяется категория (обязательное поле)
    • Описание категории: введите описание (необязательно)

  3. Заполните блок "Размещение и цены за сутки":

    • Количество мест в номере: места = взрослые + дети (обязательное поле)
    • Цена за взрослого, ₽/сутки: цена за 1 взрослого в сутки (обязательное поле)
    • Количество доп. мест: дополнительные места - раскладушки, доп. кровати (обязательное поле)
    • Доп. цена за доп. место, ₽/сут: цена за 1 доп. место в сутки (обязательное поле)
    • Цена за ребёнка, ₽/сутки: цена за 1 ребёнка в сутки (обязательное поле)

Как рассчитывается стоимость номера

Все цены указываются за 1 сутки. Стоимость базовых мест = количество мест × цена за взрослого

  1. Нажмите кнопку "Сохранить" (или "Отмена")

4.3. Настройка удобств для категории

В том же окне создания/редактирования категории, в блоке "Доступные удобства" / "Выбранные удобства":

  1. Найдите нужное удобство с помощью поиска

  2. Выберите удобства для категории одним из способов:

    • Кликните на удобство для добавления
    • Перетащите удобство мышью в раздел "Выбранные удобства"

  3. Проверьте список выбранных удобств

  4. Нажмите кнопку "Сохранить"

Шаг 5: Особенности заполнения для разных категорий справочников

Для типов документов

  • Используются при регистрации гостей и оформлении документов
  • Примеры названий: PASSPORT, Паспорт, visa, ВИЗА, driver_license, Водительское удостоверение, INTERNATIONAL_PASSPORT, Загранпаспорт, migration_card, Миграционная карта, birth_certificate, Свидетельство о рождении, SNILS, СНИЛС

Для типов гостей

  • Влияют на условия размещения и уровень обслуживания
  • Примеры названий: VIP, Вип-клиент, loyalty, Постоянный клиент, CORPORATE, Корпоративный, family, Семейный, disabled, Инвалид, with_pets, С животными, FOREIGN, Иностранец

Для типов замков

  • Связаны с физическим оборудованием
  • Примеры названий: HL-F02, smart_lock_01, Карточный замок, rfid_lock, Кодовый замок, HL-F77, Электронный ключ, nfc_lock, Биометрический замок

Для типов событий

  • Используются в системе мониторинга и уведомлений
  • Примеры названий: ALARM, Тревога, cleaning, Уборка, door_open, Дверь открыта, motion_detected, Движение, fire_alarm, Пожар

Для Modbus-шлюзов

  • Критичны для интеграции оборудования
  • Пример названия: PROTOSS-PE11-H, tcp_modbus_gateway, Шлюз Модбас, rs485_converter, Конвертер протоколов, ascii_modbus

Для Modbus-устройств

  • Настраиваются через отдельный флоу с командами и переменными (см. п. 2.4)
  • Пример названия: WP8026ADAM, modbus_controller, Контроллер Модбас, RS485_device, Датчик температуры Modbus, relay_module

Для правил заезда/выезда

  • Используются для автоматического расчёта доплаты при раннем заезде/позднем выезде (см. также мануал "Настройка профиля отеля")
  • Список правил фиксированный - создать новое или удалить существующее правило нельзя

Возможные проблемы и решения

"Ошибка создания типа/удобства/категории"

Причины:

  • Название уже существует в данной категории
  • Не заполнены обязательные поля (отмечены звёздочкой *)
  • Название содержит недопустимые символы

Решение:

  1. Используйте уникальное название
  2. Заполните все обязательные поля
  3. Используйте латинские символы или кириллицу без специальных символов

"Не могу выбрать удобства при создании категории"

Причины:

  • Удобства не созданы в системе
  • Проблемы с загрузкой списка удобств

Решение:

  1. Сначала создайте необходимые удобства в разделе "Удобства"
  2. Обновите страницу создания категории
  3. Проверьте доступность удобств в системе

"Тип не отображается в списке после создания"

Причины:

  • Ошибка сохранения в базу данных
  • Проблемы с обновлением интерфейса

Решение:

  1. Обновите страницу браузера
  2. Проверьте уведомления об успешном создании
  3. Если проблема повторяется, обратитесь к системному администратору

Важная информация

  • Уникальность: каждый тип/удобство/категория должен иметь уникальное название в рамках своей группы
  • Обязательные поля: отмечены звёздочкой (*) - набор обязательных полей отличается по категориям
  • Активность: у каждого типа/удобства/категории есть переключатель активности (вкл/выкл)
  • Бронирование разрешено: у категории номеров есть отдельный переключатель, разрешающий или запрещающий бронирование (столбец "Бронь" в списке категорий)
  • Расчёт стоимости номера: стоимость базовых мест = количество мест × цена за взрослого; все цены указываются за 1 сутки
  • Просмотр удобств категории: в списке категорий можно посмотреть привязанные удобства по значку с числом, не открывая форму редактирования
  • Запрет удаления: созданные элементы нельзя удалить, если они уже используются в системе
  • Мгновенное применение: изменения применяются немедленно во всех модулях системы
  • Категории номеров: при создании категории можно выбрать несколько удобств (клик или перетаскивание)
  • Правила заезда/выезда: список правил фиксированный, не поддерживает добавление или удаление
  • Modbus-устройства: помимо названия и описания настраиваются команды и переменные (карта регистров)

Контрольный список после настройки

После подготовки всех справочников убедитесь, что:

  1. Созданы все необходимые типы документов для гостей и сотрудников
  2. Определены категории гостей в соответствии с политикой отеля
  3. Добавлены модели используемых электронных замков
  4. Настроены правила раннего заезда/позднего выезда
  5. Созданы типы событий для системы мониторинга
  6. Настроены Modbus-шлюзы для интеграции оборудования
  7. Настроены типы Modbus-устройств с командами и переменными
  8. Созданы все необходимые удобства номеров
  9. Определены категории номеров с соответствующими наборами удобств
  10. У каждой категории корректно заполнены места, доп. места и цены за сутки
  11. Все элементы имеют корректные описания для понимания их назначения