Lunario dei Frati Patchatori
The Patching Friars' Almanac — un calendario dei santi in cui ogni giorno è dedicato a una vulnerabilità famosa, nel giorno in cui è stata divulgata. Online su fratipatchatori.it.
Design e decisioni: docs/DESIGN.md.
Sviluppo
npm install
npm run import # aggiorna src/data/ da Vulnerability Garden, CISA KEV e cvelistV5
npm run dev
Dati e contenuti:
data/overrides.json: correzioni manuali (patroni, date, CVE, campi sbagliati della fonte, longevità, assurde, esclusioni).data/extra-vulns.json: voci aggiunte a mano (santi minori, Padri della Chiesa, Papi mancanti).data/events.json, data/demons.json, data/popes.json, data/logos.json: flagelli e miracoli, Bestiario, Papi, loghi CC0.src/data/saints/, src/data/events/, src/data/demons/, src/data/popes/: testi IT/EN.data/santini/<id>.json → node scripts/build-santini.mjs → src/data/santini/<id>.svg.
Le immagini di condivisione sono in cache in .cache/og (per hash del contenuto): la prima build impiega qualche minuto, le successive pochi secondi.
Come si scrivono i contenuti: docs/CONTENT.md.
API
API pubblica in sola lettura, gratuita e senza chiave. Riferimento interattivo (Swagger): fratipatchatori.it/api/ · specifica OpenAPI: public/api/openapi.yaml.
| Endpoint | Cosa restituisce |
|---|
GET https://fratipatchatori.it/api/v1/{lang}/days/{MM-DD}.json | Un giorno: patrono, altri santi del giorno, ricorrenze |
GET https://fratipatchatori.it/api/v1/{lang}/year.json | Tutti i 366 giorni (circa 800 KB) |
GET https://frati-push.fratipatchatori.workers.dev/api/v1/{lang}/today?tz=Europe/Rome | Il giorno di oggi nel fuso indicato (predefinito Europe/Rome) |
lang è it o en. I file dei giorni sono statici su GitHub Pages, con CORS aperto; today passa dal Worker in push/, perché un sito statico non sa che giorno è.
curl -s https://fratipatchatori.it/api/v1/it/days/10-24.json | jq '.patron | {title, cves, cvss, kev}'
{
"title": "San Citrix Bleed, che perdeva i token di sessione",
"cves": ["CVE-2023-4966"],
"cvss": 9.4,
"kev": true
}
Ogni giorno contiene patron (null nei giorni vacanti) con dati tecnici (cves, cvss, kev, ransomware, vendor, product, author, canonical) e testi parodistici (texts: patronato, agiografia, preghiera, festa, proverbio), più others, observances (flagelli e miracoli), il link alla pagina, l'immagine di condivisione e l'embed. Stesse licenze del sito: testi CC BY-NC-SA 4.0, dati CC BY-SA 4.0.
App e notifiche
Il sito è una PWA installabile (manifest per lingua, service worker in public/sw.js, che tiene offline i prossimi sette giorni). Le notifiche giornaliere passano da un Cloudflare Worker (push/): conserva le iscrizioni in KV e ogni ora manda un push vuoto a chi ha le 8 del mattino; il service worker scarica il santo del giorno e mostra la notifica.
cd push
npx wrangler login
npx wrangler kv namespace create SUBS # metti l'id in wrangler.toml
npx wrangler secret put VAPID_PRIVATE_JWK # chiave privata VAPID in formato JWK
npx wrangler deploy # poi metti l'URL del Worker in src/lib/push.ts
Licenze
Uso non commerciale. Codice: PolyForm Noncommercial 1.0.0. Testi parodistici e santini: CC BY-NC-SA 4.0. Dati delle vulnerabilità: CC BY-SA 4.0, perché derivati da Vulnerability Garden di Shellsharks. Dettagli in LICENSE.
Santini e testi parodistici sono generati con AI; i dati tecnici sono reali.
