Conceitos

​

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.

​

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: 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; use o Audit Trail apenas para detalhes técnicos de eventos e diagnóstico.