Clase 9 - Martes, 20 de octubre de 2026 (20 10 26) - Desarrollo e Implementación de sistemas en la nube
Apunte Universitario Completo: Desarrollo e Implementación de Sistemas en la Nube
1. Introducción General
Contexto del Tema
El desarrollo e implementación de sistemas en la nube exige una delimitación precisa de la arquitectura de software y de las interacciones entre componentes. En el diseño de soluciones compuestas por servicios desacoplados (frontend, capas de orquestación, backends de negocio y bases de datos), la representación gráfica y formal mediante diagramas de arquitectura y de secuencia no es un mero formalismo documental, sino la herramienta estructural para garantizar la trazabilidad, mantenibilidad y robustez del sistema.
Importancia y Relevancia
En entornos distribuidos alojados en plataformas de la nube (como Render, Vercel o Supabase), surgen desafíos técnicos críticos derivados de la latencia de red, la concurrencia de solicitudes y la seguridad en la transmisión de datos. Comprender la diferencia entre la macroarquitectura (relación global entre componentes) y la microarquitectura (estructura interna de un componente), así como dominar el diseño de comunicación síncrona mediante REST, la gestión de tokens JWT, la prevención de condiciones de carrera (race conditions) y el principio de idempotencia, resulta imprescindible para construir sistemas escalables y libres de errores en producción.
2. Marco Conceptual: Definición de Conceptos Clave desde Cero
1. Diagrama de Arquitectura (Macroarquitectura)
Es la representación gráfica de alto nivel que muestra los componentes de un sistema, cómo se comunican entre sí y dónde están alojados digital o físicamente.
- Por qué existe: Permite visualizar la distribución de responsabilidades, los protocolos de interacción y las fronteras de infraestructura sin entrar en la implementación interna del código.
2. Microarquitectura
Es el diseño e implementación interna de un componente individual dentro del sistema global.
- Por qué existe: Mientras la macroarquitectura muestra que la API de usuarios se conecta con una base de datos, la microarquitectura define cómo está estructurada internamente esa API (por ejemplo, dividida en capas lógicas de rutas, middlewares, lógica de negocio y repositorios).
3. Diagrama de Secuencia
Un diagrama UML que ilustra cómo interactúan los objetos o componentes a lo largo del tiempo, detallando el orden cronológico de los mensajes (solicitudes y respuestas) intercambiados para cumplir con un flujo de trabajo específico.
- Por qué existe: Sirve para documentar la lógica paso a paso de un proceso (request), permitiendo identificar fallos de diseño, dependencias innecesarias o flujos de validación faltantes.
4. API Gateway y Capa de Orquestación
Un componente arquitectónico que actúa como punto único de entrada para las solicitudes de los clientes hacia los servicios internos.
- Por qué existe: Centraliza tareas transversales como la autenticación, la validación de tokens de seguridad (JWT), el enrutamiento y la orquestación de llamadas a múltiples servicios de fondo (backend).
5. Tokens de Autenticación (JWT - JSON Web Token)
Un estándar abierto utilizado para transmitir información de identidad de forma segura entre partes como un objeto JSON firmado digitalmente.
- Por qué existe: Permite una autenticación sin estado (stateless). Cada solicitud incluye el token en las cabeceras HTTP, lo que permite verificar la identidad y roles del usuario sin consultar constantemente a la base de datos principal de sesiones.
6. Desacoplamiento REST vs. Persistencia
Principio según el cual las interfaces HTTP presentadas hacia el cliente (verbos GET, POST, PATCH, DELETE) representan recursos de negocio abstractos (ABM) y no están atadas de manera obligatoria a operaciones directas en las tablas de la base de datos (SELECT, INSERT, UPDATE, DELETE).
7. Condición de Carrera (Race Condition)
Un fallo o comportamiento no deseado que ocurre en sistemas concurrentes cuando dos o más solicitudes procesan operaciones sobre el mismo recurso de forma simultánea, y el resultado final depende del orden de llegada o de ejecución de dichas solicitudes.
8. Idempotencia y Cabecera de Idempotencia (Idempotency Key)
Propiedad de las operaciones HTTP por la cual realizar una misma solicitud múltiples veces produce exactamente el mismo resultado y estado en el servidor que realizarla una sola vez.
- Por qué existe: Protege al sistema contra ejecuciones duplicadas de acciones críticas (como procesar un cobro o reservar un turno) cuando el cliente reintenta una solicitud o envía clics simultáneos.
9. Webhook
Mecanismo de comunicación asíncrona en el que un servidor envía una notificación HTTP automáticamente a otro sistema tan pronto como ocurre un evento específico.
3. Desarrollo del Tema
Sección 3.1: Modelado y Organización de Arquitecturas en la Nube
El diseño de la arquitectura de un sistema en la nube requiere la delimitación clara de sus capas físicas y lógicas. Un sistema típico de arquitectura distribuida contempla las siguientes capas:
[ Capa de Presentación ] ---> [ Capa de Orquestación / Gateway ] ---> [ Capa de Lógica de Negocio ] ---> [ Capa de Datos ]
(Frontend Web / Mobile) (API Gateway / Validaciones) (APIs / Backend) (Bases de Datos)
- Capa de Presentación (Frontend): Construida en entornos como JavaScript/Mobile, responsable de la interfaz de usuario y la captura de eventos.
- Capa de Orquestación y Validación: Encabezada por un API Gateway. Recibe las solicitudes HTTP del cliente, intercepta las cabeceras de autorización (
Authorization: Bearer <JWT>), valida la autenticidad y los permisos del token, e inyecta cabeceras personalizadas (custom headers) hacia los servicios internos. - Capa de Lógica de Negocio (Backend): Compuesta por microservicios o APIs dedicadas (por ejemplo, API de Usuarios, API de Turnos/Reservas). Cada una procesa la regla de negocio concreta.
- Capa de Datos: Conformada por motores de bases de datos relacionales o no relacionales (como MongoDB, PostgreSQL o Supabase).
Analogía Didáctica: El Mueble y la Mamushka
Para comprender las perspectivas de la arquitectura:
- Macroarquitectura (El Mueble): Al mirar una habitación, se observan distintos muebles (componentes). Cada mueble tiene una función (un cajón para ropa, otro para cubiertos).
- Microarquitectura (Dentro del Cajón): Al abrir un cajón específico (hacer zoom-in a una API), se descubre una estructura interna compartimentada (división para tenedores, cucharas y cuchillos).
Un diagrama de arquitectura general debe centrarse en mostrar la interacción de los "muebles" principales y cómo están alojados (por ejemplo, en Render o Vercel), agrupando componentes en capas lógicas solo cuando aporte claridad comunicativa.
MUEBLE COMPLETO (Macroarquitectura)
+-------------------------------------------------------------------+
| Cajón 1: Ropa | Cajón 2: Cubiertos | Cajón 3: Juguetes |
+-------------------------------------------------------------------+
|
V (Zoom-In)
INTERIOR DEL CAJÓN 2 (Microarquitectura)
+-------------------------------------------+
| Cucharas | Tenedores | Cuchillos |
+-------------------------------------------+
Estándares Visuales en Diagramas
- Uso de Iconos y Logos: Es recomendable emplear logos oficiales e imágenes con fondo transparente de las tecnologías (por ejemplo, Render, Mongo, Supabase) en lugar de bloques de texto plano, facilitando la lectura gráfica inmediata.
- Justificación de Agrupamientos: Toda caja o contorno agrupador en un diagrama debe responder a una razón explícita (ej. "Capa de Orquestación", "Servicios de Negocio en Render"). Agrupar elementos sin fundamento confunde la interpretación del modelo.
Sección 3.2: Estructuración Reglada de Diagramas de Secuencia
Un diagrama de secuencia documenta el comportamiento dinámico de la solución. Para mantener un estándar académico y profesional, debe regirse por los siguientes principios:
1. Principio de "Un Diagrama por Request"
No se debe documentar todo el sistema o múltiples interacciones en una sola lámina. Un diagrama de secuencia debe enfocarse exclusivamente en un único flujo de solicitud (request), por ejemplo: Crear Reserva, Modificar Reserva o Cancelar Reserva. Flujos triviales de consulta genérica (GET All) no requieren diagramación salvo que contengan lógica de negocio compleja.
2. Rigor Sintáctico en la Comunicación
Es crítico diferenciar la naturaleza de los mensajes según los componentes que interactúan:
- Entre Frontend / Gateway / APIs: Se utilizan Verbos HTTP (
POST /reservas,GET /usuarios,PATCH /turnos). - Entre APIs y Bases de Datos: Se utilizan Comandos de Persistencia / SQL (
SELECT * FROM servicios,INSERT INTO reservas,UPDATE turnos). Nunca debe diagramarse un método HTTP dirigiéndose a una base de datos ni una sentencia SQL enviada a una API.
3. Estructura de Control y Flujos de Error (alt)
Al representar validaciones en un bloque alternativo (alt), el estándar técnico dicta presentar siempre el camino feliz (Happy Path) en la sección superior y los escenarios de error en la sección inferior:
+-----------------------------------------------------------------------------------+
| alt: Validación de Token JWT |
+-----------------------------------------------------------------------------------+
| [JWT Válido] |
| API -> DB: SELECT * FROM usuarios WHERE id = x |
| API <-- DB: Registro encontrado |
| API -> Frontend: 200 OK (Procesa lógica principal) |
+-----------------------------------------------------------------------------------+
| [JWT Inválido / Expirado] |
| API -> Frontend: 401 Unauthorized |
+-----------------------------------------------------------------------------------+
4. Uso de Notas Explicativas
En lugar de saturar las firmas de los métodos con parámetros excesivos, se deben utilizar notas rectangulares adosadas a la línea de vida del componente (note left / note right) para detallar las reglas de negocio (ej. "Valida que la fecha de nacimiento coincida con el día actual para aplicar 50% de descuento").
Sección 3.3: Desacoplamiento entre Recursos REST y Operaciones de Persistencia
Existe una concepción simplificada inicial donde se asocia directamente un recurso REST con una tabla y una operación HTTP con una sentencia SQL (Regla 90/10):
| Operación HTTP (Front) | Operación SQL asumida (90%) | Abstracción de Negocio Real (10%) |
POST | INSERT | Puede ejecutar un UPDATE (ej. marcar un turno existente como ocupado). |
GET | SELECT | Puede realizar un INSERT contingente (ej. generar una tarjeta si el usuario no la posee). |
DELETE | DELETE | Usualmente ejecuta un UPDATE (borrado lógico / cambio de estado a cancelado). |
PATCH / PUT | UPDATE | Puede insertar registros de historial o auditoría. |
Ejemplo de Desacoplamiento:
En un sistema de reservas de turnos:
- El cliente emite una solicitud
POST /reservas. - A nivel de negocio, se está "creando una reserva".
- A nivel de base de datos, el backend ejecuta un comando
UPDATEsobre la tablaturnos, modificando el estado del turno de"disponible"a"ocupado"e inyectando elusuario_id. No se insertó una fila nueva; se actualizó un estado de recurso existente.
Sección 3.4: Concurrencia Avanzada: Condición de Carrera e Idempotencia
En aplicaciones distribuidas, la latencia de red y la interacción del usuario pueden generar llamadas concurrentes sobre el mismo endpoint.
El Problema: Condición de Carrera (Race Condition)
Supóngase un escenario en el cual un usuario pulsa repetidamente (dos clics rápidos) el botón "Pagar" en una aplicación móvil.
Usuario App Mobile API Payments
| | |
|--- Clic 1 ------>|-- POST /pagar (req 1) ->| (Inicia procesamiento 1)
|--- Clic 2 ------>|-- POST /pagar (req 2) ->| (Inicia procesamiento 2)
| | |
| |<-- Error (req 2) -------| (Req 2 falla/falla de red)
|<-- Muestra Error-| |
| |<-- 200 OK (req 1) ------| (Req 1 cobra con éxito)
Resultado Anómalo: La respuesta de error del segundo intento llega o se procesa antes de confirmar la respuesta correcta del primer intento. La aplicación móvil muestra en pantalla un mensaje de "Error en el pago", pero en el backend el cobro fue procesado con éxito. El usuario, desinformado, intentará pagar nuevamente, generando un cobro duplicado.
La Solución: Patrón de Idempotencia mediante X-Idempotency-Key
Para resolver de raíz este problema en el backend, se implementa una Cabecera de Idempotencia en las solicitudes de modificación o creación (POST).
App Mobile API de Pagos / Base de Datos
| |
|-- POST /pagar (Header: Idempotency-Key: 1) ->|
|-- POST /pagar (Header: Idempotency-Key: 1) ->| (Detecta Key "1" en proceso)
| |
| |-- [Req 1]: Procesa cobro exitoso.
| |-- [Req 2]: Entra en bucle de espera (sleep/loop).
| |
|<-- 200 OK (Resultado de Req 1) --------------|
| |-- [Req 2]: Despierta, lee el resultado del Req 1
|<-- 200 OK (Retorna la MISA respuesta) -------| y devuelve la misma respuesta sin re-cobrar.
- Generación de la clave: El cliente frontend o mobile genera un identificador único de transacción (
Idempotency-Key: 1) y lo adjunta en la cabecera HTTP de la solicitud. - Detección en Backend: Al recibir el primer request (
req 1), el backend registra que la clave1está en estado"Procesando". - Manejo del Request Concurrente (
**req 2**): Si ingresa una segunda solicitud con la misma clave (Idempotency-Key: 1) mientras la primera aún se ejecuta, el backend no procesa un segundo pago. En su lugar, pone la segunda solicitud en un ciclo de espera o reposo (sleep/loop). - Respuesta Idempotente: Tan pronto como el
req 1termina y guarda el resultado (ej.200 OK - Cobro Exitoso), la solicitudreq 2se despierta, toma exactamente el mismo resultado y lo retorna al cliente. Ambas solicitudes reciben la misma confirmación, garantizando que el cobro se realice una sola vez.
4. Ejemplos Prácticos y Casos Aplicados Paso a Paso
Caso Práctico 1: Diagramado Paso a Paso del Flujo de Reserva de Turnos
A continuación se detalla la secuencia lógica de validación e interacción para el endpoint POST /reservas:
- Solicitud del Cliente: El Frontend envía
POST /reservasincluyendo la cabeceraAuthorization: Bearer <JWT>y un cuerpo JSON con{ profesional_id, servicio_id, fecha_hora }. - Validación de Identidad (JWT):
- Evaluación: El backend (o Gateway) verifica la firma digital del JWT.
- Camino de Error: Si el token es inválido o expiró, corta la ejecución y retorna inmediatamente un código
401 Unauthorized.
- Validación de Formato de Datos:
- Evaluación: El backend evalúa los tipos de datos recibidos en el cuerpo.
- Camino de Error: Si falta un campo obligatorio o el formato de fecha es incorrecto, retorna un código
400 Bad Request.
- Verificación de Existencia y Reglas de Negocio en Base de Datos:
- Ejecución SQL: El backend emite un
SELECT * FROM servicios WHERE id = servicio_id. - Camino de Error: Si la consulta no devuelve registros, retorna un código
422 Unprocessable Entity(Entidad no procesable).
- Ejecución SQL: El backend emite un
- Interacción entre Microservicios (Requisito de Integración):
- Solicitud Interna: Para calcular el costo final, el Backend de Reservas invoca mediante un
GET /usuarios/{id}al Backend de Usuarios para obtener la fecha de nacimiento del cliente. Si la fecha coincide con el día actual, se aplica un descuento de cumpleaños.
- Solicitud Interna: Para calcular el costo final, el Backend de Reservas invoca mediante un
- Persistencia del Estado:
- Ejecución SQL: Se ejecuta un
UPDATE turnos SET estado = 'ocupado', usuario_id = x WHERE id = turno_id AND estado = 'disponible'.
- Ejecución SQL: Se ejecuta un
- Respuesta Final: El sistema retorna
201 Createdcon los detalles de la reserva confirmada.
5. Errores Comunes y Confusiones Frecuentes
1. Mezcla de Conceptos de Macroarquitectura y Microarquitectura
- Error: Asumir que la separación interna en capas de un microservicio (controlador, servicio, repositorio) es un diagrama de arquitectura general del sistema.
- Aclaración: La macroarquitectura muestra las piezas del sistema global (Frontend, Gateways, APIs, Databases); la microarquitectura detalla el diseño interno de una sola de esas piezas.
2. Sobrecarga de Diagramas de Secuencia
- Error: Agrupar en una sola lámina la autenticación, la selección de profesionales, la carga de servicios y la reserva final.
- Aclaración: Debe existir un diagrama de secuencia por cada interacción/endpoint (
request) individual. La secuencia de consulta de servicios no debe mezclarse con la secuencia de creación de la reserva.
3. Incoherencia en Sintaxis de Mensajes
- Error: Graficar que el Frontend envía un
SELECTa la API o que la API le envía unPOSTa la base de datos PostgreSQL. - Aclaración: Entre cliente y API siempre se usan verbos y rutas HTTP (
GET /recurso,POST /recurso). Entre API y Base de Datos siempre se usan comandos de persistencia (SELECT,INSERT,UPDATE).
4. Asumir Equidad Absoluta entre REST y Tablas de Base de Datos
- Error: Creer que invocar
DELETE /reservas/1debe borrar físicamente la fila1de la tabla de la base de datos. - Aclaración: A nivel de API se expone una baja lógica del recurso; internamente la base de datos suele ejecutar un
UPDATEpara cambiar el estado del registro a"cancelado".
5. Delegar el Control de Duplicados Exclusivamente al Frontend
- Error: Deshabilitar un botón en la interfaz gráfica para evitar clics dobles y considerar que el problema de la condición de carrera está resuelto.
- Aclaración: Los controles de interfaz son eludibles por fallos de red, scripts o herramientas como Postman. La integridad de las transacciones duplicadas debe asegurarse obligatoriamente en el backend mediante patrones de Idempotencia.
6. Fechas Importantes y Avisos Académicos
A partir del análisis exhaustivo del contexto de la clase y las indicaciones del docente, se establece el siguiente cronograma y cuadro de avisos regulatorios:
Cronograma de Evaluaciones y Fechas Límite
| Fecha | Tipo de Evento | Descripción Detallada |
| 27 de Octubre | Clase de Corrección | Instancia de consulta y corrección incremental de Trabajos Prácticos (TP). |
| 3 de Noviembre | Clase de Corrección | Última clase de revisión y ajustes antes de la entrega formal. |
| 10 de Noviembre | Entrega Virtual / Presentación Presencial (Instancia Principal de Parcial) | Fecha Límite Principal. Entrega virtual del trabajo y presentación presencial en el instituto. En esta instancia se asigna la nota de parcial. |
| 17 de Noviembre | Primera Fecha de Recuperación / Corrección | Instancia para entregar ajustes pedidos en la presentación del 10/11. Permite convertir una nota de "No Aprobado" a "Aprobado", o de "Aprobar" a "Promocionar". |
| 24 de Noviembre | Segunda Fecha de Recuperación / Cierre de Cursada | Último día de cursada oficial. Presentación final de correcciones pendientes. Los alumnos aprobados en fechas previas no requieren asistir. |
Contingencia por Visita Papal (Aviso Importante)
Existe la posibilidad de que se decrete feriado alrededor del 10 de noviembre debido a una visita del Papa. Ante este escenario, la cátedra maneja las siguientes alternativas de reorganización:
- Presentación Virtual Dividida: Repartir las exposiciones de los grupos en modalidad virtual entre las fechas del 10 de noviembre y el 17 de noviembre.
- Reprogramación Total: Trasladar la presentación presencial/virtual al 17 de noviembre para la totalidad de la cursada. Nota: La decisión final se definirá por mayoría o indicación institucional a medida que se acerque la fecha.
Indicaciones Regulatorias del Profesor
- Presentación de Venta (Sales Deck / Flyer / PPT): Es un entregable OPCIONAL por el momento. Diseñar una presentación comercial (deck de venta o blueprint) y defender el producto como una venta otorgará un puntaje adicional ("plus").
- Advertencia: El profesor explicitó que este criterio es dinámico; si el nivel de avance general de los grupos hacia la fecha límite es deficiente, la presentación de venta pasará a ser de carácter OBLIGATORIO.
- Requisito de Comunicación entre Servicios: Es condición obligatoria para la aprobación del Trabajo Práctico que exista al menos una llamada o comunicación directa (vía HTTP/REST) entre dos servicios o backend independientes del sistema.
7. Síntesis y Conclusiones
- Abstracción y Claridad: Los diagramas de arquitectura deben reflejar la interacción global de los componentes de software en la nube y su infraestructura sin saturar con información de contexto innecesaria, fundamentando cada agrupación lógica.
- Aislamiento de Diagramas de Secuencia: La documentación dinámica exige estructurar un diagrama por cada solicitud HTTP concreta, diferenciando de forma tajante el lenguaje HTTP empleado con el cliente del lenguaje de consultas (SQL/NoSQL) utilizado con las bases de datos.
- Manejo Formal del Flujo Feliz y Excepciones: En la representación UML de validaciones (
alt), el camino exitoso debe priorizarse en el bloque superior, canalizando las fallas de token (401), errores de formato (400) o inconsistencias de negocio (422) en las subdivisiones inferiores. - Robustez Concurrente: Para evitar fallos graves de consistencia en la nube como la condición de carrera, las operaciones de modificación o cobro deben implementar patrones de idempotencia a través de cabeceras dedicadas (
X-Idempotency-Key), garantizando la misma respuesta ante reintentos accidentales.
8. Preguntas de Repaso
Nivel Básico
- ¿Cuál es la diferencia principal entre un diagrama de macroarquitectura y uno de microarquitectura?
- En un diagrama de secuencia, ¿qué lenguaje o sintaxis debe utilizarse para graficar la interacción entre una API y su Base de Datos?
- ¿Qué código de respuesta HTTP debe retornar un backend cuando la firma de un token JWT recibido es inválida?
Nivel Intermedio
- Explique el principio del desacoplamiento entre verbos HTTP REST y operaciones de base de datos. Dar un ejemplo donde un
POSTejecute unUPDATE. - En la diagramación de un bloque alternativo (
alt) para validar un request, ¿cómo deben ordenarse visualmente los escenarios de éxito y de error? - ¿Por qué se considera inapropiado documentar flujos como
GET Allmediante diagramas de secuencia complejos?
Nivel Avanzado
- Describa detalladamente el problema de la Condición de Carrera (Race Condition) cuando un usuario presiona dos veces seguidas el botón de cobro en una aplicación móvil.
- Explique el mecanismo técnico mediante el cual una cabecera
X-Idempotency-Keyresuelve la condición de carrera en el backend, detallando el comportamiento de la segunda solicitud concurrente.