Especificaciones Técnicas

Arquitectura & Stack Tecnológico v1.1.1

Core Technology

Desarrollado con un enfoque híbrido de alto rendimiento.

⚡

Flutter 3.38.9

Framework principal para renderizado UI nativo, gestión de estado y navegación multiplataforma.

🔥

Flame Engine ^1.35

Motor de juego 2D integrado para el manejo del loop de juego, partículas y animaciones complejas.

🧠

Provider ^6.1

Arquitectura de inyección de dependencias y gestión de estado reactiva para la lógica de negocio.

🎙️

Speech Recognition

Integración nativa (speech_to_text ^7.3) para análisis de voz en tiempo real y triggering de eventos.

Librerías & Módulos

Selección de paquetes optimizados para estabilidad y rendimiento en Android 10+.

Monetización & Analytics

  • google_mobile_ads ^7.0.0: Gestión de anuncios intersticiales y recompensados.
  • in_app_purchase ^3.2.3: Procesamiento seguro de transacciones digitales (Gacha system).

Multimedia & UX

  • audioplayers ^6.5.1: Motor de audio para SFX y música ambiental dinámica.
  • animate_do ^4.2.0: Micro-animaciones para feedback visual en UI.
  • flutter_localization ^0.3.3: Soporte i18n para internacionalización.

Utilidades del Sistema

  • shared_preferences ^2.5.4: Persistencia de datos local ligera (progreso, unlocks).
  • url_launcher ^6.3.2: Gestión de enlaces externos y políticas.
  • package_info_plus ^9.0.0: Control de versiones y metadatos del build.

Arquitectura del Proyecto

Estructura escalable basada en "Feature-First".

lib/
├── main.dart                  # Entry Point & Providers Setup
├── config/
│   ├── theme/                 # Paleta de colores y estilos globales
│   └── routes/                # Mapa de navegación
├── core/
│   ├── constants/             # Strings, Assets Paths
│   └── utils/                 # Helpers (AudioPlayer, Haptic)
├── data/
│   ├── datasources/           # Local Storage & API Mockups
│   └── repositories/          # Implementación de repositorios
├── domain/
│   ├── entities/              # Modelos (OracleEntity, Item)
│   └── usecases/              # Lógica de negocio pura
└── presentation/
    ├── widgets/               # Componentes reutilizables (Buttons, Loaders)
    └── screens/
        ├── oracle/            # Lógica del Oráculo (Voice/Flame)
        ├── shop/              # Gacha System & IAP
        ├── collection/        # Grid de Entes desbloqueados
        └── settings/          # Configuración y Legal

La arquitectura separa la capa de presentación (Flutter Widgets) de la lógica del juego (Flame Components) y la capa de datos, permitiendo escalabilidad y testeo unitario eficiente.