Mudra sova
Kratak informativni ili zabavni sadržaj koji lokacija može uključiti.
Mudra sova svakog dana prikazuje jednu kratku, provjerenu priču koja korisniku otvara novi pogled na ljude i odnose, ljudsko ponašanje, povijest ili popularnu znanost. Sadržaj nije poslovica, profesionalni savjet ni nasumična trivija.
Korisničko iskustvo
Dnevna kartica sadrži:
- kategoriju i procijenjeno vrijeme čitanja
- naslov i kratki uvod
- objašnjenje ideje u obliku mikropriče
- istaknutu promjenu perspektive
- otvoreno pitanje za razmišljanje
- jednu ili dvije poveznice na provjerene izvore
Klasični početni prikaz prikazuje naslov današnje priče. Portal prikazuje naslov, uvod i otvara puni ekran lib/screens/wise_owl.dart.
Arhitektura
Flutter aplikacija poziva sigurnosna provjera aplikacije zaštićenu callable funkciju getDailyWiseOwl. aplikacija nema izravan pristup dokumentima i više ne čita sayings/sayings.json iz sigurna pohranaa.
Cloud Function ensureWiseOwlHorizon svakog dana u 03:45 po vremenskoj zoni Europe/Zagreb održava unaprijed pripremljen horizont od 14 dana. Generiranje:
- koristi postojeći Secret Manager secret OPENAI_API_KEY
- koristi OpenAI Responses API i web pretragu samo po dopuštenim domenama
- zahtijeva strogo strukturirani dvojezični HR/EN rezultat
- odbija nepoznate kategorije i izvore koji se nisu pojavili u stvarnom rezultatu web pretrage
- transakcijski odbija već objavljeni conceptId, uključujući paralelna generiranja istog koncepta
- sprema objavljeni sadržaj u wise_owl_cards/{YYYY-MM-DD}
- prati korištene koncepte u wise_owl_concepts/{conceptId} radi izbjegavanja ponavljanja
Ako današnji dokument nedostaje, callable sprema i vraća provjereni rezervni sadržaj. Zbog toga privremeni kvar OpenAI-ja ne ostavlja prazan ekran.
Produkcijsko puštanje
Prije puštanja potvrditi da u sustav Conexe Secret Manageru postoji OPENAI_API_KEY, a zatim objaviti sustav podataka pravila i funkcije:
``powershell sustav Conexe deploy --only sustav podataka:rules --project conexaproject-9660d sustav Conexe deploy --only functions:getDailyWiseOwl,functions:ensureWiseOwlHorizon,functions:adminGenerateWiseOwlCards --project conexaproject-9660d `
Za ručno generiranje odabranih datuma koristi se administratorska callable funkcija adminGenerateWiseOwlCards s najviše sedam datuma po pozivu.
Važne datoteke
- lib/models/daily_wisdom.dart
- lib/services/wise_owl_service.dart
- lib/screens/wise_owl.dart
- sustav podataka-setup/functions/wise_owl.js
- sustav podataka-setup/functions/wise_owl_logic.js
- sustav podataka-setup/functions/wise_owl_seed.js`