active v2.1.0 Laboratorio

Flashcards AI

Mazo mágico interactivo de estudio activo con giro 3D, pronunciación fonética por voz (1x y 0.75x), 3 modos de juego y generación masiva con IA.

Aplicación de estudio activo (Active Recall) y memorización bilingüe diseñada para niños (ciencias escolares, espacio, capitales) y adultos (Business English, conceptos de IA, finanzas). Incorpora giro tridimensional de tarjetas con CSS 3D, pronunciación por voz nativa con Web Speech API en velocidad normal y lenta (modo tortuga), 3 modos de estudio (Giro Leitner, Quiz Arcade 4 opciones y Modo Escritura con pistas), importación/exportación CSV RFC-4180 y autogeneración mágica en lote con Google Gemini API.

Flashcards AI

🎯Objetivos del Sistema

✓

Facilitar el estudio bilingüe multigeneracional (niños y adultos) eliminando la monotonía de los métodos tradicionales y la frialdad de pantallas vacías.

✓

Proporcionar pronunciación fonética por voz nativa (Web Speech API) con selector de velocidad dual (1.0x y modo tortuga 0.75x).

✓

Ofrecer 3 modos de estudio interactivos: Giro Clásico con Cajas Leitner, Quiz Arcade con distractores y Modo Ortográfico con pistas.

✓

Integrar generación estructurada en lote con la API de Google Gemini (gemini-2.5-flash / gemini-2.0-flash BYOK) en formato JSON.

✓

Garantizar privacidad 100% en cliente, persistencia de progreso y medallas en LocalStorage, y funcionamiento offline como PWA instalable.

⚡Capacidades Principales

🗣️

Pronunciación Fonética Dual (1.0x y Tortuga 0.75x): síntesis de voz en el navegador con Web Speech API para escuchar la pronunciación exacta sílaba a sílaba.

🎒

6 Mazos Curados en 1 Clic: barajas listas para niños (Ciencias Bilingües, Espacio, Capitales) y adultos (Business English, Conceptos IA, Estrategia MBA).

🎯

3 Modos de Estudio Adaptativos: Giro Clásico 3D con Cajas Leitner, Quiz Arcade de 4 opciones y Reto de Escritura con revelación de pistas.

⚡

Generación en Lote con Gemini: autocompleta decenas de términos, definiciones, fonética y pistas mnemotécnicas en una sola llamada JSON.

📂

Importación y Exportación CSV RFC-4180: procesa y descarga listas tabulares compatibles con Excel, soportando comas y comillas.

📲

PWA 100% Offline e Instalable: cero CDNs externos, diseño adaptativo Sunny Studio / Starlight Deck anti-FOUC y medallas de logros.

📐Arquitectura y Especificaciones de Diseño

Arquitectura cliente estricta Single-Source-of-Truth: toda la lógica de estudio, parser CSV y síntesis de audio se ejecuta de forma determinista en el navegador. La clave API de Gemini del usuario reside exclusivamente en su LocalStorage y se comunica de forma directa y segura con los endpoints de Google AI Studio sin intermediarios.

flowchart TD USER["Estudiante (Niño / Adulto)"] --> UI["Interfaz Flashcards 3D (Sunny / Starlight)"] UI -->|"Modo Manual / CSV"| PARSER["Parser/Exportador CSV RFC-4180"] UI -->|"Modo IA (Gemini Batch)"| GEMINI["Google Gemini API (gemini-2.5-flash / 2.0-flash)"] PARSER --> DECK["Gestor de Mazos (6 Curados + Personalizados)"] GEMINI --> DECK DECK -->|"Persistencia Local"| LS[("Navegador LocalStorage")] DECK --> TTS["Web Speech API (Voz 1.0x & Tortuga 0.75x)"] DECK --> MODES{"3 Modos de Juego"} MODES -->|"1"| M1["Giro 3D & Cajas Leitner"] MODES -->|"2"| M2["Quiz Arcade (4 Opciones)"] MODES -->|"3"| M3["Escritura & Pistas"] M1 --> UI M2 --> UI M3 --> UI

🔍 Haz clic en el diagrama para ampliar a pantalla completa

Principios Arquitectónicos Invariantes:

  • Privacidad y Soberanía Local: los mazos y claves API residen exclusivamente en el navegador del usuario sin analítica invasiva ni trackers de terceros.
  • Inclusión y Motivación Lúdica: colores amigables, relieve 3D táctil, confeti nativo y refuerzo sonoro para entusiasmar a niños y adultos sin formalismos rígidos.
  • Cero Dependencias de Red: eliminación total de librerías externas o CDNs, garantizando funcionamiento instantáneo y 100% offline.

🛠️Stack Tecnológico

FRONTEND

Vanilla JS (ES Modules)HTML5 SemanticCSS 3D TransformsCSS Design Tokens

PWA

Web App Manifest (PWA)Service Worker (Cache-First / Stale-While-Revalidate)SVG Vector Icon

APIS

Web Speech Synthesis API (TTS)Web Audio API (Sintetizador 8-bit)Web Storage API (LocalStorage)

AI

Google Gemini API (gemini-2.5-flash / gemini-2.0-flash via REST JSON)

HOSTING

Hugo Static Engine (/apps/flashcards/)Shims SEO Retrocompatibles (/es/, /en/)

📚Artículos de Referencia & Documentación de Construcción

Esta aplicación está respaldada por una serie técnica publicada paso a paso en el blog:

Programando con IA: Creando mi Propia App mágica de Flashcards para Estudiar
Parte 1

Programando con IA: Creando mi Propia App mágica de Flashcards para Estudiar

Ayudando a mi hijo a estudiar ciencias en inglés, me di cuenta de que necesitábamos algo más que tapar la hoja con la mano. Así …

Leer artículo completo →

⏱️Historial Evolutivo & Versiones (SemVer)

Registro formal de entregas, características y revisiones de seguridad:

v2.1.0 2026-11-06 RELEASE

Flashcards v2.1.0: PWA Offline Completa, Suite de Iconos Maskable, Instalación Universal y Actualización In-App

  • Suite completa de 6 iconos PNG y SVG con soporte nativo de capa maskable (192px y 512px) y apple-touch-icon para Android e iOS.
  • Actualización de Service Worker v2.1.0 con soporte skipWaiting, precaché integral de iconos y recarga instantánea via controllerchange.
  • Botón de instalación PWA universal en barra superior con detección inteligente de standalone y guía en toast para Safari en iOS.
  • Badge interactivo #btn-check-update (v2.1.0) para comprobación manual de versión y banner flotante #pwa-update-banner.
  • Empaquetado Single-File Inline: inyección directa de CSS y módulos JS en index.html, eliminando peticiones sueltas y asegurando carga offline instantánea.
  • Sistema flotante de notificaciones Toasts (#toast-container) para feedback lúdico, logros y estados de la app.
v2.0.0 2026-11-06 RELEASE

Evolución a Mazo Mágico v2.0: Audio Fonético, 6 Mazos Curados, 3 Modos y Gemini Batch

  • Cierre de drift de contrato: integración de síntesis de voz Web Speech API con velocidad normal (1.0x) y modo tortuga (0.75x) para practicar pronunciación bilingüe.
  • 6 mazos pre-cargados para niños (Ciencias del Cuerpo Humano, Espacio, Capitales) y adultos (Business English, Conceptos IA, Estrategia MBA).
  • 3 modos de estudio interactivos: Giro 3D con Cajas Leitner, Quiz Arcade de 4 opciones y Reto de Escritura con pistas ortográficas progresivas.
  • Migración de la API de Gemini a llamadas en lote estructuradas en JSON (gemini-2.5-flash con fallback a gemini-2.0-flash), acelerando 10x la generación de cartas.
  • Parser y exportador CSV estándar RFC-4180 con descarga de mazos y plantillas de ejemplo descargables.
  • PWA 100% Offline: manifest.json, sw.js, icono vectorial y erradicación total de CDNs externos (Tailwind y Giphy).
  • Persistencia completa de mazos, récords y 6 medallas coleccionables en LocalStorage con lluvia de confeti en Canvas.
  • Shims de redirección SEO en /es/ y /en/ con reparación de errata UTF-g.
v1.0.0 2025-10-17 RELEASE

Lanzamiento oficial inicial de Flashcards con motor IA de Gemini

  • Integración básica con API de Gemini y animación de tarjeta 3D.

¿Quieres profundizar en esta arquitectura o proponer nuevas mejoras?

Si te interesa implementar esta arquitectura en tu organización, explorar adaptaciones a medida o tienes propuestas para evolucionar la aplicación, escríbeme directamente.

También puedes escribirme a través del formulario de contacto (contacto@datalaria.com).