Console + site público

Dois lugares onde o Letaido coloca o que constrói: um para sua equipe, outro para todos os outros.

1. O Console (interno)

O Console é um aplicativo web exclusivo para membros onde a Letaido disponibiliza ferramentas internas. Pense nele como a superfície do painel de controle privado da sua equipe.

Acessível apenas para membros da área de trabalho. Visitantes anônimos encontram uma tela de login.
O aplicativo lê a identidade dos cabeçalhos de autenticação, então cada página sabe quem está visualizando (proprietário, administrador, membro, visualizador).
Acesso ao banco de dados: leitura/gravação completa para console_db e console_site_db. Não pode acessar site_db.

Criar uma página de Console quando:

A saída é apenas para sua equipe.
É necessário consultar dados internos, chamar conectores ou exibir controles.
Os clientes nunca devem vê-la.

Relatórios, aplicativos, artefatos

Tudo o que a Letaido cria no Console se enquadra em uma das três categorias. A página inicial do Console tem uma aba para cada uma (Relatórios, Aplicativos, Artefatos) mais uma aba Início que lista tudo junto, do mais recente para o mais antigo, com a categoria como uma tag ao lado do título.

Bucket	O que é	O que sua equipe faz com isso	Exemplos
Relatórios	Gráficos, tabelas e visualizações de dados filtrados	Abre, lê os números, filtra e sai	Ahrefs Brand Authority, AI Visibility, Rank Monitor
Aplicativos	Ferramentas de várias páginas e fluxos de trabalho complexos	Cola uma entrada, executa um pipeline, obtém uma saída, retorna a execuções anteriores	Battlecard Generator, AI Visibility Dashboard, Paid Ads Campaign Builder
Artefatos	Itens únicos: um gráfico, uma tabela, um trecho de texto	Dá uma olhada, copia, compartilha e segue em frente	Visualização de e-mail, bloco de página inicial, seção AEO 101, Ahrefs Feature Library

Relatórios

Um Relatório é algo que você abre para ver o estado de algo. O valor está nos dados exibidos; a interação principal é ler ou filtrar. Os Relatórios são atualizados de suas fontes de dados em um cronograma ou sob demanda. Eles ficam em /reports/<slug>/.

Solicite um relatório quando a resposta para "por que isso existe" for "para que possamos ver X rapidamente" (o estado das nossas classificações, a participação de voz desta semana, o delta de autoridade da marca deste mês).

Aplicações

Uma aplicação é algo que você usa para trabalhar. O valor está no fluxo de trabalho; a interação principal é criar, editar ou produzir. As aplicações recebem entrada, executam pipelines de várias etapas, armazenam resultados e permitem que sua equipe retorne a execuções anteriores. Elas ficam em /applications/<slug>/.

Peça um aplicativo quando a resposta para "por que isso existe" for "para que possamos fazer X repetidamente sem reconstruir o fluxo de trabalho toda vez" (gerar um battlecard, executar um briefing de campanha, produzir um texto).

Artefatos

Um Artefato é uma única parte da saída que você insere uma vez e referencia depois. Ele é pequeno, independente e não vale a pena ser envolvido em um aplicativo ou relatório completo. Os Artefatos ficam em /artifacts/<slug>/.

Solicite um Artefato quando a resposta para "por que isso existe" for "para que a equipe tenha um lugar para visualizá-lo" (uma prévia de bloco da página inicial, o e-mail desta semana, uma biblioteca de recursos, um documento de uma página para vendas).

Não tem certeza de qual você quer?

Descreva o resultado e o agente escolhe o bucket certo.

"Mostre-me a autoridade da marca semanal por concorrente." → Relatório.
"Crie uma ferramenta onde eu colo a URL de um concorrente e recebo um battlecard de volta." → Aplicativo.
"Gere uma prévia do boletim informativo da próxima semana." → Artefato.

2. O site público (externo)

O site público é a parte da sua área de trabalho que a internet aberta pode acessar, completamente isolada do Console que sua equipe usa. Ele existe para fornecer conteúdo a pessoas fora da sua área de trabalho.

Padrão de URL: /<route> para tudo. Padrões convencionais: /u/<token> para relatórios compartilhados únicos, /r2s/<token> para execuções revisadas, /docs/<slug> para estes documentos.
A visibilidade é controlada por uma alternância no nível da área de trabalho (consulte Modos abaixo).
Acesso ao banco de dados: leitura/gravação site_db (é o proprietário). Leitura/gravação console_site_db. Não pode acessar console_db.

Crie uma página de site público quando: - Um cliente, prospect ou visitante anônimo precisar ver algo. - Você quiser um URL compartilhável fora de e-mail ou Slack. - Os dados já foram gerados (no Console ou por um job) e você está apenas os disponibilizando.

Três modos para o site público

O site público tem três estados, alternados por um proprietário ou administrador na interface da área de trabalho. O próprio agente não pode alterá-los.

off: o nginx retorna 403 para todos. O processo Flask ainda está em execução; nenhum tráfego o alcança.
authorized: membros da Área de trabalho e convidados explicitamente convidados podem visualizá-lo. Bom para revisão antes de um lançamento.
open: qualquer pessoa com o URL pode visualizá-lo. Trate cada visitante como não confiável.

Quando o modo é open, o agente aplica padrões extras: validação Pydantic em cada entrada do visitante, nenhuma chamada de conector por visitante (armazenamento em cache em site_db), aprovações de conector separadas para a superfície do site e a saída visível é higienizada antes da persistência.

Comunicação entre superfícies

O Console e o site público funcionam em processos diferentes. Eles ainda podem cooperar, mas apenas por meio de um canal explícito: o banco de dados console_site_db.

O Console grava dados (um relatório, um resumo, um artefato) em uma tabela.
O site público lê essa tabela e a renderiza em um URL protegido por token.
O site pode gravar de volta sinais de interação (por exemplo, "o visitante clicou") que o Console lê.

O agente NÃO tenta fazer proxy de uma consulta do Console por meio de uma rota pública. O REVOKE está na camada do banco de dados; falharia de qualquer forma e também seria o design errado.