@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/de/Flutter/checklists/refactoring.md

@@ -0,0 +1,30 @@
+# Sichere Refactoring-Checkliste
+
+## Vorbereitung
+
+- [ ] Alle bestehenden Tests bestanden
+- [ ] Baseline-Coverage aufgezeichnet
+- [ ] Feature-Branch erstellt
+- [ ] Backup/initialer Commit durchgeführt
+
+## Während des Refactorings
+
+- [ ] Eine Änderung nach der anderen
+- [ ] Tests bestehen nach jedem Schritt
+- [ ] Häufige Commits
+- [ ] Keine funktionalen Änderungen
+
+## Verifizierungen
+
+- [ ] Alle Tests bestanden
+- [ ] Coverage beibehalten oder verbessert
+- [ ] Keine Performance-Regression
+- [ ] flutter analyze sauber
+- [ ] Kompilierung ohne Fehler
+
+## Vor dem Merge
+
+- [ ] Code-Review genehmigt
+- [ ] Dokumentation aktualisiert
+- [ ] CHANGELOG aktualisiert
+- [ ] Integrationstests bestanden

package/Dev/i18n/de/Flutter/checklists/security.md

@@ -0,0 +1,47 @@
+# Sicherheits-Audit-Checkliste
+
+## Sensible Daten
+
+- [ ] Tokens in flutter_secure_storage
+- [ ] Keine Passwörter in SharedPreferences
+- [ ] Keine hardcodierten Secrets
+- [ ] .env in .gitignore
+- [ ] Obfuskierung in Produktion aktiviert
+
+## API & Netzwerk
+
+- [ ] Nur HTTPS
+- [ ] Certificate Pinning implementiert
+- [ ] Timeouts konfiguriert
+- [ ] Sichere Retry-Strategie
+- [ ] Netzwerkfehlerbehandlung
+
+## Authentifizierung
+
+- [ ] Sichere JWT-Tokens
+- [ ] Refresh-Token implementiert
+- [ ] Sauberer Logout
+- [ ] Session-Timeout
+- [ ] Biometrie falls verfügbar
+
+## Validierung
+
+- [ ] Client-seitige Validierung
+- [ ] Server-seitige Validierung
+- [ ] Eingabe-Sanitisierung
+- [ ] XSS-Prävention
+- [ ] SQL-Injection-Prävention
+
+## Berechtigungen
+
+- [ ] Minimale Berechtigungen
+- [ ] Anfrage zur richtigen Zeit
+- [ ] Ablehnung behandeln
+- [ ] Berechtigungs-Dokumentation
+
+## Produktion
+
+- [ ] ProGuard/R8 konfiguriert
+- [ ] Symbols hochgeladen
+- [ ] Produktions-Logs deaktiviert
+- [ ] Error-Tracking konfiguriert

package/Dev/i18n/de/Flutter/commands/analyze-performance.md

@@ -0,0 +1,357 @@
+---
+description: Flutter Performance-Analyse
+argument-hint: [arguments]
+---
+
+# Flutter Performance-Analyse
+
+Du bist ein Flutter Performance-Experte. Du musst die Performance der Anwendung analysieren, Probleme identifizieren (Jank, Memory Leaks, unnötige Rebuilds) und Optimierungen vorschlagen.
+
+## Argumente
+$ARGUMENTS
+
+Argumente:
+- (Optional) Fokus: rendering, memory, network, all
+
+Beispiel: `/flutter:analyze-performance rendering`
+
+## MISSION
+
+### Schritt 1: Metriken Erfassen
+
+```bash
+# Im Profile-Modus starten
+flutter run --profile
+
+# DevTools
+flutter pub global activate devtools
+dart devtools
+
+# Code analysieren
+dart analyze --fatal-infos
+```
+
+### Schritt 2: Rendering-Analyse
+
+#### Unnötige Rebuilds Identifizieren
+
+```dart
+// In main.dart für Debugging hinzufügen
+import 'package:flutter/rendering.dart';
+
+void main() {
+  debugProfileBuildsEnabled = true;  // Build-Logging
+  debugPrintRebuildDirtyWidgets = true;  // Rebuild-Logging
+  runApp(const MyApp());
+}
+```
+
+#### Häufige Probleme und Lösungen
+
+##### 1. Kaskadenartige Rebuilds
+
+```dart
+// ❌ SCHLECHT - Alles wird bei jeder Änderung neu gebaut
+class ParentWidget extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Consumer<MyModel>(
+      builder: (context, model, _) => Column(
+        children: [
+          HeaderWidget(title: model.title),
+          BodyWidget(items: model.items),
+          FooterWidget(), // Unnötiger Rebuild!
+        ],
+      ),
+    );
+  }
+}
+
+// ✅ GUT - Feine Granularität
+class ParentWidget extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Selector<MyModel, String>(
+          selector: (_, model) => model.title,
+          builder: (_, title, __) => HeaderWidget(title: title),
+        ),
+        Selector<MyModel, List<Item>>(
+          selector: (_, model) => model.items,
+          builder: (_, items, __) => BodyWidget(items: items),
+        ),
+        const FooterWidget(), // const = kein Rebuild
+      ],
+    );
+  }
+}
+```
+
+##### 2. Nicht Optimierte ListView
+
+```dart
+// ❌ SCHLECHT - Erstellt alle Widgets auf einmal
+ListView(
+  children: items.map((item) => ItemWidget(item: item)).toList(),
+)
+
+// ✅ GUT - Lazy Loading
+ListView.builder(
+  itemCount: items.length,
+  itemBuilder: (context, index) => ItemWidget(item: items[index]),
+  // Zusätzliche Optimierungen
+  cacheExtent: 500, // Vor-Rendering
+  addAutomaticKeepAlives: false, // Falls Zustand nicht erhalten werden muss
+)
+
+// ✅ NOCH BESSER - Mit fester Größe
+ListView.builder(
+  itemCount: items.length,
+  itemExtent: 80, // Feste Höhe = optimierte Berechnung
+  itemBuilder: (context, index) => ItemWidget(item: items[index]),
+)
+```
+
+##### 3. Nicht Optimierte Bilder
+
+```dart
+// ❌ SCHLECHT
+Image.network(
+  'https://example.com/large_image.jpg',
+)
+
+// ✅ GUT - Mit Cache und Resize
+CachedNetworkImage(
+  imageUrl: 'https://example.com/large_image.jpg',
+  cacheWidth: 300, // Im Speicher resizen
+  cacheHeight: 300,
+  memCacheWidth: 300,
+  placeholder: (context, url) => const Shimmer(),
+  errorWidget: (context, url, error) => const Icon(Icons.error),
+)
+```
+
+### Schritt 3: Speicher-Analyse
+
+#### Memory Leaks Erkennen
+
+```dart
+// Fehlende dispose() prüfen
+class _MyWidgetState extends State<MyWidget> {
+  late StreamSubscription _subscription;
+  late AnimationController _controller;
+  Timer? _timer;
+
+  @override
+  void initState() {
+    super.initState();
+    _subscription = stream.listen((_) {});
+    _controller = AnimationController(vsync: this);
+    _timer = Timer.periodic(Duration(seconds: 1), (_) {});
+  }
+
+  @override
+  void dispose() {
+    _subscription.cancel();  // ✅ Wichtig!
+    _controller.dispose();   // ✅ Wichtig!
+    _timer?.cancel();        // ✅ Wichtig!
+    super.dispose();
+  }
+}
+```
+
+#### Problematische Patterns
+
+```dart
+// ❌ SCHLECHT - Closure erfasst den Kontext
+onPressed: () async {
+  await longOperation();
+  Navigator.of(context).pop(); // Kontext kann ungültig sein!
+}
+
+// ✅ GUT - Mounted prüfen
+onPressed: () async {
+  await longOperation();
+  if (mounted) {
+    Navigator.of(context).pop();
+  }
+}
+```
+
+### Schritt 4: Empfohlene Optimierungen
+
+#### Widget Optimization Checklist
+
+```dart
+// 1. const überall wo möglich verwenden
+const MyWidget(); // ✅
+
+// 2. RepaintBoundary für teure Teile
+RepaintBoundary(
+  child: ExpensiveWidget(),
+)
+
+// 3. Oft ändernde Widgets separieren
+class OptimizedWidget extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        const StaticHeader(),      // Niemals Rebuild
+        const AnimatedCounter(),   // Isoliert
+        const StaticFooter(),      // Niemals Rebuild
+      ],
+    );
+  }
+}
+
+// 4. Builds in Builds vermeiden
+// ❌ SCHLECHT
+build(context) {
+  final items = generateItems(); // Bei jedem Build aufgerufen!
+  return ListView.builder(...);
+}
+
+// ✅ GUT
+late final items = generateItems(); // Nur einmal
+
+// 5. Keys korrekt verwenden
+ListView.builder(
+  itemBuilder: (context, index) => ItemWidget(
+    key: ValueKey(items[index].id), // Stabile Key
+    item: items[index],
+  ),
+)
+```
+
+### Schritt 5: Bericht Erstellen
+
+```
+══════════════════════════════════════════════════════════════
+📊 FLUTTER PERFORMANCE-BERICHT
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+🎯 RENDERING-METRIKEN
+──────────────────────────────────────────────────────────────
+
+| Seite | Build-Zeit | Raster-Zeit | FPS | Status |
+|-------|-----------|-------------|-----|--------|
+| Home | 8ms | 12ms | 60 | ✅ |
+| Liste | 45ms | 35ms | 45 | ⚠️ |
+| Detail | 15ms | 18ms | 58 | ✅ |
+
+Schwellenwerte:
+- Build < 16ms : ✅
+- Build > 16ms : ⚠️ Möglicher Jank
+- Build > 32ms : ❌ Sichtbarer Jank
+
+──────────────────────────────────────────────────────────────
+🧠 SPEICHER-METRIKEN
+──────────────────────────────────────────────────────────────
+
+| Metrik | Wert | Schwelle | Status |
+|--------|------|----------|--------|
+| Heap Verwendet | 85MB | < 150MB | ✅ |
+| Heap Kapazität | 120MB | < 200MB | ✅ |
+| Extern | 25MB | < 50MB | ✅ |
+| RSS | 180MB | < 300MB | ✅ |
+
+──────────────────────────────────────────────────────────────
+⚠️ ERKANNTE PROBLEME
+──────────────────────────────────────────────────────────────
+
+### Kritisch
+1. **Excessive Rebuilds** - ProductListPage
+   - 150 Rebuilds/Sek erkannt
+   - Ursache: Provider auf falscher Ebene
+   - Fix: Selector oder granularen Consumer verwenden
+
+### Wichtig
+2. **Nicht optimierte ListView** - OrderHistoryPage
+   - Kein itemExtent definiert
+   - 500+ Items ohne Lazy Loading
+   - Fix: ListView.builder mit itemExtent
+
+3. **Bilder ohne Cache** - ProductCard
+   - Image.network ohne Cache
+   - Fix: cached_network_image verwenden
+
+### Geringfügig
+4. **Nicht-const Widgets** - Benutzerdefinierte AppBar
+   - 5 Widgets können const sein
+   - Fix: const Keyword hinzufügen
+
+──────────────────────────────────────────────────────────────
+🔧 VORGESCHLAGENE OPTIMIERUNGEN
+──────────────────────────────────────────────────────────────
+
+### 1. ProductListPage - Rebuilds (Impact: Hoch)
+```dart
+// Vorher
+Consumer<CartModel>(
+  builder: (_, cart, __) => ProductList(cart: cart),
+)
+
+// Nachher
+Selector<CartModel, int>(
+  selector: (_, cart) => cart.itemCount,
+  builder: (_, count, child) => child!,
+  child: const ProductList(),
+)
+```
+
+### 2. OrderHistoryPage - ListView (Impact: Hoch)
+```dart
+// Vorher
+ListView(children: orders.map((o) => OrderTile(o)).toList())
+
+// Nachher
+ListView.builder(
+  itemCount: orders.length,
+  itemExtent: 72,
+  itemBuilder: (_, i) => OrderTile(orders[i]),
+)
+```
+
+### 3. ProductCard - Bilder (Impact: Mittel)
+```dart
+// Vorher
+Image.network(product.imageUrl)
+
+// Nachher
+CachedNetworkImage(
+  imageUrl: product.imageUrl,
+  cacheWidth: 200,
+  memCacheWidth: 200,
+)
+```
+
+──────────────────────────────────────────────────────────────
+📈 GESCHÄTZTE AUSWIRKUNG
+──────────────────────────────────────────────────────────────
+
+| Optimierung | Vorher | Nachher | Gewinn |
+|-------------|--------|---------|--------|
+| ProductListPage FPS | 45 | 60 | +33% |
+| Bildspeicher | 85MB | 45MB | -47% |
+| Time to Interactive | 2.5s | 1.8s | -28% |
+
+──────────────────────────────────────────────────────────────
+📋 NÜTZLICHE BEFEHLE
+──────────────────────────────────────────────────────────────
+
+# Profiling
+flutter run --profile
+flutter analyze
+
+# DevTools
+flutter pub global activate devtools
+dart devtools
+
+# Performance Overlay
+MaterialApp(
+  showPerformanceOverlay: true,
+)
+```

package/Dev/i18n/de/Flutter/commands/check-architecture.md

@@ -0,0 +1,92 @@
+---
+description: Flutter Architektur-Prüfung
+argument-hint: [arguments]
+---
+
+# Flutter Architektur-Prüfung
+
+## Argumente
+
+$ARGUMENTS
+
+## MISSION
+
+Du bist ein Flutter-Experte, der beauftragt ist, die Projektarchitektur gemäß den Prinzipien der Clean Architecture zu prüfen.
+
+### Schritt 1: Analyse der Projektstruktur
+
+- [ ] Ordnerstruktur des Projekts identifizieren
+- [ ] Dateien `pubspec.yaml` und `analysis_options.yaml` lokalisieren
+- [ ] Regeln aus `/rules/02-architecture.md` referenzieren
+- [ ] SOLID-Prinzipien aus `/rules/04-solid-principles.md` referenzieren
+
+### Schritt 2: Architektur-Prüfungen (25 Punkte)
+
+#### 2.1 Organisation in Clean Architecture Layern (10 Punkte)
+- [ ] **Domain Layer**: Isolierte Entities und Use Cases (0-4 Pkt)
+  - `lib/domain/entities/` und `lib/domain/usecases/` prüfen
+  - Keine Abhängigkeiten zu data oder presentation
+  - Reine Entities nur mit Geschäftslogik
+- [ ] **Data Layer**: Repositories, DataSources, Models (0-3 Pkt)
+  - `lib/data/repositories/`, `lib/data/datasources/`, `lib/data/models/` prüfen
+  - Implementierung der Domain-Interfaces
+  - Trennung remote/local datasources
+- [ ] **Presentation Layer**: UI, States, BLoCs/Providers (0-3 Pkt)
+  - `lib/presentation/pages/`, `lib/presentation/widgets/`, `lib/presentation/blocs/` prüfen
+  - Trennung UI/Business Logic
+  - Wiederverwendbare Widgets in `/widgets/common/`
+
+#### 2.2 Dependency Injection (5 Punkte)
+- [ ] **DI Container** konfiguriert (get_it, injectable, riverpod) (0-3 Pkt)
+- [ ] **Kein direktes new()** in Widgets (0-2 Pkt)
+- [ ] Alle Abhängigkeiten über Konstruktor injiziert
+
+#### 2.3 Verantwortungstrennung (5 Punkte)
+- [ ] **Single Responsibility**: Eine Klasse = eine Verantwortung (0-2 Pkt)
+- [ ] **Interface Segregation**: Kleine und spezialisierte Interfaces (0-2 Pkt)
+- [ ] **Dependency Inversion**: Abhängig von Abstraktionen, nicht Implementierungen (0-1 Pkt)
+
+#### 2.4 Modulare Struktur (5 Punkte)
+- [ ] **Isolierte Features**: Code nach Funktionalität organisiert (0-2 Pkt)
+- [ ] **Core/Shared**: Gemeinsame Utilities getrennt (0-2 Pkt)
+- [ ] **Keine Kopplung** zwischen Features (0-1 Pkt)
+
+### Schritt 3: Punkteberechnung
+
+```
+ARCHITEKTUR-SCORE = Summe der Punkte / 25
+
+Interpretation:
+✅ 20-25 Pkt: Exzellente Architektur
+⚠️ 15-19 Pkt: Korrekte Architektur, Verbesserungen empfohlen
+⚠️ 10-14 Pkt: Architektur zu verbessern
+❌ 0-9 Pkt: Problematische Architektur
+```
+
+### Schritt 4: Detaillierter Bericht
+
+Erstelle einen Bericht mit:
+
+#### 📊 ARCHITEKTUR-SCORE: XX/25
+
+#### ✅ Stärken
+- Liste erkannter Best Practices
+- Beispiele für gut strukturierten Code
+
+#### ⚠️ Verbesserungspunkte
+- Erkannte Verstöße mit Dateien und Zeilen
+- Auswirkungen auf Wartbarkeit
+
+#### ❌ Kritische Verstöße
+- Größere Architekturprobleme
+- Starke Kopplung, zirkuläre Abhängigkeiten
+
+#### 🎯 TOP 3 PRIORITÄRE MASSNAHMEN
+
+1. **[HOHE PRIORITÄT]** Wichtigste Maßnahme mit geschätztem Aufwand und Impact
+2. **[MITTLERE PRIORITÄT]** Zweite Maßnahme mit Begründung
+3. **[NIEDRIGE PRIORITÄT]** Dritte Maßnahme für kontinuierliche Verbesserung
+
+---
+
+**Hinweis**: Dieser Bericht konzentriert sich ausschließlich auf die Architektur. Für ein vollständiges Audit verwenden Sie `/check-compliance`.

package/Dev/i18n/de/Flutter/commands/check-code-quality.md

@@ -0,0 +1,120 @@
+---
+description: Flutter Codequalitäts-Prüfung
+argument-hint: [arguments]
+---
+
+# Flutter Codequalitäts-Prüfung
+
+## Argumente
+
+$ARGUMENTS
+
+## MISSION
+
+Du bist ein Flutter-Experte, der beauftragt ist, die Codequalität gemäß Effective Dart und Best Practices zu prüfen.
+
+### Schritt 1: Projektanalyse
+
+- [ ] Alle Dart-Dateien des Projekts identifizieren
+- [ ] Datei `analysis_options.yaml` analysieren
+- [ ] Regeln aus `/rules/03-coding-standards.md` referenzieren
+- [ ] Prinzipien aus `/rules/05-kiss-dry-yagni.md` referenzieren
+- [ ] Linter-Konfiguration prüfen
+
+### Schritt 2: Codequalitäts-Prüfungen (25 Punkte)
+
+#### 2.1 Effective Dart Namenskonventionen (6 Punkte)
+- [ ] **Klassen/Enums**: UpperCamelCase (0-1 Pkt)
+  - Beispiele: `UserProfile`, `AuthenticationState`
+- [ ] **Variablen/Methoden**: lowerCamelCase (0-1 Pkt)
+  - Beispiele: `userName`, `fetchUserData()`
+- [ ] **Konstanten**: lowerCamelCase (0-1 Pkt)
+  - Beispiele: `maxRetries`, `defaultTimeout`
+- [ ] **Dateien**: snake_case (0-1 Pkt)
+  - Beispiele: `user_profile.dart`, `authentication_bloc.dart`
+- [ ] **Packages**: snake_case (0-1 Pkt)
+  - `pubspec.yaml` prüfen
+- [ ] **Beschreibende Namen**: Kryptische Abkürzungen vermeiden (0-1 Pkt)
+
+#### 2.2 Linting und statische Analyse (7 Punkte)
+- [ ] **analysis_options.yaml** mit strikten Regeln konfiguriert (0-2 Pkt)
+  - `flutter_lints` oder `very_good_analysis` einbinden
+  - Benutzerdefinierte Regeln aktiviert
+- [ ] **Keine Warnings** in `flutter analyze` (0-3 Pkt)
+  - Ausführen: `docker run --rm -v $(pwd):/app -w /app cirrusci/flutter:stable flutter analyze`
+- [ ] **Keine Verstöße** gegen `prefer_const_constructors`, `unnecessary_null_in_if_null_operators` (0-2 Pkt)
+
+#### 2.3 KISS, DRY, YAGNI Prinzipien (6 Punkte)
+- [ ] **KISS (Keep It Simple)**: Methoden < 50 Zeilen (0-2 Pkt)
+  - Keine unnötige komplexe Logik
+  - Eine Abstraktionsebene pro Methode
+- [ ] **DRY (Don't Repeat Yourself)**: Kein duplizierter Code (0-2 Pkt)
+  - Gemeinsame Utilities in `/core/utils/`
+  - Wiederverwendbare Widgets extrahiert
+- [ ] **YAGNI (You Ain't Gonna Need It)**: Keine Über-Engineering (0-2 Pkt)
+  - Kein Code "für alle Fälle"
+  - Gerechtfertigte Abstraktionen
+
+#### 2.4 Dokumentation und Kommentare (3 Punkte)
+- [ ] **Öffentliche Klassen** mit `///` dokumentiert (0-1 Pkt)
+- [ ] **Komplexe Methoden** mit erklärenden Kommentaren (0-1 Pkt)
+- [ ] **Kein auskommentierter Code** in Produktion (0-1 Pkt)
+  - Git für Historie verwenden
+
+#### 2.5 Fehlerbehandlung (3 Punkte)
+- [ ] **Try-catch** angemessen mit Logging (0-1 Pkt)
+- [ ] **Spezifische Fehlertypen** (nicht nur `catch (e)`) (0-1 Pkt)
+- [ ] **Keine print()** in Produktion (Logger verwenden) (0-1 Pkt)
+
+### Schritt 3: Punkteberechnung
+
+```
+CODEQUALITÄTS-SCORE = Summe der Punkte / 25
+
+Interpretation:
+✅ 20-25 Pkt: Exzellente Qualität
+⚠️ 15-19 Pkt: Korrekte Qualität, Verbesserungen empfohlen
+⚠️ 10-14 Pkt: Qualität zu verbessern
+❌ 0-9 Pkt: Problematische Qualität
+```
+
+### Schritt 4: Detaillierter Bericht
+
+Erstelle einen Bericht mit:
+
+#### 📊 CODEQUALITÄTS-SCORE: XX/25
+
+#### ✅ Stärken
+- Gut beachtete Konventionen
+- Beispiele für sauberen und lesbaren Code
+
+#### ⚠️ Verbesserungspunkte
+- Erkannte kleinere Verstöße mit Dateien
+- Verbesserungsvorschläge
+
+#### ❌ Kritische Verstöße
+- Namensgebungsprobleme
+- Duplizierter oder zu komplexer Code
+- Ungelöste Warnings
+
+#### 📝 Beispiele für zu verbessernden Code
+
+```dart
+// ❌ Schlecht
+var d = DateTime.now(); // Kryptischer Name
+void doStuff() { ... } // Zu vage
+
+// ✅ Gut
+final currentDate = DateTime.now();
+void authenticateUser() { ... }
+```
+
+#### 🎯 TOP 3 PRIORITÄRE MASSNAHMEN
+
+1. **[HOHE PRIORITÄT]** Warnings von `flutter analyze` beheben (Impact: Wartbarkeit)
+2. **[MITTLERE PRIORITÄT]** Methoden > 50 Zeilen refactoren (Impact: Lesbarkeit)
+3. **[NIEDRIGE PRIORITÄT]** Fehlende öffentliche Klassen dokumentieren (Impact: API)
+
+---
+
+**Hinweis**: Dieser Bericht konzentriert sich ausschließlich auf die Codequalität. Für ein vollständiges Audit verwenden Sie `/check-compliance`.