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
1
Abrir conexão
Acesse
Console > Repositórios > Conectar repositório.2
Escolher origem
Selecione aplicativo conectado, credencial manual ou conector local.
3
Selecionar repositórios
Escolha os repositórios disponíveis ou informe os nomes conforme a origem escolhida.
4
Configurar PM
Opcionalmente associe provedor de gerenciamento de tarefas e campos de extração.
5
Revisar regras
Configure branches, comportamento para drafts, checks e idioma quando necessário.
6
Salvar
Salve e acompanhe o status de prontidão na lista ou no detalhe do repositório.
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 doARCHITECTURE.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.
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.
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,developou 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.
- 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.
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.
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.
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:1
Copiar o webhook de entrada
Abra a página de detalhe do repositório e vá até a seção Webhook de VCS. Copie a URL do webhook de entrada e a chave de assinatura.
2
Adicionar o webhook no seu provedor
Nas configurações do seu provedor de VCS, crie um webhook. Cole a URL no campo de payload ou target URL e a chave no campo de secret.
3
Selecionar eventos
Assine os eventos de pull request ou merge request para que o provedor notifique a Acrity quando um PR/MR for aberto ou atualizado.
4
Revalidar
Volte à seção Webhook de VCS e revalide. A Acrity confirma que consegue receber eventos antes de o repositório ficar Pronto.
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 emSegurança > Tratamento de dados.