KI Unterstützung

15 minutes ANFÄNGER

Erfahren Sie, wie Sie KI Assistenten wie Cursor AI und GitHub Copilot für die nahtlose Arbeit mit GEMVC konfigurieren. Entdecken Sie die integrierten KI Unterstützungsdateien von GEMVC und wie sie bei der Generierung von korrektem, typ sicherem Code helfen.

What You'll Learn

KI Assistent Setup

Cursor AI und GitHub Copilot konfigurieren

KI Unterstützungsdateien

Verfügbare KI Kontextdateien verstehen

Code Generierung

Wie KI Assistenten bei der Generierung von GEMVC Code helfen

Video Coming Soon...

Was ist GEMVC KI Unterstützung?

GEMVC wird mit **umfassenden KI Unterstützungsdateien** geliefert, die KI Assistenten (wie Cursor AI, GitHub Copilot, Claude usw.) helfen, die Framework Architektur zu verstehen und korrekten Code zu generieren. Diese Dateien bringen KI Assistenten die 4-Schichten Architektur, Sicherheitsfunktionen und Codierungs Muster von GEMVC bei.

  • **Automatische Code Generierung** - KI Assistenten können vollständige CRUD Operationen nach GEMVC Mustern generieren
  • **Typ sicherer Code** - KI versteht die PHPStan Level 9 Anforderungen und generiert typ sicheren Code
  • **Korrekte Architektur** - KI kennt die obligatorische 4-Schichten Architektur und überspringt keine Schichten
  • **Sicherheitsbewusstsein** - KI versteht, dass 90% der Sicherheit automatisch sind
  • **Framework Spezifisch** - KI weiß, dass GEMVC NICHT Laravel oder Symfony ist

**Wichtiger Punkt:** GEMVC bietet **spezialisierte KI Unterstützungsdateien**, die KI Assistenten beibringen, korrekten GEMVC Code zu generieren. Diese Dateien werden automatisch in Ihr Projekt aufgenommen, wenn Sie gemvc init ausführen.

1 1475

Wie KI Unterstützung funktioniert

KI Assistenten Dateien

GEMVC bietet mehrere KI Unterstützungsdateien, die während gemvc init automatisch in Ihr Projekt Stammverzeichnis kopiert werden. Jedes KI Tool liest unterschiedliche Dateien:

Für Cursor AI

**Primäre Datei:** .cursorrules

Cursor AI lädt .cursorrules automatisch aus Ihrem Projekt Stammverzeichnis. Diese Datei enthält umfassende Framework Regeln, Code Muster und Beispiele, die Cursor verwendet, um korrekten GEMVC Code zu generieren.

Für GitHub Copilot

**Primäre Dateien:**

  • GEMVC_GUIDE.md - Code Generierungs Muster
  • COPILOT_INSTRUCTIONS.md - Kurzanleitungen
  • GEMVC_PHPDOC_REFERENCE.php - PHPDoc Annotationen für Type Hints

Copilot liest Markdown Dateien in Ihrem Projekt Stammverzeichnis und verwendet PHPDoc Annotationen für die Code Vervollständigung.

Für alle KI Assistenten

**Referenzdateien:**

  • AI_CONTEXT.md - Kurzübersicht
  • AI_API_REFERENCE.md - Komplette API Dokumentation
  • QUICK_START_AI.md - Master Anweisungen für KI Assistenten
  • gemvc-api-reference.jsonc - Strukturierte Framework Daten
2

Cursor AI einrichten

Automatische Konfiguration

Cursor AI wird **automatisch konfiguriert**, wenn Sie ein GEMVC Projekt initialisieren. Die Datei .cursorrules wird in Ihrem Projekt Stammverzeichnis erstellt und Cursor lädt sie automatisch.

Was automatisch geschieht:

  1. 1. Führen Sie gemvc init aus, um Ihr Projekt zu initialisieren
  2. 2. GEMVC kopiert .cursorrules in Ihr Projekt Stammverzeichnis
  3. 3. Cursor AI erkennt und lädt .cursorrules automatisch
  4. 4. Cursor versteht nun die GEMVC Architektur und Muster

Was Cursor AI lernt:

  • ✓ 4-Schichten Architektur (API → Controller → Model → Table)
  • ✓ Sicherheitsfunktionen (90% automatisch)
  • ✓ Code Generierungs Muster
  • ✓ Typensicherheits Anforderungen (PHPStan Level 9)
  • ✓ Häufig zu vermeidende Fehler
  • ✓ Methoden Signaturen und Rückgabe Typen

Beispiel: Cursor bitten, CRUD zu erstellen

Nach der Einrichtung können Sie Cursor fragen:

Sie:

"Erstelle einen Produkt CRUD Endpunkt"

Cursor AI:

Generiert alle 4 Schichten korrekt:

  • app/api/Product.php mit Schema Validierung
  • app/controller/ProductController.php mit Mapping
  • app/model/ProductModel.php mit Geschäftslogik
  • app/table/ProductTable.php mit Datenbank Operationen
3

GitHub Copilot einrichten

Automatische Konfiguration

GitHub Copilot wird **automatisch konfiguriert**, wenn Sie ein GEMVC Projekt initialisieren. Copilot liest Markdown Dateien in Ihrem Projekt Stammverzeichnis und verwendet PHPDoc Annotationen für die Code Vervollständigung.

Was automatisch geschieht:

  1. 1. Führen Sie gemvc init aus, um Ihr Projekt zu initialisieren
  2. 2. GEMVC kopiert KI Unterstützungsdateien in Ihr Projekt Stammverzeichnis:
    • GEMVC_GUIDE.md
    • COPILOT_INSTRUCTIONS.md
    • GEMVC_PHPDOC_REFERENCE.php
  3. 3. Copilot liest diese Dateien beim Codieren automatisch
  4. 4. Copilot versteht nun die GEMVC Muster und generiert korrekten Code

Was Copilot lernt:

  • ✓ Code Generierungs Muster aus GEMVC_GUIDE.md
  • ✓ Kurzanweisungen aus COPILOT_INSTRUCTIONS.md
  • ✓ Type Hints aus GEMVC_PHPDOC_REFERENCE.php
  • ✓ 4-Schichten Architektur Anforderungen
  • ✓ Sicherheits Best Practices

Beispiel: Copilot Code Vervollständigung

Wenn Sie mit der Eingabe beginnen, schlägt Copilot korrekten GEMVC Code vor:

Terminal
<?php
// Sie geben ein:
public function create(): JsonResponse
{
    if(!$this->request->define

// Copilot schlägt vor:
if(!$this->request->definePostSchema([
    'name' => 'string',
    'email' => 'email'
])) {
    return $this->request->returnResponse();
}
return (new ProductController($this->request))->create();
4

Verfügbare KI Unterstützungsdateien

Vollständige Datei Referenz

GEMVC bietet mehrere KI Unterstützungsdateien, von denen jede einem bestimmten Zweck dient:

.cursorrules (Cursor AI Primär)

**Zweck:** Umfassende Framework Regeln für Cursor AI

  • ✓ Vollständiges Framework Verständnis
  • ✓ Code Muster und Beispiele
  • ✓ DO's und DON'Ts
  • ✓ Wichtige Klassen Referenzen
  • ✓ Automatisch von Cursor geladen

GEMVC_GUIDE.md (Copilot Primär)

**Zweck:** Prägnante Anleitung zur Code Generierung

  • ✓ Quick Start Muster
  • ✓ Code Generierungs Beispiele
  • ✓ CLI Befehle Referenz
  • ✓ Wesentliche Muster

COPILOT_INSTRUCTIONS.md (Copilot Referenz)

**Zweck:** Einfache Anweisungen für GitHub Copilot

  • ✓ Kurzübersicht
  • ✓ Wesentliche Muster
  • ✓ Häufig zu vermeidende Fehler

GEMVC_PHPDOC_REFERENCE.php (Type Hints)

**Zweck:** PHPDoc Annotationen für die Code Vervollständigung

  • ✓ Korrekte Type Hints
  • ✓ Methoden Signaturen
  • ✓ Copilot freundliche Dokumentation

AI_CONTEXT.md (Kurzübersicht)

**Zweck:** Schnelle Nachschlagewerk für alle KI Assistenten

  • ✓ Framework Übersicht
  • ✓ Wesentliche Muster
  • ✓ Häufige Aufgaben
  • ✓ Kurze Beispiele

AI_API_REFERENCE.md (Komplette API Dokumente)

**Zweck:** Vollständige API Dokumentation für KI Assistenten

  • ✓ Vollständige Klassen Referenz
  • ✓ Methoden Signaturen
  • ✓ Parameter und Rückgabe Typen
  • ✓ Allgemeine Muster

QUICK_START_AI.md (Master Anweisungen)

**Zweck:** MASTER Anweisungen für KI Assistenten

  • ✓ Zwingt KI, ALLE Dokumentationen zu lesen
  • ✓ Vollständiges Architektur Verständnis
  • ✓ Code Generierungs Muster
  • ✓ Kritische Regeln und Konventionen

gemvc-api-reference.jsonc (Strukturierte Daten)

**Zweck:** Maschinen lesbare Framework Daten

  • ✓ Strukturierte Framework Metadaten
  • ✓ Programmatischer Zugriff
  • ✓ Code Generierungs Tools
5

Wie KI Assistenten helfen

Code Generierungs Beispiele

Mit konfigurierter KI Unterstützung können KI Assistenten korrekten GEMVC Code generieren, der allen Framework Mustern folgt:

Beispiel 1: Vollständiges CRUD generieren

**Sie fragen:** "Erstelle einen Produkt CRUD Endpunkt"

**KI generiert:** Alle 4 Schichten mit korrekten Mustern:

Terminal
<?php
// app/api/Product.php
class Product extends ApiService
{
    public function create(): JsonResponse
    {
        if(!$this->request->definePostSchema([
            'name' => 'string',
            'price' => 'float',
            '?description' => 'string'
        ])) {
            return $this->request->returnResponse();
        }
        return (new ProductController($this->request))->create();
    }
}

KI generiert automatisch Controller, Model und Table Schichten nach denselben Mustern!

Beispiel 2: Authentifizierung hinzufügen

**Sie fragen:** "Füge Authentifizierung zum Produkt Erstellungs Endpunkt hinzu"

**KI generiert:**

Terminal
<?php
public function create(): JsonResponse
{
    // KI weiß, dass zuerst die Authentifizierung hinzugefügt werden muss!
    if (!$this->request->auth(['admin', 'salesManager'])) {
        return $this->request->returnResponse();
    }
    
    // Dann Schema Validierung
    if(!$this->request->definePostSchema([
        'name' => 'string',
        'price' => 'float'
    ])) {
        return $this->request->returnResponse();
    }
    
    return (new ProductController($this->request))->create();
}

Beispiel 3: Typ sicherer Code

**Sie fragen:** "Erstelle eine Methode zum Abrufen des Produkts nach ID"

**KI generiert:** PHPStan Level 9 konformen Code:

Terminal
<?php
// KI weiß, dass die korrekten Rückgabe Typen verwendet werden müssen!
public function selectById(int $id): null|static
{
    $result = $this->select()
        ->where('id', $id)
        ->limit(1)
        ->run();
    return $result[0] ?? null;  // ✅ Typ sicher!
}

Vorteile der KI Unterstützung

✅ Konsistente Code Generierung

KI generiert Code, der konsistent den GEMVC Mustern folgt, um sicherzustellen, dass der gesamte Code derselben Architektur folgt.

✅ Typ sicherer Code

KI versteht die PHPStan Level 9 Anforderungen und generiert typ sicheren Code mit korrekten Type Hints.

✅ Eingebaute Sicherheit

KI weiß, dass 90% der Sicherheit automatisch sind und fügt nur die notwendige Schema Validierung und Authentifizierung hinzu.

✅ Korrekte Architektur

KI überspringt keine Schichten und generiert immer alle 4 Schichten (API, Controller, Model, Table) korrekt.

✅ Schnellere Entwicklung

KI kann vollständige CRUD Operationen in Sekunden generieren, die allen GEMVC Best Practices folgen.

✅ Weniger Fehler

KI kennt häufige Fehler, die vermieden werden müssen (wie die Verwendung von Laravel Mustern), und generiert korrekten GEMVC Code.

Datei Speicherort Referenz

Nach dem Ausführen von gemvc init finden Sie diese Dateien in Ihrem Projekt Stammverzeichnis:

project-root/
├── .cursorrules ← Cursor AI (primär)
├── GEMVC_GUIDE.md ← GitHub Copilot (primär)
├── COPILOT_INSTRUCTIONS.md ← GitHub Copilot
├── GEMVC_PHPDOC_REFERENCE.php ← KI Type Hints
├── AI_CONTEXT.md ← Kurzübersicht
├── AI_API_REFERENCE.md ← Komplette API Dokumente
├── QUICK_START_AI.md ← Master Anweisungen
└── gemvc-api-reference.jsonc ← Strukturierte Daten

Nutzungs Tipps

💡 Seien Sie spezifisch in Ihren Anfragen

Je spezifischer Sie sind, desto besser kann die KI Code generieren:

✅ Gut:

"Erstelle einen Produkt CRUD Endpunkt mit Authentifizierung für die Rollen Admin und SalesManager"

❌ Weniger effektiv:

"Erstelle Produkt Endpunkt"

💡 Generierten Code überprüfen

Überprüfen Sie immer den von der KI generierten Code. Führen Sie PHPStan aus, um die Typensicherheit zu überprüfen, und testen Sie die generierten Endpunkte, um sicherzustellen, dass sie korrekt funktionieren.

💡 CLI für vollständiges CRUD verwenden

Für vollständige CRUD Operationen können Sie auch CLI Befehle verwenden:

Terminal
# Vollständiges CRUD generieren
gemvc create:crud Product

# Dann mit KI Unterstützung anpassen

💡 CLI und KI kombinieren

Best Practice: Verwenden Sie CLI, um die Struktur zu generieren, und dann KI Unterstützung, um benutzerdefinierte Logik, Validierungen oder komplexe Funktionen hinzuzufügen.

Wichtige Hinweise

  • **Automatische Einrichtung:** KI Unterstützungsdateien werden während gemvc init automatisch kopiert. Keine manuelle Konfiguration erforderlich!
  • **Cursor AI:** Lädt .cursorrules automatisch aus dem Projekt Stammverzeichnis. Initialisieren Sie einfach Ihr Projekt, und Cursor wird GEMVC verstehen.
  • **GitHub Copilot:** Liest Markdown Dateien im Projekt Stammverzeichnis automatisch. Stellen Sie sicher, dass sich die Dateien für beste Ergebnisse im Stammverzeichnis befinden.
  • **Immer überprüfen:** Während die KI korrekten Code generiert, sollten Sie ihn immer überprüfen und testen. Führen Sie PHPStan aus, um die Typensicherheit zu gewährleisten.
  • **Framework Spezifisch:** KI Assistenten verstehen, dass GEMVC NICHT Laravel oder Symfony ist, und generieren GEMVC spezifischen Code.

🤖 KI Unterstützung bereit!

Ausgezeichnet! Sie haben gelernt, wie die KI Unterstützung von GEMVC funktioniert. Nach dem Ausführen von gemvc init versteht Ihr KI Assistent automatisch die GEMVC Architektur und generiert korrekten Code!