🚗 Жилець — у три кроки

1. Підтвердьте, що ви мешканець. Перший раз заповніть заявку (комплекс, будинок, квартира, авто). Управління підтвердить вашу адресу — після цього зʼявиться кнопка відчинення.
2. Біля шлагбауму натисніть «ВІДЧИНИТИ». Охорона миттєво отримує ваш запит з номером авто й квартирою. На екрані видно статус: надіслано → охорона отримала → відчинено ✓. Дзвонити не треба.
3. Готово. Шлагбаум піднімається. Якщо охорона довго не відповідає — натисніть «ВІДЧИНИТИ» ще раз або зателефонуйте на пост.

📲 Ваша постійна QR-перепустка

У вас є особистий QR-код. Покажіть його на пості — охорона сканує камерою й одразу впускає, навіть якщо ви без телефону за кермом (показав пасажир). Код можна перевипустити, якщо телефон загубився.

📢 Оголошення

Угорі — стрічка оголошень від управління (прибирання, відключення води, збори). Нові приходять у реальному часі.

👋 Запросити гостя, таксі чи доставку

1. У розділі «Гостьова перепустка» вкажіть, хто їде (Гість / Таксі / Нова Пошта), за потреби — нотатку та термін дії.
2. Натисніть «Створити перепустку» — отримаєте посилання, короткий код і QR.
3. Надішліть посилання гостю (кнопка «Поділитися»). Гість відкриває його, біля шлагбауму тисне «Я біля шлагбауму» — охорона бачить, до кого і від кого.

Перепустка одноразова й згоряє лише після успішного вʼїзду (якщо охорона помилково відмовила — гість може спробувати ще раз). Будь-яку перепустку можна відкликати завчасно.

🛡️ Пульт охорони

1. Запити на вʼїзд зʼявляються у реальному часі зі звуком — видно імʼя/квартиру, номер авто, і чи це жилець, чи гість (до кого і від кого).
2. Дві кнопки: «✅ Відчинити» або «⛔ Відмова». Жодних дзвінків і записів вручну.
3. QR гостя/жильця — піднесіть код до камери (або введіть короткий код): система миттєво показує, чий це пропуск і чинний він.

Угорі — лічильники за сьогодні (скільки очікують / скільки впущено). Оброблені запити лишаються в «Нещодавніх».

🏢 Управління (для ЖЕКу/забудовника)

• Заявки та мешканці. Підтверджуйте нові заявки (✓ / ✕), за потреби — блокуйте доступ. Можна додати мешканця вручну.
• Мультидомовість. Угорі перемикач комплексів — кожен ЖК Мартинова окремо (мешканці, запити, журнал не змішуються).
• Аналітика. Вʼїзди за день, скільки впущено, гостей, середній час реакції охорони, графік по годинах.
• 📢 Оголошення. Напишіть заголовок і текст — оголошення зʼявиться у застосунку всіх мешканців комплексу (і прийде в Telegram). Зайве — видаліть.
• 📒 Журнал подій. Хто кого впустив, які перепустки видані — повна історія.

⚙️ Запуск і підключення (для власника)

1. Telegram-бот. Створіть бота у @BotFather, отримайте токен → запустіть із TG_TOKEN. У @BotFather задайте Menu Button URL на адресу застосунку.
2. Прив'яжіть чати персоналу. З робочого чату охорони надішліть боту /bind_security klubnyi, з чату управління — /bind_admin klubnyi. Відтепер запити й заявки йдуть саме туди.
3. PIN персоналу. Змініть стандартні STAFF_PIN / ADMIN_PIN на власні.
4. Шлагбаум. Зараз бот сповіщає охорону, відчиняє людина (без втручання в електрику). Коли захочете авто-відчинення — підключається GSM-реле / IP-реле (Shelly) / СКУД зміною однієї настройки, без переписування. Потрібен огляд приводу на місці + згода УК.