Mike Kostenko

Systems I run

Prazo

Deadline reminders for Portugal

Telegram bot, 2026 to present. Open in Telegram

Overview

Prazo reminds people living in Portugal of official deadlines: car tax (IUC), car inspection (IPO), property tax (IMI), IRS and e‑fatura validation. A short onboarding captures what applies to each person, then reminders arrive 14 days before, 3 days before and on the day — in English, each with a link to the official source.

Tech stack

Java 21, Spring Boot, PostgreSQL with Flyway migrations, Telegram Bot API (long polling). Self-hosted on a Raspberry Pi as a systemd service with nightly PostgreSQL backups.

Architecture

A rule-based deadline engine keeps the law out of the code: each year's obligations live in self-contained YAML files, so changing a deadline means editing data, not Java. Occurrences are generated per user from their profile, and reminders are queued in PostgreSQL and sent with retry and backoff. The bot runs by long polling, so the Pi needs no inbound ports; nightly pg_dump backups are copied off the device.