Um painel feito com ajuda de IA continua a precisar de revisão antes de ficar disponível. Antes da primeira publicação na Vercel, alguém tem de verificar o código gerado, os dados que pode ler ou alterar e quem pode aceder às páginas implementadas. Este guia parte de um painel existente que funciona localmente. Segue as instruções atuais da CLI da Vercel, verificadas a 20 de outubro de 2026; a BIG CHANGE não criou nem implementou uma aplicação de exemplo.

A grande mudança

  • O que mudou: Um painel local feito com ajuda de IA pode tornar-se uma implementação real em produção logo no primeiro vercel deploy. A passagem para produção pode acontecer antes de a equipa criar uma pré-visualização.
  • Porque importa: Quem publica a aplicação tem de verificar as dependências geradas, os pedidos de dados, os segredos e os acessos antes desse comando. Um ecrã local a funcionar pouco diz sobre quem pode abrir o domínio de produção ou o que o servidor pode ler.
  • O que observar: O registo decisivo é a implementação real e as suas verificações de acesso: URL de produção, identidade da compilação, rotas representativas, registos e visitantes autorizados e recusados. As alterações seguintes podem usar pré-visualizações, mas uma compilação de produção usa variáveis próprias e exige a mesma confirmação.

1. Reveja o painel e escolha os utilizadores

Precisa do código-fonte autorizado de um painel a funcionar localmente, do comando de compilação repetível do respetivo framework, de acesso à origem de dados aprovada e de autorização para criar uma implementação em produção na equipa Vercel prevista. Instale a CLI atual da Vercel e tenha acesso à conta, uma conta de teste para um visitante autorizado e uma forma separada de verificar um visitante recusado. Confirme que a Vercel suporta o framework e as definições de compilação da aplicação; este guia não pode fornecer comandos para uma base de código desconhecida.

Reveja os ficheiros gerados por IA como código de produção. Leia as dependências e os scripts dos pacotes, a configuração do framework, as rotas do servidor e o código do navegador. Siga cada pedido de dados: destino, credencial usada, resposta e eventual escrita de dados por uma rota. Confirme que o código enviado ao navegador não contém chaves privadas nem registos não autorizados e que as rotas do servidor aplicam as permissões do utilizador previsto. Execute a compilação própria da aplicação e uma vista representativa do painel com dados de teste aprovados. Resolva avisos de dependências, falhas de compilação e dados incorretos antes de carregar. Remova credenciais incorporadas; se alguma entrou no controlo de versões, substitua-a no fornecedor. Um repositório privado não torna privado um painel implementado.

Decida quem pode abrir o painel de produção antes de o associar a um projeto. Standard Protection mantém os domínios de produção públicos. All Deployments abrange os domínios de produção e os URL gerados; com Vercel Authentication está disponível em todos os planos, mas os visitantes precisam do acesso Vercel adequado. Não serve como início de sessão para qualquer cliente. Para clientes ou outros utilizadores externos, planeie e teste a autenticação e autorização próprias do painel ou escolha outro método de proteção compatível com os utilizadores e o plano. A proteção do alojamento não substitui as verificações nas rotas de dados da aplicação.

Consulte o plano da conta e a página de utilização. O plano Hobby da Vercel destina-se a uso pessoal não comercial; um painel empresarial exige um plano pago adequado. Alojamento, funções, transferência de dados e serviços externos de modelos ou bases de dados podem ter custos e limites separados. Os preços e limites atuais dependem da conta prevista: reveja-os antes de autorizar a publicação.

2. Associe o projeto e configure os acessos e as variáveis

Na pasta local do painel, inicie sessão na CLI atual da Vercel com a conta prevista e associe a pasta:

Terminal
vercel link

O comando interativo seleciona a equipa e o projeto ou cria um projeto, se necessário. Associar não implementa o projeto. Compare a equipa e o projeto selecionados, a predefinição do framework, a pasta raiz, o comando de compilação e as definições de saída na Vercel com o código revisto. Se alguma definição for incerta, pare antes de implementar e resolva-a nas definições do projeto e na compilação local.

Abra agora nesse projeto Settings → Deployment Protection. Selecione o método e o âmbito de proteção escolhidos no passo 1 e confirme que a definição guardada cobre o domínio de produção e os URL de implementação gerados conforme previsto. Inspecione exceções e ligações partilháveis. Faça-o antes da primeira implementação; as definições de um projeto novo só podem ser verificadas depois de existir.

Em Settings → Environment Variables, introduza cada nome, valor, tipo e ambiente de destino necessário. Coloque as credenciais em Secret, cujo valor não pode ser lido depois de guardado; use Config para valores que os membros autorizados do projeto possam ler mais tarde. Não coloque credenciais do servidor em variáveis que o framework expõe ao navegador. Atribua a Development, Preview e Production os valores e permissões previstos, incluindo dados de servidor separados quando adequado. O comando de listagem ajuda a verificar nomes e destinos sem apresentar valores secretos:

Terminal
vercel env ls

Guardar ou alterar uma variável afeta novas implementações, não as anteriores. Um Secret guardado não pode ser recuperado mais tarde para configurar um portátil; não conte com vercel env pull nem com vercel env run para o recuperar. Obtenha do fornecedor uma credencial de desenvolvimento separada e autorizada e siga a configuração local do framework. Execute a aplicação local e repita a vista de dados permitida e o teste de utilizador recusado nesse ambiente de desenvolvimento. Se a aplicação ou o fornecedor tiver um processo especial de autenticação, siga o procedimento documentado antes de prosseguir.

3. Aprove e verifique a primeira publicação em produção

Peça ao responsável que aprove esta primeira publicação específica após as verificações de código, dados, acessos, variáveis, plano e compilação. O guia da CLI da Vercel indica que o primeiro vercel deploy de um projeto novo cria uma implementação em produção mesmo sem --prod. Trate o seguinte comando como uma ação em produção:

Terminal
vercel deploy

Guarde o URL devolvido e encontre o identificador da implementação no painel da Vercel. Confirme que a compilação terminou, que o ambiente de produção e o código são os aprovados e que o domínio atribuído é o previsto. Verifique a raiz e cada rota real do painel ou da API escolhida para revisão, substituindo os marcadores entre parênteses angulares pelo URL devolvido e pelos caminhos reais:

Terminal
vercel curl / --deployment <production-url>
vercel curl /your-real-route --deployment <production-url>
vercel logs --environment production --level error --since 5m

A resposta da rota deve corresponder à página ou ao comportamento de dados permitido esperado; investigue erros nos registos de compilação ou execução. vercel curl pode ultrapassar a proteção da implementação, pelo que o seu sucesso não demonstra que a página é privada. Num navegador normal, abra o domínio de produção e o URL gerado sem sessão iniciada e confirme a recusa onde o acesso deva ser controlado. Depois entre como visitante previsto e verifique o painel e o seu percurso de dados permitido. Teste também um visitante que não deva ver esses dados. Registe o URL real, o identificador da implementação, as respostas das rotas, os resultados dos visitantes e o resultado relevante dos registos de erro. Esta é a verificação de conclusão, não apenas a devolução de um URL pela CLI.

Se o resultado do primeiro comando for incerto, inspecione essa implementação exata no painel do projeto antes de repetir. Uma falha de compilação exige consultar o registo e corrigir localmente dependências ou definições do framework, seguindo-se uma nova implementação aprovada. Uma variável em falta exige verificar destino e tipo, guardar um valor corrigido e implementar novamente. Se o painel estiver vazio ou uma rota de dados falhar, compare o pedido do navegador com os registos de execução, o endereço do servidor, as origens permitidas e as permissões do servidor; volte depois a executar as verificações de rota e acesso que falharam.

Se material sensível ficar público inesperadamente, o proprietário autorizado do projeto pode escolher imediatamente All Deployments with Vercel Authentication em Deployment Protection e confirmar a recusa no domínio de produção e nos URL gerados num navegador sem sessão iniciada. Verifique exceções e ligações de partilha e revogue no fornecedor as credenciais de servidor expostas. Esta restrição temporária admite apenas utilizadores Vercel adequados e pode interromper acessos previstos. Corrija a aplicação e o desenho do acesso, aprove uma nova implementação e verifique visitantes autorizados e recusados antes de reabrir. Uma primeira publicação pode não ter implementação anterior à qual voltar; restringir o acesso não desfaz uma divulgação já ocorrida.

4. Use pré-visualizações nas alterações seguintes

Depois de o projeto ter uma implementação em produção, a Vercel documenta vercel deploy como uma implementação de pré-visualização com variáveis Preview. Reveja o código alterado e a compilação local, implemente a pré-visualização e registe o respetivo URL e identificador no painel:

Terminal
vercel deploy
vercel curl / --deployment <preview-url>
vercel logs --deployment <preview-deployment-id> --level error

Verifique o painel alterado num navegador com dados de teste aprovados, as suas rotas, os acessos previstos e a recusa de utilizadores. Quando o responsável aprovar essa revisão para produção, implemente-a deliberadamente e repita as verificações do URL de produção, rotas, registos e visitantes:

Terminal
vercel deploy --prod
vercel curl / --deployment <production-url>
vercel logs --environment production --level error --since 5m

A produção é uma nova compilação com variáveis Production; uma pré-visualização correta não prova que essas credenciais ou percursos de dados funcionam. Se estiver ligado um repositório Git, verifique o ramo de produção configurado antes de depender de implementações automáticas, que seguem um percurso diferente destes comandos manuais.

Fontes e leituras complementares