Framework Ecosystems Labs#

Programa comparativo de 180 horas para aprender a entender, comparar y elegir bibliotecas, frameworks y plataformas de desarrollo. La unidad de comparación no es un «Hola mundo»: es el mismo contrato funcional, con las mismas pruebas de aceptación y los mismos atributos de calidad, implementado en distintos ecosistemas.

📖 Sitio del programa: https://vladimiracunadev-create.github.io/framework-ecosystems-labs/

🚀 Empezar aquí#

El programa cubre de la instalación al nivel experto, y empieza por una máquina vacía: empezar/ instala las ocho cadenas de herramientas, explica los seis conocimientos previos que el resto da por sabidos —terminal, puertos, HTTP, JSON, dependencias y git— y lleva hasta el primer contrato en verde.

node scripts/doctor.mjs   # qué cadenas tienes y cuánto del laboratorio puedes ejecutar hoy

📖 ¿Una palabra que no conoces? El glosario reúne 136 conceptos con su definición y la clase donde se enseña, las 138 tecnologías del catálogo y las 8 cadenas de herramientas. Se genera desde esas fuentes, y la validación falla si una referencia deja de resolver.

El informe dice cuántas de las implementaciones del laboratorio puedes ejecutar en tu máquina, cuáles no y con qué comando exacto se recupera cada una. No hace falta instalarlas todas: lo que no se ejecute en local se ejecuta en la integración continua, y una implementación omitida se declara omitida.

La regla que gobierna este repositorio#

Ninguna afirmación del programa procede de una fuente difusa.

Todo lo que aquí se enseña se apoya en un libro, un artículo con revisión por pares, una norma o la documentación oficial de quien mantiene la tecnología. Y no es una intención declarada: es una comprobación automática que deja el repositorio en rojo.

node scripts/verify-sources.mjs   # sin red: determinista y reproducible
node scripts/refresh-sources.mjs  # con red: contrasta con los catálogos públicos

verify-sources.mjs falla si una cita apunta a una fuente inexistente, si una lección cita menos de cuatro, si un libro no tiene ISBN válido, si un artículo no tiene DOI, si una lección omite alguna de las doce secciones obligatorias, o si alguna entrada del registro no se cita en ningún texto — la bibliografía decorativa también es un fallo.

Y verify-contract.mjs cierra el otro flanco: comprueba que cada código del catálogo de errores se ejercita en las pruebas, que las cinco implementaciones pueden emitirlo, y que todo extracto del contrato citado en una lección coincide literalmente con el contrato. Esa última comprobación existe por un fallo real: el currículo enseñaba un formato de error que el contrato canónico no cumplía, y nada lo detectaba.

Detalle completo en sources/README.md y docs/BIBLIOGRAPHY.md.

Propósito#

Al finalizar, una persona podrá:

• diferenciar lenguaje, runtime, biblioteca, framework, metaframework, SDK, ORM y plataforma;
• reconocer inversión de control, convenciones, composición y extensibilidad;
• construir frontend, API, full stack, móvil y escritorio con patrones transferibles;
• comparar routing, estado, validación, persistencia, seguridad, pruebas y despliegue;
• elegir un framework según producto, equipo, riesgo y ciclo de vida;
• migrar sistemas heredados de forma incremental;
• evaluar dependencia, mantenimiento, licencias y cadena de suministro;
• demostrar la misma funcionalidad mediante pruebas compartidas.

Principio central#

mismo dominio + mismo contrato + mismas pruebas + entornos declarados

Cambiar requisitos para favorecer una tecnología invalida la comparación. Y aquí no es una consigna: el mismo examen se ejecuta contra los cinco ecosistemas.

node scripts/run-acceptance.mjs reference-node   # sin instalar nada
node scripts/run-acceptance.mjs express --prepare

Los 20 casos viven en contracts/taskflow/acceptance.test.mjs y solo hablan HTTP: se lanzan sin adaptador contra cualquier implementación, en cualquier lenguaje. Los errores siguen RFC 9457 con errors[] por campo, porque un 422 que solo dice «datos inválidos» impide construir una interfaz accesible.

Las desviaciones que una implementación necesita están declaradas en ACCEPTANCE.md. Una desviación declarada es información sobre el ecosistema; una silenciosa es un fallo de la comparación.

🗺️ El Atlas — cada lenguaje tiene sus frameworks#

El programa tiene dos capas. El núcleo implementa un contrato en cinco ecosistemas y lo verifica en cada entrega. El Atlas sitúa 138 tecnologías en su ecosistema y en su era, porque nadie aprende 138 frameworks pero cualquiera puede aprender ocho ideas y verlas repetirse durante veinte años con nombres distintos.

Incluye la genealogía —quién viene de quién— y las cinco eras del campo, de «el servidor lo hace todo» a las islas y el regreso del hipermedia.

Y 138 fichas a fondo —una por cada tecnología del catálogo, sin excepciones—, cada una con sus fuentes: de qué problema nació, qué idea aportó, qué dejó abierto y qué lección deja para decidir hoy.

Una muestra de lo que se aprende leyéndolas:

Cada entrada declara clasificación, era, estado, licencia SPDX y documentación oficial. node scripts/refresh-catalog.mjs contrasta los 138 enlaces y los identificadores de licencia con su fuente.

🎓 Las clases — el mismo problema en todos los frameworks#

Un módulo enseña un tema. Una clase plantea un problema y lo resuelve en todos los frameworks a la vez, con el código a la vista y un contrato ejecutable que los obliga a comportarse igual.

149 clases en 12 partes, de lo más simple —levantar un servidor— a lo más avanzado —migrar sin parar, elegir y saber salir.

Los elencos#

Los lenguajes son intercambiables: cualquiera suma dos números. Los frameworks no. Spring Boot no implementa una clase de reactividad en el cliente y React no implementa una de migraciones de base de datos. Por eso cada clase declara su elenco: los frameworks para los que ese problema tiene sentido. En total, 53 tecnologías del catálogo aparecen en algún elenco.

Un resultado verde que se puede creer#

node scripts/run-class.mjs 011

El verificador arranca cada implementación, la somete al contrato y declara cuáles omitió por falta de cadena de herramientas:

  ✔ fastapi              4 casos
  ✔ flask                4 casos
  ✔ laravel              4 casos
  ⊘ spring-boot          falta la herramienta `mvn`
  ⊘ gin                  falta la herramienta `go`

RESUMEN: 3 verificadas · 0 con fallo · 7 omitidas por falta de herramientas

Un informe que dijera «todo bien» sin haber ejecutado siete de diez estaría mintiendo. Distinguir verificado de omitido es lo que hace creíble el verde.

El programa#

Rutas frontend, backend, full stack y modernización en curriculum/README.md.

Anatomía de un módulo#

Los trece siguen el mismo contrato de doce secciones, y la validación lo exige:

Prerrequisitos · Objetivos observables · Concepto independiente del framework · Anatomía comparada · Implementación mínima · Pruebas compartidas · Seguridad y accesibilidad · Errores frecuentes y diagnóstico · Comprobación de recuerdo · Reto de transferencia · Criterios de evaluación · Fuentes

Por qué esas doce y en ese orden: docs/LEARNING-MODEL.md, donde cada decisión pedagógica se apoya en su propia fuente.

Empezar#

Requiere Node.js 22 o superior. Sin instalar dependencias:

node scripts/doctor.mjs                          # qué puedes ejecutar en esta máquina
node scripts/validate-repository.mjs             # estructura, catálogo, enlaces
node scripts/verify-sources.mjs                  # trazabilidad de las citas
node scripts/verify-contract.mjs                 # contrato ↔ lecciones ↔ código
node --test labs/01-http-contract/reference-node/server.test.mjs
node scripts/run-acceptance.mjs reference-node   # el contrato, de punta a punta
node scripts/generate-atlas.mjs --check           # el Atlas coincide con el catálogo
node scripts/generate-site.mjs                   # genera site/ (no se versiona)

Con pnpm, que es el único gestor admitido para JavaScript y TypeScript:

corepack enable
pnpm check

Estructura#

empezar/          Prólogo: instalación, conocimientos previos y primer verde
glosario/         136 conceptos con su definición y dónde se enseña
atlas/            Atlas: ecosistemas, genealogía y fichas a fondo
catalog/          Registro de 138 tecnologías con era, estado y licencia
classes/          149 clases: el mismo problema resuelto en todos los frameworks
contracts/        Dominio y contrato TaskFlow compartido
curriculum/       Los 13 módulos del programa
docs/             Taxonomía, arquitectura, selección, seguridad, modelo pedagógico
labs/             Implementaciones y comparaciones ejecutables
projects/         Productos canónicos y proyecto final
assessments/      Diagnóstico y rúbricas
sources/          Registro bibliográfico verificable y su política
templates/        Plantillas de lección, framework y decisión
scripts/          Validaciones, ejecutor de aceptación y generador del sitio

Cobertura de «todos los frameworks»#

• Núcleo ejecutable: cinco implementaciones del mismo contrato, probadas en CI.
• Atlas: 138 tecnologías en 13 ecosistemas, con genealogía y eras.
• Fichas a fondo: casos donde la historia enseña más que la documentación.
• Plantillas: incorporación consistente de nuevos ecosistemas.

Estar en el catálogo no equivale a una recomendación ni a dominio profesional. Y el número de estrellas o descargas no aparece en ninguna entrada, porque no responde a ninguna de las preguntas del módulo 11.

Proyectos canónicos#

Plataforma educativa · comercio electrónico · libro contable y pagos · red social · panel de agentes y automatizaciones. Cada uno con un atributo de calidad dominante distinto, en projects/canonical-products.md.

Qué NO promete este programa#

• No garantiza dominio profesional. Demuestra criterio y capacidad de comparar; la competencia se adquiere operando sistemas reales durante meses.
• No declara ganadores. No hay un framework mejor: hay uno mejor para un producto, un equipo y un horizonte declarados.
• No es neutral. Privilegia la comparación honesta y el diagnóstico sobre la velocidad de entrega inicial. El sesgo es deliberado y está declarado.

IA y mantenimiento#

PROMPT_MAESTRO.md define cómo una IA debe investigar, implementar, probar y documentar cambios sin degradar el repositorio. La regla de fuentes se le aplica igual que a una persona.

Licencia#

MIT. Los frameworks, nombres y marcas conservan sus licencias y titulares. El repositorio no redistribuye libros ni artículos protegidos: cita, remite y explica.