Настройки KDS

Настройки KDS — фронт админки

Бизнес-спека

Настройки KDS (BR 5.1)

Раздел админки для управления звуками KDS-приложений франшизы и списком зарегистрированных устройств.

---

Routes

Route	Страница
/kds-settings	Главная страница раздела (две вкладки: Звуки, Устройства)

Доступ — kds.settings.edit.

---

Sidebar

В разделе админки добавляется пункт «Настройки KDS» (после «Расписание смен»). Иконка — 📺 (планшет).

---

Вкладка 1 — «Звуки и поведение»

Layout

┌─ Настройки KDS ───────────────────────────────────┐
│ ▼ Звуки и поведение  •  Устройства                │
├────────────────────────────────────────────────────┤
│                                                     │
│ ━━ Звуки уведомлений ━━━━━━━━━━━━━━━━━━━━━━━━━ │
│  Звук нового заказа    [Bell ▼]  [▶ Прослушать]   │
│  Интервал повтора      [▬▬▬░░░] 30 сек            │
│  Звук просрочки        [Alarm ▼] [▶ Прослушать]   │
│  Громкость по умолчанию [▬▬▬▬▬▬▬▬░░] 80%          │
│                                                     │
│ ━━ Сессии ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│  Авто-логаут после          [▬▬▬░░░] 30 мин       │
│  неактивности                                       │
│                                                     │
│  ☑ Кастомные звуковые файлы (P2 — disabled)       │
│                                                     │
│              [Отменить] [Сохранить]                 │
└────────────────────────────────────────────────────┘

Поля

Поле	Тип	Validation	API field
Звук нового заказа	Dropdown из bell / chime / buzzer / marimba / digital	—	new_order_sound
Интервал повтора	Slider 5–120 сек, шаг 5	—	new_order_repeat_seconds
Звук просрочки	Dropdown из alarm / siren / bell-loud	—	overdue_sound
Громкость по умолчанию	Slider 0–100%	—	sound_volume
Авто-логаут	Slider 5–240 минут	—	auto_logout_minutes

Превью звуков

Кнопка «▶ Прослушать» рядом с дропдауном — проигрывает соответствующий mp3-файл в браузере админа (файлы в erp-admin/web/public/sounds/).

Кнопки

• Сохранить → PATCH /admin/kds/settings с изменёнными полями
• Отменить → откат значений к серверным

При успехе — toast «Настройки сохранены. KDS-устройства подхватят при следующем логине или перезапуске.»

Состояния

• Загрузка: skeleton-форма
• Ошибка VALIDATION_ERROR: inline под полем
• Network error: красный баннер сверху

---

Вкладка 2 — «Зарегистрированные устройства»

Layout

┌─ Настройки KDS ───────────────────────────────────┐
│ ▼ Звуки и поведение  •  Устройства                │
├────────────────────────────────────────────────────┤
│                                                     │
│ Фильтры: [ТТ ▼ Все]  [Статус ▼ Все]  [Поиск 🔍]  │
│                                                     │
│ ┌─ Имя ──── ТТ ───── Сотрудник ── Версия ── Online ┐│
│ │ Кухня-1   Ленина   Иван П.      0.1.0    ✓ Сейчас│
│ │ Бар-1     Ленина   Анна К.      0.1.0    ✓ 5 мин │
│ │ Кухня-2   Невский  —            0.1.0    ✗ 2 ч   │
│ │ Кухня-3   Ленина   —            0.0.9    ⚠ Старая│
│ │              ☐ Архивные  •  Удалённые отдельно   │
│ └────────────────────────────────────────────────┘ │
│                                                     │
└────────────────────────────────────────────────────┘

Колонки таблицы

Колонка	Источник	Формат
Имя	name	Жирный, кликабельный — открывает edit-modal
ТТ	store_name	Название (из cross-service lookup в Store Service)
Текущий сотрудник	current_user.first_name + last_name	Если null — «—»
Последний сотрудник	last_user.first_name	В tooltip к ячейке «Сотрудник»
Версия APK	app_version	Если ниже latest — жёлтый бейдж «Старая»
Online-статус	computed на сервере (is_online)	✓ Сейчас / ✓ N мин назад / ✗ N ч / ✗ давно
Действия	—	«✏ Переименовать» / «❌ Удалить»

Фильтры

• ТТ — список ТТ + «Все»
• Статус — Online / Offline / Все
• Поиск по имени устройства

Действия per-row

Переименовать

Модалка:

┌─ Переименовать устройство ──────┐
│  Имя: [Планшет горячего цеха]   │
│       [Отмена]   [Сохранить]    │
└──────────────────────────────────┘

API: PATCH /admin/kds/devices/{id} с { name }. После успеха — toast.

Удалить (force-logout)

Confirm:

┌─ Удалить устройство? ──────────────────────┐
│ Имя: «Кухня-2», ТТ: «Невский»             │
│                                              │
│ Активная сессия будет немедленно закрыта.   │
│ Устройство потребует повторной регистрации. │
│                                              │
│              [Отмена]    [Удалить]          │
└──────────────────────────────────────────────┘

Только для роли Владелец франшизы / партнёра (менеджер не видит кнопку).

API: DELETE /admin/kds/devices/{id} → 204. После успеха — устройство уезжает из таблицы (или становится серым с пометкой «Удалено», если активен фильтр «Архивные»).

---

Ролевой доступ

Действие	Владелец	Менеджер	Повар	Кассир
Просмотр настроек	✅	✅	❌	❌
Изменение настроек	✅	✅	❌	❌
Просмотр списка устройств	✅	✅	❌	❌
Переименовать устройство	✅	✅	❌	❌
Удалить устройство	✅	❌	❌	❌

---

Что НЕ входит в P0

• Загрузка кастомных звуковых файлов (P2 — BR 5.7)
• Превью KDS-приложения на этом же устройстве
• Push-уведомления админу при отключении устройства
• Анализ нагрузки (сколько заказов в час прошло через устройство)
• Per-store настройки звуков (только per-franchise)

---

Связи

• Бизнес-спека
• Кухонные станции — пороги цвета per-станция (соседний раздел)
• KDS Overview — что управляется этими настройками
• User Service API
• Catalog Service API