> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acrity.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Fluxo de review

> Do repositório conectado ao resultado do review no dashboard Ops e no provedor de código.

O fluxo de review da Acrity começa quando um workspace conecta um repositório e termina com uma decisão auditável no dashboard Ops e, quando configurado, no provedor de código ou na ferramenta de PM.

## Fluxo de review em resumo

```mermaid theme={null}
flowchart TD
    A["Evento de PR/MR"] --> B["Webhook de entrada do VCS"]
    B --> C["Recepção"]
    C --> D{"Gate de política"}
    D -->|"Regra de branch ou autor bloqueado"| S["Ignorado, sem review"]
    D -->|"Elegível"| E{"Tier de review"}
    E -->|"Rápido"| F["Execução do review"]
    E -->|"Profundo"| F
    F --> G["Publicar em checks e comentários do VCS e na ferramenta de PM"]
    G --> H["Acompanhar no dashboard Ops"]
    C -.-> T["Audit Trail (diagnóstico)"]
    D -.-> T
    F -.-> T
    G -.-> T
```

## Visão geral

<Steps>
  <Step title="Conectar provedores">
    Configure VCS e, se necessário, PM em `Aplicativos conectados`, `Credenciais` ou `Conectores`.
  </Step>

  <Step title="Conectar repositórios">
    Acesse `Repositórios`, selecione os repositórios autorizados e vincule credenciais ou instalações.
  </Step>

  <Step title="Configurar política">
    Ajuste idioma, tiers de review, regras de branch, autores bloqueados e instruções adicionais.
  </Step>

  <Step title="Receber evento de PR/MR">
    O provedor envia um evento para a Acrity quando uma mudança relevante acontece.
  </Step>

  <Step title="Executar review">
    A Acrity avalia a mudança conforme as políticas do workspace e do repositório.
  </Step>

  <Step title="Publicar e auditar">
    O resultado aparece no Console e pode ser publicado no provedor de código ou na ferramenta de PM.
  </Step>
</Steps>

<Note>
  Repositórios, Policy Engine, Credenciais, Conectores, Webhooks, API Keys e Audit Trail exigem um admin de Workspace. Esses papéis são conjuntos fixos de capacidades definidos pela Acrity.
</Note>

## Configurações que influenciam o review

| Configuração                 | Local                    | Efeito                                                                                  |
| ---------------------------- | ------------------------ | --------------------------------------------------------------------------------------- |
| Idioma do workspace          | `Workspace Settings`     | define o idioma padrão de respostas e comentários; pode ser sobrescrito por repositório |
| Política global de review    | `Policy Engine`          | aplica tiers e instruções padrão no nível do workspace                                  |
| Configuração por repositório | `Repositórios` > detalhe | sobrescreve partes da política para um repositório                                      |
| Regras de branch             | detalhe do repositório   | evita reviews em fluxos que não precisam de análise                                     |
| Autores bloqueados           | `Policy Engine`          | ignora autores que não devem gerar reviews                                              |
| Bots permitidos              | `Policy Engine`          | permite review de automações específicas quando desejado                                |
| PM integrado                 | detalhe do repositório   | permite associar tarefas e publicar contexto no sistema de gestão de trabalho           |

## Onde acompanhar

Acompanhe o review no [dashboard Ops](/en/guides/ops-dashboard). Use o Audit Trail apenas para detalhes técnicos de eventos e diagnóstico.

| Tela                   | O que verificar                                                      |
| ---------------------- | -------------------------------------------------------------------- |
| dashboard Ops          | status do review, decisão, achados e acompanhamento operacional      |
| `Overview`             | saúde geral do workspace                                             |
| `Repositórios`         | prontidão, credenciais, webhooks, último review e alertas            |
| detalhe do repositório | configuração, PM, review, bootstrap e security scans                 |
| `Audit Trail`          | detalhes técnicos de eventos, diagnóstico e auditoria administrativa |
| provedor de código     | checks, comentários e status publicados pela Acrity                  |

## Pausar ou retomar reviews

Na página de detalhe do repositório, um admin de Workspace pode pausar reviews para manutenção, migração ou investigação. Enquanto pausado, novas mudanças não seguem o fluxo normal de review. Retome quando credenciais, webhooks e políticas estiverem validados.

## Boas práticas

* Comece com poucos repositórios críticos e valide o comportamento antes de expandir.
* Documente exceções no próprio repositório quando forem específicas daquele código.
* Use regras de branch para evitar reviews em merges mecânicos ou branches de sincronização.
* Configure idioma e PM antes do primeiro uso em times grandes.
* Use o `Audit Trail` apenas quando precisar de detalhes técnicos de eventos, diagnóstico ou contexto de auditoria administrativa.