> For the complete documentation index, see [llms.txt](https://tonior.gitbook.io/guia-de-desarrollo-web/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tonior.gitbook.io/guia-de-desarrollo-web/readme.md). # Introducción > Una guía integral para diseñar, construir y escalar aplicaciones web en la era de la IA ## Sobre este libro Este no es un libro sobre cómo escribir código. Es un libro sobre **cómo pensar** en el desarrollo de aplicaciones web modernas. En un mundo donde las herramientas de IA pueden generar código, el valor del desarrollador se ha desplazado hacia: * **Antes**: Entender el problema, diseñar la solución, planificar la arquitectura * **Después**: Validar, probar, desplegar, escalar y mantener Este libro es una guía viva, diseñada para evolucionar junto con la industria. > **Edición 1.0 — 3 de agosto de 2026:** la introducción, los capítulos 1 al 31 y los apéndices A–E forman un manuscrito completo. El texto, las referencias, la navegación y el sistema visual fueron auditados en la versión local antes de su publicación. *** ## Cómo usar este libro ### Si eres desarrollador junior Comienza desde el Capítulo 1 y avanza secuencialmente. Los conceptos se construyen uno sobre otro. ### Si eres desarrollador experimentado Usa el índice como referencia. Cada capítulo es autocontenido y enlaza a conceptos relacionados cuando es necesario. ### Convenciones * 📖 **Concepto**: Explicación teórica agnóstica a tecnología * 🛠️ **Práctica**: Implementación concreta con stack específico * ⚠️ **Advertencia**: Errores comunes a evitar * 💡 **Insight**: Perspectiva o tip avanzado * 🤖 **IA**: Cómo aplicar inteligencia artificial en este contexto * 🧭 **Estado del ecosistema**: Información volátil acompañada de su fecha de verificación ### Cómo interpretar la vigencia El libro separa deliberadamente: * **Fundamentos** que permanecen aunque cambien las herramientas, como HTTP, transacciones, semántica, concurrencia y diseño de sistemas. * **Prácticas** que muestran una implementación posible, no la única. * **Estado del ecosistema** que puede cambiar con rapidez: versiones, proveedores, precios, soporte y capacidades de herramientas. Una fecha de verificación no convierte una recomendación en permanente. Antes de adoptar una tecnología, consulta su documentación primaria y contrasta la decisión con las restricciones reales de tu proyecto. *** ## Índice ### Parte I: Fundamentos de las Aplicaciones Web *La plataforma que conviene comprender antes de abstraerla* 1. [**Anatomía de una Aplicación Web Moderna**](/guia-de-desarrollo-web/parte-i-fundamentos-de-las-aplicaciones-web/01-anatomia-aplicacion.md) * Cliente, servidor y la nube * El DOM: cómo el navegador representa la página * Monolitos vs microservicios vs serverless * El stack moderno: capas y responsabilidades * Cómo fluyen los datos: del clic al píxel 2. [**HTML Semántico, Formularios y Mejora Progresiva**](/guia-de-desarrollo-web/parte-i-fundamentos-de-las-aplicaciones-web/02-html-semantico-formularios.md) * HTML como contrato de significado y comportamiento * Estructura del documento y elementos nativos * Formularios, validación y seguridad * Mejora progresiva y resiliencia * Revisión del HTML generado por IA 3. [**CSS, Layout Adaptable y Sistema Visual**](/guia-de-desarrollo-web/parte-i-fundamentos-de-las-aplicaciones-web/03-css-layout-sistema-visual.md) * Cascada, herencia y especificidad * Modelo de caja y desbordamiento * Flujo normal, Flexbox y Grid * Media queries y container queries * Tokens, estados y sistema visual 4. [**JavaScript, Eventos y Runtime del Navegador**](/guia-de-desarrollo-web/parte-i-fundamentos-de-las-aplicaciones-web/04-javascript-eventos-runtime.md) * ECMAScript y APIs del navegador * Pila, tareas, microtareas y renderizado * Eventos, propagación y comportamiento predeterminado * Cancelación, carreras y estado * Workers, seguridad y observabilidad 5. [**URL, DNS, TLS, HTTP, Caché y Seguridad del Navegador**](/guia-de-desarrollo-web/parte-i-fundamentos-de-las-aplicaciones-web/05-url-dns-tls-http-seguridad.md) * Anatomía de una URL y origen * Resolución DNS, conexión y TLS * Semántica, estados e idempotencia HTTP * Frescura, validación e invalidación de caché * Cookies, same-origin policy, CORS, CSRF y CSP *** ### Parte II: El Nuevo Paradigma *Cómo cambia el oficio cuando la IA puede producir código* 6. [**La Evolución del Desarrollador Web**](/guia-de-desarrollo-web/parte-ii-el-nuevo-paradigma/06-evolucion-desarrollador.md) * Del webmaster al ingeniero de producto * El impacto de la IA en el desarrollo * Las nuevas habilidades críticas * El ciclo completo: antes, durante y después 7. [**Pensamiento en Sistemas**](/guia-de-desarrollo-web/parte-ii-el-nuevo-paradigma/07-pensamiento-sistemas.md) * Más allá del código: pensar en componentes * Acoplamiento y cohesión * Trade-offs: no hay soluciones perfectas * Documentar decisiones: ADRs (Architecture Decision Records) 8. [**Desarrollo Asistido por IA**](/guia-de-desarrollo-web/parte-ii-el-nuevo-paradigma/08-desarrollo-asistido-ia.md) * El cambio de paradigma * Qué puede y qué no puede hacer la IA * El ciclo de desarrollo con IA * Prompting efectivo para código * Cuándo confiar y cuándo verificar * MCP: conectando la IA con el mundo *** ### Parte III: El Antes — Diseño y Planificación *Todo lo que sucede antes de escribir la primera línea de código* 9. [**Entendiendo el Problema**](/guia-de-desarrollo-web/parte-iii-el-antes-diseno-y-planificacion/09-entendiendo-problema.md) * Del pedido al requerimiento * Técnicas de elicitación * User stories vs especificaciones técnicas * El arte de hacer las preguntas correctas 10. [**Diseño de Producto y UX**](/guia-de-desarrollo-web/parte-iii-el-antes-diseno-y-planificacion/10-diseno-producto-ux.md) * Pensamiento centrado en el usuario * Wireframes, mockups y prototipos * Sistemas de diseño y componentes * Accesibilidad desde el diseño 11. [**Arquitectura de Software**](/guia-de-desarrollo-web/parte-iii-el-antes-diseno-y-planificacion/11-arquitectura-software.md) * Patrones arquitectónicos: MVC, Clean Architecture, Hexagonal * Cuándo usar qué patrón * Diseñando para el cambio * Arquitectura evolutiva 12. [**Diseño de APIs**](/guia-de-desarrollo-web/parte-iii-el-antes-diseno-y-planificacion/12-diseno-apis.md) * API-First: diseñar el contrato antes del código * REST: principios y mejores prácticas * GraphQL: cuándo y por qué * tRPC y el type-safety end-to-end * Versionado y evolución de APIs * Documentación como ciudadano de primera clase 13. [**Modelado de Datos**](/guia-de-desarrollo-web/parte-iii-el-antes-diseno-y-planificacion/13-modelado-datos.md) * Pensando en entidades y relaciones * SQL vs NoSQL: criterios de decisión * Normalización vs desnormalización * Esquemas evolutivos y migraciones 14. [**Planificación Técnica**](/guia-de-desarrollo-web/parte-iii-el-antes-diseno-y-planificacion/14-planificacion-tecnica.md) * Desglose de trabajo (WBS) * Identificación de riesgos técnicos * Spikes y pruebas de concepto * Estimación: el arte de lo imposible *** ### Parte IV: El Durante — Implementación *Patrones y prácticas para construir software de calidad* 15. [**Arquitectura Frontend**](/guia-de-desarrollo-web/parte-iv-el-durante-implementacion/15-arquitectura-frontend.md) * Componentes: la unidad básica * Estado: local, global y servidor * Routing y navegación * Renderizado: CSR, SSR, SSG, ISR * Performance frontend 16. [**Arquitectura Backend**](/guia-de-desarrollo-web/parte-iv-el-durante-implementacion/16-arquitectura-backend.md) * Capas y separación de responsabilidades * Controllers, Services, Repositories * Inyección de dependencias * Manejo de errores y excepciones * Logging estructurado 17. [**Autenticación y Autorización**](/guia-de-desarrollo-web/parte-iv-el-durante-implementacion/17-autenticacion-autorizacion.md) * Identidad vs permisos * Sessions vs tokens (JWT) * OAuth 2.0 y OpenID Connect * RBAC, ABAC y políticas de acceso * Seguridad en la práctica 18. [**Comunicación y Datos en Tiempo Real**](/guia-de-desarrollo-web/parte-iv-el-durante-implementacion/18-tiempo-real.md) * HTTP: request-response tradicional * WebSockets: comunicación bidireccional * Server-Sent Events (SSE) * Polling y Long Polling * Cuándo usar cada enfoque 19. [**Persistencia y Bases de Datos**](/guia-de-desarrollo-web/parte-iv-el-durante-implementacion/19-persistencia.md) * Patrones de acceso a datos * ORMs vs Query Builders vs SQL puro * Transacciones y consistencia * Caching: estrategias y invalidación * Búsqueda: índices y full-text search 20. [**Manejo de Tareas Asíncronas**](/guia-de-desarrollo-web/parte-iv-el-durante-implementacion/20-tareas-asincronas.md) * Jobs y queues * Procesamiento en background * Patrones de retry y circuit breaker * Event-driven architecture * CQRS y Event Sourcing (introducción) *** ### Parte V: El Después — Calidad y Operaciones *Asegurar que el software funciona y sigue funcionando* 21. [**Estrategias de Testing**](/guia-de-desarrollo-web/parte-v-el-despues-calidad-y-operaciones/21-testing.md) * La pirámide de testing (y sus alternativas) * Unit tests: qué probar y qué no * Integration tests: probando colaboraciones * E2E tests: el usuario como criterio * Testing de APIs * TDD y BDD: cuándo tienen sentido 22. [**Integración y Entrega Continua**](/guia-de-desarrollo-web/parte-v-el-despues-calidad-y-operaciones/22-ci-cd.md) * El pipeline como código * Builds reproducibles * Estrategias de branching * Feature flags y trunk-based development * Ambientes: dev, staging, production 23. [**Deployment y Infraestructura**](/guia-de-desarrollo-web/parte-v-el-despues-calidad-y-operaciones/23-deployment.md) * Contenedores y Docker * Orquestación: Kubernetes básico * Plataformas: Vercel, Railway, Fly.io, AWS * Infrastructure as Code * Estrategias de deployment: blue-green, canary, rolling 24. [**Observabilidad**](/guia-de-desarrollo-web/parte-v-el-despues-calidad-y-operaciones/24-observabilidad.md) * Telemetría, monitoreo, observabilidad y debugging * Logs, métricas, trazas y correlación * SLIs, SLOs y presupuestos de error * Alertas accionables y debugging en producción * Incidentes, postmortems y cultura de aprendizaje 25. [**Escalabilidad y Rendimiento**](/guia-de-desarrollo-web/parte-v-el-despues-calidad-y-operaciones/25-escalabilidad-rendimiento.md) * Latencia, throughput, concurrencia y capacidad * Escalado vertical, horizontal y particionamiento * Cachés, CDNs y edge computing * Límites, backpressure y degradación controlada * Planificación, pruebas de carga y rendimiento web 26. [**Seguridad en Aplicaciones Web**](/guia-de-desarrollo-web/parte-v-el-despues-calidad-y-operaciones/26-seguridad-aplicaciones-web.md) * Modelado de amenazas y requisitos verificables * Validación, parametrización, codificación y sanitización * Fronteras, secretos y configuración segura * Cadena de suministro y ciclo de desarrollo * Verificación, detección y respuesta *** ### Parte VI: Stacks en Práctica *Implementaciones concretas de los conceptos anteriores* 27. [**Stack: Next.js + Node.js**](/guia-de-desarrollo-web/parte-vi-stacks-en-practica/27-stack-nextjs-node.md) * Slice vertical de solicitudes de soporte * Server y Client Components con fronteras explícitas * Server Actions, Route Handlers y contratos HTTP * Persistencia, autorización y caché por identidad * Pruebas, despliegue y observabilidad 28. [**Stack: Python + FastAPI**](/guia-de-desarrollo-web/parte-vi-stacks-en-practica/28-stack-python-fastapi.md) * Contratos HTTP con type hints y Pydantic * Dependencias para identidad y recursos por request * Concurrencia, código bloqueante y límites * SQLAlchemy, transacciones y migraciones con Alembic * Pruebas, contenedores y observabilidad 29. [**Stack: Go + APIs de Alto Rendimiento**](/guia-de-desarrollo-web/parte-vi-stacks-en-practica/29-stack-go.md) * Servicio HTTP con stdlib y límites explícitos * Persistencia, transacciones y autorización con `database/sql` * Contextos, goroutines y concurrencia limitada * Testing, detector de carreras, fuzzing y benchmarks * Binarios, terminación controlada y observabilidad *** ### Parte VII: El Futuro *Hacia dónde vamos* 30. [**La Nueva Capa de Abstracción**](/guia-de-desarrollo-web/parte-vii-el-futuro/30-nueva-capa-abstraccion.md) * El terremoto de magnitud 9 * Agents, subagents, contexto y memoria * MCP: el protocolo que conecta todo * Configurando tu entorno agéntico * El modelo mental para entidades estocásticas * Patrones y antipatrones 31. [**Tendencias y Horizontes**](/guia-de-desarrollo-web/parte-vii-el-futuro/31-tendencias-horizontes.md) * Señales, tendencias, hipótesis y adopción responsable * Distribución global y runtimes interoperables * WebAssembly, WASI, WebGPU y cómputo cliente * Convergencia full stack, plataformas y agentes * Fundamentos que permanecen y radar técnico *** ### Apéndices * [**A: Glosario**](/guia-de-desarrollo-web/apendices/a-glosario.md) * Definiciones de plataforma, arquitectura, datos, seguridad, operación e IA * [**B: Herramientas recomendadas**](/guia-de-desarrollo-web/apendices/b-herramientas-recomendadas.md) * Criterios de selección y opciones por etapa del producto * [**C: Recursos y rutas de aprendizaje**](/guia-de-desarrollo-web/apendices/c-recursos-aprendizaje.md) * Proyectos progresivos desde plataforma web hasta sistemas e IA * [**D: Plantillas y listas de verificación**](/guia-de-desarrollo-web/apendices/d-plantillas-listas.md) * Briefs, ADRs, APIs, datos, seguridad, pruebas, releases e incidentes * [**E: Referencias y bibliografía**](/guia-de-desarrollo-web/apendices/e-referencias-bibliografia.md) * Fuentes primarias y lecturas organizadas por tema *** ## Previsualización web local Antes de publicar cambios en GitBook, el manuscrito puede revisarse como sitio web local con [HonKit](https://honkit.netlify.app/), un mantenedor compatible con el formato histórico de GitBook. Requisitos: * Node.js 20.18.1 o posterior * npm Instala las dependencias y levanta el sitio: ```bash npm install npm run book:serve ``` La previsualización estará disponible en . El servidor recarga el contenido al guardar cambios. Para comprobar que todo el libro compila sin iniciar el servidor: ```bash npm run book:build ``` Este entorno valida el contenido, los enlaces, la navegación y los recursos locales. No reproduce necesariamente todos los detalles visuales del GitBook alojado. El archivo `.gitbook.yaml` conserva la estructura que utilizará la posterior sincronización con GitBook. *** ## Contribuir Este es un libro vivo. Si encuentras errores, tienes sugerencias o quieres contribuir: 1. Abre un issue describiendo tu propuesta 2. Sigue las guías de estilo del proyecto 3. Envía un PR con tus cambios ## Licencia Este trabajo está bajo una licencia [Creative Commons Atribución-NoComercial 4.0 Internacional (CC BY-NC 4.0)](https://creativecommons.org/licenses/by-nc/4.0/deed.es). **Puedes:** * Compartir — copiar y redistribuir el material en cualquier medio o formato * Adaptar — remezclar, transformar y construir a partir del material **Bajo los siguientes términos:** * **Atribución** — Debes dar crédito apropiado, proporcionar un enlace a la licencia e indicar si se han realizado cambios * **NoComercial** — No puedes usar el material con fines comerciales [![CC BY-NC 4.0](https://licensebuttons.net/l/by-nc/4.0/88x31.png)](https://creativecommons.org/licenses/by-nc/4.0/deed.es) *** *Última revisión editorial: 3 de agosto de 2026 · Edición 1.0*