Работа с очередью
Жизненный цикл талона
Талон проходит путь от выдачи на терминале до завершения обслуживания. Понимание статусов помогает сотруднику и администратору правильно реагировать на неявку, откладывание и перенаправление клиента.
Схема работы
Терминал Сотрудник Система
──────── ───────── ───────
Выбор услуги
│
├─→ 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 — обычные).
Если включена предварительная запись, порядок строится так:
- Отложенные талоны — в начале.
- Записи, у которых началось окно защиты, — впереди по времени записи.
- Клиенты без записи — по приоритету услуги и времени создания.
- Записи на более позднее время — в конце: они видны, но вызвать их ещё нельзя.
Подробнее про окно защиты и вызова — в Предварительной записи и API: слоты и расписание.
Действия сотрудника
| Действие | Что происходит | Когда использовать |
|---|---|---|
| Вызвать следующего | Первый талон из очереди получает статус «Вызван», привязывается к окну и сотруднику, табло объявляет номер. | Клиент готов к обслуживанию. |
| Повторить вызов | Номер объявляется заново. Пока предыдущая озвучка не закончилась, повтор блокируется. | Клиент не услышал приглашение. |
| Начать | Статус «Обслуживается», запускается таймер обслуживания. | Клиент подошёл к окну. |
| Завершить | Статус «Завершён», талон убирается с табло; можно добавить примечание. | Приём закончен. |
| Не пришёл | Счётчик неявок увеличивается. Если он меньше лимита — талон возвращается в очередь, иначе отменяется. | Клиент не подошёл после вызова. |
| Отложить | Талон уходит из активной очереди и возвращается автоматически через указанное время (например, 5 минут). | Клиент отошёл или пришёл неготовым. |
| Вернуть | Талон снова становится ожидающим. Счётчик неявок не сбрасывается. | Клиент вернулся или ситуация изменилась. |
| Перенаправить | Талон переходит в другую услугу с новым приоритетом, но старым номером и временем создания. | Клиенту нужна другая услуга. |
| Удалить | Удаляет ожидающий или отложенный талон из очереди сотрудника. Вызванные и обслуживаемые удалить нельзя. | Талон выдан ошибочно. |
max_no_show
(по умолчанию 3). После третьей неявки талон отменяется. «Вернуть» может
снова активировать его, но счётчик неявок сохраняется.
Автоматические задачи
| Что делает система | Как часто | Результат |
|---|---|---|
| Возврат отложенных талонов | Каждую минуту | Талон со сроком откладывания в прошлом снова становится ожидающим. |
| Проверка просроченных талонов | Каждые 5 минут | Фиксирует клиентов, ожидающих дольше max_wait_minutes; они подсвечиваются в интерфейсе. |
| Автоотмена неявившихся записей | Каждую минуту | Запись отменяется, если клиент не появился за отведённое время после назначенного. |
| Очистка необслуженных талонов | Ежедневно в полночь | Удаляются талоны, оставшиеся в статусе «Ожидает» с прошлого дня. |
| Удаление тестовых записей | Ежедневно | Тестовые брони песочницы старше суток удаляются автоматически. |
Где смотреть талоны
- Справочники → Талоны — фильтрация по номеру, статусу, услуге, сотруднику и дате; отмена записи.
- Главная — живые счётчики ожидающих, вызванных и обслуживаемых, «требуют внимания», недавние талоны.
- Отчёты — история за период: время ожидания, обслуживания и нагрузка.
- Панель сотрудника — текущий клиент и очередь ожидания с таймерами.