v1.0 · Open Source

Пересменки без бумаг

API и Telegram-бот для автоматизации отчётов менеджеров ресторана. Быстро, надёжно, открыто.

terminal

# Установка и запуск

❯ git clone github.com/tembz/bk_reports_backend

❯ poetry install

Resolving dependencies... done

❯ poetry run alembic upgrade head

INFO Running upgrade → 500ab93... done

❯ pm2 start

✓ API запущен на :8000 · Bot активен

❯

Возможности

Всё что нужно
для пересменки

Система покрывает весь цикл работы менеджера — от заполнения отчёта до учёта долгов между ресторанами.

📋

Отчёты по смене

Дневные и ночные отчёты с показателями: товарооборот, ITPH, ГО, SOS, количество чеков.

💸

Учёт долгов

Фиксация займов между ресторанами с датой возврата, статусом и историей изменений.

🔐

Авторизация

Три способа: Bearer токен, Telegram Init Data для Mini Apps, и HMAC SecretKey для бота.

🤖

Telegram-бот

Пошаговое заполнение отчёта прямо в чате, отправка фото, уведомления в группу.

⚡

Rate Limiting

Защита от злоупотреблений — ограничение запросов по IP с отдельными лимитами для auth.

🗄️

Миграции Alembic

Версионированная схема БД. Обновление и откат без потери данных одной командой.