FAQ und Fehlerbehebung

Ist AppArch ein Linter?

Nein. Linter betrachten eine einzelne Datei; AppArch betrachtet das gesamte Projekt - Schichten, Module, Verträge. Es sagt nicht „diese Klasse ist lang“; es sagt „die UI umgeht Sie und greift direkt auf die DB zu“.

Ich erhalte False Positives, was soll ich tun?

Jede Regel verfügt über einen except-Mechanismus (eine Ausnahme in der Definition) und einen ignore-Mechanismus (das Stummschalten eines einzelnen Befunds). Aus einem PR-Kommentar heraus können Sie mit einem Tippen auf „Akzeptieren“ klicken; ArchPilot merkt sich den Kontext. Sie können die Regel auch pro Projekt/Workspace im Panel deaktivieren. Siehe Architekturregeln schreiben.

Mein Token ist ungültig / ich erhalte einen 401

• Stellen Sie sicher, dass die geheime Variable APPARCH_TOKEN in der CI definiert ist.
• Das Token wurde möglicherweise widerrufen - erzeugen Sie ein neues über den Credential Manager.
• Ein Runner-Token ist auf ein einzelnes Projekt + Modul beschränkt; stellen Sie sicher, dass Sie das Token für das richtige Projekt verwenden.

Kommentare kommen in der falschen Sprache an

Die Kommentarsprache wird pro Workspace festgelegt: Einstellungen → ArchPilot → Kommentarsprache. Der technische Teil der Analyzer-Meldung bleibt auf Englisch.

Ich erhalte eine Warnung, dass das Limit erreicht ist

Das Projekt-/Mitgliederlimit kommt aus Ihrer Lizenz. Brauchen Sie ein höheres, sprechen Sie mit dem AppArch-Team - Sie erhalten eine neue Lizenzdatei (siehe Lizenz und Limits).

Ist unser Code sicher?

Ja - Ihr Quellcode verlässt niemals Ihre Infrastruktur; die Analyse läuft in Ihrer eigenen CI. Details: Sicherheit und Datenschutz.

CI läuft, aber es erscheint kein Kommentar

• Stellen Sie sicher, dass die Pipeline nur bei PR/MR-Ereignissen ausgelöst wird.
• Überprüfen Sie, ob das Modul (ArchPilot) im Workspace aktiviert ist.
• Das Bot-Konto / der Integrationsbenutzer muss die Berechtigung haben, Kommentare im Repo zu schreiben.