Computação frugal
Código trata o previsível, modelos leves a ambiguidade e alta precisão apenas erros dispendiosos.
Voltar ao Maison Apéro
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.
AtivoParcialmente ativoEm validaçãoPlaneado
Esta página nasce de um único catálogo. Só componentes validados em produção ficam ativos.
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 | Server-owned 8-language templates | Devolve um resultado Wine Library verificado sem novo pedido ao modelo. | Parcialmente 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 | Caminho previsto para tradução, extração de rótulo e estrutura leve. | Planeado |
| Gemini de alta precisão | gemini-3.7-flashContexto de entrada 1M · saída estruturada · Thinking baixo/médio/alto | Prova estruturada, geração de perguntas, correção escrita, Grand e arbitragem crítica. | 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.
01Rótulo, excerto de carta ou identidade escrita
02Auth + App Check
03Contrato de avaliação ou estudo do servidor
04Correspondência Wine Library → cache verificado · 0 tickets
05Normalização da identidade → validação
06Rascunho de avaliação → Mistral Small 4 · apenas validação
07Tradução ou extração → Gemini 3.5 Flash-Lite
08Avaliação, perguntas ou correção → Gemini 3.7 Flash
09Estrutura, factos, idioma, plano e política
10Resultado 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 |
|---|---|---|
| Normalização da identidade | Ministral 3 8B | Mínima |
| Validação de rascunho | Mistral Small 4 | Baixa |
| Geração de perguntas | Mistral Small 4 | Média |
| Tradução e extração | Gemini 3.5 Flash-Lite | Mínima |
| Prova e correção escrita | Gemini 3.7 Flash | Média |
| Arbitragem de diferenças materiais | Gemini 3.7 Flash | Alta |
Integridade dos tickets
Os tickets seguem o objetivo da tarefa, não o fornecedor interno.
- Pesquisa Wine Library e cache verificado: 0 tickets.
- Entrada inválida ou insuficiente é rejeitada antes do consumo.
- As avaliações de vinho usam 0 bilhetes.
- 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 perguntas de produção permanecem na rota aprovada Gemini 3.7 Flash.
- Tradução e extração previstas usarão repetição limitada Gemini 3.5 Flash-Lite após validação.
- Falha Gemini 3.7 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.
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.