iTeaching 2.0 — Aula Virtual Plataforma de gestión académica que permite la interacción entre administradores, profesores y estudiantes. Incluye gestión de asignaturas, materiales, tareas, foros, valoraciones anónimas con moderación de contenido por IA, y más.
Tecnología Versión Java 17 Spring Boot 3.2.5 Spring Security 6.x Spring Data JPA 3.x JJWT 0.12.5 MySQL 8.0 H2 (desarrollo) Runtime Lombok — Maven Wrapper —
Tecnología Versión React 18.2.0 TypeScript 4.9.5 Vite 2.9.18 Tailwind CSS 3.4.3 Axios 0.27.2 React Router DOM 6.23.1
┌────────────────────┐ ┌──────────────────────┐ ┌────────────┐ │ Frontend │──────▶│ Backend │──────▶│ Database │ │ React + Vite │ :5173 │ Spring Boot REST │ :8081 │ H2 / MySQL│ │ Tailwind CSS │ │ JWT Authentication │ │ │ └────────────────────┘ │ Content Moderation │ └────────────┘ └──────────────────────┘ Frontend se conecta al backend a través de un proxy Vite (/api → http://localhost:8081).Autenticación mediante tokens JWT (Bearer) en cabecera Authorization.Base de datos : H2 en memoria para desarrollo local, MySQL 8.0 para producción. Java 17 (JDK): Descargar Node.js (compatible con Vite 2.9)Docker (opcional, para MySQL en producción) Perfil local (H2 en memoria — desarrollo) cd application $env: JAVA_HOME = " C:\Program Files\Java\jdk-17" mvnw.cmd spring- boot:run " -Dspring-boot.run.profiles=local" Nota: los scripts start.ps1 (Windows) y start.sh (macOS/Linux) ejecutan las instalaciones necesarias de npm para el frontend por ti, por lo que generalmente no es imprescindible correr npm install manualmente. Si arrancas el frontend directamente (npm run dev), ejecuta npm install primero.
El backend estará disponible en http://localhost:8081.
La consola H2 estará accesible en http://localhost:8081/h2-console:
JDBC URL : jdbc:h2:mem:iteachingUser : saPassword : (vacío) Perfil por defecto (MySQL — producción) cd application $env: JAVA_HOME = " C:\Program Files\Java\jdk-17" mvnw.cmd spring- boot:run Puerto: 8080. Requiere MySQL corriendo en localhost:3306 (ver Docker ).
cd application $env: JAVA_HOME = " C:\Program Files\Java\jdk-17" mvnw.cmd clean compile cd frontend npm install npm run dev El frontend estará disponible en http://localhost:5173.
cd frontend npx vite build Los artefactos se generan en frontend/dist/.
cd application docker compose up - d Levanta MySQL 8.0 con:
Base de datos : iteachingUsuario : myuser / secretRoot : verysecretPuerto : 3306 Perfil Puerto Base de Datos DDL-Auto H2 Console local8081 H2 en memoria create-dropSí default8080 MySQL localhost:3306 updateNo
Al arrancar la aplicación, se crean automáticamente tres cuentas de prueba:
Usuario Contraseña Rol adminAdmin1234ROLE_ADMIN profesorProfe123!ROLE_PROFESOR estudianteEstud123!ROLE_ESTUDIANTE
Base URL: http://localhost:8081/api (perfil local)
Autenticación (/api/auth) — Pública Método Ruta Descripción POST /api/auth/registerRegistrar usuario POST /api/auth/loginLogin (devuelve JWT)
Método Ruta Descripción GET /api/usuariosListar usuarios GET /api/usuarios/{id}Obtener por ID GET /api/usuarios/meUsuario actual GET /api/usuarios/search?q=Buscar usuarios
Asignaturas (/api/asignaturas) Método Ruta Descripción GET /api/asignaturasListar todas GET /api/asignaturas/{id}Obtener por ID GET /api/asignaturas/search?q=Buscar POST /api/asignaturasCrear PUT /api/asignaturas/{id}Actualizar DELETE /api/asignaturas/{id}Eliminar POST /api/asignaturas/import-csvImportar desde CSV POST /api/asignaturas/{id}/profesores/{personaId}Asignar profesor DELETE /api/asignaturas/{id}/profesores/{personaId}Desasignar profesor POST /api/asignaturas/{id}/estudiantes/{personaId}Matricular estudiante DELETE /api/asignaturas/{id}/estudiantes/{personaId}Desmatricular estudiante POST /api/asignaturas/{id}/inscribirseAuto-inscripción DELETE /api/asignaturas/{id}/desinscribirseAuto-desinscripción
Clases Particulares (/api/clases) Método Ruta Descripción GET /api/clasesListar todas GET /api/clases/{id}Obtener por ID GET /api/clases/alumno/{username}Por estudiante GET /api/clases/profesor/{username}Por profesor GET /api/clases/estado/{estado}Por estado POST /api/clasesCrear PATCH /api/clases/{id}/estado?estado=Cambiar estado DELETE /api/clases/{id}Eliminar
Valoraciones (/api/valoraciones) — Anónimas Método Ruta Descripción GET /api/valoracionesListar todas GET /api/valoraciones/profesor/{id}Por profesor GET /api/valoraciones/asignatura/{id}Por asignatura GET /api/valoraciones/profesor/{pid}/asignatura/{aid}Por profesor+asig GET /api/valoraciones/profesor/{id}/promedioPromedio profesor POST /api/valoracionesCrear (ESTUDIANTE) DELETE /api/valoraciones/{id}Eliminar (ADMIN)
Materiales (/api/materiales) Método Ruta Descripción GET /api/materialesListar todos GET /api/materiales/{id}Obtener por ID GET /api/materiales/autor/{autorId}Por autor GET /api/materiales/mis-materialesMis materiales GET /api/materiales/asignatura/{id}Por asignatura GET /api/materiales/search?q=Buscar POST /api/materialesCrear PUT /api/materiales/{id}Actualizar DELETE /api/materiales/{id}Eliminar
Método Ruta Descripción GET /api/anuncios/asignatura/{id}Por asignatura GET /api/anuncios/{id}Obtener por ID POST /api/anunciosCrear DELETE /api/anuncios/{id}Eliminar
Método Ruta Descripción GET /api/tareas/asignatura/{id}Por asignatura GET /api/tareas/{id}Obtener por ID POST /api/tareasCrear DELETE /api/tareas/{id}Eliminar
Método Ruta Descripción GET /api/entregas/tarea/{tareaId}Por tarea GET /api/entregas/mis-entregasMis entregas POST /api/entregasEntregar PATCH /api/entregas/{id}/calificar?calificacion=&comentario=Calificar
Método Ruta Descripción GET /api/foro/asignatura/{id}Temas por asignatura GET /api/foro/temas/{id}Tema con respuestas POST /api/foro/temasCrear tema POST /api/foro/respuestasCrear respuesta DELETE /api/foro/temas/{id}Eliminar tema DELETE /api/foro/respuestas/{id}Eliminar respuesta
Método Ruta Descripción GET /api/grupos/asignatura/{id}Por asignatura GET /api/grupos/{id}Obtener por ID POST /api/gruposCrear PUT /api/grupos/{id}Actualizar DELETE /api/grupos/{id}Eliminar POST /api/grupos/{id}/miembros/{personaId}Añadir miembro DELETE /api/grupos/{id}/miembros/{personaId}Quitar miembro
Método Ruta Descripción GET /api/carpetas/asignatura/{id}Todas por asignatura GET /api/carpetas/asignatura/{id}/rootCarpetas raíz GET /api/carpetas/{id}/subcarpetasSubcarpetas GET /api/carpetas/{id}Obtener por ID POST /api/carpetasCrear PUT /api/carpetas/{id}Actualizar DELETE /api/carpetas/{id}Eliminar
Administración (/api/admin) — Solo ADMIN Método Ruta Descripción PATCH /api/admin/clases/{id}/cancelarCancelar clase fraudulenta GET /api/admin/audit-logsLogs de auditoría GET /api/admin/audit-logs/user/{user}Logs por usuario
┌──────────┐ ┌──────────────┐ ┌────────────┐ │ Usuarios │◄──────│ Persona │ │ Asignatura │ │ (base) │ │ (herencia) │──M:N──│ │ │ id, user│ │ nombre, email│ │ nombre,cod │ │ role │ │ puntuacion │ │ creditos │ └──────────┘ └──────────────┘ └────────────┘ │ │ ┌─────┴─────┐ ┌─────┴─────┐ ▼ ▼ ▼ ▼ ┌──────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ Clase │ │Valorac.│ │ Tarea │ │Material│ │ particular│ │anónima │ │ │ │ │ └──────────┘ └────────┘ └────────┘ └────────┘ │ ▼ ┌──────────┐ │ Entrega │ │(alumno+ │ │ tarea) │ └──────────┘ Entidad Tabla Descripción UsuariosusersEntidad base (herencia JOINED): id, username, role PersonapersonasExtiende Usuarios: nombre, apellido, email, teléfono AsignaturaasignaturasAsignatura con profesores y estudiantes (M:N) ClaseclasesClase particular alumno↔profesor con estados ValoracionvaloracionesValoración anónima de profesor por asignatura MaterialmaterialesMaterial didáctico con tipo (APUNTE, VIDEO, etc.) AnuncioanunciosAnuncio dentro de una asignatura TareatareasTarea o actividad de una asignatura EntregaentregasEntrega de un estudiante para una tarea ForoTemaforo_temasTema de foro dentro de una asignatura ForoRespuestaforo_respuestasRespuesta a un tema de foro GrupogruposGrupo de teoría o práctica CarpetacarpetasCarpeta jerárquica por asignatura AuditLogaudit_logsRegistro de auditoría de acciones
Enum Valores RoleROLE_ADMIN, ROLE_PROFESOR, ROLE_ESTUDIANTE EstadoClaseSOLICITADA, ACEPTADA, RECHAZADA, CANCELADA, COMPLETADA TipoMaterialDefinido en Material.java TipoGrupoTEORIA, PRACTICA
Login en /api/auth/login devuelve un token JWT. El token se envía en la cabecera Authorization: Bearer <token>. Expiración: 24 horas. Sesiones stateless (sin cookies de sesión). Política de Contraseñas (ENS) Mínimo 8 caracteres Al menos una mayúscula, una minúscula, un dígito y un carácter especial No puede contener el nombre de usuario Control de Acceso por Roles Rol Permisos ROLE_ADMINGestión completa: usuarios, asignaturas, clases, logs de auditoría ROLE_PROFESORGestión de sus asignaturas, materiales, tareas, calificaciones ROLE_ESTUDIANTEInscripción, entregas, valoraciones anónimas, foro
CORS : Solo localhost:5173 y localhost:3000CSRF : Deshabilitado (protección JWT)HSTS : 1 año, incluye subdominiosX-Content-Type-Options : nosniffCache-Control : no-cache, no-storeBloqueo de cuenta : Tras 5 intentos fallidos en 15 minutosAuditoría : Registro de acciones en AuditLog Moderación de Contenido (IA) Las valoraciones de profesores pasan por un sistema de moderación heurístico basado en IA (ContentModerationService) que analiza múltiples capas:
Longitud : Mínimo 10 caracteres, máximo 2000Mayúsculas excesivas : Bloquea textos con >60% en mayúsculasPalabras prohibidas : Diccionario de insultos y vulgaridades (ES/EN)Detección de leet speak : Convierte sustituciones (0→o, 1→i, 3→e, @→a, etc.)Patrones ofensivos : Regex para ataques personales, deseos negativos, etc.Puntuación excesiva : Bloquea uso excesivo de !!! o ??? Se aplica tanto al comentario como a los puntos de mejora.
application-iTeaching/ ├── application/ # Backend (Spring Boot) │ ├── compose.yaml # Docker Compose (MySQL) │ ├── mvnw.cmd # Maven Wrapper (Windows) │ ├── pom.xml # Dependencias Maven │ └── src/main/java/iteaching/app/ │ ├── application/ # Clase principal │ │ └── Application.java │ ├── config/ │ │ └── DataSeeder.java # Datos iniciales (3 cuentas demo) │ ├── controller/ # Controladores REST │ │ ├── AdminController.java │ │ ├── AnuncioController.java │ │ ├── AsignaturaController.java │ │ ├── AuthController.java │ │ ├── CarpetaController.java │ │ ├── ClaseController.java │ │ ├── EntregaController.java │ │ ├── ForoController.java │ │ ├── GrupoController.java │ │ ├── MaterialController.java │ │ ├── PersonaController.java │ │ ├── TareaController.java │ │ └── ValoracionController.java │ ├── dto/ # DTOs (Data Transfer Objects) │ │ ├── AnuncioDTO.java │ │ ├── AsignaturaDTO.java │ │ ├── AuthResponse.java │ │ ├── CarpetaDTO.java │ │ ├── ClaseCreateRequest.java │ │ ├── ClaseDTO.java │ │ ├── EntregaDTO.java │ │ ├── ForoRespuestaDTO.java │ │ ├── ForoTemaDTO.java │ │ ├── GrupoDTO.java │ │ ├── LoginRequest.java │ │ ├── MaterialDTO.java │ │ ├── RegisterRequest.java │ │ ├── TareaDTO.java │ │ ├── UsuarioDTO.java │ │ └── ValoracionDTO.java │ ├── exception/ │ │ └── GlobalExceptionHandler.java │ ├── Models/ # Entidades JPA │ │ ├── Anuncio.java │ │ ├── Asignatura.java │ │ ├── AuditLog.java │ │ ├── Carpeta.java │ │ ├── Clase.java │ │ ├── Entrega.java │ │ ├── EstadoClase.java │ │ ├── ForoRespuesta.java │ │ ├── ForoTema.java │ │ ├── Grupo.java │ │ ├── Material.java │ │ ├── Persona.java │ │ ├── Tarea.java │ │ ├── Usuarios.java │ │ └── Valoracion.java │ ├── repository/ # Repositorios Spring Data │ ├── security/ # Configuración de seguridad │ │ ├── CustomUserDetailsService.java │ │ ├── JwtAuthenticationFilter.java │ │ ├── JwtUtil.java │ │ ├── PasswordPolicyValidator.java │ │ └── SecurityConfig.java │ └── service/ # Lógica de negocio │ ├── ContentModerationService.java # IA moderación │ └── ...Service.java │ ├── frontend/ # Frontend (React + Vite) │ ├── package.json │ ├── vite.config.ts │ ├── tailwind.config.js │ ├── tsconfig.json │ └── src/ │ ├── App.tsx # Router y rutas │ ├── main.tsx # Punto de entrada │ ├── api/ │ │ ├── client.ts # Axios con interceptor JWT │ │ └── endpoints.ts # Funciones API tipadas │ ├── components/ │ │ ├── Layout.tsx # Layout principal │ │ └── PrivateRoute.tsx # Ruta protegida │ ├── context/ │ │ └── AuthContext.tsx # Estado de autenticación │ ├── pages/ │ │ ├── LoginPage.tsx │ │ ├── RegisterPage.tsx │ │ ├── DashboardPage.tsx │ │ ├── AsignaturasPage.tsx │ │ ├── AsignaturaDetailPage.tsx │ │ ├── ClasesPage.tsx │ │ ├── MaterialesPage.tsx │ │ ├── ValoracionesPage.tsx │ │ └── UsuariosPage.tsx │ └── types/ │ └── index.ts # Interfaces TypeScript │ └── README.md Proyecto académico — iTeaching 2.0.
Arranque de los dos servicios (Front y back) powershell -ExecutionPolicy Bypass -File .\start.ps1
bash start.sh