Preguntas frecuentes y resolución de problemas

¿Es AppArch un linter?

No. Los linters miran un único archivo; AppArch mira todo el proyecto - capas, módulos, contratos. No te dirá “esta clase es larga”; te dirá “la UI te está saltando y va directa a la base de datos”.

Estoy recibiendo falsos positivos, ¿qué debo hacer?

Cada regla tiene un mecanismo except (una excepción en la definición) y un mecanismo ignore (silenciar un único hallazgo). Desde un comentario de PR puedes hacer clic en “Aceptar” con un solo toque; ArchPilot recuerda el contexto. También puedes desactivar la regla por proyecto/workspace en el panel. Consulta Escribir reglas de arquitectura.

Mi token no es válido / recibo un 401

• Asegúrate de que la variable secreta APPARCH_TOKEN está definida en CI.
• Es posible que el token se haya revocado - genera uno nuevo desde el Gestor de credenciales.
• Un token de runner está acotado a un único proyecto + módulo; asegúrate de estar usando el token del proyecto correcto.

Los comentarios llegan en el idioma equivocado

El idioma de los comentarios se configura por workspace: Ajustes → ArchPilot → Idioma de los comentarios. La parte técnica del mensaje del analizador permanece en inglés.

Recibo un aviso de límite alcanzado

El límite de proyectos/miembros proviene de tu licencia. Si necesitas uno mayor, habla con el equipo de AppArch y se emitirá un nuevo archivo de licencia (consulta Licencia y límites).

¿Está seguro nuestro código?

Sí - tu código fuente nunca sale de tu infraestructura; el análisis se ejecuta en tu propio CI. Detalles: Seguridad y privacidad.

El CI se ejecuta pero no aparece ningún comentario

• Asegúrate de que el pipeline se dispara únicamente en eventos de PR/MR.
• Verifica que el módulo (ArchPilot) está habilitado en el workspace.
• La cuenta del bot / el usuario de la integración debe tener permiso para escribir comentarios en el repositorio.