Solo las líneas que cambiaste
La deuda antigua del mismo archivo la sigue midiendo ArchScan, pero nunca se convierte en ruido de revisión en tu merge request.
- Nueva infracción: comentada
- Deuda existente: sin comentario
Un arquitecto senior en cada pull request.
ArchPilot actúa en cuanto se abre un pull/merge request, lee el código modificado según tus reglas de arquitectura y deja la corrección como comentario de revisión en línea.
Pantallas de una instalación en funcionamiento
El recorrido de un merge request
Seis pasos entre tu CI y el panel de AppArch, ambos dentro de tu red. El repositorio nunca se sube; solo viajan los hallazgos.
- CI y Git
Se abre un merge request
Un MR nuevo, o un push nuevo sobre él, inicia tu pipeline.
- CI y Git
Arranca el job del analizador
Descarga el conjunto de reglas del panel, con los ajustes de proyecto y espacio ya aplicados.
- CI y Git
Solo se leen los archivos modificados
En modo revisión, el analizador identifica primero los archivos modificados y solo lee esos.
- Panel de AppArch
Los hallazgos van al panel
Regla, archivo, línea y mensaje van al panel; el repositorio en sí nunca se sube.
- Panel de AppArch
Nuevo, repetido o corregido
El panel compara con la ejecución anterior: los hallazgos nuevos reciben un comentario, los repetidos no se vuelven a publicar y los corregidos se resuelven.
- CI y Git
Llegan comentarios y resumen
Comentarios en línea sobre las líneas exactas y una sección AppArch con los totales en la descripción del MR.
Compuerta opcional: elige una severidad fail-on en el panel; cuando un hallazgo la alcanza, el job termina con el código 4, después de enviar los resultados, y el pipeline se pone en rojo.
Anatomía de un comentario
Cada comentario responde a las mismas cinco preguntas y se ve igual en los cuatro proveedores Git.
-
Regla y severidad
Qué regla y qué tan grave. La severidad determina la puntuación y la compuerta opcional.
-
La línea exacta
El comentario va en la línea que rompe la regla, nunca en una anotación encima.
-
Por qué importa
El razonamiento, para que corregir sea una decisión y no una suposición.
-
Sugerencia
Qué cambiar, tal como lo sugiere el analizador.
-
Detalles de la regla
Un enlace a la página de documentación de la regla.
La vida de un hallazgo en un merge request
Un comentario por hallazgo, del primer push al último. Cada hallazgo se cierra por separado: corregido o cerrado por una persona.
- EncontradoEl push que lo introduce: un comentario en línea.
- Sigue ahíPushes posteriores: el comentario se queda, sin duplicados.
- CorregidoLa línea ya no rompe la regla: el comentario se resuelve.Cerrado a manoUna persona lo cierra: cuenta como descartado, nunca como corregido.
Cuatro proveedores Git, un solo comportamiento
Los comentarios se publican desde el usuario de integración predeterminado o desde una cuenta de bot dedicada al workspace.
GitHub GitLab Bitbucket Azure DevOps
Qué hay bajo el capó
ArchPilot no es un linter - se comporta como un arquitecto que se adapta al flujo de su equipo sin ruido.
Comentarios de revisión en línea
El hallazgo aparece en la línea exacta - explicando qué está mal, por qué y la corrección sugerida, igual que un revisor humano. Puede responder en el hilo para debatir.
Análisis acotado al diff
Solo se revisa el código modificado en ese PR/MR. La deuda heredada nunca se convierte en ruido - el equipo se centra solo en el riesgo que introduce ahora.
Sin duplicados y resuelto automáticamente
Los comentarios se indexan por marcador: el mismo hallazgo nunca se vuelve a publicar en cada push y las infracciones corregidas se resuelven automáticamente. El PR se mantiene limpio y legible.
Cuenta de bot dedicada + idioma de comentarios
Los comentarios se publican desde el usuario de integración predeterminado o desde una cuenta de bot dedicada al workspace. Usted elige el idioma de comentarios por workspace (EN/TR).
Revisiones manuales bajo demanda
Active una revisión de un MR específico directamente desde el panel. ArchPilot verifica primero el acceso ("¿puedo leerlo?") y luego ejecuta la revisión en su propio pipeline de CI.
Sincronización de desarrolladores y puntuación
Los miembros de Git y los autores de MR se sincronizan automáticamente; las cuentas de servicio/bot se marcan automáticamente (y son editables). Cada desarrollador obtiene una puntuación basada en ArchPilot.
Anulación de reglas por proyecto
Active, desactive o ajuste reglas por proyecto o workspace. Las reglas que desactiva en el panel nunca llegan al bot - sin falsos positivos.
Se ejecuta en su propio CI
El análisis se ejecuta en su propio CI, en su propia infraestructura - su código fuente nunca sale de ella; solo se envían los hallazgos al panel.
Míralo en el producto
Todas las capturas
Obtenga su primera revisión hoy
Conecte Git, active las reglas y deje que ArchPilot intervenga en el próximo PR.