MassageManagement architecture Diagram

Life of an appointment

The appointment is created in Google Calendar and Google notifies the webhook
When it ends, the bot asks for the massage type on Telegram
The reply creates the entry in the database and it shows up on the web

Security and alerts

Webhooks check a secret shared with Google and Telegram
The bot only answers the authorised chat
If calendar access fails, the bot sends an alert on Telegram

Persistence

Reminders are stored in SQLite and survive restarts
The Google watch expires every 7 days and a daily task renews it

Deployment

CI/CD: every push to main is deployed to the server automatically