Plataforma
Uma consola full-stack para a entrega séria de software com IA
Registos, base de dados, rede e erros — visíveis ao lado do chat, para depurar a app com evidência e colocar as conclusões diretamente no seu próximo pedido.
A consola full-stack é a superfície de diagnóstico dentro do Ciao Builder: registos, estado da base de dados, pedidos de rede e erros, visíveis ao lado da conversa. Ao contrário de construtores de IA que o deixam a adivinhar quando algo se quebra, a consola mostra o que realmente aconteceu em toda a stack — para que o próximo pedido transporte evidência, não especulação, e as correções cheguem à causa real.
Publicado 2026-07-03 · Última atualização 2026-07-03
Depurar uma app que não escreveu à mão
Quando uma app que construiu com IA se comporta mal, a pior posição em que pode estar é a adivinhar. O erro está na interface, na consulta, na chamada de API, ou nos próprios dados? Sem visibilidade, uma correção de uma linha torna-se uma tarde de pedidos especulativos — tentando reformulações contra uma caixa negra e esperando que uma delas resulte.
A consola full-stack dá-lhe a visibilidade que os engenheiros esperam, dentro do Builder: registos de servidor e navegador, tabelas e linhas de base de dados, pedidos e respostas de rede, e erros com o seu contexto — tudo ao lado da conversa. Vê o que realmente aconteceu, e depois coloca a evidência no próximo pedido.
Isto não é uma superfície de nicho para utilizadores avançados. Toda a promessa de construir software a partir de linguagem simples colapsa na primeira vez que algo se quebra e a plataforma não consegue mostrar-lhe porquê. A visibilidade é o que mantém a promessa honesta.
Como funciona a consola
Tudo acontece ao lado da conversa — o objetivo é manter a evidência e a ação no mesmo local.
1. Abra-a ao lado do chat
Sem ferramentas separadas, sem mudança de contexto. A consola situa-se ao lado da conversa e da pré-visualização ao vivo.
2. Leia os registos
Saída de servidor e navegador da app em execução, para que "não funcionou" se torne uma linha específica num momento específico.
3. Inspecione a base de dados
Veja as tabelas e linhas reais do Supabase por trás da app. Confirme se o registo foi escrito, e com que valores.
4. Observe a rede
Pedidos, respostas, códigos de estado e tempos — especialmente valioso quando integrações e APIs externas estão em jogo.
5. Veja erros em contexto
As falhas aparecem com a atividade circundante que as produziu, não como mensagens nuas despidas da sua história.
6. Transforme evidência em correção
Referencie o que encontrou no próximo pedido. Para problemas de produção ao vivo, o Doctor — o SRE de IA apenas de leitura — sonda a app, o DNS e o CDN, diagnostica a causa raiz e elabora a correção.
Porque é que isto importa
Pedir com evidência vence pedir com intuição. "O POST para /api/orders devolve 400 e a linha nunca aparece na tabela orders" produz uma correção correta numa ronda; "o assunto das encomendas está estragado" produz uma reescrita de algo que nunca foi o problema. A consola é o que torna o primeiro tipo de pedido possível para todos, não apenas engenheiros.
Esta é grande parte do que separa a engenharia assistida por IA de conversar com esperança: o sistema mostra o seu estado, o humano raciocina sobre ele, e a correção baseia-se no que a stack realmente fez. Ao longo do tempo isso produz uma base de código mais silenciosa — menos reescritas especulativas, diffs mais pequenos, e uma equipa que confia na app porque consegue sempre ver dentro dela.
Também muda quem pode apoiar uma aplicação. Uma agência ou uma equipa de operações consegue responder "o que aconteceu a essa encomenda?" com dados em vez de escalar, porque a pergunta é inspecionável no mesmo local onde a app vive.
Quem usa a consola full-stack
A consola serve todos os que já tiveram de responder à pergunta "o que aconteceu realmente?"
- Fundadores técnicos — Diagnosticam as suas próprias apps em minutos em vez de escalar cada contratempo ou repedir às cegas.
- Agências — Apoiam apps de clientes profissionalmente — reproduzem o problema, leem a evidência, lançam a correção revista.
- Programadores — Verificam o comportamento do backend escrito por IA — consultas, escritas, chamadas de API — antes de o confiar com dados de produção.
- Equipas de operações — Confirmam que os fluxos de dados entre a app e sistemas existentes estão a fazer o que a integração prometia.
Notas de segurança e governança
A visibilidade é poderosa, por isso vem com controlos:
- ✓ O acesso ao workspace, incluindo a consola, segue o controlo de acesso baseado em funções.
- ✓ As correções guiadas por evidência da consola ainda passam pela revisão do Guardrails e pelos gates de QA antes da publicação.
- ✓ A Segurança confirma vulnerabilidades contra a app ao vivo antes de as sinalizar — conclusões, não ruído.
- ✓ O Doctor opera apenas de leitura: sonda, diagnostica e elabora correções, mas as alterações são lançadas através do ciclo governado.
- ✓ Os pedidos, merges e deploys à volta de cada correção chegam ao registo de auditoria apenas de acréscimo.
O que a consola mostra
Quatro superfícies cobrem a maioria das investigações de ponta a ponta:
| Superfície | O que vê | O que responde |
|---|---|---|
| Registos | Saída de servidor e navegador da app em execução | O que executou, e o que reportou |
| Base de dados | Tabelas, linhas e valores do Supabase | Os dados mudaram realmente, e como |
| Rede | Pedidos, respostas, códigos de estado, tempos | O que a app e sistemas externos disseram um ao outro |
| Erros | Falhas com contexto circundante | Onde se quebrou, e o que levou a isso |
Perguntas frequentes
Preciso de ferramentas externas para depurar uma app construída no Ciao?
Para o trabalho do dia a dia, não — registos, base de dados, rede e erros são inspecionáveis de dentro do Builder. Como a app é React, TypeScript e Supabase padrão que você possui, os seus engenheiros também podem ligar as ferramentas externas que preferirem.
Posso ver a base de dados real?
Sim. A consola mostra as tabelas e linhas do Supabase por trás da sua app, para que possa confirmar o que um fluxo realmente escreveu. É muitas vezes a forma mais rápida de distinguir um erro de interface de um erro de dados.
Como é que a consola se relaciona com o Doctor?
A consola é você a olhar para a stack; o Doctor é um SRE de IA apenas de leitura que olha por si — sondando a app ao vivo, o DNS e o CDN, diagnosticando a causa raiz e elaborando a correção. Trabalham melhor juntos: o Doctor para incidentes de produção, a consola para investigação em tempo de construção.
Quem na equipa consegue ver a consola?
O acesso segue o controlo de acesso baseado em funções no workspace, para que decida quem pode inspecionar registos e dados. Os planos empresariais acrescentam SSO via SAML e OIDC e MFA opcional por cima.
Usar a consola contorna a governança quando lanço uma correção?
Não. A consola informa a correção; a correção ainda se integra sob o Guardrails com revisão humana registada, passa pelos smoke gates de QA antes da publicação, e é registada no registo de auditoria apenas de acréscimo.