Architecture Lab

Una API chica de proyectos y tareas, construida cinco veces con cinco estructuras de backend: Layered, Feature modules, Hexagonal, Clean y Use-case-first. Las cinco responden igual por HTTP; cambia la organización del código.

El objetivo es aprender cuándo una estructura ayuda, qué cuesta y qué decisiones no dependen de los nombres de las carpetas.

El producto

Dos recursos, proyectos y tareas, con seis operaciones y tres reglas de negocio. El contrato se explica y se prueba en el playground.

Cómo usar este sitio

Playground: elegí una de las cinco APIs, mandá requests y mirá la respuesta completa.
Arquitecturas: una tarjeta por app y una tabla que compara las cinco.

Correr las apps

Requiere Node.js 24.21.0 y pnpm 12.6.0, que llega con Corepack (corepack enable). Desde la raíz del repo:

pnpm install
pnpm --filter @architecture-lab/<app> db:reset   # base con datos de ejemplo
pnpm --filter @architecture-lab/<app> start
pnpm --filter @architecture-lab/web dev          # el sitio

Cada app corre en su propia terminal; para el playground, iniciá las cinco.

Qué no es

Ninguna arquitectura se presenta como la mejor. Los números de la comparación son observaciones sobre este repo, no puntajes (advertencias).