CarbCam scatta la tua foto, la invia a un servizio AI, riceve una stima dei componenti, convalida i valori rispetto a database nutrizionali standard e ti mostra il risultato.

Ogni analisi attraversa fino a sei passaggi:

Flusso visualizzato: seguito dagli screenshot reali per confronto:

1. Scheda Scansione

2. Analisi AI

3. Risultato

1 Scatto della foto e ritaglio locale dell'immagine

La foto rimane inizialmente interamente sul tuo dispositivo. Puoi ritagliarla, ruotarla o rifarla. Nulla viene caricato finché non tocchi “Analizza”.

2 Interrogazione della cache del server (Precheck)

Prima ancora che l'immagine venga inviata all'AI, l'app verifica tramite hash SHA-512 e perceptual hash se una foto identica o molto simile esiste già nella cache del server. In caso di corrispondenza, ricevi immediatamente il risultato salvato: senza un'altra chiamata all'AI. Un successivo passaggio di Conferma contrassegna la voce della cache come consumata (conteggio quota).

3 Caricamento per l'analisi AI

Se non c'è corrispondenza nella cache, la foto (ritagliata) viene inviata al nostro endpoint di analisi. Lì viene chiamato un modello di visione (Gemini, Claude o OpenAI, a seconda della tua scelta nelle impostazioni dell'app) per descrivere l'immagine, nominare i singoli componenti e stimare quantità approssimative.

4 Convalida in background (solo con confidenza bassa)

Se la stima dell'AI riporta una confidenza bassa, il server avvia un controllo incrociato in background con i database nutrizionali (USDA FoodData Central, Open Food Facts). I valori corretti confluiscono nella cache: la prossima volta che viene trovata corrispondenza con la stessa foto o una simile, vedi il risultato migliorato. Per le scansioni con confidenza alta questo passaggio viene saltato.

Per i codici a barre, invece, il confronto con Open Food Facts / USDA viene sempre eseguito direttamente, poiché la tabella nutrizionale del produttore è qui la fonte primaria.

5 Modifica da parte tua

Puoi sovrascrivere qualsiasi valore: quantità, carboidrati, kcal, FPE, componente. Al salvataggio vengono utilizzati i tuoi valori, non la stima dell'AI. L'app salva la tua correzione totale dei carboidrati (Utente: Xg vs AI: Yg) come differenza a scopo statistico.

6 Salvataggio e sincronizzazione Nightscout

Localmente in un database SQLite. Facoltativamente anche tramite sincronizzazione Nightscout con la tua istanza Nightscout: ma solo come nota nella tabella dei trattamenti (con il tag CarbCam), non come trattamento attivo di carboidrati/insulina. I tuoi calcoli Loop/AAPS/iAPS non sono influenzati dai salvataggi di CarbCam: il pasto è visibile solo come nota. Se usi Nightscout gestito da ns.10be.de, la configurazione è particolarmente semplice: inserisci l'URL Nightscout e l'API secret, fatto.

Se vuoi i carboidrati attivamente come trattamento, usa il pulsante Condividi nel risultato della scansione: invia il valore dei carboidrati tramite deep link ad AAPS/AndroidAPS, Loop, iAPS o Trio oppure apre il foglio di condivisione di sistema.

FPE sta per Fat-Protein Units (unità grasso-proteine). Descrivono quanta energia proveniente da grassi e proteine influisce sulla glicemia con un ritardo.

Un FPE equivale approssimativamente a 100 kcal da grassi e proteine. Esempio:

• 30 g grassi + 20 g proteine = (270 + 80) ÷ 100 = 3,5 FPE

Gli utenti di microinfusore spesso usano l'FPE per impostare i parametri del bolo esteso (ad es. onda quadra o onda doppia). Gli utenti di penna possono usare l'FPE come indicatore approssimativo per uno spuntino di correzione ritardato o una piccola correzione pomeridiana.

CarbCam mostra l'FPE come chip giallo nella scheda del risultato. I colori dei valori nutrizionali:

• Carbs Carboidrati
• kcal Calorie
• FPE Unità grasso-proteine
• Fat Grassi
• Protein Proteine

Quando Nightscout è configurato, CarbCam carica i dati glicemici dalla tua istanza Nightscout e mostra la curva glicemica nella scheda cronologia sotto ogni pasto. La finestra temporale dipende dalla piattaforma e viene scelta automaticamente intorno al pasto. Insieme a Nightscout, CarbCam consente un monitoraggio glicemico mirato dopo il pasto.

Caratteristiche della curva glicemica (dati Nightscout):

• Finestra temporale intorno al pasto (dipendente dalla piattaforma)
• Indicatore per l'ora del pasto
• Picco evidenziato a colori (rosso/giallo/verde a seconda del livello)
• Aumento e valore finale come metriche chiave
• IOB / COB come linee di sovrapposizione facoltative

La precisione dipende dal tipo di pasto:

Cosa migliora la precisione:

• Buona illuminazione e foto nitida: nessuna ombra sul piatto
• Tutti i componenti visibili: non affogare la pasta nel sugo
• Riferimento di dimensione: tieni il bordo del piatto, le posate o la mano nell'inquadratura
• Piatti standard: l'AI è brava con piatti ben conosciuti

Cosa riduce la precisione:

• Piatti da buffet con molti piccoli mucchietti
• Componenti fortemente ricoperti di sugo
• Piatti regionali molto insoliti senza un database di riferimento chiaro
• Fotografati di lato con angolazione senza riferimento di dimensione

Cosa significa questo per il tuo bolo:

• Per pasti normali: usa la stima come punto di partenza, applica la tua conoscenza personale e correggi il valore prima di salvare se necessario
• Per decisioni di bolo critiche (carboidrati molto alti, rischio di ipoglicemia): consulta sempre la tua conoscenza / il database / la confezione
• Con un microinfusore: acquisisci esperienza su quanto i tuoi pasti tipicamente si discostano, poi correggi la stima con il tuo fattore personale

Senza connessione internet funzionano le seguenti funzionalità:

• Sfoglia e filtra la cronologia
• Crea e modifica voci manualmente
• Visualizza la scheda statistiche
• Esporta dati (CSV/JSON)
• Scatta foto e mettile in coda per analisi successiva

Le seguenti funzioni richiedono una connessione:

• Analisi AI (la foto viene inviata al provider)
• Ricerca automatica codice a barre (Open Food Facts)
• Sincronizzazione Nightscout (curva glicemica, caricamento trattamenti)