KINDOT ADMIN

Безопасность

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

Сессия входа

Вы можете завершить текущий сеанс на этом устройстве. Это удалит авторизационный cookie-токен.

Фоновый режим

Опрашивать столы в фоне Сервер сам следит за столами, даже когда вкладка закрыта — дашборд открывается мгновенно.

интервал

Управляющий бот KINDOT ADMIN

Отдельный бот для владельца и администрации заведения (не публичный @kindotbot для гостей). Владелец — полный доступ; администрация из списка ниже — урезанный вид (только столы и управление).

Администрация заведения (урезанный доступ)

По одному Telegram-id на человека. Свой id узнать: написать боту @userinfobot или /start управляющему боту — он ответит твоим id.

Кнопка Mini App в управляющем боте Ставит кнопку-меню (откроет админку по туннелю). Пускает только владельца и админов из списка. Требует заданный Chat ID владельца.

KINDOT PANEL — программа сотрудников

PANEL — отдельная программа (порт 8080, start-panel.bat) со своим паролем и своим Telegram-ботом. Сотрудники видят только столы: пароль ADMIN к PANEL не подходит, полного доступа через панель не получить. Создай бота в @BotFather (/newbot) и вставь токен — больше ничего настраивать не нужно: ты станешь управляющим бота, сотрудники из списка ниже получат доступ сразу. Новых добавляй командой /approve <id>.

Токен бота PANEL

Пароль входа в PANEL

Пароль сотрудников, не твой. Пустое поле — пароль не меняется. Пароль ADMIN к PANEL не подходит.

Сотрудники (Telegram-id, доступ к боту PANEL)

Гостевой доступ (QR стола)

Здесь настраивается то, что видит гость за столом, когда сканирует QR-наклейку. Это НЕ управляющий бот: админка живёт в @kindot_admin_bot (секция выше), а гостям показывается публичный бот @kindotbot. Если ничего не менял — значения по умолчанию уже рабочие, трогать не нужно.

1 · Бот гостей (username)

Имя гостевого бота без @. Сюда НЕЛЬЗЯ вставлять токен (длинную строку с двоеточием) — только короткое имя, например kindotbot.

2 · Имя мини-аппы

Короткое имя Mini App из BotFather. Вместе с ботом даёт ссылку гостя: t.me/kindotbot/kindot.

3 · Публичный веб-адрес — обычно ПУСТО

Оставь пустым: внутри заведения QR открывает stolN.local автоматически. Заполняется ТОЛЬКО если у тебя есть свой домен и столы выставлены в интернет, например https://stol{no}.kindot.kz — {no} заменится на номер стола. Токен бота сюда вставлять нельзя.

Как настроить гостевого бота с нуля (пошагово)

В Telegram открой @BotFather → команда /newbot → придумай имя и username (например kindotbot). Токен, который он выдаст, для этой секции НЕ нужен — токен живёт в прошивке стола.
Там же: /newapp → выбери своего бота → задай имя мини-аппы (например kindot), описание и картинку.
В поле «Web App URL» укажи адрес стола (внутри сети — http://stol1.local, из интернета — свой домен).
Впиши сюда username бота (шаг 1) и имя мини-аппы (шаг 2) → «Сохранить».
Готово: QR на столе поведёт гостя в t.me/<бот>/<аппа>?startapp=t<номер>.

Доступ из интернета

HTTPS-туннель Cloudflare: трафик зашифрован, вход — по паролю. Ссылка временная (trycloudflare) — работает, пока приложение запущено. Постоянный домен и связь со столами через интернет — этап Pi-Host.

Поднимать туннель при старте (24/7) После перезапуска админки туннель включится сам, новый адрес придёт в Telegram. Требует пароль на вход (не дефолтный).

Хаб

Перезапускает ОБА процесса — ADMIN (этот кабинет, порт 8000) и PANEL (зал/персонал, порт 8080) — разом, даже если нажали здесь, в ADMIN. Столы работают независимо от хаба и не пострадают — просто на несколько секунд пропадут из реестра, пока супервизор (24/7-цикл) поднимает оба процесса заново.

ИИ-рисование

Персонал пишет «нарисуй мандалу» — хаб превращает текст в G-код и отправляет на стол (кнопка «🎨 ИИ-рисунок» в карточке стола). Ключ хранится ТОЛЬКО здесь, в зашифрованном виде: ни в прошивке, ни в браузере его нет. Столы в интернет не выходят — рисунок приходит к ним по локальной сети.

Подходит любой из двух ключей — провайдер определяется сам: sk-ant-… — Anthropic (console.anthropic.com, подписка Claude Pro/Max не годится), sk-or-… — OpenRouter (openrouter.ai/keys).

Эта модель отвечает за рисунок на песке. По умолчанию anthropic/claude-haiku-4.5 — единственная из проверенных, кто прошёл оба тестовых рисунка (≈$0.016 за рисунок). Дешёвые модели заворачивают спираль за борт поля. Для беседы с гостем ставьте модель попроще — поле «Модель диалога» ниже (беседа на ling-2.6-flash ≈ $0.0002 против $0.019 на Haiku). Модели с суффиксом :free бесплатны, но работают только после галки на openrouter.ai/settings/privacy — а это разрешение провайдерам обучаться на ваших промптах, то есть на переписке гостей.

Модель:

ИИ-помощник гостя

Гость пишет живым текстом — в гостевого бота или в пузырь на странице стола — и помощник отвечает: советует по меню, собирает заказ, зовёт официанта, рисует узор на песке. Заказ уходит на кухню только после кнопки «Подтверждаю» у гостя; цены всегда берутся из меню, а не из слов ИИ. Работает на том же ключе, что и ИИ-рисование.

Включить помощника гостя Разрешить собирать заказ Разрешить гостю просить рисунок

Лимиты: запросов/сутки сообщ./час на стол рисунков/час

Бесплатный тариф OpenRouter: 20 запросов в минуту и 50 в сутки, а после разового пополнения на $10 — 1000 в сутки. Одна беседа с гостем — это 3–10 запросов. Когда лимит выбран, помощник не ломается: он отвечает кнопками «Меню» и «Позвать официанта».

Модель диалога:

Болтовня идёт постоянно, рисунок — редко. Поставьте сюда дешёвую модель (например inclusionai/ling-2.6-flash): сто бесед в день обойдутся в 2 цента вместо $1.9 на модели для рисования. Главное — чтобы она поддерживала инструменты, иначе помощник не покажет меню и не соберёт заказ.

Обновления столов (план)

OTA-доставка прошивок на столы — через Telegram-бот или Pi-Host (подписанные и шифрованные релизы, см. tools/sign). Канал выбирается на следующем этапе — скажи, каким мессенджером/каналом пользуешься, и заложим его.