🧭 Cómo está pensado este libro

Cada tecnología se explica con la misma estructura, para que puedas comparar entre lenguajes:

┌─ 🎯 Qué es y cuándo usarlo ...... concepto + caso de uso real
├─ ⚙️  Instalación y "hola mundo" .. arranca en 5 minutos
├─ 🧱 Estructura del proyecto ...... cómo se organiza
├─ 🔬 API REST completa (CRUD) ..... ejemplo real paso a paso
├─ 🗄️  Conexión a base de datos ..... con PostgreSQL
├─ 🧪 Tests ........................ unitarios, integración, e2e
├─ 🧼 Buenas prácticas ............ SOLID / clean code aplicado
└─ 🚀 Despliegue .................. Docker + producción

💡 Consejo: cuando aprendas un concepto en un lenguaje (por ejemplo inyección de dependencias en NestJS), busca cómo se hace lo mismo en otro (Laravel, FastAPI). Así aprendes el concepto, no solo la sintaxis. Los frameworks cambian; los principios se quedan.

🗺️ Ruta de aprendizaje recomendada

graph TD
    T1[T1 Terminal y Linux] --> T2[T2 Bash scripting]
    T2 --> T3[T3 Caja de herramientas CLI]
    T3 --> F[00 Fundamentos]
    F --> DB[01-02 Bases de datos SQL]
    DB --> L[03 PHP + Laravel]
    L --> FL[04 Flask]
    FL --> FA[05 FastAPI]
    FA --> N[06 NestJS]
    N --> E[07 Bun + Elysia]
    E --> G[08 Go]
    G --> T[09 Testing]
    T --> S[10 SOLID + Clean Code]
    S --> A[11 Arquitectura]
    A --> D[12 Docker]
    D --> NG[13 Nginx / Apache]
    NG --> OPS[14 DevOps + Despliegue]
    OPS --> FE[15 Fundamentos Frontend]
    FE --> HX[16 HTMX]
    HX --> R[17 React]
    R --> NX[18 Next.js]
    NX --> V[19 Vue]
    V --> AU[20 Autenticación]
    AU --> TR[21 Tiempo real]
    TR --> PF[22 Proyecto final]
    PF --> IN[23-26 Pensamiento de ingeniero]
    IN --> PR[Proyectos guiados]

🧭 ¿No sabes si empezar por HTMX, React, Next.js o Vue? Prueba la guía interactiva "¿Qué framework elijo?": tres preguntas sobre tu proyecto y te da una recomendación con el porqué.

¿Por qué este orden?

0. La terminal antes que nada (T1-T3): tu código va a correr en Linux, tu contenedor es un Linux y tu pipeline de CI ejecuta shell. Aprender un framework sin saber moverte por un servidor es construir sobre arena. Son tres capítulos y te acompañan el resto del libro.
1. Fundamentos y SQL primero: todo backend habla con una base de datos. Si no entiendes cómo viaja una petición HTTP y cómo guardar datos, los frameworks son magia negra.
2. Laravel antes que nada: es el framework más "amable" para aprender: te da todo hecho y ves resultados rápido. Perfecto para entender el patrón MVC y REST.
3. Flask → FastAPI: Flask es minimalista (entiendes lo básico); FastAPI añade tipado, validación automática y async (el salto natural).
4. NestJS → Elysia → Go: de un framework muy estructurado (NestJS) a uno moderno y rápido (Elysia), hasta un lenguaje compilado y de bajo nivel (Go). Aquí ya piensas como ingeniero.
5. Calidad y DevOps al final: cuando ya sabes construir, aprendes a construir bien (SOLID, arquitectura) y a entregar (Docker, Nginx, servidores).
6. Frontend de menos a más JavaScript (15-19): fundamentos del navegador, luego HTMX (aprovecha el backend que ya tienes), después React/Next.js y Vue (la UI vive en el cliente).
7. Auth, tiempo real y proyecto final (20-22): cierras el círculo backend↔frontend y lo demuestras todo junto en una app real de principio a fin.
8. Pensamiento de ingeniero al final (23-26): cuando ya sabes construir, aprendes a decidir: trade-offs, estimaciones, diseño de sistemas, ADRs y post-mortems. Esta parte no tiene sentido antes de haberte peleado con código real — sin cicatrices, los principios suenan a frases hechas.
9. Proyectos guiados en paralelo: no esperes al final. Cada proyecto tiene indicado tras qué capítulos hacerlo. Un proyecto terminado enseña más que tres capítulos leídos.

🎓 Cómo estudiar (método que funciona)

1. Lee el capítulo entero una vez sin escribir código, para tener el mapa mental.
2. Reléelo escribiendo TODO el código a mano (no copies-pega). El músculo se entrena tecleando.
3. Rompe el ejemplo a propósito: cambia cosas, provoca errores, entiende los mensajes.
4. Haz el ejercicio final de cada capítulo sin mirar.
5. Explícaselo a alguien (o a un pato de goma). Si no lo puedes explicar, no lo entendiste.

Regla de oro: un proyecto pequeño terminado enseña más que diez tutoriales a medias. Al acabar cada lenguaje, construye la misma "API de tareas (todo-list)" con él. Verás cómo el mismo problema se resuelve distinto en cada stack.

🛠️ Los cinco proyectos

Leer no basta. El libro incluye cinco proyectos guiados con especificación, criterios de aceptación y rúbrica de autoevaluación:

#	Proyecto	Hazlo después de
P1	Kit de herramientas DevOps en Bash	Parte 0
P2	API de tareas (y repetirla en otro lenguaje)	Caps. 0-11
P3	Plataforma de cursos fullstack desplegada	Caps. 12-22
P4	Diseño de sistemas (sin escribir código)	Caps. 23-26
P5	Tu propio producto, con usuarios reales	Todo

✅ Requisitos previos

• Ninguno técnico. La terminal se enseña desde cero en la Parte 0; si ya te manejas, sáltala y vuelve cuando algo te chirríe.
• Un editor: VS Code recomendado.
• En Windows: WSL2 (wsl --install en PowerShell como administrador). Todo el libro asume un entorno Linux, y WSL2 te da uno real dentro de Windows.
• Ganas de romper cosas y arreglarlas.

Todo lo demás (instalar cada lenguaje, Docker, PostgreSQL) se explica dentro del libro.