ZarplataBot — Telegram-бот для учёта смен, бара и отчётов

🔍 О проекте

ZarplataBot — это Telegram-бот, созданный для автоматизации финансового учёта в небольших командах, таких как баристы, сотрудники смен, обслуживающий персонал и администраторы. Он заменяет ручной ввод в таблицы и помогает отслеживать:

• 💼 Рабочие смены (дневные и ночные)
• 🍷 Доходы с бара с динамичным процентом
• 💸 Расходы с комментарием
• 🚫 Штрафы и удержания
• 📊 Месячные отчёты с фильтрацией

Проект разрабатывался как личное решение для внутренней автоматизации, но может масштабироваться под любую команду.

💡 Зачем я это сделал?

Работая в коллективе, где часто ведётся учёт “вручную”, я заметил, что:

• Записи о сменах забываются
• Расходы теряются
• Доходы считаются “на глаз”
• Отчёты приходится собирать по частям

Чтобы убрать рутину и ошибки, я решил автоматизировать процесс через Telegram, которым все уже пользуются каждый день.

🔧 Функционал

• 🕑 Добавление смен: дневная или ночная (по фиксированной ставке)
• 🍷 Учёт бара: процент дохода зависит от суммы (динамически)
  • до 3500 — 5%
  • от 3500 до 4000 — 6%
  • от 4000 до 4500 — 7%
  • …
  • от 10 000 — 15%
• 💸 Ввод расходов и комментариев (например: “300 еда”)
• 🚫 Штрафы с пояснением (“500 опоздание”)
• 📊 Отчёты по месяцам — за текущий, предыдущий и выбранные вручную
• 🗃 Хранение всех данных в Airtable — удобно редактировать вручную
• ⏱ Мгновенная реакция — через Telegram-бот, без необходимости заходить в таблицы

🔌 Интеграции

• Telegram Bot API — для общения с пользователем
• Airtable API — как база данных, которую можно редактировать и вручную
• SQLite — локальное хранилище на случай оффлайна
• Railway — деплой и круглосуточная работа бота
• GitHub — для хранения и обновлений проекта

🚀 Развёртывание

Бот развёрнут на платформе Railway, что позволяет ему работать 24/7 без зависимостей от локального компьютера. Обновление кода происходит через git push на GitHub, а Railway автоматически пересобирает контейнер и перезапускает бота.

🖼 Интерфейс

Пользователь взаимодействует с ботом через кнопки:

• ▶️ Старт
• 🕑 Дневная / 🌙 Ночная
• 🍷 Бар
• 💸 Расход
• 🚫 Штраф
• 📊 Отчёт

Каждое действие сопровождается подтверждением и интерактивными сообщениями. Интерфейс адаптирован под Telegram UX.

🛠 Использованные технологии

📦 Репозиторий проекта

Код доступен на GitHub:

👉 github.com/adjabkhanian/zarplata-bot

📈 Планы на будущее

• Авторизация по пользователям
• Интеграция с Google Sheets
• Отчёты в PDF
• Аналитика с графиками
• Панель администратора через веб-интерфейс

💬 Вывод

ZarplataBot — это не просто бот, а рабочий инструмент для учёта и прозрачности. Он убирает хаос и делает рутину приятной.

Если ты хочешь адаптировать этого бота под свою команду — напиши мне 😉