Local Air Raid Alert Notification System

The primary problem this project addresses is the elimination of "information noise." While standard applications often blast notifications for the entire region, these bots filter the incoming data stream to react exclusively to threats targeting specific territorial communities (Kamianske and Dnipro).

Key Features

• Localized Notifications: Precision filtering of API data based on Location IDs. Users receive "Alert" and "All Clear" notifications only for their specific city.

• Instant Delivery (Zero-delay): Leveraging a serverless architecture allows the bots to process requests and broadcast notifications to thousands of users in fractions of a second.

• High Fault Tolerance: The bots operate independently of local servers or standard hosting providers, eliminating downtime during power outages or blackouts. Cloudflare's edge network ensures 99.9% uptime.

• Optimized Storage: State management (tracking the active alert status) and user ID persistence are handled via a distributed database to minimize latency during mass broadcasts.

Technical Stack

• Language: JavaScript (Node.js)

• Infrastructure: Cloudflare Workers (Serverless)

• Database: Cloudflare KV / D1

• APIs: Telegram Bot API, Official Ukrainian Alert Aggregators (REST API)

Architecture & Integration

The core logic relies on a scheduler/webhook mechanism that continuously monitors state APIs for security status updates in the designated regions. Upon detecting a trigger, the Worker fetches the active subscriber list from the database and initiates an asynchronous broadcast via the Telegram API, effectively bypassing standard platform rate limits on messages per second.