# Einrichtung des KI-Assistenten in PhpStorm

## Übersicht

Diese Anleitung beschreibt, wie der KI-Assistent in PhpStorm eingerichtet wird, um automatisch die Projekt-Guidelines zu verwenden.

## Methode 1: Über die PhpStorm-Einstellungen

1. Öffne PhpStorm und gehe zu **Settings/Preferences**
   - Windows/Linux: File → Settings
   - macOS: PhpStorm → Preferences

2. Navigiere zu **Tools** → **AI Assistant** → **Custom Instructions**

3. Aktiviere die Option **Use custom instructions**

4. Füge in das Textfeld den Inhalt aus der Datei `/docs/ai/GUIDELINES-FÜR-AI-ASSISTANT.md` ein
   - Alternativ kannst du auf einen relativen Pfad verweisen

5. Aktiviere die Option **Apply project-specific instructions**, damit diese Einstellungen nur für dieses Projekt gelten

6. Klicke auf **Apply** und dann auf **OK**

## Methode 2: Über die Projektkonfiguration (empfohlen)

Die `.idea/aiAssistant.xml`-Datei ist bereits im Projekt enthalten und konfiguriert den KI-Assistenten automatisch mit den richtigen Einstellungen. Wenn du das Projekt öffnest, sollte der KI-Assistent bereits korrekt eingerichtet sein.

Um zu überprüfen, ob die Einstellungen korrekt übernommen wurden:

1. Öffne die PhpStorm-Einstellungen wie oben beschrieben
2. Navigiere zu **Tools** → **AI Assistant** → **Custom Instructions**
3. Überprüfe, ob **Use custom instructions** aktiviert ist und die Guidelines angezeigt werden

## Testen der Einrichtung

Um zu testen, ob der KI-Assistent die Guidelines korrekt anwendet:

1. Öffne eine PHP-Datei im Projekt
2. Drücke `Alt+A` (Windows/Linux) oder `Option+A` (macOS) um den KI-Assistenten zu öffnen
3. Bitte den Assistenten, eine neue Klasse zu erstellen
4. Überprüfe, ob die generierte Klasse den Guidelines entspricht:
   - Sie sollte als `final` und wenn möglich `readonly` deklariert sein
   - Constructor Property Promotion sollte verwendet werden
   - Es sollten keine externen Abhängigkeiten importiert werden

## Fehlerbehebung

Falls die Guidelines nicht korrekt angewendet werden:

1. Stelle sicher, dass du die neueste Version von PhpStorm verwendest
2. Überprüfe, ob die AI Assistant-Funktion aktiviert ist
3. Versuche, das Projekt neu zu öffnen
4. Führe einen Cache-Clear in PhpStorm durch: File → Invalidate Caches