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
Версионированная схема БД. Обновление и откат без потери данных одной командой.

Стек

Python 3.13
FastAPI
aiogram 3
SQLAlchemy (async)
PostgreSQL
Alembic
Poetry
PM2
aiohttp
Pydantic v2

Готов к использованию

Открытый исходный код. Бери, разворачивай у себя, адаптируй под свой ресторан.