Calcolo frugale
Il codice gestisce il prevedibile, modelli piccoli l'ambiguità e alta precisione solo errori costosi.
Trasparenza ingegneristica
Stack tecnologico e architettura IA
Una vista pubblica e versionata di come Maison Apéro bilancia competenza sul vino, velocità, costo e privacy, distinguendo produzione e validazione.
Catalog2026-09-08
Stato di distribuzione
Questa pagina nasce da un solo catalogo. Solo i componenti validati in produzione sono attivi.
- Attivo
- Parzialmente attivo
- In validazione
- Pianificato
Stack IA
Il client non sceglie il fornitore: il server gestisce attività, modello, addebito e fallback.
| Livello | Tecnologia o modello | Uso | Stato |
|---|---|---|---|
| Client | Flutter 3.47 / Dart 3.13 |
Un’unica base UI per Android, iOS, Web e PWA. | Attivo |
| Autenticazione e protezione API | Firebase Auth / App Check |
Accetta utenti autenticati e istanze verificate. | Attivo |
| Orchestratore di valutazione | Cloud Functions / Node.js 22 |
Classifica valutazione e studio, sceglie modelli, controlla ticket, ritenta e valida. | Parzialmente attivo |
| Cache verificata | Verified Wine Library cache |
Restituisce un risultato Wine Library verificato senza una nuova richiesta al modello. | Attivo |
| Normalizzazione input | ministral-8b-2512Contesto 256k · output strutturati |
Normalizza l’identità da etichetta, carta o testo e verifica se è sufficiente. | In validazione |
| Validazione valutazioni | mistral-small-2603Contesto 256k · output strutturati · reasoning regolabile |
Valida i percorsi di bozza e metadati delle domande prima della produzione. | In validazione |
| Gemini leggero | gemini-3.5-flash-liteContesto input 1M · output strutturati · Thinking |
Traduzione ed elaborazione leggera: Gemini 3.5 Flash-Lite. L’identificazione del vino usa Gemini 3.8 Flash. | Attivo |
| Gemini ad alta precisione | gemini-3.8-flash / gemini-3.7-flashContesto input 1M · output strutturati · Thinking basso/medio/alto |
Recensioni e Grand: Gemini 3.8 Flash. Quiz e correzione scritta: Gemini 3.7 Flash. | Attivo |
| Dati | Firestore / Wine Library |
Fatti verificati, valutazioni e cache per lingua. | Attivo |
| Conoscenza riservata | Server-only reference layer |
Mantiene riferimenti e istruzioni di valutazione o domande sul server. | Parzialmente attivo |
| Segreti | Google Secret Manager |
Separa credenziali da codice e client. | Attivo |
| Osservabilità | Cloud Logging / aggregate metrics |
Misura modello, attività, latenza, token e successo senza registrare l’input. | Attivo |
Come viene elaborata una valutazione o domanda
Prima si consulta la Wine Library; i modelli si eseguono solo quando necessario e il risultato viene validato prima della visualizzazione.
Etichetta, estratto di carta o identità digitata
Auth + App Check
Contratto server di valutazione o studio
Corrispondenza Wine Library → cache verificata; costo secondo l’attività
Normalizzazione identità → validazione
Bozza di valutazione → Mistral Small 4 · solo validazione
Traduzione ed elaborazione leggera: Gemini 3.5 Flash-Lite. L’identificazione del vino usa Gemini 3.8 Flash.
Recensioni e Grand: Gemini 3.8 Flash. Quiz e correzione scritta: Gemini 3.7 Flash.
Struttura, fatti, lingua, piano e policy
Risultato indicativo o rimborso
Perché questa architettura
Quattro principi ingegneristici sostituiscono un approccio uniforme.
Generazione fondata
Si recuperano dati verificati e si separano fatti da raccomandazioni.
Errore sicuro
Una valutazione critica fallita non viene declassata: rimborso e nuovo tentativo.
Addebito idempotente
Un'attività ha una chiave; tentativi e fallback non duplicano il consumo.
Politica di ragionamento
L'intensità dipende dal rischio; prompt, soglie esatte e tracce restano sul server.
| Attività | Modello | Intensità |
|---|---|---|
| Generazione di domande a scelta multipla | Gemini 3.7 Flash |
Bassa |
| Correzione delle risposte scritte | Gemini 3.7 Flash |
Media |
| Traduzione ed estrazione | Gemini 3.5 Flash-Lite |
Minima |
| Recensione di degustazione strutturata | Gemini 3.8 Flash |
Media |
| Giudizio su differenze rilevanti | Gemini 3.8 Flash |
Alta |
Integrità dei ticket
I ticket seguono lo scopo dell'attività, non il fornitore interno.
- Riaprire recensioni salvate usa 0 ticket. Una nuova recensione segue il costo del server, anche se esiste una cache.
- Senza un risultato utilizzabile, i ticket riservati per la richiesta vengono restituiti.
- Ogni nuova recensione mostra il costo in ticket confermato dal server prima di iniziare. Riaprire le recensioni salvate è gratuito.
- Le sessioni di studio mostrano il prezzo fisso prima dell’avvio.
- Fallback e nuovo tentativo non consumano altro.
- Senza risultato utile c’è rimborso automatico.
- Riprendere un’attività pagata non addebita ancora.
Fallback senza perdita silenziosa
- Recensioni e Grand: Gemini 3.8 Flash. Quiz e correzione scritta: Gemini 3.7 Flash.
- La traduzione usa Gemini 3.5 Flash-Lite con tentativi limitati e Gemini 3.8 Flash se la verifica fallisce.
- Un errore Gemini 3.8 Flash non passa a un valutatore inferiore.
- Un’attività comporta al massimo un addebito.
Confine della privacy
- Il catalogo è pubblico, ma il client non controlla il modello.
- Prompt, riferimenti privati, soglie e protezioni restano sul server.
- Le tracce di ragionamento non vengono mostrate né salvate.
- Le chiavi restano in Secret Manager.
- Grand resta sul percorso Gemini approvato durante la validazione Mistral.
- L'approvazione Mistral richiede API regionale UE stateless, esclusione dal training ed eleggibilità ZDR verificata; non risulta attiva prima del controllo operativo.
- I log contengono metadati, mai prompt, messaggi, email o immagini.
Versioned by design
Architettura viva
Catalogo, otto lingue, dati strutturati, sitemap e riepilogo IA vengono generati e validati insieme.
Riferimenti tecnici primari
Domande sull'architettura
Il client sceglie il modello?
No. Il server autenticato applica una policy versionata.
Il fallback consuma un altro ticket?
No. Condivide la stessa richiesta idempotente.
Mistral elabora già valutazioni in produzione?
No; resta in validazione multilingue del dominio del vino.
Le istruzioni di valutazione sono pubbliche?
No. L’architettura è pubblica; istruzioni, riferimenti, soglie e tracce restano riservati.