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

# Conceitos

> Entenda os conceitos públicos usados no Console da Acrity.

## Workspace

Um workspace agrupa usuários, repositórios, credenciais, conectores, webhooks, API keys, configurações de review e dados de cobrança. A maioria das telas do Console trabalha sempre dentro do workspace ativo.

O diagrama abaixo mostra como esses objetos se relacionam. Um workspace mantém seus membros e sua configuração, e cada repositório é onde um pull ou merge request se torna um review.

```mermaid theme={null}
graph TD
    Workspace --> Repositories
    Workspace --> Credentials
    Workspace --> Connectors
    Workspace --> Webhooks
    Workspace --> APIKeys["API keys"]
    Workspace --> Policy
    Workspace --> Billing
    Workspace --> Members
    Repositories --> Request["Pull / merge request"]
    Request --> Review
```

## Repositório

Um repositório é a unidade onde a Acrity acompanha pull requests ou merge requests. Cada repositório pode herdar configurações do workspace ou ter ajustes próprios, como idioma, regras de branch, ferramenta PM e comportamento de review.

## Review automatizado

Um review automatizado é uma avaliação gerada pela Acrity a partir de um PR/MR autorizado. O Console mostra histórico, status, achados, sugestões e eventos relacionados sem transformar o repositório em uma cópia navegável do código.

## Tiers de review

Acrity expõe dois modos públicos de review:

| Tier | Quando usar                                                                 |
| ---- | --------------------------------------------------------------------------- |
| Fast | Feedback mais rápido para mudanças comuns e fluxo contínuo.                 |
| Deep | Análise mais abrangente para mudanças sensíveis, maiores ou de maior risco. |

As configurações podem ser definidas no workspace e ajustadas por repositório quando necessário.

## Aplicativo conectado

Um aplicativo conectado usa o fluxo oficial do provedor, como GitHub App ou OAuth, para autorizar acesso a repositórios e ferramentas externas. É a opção preferencial quando disponível.

## Credencial

Uma credencial é um segredo cadastrado por um Admin de workspace, como token de VCS ou ferramenta PM. Segredos são armazenados criptografados e não são exibidos novamente em texto claro depois do cadastro.

## Conector

Um conector é um componente instalado no ambiente do cliente para integrar VCS privado ou self-hosted. Ele permite que a Acrity coordene reviews sem exigir que o token do VCS privado seja armazenado na nuvem da Acrity.

## Webhook de saída

Webhook de saída é uma notificação enviada pela Acrity para sistemas externos quando eventos relevantes acontecem no workspace. O destino pode validar a origem usando assinatura HMAC.

## API key

API key permite acesso programático a recursos públicos da API Acrity. Cada chave deve ter escopos mínimos, expiração adequada e, quando possível, restrição por IP.

## Audit Trail

O Audit Trail centraliza eventos técnicos e administrativos visíveis para um Admin de workspace, ajudando a diagnosticar conexões, webhooks, estados de repositório e eventos técnicos de review. Acompanhe os reviews no [dashboard Ops](/pt-BR/guides/ops-dashboard); use o Audit Trail apenas para detalhes técnicos de eventos e diagnóstico.