FAQ et dépannage

AppArch est-il un linter ?

Non. Les linters examinent un seul fichier ; AppArch examine l’ensemble du projet - couches, modules, contrats. Il ne dira pas « cette classe est trop longue » ; il dira « l’UI vous contourne et accède directement à la base de données ».

J’obtiens des faux positifs, que dois-je faire ?

Chaque règle dispose d’un mécanisme except (une exemption dans la définition) et d’un mécanisme ignore (faire taire un seul constat). Depuis un commentaire de PR, vous pouvez cliquer sur « Accepter » d’un seul geste ; ArchPilot retient le contexte. Vous pouvez également désactiver la règle par projet/espace de travail dans le panneau. Voir Écrire des règles d’architecture.

Mon token est invalide / j’obtiens une erreur 401

• Assurez-vous que la variable secrète APPARCH_TOKEN est définie dans la CI.
• Le token a peut-être été révoqué - générez-en un nouveau depuis le Gestionnaire d’identifiants.
• Un token de runner est limité à un seul projet + module ; assurez-vous d’utiliser le token du bon projet.

Les commentaires arrivent dans la mauvaise langue

La langue des commentaires se définit par espace de travail : Paramètres → ArchPilot → Langue des commentaires. La partie technique du message de l’analyseur reste en anglais.

J’obtiens un avertissement de limite atteinte

La limite de projets/membres provient de votre licence. S’il vous en faut une plus élevée, contactez l’équipe AppArch : un nouveau fichier de licence vous sera émis (voir Licence et limites).

Notre code est-il en sécurité ?

Oui - votre code source ne quitte jamais votre infrastructure ; l’analyse s’exécute dans votre propre CI. Détails : Sécurité et confidentialité.

La CI s’exécute mais aucun commentaire n’apparaît

• Assurez-vous que le pipeline n’est déclenché que sur les événements PR/MR.
• Vérifiez que le module (ArchPilot) est activé dans l’espace de travail.
• Le compte bot / l’utilisateur d’intégration doit avoir la permission d’écrire des commentaires sur le dépôt.