Редактирование: диагностика-iiko

Путь: 02_Настройка_iiko/диагностика-iiko.md

Содержимое (Markdown)

# Диагностика iiko (сбор логов и конфигов)

Инструкция описывает работу с предустановленным ПО «Диагностика» для сбора логов с кассы, ручное снятие логов плагина, а также справочную информацию по iikoWaiter (iiko water).

## ПО «Диагностика»

«Диагностика» — предустановленная программа (устанавливается в момент установки iiko на кассы), предназначенная для сбора данных с кассы за нужный период.

> **Важно.** Во время работы в ПО кассовый терминал занят — клиент не сможет использовать iiko в ресторане, так как программа будет свёрнута. Перед использованием обязательно предупредите клиента, что терминал будет занят 5–10 минут. Кассовая программа **iikoFront должна быть запущена** — если она выключена, «Диагностика» не отобразит данные по ней. Закрывать программу во время работы нельзя.

### Запуск ПО

1. Свернуть iiko: нажать значок сворачивания в верхнем правом углу. Если кнопки «Свернуть» нет — нажать **F3**, после чего окно iiko уменьшится и откроется рабочий стол кассы.
2. Если после сворачивания открылся чёрный экран:
   - Вызвать **«Диспетчер задач»** через интерфейс AnyDesk или комбинацией `Ctrl+Alt+Del`.
   - Создать новую задачу («Запустить новую задачу» / «Создать задачу») и прописать команду `explorer`. После ввода появится рабочий стол.

### Сбор логов

1. ПО находится в меню «Пуск» рядом с иконкой iiko.
2. После запуска дождаться загрузки нужной кассы.
3. Найдя нужную кассу, проставить галочку у папки **«Logs»** — так программе указывается, что нужны только логи с этой кассы.
4. Выбрать период (дату), за который нужно собрать лог. За один день — выбрать конкретную дату; за несколько — выставить интервал.
5. Сохранить лог в нужную папку.
6. Нажать кнопку **«Собрать архив»** — программа откроет папку, в которой будет лежать лог.
7. В архиве много лишних папок; при необходимости логи можно вытащить из архива.

> Если лог не найден на 1-й кассе — войти на 2-ю и проверить лог на ней.

### Завершение работы

После сбора всех логов:
- закрыть ПО «Диагностика»;
- открыть кассовую программу обратно, чтобы клиент мог в ней работать.

## Ручное снятие логов плагина

Если требуется снять логи вручную (без ПО «Диагностика»):

1. В админке открыть раздел **«Приложения»**, по номеру поинта найти настройки «Конфигурации плагина для iiko» нужной кассы (название кассы — в поле «Псевдоним кассы»), скопировать оттуда логин AnyDesk.
2. Подключиться к удалённой кассе по AnyDesk и перейти в режим файлового менеджера.
3. Перейти в директорию:
   ```
   C:\Users\User\AppData\Roaming\iiko\CashServer\Logs
   ```
   Вместо `User` может быть `POS-User`, `Administrator`, `Public` и т.д. (зависит от учётной записи). Также можно ввести `%appdata%` прямо в адресную строку AnyDesk.
4. В папке `Logs` найти файлы, в названии которых есть `BeOpen.Front.Remarked.JsonRpc` или `plugin-Get.Front.RemarkedPlugin`. Логи за сегодняшний день — с расширением `.log`, за предыдущие дни — `.zip`.
5. Скопировать нужный файл/файлы на свой компьютер (кнопка «Скачать» в контекстном меню или перетаскиванием).

> Если лога за сегодня нет, а есть только за предыдущий день — подождать ~2 минуты для прогрузки. На кассе логи архивируются автоматически, примерно в 12:00 по местному времени за предыдущий день.

При передаче лога дополнительно сообщить:
- скриншот или видео ошибки;
- дату и время ошибки;
- пример гостя, по которому произошла ошибка (ФИО, номер телефона или номер карты).

## iiko water (iikoWaiter)

iikoWaiter — модуль системы автоматизации ресторанного бизнеса iiko, работающий на мобильных устройствах под управлением Android или iOS. Приложение обеспечивает доступ к функционалу iikoFront: создание, редактирование и оплату заказов, просмотр меню, управление столами и синхронизацию с сервером iiko.

Документация iikoWaiter — централизованный справочный ресурс, в котором подробно описаны:
- основные принципы работы приложения;
- модели сценариев (чекин гостя и другие);
- технические детали и внутренние механизмы;
- известные проблемы, способы их диагностики и решения.

Ссылка на документацию:
```
https://arbus.atlassian.net/wiki/spaces/IIKOWAITER/pages/1802241
```

Отмена