Repositórios

Repositórios são o centro operacional da Acrity. Eles definem como pull requests ou merge requests são analisados, quais provedores são usados e quais exceções se aplicam a cada projeto. Use Console > Repositórios para listar, conectar, configurar, pausar, validar e remover repositórios. Acompanhe status de revisão, decisões e achados no painel de Ops. Use Console > Audit Trail apenas para detalhes técnicos de eventos, diagnóstico e auditoria administrativa.

​

Quem pode acessar

Repositórios exigem um admin de workspace. Os papéis são conjuntos fixos de capacidades definidos pela Acrity, não configuráveis pela sua organização.

​

Conectar repositórios

​

Métodos de conexão

​

Estados de prontidão

Um repositório precisa alcançar o estado Pronto antes que a Acrity analise seus pull requests ou merge requests. Acompanhe o estado atual na lista de repositórios e na página de detalhe do repositório. O bootstrap do ARCHITECTURE.md é obrigatório, não opcional. Até ser mesclado, o repositório permanece em Aguardando merge da arquitetura e não recebe revisões.

​

Tela de lista

A lista de repositórios ajuda a identificar:

• repositórios conectados;
• estado de prontidão;
• provedor VCS;
• método de autenticação;
• última validação;
• alertas de webhook, credencial ou conector;
• repositórios que exigem ação antes de receber revisões.

Use filtros e busca para localizar projetos rapidamente. A lista de repositórios pode mostrar dicas operacionais, mas o painel de Ops é o lugar principal para acompanhar o progresso e os resultados das revisões.

​

Detalhe do repositório

A página de detalhe concentra as configurações do projeto.

​

Idioma do repositório

O idioma do repositório sobrescreve o padrão do workspace para aquele projeto. Use quando:

• uma equipe trabalha em idioma diferente do restante do workspace;
• repositórios de clientes exigem respostas localizadas;
• comentários de revisão precisam seguir padrão de comunicação específico.

Se não houver idioma configurado no repositório, a Acrity usa o padrão do workspace.

​

Regras de branch

Regras de branch ajudam a evitar revisões em cenários que não precisam de análise ou que geram ruído. Configurações comuns:

• branches raiz ou principais, como main, master, develop ou equivalentes;
• ignorar merges entre branches raiz;
• regras para ignorar combinações específicas de origem e destino;
• correspondência por texto exato, prefixo, sufixo, trecho ou padrão configurado;
• revisão de PR/MR em draft;
• comportamento quando checks do provedor indicam sucesso.

​

Integração com PM

A integração de PM permite que a Acrity relacione PRs/MRs a tarefas, critérios de aceite e contexto de produto. Campos comuns:

• identificador da tarefa;
• critérios de aceite;
• story points;
• sprint;
• épico;
• prioridade;
• componente;
• labels;
• campo de fallback quando a informação principal não está disponível.

Fontes comuns para extração:

• nome da branch;
• título do PR/MR;
• descrição do PR/MR;
• comentários quando habilitados pela configuração.

​

Configuração de review por repositório

A configuração do repositório deve ser usada para exceções ao padrão do workspace. Use quando:

• um projeto exige instruções diferentes;
• um repositório precisa de apenas um tier de revisão;
• a equipe tem convenções específicas;
• a saída de revisão deve usar linguagem ou foco diferente.

Evite duplicar no repositório o que já está bem definido no Console > Policy Engine.

​

Pausar e retomar reviews

Pausar reviews impede novas análises automáticas para o repositório enquanto a pausa estiver ativa. Use pausa quando:

• o repositório está em migração;
• o provedor está instável;
• credenciais estão sendo rotacionadas;
• a equipe quer interromper revisões por uma janela planejada;
• regras precisam ser revisadas antes de continuar.

Retome assim que a causa for resolvida.

​

Webhook de VCS

O webhook de VCS permite que eventos do provedor acionem a Acrity. Pelo Console, você pode:

• configurar webhook quando o provedor e método de conexão permitirem;
• revalidar webhook;
• revisar status de configuração;
• identificar pendências de permissão ou segredo.

Se o provedor for acessado por conector local, siga também a documentação de Console > Conectores.

​

Como as revisões são disparadas

A Acrity inicia uma revisão quando o seu provedor envia um evento de pull request ou merge request para o webhook de VCS de entrada da Acrity. Para conexões via aplicativo conectado, a Acrity registra o webhook para você. Para conexões com credencial manual e conector local, você mesmo cola o webhook no provedor:

​

Bootstrap de arquitetura

A aba Bootstrap ajuda a preparar uma documentação de arquitetura para o repositório quando o fluxo estiver disponível. Use para:

• verificar se o repositório já tem documentação de arquitetura;
• iniciar geração assistida;
• revisar o material proposto;
• escolher branch alvo quando aplicável;
• concluir o fluxo com ou sem commit, conforme opção exibida;
• repetir ou reiniciar quando a tela indicar que é permitido.

​

Security scans

Quando habilitado, o repositório pode exibir informações de varreduras de segurança e dependências. Use a tela para acompanhar último scan, próxima execução e ações disponíveis. Detalhes de dados e segurança ficam em Segurança > Tratamento de dados.

​

Problemas comuns