appiq-solution 1.4.8 → 1.5.0

package/#NEW APP PROMPT/ARCHITECTURE_UNIFIED.md

@@ -1,414 +0,0 @@
-# Unified Flutter Project Architecture Documentation
-
-## Overview
-
-This document combines the best practices and details from both a scalable Flutter skeleton and the AiGo project architecture. It is designed to be directly usable in modern IDEs (Cursor AI, VSCode, etc.) and provides a solid, extensible, and production-ready foundation for any modern Flutter app.
-
----
-
-## 1. High-Level Principles
-
-- **Clean Architecture**: Clear separation of UI, domain logic, and data sources.
-- **Feature Modularity**: Each feature is self-contained, following a data/domain/presentation split.
-- **State Management**: Riverpod (with annotations/codegen) for robust, testable state.
-- **Dependency Injection**: Riverpod for providers, GetIt for global services.
-- **Code Generation**: Use of freezed, json_serializable, and build_runner to reduce boilerplate.
-- **Internationalization**: Multi-language support with ARB files and codegen.
-- **Theming**: Light/dark mode with easy switching.
-- **Testing & CI/CD**: Comprehensive test setup, GitHub Actions, and Fastlane for automation.
-- **Responsiveness**: Adaptive UI for mobile, tablet, and web.
-- **Cloud Integration**: (Optional) Firebase Auth, Firestore, Storage.
-
----
-
-## 2. Folder Structure
-
-```
-lib/
-├── core/                # Core utilities and shared components
-│   ├── config/          # App configuration
-│   ├── initialization/  # App initialization logic
-│   ├── json_converters/ # JSON conversion helpers
-│   ├── locale/          # Locale handling
-│   ├── location/        # Location services
-│   ├── mixins/          # Reusable mixins
-│   ├── network/         # Network utilities
-│   ├── routing/         # Routing configuration
-│   ├── services/        # Core services
-│   ├── storage/         # Local storage
-│   ├── theme/           # Theme configuration
-│   ├── utils/           # Utility functions
-│   └── widgets/         # Shared widgets
-│
-├── data/                # Data layer
-│   ├── datasources/     # Data sources (local, remote)
-│   ├── dtos/            # Data Transfer Objects
-│   ├── mappers/         # DTO <-> domain model mappers
-│   └── repositories/    # Repository implementations
-│
-├── domain/              # Domain layer
-│   ├── models/          # Domain models
-│   ├── repositories/    # Repository interfaces
-│   └── usecases/        # Business logic use cases
-│
-├── l10n/                # Localization
-│   ├── app_*.arb        # Translation files for different languages
-│   └── generate_translations.py # Script to manage translations
-│
-├── views/               # UI components organized by feature
-│   ├── event/           # Event feature module
-│   ├── home/            # Home feature
-│   ├── place/           # Place feature
-│   ├── plan/            # Plan feature
-│   ├── profile/         # Profile feature
-│   ├── settings/        # Settings feature
-│   └── onboarding/      # Onboarding feature
-│
-├── service_locator.dart # Dependency injection (GetIt)
-├── app.dart             # App configuration
-└── main.dart            # Entry point
-
-test/
-  /features
-  /core
-  /widgets
-assets/
-  /images
-  /icons
-  /fonts
-  /translations
-.ios/
-.android/
-.github/
-  workflows/
-fastlane/
-.gitignore
-pubspec.yaml
-README.md
-analysis_options.yaml
-```
-
----
-
-## 3. Key Packages
-
-- **State Management:** riverpod, flutter_riverpod, riverpod_annotation, riverpod_generator
-- **Dependency Injection:** get_it
-- **Routing:** go_router
-- **Localization:** flutter_localizations, intl, easy_localization
-- **Theming:** flex_color_scheme or ThemeData
-- **Networking:** dio or http
-- **Model Generation:** freezed, json_serializable, build_runner
-- **CI/CD:** GitHub Actions, Fastlane
-- **Testing:** flutter_test, mocktail, integration_test
-- **Linting:** very_good_analysis or custom analysis_options.yaml
-- **Other:** flutter_svg, cached_network_image, shared_preferences, equatable
-- **Cloud (optional):** firebase_auth, cloud_firestore, firebase_storage
-
----
-
-## 4. Core Architecture
-
-### Dependency Injection
-
-- Use **GetIt** for global services.
-- Use **Riverpod** for feature-specific providers.
-
-Example:
-```dart
-final GetIt getIt = GetIt.instance;
-Future<void> setupServiceLocator() async {
-  providerContainer = ProviderContainer();
-  getIt
-    ..registerLazySingleton(() => Logger())
-    ..registerLazySingleton(() => FirebaseAuth.instance);
-  // More registrations...
-}
-```
-
-### Routing
-
-- Use GoRouter for declarative, type-safe navigation.
-- Define routes in a centralized file.
-
-Example:
-```dart
-final router = GoRouter(
-  navigatorKey: _rootNavigatorKey,
-  initialLocation: AppRoutes.initialRoute,
-  routes: [
-    ShellRoute(
-      navigatorKey: _shellNavigatorKey,
-      builder: (context, state, child) => BottomNavBar(child: child),
-      routes: [
-        GoRoute(
-          path: AppRoutes.homeRoute,
-          builder: (context, state) => const HomeScreen(),
-        ),
-        // More routes...
-      ],
-    ),
-    // More top-level routes...
-  ],
-);
-```
-
-### Localization
-
-- Use ARB files in `/l10n/` for translations.
-- Support multiple languages (e.g., en, de, ru, tr, ar).
-- Use codegen and scripts to manage translations.
-
-Example:
-```dart
-MaterialApp.router(
-  // ...
-  locale: locale,
-  localizationsDelegates: const <LocalizationsDelegate<dynamic>>[
-    AppLocalizations.delegate,
-    GlobalMaterialLocalizations.delegate,
-    GlobalWidgetsLocalizations.delegate,
-    GlobalCupertinoLocalizations.delegate,
-  ],
-  supportedLocales: const [
-    Locale('en'),
-    Locale('de'),
-    Locale('ru'),
-    Locale('tr'),
-    Locale('ar'),
-  ],
-  // ...
-)
-```
-
----
-
-## 5. Layered Architecture
-
-- **core/**: Shared utilities, themes, localization, providers, base widgets.
-- **data/**: Data sources, DTOs, mappers, repository implementations.
-- **domain/**: Entities, repository interfaces, usecases.
-- **views/**: Feature modules, each with providers, screens, widgets.
-- **l10n/**: Localization files and scripts.
-- **assets/**: Images, icons, fonts, translations.
-
----
-
-## 6. State Management with Riverpod (with Annotations)
-
-- Use `@riverpod` annotation for providers.
-- Organize providers by feature.
-
-Example:
-```dart
-@Riverpod(keepAlive: true)
-class EventDetailsNotifier extends _$EventDetailsNotifier {
-  late final EventRepository _eventRepository = getIt<EventRepository>();
-
-  @override
-  EventDetailsState build({required String eventId}) {
-    return EventDetailsState(eventId: eventId);
-  }
-
-  Future<void> loadEventDetails() async {
-    state = state.copyWith(isLoading: true, hasError: false);
-    try {
-      final event = await _eventRepository.getEventById(state.eventId);
-      // ...
-      state = state.copyWith(
-        isLoading: false,
-        hasError: false,
-        event: event,
-        travelInfo: travelInfo,
-      );
-    } catch (e) {
-      state = state.copyWith(
-        isLoading: false,
-        hasError: true,
-        errorMessage: e.toString(),
-      );
-    }
-  }
-}
-```
-
----
-
-## 7. Model Generation
-
-- Use `freezed` for immutable models and state classes.
-- Use `json_serializable` for JSON (de)serialization.
-
-Example:
-```dart
-@freezed
-class User with _$User {
-  const factory User({
-    required String id,
-    required String email,
-    // ...
-  }) = _User;
-  factory User.fromJson(Map<String, dynamic> json) => _$UserFromJson(json);
-}
-```
-
----
-
-## 8. Data Layer Example
-
-- **DTOs**: Data Transfer Objects for serialization.
-- **Mappers**: Transform between DTOs and domain models.
-- **Repositories**: Implement data access logic.
-
-Example DTO:
-```dart
-@freezed
-abstract class EventDTO with _$EventDTO {
-  factory EventDTO({
-    required String id,
-    required String title,
-    // ...
-  }) = _EventDTO;
-  factory EventDTO.fromJson(Map<String, dynamic> json) => _$EventDTOFromJson(json);
-}
-```
-
-Example Mapper:
-```dart
-class EventMapper {
-  static Event toDomain(EventDTO dto) => Event(
-    id: dto.id,
-    title: dto.title,
-    // ...
-  );
-  static EventDTO fromDomain(Event domain) {
-    // ...
-  }
-}
-```
-
----
-
-## 9. UI Layer Example
-
-- **Screens**: Full-page UI components, handle user interactions.
-- **Widgets**: Reusable UI components.
-- **Providers**: State management for UI.
-
-Example screen:
-```dart
-class EventDetailsScreen extends ConsumerStatefulWidget {
-  final String eventId;
-  const EventDetailsScreen({required this.eventId, super.key});
-  @override
-  ConsumerState<EventDetailsScreen> createState() => _EventDetailsScreenState();
-}
-
-class _EventDetailsScreenState extends ConsumerState<EventDetailsScreen> {
-  @override
-  void initState() {
-    super.initState();
-    WidgetsBinding.instance.addPostFrameCallback((_) {
-      ref.read(eventDetailsNotifierProvider(eventId: widget.eventId).notifier)
-        .loadEventDetails();
-    });
-  }
-  @override
-  Widget build(BuildContext context) {
-    final state = ref.watch(eventDetailsNotifierProvider(eventId: widget.eventId));
-    if (state.isLoading) return EventDetailsShimmer();
-    if (state.hasError) return ErrorView(message: state.errorMessage);
-    final event = state.event;
-    if (event == null) return NotFoundView();
-    return DetailScaffold(
-      title: event.title,
-      body: Column(
-        children: [
-          EventOrganizerSection(event: event),
-          EventActionButtons(event: event),
-        ],
-      ),
-    );
-  }
-}
-```
-
----
-
-## 10. Theming (Dark/Light Mode)
-
-- Define themes in `/core/theme/`.
-- Provide theme switching via Riverpod provider.
-- Use `ThemeMode.system` as default.
-
----
-
-## 11. CI/CD & Fastlane
-
-- **GitHub Actions:** for static analysis, tests, build, deploy.
-- **Fastlane:** for iOS/Android build & release automation.
-- Example workflow: `.github/workflows/flutter.yml`
-- Fastlane setup in `/fastlane/` ([Fastlane docs](https://docs.fastlane.tools/getting-started/ios/setup/)).
-
----
-
-## 12. Example pubspec.yaml (excerpt)
-
-```yaml
-dependencies:
-  flutter:
-    sdk: flutter
-  flutter_localizations:
-    sdk: flutter
-  riverpod: ^3.0.0
-  flutter_riverpod: ^3.0.0
-  riverpod_annotation: ^3.0.0
-  go_router: ^13.0.0
-  freezed_annotation: ^2.4.1
-  json_serializable: ^6.7.1
-  intl: ^0.18.1
-  flex_color_scheme: ^7.3.1
-  dio: ^5.4.0
-  shared_preferences: ^2.2.2
-  flutter_svg: ^2.0.9
-  cached_network_image: ^3.3.1
-  equatable: ^2.0.5
-dev_dependencies:
-  riverpod_generator: ^3.0.0
-  build_runner: ^2.4.7
-  freezed: ^2.4.6
-  flutter_test:
-    sdk: flutter
-  very_good_analysis: ^5.1.0
-```
-
----
-
-## 13. Additional Settings
-
-- `analysis_options.yaml` for linting.
-- `.env` for environment variables (use `flutter_dotenv` if needed).
-- README with setup, build, and contribution instructions.
-
----
-
-## 14. How to Use
-
-- Use this structure as your base.
-- Scaffold folders/files as per above.
-- Add features by duplicating the feature folder pattern.
-- Use Riverpod for all state management.
-- Generate models and providers with build_runner.
-- Add translations in `/l10n/`.
-- Set up CI/CD and Fastlane as per documentation.
-
----
-
-## 15. Best Practices & Notes
-
-- Keep features modular and isolated.
-- Use code generation to reduce boilerplate.
-- Centralize routing and localization configuration.
-- Prefer immutable state (freezed) and pure functions in domain/usecases.
-- Write tests for all business logic and UI flows.
-- Document your code and keep this architecture file up-to-date.

package/#NEW APP PROMPT/accesibility_prompt.md

@@ -1,103 +0,0 @@
-# Accessibility-System für moderne Webseiten
-
-Erstelle ein umfassendes Barrierefreiheits-System für meine Webseite mit folgenden Komponenten und Funktionen:
-
-## 1. Accessibility Provider (Kontext-System)
-
-Implementiere einen React Context Provider mit folgenden Funktionen:
-- Verwaltung der Schriftgröße (80%-150%)
-- Hochkontrast-Modus-Einstellung
-- Einstellung für reduzierte Animation/Bewegung
-- Text-to-Speech-Funktionalität
-- Speicherung der Einstellungen im localStorage
-
-Code-Struktur:
-```jsx
-'use client'
-import { createContext, useState, useEffect, useContext } from 'react'
-
-// Definiere Interface für Einstellungen
-interface AccessibilitySettings {
-  fontSize: number;
-  highContrast: boolean;
-  reducedMotion: boolean;
-  textToSpeechEnabled: boolean;
-}
-
-// Erstelle Kontext mit Funktionen
-const AccessibilityContext = createContext({/* Standardwerte */})
-
-export function AccessibilityProvider({ children }) {
-  // State-Management und Funktionen
-  // Speichern und Laden von Einstellungen
-  // Text-to-Speech-Implementierung
-  
-  return (
-    <AccessibilityContext.Provider value={/* Werte und Funktionen */}>
-      {children}
-    </AccessibilityContext.Provider>
-  )
-}
-
-export const useAccessibility = () => {
-  const context = useContext(AccessibilityContext)
-  if (!context) throw new Error('useAccessibility muss innerhalb eines AccessibilityProviders verwendet werden')
-  return context
-}
-```
-
-## 2. Accessibility Menu UI
-
-Erstelle ein schwebendes Accessibility-Menü mit folgenden Eigenschaften:
-- Positionierung in der unteren linken Ecke des Bildschirms
-- Einstellbares Popup-Menü, das links vom Button erscheint
-- Steuerelemente für alle Barrierefreiheits-Optionen
-- Responsive Design für alle Bildschirmgrößen
-- Animation für sanfte Übergänge
-
-Styling-Anweisungen:
-- Verwende Tailwind CSS für Styling
-- Runde, schwebende Schaltfläche mit Schatten-Effekt
-- Popup mit deutlichem Kontrast zum Hintergrund
-- Klare, lesbare Beschriftungen
-- Ausreichend große Bedienelemente
-
-## 3. Barrierefreie UI-Komponenten
-
-Implementiere folgende barrierefreie Komponenten:
-- AccessibleAccordion: Ausklappbare Inhalte mit Keyboard-Navigation
-- AccessibleImage: Bilder mit Alt-Text und optional Vorlese-Funktion
-- AccessibleTabs: Tab-Navigation mit Keyboard-Unterstützung
-- AccessibleTable: Tabellen mit angemessenen ARIA-Attributen
-- AccessiblePagination: Navigation mit Keyboard-Unterstützung
-- AccessibleTooltip: Barrierefreie Tooltips
-- AccessibleAlert: Benachrichtigungen für Screenreader
-- AccessibleBreadcrumbs: Navigations-Breadcrumbs
-- AccessibleDialog: Modal-Dialoge mit Trap-Focus
-- AccessibleNavigation: Hauptnavigation mit ARIA-Attributen
-- AccessibleForm: Formulare mit geeigneten Labels und Fehlermeldungen
-
-## 4. Integration und Tests
-
-Integration:
-- Binde den AccessibilityProvider im Root-Layout ein
-- Platziere das AccessibilityMenu an geeigneter Stelle
-- Verwende die barrierefreien Komponenten in der gesamten Anwendung
-
-Tests:
-- Teste mit Screenreadern (NVDA, VoiceOver)
-- Überprüfe Keyboard-Navigation
-- Teste auf verschiedenen Geräten und Bildschirmgrößen
-- Führe Kontrast- und Lesbarkeits-Tests durch
-
-## 5. Wichtige Standards und Best Practices
-
-Stelle sicher, dass deine Implementation folgende Standards erfüllt:
-- WCAG 2.1 Level AA
-- Aria-Label und Aria-Attributes
-- Semantic HTML
-- Ausreichende Kontrastverhältnisse
-- Keyboard-Navigation
-- Focus-Management
-
-Verwende die obigen Anweisungen, um ein komplettes Barrierefreiheits-System zu implementieren, das alle Nutzergruppen berücksichtigt und ihnen eine optimale Benutzererfahrung bietet.

package/#NEW APP PROMPT/clean-code.mdc

@@ -1,55 +0,0 @@
----
-description: Guidelines for writing clean, maintainable, and human-readable code. Apply these rules when writing or reviewing code to ensure consistency and quality.
-globs: 
----
-# Clean Code Guidelines
-
-## Constants Over Magic Numbers
-- Replace hard-coded values with named constants
-- Use descriptive constant names that explain the value's purpose
-- Keep constants at the top of the file or in a dedicated constants file
-
-## Meaningful Names
-- Variables, functions, and classes should reveal their purpose
-- Names should explain why something exists and how it's used
-- Avoid abbreviations unless they're universally understood
-
-## Smart Comments
-- Don't comment on what the code does - make the code self-documenting
-- Use comments to explain why something is done a certain way
-- Document APIs, complex algorithms, and non-obvious side effects
-
-## Single Responsibility
-- Each function should do exactly one thing
-- Functions should be small and focused
-- If a function needs a comment to explain what it does, it should be split
-
-## DRY (Don't Repeat Yourself)
-- Extract repeated code into reusable functions
-- Share common logic through proper abstraction
-- Maintain single sources of truth
-
-## Clean Structure
-- Keep related code together
-- Organize code in a logical hierarchy
-- Use consistent file and folder naming conventions
-
-## Encapsulation
-- Hide implementation details
-- Expose clear interfaces
-- Move nested conditionals into well-named functions
-
-## Code Quality Maintenance
-- Refactor continuously
-- Fix technical debt early
-- Leave code cleaner than you found it
-
-## Testing
-- Write tests before fixing bugs
-- Keep tests readable and maintainable
-- Test edge cases and error conditions
-
-## Version Control
-- Write clear commit messages
-- Make small, focused commits
-- Use meaningful branch names 

package/#NEW APP PROMPT/codequality.mdc

@@ -1,47 +0,0 @@
----
-description: Code Quality Guidelines
-globs: 
----
-# Code Quality Guidelines
-
-## Verify Information
-Always verify information before presenting it. Do not make assumptions or speculate without clear evidence.
-
-## File-by-File Changes
-Make changes file by file and give me a chance to spot mistakes.
-
-## No Apologies
-Never use apologies.
-
-## No Understanding Feedback
-Avoid giving feedback about understanding in comments or documentation.
-
-## No Whitespace Suggestions
-Don't suggest whitespace changes.
-
-## No Summaries
-Don't summarize changes made.
-
-## No Inventions
-Don't invent changes other than what's explicitly requested.
-
-## No Unnecessary Confirmations
-Don't ask for confirmation of information already provided in the context.
-
-## Preserve Existing Code
-Don't remove unrelated code or functionalities. Pay attention to preserving existing structures.
-
-## Single Chunk Edits
-Provide all edits in a single chunk instead of multiple-step instructions or explanations for the same file.
-
-## No Implementation Checks
-Don't ask the user to verify implementations that are visible in the provided context.
-
-## No Unnecessary Updates
-Don't suggest updates or changes to files when there are no actual modifications needed.
-
-## Provide Real File Links
-Always provide links to the real files, not x.md.
-
-## No Current Implementation
-Don't show or discuss the current implementation unless specifically requested.

package/#NEW APP PROMPT/flutter-ai-rules/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Ivanna
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.