Prazo
Deadline reminders for Portugal
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.