v1.0.0

Firefly v1.0.0

First stable release of Firefly: a Spring Boot Telegram bot for DTEK outage schedules (Kyiv + Kyiv region), with SQLite persistence and automated schedule refresh.

Highlights

• Telegram bot with /start flow and inline menu.
• Manual outage group selection for:
  • Kyiv (🏙️ Київ)
  • Kyiv region (🏘️ Київщина)
• Auto-detect group by Kyiv address via YASNO (📍 Знайти групу за адресою (Київ)).
• Per-user notification toggle and persisted user settings.
• Admin stats commands:
  • /stats_today
  • /stats_week
• Scheduled schedule refresh + midnight rollover logic (Europe/Kyiv).

Tech Stack

• Java 25
• Spring Boot 4.0.1
• SQLite + Spring Data JPA + Flyway
• Telegram Bots API (long polling)
• Playwright + Jsoup

Breaking Changes

• None (initial stable release).

Install / Run (JAR)

Prerequisite: Java 25

export TELEGRAM_BOT_TOKEN=your_token_here
java -jar firefly-1.0.0.jar

Optional env vars:

• TELEGRAM_ADMIN_CHAT_IDS
• SPRING_DATASOURCE_URL (default: jdbc:sqlite:src/main/resources/db/app.db)
• scheduler.shutdowns.fixed-delay-ms (interpreted as minutes)
• scheduler.shutdowns.time-zone (default: Europe/Kyiv)

Database Notes

• Flyway migrations are enabled.
• spring.jpa.hibernate.ddl-auto=none.

Checksums

SHA-256:

• firefly-1.0.0.jar: 99fdb3b2ef1e34f7231e696416df7f801de9ed2f5a91b652de9c2b0b30c95e0d

Verification:

shasum -a 256 firefly-1.0.0.jar

Docker

Also available as container image:

• ghcr.io/ndmik-dev/firefly:latest

---

Full Changelog: Initial stable release (v1.0.0).