> ## 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.

# Flujo de revisión

> Del repositorio conectado al resultado del review en el dashboard Ops y el proveedor de código.

El flujo de revisión de Acrity comienza cuando un workspace conecta un repositorio y termina con una decisión auditable en el dashboard Ops y, cuando está configurado, en el proveedor de código o la herramienta PM.

## El flujo de revisión de un vistazo

```mermaid theme={null}
flowchart TD
    A["Evento de PR/MR"] --> B["Webhook entrante de VCS"]
    B --> C["Recepción"]
    C --> D{"Control de política"}
    D -->|"Regla de branch o autor bloqueado"| S["Omitido, sin review"]
    D -->|"Elegible"| E{"Tier de review"}
    E -->|"Fast"| F["Ejecución de review"]
    E -->|"Deep"| F
    F --> G["Publicar en checks y comentarios de VCS, y herramienta PM"]
    G --> H["Dar seguimiento en el dashboard Ops"]
    C -.-> T["Audit Trail (diagnóstico)"]
    D -.-> T
    F -.-> T
    G -.-> T
```

## Vista general

<Steps>
  <Step title="Conectar proveedores">
    Configura VCS y, si es necesario, PM en `Aplicaciones conectadas`, `Credenciales` o `Connectors`.
  </Step>

  <Step title="Conectar repositorios">
    Accede a `Repositorios`, selecciona los repositorios autorizados y vincula credenciales o instalaciones.
  </Step>

  <Step title="Configurar política">
    Ajusta idioma, tiers de review, reglas de branch, autores bloqueados e instrucciones adicionales.
  </Step>

  <Step title="Recibir evento de PR/MR">
    El proveedor envía un evento a Acrity cuando ocurre un cambio relevante.
  </Step>

  <Step title="Ejecutar review">
    Acrity evalúa el cambio conforme a las políticas del workspace y del repositorio.
  </Step>

  <Step title="Publicar y auditar">
    El resultado aparece en la Console y puede publicarse en el proveedor de código o la herramienta PM.
  </Step>
</Steps>

<Note>
  Repositorios, Policy Engine, Credenciales, Connectors, Webhooks, API Keys y Audit Trail requieren un administrador de workspace. Los administradores de plataforma también tienen acceso. Estos roles son conjuntos de capacidades fijos definidos por Acrity.
</Note>

## Configuraciones que influyen en el review

| Configuración                 | Lugar                         | Efecto                                                                                            |
| ----------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------- |
| Idioma del workspace          | `Configuración del workspace` | define el idioma predeterminado de respuestas y comentarios; puede sobrescribirse por repositorio |
| Política global de review     | `Policy Engine`               | aplica tiers a nivel de workspace e instrucciones predeterminadas                                 |
| Configuración por repositorio | `Repositorios` > detalle      | sobrescribe partes de la política para un repositorio                                             |
| Reglas de branch              | detalle del repositorio       | evita reviews en flujos que no necesitan analizarse                                               |
| Autores bloqueados            | `Policy Engine`               | ignora autores que no deben generar reviews                                                       |
| Bots permitidos               | `Policy Engine`               | permite review de automatizaciones específicas cuando se desea                                    |
| PM integrado                  | detalle del repositorio       | permite asociar tareas y publicar contexto en el sistema de gestión                               |

## Dónde dar seguimiento

Da seguimiento al review en el [dashboard Ops](/en/guides/ops-dashboard). Usa Audit Trail solo para detalles técnicos del evento y diagnóstico.

| Pantalla                | Qué verificar                                                        |
| ----------------------- | -------------------------------------------------------------------- |
| dashboard Ops           | estado del review, decisión, hallazgos y seguimiento operativo       |
| `Overview`              | salud general del workspace                                          |
| `Repositorios`          | readiness, credenciales, webhooks, último review y alertas           |
| detalle del repositorio | configuración, PM, review, bootstrap y security scans                |
| `Audit Trail`           | detalles técnicos del evento, diagnóstico y auditoría administrativa |
| proveedor de código     | checks, comentarios y status publicados por Acrity                   |

## Pausar o retomar reviews

En el detalle del repositorio, un administrador de workspace puede pausar reviews para mantenimiento, migración o investigación. Mientras esté pausado, los nuevos cambios no siguen el flujo normal de review. Retoma cuando credenciales, webhooks y políticas estén validados.

## Buenas prácticas

* Empieza con pocos repositorios críticos y valida el comportamiento antes de ampliar.
* Documenta excepciones en el propio repositorio cuando sean específicas de ese código.
* Usa reglas de branch para evitar reviews en merges mecánicos o branches de sincronización.
* Configura idioma y PM antes del primer uso en equipos grandes.
* Usa `Audit Trail` solo cuando necesites detalles técnicos del evento, diagnóstico o contexto de auditoría administrativa.
