Работа с очередью

Жизненный цикл талона

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

Схема работы

Терминал                Сотрудник                      Система
────────                ─────────                      ───────
Выбор услуги
   │
   ├─→ waiting ──→ called ──→ in_progress ──→ completed
   │      │          │            │
   │      │          ├─→ waiting / booked (не пришёл, лимит не исчерпан)
   │      │          ├─→ postponed ──→ waiting (авто)
   │      │          └─→ cancelled (после N неявок)
   │
   └─→ booked (предварительная запись) ──→ called …

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

Статусы талона

СтатусЧто означаетДоступные действия
waitingОжидает вызоваВызвать, отложить, перенаправить, удалить
calledКлиента пригласили к окнуНачать обслуживание, пропустить, отложить, вернуть, перенаправить
in_progressОбслуживается сотрудникомЗавершить, отложить, вернуть, перенаправить
completedОбслуживание завершено—
postponedОбслуживание отложеноВернётся автоматически по времени, перенаправить, удалить
cancelledКлиент не нужен: исчерпан лимит неявок или отменена записьВернуть, перенаправить
bookedПредварительная запись на будущее времяВызвать в разрешённое окно, отменить, перенести
Про пропуски. Раньше для неявки использовался статус skipped. Сейчас кнопка «Не пришёл» не переводит талон в этот статус: талон без записи возвращается в ожидание, запись — обратно в статус записи (booked), а после исчерпания лимита неявок отменяется. В фильтрах старых отчётов и выгрузках статус skipped может встречаться как исторический.

Нумерация талонов

Номер состоит из префиксов и порядкового номера: [очередь]-[услуга]-NNN. Пустые префиксы пропускаются.

Префикс очередиПрефикс услугиПример номераСчётчик
ЕстьЕстьП-К-001Отдельный для пары «очередь + услуга»
НетЕстьК-001Отдельный для услуги
ЕстьНетП-001Общий для всей очереди
НетНет001Общий для всей системы
  • Число цифр задаётся настройкой ticket_number_digits (1–6, по умолчанию 3).
  • Счётчики сбрасываются ежедневно в часовом поясе системы.
  • При переполнении диапазона нумерация начинается заново: 999 → 001.
  • При перенаправлении талона в другую услугу номер не меняется — у клиента уже распечатан первый талон.

Порядок в очереди и приоритет

Клиенты без записи стоят по приоритету услуги, затем по времени создания талона: priority ASC, created_at ASC. Меньшее число приоритета — выше в очереди (например, 1 — срочные, 5 — обычные).

Если включена предварительная запись, порядок строится так:

  1. Отложенные талоны — в начале.
  2. Записи, у которых началось окно защиты, — впереди по времени записи.
  3. Клиенты без записи — по приоритету услуги и времени создания.
  4. Записи на более позднее время — в конце: они видны, но вызвать их ещё нельзя.

Подробнее про окно защиты и вызова — в Предварительной записи и API: слоты и расписание.

Действия сотрудника

ДействиеЧто происходитКогда использовать
Вызвать следующегоПервый талон из очереди получает статус «Вызван», привязывается к окну и сотруднику, табло объявляет номер.Клиент готов к обслуживанию.
Повторить вызовНомер объявляется заново. Пока предыдущая озвучка не закончилась, повтор блокируется.Клиент не услышал приглашение.
НачатьСтатус «Обслуживается», запускается таймер обслуживания.Клиент подошёл к окну.
ЗавершитьСтатус «Завершён», талон убирается с табло; можно добавить примечание.Приём закончен.
Не пришёлСчётчик неявок увеличивается. Если он меньше лимита — талон возвращается в очередь, иначе отменяется.Клиент не подошёл после вызова.
ОтложитьТалон уходит из активной очереди и возвращается автоматически через указанное время (например, 5 минут).Клиент отошёл или пришёл неготовым.
ВернутьТалон снова становится ожидающим. Счётчик неявок не сбрасывается.Клиент вернулся или ситуация изменилась.
ПеренаправитьТалон переходит в другую услугу с новым приоритетом, но старым номером и временем создания.Клиенту нужна другая услуга.
УдалитьУдаляет ожидающий или отложенный талон из очереди сотрудника. Вызванные и обслуживаемые удалить нельзя.Талон выдан ошибочно.
Лимит неявок задаётся настройкой max_no_show (по умолчанию 3). После третьей неявки талон отменяется. «Вернуть» может снова активировать его, но счётчик неявок сохраняется.

Автоматические задачи

Что делает системаКак частоРезультат
Возврат отложенных талоновКаждую минутуТалон со сроком откладывания в прошлом снова становится ожидающим.
Проверка просроченных талоновКаждые 5 минутФиксирует клиентов, ожидающих дольше max_wait_minutes; они подсвечиваются в интерфейсе.
Автоотмена неявившихся записейКаждую минутуЗапись отменяется, если клиент не появился за отведённое время после назначенного.
Очистка необслуженных талоновЕжедневно в полночьУдаляются талоны, оставшиеся в статусе «Ожидает» с прошлого дня.
Удаление тестовых записейЕжедневноТестовые брони песочницы старше суток удаляются автоматически.

Где смотреть талоны

  • Справочники → Талоны — фильтрация по номеру, статусу, услуге, сотруднику и дате; отмена записи.
  • Главная — живые счётчики ожидающих, вызванных и обслуживаемых, «требуют внимания», недавние талоны.
  • Отчёты — история за период: время ожидания, обслуживания и нагрузка.
  • Панель сотрудника — текущий клиент и очередь ожидания с таймерами.