Calendario Raccolta Rifiuti → Alexa
Un sistema che trasforma i calendari PDF della raccolta differenziata in promemoria vocali su Alexa — "cosa butto domani?" e un avviso ogni sera prima della raccolta.
Invocazione: “Alexa, apri calendario rifiuti”
Il problema
Ricordarsi ogni sera quale bidone portare fuori è un classico. I calendari del gestore (SERIT) sono PDF: comodi da guardare, inutili da interrogare a voce. Volevo poter chiedere ad Alexa “cosa butto domani?” e, meglio ancora, ricevere un promemoria automatico la sera prima.
Architettura a tre strati
- Ingestione (offline) — scarica i PDF SERIT e li converte in JSON strutturato e validato. È l’unico strato legato al layout del PDF.
- Dati normalizzati — un file per
comune/zona/annopiù uncatalog.jsonindice. Aggiungere un comune significa aggiungere file, senza toccare la skill. - Skill Alexa (Node / AWS Lambda) — risponde a voce e programma i promemoria serali.
Il parser PDF (la parte più interessante)
I PDF SERIT hanno una particolarità insidiosa: i numeri dei giorni sono grafica vettoriale, non testo. Il parser ricostruisce quindi la data dalla sequenza dei giorni della settimana (che invece sono testo) più mese e anno, e la valida confrontandola con il giorno-settimana atteso. Se qualcosa non torna, il programma esce con un codice d’errore: è il segnale che il layout del PDF è cambiato e il parser va rivisto. Sui file di prova: zero incongruenze.
La skill Alexa
- On-demand: “cosa butto oggi/domani” e “quando si raccoglie la frazione”, con scelta della zona a voce.
- Promemoria serali alle 20:00 la sera prima di ogni raccolta, tramite la Reminders API, con la zona salvata in modo persistente (DynamoDB).
Il vincolo che ha ribaltato il progetto
La prima architettura creava i promemoria fuori sessione: una catena
EventBridge → Lambda → Messaging API doveva svegliare la skill ogni sera e programmare
l’avviso. Non funziona. Alexa vieta di creare promemoria fuori da una sessione con
l’utente e risponde NOT_IN_SESSION, anche quando la skill è invocata tramite il canale
di messaggistica. Un assunto sbagliato, smentito dai log.
La soluzione è un promemoria “a orizzonte”: quando apri la skill (o dici “attiva i promemoria”), la skill programma in un colpo solo tutte le raccolte delle successive ~6 settimane, ognuna come avviso vocale la sera prima. A ogni apertura fa un top-up e riempie le settimane mancanti. Il compromesso è dichiarato: è automatico per circa sei settimane, poi basta riaprire la skill per rinnovare l’orizzonte.
Da un comune a 52
Nata per il mio comune soltanto, l’ho estesa a 52 comuni e 79 calendari SERIT: il parser ora costruisce un intero catalogo invece di un singolo file, in modo incrementale — controlla se i PDF sono cambiati prima di riscaricarli, e se uno di loro non si riesce più a leggere tiene l’ultima versione buona invece di lasciare il comune senza dati. Il modello di interazione della skill (i nomi di comuni e zone che Alexa riconosce a voce) è generato automaticamente dal catalogo, non scritto a mano.
Aggiungere i comuni cambia anche una piccola regola pratica: non tutti espongono i bidoni la sera prima. Alcuni indicano il giorno stesso, di mattina o di pomeriggio — quindi l’orario del promemoria non è più fisso alle 20:00, ma calcolato in base a come e quando quel comune specifico richiede l’esposizione.
La stessa architettura di un’altra mia skill
Per tenere il catalogo aggiornato senza un server sempre acceso, ho riusato l’impostazione della mia skill Almanacco del Giorno: un Worker Cloudflare programmato controlla se l’indice SERIT è cambiato (bastano poche richieste, il piano gratuito ne basta e avanza) e, solo in quel caso, avvia una GitHub Action che ricostruisce davvero il catalogo e lo pubblica. La skill legge i dati dal Worker, con una copia locale di riserva se qualcosa non risponde. Un piccolo allarme su Telegram avvisa quando l’elenco dei calendari cambia.
Stato
Tutte le fasi core sono completate, promemoria verificati end-to-end (compaiono davvero nell’app Alexa) e la skill multi-comune è distribuita. Il primo aggiornamento automatico reale del catalogo è andato a buon fine: il Worker ha girato a orario, l’avviso su Telegram è arrivato e il controllo di stato ha riportato data dell’ultimo controllo e impronta dell’indice. Il ciclo Worker → GitHub Action → archivio → skill è chiuso.
Ora la skill è anche pubblicata sullo Store di Alexa, con descrizione multi-comune e con la privacy policy e i termini d’uso di questa sezione. Il progetto è concluso: da qui in avanti resta la manutenzione, per esempio adattare il parser se SERIT cambiasse il formato dei PDF.
Stack
Python (parser) · Node.js / Alexa ASK SDK · AWS Lambda · DynamoDB · Alexa Reminders API · Cloudflare Workers · GitHub Actions