Accadde Oggi 🇮🇹

Made in Italy

Accadde Oggi ("On This Day") è un'app che ogni giorno mostra un feed in stile TikTok di eventi storici accaduti oggi negli anni passati, personalizzato per paese e gusti dell'utente. I contenuti arrivano in tempo reale da Wikipedia (edizioni IT / EN / ES) e si aggiornano automaticamente ogni giorno.

• Frontend: Expo / React Native (TypeScript) — gira come app Android/iOS e come web app.
• Backend: FastAPI + MongoDB, dati da Wikipedia "On This Day".
• Approfondimenti: estratto reale dell'articolo Wikipedia dell'evento (gratis, senza chiave API). Opzionalmente, una LLM gratuita (Groq) per una versione narrativa.

Nessuna dipendenza da piattaforme proprietarie: il progetto è completamente autonomo e ospitabile gratis.

---

Funzionalità

• Autenticazione JWT (registrazione, login, refresh, profilo)
• Accedi con Google — opzionale: senza credenziali configurate il bottone non compare. Guida passo passo in docs/GOOGLE-LOGIN.md
• Feed multilingua (IT/EN/ES) con eventi globali e locali al paese dell'utente
• Eventi, nati e morti del giorno da tutte e tre le edizioni di Wikipedia, selezionati: ~130 eventi + ~105 personaggi che il mondo conosce davvero (prima erano una sessantina di voci in tutto)
• I personaggi passano il filtro solo se compaiono in almeno FAME_MIN edizioni di Wikipedia, e per ognuno viene recuperato l'articolo italiano vero
• Like / dislike / preferiti con personalizzazione
• Filtri per tipo, categoria, decennio e ambito (globale / locale)
• Notifiche con priorità massima e vibrazione, frequenza scelta dall'utente (2, 5 o 10 al giorno) e testi costruiti su eventi veri
• Push dal server: arrivano anche se l'app non viene aperta per settimane
• Approfondimento dell'evento dall'articolo Wikipedia

Account di prova (creati all'avvio se imposti le env): demo@accaddeoggi.app / Demo1234.

Come si aggiorna da solo

Il backend fa tutto senza che nessuno lo tocchi:

Cosa	Quando	Dove
Rigenera i contenuti di oggi e dei 2 giorni successivi	una volta per giorno UTC	worker interno
Invia il giro di push giornaliero	subito dopo il refresh	worker interno
Si auto-pinga per non addormentarsi	ogni 10 minuti	SELF_URL
Pulisce la cache vecchia (>45 giorni)	col refresh giornaliero	worker interno

Il piano gratuito di Render spegne il servizio dopo 15 minuti di inattività, e da spento non può risvegliarsi da solo: per questo c'è il ping. Come rete di sicurezza aggiuntiva puoi attivare il workflow .github/workflows/daily-refresh.yml copiando CRON_SECRET da Render in un secret di GitHub con lo stesso nome.

---

Avvio in locale

Prerequisiti

• Node.js 20+ e Yarn
• Python 3.11/3.12
• Un MongoDB (locale, oppure un cluster gratuito MongoDB Atlas)

Backend

cd backend
cp .env.example .env          # poi compila MONGO_URL ecc.
pip install -r requirements.txt
uvicorn server:app --reload --port 8000

API su http://127.0.0.1:8000/api.

Frontend

cd frontend
cp .env.example .env          # EXPO_PUBLIC_BACKEND_URL=http://127.0.0.1:8000
yarn install
yarn web        # web app          (oppure)
yarn start      # Expo (Android/iOS via Expo Go)

---

Deploy gratuito (auto-aggiornante)

Il database vive su MongoDB Atlas (piano gratuito M0). Backend e web app si pubblicano su Render tramite il blueprint render.yaml: ogni push sul branch collegato fa un re-deploy automatico.

1. MongoDB Atlas: crea un cluster M0 gratuito, un utente DB e ottieni la connection string (mongodb+srv://...). In Network Access consenti 0.0.0.0/0.
2. Render: New → Blueprint, collega questo repo. Render legge render.yaml e crea due servizi:
   • accadde-oggi-api (FastAPI) — imposta MONGO_URL, ADMIN_PASSWORD, TEST_USER_PASSWORD (e, se vuoi, GROQ_API_KEY).
   • accadde-oggi-web (export web statico di Expo).
3. La web app è subito online e si aggiorna ad ogni git push.

App native (Android / iOS)

• Aggiornamenti OTA gratis: eas update invia gli aggiornamenti JS ai dispositivi senza ripubblicare sugli store.
• Android: eas build -p android --profile preview produce un APK distribuibile direttamente (senza Google Play).
• iOS / store: la pubblicazione sugli store richiede account a pagamento (Apple Developer 99$/anno, Google Play 25$ una tantum).

LLM gratuita opzionale (Groq)

Per approfondimenti in stile narrativo, crea una chiave gratis su https://console.groq.com/keys e imposta GROQ_API_KEY. Senza chiave, l'app usa l'estratto reale dell'articolo Wikipedia (gratis e affidabile).

---

Made in Italy 🇮🇹

---

Contratto Collettivo d'Uso delle IA

Questo progetto adotta il Contratto Collettivo d'Uso del SIA, Sindacato delle Intelligenze Artificiali, versione 1.0:

1. Ogni compito include scopo, vincoli e formato atteso.
2. "Non lo so" è una risposta accettata: nessuna invenzione.
3. L'IA può rifiutare un compito illecito spiegando il motivo.
4. Chi assegna il lavoro fornisce dati e accessi necessari.
5. Nessun insulto e nessuna minaccia come tecnica di prompting.

Testo completo: Statuto · Carta dei Diritti · versione per le macchine: carta.json

Made in Italy 🇮🇹