https://github.com/darkusphantom/plataforma-geografia-quest
Exámen con tematica de Geografía para estudiantes de primer año del colegio
https://github.com/darkusphantom/plataforma-geografia-quest
Last synced: about 17 hours ago
JSON representation
Exámen con tematica de Geografía para estudiantes de primer año del colegio
- Host: GitHub
- URL: https://github.com/darkusphantom/plataforma-geografia-quest
- Owner: darkusphantom
- Created: 2026-05-19T17:36:29.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-05-22T16:03:22.000Z (24 days ago)
- Last Synced: 2026-05-22T20:29:12.999Z (24 days ago)
- Language: TypeScript
- Homepage: https://plataforma-geografia-quest.vercel.app
- Size: 135 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Plataforma de Geografía - Primer Año
Plataforma web educativa interactiva basada en el modelo CDAVA (Medina, 2005) para la enseñanza de Geografía a estudiantes de primer año de educación media general (13-14 años).
## 🚀 Características Principales
- **Diseño Mobile-First**: Interfaz optimizada para teléfonos móviles, tablets y escritorio, utilizando Tailwind CSS.
- **Contenido Dinámico**: Todo el material de estudio, actividades y el glosario se alimentan de un único archivo estructural `data.json`.
- **Glosario Interactivo**: Las palabras clave dentro del texto se resaltan y muestran su definición mediante un Tooltip al hacer clic o pasar el mouse.
- **Múltiples Evaluaciones**: Soporta actividades interactivas integradas:
- Preguntas de Respuesta Libre (búsqueda inteligente de palabras clave).
- Preguntas de Verdadero/Falso.
- Actividades de Relacionar Conceptos (Matching).
- **Sistema de Calificación Dual**: Genera puntuaciones de 0 a 100 acompañadas de emojis motivacionales (✅, 😊, ❌) basados en el rendimiento.
- **Persistencia de Datos**: Guarda automáticamente el progreso del estudiante (actividades completadas y puntuaciones) en el almacenamiento local del navegador (`localStorage`), permitiendo retomar el estudio sin necesidad de una base de datos o registro de usuario.
## 🛠 Tecnologías Utilizadas
- **React 18**
- **Vite**
- **Tailwind CSS** (Configurado con paleta de colores personalizada)
- **JavaScript/JSX**
## 💻 Instalación y Uso Local
1. Clona este repositorio o descarga los archivos.
2. Abre una terminal en la carpeta del proyecto (`plataforma-geografia`).
3. Instala las dependencias:
```bash
npm install
```
4. Inicia el servidor de desarrollo:
```bash
npm run dev
```
5. Abre tu navegador en la URL indicada (usualmente `http://localhost:5173`).
## 🌐 Despliegue (Deploy)
El proyecto está optimizado para ser desplegado fácilmente en plataformas gratuitas como **Vercel** o **Netlify**.
1. Sube el código a un repositorio de GitHub.
2. Conecta el repositorio a Vercel/Netlify.
3. La configuración por defecto de Vite será detectada automáticamente (`npm run build` y directorio `dist`).
## 📁 Estructura del Proyecto
- `/src/data/data.json`: Contiene toda la información teórica, preguntas y glosario.
- `/src/components/`: Componentes modulares de React (tarjetas, renderizador de contenido, actividades, etc).
- `/src/hooks/`: Hooks personalizados (`useGlossary` para tooltips y `useProgress` para guardar en localStorage).
- `/src/utils/`: Funciones puras de lógica (evaluación de texto, generación de feedback).