Work information

Title Mg4x (código fuente)
MG 4x: Código Fuente y Algoritmos
Documentación de Desarrollo

Propietario: Alfredo Lápiz (Alfredo de Jesús Blanco)
Desarrollador: Jesus Blanco
Fecha: Febrero 2026

1. Estructura del Proyecto (Flutter/Dart)
El código fuente está organizado siguiendo la arquitectura limpia propuesta para aplicaciones Flutter escalables:
lib/
├── main.dart # Punto de entrada y configuración de temas
├── domain/ # Lógica de negocio pura (independiente de UI)
│ ├── braille_alphabet.dart # Mapeo de caracteres a puntos Braille/PRD
│ └── calculator_logic.dart # Algoritmos de cálculo y validación
├── game/ # Núcleo del juego
│ ├── engine/
│ │ └── game_engine.dart # Máquina de estados del juego (Niveles, Vidas, Puntos)
│ ├── models/
│ │ └── level_model.dart # Definición de datos para niveles
│ └── screens/
│ └── game_screen.dart # Interfaz principal de juego (UI)
├── widgets/
│ └── braille_keyboard.dart # Componente de teclado interactivo personalizado
└── core/ # Servicios transversales
├── audio/ # Gestión de efectos de sonido y TTS
└── persistence/ # Guardado de progreso local
```

### 2. Algoritmos Clave

#### 2.1. Motor de Validación Braille (`braille_alphabet_prd.dart`)
El núcleo del sistema es un mapa de hash bidireccional que convierte combinaciones de puntos (Listas de enteros `[1,2,4,5]`) en caracteres ASCII y viceversa. Este módulo soporta dos modos de operación simultáneos:
* **Modo Braille:** Estándar internacional (ISO).
* **Modo PRD:** Lógica numérica reversible propietaria.

2.2. Generación Procedural de Niveles (`game_engine.dart`)
A diferencia de juegos estáticos, MG 4x genera desafíos matemáticos en tiempo real basándose en el nivel del usuario.
Nivel 1-2:** Selección aleatoria de diccionarios predefinidos.
Nivel 3-6:** Generación algorítmica de operaciones (`A op B = ?`) con validación de complejidad para asegurar que el resultado sea representable en el teclado limitado.
2.3. Teclado Virtual con Feedback Hápico (`braille_keyboard.dart`)
Implementación de un `GestureDetector` complejo que permite la entrada multitáctil (acordes) y secuencial. El algoritmo de "debounce" asegura que las pulsaciones rápidas se registren como una sola "letra" Braille, imitando la escritura en una máquina Perkins.

3. Dependencias Clave
* `flutter_tts`: Para la síntesis de voz (Accesibilidad).
* `shared_preferences`: Para la persistencia de datos (Progreso del jugador).
* `provider` / `flutter_bloc`: Gestión de estado (implícita en la arquitectura).

4. Licencia de Uso
Este código fuente es propiedad intelectual de **Alfredo Lápiz**. Se prohíbe su copia, distribución, ingeniería inversa o uso comercial sin autorización escrita explícita.
Work type Source Code
Tags desarrollo móvil. prd, código fuente, software propietario, audioplayers, lógica musical, mg4x, estructura de software, punto reversible digital., alfredo lapiz, motor de audio, flutter, algoritmo braille, game engine, código educativo, app desarrollo, dart, programación, integración multimedia, lógica matemática

-------------------------

Registry info in Safe Creative

Identifier 2602104522600
Entry date Feb 10, 2026, 8:59 PM UTC
License All rights reserved

-------------------------

Copyright registered declarations

Author. Holder Alfredo Lápiz. Date Feb 10, 2026.


Information available at https://www.safecreative.org/work/2602104522600-mg4x-codigo-fuente-