Loading repository data…
entreunosyceros / repository
forja-de-ejercicios
La máquina de ejercicios: genera ejercicios prácticos aleatorios, permite practicar en Docker y corrige automáticamente.
#css#dockerfile#gemini#html#ifct#java
Live repository statistics
★ 1Stars
⑂ 0Forks
◯ 0Open issues
◉ 1Watchers
65/100
OPENREPOHUB HEALTH SIGNAL
Healthy signals
A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
72
Community adoption25% weight
0
Maintenance state20% weight
100
License clarity10% weight
100
Project information10% weight
100
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview
Forja de ejercicios — luego es tarde... para estudiar
Genera ejercicios prácticos al azar (informática, idiomas u otras materias desde PDF), permite practicar en Docker y corrige la respuesta del alumno con criterios verificables. La interfaz es Spring Boot; la generación y corrección las hace Python (generador.py, evaluador.py, modelo_ejercicio.py, tipo_materia.py).
📘 Documentación ampliada: doc_app/README.md · guías por rol (alumno.txt · profesor.txt) · ayuda en la web (/como-funciona). DeepWiki es complementaria.
Inicio rápido
Instalar
| Sistema | Comando |
|---|---|
| Linux / macOS | chmod +x install.sh iniciar-forja.sh && ./install.sh |
| Windows | install.bat (doble clic o desde cmd/PowerShell) |
Detalle (Windows, Docker, arranque manual): doc_app/instalacion.md.
Arrancar
| Sistema | Comando |
|---|---|
| Linux / macOS | ./iniciar-forja.sh |
| Windows | .\iniciar-forja.bat |
Abre http://localhost:8080 cuando veas Started AplicacionForjaExamenes.
Acceso
| Rol | Usuario | Contraseña |
|---|---|---|
| Alumno | alumno | practica |
| Alumno (demo) | demo | demo |
| Profesor | profesor | profesor |
Prueba rápida (2 minutos)
- Inicia sesión como alumno (
alumno/practica). - En la portada, pulsa el módulo POO (o «Empezar ahora»).
- Escribe tu solución (con resaltado de sintaxis) y pulsa Enviar.
- Verás la nota (0–10), la retroalimentación y tu respuesta corregida.
- En la portada aparece tu progreso y estadísticas.
Documentación
| Tema | Enlace |
|---|---|
| Índice completo | doc_app/README.md |
| Instalación y arranque | instalacion.md |
| Uso (alumno / profesor) | guia-usuario.md |
| Aula con PCs independientes | aula-compartida.md |
| Cuenta y perfil | cuenta-perfil.md |
| Revisión del banco (IA) | revision-banco.md |
| Módulos y corrección | modulos-y-correccion.md |
| Apuntes PDF + Gemini | apuntes-gemini.md |
| Arquitectura | arquitectura.md |
| Configuración | configuracion.md |
| Problemas frecuentes | problemas-frecuentes.md |
| Desarrollo y pruebas | desarrollo.md |
| PDFs de apuntes (carpeta) | documentacion/README.md |
Resumen
- Alumno: elige módulo, practica, recibe corrección automática; opcionalmente importa el banco del profesor y exporta su entrega.
- Profesor: practica igual, revisa propuestas de IA, aprueba ejercicios, exporta el banco y hace seguimiento de la clase.
- Sin Gemini: los módulos clásicos (
poo,bd_sql,docker…) funcionan sin clave API. - Con Gemini: sube PDFs a
documentacion/para módulosdocs_*(ver apuntes-gemini.md).
En el aula cada PC suele tener su propia instalación; el intercambio es por carpeta compartida (banco y entregas). Ver aula-compartida.md.
Licencia
Creado por entreunosyceros para el ICFT0112. Ver LICENSE y desarrollo.md.