Telegram Mini App для запису в бʼюті-салон «Velvet Studio»
«Velvet Studio» - сервіс запису в салон краси, який живе повністю в Telegram. Клієнт відкриває Mini App, обирає послугу, майстра і вільний час, підтверджує запис і одразу отримує деталі візиту в чат. Запис лягає в Google Таблицю салону, а власник бачить розклад і статистику в тому самому боті. Ані дзвінків, ані окремого застосунку, ані паперового журналу.
Кому підходить: салонам краси, барбершопам, студіям манікюру, масажним і косметологічним кабінетам, а також будь-якому бізнесу, що працює за записом - від СТО до репетиторів. Особливо тим, хто досі приймає записи в директі й вручну звіряє, чи вільний майстер.
Стек: Python і aiogram для бота, FastAPI для бекенду Mini App, Google Sheets API замість бази даних, APScheduler для нагадувань.
- Python
- aiogram
- FastAPI
- Telegram Mini App
- Google Sheets API
- APScheduler
Як влаштована система
Система складається з трьох частин, які працюють з одними й тими самими даними: Mini App, у якому записується клієнт, Google Таблиця, де ці записи живуть, і Telegram-бот, через який салон їх бачить і рахує. Жодну з частин не треба відкривати окремо - усе всередині Telegram.
1. Mini App для клієнта
Запис відкривається прямо з чату бота і виглядає як застосунок салону, а не як переписка. Сценарій - пʼять кроків: послуга, майстер, дата і час, контактні дані, підтвердження. Ціна і тривалість видно з першого кроку, тож клієнт розуміє, у що обійдеться візит, ще до того, як його підтвердить.
Список майстрів фільтрується під обрану послугу - клієнт бачить лише тих, хто її виконує. Календар відкриває тільки робочі дні майстра, а сітка часу враховує тривалість послуги, індивідуальний графік і вже наявні записи, тому зайнятих годин у ній просто немає.
2. Google Таблиця як бекофіс
Окремої адмінки в системі немає, і це свідоме рішення. Бекофісом працює звичайна Google Таблиця з аркушів «Майстри», «Послуги», «Записи» і «Налаштування». Адміністратор редагує її так само, як редагував би будь-яку таблицю, - вчити новий інтерфейс не треба нікому.
Змінили ціну послуги, додали майстра або закрили день - Mini App і бот бачать це відразу. Кожен запис лягає окремим рядком, який можна відсортувати, відфільтрувати чи вивантажити, а історія лишається в акаунті салону, а не в чужій системі.
3. Telegram-бот для власника
Власник керує салоном з того самого бота. Команда запуску відкриває панель: записи на сьогодні і на завтра, вибір довільного дня, вільні слоти і статистика. Окрема кнопка примусово перечитує таблицю, якщо адміністратор щойно щось у ній змінив.
Статистика рахується за період - сьогодні, наступні сім днів, останні сім або тридцять. У зведенні: кількість записів у розрізі статусів, унікальні клієнти, зароблена й очікувана сума, топ послуг і топ майстрів. Цифри беруться з тих самих рядків таблиці, тому звіряти їх ні з чим не треба.
Ключова логіка
- → Захист від подвійного запису: слот перевіряється ще раз у момент підтвердження, тож двоє клієнтів не потраплять до одного майстра на одну годину, навіть якщо записуються одночасно
- → Статуси запису: очікує → підтверджено → завершено або скасовано. Статус змінюється в таблиці, і статистика перераховується за ним автоматично
- → Автоматичне нагадування за 24 години до візиту: шедулер сам знаходить завтрашні записи, надсилає клієнту повідомлення і ставить у таблиці позначку, щоб не надіслати його вдруге
Що вміє система
- → Запис у пʼять кроків прямо в Telegram - без сайту, окремого застосунку і дзвінків
- → Каталог послуг з ціною, тривалістю, описом і категорією, який редагується в таблиці
- → Картки майстрів: спеціалізація, рейтинг, графік по днях тижня, вихідні і власний перелік послуг
- → Фільтрація майстрів під обрану послугу - клієнт бачить лише тих, хто її виконує
- → Сітка вільного часу з урахуванням тривалості послуги, графіка майстра і вже наявних записів
- → Підтвердження клієнту в Telegram з номером запису, послугою, майстром, адресою і сумою
- → Панель власника: записи на сьогодні, на завтра і на будь-який обраний день, а також вільні слоти
- → Статистика за період: записи по статусах, унікальні клієнти, виручка, топ послуг і топ майстрів
- → Google Таблиця замість адмінки: дані салону лишаються в його власному акаунті