KI Unterstützung
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.
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
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. Führen Sie
gemvc initaus, um Ihr Projekt zu initialisieren - 2. GEMVC kopiert
.cursorrulesin Ihr Projekt Stammverzeichnis - 3. Cursor AI erkennt und lädt
.cursorrulesautomatisch - 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.phpmit Schema Validierung - ✓
app/controller/ProductController.phpmit Mapping - ✓
app/model/ProductModel.phpmit Geschäftslogik - ✓
app/table/ProductTable.phpmit Datenbank Operationen
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. Führen Sie
gemvc initaus, um Ihr Projekt zu initialisieren - 2. GEMVC kopiert KI Unterstützungsdateien in Ihr Projekt Stammverzeichnis:
- •
GEMVC_GUIDE.md - •
COPILOT_INSTRUCTIONS.md - •
GEMVC_PHPDOC_REFERENCE.php
- •
- 3. Copilot liest diese Dateien beim Codieren automatisch
- 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:
<?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();
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
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:
<?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:**
<?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:
<?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:
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:
# 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 initautomatisch kopiert. Keine manuelle Konfiguration erforderlich! -
**Cursor AI:** Lädt
.cursorrulesautomatisch 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!