Cursus — ft_transcendence pendiente

El último proyecto del common core (rank 06): una aplicación web completa —frontend, backend y base de datos— hecha en equipo de 4 o 5 personas, con una idea elegida por el propio equipo y un sistema de módulos que hay que sumar hasta 14 puntos. Esta ficha describe la versión 21.2 del enunciado, la más reciente que se ha podido localizar.

De un Pong a «lo que queráis» — ft_transcendence existe desde los primeros años del 42cursus y ha cambiado de enunciado muchas veces. Durante mucho tiempo el proyecto era siempre el mismo: un Pong multijugador en el navegador —el juego de Atari de 1972, el primer gran éxito comercial del videojuego— con usuarios, chat y torneos, y lo que cambiaba de una versión a otra era la pila tecnológica impuesta y la lista de módulos. La versión 21 rompe con eso: el subtítulo del enunciado es literalmente «Surprise.» y el contenido lo decide el equipo. El Pong queda como un ejemplo más («si eliges hacer un Pong, como en el proyecto original…»). Lo que se mantiene es la intención: juntar en un solo proyecto todo lo aprendido —redes, contenedores, seguridad, bases de datos— y hacerlo como se hace en una empresa, con roles, reparto de trabajo y documentación. Es, con diferencia, el proyecto más largo del common core, y el enunciado avisa de que las malas decisiones al principio y la falta de coordinación cuestan mucho tiempo.

Qué pide

Rank: 06Stack: libre (web: frontend + backend + BD)Grupo: 4–5 personasEnunciado: v21.2

El enunciado dedica además un capítulo entero a ideas de proyecto con la combinación de módulos que daría los 14 puntos, agrupadas en juegos, proyectos sociales, creativos, de productividad y especializados.

El equipo y sus roles

Hay que asignar estos roles (con 4 personas, alguien acumula varios):

Como recomendación (no obligatoria): reuniones regulares, un tablero de tareas (GitHub Issues, Trello…), dividir en tareas pequeñas, revisiones de código, notas de decisiones y un canal de comunicación (Discord, Slack…). En la evaluación preguntarán cómo se repartieron los roles, cómo se organizó y dividió el trabajo, cómo os comunicasteis y qué aportó cada uno, y todos deben poder explicar el proyecto.

Qué te obliga a aprender — Los nombres vienen de Scrum, el marco ágil que Ken Schwaber y Jeff Sutherland presentaron en 1995 y que hoy usa buena parte de la industria. El PO decide qué se construye, el equipo cómo, y el Scrum Master cuida de que el proceso no se atasque. Hasta ahora los proyectos en grupo de 42 eran de dos personas que se repartían ficheros; con cinco, sin alguien que decida prioridades y alguien que vigile la arquitectura, cada uno acaba construyendo su propia aplicación.

La parte obligatoria

Requisitos generales (si no se cumplen, el proyecto se rechaza):

Requisitos técnicos:

El enunciado define también qué cuenta como framework: algo con arquitectura y convenciones propias, funciones integradas (rutas, estado…) y un ecosistema. React, Vue, Angular, Svelte o Next.js sí; Express, Fastify, NestJS, Django, Flask o Rails también; jQuery, Lodash o Axios no. React se considera framework a estos efectos aunque técnicamente sea una librería.

Qué te obliga a aprender — Casi cada línea es una lección de seguridad o de operación. Hash con sal: la contraseña nunca se guarda, se guarda el resultado de una función de derivación lenta (bcrypt, scrypt, Argon2) aplicada a la contraseña más un valor aleatorio distinto por usuario, para que dos contraseñas iguales no den el mismo hash y no sirvan las tablas precalculadas. A modo de ilustración del concepto, en Python:
import hashlib, os
salt = os.urandom(16)
h = hashlib.scrypt(b"contraseña", salt=salt, n=2**14, r=8, p=1)
# se guardan salt y h; nunca la contraseña
Validar también en el backend: el frontend lo controla el usuario, así que cualquier comprobación hecha solo en el navegador se salta con un curl. HTTPS: el TLS que en Inception se configuraba en NGINX, ahora delante de una aplicación real. Un solo comando: lo que Inception enseñó con Docker Compose. Condiciones de carrera: el mismo problema de hilos y mutex de los proyectos de concurrencia, ahora entre peticiones HTTP que tocan la misma fila de la base de datos.

Cómo funcionan los módulos

El enunciado da un ejemplo con el Pong clásico: juego web (2) + jugadores remotos (2) + torneo (1) + personalización (1) + gestión de usuarios estándar (2) + OAuth (1) + frameworks de front y back (2) + ORM (1) + IA rival (2) = 14.

IV.1Web

TipoMódulo
MajorFramework en frontend y backend (un full-stack como Next.js, Nuxt o SvelteKit cuenta como ambos si se usan sus dos partes)
MinorFramework solo en el frontend
MinorFramework solo en el backend
MajorTiempo real con WebSockets o similar: actualizaciones entre clientes, conexiones y desconexiones bien gestionadas, difusión eficiente
MajorInteracción entre usuarios: chat básico, perfiles y sistema de amigos
MajorAPI pública con clave segura, límite de peticiones, documentación y al menos 5 endpoints (GET, POST, PUT, DELETE…)
MinorORM para la base de datos
MinorNotificaciones para toda creación, modificación y borrado
MinorFunciones colaborativas en tiempo real (espacios compartidos, edición en vivo, dibujo…)
MinorServer-Side Rendering (SSR)
MinorProgressive Web App (PWA) con modo sin conexión e instalable
MinorSistema de diseño propio: paleta, tipografía, iconos y al menos 10 componentes reutilizables
MinorBúsqueda avanzada con filtros, ordenación y paginación
MinorSubida y gestión de ficheros: varios tipos, validación en cliente y servidor, almacenamiento con control de acceso, vista previa, progreso y borrado

El enunciado no aclara si el major de «framework en front y back» se puede sumar con los dos minor de framework por separado; lo lógico es que no, pero no está confirmado.

Qué te obliga a aprender — El modelo petición-respuesta de HTTP no sirve para un chat o un juego: el servidor no puede avisar al cliente si este no pregunta. WebSocket (RFC 6455, 2011) resuelve eso abriendo un canal bidireccional permanente sobre la misma conexión TCP, tras un handshake HTTP. Es el servidor multicliente con sockets de toda la vida, llevado al navegador. El ORM traduce tablas a objetos; la API pública con rate limiting obliga a pensar en quién llama y cuántas veces.

IV.2Accesibilidad e internacionalización

TipoMódulo
MajorAccesibilidad completa según WCAG 2.1 AA: lector de pantalla, navegación por teclado y tecnologías de asistencia
MinorVarios idiomas (mínimo 3): sistema i18n, traducciones completas, selector de idioma y todo el texto traducible
MinorIdiomas de derecha a izquierda (árabe, hebreo…), con el diseño entero en espejo, no solo la dirección del texto
MinorAl menos 2 navegadores más (Firefox, Safari, Edge…), probados y con las limitaciones documentadas
Qué te obliga a aprender — Las WCAG (Web Content Accessibility Guidelines) son la norma del W3C para la accesibilidad web; la 2.1 es de 2018 y el nivel AA es el que suelen exigir las leyes, como la directiva europea de accesibilidad. Cumplirlas significa HTML semántico, contraste suficiente, foco visible y que todo funcione sin ratón. La internacionalización enseña a no escribir nunca un texto visible directamente en el código, sino una clave que se traduce.

IV.3Gestión de usuarios

TipoMódulo
MajorGestión estándar: editar perfil, avatar (con uno por defecto), amigos con estado en línea y página de perfil
MinorEstadísticas e historial de partidas: victorias, derrotas, nivel, logros, clasificación (requiere un juego)
MinorAutenticación remota con OAuth 2.0 (Google, GitHub, 42…)
MajorPermisos avanzados: CRUD de usuarios, roles (admin, usuario, invitado, moderador…) y vistas distintas según el rol
MajorOrganizaciones: crear, editar y borrar, añadir y quitar usuarios, y acciones dentro de una organización
MinorAutenticación en dos pasos (2FA) completa
MinorPanel de analítica de la actividad de los usuarios
Qué te obliga a aprender — OAuth 2.0 (RFC 6749, 2012) es el protocolo detrás de «Iniciar sesión con Google»: tu aplicación nunca ve la contraseña del usuario, sino un código que canjea por un token. La propia intra de 42 ofrece OAuth, y era la forma de entrar en las versiones antiguas del proyecto. La 2FA típica es TOTP (RFC 6238): un secreto compartido y la hora actual generan un código de seis dígitos que cambia cada 30 segundos. Los permisos por rol son el control de acceso que en Born2beroot se hacía con grupos y sudo, ahora dentro de la aplicación.

IV.4Inteligencia artificial

TipoMódulo
MajorRival controlado por IA: que pueda ganar a veces, que imite a un humano (no juego perfecto) y que use las opciones de personalización si las hay (requiere un juego)
MajorSistema RAG completo sobre un conjunto de datos grande
MajorInterfaz con un LLM: generar texto o imágenes, respuestas en streaming, gestión de errores y límite de peticiones
MajorRecomendaciones con aprendizaje automático (filtrado colaborativo o por contenido) que mejoren con el tiempo
MinorModeración automática de contenido
MinorVoz (reconocimiento o síntesis) para accesibilidad o interacción
MinorAnálisis de sentimiento del contenido de los usuarios
MinorReconocimiento y etiquetado de imágenes
Qué te obliga a aprender — El RAG (Retrieval-Augmented Generation, propuesto por Lewis y otros en 2020) es lo mismo que se trabaja en el proyecto «RAG against the machine» del rank 04: buscar primero los fragmentos relevantes y dárselos al modelo como contexto. El rival de IA tiene una exigencia curiosa: no debe jugar perfecto. En un Pong, calcular dónde llegará la pelota es fácil; lo difícil es que el rival se equivoque de forma creíble (tiempo de reacción, error en la predicción), que es lo que hacen los juegos comerciales.

IV.5Ciberseguridad

TipoMódulo
MajorWAF/ModSecurity endurecido + HashiCorp Vault para los secretos (claves de API, credenciales, variables de entorno), cifrados y aislados
Qué te obliga a aprender — Un WAF (Web Application Firewall) inspecciona las peticiones HTTP antes de que lleguen a la aplicación y bloquea patrones de ataque conocidos (inyección SQL, XSS…); ModSecurity es el clásico de código abierto y suele ir como módulo de NGINX o Apache. Vault da un paso más que el .env obligatorio: los secretos no viven en ficheros, sino en un servicio que los entrega cifrados y bajo control de acceso.

IV.6Juego y experiencia de usuario

TipoMódulo
MajorJuego web completo entre usuarios (Pong, ajedrez, tres en raya, cartas…), con partidas en vivo, reglas claras y condiciones de victoria; 2D o 3D
MajorJugadores remotos: dos ordenadores en la misma partida en tiempo real, con latencia, desconexiones y reconexión bien gestionadas
MajorMultijugador de tres o más jugadores, sincronizado y justo (requiere un juego)
MajorUn segundo juego, con historial y emparejamiento (requiere el primero)
MajorGráficos 3D avanzados con Three.js, Babylon.js o similar
MinorChat avanzado: bloquear usuarios, invitar a partidas desde el chat, avisos de torneo, perfiles desde el chat, historial, «escribiendo…» y leído (requiere el chat básico; invitaciones y avisos requieren además un juego)
MinorTorneos: cuadro de enfrentamientos, emparejamiento e inscripción (requiere un juego)
MinorPersonalización del juego: poderes, mapas o temas, ajustes, con opciones por defecto (requiere un juego)
MinorGamificación persistente: al menos 3 de logros, insignias, clasificaciones, XP/niveles, retos diarios o recompensas
MinorModo espectador en tiempo real (requiere un juego)
Qué te obliga a aprender — El problema central del juego en red: dos jugadores ven la misma partida con decenas de milisegundos de retraso entre ellos. La solución habitual es un servidor autoritativo —el servidor calcula el estado y los clientes solo envían sus entradas y dibujan lo que reciben— para que nadie pueda hacer trampas modificando su navegador; encima se añaden técnicas de predicción e interpolación para que el retraso no se note. Es la herencia directa del Pong de las versiones anteriores, que exigían justamente esto.

IV.7DevOps

TipoMódulo
MajorGestión de logs con ELK: Elasticsearch para guardar e indexar, Logstash para recoger y transformar, Kibana para visualizar; retención, archivado y acceso seguro
MajorMonitorización con Prometheus y Grafana: métricas, exporters, paneles propios, alertas y acceso seguro
MajorBackend en microservicios poco acoplados, cada uno con una responsabilidad, comunicados por REST o colas de mensajes
MinorPágina de estado y health checks, con copias de seguridad automáticas y procedimiento de recuperación ante desastres
Qué te obliga a aprender — Que una aplicación en producción hay que poder observarla: logs para saber qué pasó, métricas para saber cómo va. Prometheus nació en SoundCloud en 2012 y funciona al revés de lo intuitivo: no le envías métricas, él las recoge periódicamente de cada servicio. Los microservicios llevan al extremo la idea de Inception de un contenedor por servicio, con su coste: cada llamada entre servicios puede fallar.

IV.8Datos y analítica

TipoMódulo
MajorPanel de analítica con gráficos interactivos, datos en tiempo real, exportación (PDF, CSV…) y filtros por fechas
MinorExportación e importación de datos (JSON, CSV, XML…) con validación y operaciones en bloque
MinorCumplimiento del RGPD: pedir los propios datos, borrarlos con confirmación, exportarlos legibles y correos de confirmación
Qué te obliga a aprender — El RGPD (Reglamento General de Protección de Datos, aplicable en la UE desde 2018) reconoce derechos como el de acceso, el de supresión y el de portabilidad. Implementarlos obliga a saber dónde está cada dato de un usuario en tu base de datos, cosa que en un esquema mal diseñado no es obvia.

IV.9Blockchain

TipoMódulo
MajorGuardar las puntuaciones de los torneos en una blockchain de pruebas con Avalanche y contratos en Solidity
MinorBackend que se ejecuta en blockchain con ICP (Internet Computer Protocol); incompatible con SSR
Qué te obliga a aprender — Un smart contract es un programa desplegado en una cadena de bloques cuyo estado no puede alterarse a posteriori. Guardar ahí los resultados de un torneo es la demostración clásica de integridad: ni siquiera el administrador de la aplicación puede cambiar quién ganó.

IV.10Módulos a elección

El README

Además de la parte común a todos los proyectos nuevos (primera línea en cursiva «This project has been created as part of the 42 curriculum by <login1>, <login2>…», y secciones Description, Instructions y Resources con cómo se ha usado la IA), aquí se exige:

Tiene que estar en inglés, y el enunciado avisa de que un README pobre puede perjudicar la evaluación.

Qué te obliga a aprender — A documentar para alguien que no estuvo allí: un evaluador, un compañero que se incorpora o un reclutador que mira el repositorio. Las secciones de contribuciones individuales, junto con el historial de Git, son también la forma de comprobar que el trabajo se repartió de verdad.

Bonus y evaluación

Puntos delicados

Fuente

Enunciado oficial en inglés, versión 21.2 (subtítulo «Surprise.»), obtenido de repositorios de estudiantes que lo incluyen. Se han localizado también copias de las versiones 21.0 y 21.1, con la misma estructura. Hay dos copias de la 21.2 con diferencias mínimas (una de ellas detalla más las dependencias del chat avanzado); esta ficha sigue la más completa. No se ha encontrado ninguna versión posterior a la 21.2, pero el enunciado puede haber cambiado en la intra.