appiq-solution 1.4.8 → 1.5.0

package/flutter/punkt.claude/punkt.claude/commands/git-commit.md

@@ -1,3 +0,0 @@
-Check the changes files and create a commit message for the changes. if needed and if several tasks or things are done do several commits.
-
-and also run the git commit cmd.

package/flutter/punkt.claude/punkt.claude/commands/manage-translations.md

@@ -1,433 +0,0 @@
-# Translation Management Command
-
-Manages translations for the AiGo app across all supported languages (English, German, Russian, Turkish, Arabic) with proper ARB file generation and validation.
-
-**Usage:** `manage-translations [ACTION] [OPTIONS]`
-
-**Actions:**
-- `add` - Add new translation keys
-- `update` - Update existing translations  
-- `generate` - Generate localization files
-- `validate` - Validate translation completeness
-- `extract` - Extract hardcoded strings from code
-
-**Examples:**
-- `manage-translations add --key "newFeature.title" --en "New Feature" --de "Neue Funktion"`
-- `manage-translations generate`
-- `manage-translations validate`
-
-## Supported Languages
-
-AiGo supports the following languages with their locale codes:
-- **English (en)** - Primary/template language
-- **German (de)** - German translation
-- **Russian (ru)** - Russian translation  
-- **Turkish (tr)** - Turkish translation
-- **Arabic (ar)** - Arabic translation with RTL support
-
-## File Structure
-
-```
-lib/l10n/
-├── app_en.arb          # English (template)
-├── app_de.arb          # German
-├── app_ru.arb          # Russian
-├── app_tr.arb          # Turkish
-├── app_ar.arb          # Arabic
-├── l10n.dart           # Generated localizations
-├── app_localizations.dart
-├── app_localizations_en.dart
-├── app_localizations_de.dart
-├── app_localizations_ru.dart
-├── app_localizations_tr.dart
-├── app_localizations_ar.dart
-├── generate_translations.py
-└── new/
-```
-
-## Configuration
-
-The app uses the following localization configuration in `l10n.yaml`:
-
-```yaml
-arb-dir: lib/l10n
-template-arb-file: app_en.arb
-output-localization-file: app_localizations.dart
-output-class: AppLocalizations
-untranslated-messages-file: untranslated.txt
-synthetic-package: false
-nullable-getter: false
-```
-
-## Command Actions
-
-### 1. Add New Translations
-
-**Usage:** `manage-translations add --key "feature.key" --en "English" --de "German" --ru "Russian" --tr "Turkish" --ar "Arabic"`
-
-**Example:**
-```bash
-manage-translations add \
-  --key "favorites.title" \
-  --en "Favorites" \
-  --de "Favoriten" \
-  --ru "Избранное" \
-  --tr "Favoriler" \
-  --ar "المفضلة"
-```
-
-**Process:**
-1. Validate that the key doesn't already exist
-2. Add the key to app_en.arb as the template
-3. Add translations to all other ARB files
-4. Generate localization files
-5. Validate all translations are complete
-
-**Template for new key in app_en.arb:**
-```json
-{
-  "keyName": "English Text",
-  "@keyName": {
-    "description": "Description of where this text is used"
-  }
-}
-```
-
-### 2. Update Existing Translations
-
-**Usage:** `manage-translations update --key "existing.key" --en "New English" --de "New German"`
-
-**Process:**
-1. Verify the key exists in app_en.arb
-2. Update translations in specified language files
-3. Mark other languages for review if needed
-4. Regenerate localization files
-
-### 3. Generate Localization Files
-
-**Usage:** `manage-translations generate`
-
-**Process:**
-1. Run Flutter's localization generation: `flutter gen-l10n`
-2. Validate generated files
-3. Check for any errors or warnings
-4. Update untranslated.txt with missing translations
-
-**Generated files:**
-- `lib/l10n/app_localizations.dart`
-- `lib/l10n/app_localizations_*.dart` for each language
-- `untranslated.txt` with missing translations
-
-### 4. Validate Translations
-
-**Usage:** `manage-translations validate`
-
-**Validation checks:**
-1. **Completeness**: All keys exist in all language files
-2. **Consistency**: Same number of placeholders in all translations
-3. **Syntax**: Valid JSON format in all ARB files
-4. **Placeholders**: Proper placeholder syntax `{variable}`
-5. **Gender/Plural**: Proper ICU message format for complex texts
-6. **RTL Support**: Arabic translations use correct text direction
-
-**Sample validation output:**
-```
-✅ English (en): 245 keys - Complete
-✅ German (de): 245 keys - Complete  
-❌ Russian (ru): 243 keys - Missing: favorites.title, settings.theme
-✅ Turkish (tr): 245 keys - Complete
-⚠️  Arabic (ar): 245 keys - Complete (2 RTL warnings)
-
-Missing translations written to: untranslated.txt
-```
-
-### 5. Extract Hardcoded Strings
-
-**Usage:** `manage-translations extract`
-
-**Process:**
-1. Scan all Dart files in `lib/` directory
-2. Look for hardcoded strings that should be localized
-3. Identify Text widgets with string literals
-4. Find string concatenations that should use interpolation
-5. Generate report of strings that need localization
-
-**Example patterns detected:**
-```dart
-// Bad - hardcoded string
-Text('Welcome to AiGo')
-
-// Good - localized string  
-Text(context.l10n.welcomeMessage)
-
-// Bad - hardcoded concatenation
-Text('Hello ' + userName)
-
-// Good - localized with interpolation
-Text(context.l10n.greetingMessage(userName))
-```
-
-## Implementation Guidelines
-
-### Adding New Features with Translations
-
-When implementing a new feature, follow this workflow:
-
-1. **Design Translation Keys**:
-   ```
-   featureName.title
-   featureName.subtitle  
-   featureName.description
-   featureName.button.save
-   featureName.button.cancel
-   featureName.error.notFound
-   featureName.success.saved
-   ```
-
-2. **Add to ARB Files**:
-   Start with English (template):
-   ```json
-   {
-     "favoritesTitle": "My Favorites",
-     "@favoritesTitle": {
-       "description": "Title for the favorites screen"
-     },
-     "favoritesEmpty": "No favorites yet",
-     "@favoritesEmpty": {
-       "description": "Message shown when favorites list is empty"
-     },
-     "favoritesCount": "{count, plural, =0{No favorites} =1{1 favorite} other{{count} favorites}}",
-     "@favoritesCount": {
-       "description": "Count of favorite items",
-       "placeholders": {
-         "count": {
-           "type": "int",
-           "example": "5"
-         }
-       }
-     }
-   }
-   ```
-
-3. **Use in Code**:
-   ```dart
-   import 'package:aigo/l10n/l10n.dart';
-   
-   class FavoritesScreen extends StatelessWidget {
-     @override
-     Widget build(BuildContext context) {
-       return Scaffold(
-         appBar: AppBar(
-           title: Text(context.l10n.favoritesTitle),
-         ),
-         body: favorites.isEmpty
-           ? Text(context.l10n.favoritesEmpty)
-           : Text(context.l10n.favoritesCount(favorites.length)),
-       );
-     }
-   }
-   ```
-
-### RTL (Right-to-Left) Support for Arabic
-
-Arabic text requires special handling:
-
-1. **Text Direction**: Automatically handled by `LocaleProvider`
-2. **Layout Direction**: Use `Directionality` widget when needed
-3. **Icons**: Consider flipping directional icons
-4. **Alignment**: Use `TextAlign.start` instead of `TextAlign.left`
-
-**Example RTL-aware implementation:**
-```dart
-Consumer(
-  builder: (context, ref, child) {
-    final isRtl = ref.watch(isRtlProvider);
-    
-    return Directionality(
-      textDirection: isRtl ? TextDirection.rtl : TextDirection.ltr,
-      child: Row(
-        children: [
-          Icon(isRtl ? Icons.arrow_back_ios : Icons.arrow_forward_ios),
-          Text(context.l10n.continueText),
-        ],
-      ),
-    );
-  },
-)
-```
-
-### Complex Messages with ICU Format
-
-For messages with plurals, gender, or complex formatting:
-
-```json
-{
-  "messageCount": "{count, plural, =0{no messages} =1{one message} other{{count} messages}}",
-  "@messageCount": {
-    "description": "Number of messages",
-    "placeholders": {
-      "count": {
-        "type": "int"
-      }
-    }
-  },
-  "userGreeting": "{gender, select, male{Welcome Mr. {name}} female{Welcome Ms. {name}} other{Welcome {name}}}",
-  "@userGreeting": {
-    "description": "Greeting based on user gender",
-    "placeholders": {
-      "gender": {
-        "type": "String"
-      },
-      "name": {
-        "type": "String"
-      }
-    }
-  }
-}
-```
-
-## Automation Scripts
-
-### Translation Generation Script
-
-Create `lib/l10n/generate_translations.py` for automated management:
-
-```python
-#!/usr/bin/env python3
-import json
-import os
-import subprocess
-import sys
-
-LANGUAGES = ['en', 'de', 'ru', 'tr', 'ar']
-ARB_DIR = 'lib/l10n'
-
-def generate_translations():
-    """Generate Flutter localizations"""
-    try:
-        result = subprocess.run(['flutter', 'gen-l10n'], 
-                              capture_output=True, text=True)
-        if result.returncode == 0:
-            print("✅ Translations generated successfully")
-        else:
-            print(f"❌ Error generating translations: {result.stderr}")
-    except Exception as e:
-        print(f"❌ Failed to run flutter gen-l10n: {e}")
-
-def validate_completeness():
-    """Validate all languages have the same keys"""
-    template_file = f"{ARB_DIR}/app_en.arb"
-    
-    with open(template_file, 'r', encoding='utf-8') as f:
-        template = json.load(f)
-    
-    template_keys = {k for k in template.keys() if not k.startswith('@')}
-    
-    for lang in LANGUAGES[1:]:  # Skip English (template)
-        lang_file = f"{ARB_DIR}/app_{lang}.arb"
-        
-        if not os.path.exists(lang_file):
-            print(f"❌ Missing file: {lang_file}")
-            continue
-            
-        with open(lang_file, 'r', encoding='utf-8') as f:
-            lang_data = json.load(f)
-        
-        lang_keys = {k for k in lang_data.keys() if not k.startswith('@')}
-        missing_keys = template_keys - lang_keys
-        
-        if missing_keys:
-            print(f"❌ {lang.upper()}: Missing {len(missing_keys)} keys")
-            for key in sorted(missing_keys):
-                print(f"   - {key}")
-        else:
-            print(f"✅ {lang.upper()}: Complete ({len(lang_keys)} keys)")
-
-if __name__ == "__main__":
-    if len(sys.argv) > 1 and sys.argv[1] == "validate":
-        validate_completeness()
-    else:
-        generate_translations()
-```
-
-### Usage Commands
-
-After updating translations, always run:
-
-```bash
-# Generate localization files
-flutter gen-l10n
-
-# Run build runner for any generated code
-dart run build_runner build
-
-# Validate completeness
-python3 lib/l10n/generate_translations.py validate
-```
-
-## Quality Checklist
-
-### Before Adding New Feature
-- [ ] Design complete translation key structure
-- [ ] Plan for plurals and complex messages
-- [ ] Consider RTL support for Arabic
-- [ ] Prepare context descriptions for translators
-
-### Adding Translations
-- [ ] All 5 languages have translations
-- [ ] Placeholders are consistent across languages
-- [ ] Context descriptions provided
-- [ ] ICU format used for complex messages
-- [ ] No hardcoded strings in Dart code
-
-### After Implementation
-- [ ] Run `flutter gen-l10n` successfully
-- [ ] Validate with `manage-translations validate`
-- [ ] Test RTL layout with Arabic
-- [ ] Verify all text displays correctly
-- [ ] Check untranslated.txt is empty
-
-### Code Quality
-- [ ] Use `context.l10n` for all user-facing text
-- [ ] No string concatenation for localized text
-- [ ] Proper placeholder usage
-- [ ] RTL-aware layout implementation
-
-## Common Translation Keys Structure
-
-Follow this naming convention for consistency:
-
-```
-// Screen titles
-screenName.title
-screenName.subtitle
-
-// Actions
-screenName.button.action
-screenName.action.verb
-
-// States
-screenName.loading
-screenName.empty
-screenName.error
-
-// Messages
-screenName.success.action
-screenName.error.specific
-screenName.warning.condition
-
-// Fields
-screenName.field.label
-screenName.field.hint
-screenName.field.error
-
-// General/Global
-general.yes
-general.no
-general.save
-general.cancel
-general.delete
-general.confirm
-```
-
-This translation management system ensures AiGo maintains high-quality, complete translations across all supported languages while following Flutter's best practices for internationalization.

package/flutter/punkt.claude/punkt.claude/commands/search-web.md

@@ -1 +0,0 @@
-Search the web for this: $ARGUMENTS and get the most relevant information that answers my query.

package/flutter/punkt.claude/punkt.claude/developer_check.md

@@ -1,121 +0,0 @@
-# Developer Check Status
-
-**Project**: AiGo Mobile App  
-**Created**: 2025-07-16  
-**Last Updated**: 2025-07-16  
-
-## Overview
-
-Dieses Dokument verwaltet den Status aller Development-Tasks und deren Quality-Reviews. Wird automatisch von `/dev` und `/checkdev` Commands aktualisiert.
-
----
-
-## Active Development Session
-
-**Session ID**: DEV-001  
-**Started**: 2025-07-16  
-**Developer**: Claude Code Assistant  
-**QA Reviewer**: Claude Code QA  
-
-### Session Summary
-- **Total Tasks**: 1
-- **Completed**: 1  
-- **In Progress**: 0
-- **Pending**: 0
-- **Blocked**: 0
-
----
-
-## Development Tasks
-
-### DEV-001-001 - Test Task: Create Demo Widget
-**Status**: ✅ COMPLETED  
-**Priority**: MEDIUM  
-**Estimated Time**: 0.5h  
-**Actual Time**: 0.5h  
-**Dependencies**: None  
-
-#### Description
-Demo-Task zur Validierung des Developer-Check-Systems. Erstelle ein einfaches Test-Widget.
-
-#### Implementation Details
-- [x] Create demo_widget.dart
-- [x] Add basic widget structure
-- [x] Test widget compilation
-
-#### Files Modified
-- lib/core/widgets/demo_widget.dart
-
-#### Quality Checklist
-- [x] DRY Prinzip befolgt
-- [x] Code lesbar und dokumentiert
-- [x] Wartbar strukturiert
-- [x] Performance optimiert
-- [x] Testbar implementiert
-
-#### Notes
-Demo-Implementation für System-Test. Bereit für QA-Review.
-
----
-
-## Quality Reviews
-
-### Review: DEV-001-001 - Test Task: Create Demo Widget
-**Reviewer**: Claude Code QA  
-**Review Date**: 2025-07-16 15:30  
-**Status**: ✅ PASSED  
-
-#### Quality Score: 5/5
-- 🧹 DRY: ✅ Keine Duplikation
-- 📖 Readable: ✅ Klare Struktur  
-- 🔧 Maintainable: ✅ Modularer Aufbau
-- ⚡ Performant: ✅ Optimiert
-- 🧪 Testable: ✅ Testfreundlich
-
-#### Issues Found
-*Keine kritischen Issues gefunden.*
-
-#### Fixes Applied
-*Keine Fixes erforderlich.*
-
-#### Recommendations
-- Widget kann für weitere Demo-Zwecke erweitert werden
-- Dokumentation ist vollständig und ausreichend
-
----
-
-## Session Metrics
-
-### Code Quality Score: 5.0/5.0
-- 🧹 DRY Prinzip: ✅ 100%
-- 📖 Lesbarkeit: ✅ 100%  
-- 🔧 Wartbarkeit: ✅ 100%
-- ⚡ Performance: ✅ 100%
-- 🧪 Testbarkeit: ✅ 100%
-
-### Development Velocity
-- **Tasks per Hour**: 2.0
-- **Average Task Time**: 0.5h
-- **Issues Found**: 0
-- **Issues Fixed**: 0
-
----
-
-## Notes & Learnings
-
-### System Validation - 2025-07-16
-- ✅ Developer Check System erfolgreich implementiert
-- ✅ `/dev` und `/checkdev` Commands funktional
-- ✅ Task-Management und Quality-Reviews integriert
-- ✅ Automatische Status-Updates funktionieren
-
-### Best Practices Established
-- Tasks haben eindeutige IDs (DEV-[SESSION]-[TASK])
-- Quality-Checkliste mit 5 Kriterien etabliert
-- Smart Review-Strategy implementiert (context-aware)
-- Metrics-Tracking für kontinuierliche Verbesserung
-
----
-
-**System Status**: ✅ READY FOR PRODUCTION  
-**Next Action**: System ist bereit für echte Development-Tasks!