Calcolo frugale
Il codice gestisce il prevedibile, modelli piccoli l'ambiguità e alta precisione solo errori costosi.
Torna a Maison Apéro
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.
AttivoParzialmente attivoIn validazionePianificato
Questa pagina nasce da un solo catalogo. Solo i componenti validati in produzione sono attivi.
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 | Server-owned 8-language templates | Restituisce un risultato Wine Library verificato senza una nuova richiesta al modello. | Parzialmente 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 | Percorso previsto per traduzione, estrazione etichetta e struttura leggera. | Pianificato |
| Gemini ad alta precisione | gemini-3.7-flashContesto input 1M · output strutturati · Thinking basso/medio/alto | Degustazione strutturata, generazione domande, correzione scritta, Grand e giudizio critico. | 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.
01Etichetta, estratto di carta o identità digitata
02Auth + App Check
03Contratto server di valutazione o studio
04Corrispondenza Wine Library → cache verificata · 0 ticket
05Normalizzazione identità → validazione
06Bozza di valutazione → Mistral Small 4 · solo validazione
07Traduzione o estrazione → Gemini 3.5 Flash-Lite
08Valutazione, domande o correzione → Gemini 3.7 Flash
09Struttura, fatti, lingua, piano e policy
10Risultato 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à |
|---|---|---|
| Normalizzazione identità | Ministral 3 8B | Minima |
| Validazione bozza | Mistral Small 4 | Bassa |
| Generazione domande | Mistral Small 4 | Media |
| Traduzione ed estrazione | Gemini 3.5 Flash-Lite | Minima |
| Degustazione e correzione scritta | Gemini 3.7 Flash | Media |
| Giudizio su differenze rilevanti | Gemini 3.7 Flash | Alta |
Integrità dei ticket
I ticket seguono lo scopo dell'attività, non il fornitore interno.
- Ricerca Wine Library e cache verificata: 0 ticket.
- Input non valido o insufficiente respinto prima del consumo.
- Le recensioni del vino usano 0 ticket.
- 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
- Valutazioni e domande in produzione restano sul percorso approvato Gemini 3.7 Flash.
- Traduzione ed estrazione previste useranno tentativi limitati Gemini 3.5 Flash-Lite dopo la validazione.
- Un errore Gemini 3.7 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.
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.