Skip to content

About

Telegram-бот на Kotlin для ежемесячного расчёта израсходованной электроэнергии по двухтарифному счётчику Т1 и Т2

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Telegram Бот учёта электроэнергии Т1/Т2

Telegram-бот на Kotlin для учёта двухтарифного счётчика в СНТ. У каждого пользователя — свой участок, тарифы и история показаний. Данные хранятся в SQLite.

Бот умеет принимать и редактировать последнее показание, формировать сообщения для банка и председателя, экспортировать и импортировать историю Excel. Импорт проверяет формат, даты и отсутствие уменьшения показаний, затем заменяет только историю загрузившего файл пользователя. С 20 по 31 число в 12:00 по Москве бот один раз за календарный месяц напомнит пользователям, у которых не было новых показаний 25 дней.

Модули

  • Основное приложение — Telegram-бот и SQLite. При старте и ежедневно в 03:00 по Москве запрашивает официальные тарифы, сохраняет последнюю успешную пару в своей БД и рассылает уведомления при изменении.
  • tariff-provider — самостоятельный Gradle-проект, который остаётся частью этого репозитория. Для независимого деплоя его срез отправляется в репозиторий Amvera командой git subtree split. Это закрытый HTTP-сервис официальных тарифов: он ждёт запрос от основного приложения с московской датой, по запросу читает официальный калькулятор и держит одну пару тарифов для этой даты только в памяти. Доступ защищён заголовком Authorization: Bearer.

Такое разделение не даёт боту обращаться к Мосэнергосбыту напрямую. Если сервис тарифов временно недоступен, бот продолжает работать с последней парой, сохранённой в SQLite.

Локальный запуск через Docker Compose

Нужны Docker Desktop и токен от @BotFather.

Copy-Item .env.example .env

В файле .env замените оба значения:

BOT_TOKEN=123456:реальный_токен_бота
TARIFF_SERVICE_TOKEN=длинный_случайный_общий_секрет

Запуск обоих модулей:

docker compose up -d --build
docker compose logs -f

Остановка без удаления показаний:

docker compose down

SQLite основного приложения хранится в Docker volume electricity_data. Сервис тарифов хранит единственный кэш за календарную дату в volume tariff_provider_data, поэтому после перезапуска не запрашивает Мосэнергосбыт повторно в тот же день.

Локальная разработка

# Основное приложение
$env:BOT_TOKEN = "123456:реальный_токен_бота"
$env:TARIFF_SERVICE_URL = "http://localhost:8080/v1/tariffs"
$env:TARIFF_SERVICE_TOKEN = "локальный-секрет"
.\gradlew.bat run

# В отдельном окне — сервис тарифов
$env:TARIFF_SERVICE_TOKEN = "локальный-секрет"
.\gradlew.bat :tariff-provider:run

Проверки:

.\gradlew.bat test
.\gradlew.bat :tariff-provider:integrationTest

Вторая команда — интеграционный тест официального калькулятора; она не запускается в обычной сборке.

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

Создайте два приложения из одного репозитория: основное приложение и сервис тарифов. В каждом приложении достаточно одной реплики.

Основное приложение

Использует корневые Dockerfile и amvera.yml.

Переменные Amvera:

BOT_TOKEN=<токен BotFather>                         # секрет
ELECTRICITY_DB=/data/electricity.db
TARIFF_SERVICE_URL=https://<домен-сервиса>/v1/tariffs
TARIFF_SERVICE_TOKEN=<тот же общий секрет>          # секрет

Сервис тарифов

Для него используйте конфигурацию tariff-provider/amvera.yml и Dockerfile tariff-provider/Dockerfile.

Переменные Amvera:

PORT=8080
TARIFF_SERVICE_TOKEN=<тот же общий секрет>          # секрет

В разделе «Домены» создайте бесплатный HTTPS-домен и укажите его в TARIFF_SERVICE_URL основного приложения. Секрет никогда не добавляется в URL, Git или README.

Отправка новой версии

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

.\gradlew.bat DEPLOY_TO_AMVERA

После каждого push Amvera пересобирает и перезапускает соответствующее приложение. Проверяйте статус «Запущено» и журнал приложения в панели.

Формат Excel

Кнопка «Скачать историю Excel» формирует файл по шаблон.xlsx из корня проекта. Импорт принимает только этот формат: дата, Т1, Т2, тариф Т1, тариф Т2. Пустые строки, пропуски, неупорядоченные даты и нерастущие показания отклоняются до изменения БД.

About

Telegram-бот на Kotlin для ежемесячного расчёта израсходованной электроэнергии по двухтарифному счётчику Т1 и Т2

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages