Как QR-код передаёт номер стола и не даёт заказу потеряться

QR-код передаёт стол не через изображённую цифру, а через уникальный ключ в ссылке. Приложение разрешает ключ в конкретную точку и запись стола, сохраняет этот контекст, а при оформлении отправляет внутренний идентификатор стола вместе с заказом.

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

Если читать 30 секунд

• Короткий маршрут /t/<qrKey> сначала разрешает ключ и получает точку, стол, подпись и название заведения.
• Заказ содержит внутренний tableId; сервер отклоняет стол, который не принадлежит выбранной точке.
• Правильный ключ не исправит перепутанные физические таблички: система честно передаст стол, которому этот ключ выдан.
• После перевыпуска ключа старый QR перестаёт разрешаться и весь тираж нужно проверить заново.
• Обычный гостевой вход показывает интерфейс меню, но не подтверждает семантику прямого /t/<qrKey> и привязку конкретной таблички.

Что на самом деле зашито в ссылке

У каждого стола есть внутренняя запись с точкой, подписью и уникальным QR-ключом. Сам ключ используется в адресе /t/<qrKey> или в параметре запуска мини-приложения. Гостю не нужно видеть внутренний идентификатор базы и вручную вводить номер.

После открытия прямой ссылки клиентское приложение вызывает публичное разрешение ключа. Сервер находит стол по точному значению и возвращает placeId, tableId, номер или подпись, название точки и признак демо-режима. Приложение сохраняет эти данные как QR-контекст и загружает меню выбранного заведения.

На оформлении в заказ попадают placeId и tableId. Сервер отдельно проверяет, что стол существует и относится к этой точке. Поэтому подмена tableId на стол другого заведения не создаст допустимый заказ.

Эта схема отличается от общей ссылки на заведение. Сравнение маршрутов есть в матрице «стол или точка»: короткий адрес выбирает заведение, но не несёт конкретный контекст стола.

Пять звеньев маршрута заказа

Чтобы найти ошибку, разложите путь на пять звеньев.

1. Физический носитель. Табличка закреплена на конкретном столе и подписана для персонала.
2. Прямая ссылка. QR открывает /t/<qrKey> или эквивалентный вход через мессенджер с тем же ключом.
3. Разрешение ключа. Сервер возвращает одну запись стола и её точку либо сообщает, что код недействителен.
4. Оформление. Приложение отправляет разрешённые placeId и tableId, а не номер, введённый по памяти.
5. Рабочая очередь. Карточка показывает подпись стола, по которой смена направляет выдачу.

Потеряться заказ может не только в коде. Если табличку со стола 4 положили на стол 7, все технические звенья выполнятся правильно, но карточка укажет стол 4. Система не видит расположение пластика в зале. Поэтому физическая сверка равна по важности серверной проверке.

Парный протокол «табличка → стол → заказ → очередь»

Проводите тест вдвоём. Проверяющий А остаётся в зале с табличкой и гостевым телефоном. Проверяющий Б находится у рабочей очереди. Они не подсказывают друг другу ожидаемый номер до появления карточки.

Шаг 1. Зафиксировать пару

Проверяющий А записывает подпись стола и маркировку на обратной стороне таблички. Проверяющий Б открывает список столов выбранной точки и находит ожидаемую запись. Если на носителе нет служебной маркировки, добавьте её до тиража: она нужна персоналу, а не гостю.

Критерий готовности: оба человека называют одну и ту же пару «носитель — стол», не сканируя код.

Шаг 2. Разрешить ключ

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

Критерий готовности: приложение получило QR-контекст без ручного выбора другого стола. Если появился список заведений или ошибка определения стола, тест остановлен.

Шаг 3. Оформить нейтральный тестовый заказ

Используйте заранее согласованную доступную позицию и пометку, по которой смена отличит тест. Не оформляйте заказ в реальной рабочей точке без разрешения ответственного. Проверьте корзину, оформление и видимый контекст стола.

Критерий готовности: сервер принял заказ с разрешённым столом. Нельзя исправлять стол вручную после сканирования, иначе вы проверите другой маршрут.

Шаг 4. Сверить карточку смены

Проверяющий Б находит новую карточку и называет дневной номер, стол и тестовую позицию. Только после этого проверяющий А сообщает, за каким столом физически находится.

Критерий готовности: физический стол, экран гостя и подпись в очереди совпали. Совпадение одного номера на телефоне недостаточно, если очередь показывает другое назначение.

Шаг 5. Закрыть тест и поменяться ролями

Тестовый заказ отменяют или проводят по согласованному тестовому сценарию, чтобы он не остался в рабочем потоке. Затем проверяющие меняются ролями и повторяют процедуру для следующей таблички.

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

Реестр носителей после печати

Для небольшого зала достаточно простой таблицы. Не храните в ней лишние персональные или секретные данные; нужен контроль физического тиража.

Точка	Подпись стола	Маркировка носителя	Дата печати	Ключ разрешён	Тестовый заказ	Стол в очереди	Проверили
____	____	____	____	да / нет	№ ____	____	__ / __

Две подписи в последней колонке означают парную проверку. Если таблички печатаются партиями, укажите дату или номер партии. Тогда после ошибки не придётся заново проверять носители, которые не менялись.

Реестр не заменяет список столов в административной части. Он связывает цифровую запись с физическим предметом. Для выбора материала, размера и служебной подписи пригодится отдельный разбор настольных QR-табличек.

Как принять целую партию без выборочной слепоты

Не проверяйте только первый и последний QR из пачки. Ошибка печати может относиться к одной строке макета, а перестановка — к двум соседним носителям. Разложите таблички в порядке реестра и для каждой выполните разрешение ключа. Тестовый заказ нужен для каждой уникальной пары «ключ — стол», потому что именно он подтверждает продолжение маршрута до очереди.

Разделите приёмку на два круга. В первом проверяющий А сканирует носители по порядку, а проверяющий Б отмечает результат разрешения. Затем перемешайте роли, но не таблички: второй человек сверяет физическую подпись и делает контрольные заказы. Такой порядок снижает риск, что один сотрудник автоматически подтвердит собственную раскладку.

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

На открытии смены дежурный получает не стопку табличек, а закрытый реестр: для каждого носителя указаны стол, дата проверки и две роли. Если уборка временно снимает QR со столов, храните их в подписанных ячейках. Это проще, чем ежедневно восстанавливать соответствие по внешнему виду одинаковых табличек.

Что ломается после перестановки столов

Перестановка мебели не меняет ключ внутри уже напечатанного QR. Если сотрудники переносят таблички вместе со столами и сохраняют подписи, маршрут остаётся тем же. Если носители собирают в одну стопку и раскладывают заново, риск перепутать пары резко возрастает.

После любой перестановки выполните минимум второй и четвёртый шаги протокола: разрешите ключ на месте и сравните стол в очереди. Не ограничивайтесь тем, что камера распознала QR. Камера подтверждает читаемость изображения, а не правильную привязку.

Если меняется сама подпись стола, обновите цифровую запись и физическую маркировку вместе. Не оставляйте сотрудникам скрытое правило «в системе стол 4, в зале он теперь 7». Такие соответствия держатся до первой новой смены.

Что происходит при перевыпуске ключа

Администратор может сгенерировать новый QR-ключ для стола. Сервер заменяет старое значение в записи. После этого старый код больше не находится по прежнему ключу, а новый должен попасть на физический носитель.

Перевыпуск полезен, если ссылка утекла, носитель потерян или ключ нужно заменить по внутренней политике. Но он создаёт окно риска: новый файл уже существует, а на столе ещё лежит старый QR. Планируйте замену как одну операцию.

1. подготовьте новый носитель;
2. снимите старую табличку;
3. установите новую на тот же стол;
4. выполните парный тест;
5. уничтожьте или явно пометьте старый тираж;
6. закройте запись в реестре носителей.

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

Диагностика по симптому

Что видит гость или смена	Вероятная причина	Что проверить первым
Ошибка определения стола	Неверный, устаревший или неполный ключ	Полный адрес и дату перевыпуска
Открылось другое заведение	Носитель из другой точки	Маркировку партии и запись стола
На телефоне стол верный, в зале другой	Таблички переставлены	Физическую пару носитель — стол
Заказ отклонён при оформлении	Стол не существует или не принадлежит точке	Результат разрешения ключа и выбранную точку
Карточка пришла верно, заказ отнесли не туда	Ошибка выдачи после маршрутизации	Порядок сверки номера и стола

Последний симптом не исправляется новым QR. Если карточка содержит правильное назначение, проверяйте работу с заказом со стола и порядок выдачи. Технологический маршрут уже завершился корректно.

Заказ не теряется, когда совпадают четыре объекта

Надёжная маршрутизация требует совпадения физической таблички, записи стола, контекста оформления и карточки очереди. QR-ключ связывает цифровые части, а парный протокол подтверждает, что носитель лежит там, где предполагает система.

Проверяйте каждую новую или перемещённую табличку до рабочей смены. Перед печатью партии согласуйте парную проверку прямого маршрута для своей точки, а после тестового заказа отдельно пройдите сервисные события статуса. Если ошибка появилась, найдите конкретное звено маршрута и не перевыпускайте весь тираж без причины.