❓ Preguntas Frecuentes

Kursor requiere los siguientes requisitos mínimos:

• Sistema Operativo: Windows 10/11, macOS 10.15+, o Linux (Ubuntu 20.04+)
• Java: Java 11 o superior
• Memoria RAM: 4 GB mínimo
• Espacio en disco: 500 MB libres

La instalación de Kursor es muy sencilla:

1. Descarga la última versión desde GitHub Releases
2. Extrae el archivo ZIP en una carpeta de tu elección
3. Ejecuta el script correspondiente a tu sistema:
   • Windows: kursor.bat
   • Linux/macOS: ./kursor.sh

Sí, Kursor funciona completamente sin conexión a internet.

Una vez descargado e instalado, Kursor es una aplicación de escritorio que:

• No requiere conexión a internet para funcionar
• Almacena todos los datos localmente
• Permite crear y gestionar cursos offline
• Guarda el progreso en tu dispositivo

La conexión a internet solo es necesaria para:

• Descargar actualizaciones
• Compartir cursos con otros usuarios
• Acceder a la documentación online

Para crear tu primer curso:

1. Crea un archivo con extensión .yaml en la carpeta cursos/
2. Define la estructura básica del curso (ID, título, descripción)
3. Añade bloques de preguntas con el tipo deseado
4. Guarda el archivo y selecciónalo en Kursor

Ejemplo básico:

id: mi_curso
titulo: "Mi Primer Curso"
descripcion: "Un curso de ejemplo"
bloques:
  - id: bloque_1
    titulo: "Preguntas Básicas"
    tipo: "flashcard"
    preguntas:
      - pregunta: "¿Pregunta ejemplo?"
        respuesta: "Respuesta ejemplo"

Kursor soporta actualmente 4 tipos de preguntas:

Kursor ofrece 4 estrategias de aprendizaje completamente implementadas:

Puedes cambiar la estrategia al inicio de cada sesión de aprendizaje.

Sí, Kursor está diseñado para ser extensible.

Para crear un nuevo módulo de preguntas:

1. Implementa la interfaz PreguntaModule
2. Crea las clases de dominio para tu tipo de pregunta
3. Registra el módulo en el archivo de servicios
4. Compila y añade el JAR a la carpeta modules/

Kursor está desarrollado con las siguientes tecnologías:

• Lenguaje: Java 11+
• Interfaz: JavaFX
• Persistencia: JPA/Hibernate con SQLite
• Configuración: YAML
• Logging: SLF4J + Logback
• Testing: JUnit 5
• Build: Maven

La arquitectura modular utiliza el patrón Service Provider Interface (SPI) de Java.

Kursor almacena todos los datos localmente en tu dispositivo:

• Base de datos: kursor.db (SQLite)
• Logs: Carpeta log/
• Cursos: Carpeta cursos/
• Módulos: Carpeta modules/

Todos los datos se almacenan en el directorio de instalación de Kursor.

Si Kursor no se inicia, sigue estos pasos:

1. Verifica Java: Ejecuta java -version en la terminal
2. Revisa los logs: Consulta los archivos en la carpeta log/
3. Verifica permisos: Asegúrate de que tienes permisos de escritura en el directorio
4. Reinstala: Descarga una nueva copia desde GitHub

Si el problema persiste, puedes:

• Reportar el problema en GitHub Issues
• Incluir los logs de error en tu reporte
• Especificar tu sistema operativo y versión de Java

Si tu curso no se carga, verifica:

• Formato YAML: Asegúrate de que el archivo tiene la sintaxis correcta
• Estructura: Verifica que todos los campos obligatorios están presentes
• Codificación: El archivo debe estar en UTF-8
• Ubicación: El archivo debe estar en la carpeta cursos/

Errores comunes:

• Espacios incorrectos en la indentación
• Caracteres especiales sin comillas
• Campos obligatorios faltantes
• Tipos de preguntas no soportados

Para reportar problemas o solicitar nuevas funciones:

1. Ve a GitHub Issues
2. Haz clic en "New Issue"
3. Selecciona el tipo apropiado (Bug report o Feature request)
4. Completa la plantilla con toda la información solicitada
5. Incluye logs, capturas de pantalla o ejemplos si es necesario

Información útil para incluir:

• Sistema operativo y versión
• Versión de Java
• Versión de Kursor
• Pasos para reproducir el problema
• Comportamiento esperado vs. actual