O plano do site

O PLAN.md é escrito no momento em que a primeira criação de um projeto termina, e foi feito para descrever sempre o site como ele está agora — não um registro de tudo que já aconteceu com ele (para isso servem a aba Versões e o Registro de mudanças). A tela Plano do site transforma esse Markdown em interface real: uma tabela para as páginas, uma lista para os módulos, uma lista de verificação para as perguntas em aberto e texto corrido para os fatos do negócio, a marca e as decisões.

Antes de qualquer criação terminar, não há nada para ler ainda: a tela mostra "Nenhum plano ainda", explica com clareza que o plano é escrito pela primeira criação do projeto e leva de volta à página própria do projeto, em vez de mostrar uma tabela vazia.

Um site cujos arquivos chegaram sem plano (publicado por outra ferramenta de IA pelo conector, importado ou enviado) ainda assim recebe um: a tela começa o plano a partir do briefing do projeto, das escolhas do kit e das páginas medidas, e um aviso, Este plano foi iniciado para você, oferece Salvar este plano, que o torna o plano real do projeto para que todas as seções possam ser editadas. Ler o plano completo do site leva ao documento do plano na aba Plano e briefing.

Ferramentas adicionadas depois a partir do Kit (Adicionar ao plano) entram na lista de Módulos como Planejado, com um link Ver no Kit, mesmo quando o texto do plano foi escrito antes de elas serem adicionadas.

Abaixo do título, uma linha informa quando o plano foi atualizado pela última vez: "Plano atualizado 2 de out., 15:04". Esse horário vem da última vez em que o aiKit mediu os arquivos reais do site, o que acontece após cada alteração (uma edição pelo chat, um fixar, uma adição do kit, uma restauração, uma edição manual do plano, uma publicação por outra ferramenta de IA).

No topo, assim que existir um plano: uma barra geral de porcentagem concluída e três cartões abaixo dela: Páginas criadas (de páginas planejadas), Módulos criados (de módulos escolhidos) e Perguntas respondidas (das perguntas em aberto do plano). Cada cartão é um botão que rola até a seção que ele conta. Nada disso é informado pelo próprio texto do plano: uma página só conta como criada quando o aiKit a encontra nos arquivos reais do site; um módulo só conta como criado a partir do relatório de build verificado ou do módulo encontrado nos arquivos; e uma pergunta conta como respondida quando a linha dela está marcada no plano ou quando o cliente respondeu na página Perguntas dele.

Duas coisas fazem o plano ficar desatualizado, e a tela informa qual delas: a análise de IA que reescreve o plano após uma mudança não terminou ("O plano escrito não foi atualizado após a última mudança", com o motivo), ou o site tem uma versão mais nova do que a usada para medir o plano ("O site mudou depois que este plano foi atualizado pela última vez"). Em qualquer um dos casos, aparece um botão "Atualizar plano". A página nunca executa isso sozinha ao ser aberta (abrir uma página nunca usa IA); o motor já incorpora cada mudança ao plano em segundo plano, e o botão existe para quando isso ficou para trás. Atualizar plano incorpora a mudança mais recente ao plano escrito e mede o site de novo. Se ainda assim não der certo, o aviso continua mostrando o que deu errado, e você pode pressionar Atualizar plano novamente ou editar o plano manualmente.

O cartão Saúde dá ao site uma nota de 0 a 100 com base em regras que o aiKit verifica nos arquivos reais, nunca na opinião da IA: título ou descrição de busca da página ausente ou repetido, página sem título principal ou com mais de um, link para uma página que não existe, página que ninguém linka e que o menu deixa de fora, imagens sem descrição para leitores de tela, páginas muito curtas, formulário sem destino e módulo pedido no briefing que não está no site. Cada problema indica a página, explica por que importa e tem um botão Corrigir: Corrigir envia a instrução pronta do problema como uma solicitação e a entrega à IA; o botão mostra "Correção solicitada" enquanto trabalha, e a nota é medida de novo quando a mudança for aplicada. Filtre a lista por gravidade com os contadores Alta, Média e Baixa, e "Mostrar todos" remove o filtro.

O Mapa do site desenha o site como uma árvore: a página inicial no topo, depois o menu na ordem, depois as páginas acessadas a partir dessas. Páginas que ninguém linka ficam em um grupo próprio, páginas listadas no plano que ainda não foram criadas são desenhadas tracejadas e marcadas como Planejada, e páginas criadas que o plano nunca menciona são marcadas como "Não está no plano" com um botão "Adicionar ao plano", que as inclui na seção Páginas.

Toque em qualquer página (no mapa do site ou na lista Páginas) para abrir os detalhes dela ao lado do plano. A barra de endereços muda para ?page=/sobre, então o link abre a mesma página para qualquer pessoa da equipe. Os detalhes mostram como a página aparece no Google (título, endereço, descrição), suas seções e títulos principais, contagem de palavras, imagens e quantas não têm descrição, seus formulários e qual módulo do kit os executa, se o cliente aprovou a página, e a última mudança: quando, quem pediu e o que foi pedido.

O Histórico lista as versões que o aiKit guarda (a Original e as 10 mais recentes), da mais nova para a mais antiga: o número, o tipo de mudança (Primeira criação, Chat, Fixado, Kit, Publicado, Restauração, Edição do plano), quando, o que foi pedido, quem pediu e quais páginas mudaram (toque em uma página para abrir os detalhes dela). A mais nova é marcada como Versão atual; qualquer versão anterior tem "Restaurar esta versão", que pede confirmação e salva o estado atual antes de devolver o site àquela versão, para que a restauração possa ser desfeita. As três primeiras aparecem; "Mostrar todas" lista as demais.

A seção Dados do negócio compara o telefone, o e-mail, o endereço e o horário da Ficha do Cliente com o texto das páginas criadas (começando pela página inicial e pelo contato). Cada dado mostra "No site" ou "Não encontrado no site" (com quantas páginas foram verificadas, já que o site pode mostrar um valor antigo), e um link "Editar na Ficha do Cliente" mantém a Ficha do Cliente como fonte da verdade.

• Páginas — uma tabela: Página, Caminho, Finalidade e Status (Criada ou Planejada), com um link "Ver" para a página no ar assim que ela estiver criada e o site estiver publicado.
• Módulos e ferramentas — cada módulo listado no plano, com uma etiqueta Criado ou Planejado e a própria nota.
• Dados do negócio — horário, endereço, serviços, preços e qualquer informação factual sobre o negócio, escrita como texto simples.
• Marca — a paleta, o tom e quaisquer notas de estilo registradas no plano.
• Decisões — escolhas reais que já foram feitas e não devem ser rediscutidas na próxima edição.
• Perguntas em aberto — uma lista de verificação com itens que ainda não foram decididos de fato, cada um mostrando respondida ou ainda em aberto.

Todo cartão de seção tem os mesmos dois botões. "Editar" abre o Markdown bruto dessa seção em uma área de texto simples e o salva diretamente no PLAN.md — é uma gravação real e imediata (pelo endpoint PUT do próprio projeto), mas não dispara de propósito um build nem uma publicação; só altera o que o documento do plano diz, como editar qualquer outra anotação.

"Pedir uma alteração" é diferente de propósito: ele abre um formulário simples ("O que você gostaria de alterar em <section>?"), e ao enviá-lo, uma solicitação real é registrada na aba Feedback do projeto — com o rótulo "Plano do site — <Section>: …" — exatamente como qualquer pedido feito por marcação ou Edição rápida, com seu próprio ciclo de status e um link "Ver a solicitação" assim que for enviada. Use Editar quando você quiser corrigir ou reescrever o próprio texto do plano, e use Pedir uma alteração quando quiser que o site em si (e, consequentemente, o plano) seja atualizado para ficar igual.

O plano tem duas camadas. As medições (páginas, títulos, seções, links, formulários, módulos, saúde) são feitas pelo código a partir dos arquivos reais após cada mudança, então nunca ficam fora de sincronia. O plano escrito (metas, fatos do negócio, marca, decisões, perguntas em aberto) é mantido atualizado por uma etapa de IA que roda após cada mudança e reescreve apenas as partes que a mudança tocou. Ela nunca adiciona um registro de alterações nem entradas com data; o Histórico é onde fica o registro das mudanças.

Se essa etapa de IA falhar, o plano escrito é mantido como estava, em vez de ficar reescrito pela metade, a falha é registrada e a tela mostra Atualizar plano (veja acima) em vez de exibir silenciosamente um plano desatualizado.

Uma coluna ao lado do plano reúne as ações (no celular, a coluna vira um botão de largura total "Copiar o link do cliente" logo abaixo da faixa de progresso, com as demais ações recolhidas em "Mais ações (3)"). "Compartilhar com o cliente" copia um link somente leitura (aikit.ai/p/<project>/plan), sem ferramentas da equipe, sem botões de edição e sem nada interno. "Abrir o site ao vivo" é um link direto para o site publicado, ou a coluna diz claramente "Ainda não está no ar" se não estiver. "Arquivos" mostra o número real de arquivos com uma lista expansível do caminho e do tamanho de cada um. "Baixar o plano" baixa o PLAN.md atual como um arquivo .md real, byte por byte igual ao que a tela está lendo, e não um resumo gerado de novo.

A página do cliente abre na aba Plano: o mesmo documento de plano do site que a equipe vê na aba Plano e briefing (visão geral e metas, público, estratégia, mapa do site, cada ferramenta com o que faz pelo negócio dele e seu status, plano de conteúdo, cronograma, decisões e perguntas em aberto), sem as partes internas: nada de notas digitadas quando uma ferramenta foi adicionada, nenhum nome de quem adicionou o quê, nenhum link para o Kit da aiKit e nenhum botão Escrever o plano. Uma segunda aba, Páginas e aprovações, mantém a visão página por página abaixo.

Em Páginas e aprovações, protegida pelo mesmo código de acesso que o cliente já usa para deixar comentários (sem login separado), o cliente vê a mesma faixa de progresso, um Mapa do site com as páginas dele, a lista de Páginas com os links "Ver", os módulos, os fatos do negócio, a marca, as decisões e as perguntas em aberto, além da linha "Plano atualizado". Ele não tem acesso à Saúde, às instruções de correção, ao Histórico, a quem pediu o quê, à lista de arquivos nem a nenhum botão Editar ou Pedir uma alteração.

Qualquer coisa que a equipe marque para uso interno é removida no servidor antes da página ser enviada, em todas as seções: uma linha contendo "(internal)", "[internal]" ou "(staff only)", uma linha começando com "Internal:" ou "Staff only:", qualquer seção cujo título diga Internal ou Staff only, e comentários ocultos. Essas linhas nunca chegam ao navegador do cliente, nem mesmo nos dados de rede da página.

Cada página construída tem um botão Aprovar. O cliente digita o nome (e uma observação opcional) e aprova; a aprovação fica vinculada ao conteúdo exato daquela página, então, se ela mudar depois, aparece "Alterada desde a sua aprovação" e a aprovação é pedida novamente. Somente quem usa o código de acesso do cliente pode aprovar. Se você abrir o link do cliente estando logado como membro da equipe, verá o estado de aprovação de cada página, mas nenhum botão Aprovar, para que ninguém aprove em nome do cliente. No Plano do site da equipe, páginas aprovadas mostram "Aprovado pelo cliente" e as alteradas mostram "Alterado desde a aprovação".

Um botão "Enviar feedback" fica no final: se o site estiver no ar, ele abre o site publicado real com a sobreposição de feedback já ativada (usando o código de acesso do próprio cliente); se ainda não estiver no ar, ele leva à página de Atualizações recentes do cliente.