🔨 SkillsForge - Sistema de Gestión de Talleres

SkillsForge es una plataforma integral para la gestión y participación en talleres de formación profesional. Desarrollado con Next.js (frontend) y Flask (backend) con MongoDB como base de datos.

🎯 Prototipo de Prueba

📋 Tabla de Contenidos

• 🎯 Cumplimiento de Lineamientos
• ✨ Características
• 🛠️ Tecnologías
• 🚀 Instalación
• ⚙️ Configuración
• 📖 Uso
• 🛡️ Seguridad y Rate Limiting
• 🔌 API Endpoints
• 📁 Estructura del Proyecto
• 🚀 Despliegue
• 🔧 Solución de Problemas
• 📑 Documentación Técnica
• 🏗️ Arquitectura
• 🗄️ Base de Datos
• 🔐 Seguridad y Rate Limiting
• 🔌 API Documentacion
• 🚀 Despliegue
• 📝 Requisitos Solicitados / Distribucion

📸 ScreenShot de la UI

🎯 Cumplimiento de Lineamientos

✅ Gestión de Talleres de Formación Profesional

Requisito	Estado	Implementación	Código
Ver lista de talleres	✅ Completo	Lista con nombre, fecha, hora, lugar y tipo	app/estudiantes/talleres/page.tsx
Registrar un taller (admin)	✅ Completo	Formulario con todos los campos requeridos	components/formulario-taller.tsx
Modificar un taller (admin)	✅ Completo	Edición completa con validaciones	app/admin/page.tsx
Cancelar un taller (admin)	✅ Completo	Eliminación con confirmación	app/admin/page.tsx
Registrarse a un taller (estudiante)	✅ Completo	Inscripción con control de cupos	components/boton-inscripcion.tsx

✅ API RESTful - Endpoints Implementados

Endpoint	Método	Estado	Implementación	Código
/workshops	GET	✅ Completo	Obtener todos los talleres	backend/app.py
/workshops/{id}	GET	✅ Completo	Obtener taller específico	backend/app.py
/workshops	POST	✅ Completo	Crear nuevo taller (admin)	backend/app.py
/workshops/{id}	PUT	✅ Completo	Modificar taller (admin)	backend/app.py
/workshops/{id}	DELETE	✅ Completo	Eliminar taller (admin)	backend/app.py
/workshops/{id}/register	POST	✅ Completo	Registrar estudiante	backend/app.py

✅ Interfaz Web - Componentes Funcionales

Componente	Estado	Descripción	Código
Portal Estudiantes	✅ Completo	Ver talleres y registrarse	app/estudiantes/talleres/page.tsx
Panel Administradores	✅ Completo	Gestión completa de talleres	app/admin/page.tsx
Formularios React	✅ Completo	Crear/editar talleres	components/formulario-taller.tsx
Tablas React	✅ Completo	Listado de talleres	components/tabla-talleres.tsx

🛠️ Tecnologías Requeridas - Implementación

Tecnología	Estado	Versión	Implementación
Backend: Flask	✅ Completo	3.0.3	backend/app.py
Frontend: React	✅ Completo	Next.js 15	app/
Base de datos: MongoDB	✅ Completo	6.0	docker-compose.yml
Autenticación: JWT	✅ Completo	PyJWT 2.9.0	backend/app.py
Docker	✅ Completo	Docker Compose	docker-compose.yml
PyMongo	✅ Completo	4.8.0	backend/requirements.txt

🧪 Extras Implementados

Extra	Estado	Descripción	Código	Comando
Documentación Técnica	✅ Completo	Arquitectura, BD y despliegue	docs/documentacion-tecnica.md	-
Rate Limiting	✅ Completo	Protección anti-spam	backend/app.py:35-55	-
Refresh Tokens	✅ Completo	Renovación automática de tokens	backend/app.py:470-550	-

🔍 Validación de Cumplimiento

✅ Códigos de Estado HTTP Correctos

• 200 OK: Operaciones exitosas - backend/app.py:604
• 201 Created: Recursos creados - backend/app.py:659
• 400 Bad Request: Datos inválidos - backend/app.py:625
• 401 Unauthorized: No autenticado - backend/app.py:210
• 403 Forbidden: Sin permisos - backend/app.py:215
• 404 Not Found: Recurso no encontrado - backend/app.py:880
• 409 Conflict: Conflicto de recursos - backend/app.py:740
• 429 Too Many Requests: Rate limit - backend/app.py:860

✅ Respuestas en JSON

Todas las respuestas de la API están en formato JSON - backend/app.py:15

✅ Autenticación JWT con Roles

• Administradores: backend/app.py:200-230
• Estudiantes: backend/app.py:232-280
• Refresh Tokens: backend/app.py:470-550

🚀 Funcionalidades Adicionales Implementadas

✅ Tokens

• Backend: Generación y validación - backend/app.py:470-550
• Cliente API: Retry inteligente - lib/api.ts:80-120

✅ Rate Limiting

• Configuración: Redis + Flask-Limiter - backend/app.py:35-55
• Límites por Endpoint: Diferentes límites según uso - backend/app.py:543+
• Manejo de Errores: Respuestas 429 con retry-after - backend/app.py:860-870

✅ Seguridad

• Headers de Seguridad: X-Frame-Options, X-XSS-Protection - backend/app.py:850-860
• Validación de Entrada: Sanitización y validación - backend/app.py:620-640

✅ Cliente API Inteligente

• Retry Automático: En rate limits y errores de red - lib/api.ts:45-80
• Manejo de Tokens: Renovación automática - lib/api.ts:120-150
• Timeout Configurable: Prevención de requests colgados - lib/api.ts:25-45

✨ Características

🎯 Cumplimiento de Requisitos Funcionales

✅ Gestión de Talleres de Formación Profesional

• Ver lista de talleres: Lista completa con nombre, fecha, hora, lugar y tipo de actividad
• Registrar un taller (solo administradores): Crear talleres con todos los campos requeridos
• Modificar un taller (solo administradores): Editar detalles de talleres existentes
• Cancelar un taller (solo administradores): Eliminar talleres que no se realizarán
• Registrarse a un taller (solo estudiantes): Inscripción con validación de cupos

✅ API RESTful Completa

• GET /workshops → Obtener todos los talleres disponibles
• GET /workshops/{id} → Obtener detalles de un taller específico
• POST /workshops → Crear un nuevo taller (solo administradores)
• PUT /workshops/{id} → Modificar un taller existente (solo administradores)
• DELETE /workshops/{id} → Eliminar un taller (solo administradores)
• POST /workshops/{id}/register → Registrar a un estudiante en un taller

✅ Interfaz Web Funcional

• Interfaz para estudiantes: Ver talleres y registrarse
• Panel para administradores: Gestionar creación, edición y cancelación
• Formularios y tablas: Implementados con React y componentes reutilizables

🚀 Funcionalidades Implementadas

Para Estudiantes

• 📝 Registro y autenticación con validación de email
• 🔍 Búsqueda y filtrado avanzado por categoría, fecha y texto
• 📅 Inscripción a talleres con control de cupos en tiempo real
• 📊 Panel personal para gestionar inscripciones activas
• ❌ Cancelación de inscripciones con actualización automática

Para Administradores

• 🔐 Panel de administración con autenticación JWT segura
• ➕ CRUD completo de talleres (crear, leer, actualizar, eliminar)
• 👥 Gestión de estudiantes y visualización de inscripciones
• 📈 Estadísticas del sistema en tiempo real
• 📋 Control de cupos y validaciones de negocio

🛡️ Características de Seguridad y Rendimiento

• 🔒 Autenticación JWT con roles diferenciados (admin/estudiante)
• 🛡️ Rate limiting inteligente por endpoint y IP
• 🔄 Cliente API robusto con retry automático y manejo de errores
• 📱 Diseño responsive optimizado para móviles y desktop
• 🎨 Interfaz moderna con componentes accesibles
• 🐳 Containerización completa con Docker Compose
• 🗃️ Base de datos optimizada con índices y consultas eficientes

🧪 Extras Implementados

• 📚 Documentación: Arquitectura, base de datos y despliegue detallados
• 🔧 Rate limiting: Protección contra spam y ataques
• 🚀 Cliente API inteligente: Manejo automático de tokens y errores

🗄️ Diseño de Base de Datos

Diagrama Entidad-Relación

erDiagram
    TALLERES {
        ObjectId _id PK "Clave primaria"
        string nombre "Nombre del taller"
        string descripcion "Descripción detallada"
        string fecha "Fecha en formato YYYY-MM-DD"
        string hora "Hora en formato HH:MM"
        string lugar "Ubicación física"
        string categoria "Categoría del taller"
        string tipo "Tipo de actividad"
        string instructor "Nombre del instructor"
        float rating "Calificación 0.0-5.0"
        int cupo "Capacidad máxima"
        string creado_en "Timestamp ISO 8601"
        string actualizado_en "Timestamp ISO 8601"
        array inscripciones "Subdocumentos embebidos"
    }
    
    ESTUDIANTES {
        ObjectId _id PK "Clave primaria"
        string nombre "Nombre completo"
        string email UK "Email único"
        string hash "Hash bcrypt contraseña"
        string creado_en "Timestamp ISO 8601"
    }
    
    INSCRIPCIONES {
        string estudiante_id FK "Referencia a ESTUDIANTES._id"
        string nombre "Nombre del estudiante (desnormalizado)"
        string email "Email del estudiante (desnormalizado)"
        string registrado_en "Timestamp de inscripción"
    }
    
    TALLERES ||--o{ INSCRIPCIONES : "contiene"
    ESTUDIANTES ||--o{ INSCRIPCIONES : "se_inscribe_en"

Estructura Detallada de Colecciones

📚 Colección: talleres

Campo	Tipo	Restricciones	Descripción
_id	ObjectId	PK, Auto-generado	Identificador único del taller
nombre	String	Requerido, 1-200 chars	Nombre descriptivo del taller
descripcion	String	Requerido, 1-1000 chars	Descripción detallada del contenido
fecha	String	Requerido, formato YYYY-MM-DD	Fecha