Computação frugal
Código trata o previsível, modelos leves a ambiguidade e alta precisão apenas erros dispendiosos.
Transparência de engenharia
Stack tecnológico e arquitetura de IA
Uma visão pública e versionada do equilíbrio entre conhecimento de vinho, velocidade, custo e privacidade, distinguindo produção de validação.
Catalog2026-09-08
Estado da implementação
Esta página nasce de um único catálogo. Só componentes validados em produção ficam ativos.
- Ativo
- Parcialmente ativo
- Em validação
- Planeado
Stack de IA
O cliente não escolhe o fornecedor; o servidor controla tarefa, modelo, cobrança e fallback.
| Camada | Tecnologia ou modelo | Uso | Estado |
|---|---|---|---|
| Cliente | Flutter 3.47 / Dart 3.13 |
Uma base de UI para Android, iOS, Web e PWA. | Ativo |
| Autenticação e proteção da API | Firebase Auth / App Check |
Aceita utilizadores autenticados e instâncias verificadas. | Ativo |
| Orquestrador de avaliação | Cloud Functions / Node.js 22 |
Classifica avaliação e estudo, escolhe modelos, controla tickets, repete e valida. | Parcialmente ativo |
| Cache verificado | Verified Wine Library cache |
Devolve um resultado Wine Library verificado sem novo pedido ao modelo. | Ativo |
| Normalização da entrada | ministral-8b-2512Contexto 256k · saída estruturada |
Normaliza a identidade a partir de rótulo, carta ou texto e verifica se é suficiente. | Em validação |
| Validação de avaliações | mistral-small-2603Contexto 256k · saída estruturada · raciocínio ajustável |
Valida caminhos de rascunho de avaliação e metadados de perguntas antes da produção. | Em validação |
| Gemini leve | gemini-3.5-flash-liteContexto de entrada 1M · saída estruturada · Thinking |
Tradução e processamento leve: Gemini 3.5 Flash-Lite. A identificação do vinho usa Gemini 3.8 Flash. | Ativo |
| Gemini de alta precisão | gemini-3.8-flash / gemini-3.7-flashContexto de entrada 1M · saída estruturada · Thinking baixo/médio/alto |
Avaliações e Grand: Gemini 3.8 Flash. Quizzes e correção escrita: Gemini 3.7 Flash. | Ativo |
| Dados | Firestore / Wine Library |
Factos verificados, avaliações e cache por idioma. | Ativo |
| Conhecimento confidencial | Server-only reference layer |
Mantém referências e instruções de avaliação e perguntas no servidor. | Parcialmente ativo |
| Segredos | Google Secret Manager |
Separa credenciais do código e do cliente. | Ativo |
| Observabilidade | Cloud Logging / aggregate metrics |
Mede modelo, tarefa, latência, tokens e sucesso sem registar a entrada. | Ativo |
Como uma avaliação ou pergunta é processada
A Wine Library é consultada primeiro; os modelos só correm quando necessário e o resultado é validado antes da apresentação.
Rótulo, excerto de carta ou identidade escrita
Auth + App Check
Contrato de avaliação ou estudo do servidor
Correspondência Wine Library → cache verificado; custo conforme a tarefa
Normalização da identidade → validação
Rascunho de avaliação → Mistral Small 4 · apenas validação
Tradução e processamento leve: Gemini 3.5 Flash-Lite. A identificação do vinho usa Gemini 3.8 Flash.
Avaliações e Grand: Gemini 3.8 Flash. Quizzes e correção escrita: Gemini 3.7 Flash.
Estrutura, factos, idioma, plano e política
Resultado de referência ou reembolso
Porquê esta arquitetura
Quatro princípios de engenharia substituem uma abordagem única.
Geração fundamentada
Dados verificados são recuperados e factos separados de recomendações.
Falha segura
Uma avaliação crítica falhada não é rebaixada silenciosamente: reembolsa e repete.
Cobrança idempotente
Uma tarefa tem uma chave; repetição e fallback não duplicam consumo.
Política de raciocínio
A intensidade depende do risco; prompts, limites exatos e traços ficam no servidor.
| Tarefa | Modelo | Intensidade |
|---|---|---|
| Geração de perguntas de escolha múltipla | Gemini 3.7 Flash |
Baixa |
| Correção de respostas escritas | Gemini 3.7 Flash |
Média |
| Tradução e extração | Gemini 3.5 Flash-Lite |
Mínima |
| Avaliação de prova estruturada | Gemini 3.8 Flash |
Média |
| Arbitragem de diferenças materiais | Gemini 3.8 Flash |
Alta |
Integridade dos tickets
Os tickets seguem o objetivo da tarefa, não o fornecedor interno.
- Reabrir avaliações guardadas usa 0 bilhetes. Uma nova avaliação segue o custo do servidor, mesmo com cache disponível.
- Sem resultado utilizável, os bilhetes reservados para o pedido são devolvidos.
- Cada nova avaliação mostra o custo em bilhetes confirmado pelo servidor antes de começar. Reabrir avaliações guardadas é gratuito.
- Os exercícios mostram preço fixo antes de iniciar.
- Fallback e repetição não consomem mais.
- Sem resultado útil há reembolso automático.
- Retomar tarefa paga não volta a cobrar.
Fallback sem perda silenciosa
- Avaliações e Grand: Gemini 3.8 Flash. Quizzes e correção escrita: Gemini 3.7 Flash.
- A tradução usa Gemini 3.5 Flash-Lite com tentativas limitadas e Gemini 3.8 Flash se a validação falhar.
- Falha Gemini 3.8 Flash não desce para avaliador inferior.
- Uma tarefa implica no máximo um consumo.
Limite de privacidade
- O catálogo é público, mas o cliente não controla o modelo.
- Prompts, referências privadas, limites e proteções ficam no servidor.
- Traços de raciocínio não são mostrados nem armazenados.
- Chaves permanecem no Secret Manager.
- Grand permanece na rota Gemini aprovada durante a validação Mistral.
- A aprovação do Mistral exige API regional da UE sem estado, exclusão de treino e elegibilidade ZDR verificada; não aparece ativa antes da validação operacional.
- Logs guardam metadados, nunca prompts, mensagens, e-mails ou imagens.
Versioned by design
Arquitetura viva
Catálogo, oito idiomas, dados estruturados, sitemap e resumo para IA são gerados e validados juntos.
Referências técnicas primárias
Perguntas de arquitetura
O cliente escolhe o modelo?
Não. O servidor autenticado aplica uma política versionada.
O fallback consome outro ticket?
Não. Partilha o mesmo pedido idempotente.
O Mistral já processa avaliações em produção?
Não; permanece em validação multilingue do domínio do vinho.
As instruções de avaliação são públicas?
Não. A arquitetura é pública; instruções, referências, limites e traços são confidenciais.