Prepare 1.0.0 release

Author: ndmik-dev

.github/release-notes/v1.0.0.md

@@ -0,0 +1,61 @@
+## 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
+
+```bash
+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:
+```bash
+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`).

CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [1.0.0] - 2026-03-13
+
+### Added
+- Initial stable Firefly release.
+- Telegram bot `/start` flow with inline menu and persisted user settings.
+- Manual outage group selection for Kyiv and Kyiv region.
+- YASNO-based address-to-group resolution for Kyiv addresses.
+- Per-user notification toggle.
+- Admin stats commands: `/stats_today`, `/stats_week`.
+- Scheduler refresh for outage schedules and midnight rollover handling.
+
+### Technical
+- Spring Boot 4.0.1, Java 25.
+- SQLite persistence with Spring Data JPA and Flyway migrations.
+- DTEK/YASNO integrations using Playwright + Jsoup.
+

Dockerfile

@@ -48,6 +48,6 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
   && rm -rf /var/lib/apt/lists/*
 
 COPY --from=builder /ms-playwright /ms-playwright
-COPY --from=builder /app/build/libs/firefly-0.0.1.jar /app/app.jar
+COPY --from=builder /app/build/libs/firefly-1.0.0.jar /app/app.jar
 
 ENTRYPOINT ["java","-jar","/app/app.jar"]

README.md

@@ -77,6 +77,12 @@ App listens on `8080`.
 ./gradlew build
 ```
 
+## Run Released JAR (`v1.0.0`)
+```bash
+export TELEGRAM_BOT_TOKEN=your_token_here
+java -jar build/libs/firefly-1.0.0.jar
+```
+
 ## YASNO Address Lookup Script
 Script: `scripts/yasno_group_by_address.sh`
 

build.gradle

@@ -5,7 +5,7 @@ plugins {
 }
 
 group = 'io.ndmik'
-version = '0.0.1'
+version = '1.0.0'
 description = 'firefly'
 
 java {