Conceptos

​

Workspace

Un workspace agrupa usuarios, repositorios, credenciales, conectores, webhooks, API keys, configuraciones de revisión y datos de facturación. La mayoría de las pantallas de la Consola operan siempre dentro del workspace activo. El diagrama a continuación muestra cómo se relacionan estos objetos. Un workspace contiene sus miembros y su configuración, y cada repositorio es donde un pull o merge request se convierte en una revisión.

​

Repositorio

Un repositorio es la unidad donde Acrity da seguimiento a pull requests o merge requests. Cada repositorio puede heredar configuraciones del workspace o tener ajustes propios, como idioma, reglas de branch, herramienta de PM y comportamiento de revisión.

​

Revisión automatizada

Una revisión automatizada es una evaluación generada por Acrity a partir de un PR/MR autorizado. La Consola muestra el historial, el estado, los hallazgos, las sugerencias y los eventos relacionados, sin convertir el repositorio en una copia navegable del código.

​

Tiers de revisión

Acrity expone dos modos públicos de revisión: Las configuraciones se pueden definir a nivel de workspace y ajustar por repositorio cuando sea necesario.

​

Aplicación conectada

Una aplicación conectada usa el flujo oficial del proveedor, como GitHub App u OAuth, para autorizar el acceso a repositorios y herramientas externas. Es la opción preferida cuando está disponible.

​

Credencial

Una credencial es un secreto registrado por un administrador de workspace, como un token de VCS o un token de herramienta de PM. Los secretos se almacenan cifrados y no se vuelven a mostrar en texto claro después del registro.

​

Conector

Un conector es un componente instalado en el ambiente del cliente para integrar un VCS privado o self-hosted. Permite que Acrity coordine revisiones sin exigir que el token del VCS privado se almacene en la nube de Acrity.

​

Webhook saliente

Un webhook saliente es una notificación enviada por Acrity a sistemas externos cuando ocurren eventos relevantes en el workspace. El destino puede validar el origen con una firma HMAC.

​

API key

Una API key habilita el acceso programático a recursos públicos de la API de Acrity. Cada clave debe tener alcances mínimos, una expiración adecuada y restricción por IP cuando sea posible.

​

Audit Trail

Audit Trail centraliza eventos técnicos y administrativos visibles para un administrador de workspace (los administradores de plataforma también tienen acceso), ayudando a diagnosticar conexiones, webhooks, estados de repositorio y eventos técnicos de revisión. Da seguimiento a las revisiones en el dashboard Ops; usa Audit Trail solo para detalles técnicos de eventos y diagnósticos.