Редактирование: алгоритм-анализа-авторизации

Путь: 10_Логи_и_диагностика/алгоритм-анализа-авторизации.md

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

# Алгоритм анализа авторизации гостя по карте

Применяется, когда гость не привязывается / не авторизуется на кассе или не получает бонусы.

## Шаги анализа

1. Узнать идентификатор гостя: номер карты (`card`), `phone` или `external_id`.
2. Найти в логе запрос авторизации, например:
   ```
   {"card":"99001","phone":null}
   ```
3. Определить `X-Request-Id` запроса.
4. По `X-Request-Id` найти ответ → проверить `status` / `code` / `message`.
5. Если `"status":"error"` → собрать `X-Request-Id` и тело запроса для передачи в отдел ПЛ.

**Пример строки с X-Request-Id:**
```
[2025-08-04 11:31:49,434] INFO [16] - === X-Request-Id: 24a8fcf0-5b5b-47fc-939a-bd6260aca3cc ===
```

> В серверном логе (`loyalty_api`) запрос и ответ метода `GetGuest` связаны общим `hash` — по нему можно сопоставить отправленные параметры и возвращённые данные гостя.

## Типичные причины проблем с авторизацией

- Карта неактивна / не найдена на сервере.
- Сервер вернул `status:error` (код 520) → нужен серверный лог по `X-Request-Id`.
- Плагин не обрабатывает пустой ответ (требуются null-проверки).
- Форматы номера карты отличаются (префиксы, пробелы).

## Что передать в отдел ПЛ

- `X-Request-Id` проблемного запроса;
- тело запроса (`BODY` / `params`);
- тело ответа (`status` / `code` / `message`);
- данные гостя (карта / телефон) и время ошибки.

Отмена