O CarbCam recebe sua foto, envia para um serviço de IA, recebe uma estimativa dos componentes, valida os valores em bancos de dados nutricionais padrão e mostra o resultado.

Cada análise passa por até seis etapas:

Fluxo visualizado: seguido pelas capturas de tela reais para comparação:

1. Aba de escaneamento

2. Análise de IA

3. Resultado

1 Captura da foto e recorte local da imagem

A foto inicialmente permanece totalmente no seu dispositivo. Você pode recortá-la, girá-la ou tirá-la novamente. Nada é enviado até você tocar em “Analisar”.

2 Consulta ao cache do servidor (pré-checagem)

Antes que a imagem seja enviada à IA, o aplicativo verifica via hash SHA-512 e hash perceptual se já existe uma foto idêntica ou muito semelhante no cache do servidor. Se houver uma correspondência, você recebe o resultado armazenado imediatamente: sem outra chamada à IA. Uma etapa posterior de Confirmação marca a entrada do cache como consumida (contagem de cota).

3 Envio para análise de IA

Se não houver correspondência no cache, a foto (recortada) é enviada ao nosso endpoint de análise. Um modelo de visão (Gemini, Claude ou OpenAI, dependendo da sua escolha nas configurações do aplicativo) é chamado para descrever a imagem, nomear os componentes individuais e estimar quantidades aproximadas.

4 Validação em segundo plano (somente com baixa confiança)

Se a estimativa da IA relatar uma confiança baixa, o servidor inicia uma verificação cruzada em segundo plano com bancos de dados nutricionais (USDA FoodData Central, Open Food Facts). Os valores corrigidos alimentam o cache: na próxima vez que a mesma foto ou uma semelhante for correspondida, você verá o resultado aprimorado. Para escaneamentos com alta confiança, essa etapa é ignorada.

Para códigos de barras, porém, a comparação com Open Food Facts/USDA sempre é realizada diretamente, já que a tabela nutricional do fabricante é a fonte primária neste caso.

5 Edição por você

Você pode sobrescrever qualquer valor: quantidade, carboidratos, kcal, FPE, componente. Ao salvar, seus valores são usados, não a estimativa da IA. O aplicativo armazena sua correção total de carboidratos (Usuário: Xg vs IA: Yg) como uma diferença para fins estatísticos.

6 Salvar e sincronizar com o Nightscout

Localmente em um banco de dados SQLite. Opcionalmente também via sincronização com Nightscout para sua instância do Nightscout, mas apenas como uma nota na tabela de tratamentos (com a etiqueta CarbCam), não como um tratamento ativo de carboidratos/insulina. Seus cálculos do Loop/AAPS/iAPS não são afetados pelos salvamentos do CarbCam: a refeição é visível apenas como uma nota. Se você usa a hospedagem gerenciada do Nightscout em ns.10be.de, a configuração é especialmente fácil: informe a URL do Nightscout e o segredo de API, pronto.

Se você quiser os carboidratos ativamente como um tratamento, use o botão Compartilhar no resultado do escaneamento: ele envia o valor de carboidratos via deep link para AAPS/AndroidAPS, Loop, iAPS ou Trio, ou abre a folha de compartilhamento do sistema.

FPE significa Fat-Protein Units (unidades gordura-proteína). Elas descrevem quanta energia de gordura e proteína afeta a glicemia com atraso.

Um FPE equivale a aproximadamente 100 kcal de gordura e proteína. Exemplo:

• 30 g de gordura + 20 g de proteína = (270 + 80) ÷ 100 = 3,5 FPE

Usuários de bomba costumam usar o FPE para definir os parâmetros do bolus estendido (por exemplo, quadrado ou duplo). Usuários de caneta podem usar o FPE como um indicador aproximado para um lanche de correção tardio ou uma pequena correção à tarde.

O CarbCam exibe o FPE como um chip amarelo no cartão de resultado. As cores dos valores nutricionais:

• Carbs Carboidratos
• kcal Calorias
• FPE Unidades gordura-proteína
• Fat Gordura
• Protein Proteína

Quando o Nightscout está configurado, o CarbCam carrega dados de glicemia da sua instância do Nightscout e mostra a curva de glicemia na aba de histórico abaixo de cada refeição. A janela de tempo depende da plataforma e é escolhida automaticamente em torno da refeição. Junto com o Nightscout, o CarbCam permite um acompanhamento direcionado da glicemia pós-refeição.

Recursos da curva de glicemia (dados do Nightscout):

• Janela de tempo em torno da refeição (depende da plataforma)
• Marcador para o horário da refeição
• Pico destacado em cor (vermelho/amarelo/verde dependendo do nível)
• Subida e valor final como métricas-chave
• IOB / COB como linhas de sobreposição opcionais

A precisão depende do tipo de refeição:

O que melhora a precisão:

• Boa iluminação e foto nítida: sem sombras sobre o prato
• Todos os componentes visíveis: não afogue a massa no molho
• Referência de tamanho: mantenha a borda do prato, talheres ou a mão no enquadramento
• Pratos padrão: a IA é boa em pratos bem conhecidos

O que reduz a precisão:

• Pratos de bufê com muitas pequenas porções
• Componentes muito cobertos por molho
• Pratos regionais muito incomuns sem uma base de dados de referência clara
• Fotografado em ângulo lateral sem referência de tamanho

O que isso significa para o seu bolus:

• Para refeições normais: use a estimativa como ponto de partida, aplique seu próprio conhecimento e ajuste o valor antes de salvar, se necessário
• Para decisões críticas de bolus (carboidratos muito altos, risco de hipoglicemia): consulte sempre seu próprio conhecimento/banco de dados/embalagem
• Com bomba: ganhe experiência sobre o quanto suas refeições costumam desviar, então corrija a estimativa com seu fator pessoal

Sem conexão com a internet, os seguintes recursos funcionam:

• Navegar e filtrar o histórico
• Criar e editar entradas manualmente
• Ver a aba de estatísticas
• Exportar dados (CSV/JSON)
• Tirar fotos e colocá-las na fila para análise posterior

O seguinte requer conexão:

• Análise de IA (a foto é enviada ao provedor)
• Consulta automática de código de barras (Open Food Facts)
• Sincronização com Nightscout (curva de glicemia, envio de tratamentos)