Documentação

Evidência de revisão

Implantações de pré-visualização, varreduras, cobertura e resultados de testes são anexados ao pull request que descrevem.

Evidência de revisão É a prova de verificação anexada ao pull request ao qual pertence: uma pré-visualização que pode ser aberta, um resultado de varredura, uma variação de cobertura ou uma execução de navegador gravada.

O princípio é simples: a evidência e o código que descreve devem chegar juntos. Um resultado de varredura em um painel separado que ninguém abre não é evidência; é apenas uma tarefa pendente.

O que pode ser anexado

Coroid se integra com Provedores de diversas categorias:

CategoriaProvedores
Nativo do GitAmbientes do GitHub Actions, Aplicativos de Revisão do GitLab
Hospedagem estáticaVercel, Netlify, Cloudflare Pages, AWS Amplify
Pré-visualizações completasRender, Railway, Heroku Review Apps, Fly.io, Northflank, Qovery, Porter
Distribuição móvelExpo EAS, TestFlight, Testes internos do Google Play
Revisão e varreduraCodeRabbit, Qodo / Agente do PR, Greptile, Cursor Bugbot, SonarQube Cloud, Snyk, Semgrep
Cobertura e visualCodecov, Chromatic, Percy
Testes end-to-end e monitoramentoCypress Cloud, Checkly, Maestro, BrowserStack
PersonalizadoWebhook de evidência personalizado

São trinta e um Provedores no total. O webhook de evidência personalizado cobre tudo o que não está na lista.

Cada Provedor indica quais tipos de evidência pode gerar — pré-visualização web, compilação móvel, Revisão do AI, varredura de segurança, cobertura, revisão visual, testes end-to-end e desempenho — e como o Coroid a consome, seja pela interface do git, pela saída da CI ou chamando diretamente o API do Provedor.

Você provavelmente já possui a maior parte disso

Esse é o objetivo. Equipes que adotam o Coroid geralmente já contam com implantações de pré-visualização, um scanner e relatórios de cobertura. A evidência de revisão conecta o que já existe em vez de substituí-lo.

Configure os Provedores nas configurações de conexão da organização; a evidência será então anexada automaticamente às pull requests abertas pelo Coroid.

Evidência e portas

Evidência e portas são relacionadas, mas distintas:

  • Evidência é informação anexada para que um ser humano a analise.
  • Uma porta é uma decisão imposta pelo sistema.

A evidência pode alimentar uma porta — uma porta de limite de cobertura lê a evidência de cobertura — mas a maior parte da evidência é apenas informação. Nem tudo o que merece ser visto justifica bloquear algo.

Escolhendo o que anexar

Mais evidência não significa melhor. Cada item compete pela atenção do revisor, e um pull request com quinze artefatos recebe a mesma atenção que um com três.

Anexe o que altera uma decisão:

  • uma pré-visualização sempre que a alteração for visível para o usuário
  • cobertura quando a variação for relevante
  • varredura de segurança em qualquer coisa que envolva manipulação de entrada, autenticação ou dependências
  • diferenças visuais em trabalhos com sistemas de design e componentes