Monolito, modular monolith y servicios

← SE-302 — Vistas lógica, runtime, datos y despliegue · ↑ Parte 25 · 📚 Índice completo · 🌐 Portal · SE-304 — Capas, hexagonal, clean y ports and adapters →

Prerrequisitos

• Haber completado o diagnosticado SE-302 y poder explicar qué evidencia produjo.
• Manejar archivos de texto, rutas y control de versiones a nivel básico.
• Disponer de editor Markdown, Mermaid y repositorio de ADR.

Problema auténtico

Un equipo que trabaja en una servicio financiero debe decidir sobre Monolito, modular monolith y servicios. Tiene información incompleta, restricciones de tiempo y personas afectadas por una decisión incorrecta. El reto no es repetir definiciones: es convertir el tema en un resultado revisable, distinguir observación de supuesto y conservar evidencia para que otra persona pueda continuar o cuestionar el trabajo.

Objetivos observables

Al terminar podrás:

1. explicar Monolito y modular con un ejemplo y un contraejemplo;
2. comparar al menos dos opciones usando evidencia, riesgo, costo y reversibilidad;
3. producir el artefacto dossier de arquitectura con decisiones y escenarios para que otra persona pueda revisarlo;
4. diagnosticar el fallo «elegir un estilo arquitectónico antes de identificar fuerzas y atributos» sin ocultar incertidumbre;
5. transferir la decisión a otra plataforma o dominio sin depender de una marca.

Temas y por qué importan

Mapa conceptual

flowchart LR
    P["Problema: Monolito, modular monolith y servicios"] --> M["Modelo: Monolito"]
    M --> D["Decisión: modular"]
    D --> E["Evidencia: monolith"]
    E --> R["Revisión: servicios"]
    R -->|nueva información| M

El diagrama se lee de izquierda a derecha: el problema obliga a construir un modelo; el modelo permite decidir; la decisión solo se sostiene con evidencia; y la revisión devuelve nueva información al modelo. No es una secuencia lineal de entrega, sino un ciclo de aprendizaje aplicado a Monolito, modular monolith y servicios.

Conceptos y decisiones

La arquitectura expresa decisiones significativas y difíciles de cambiar frente a atributos y restricciones; un diagrama solo es una vista del razonamiento.

La pregunta rectora de esta parte es: ¿qué escenario de calidad fuerza la decisión y qué alternativa se descartó? La respuesta debe apoyarse en escenarios medibles, vistas coherentes, ADR y análisis de consecuencias.

1. Monolito: modelo

En esta clase, Monolito se estudia como modelo. Su función es delimita qué entidad, estado o relación se estudia y qué queda fuera. Debe conectarse con la pregunta «¿qué escenario de calidad fuerza la decisión y qué alternativa se descartó?» y demostrarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias. Un tratamiento superficial solo lo nombraría; un tratamiento útil identifica precondiciones, transición, resultado observable y caso en que la explicación deja de sostenerse. Aplica esa secuencia a Monolito, modular monolith y servicios, registra los supuestos y explica qué decisión concreta cambia al comprenderla.

2. Modular: mecanismo

En esta clase, modular se estudia como mecanismo. Su función es explica la cadena causal: qué entrada cambia qué estado y mediante qué regla. Debe conectarse con la pregunta «¿qué escenario de calidad fuerza la decisión y qué alternativa se descartó?» y demostrarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias. Un tratamiento superficial solo lo nombraría; un tratamiento útil identifica precondiciones, transición, resultado observable y caso en que la explicación deja de sostenerse. Aplica esa secuencia a Monolito, modular monolith y servicios, registra los supuestos y explica qué decisión concreta cambia al comprenderla.

3. Monolith: evidencia

En esta clase, monolith se estudia como evidencia. Su función es define la señal observable que permite contrastar el modelo sin confundir correlación con causa. Debe conectarse con la pregunta «¿qué escenario de calidad fuerza la decisión y qué alternativa se descartó?» y demostrarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias. Un tratamiento superficial solo lo nombraría; un tratamiento útil identifica precondiciones, transición, resultado observable y caso en que la explicación deja de sostenerse. Aplica esa secuencia a Monolito, modular monolith y servicios, registra los supuestos y explica qué decisión concreta cambia al comprenderla.

4. Servicios: decisión

En esta clase, servicios se estudia como decisión. Su función es convierte el conocimiento en opciones comparables, límites, riesgos y condiciones de reversión. Debe conectarse con la pregunta «¿qué escenario de calidad fuerza la decisión y qué alternativa se descartó?» y demostrarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias. Un tratamiento superficial solo lo nombraría; un tratamiento útil identifica precondiciones, transición, resultado observable y caso en que la explicación deja de sostenerse. Aplica esa secuencia a Monolito, modular monolith y servicios, registra los supuestos y explica qué decisión concreta cambia al comprenderla.

La regla de trabajo es conservar trazabilidad: problema → supuesto → opción → decisión → evidencia → revisión. Una solución técnicamente posible puede seguir siendo inadecuada si excluye personas, desplaza riesgos o no puede mantenerse. La herramienta concreta se elige después de fijar el comportamiento y el criterio de aceptación.

Definiciones de trabajo

• Monolito: concepto usado aquí como modelo; se acepta solo si puede observarse o justificarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias.
• Modular: concepto usado aquí como mecanismo; se acepta solo si puede observarse o justificarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias.
• Monolith: concepto usado aquí como evidencia; se acepta solo si puede observarse o justificarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias.
• Servicios: concepto usado aquí como decisión; se acepta solo si puede observarse o justificarse mediante escenarios medibles, vistas coherentes, ADR y análisis de consecuencias.

Estas definiciones son operativas para el borrador: deberán sustituirse o precisarse con terminología de las fuentes de la clase durante la revisión cualitativa. No son un glosario normativo.

Ejemplo mínimo

Registra una sola decisión sobre Monolito, modular monolith y servicios:

El valor del ejemplo no está en “tener razón”, sino en que el razonamiento pueda ser inspeccionado.

Ejemplo profesional

En la servicio financiero, el equipo prepara un cambio relacionado con Monolito, modular monolith y servicios. Parte de esta pregunta: ¿qué escenario de calidad fuerza la decisión y qué alternativa se descartó? Antes de implementarlo, registra personas afectadas, estados normales y degradados, datos utilizados, costo de reversión y señales de éxito. Dos opciones se comparan con la misma tabla y se contrastan usando escenarios medibles, vistas coherentes, ADR y análisis de consecuencias. La alternativa ganadora queda condicionada a una prueba pequeña. La revisión incluye a producto, ingeniería y una persona que no participó en la propuesta. El resultado se archiva como context.md y enlaza la evidencia, no solo la conclusión.

Práctica guiada

1. Crea work/SE-303/ sin copiar datos personales ni secretos.
2. Formula el problema en una frase que incluya actor, necesidad y consecuencia.
3. Separa en una tabla hechos observados, inferencias, incógnitas y restricciones.
4. Propón dos opciones y una opción de no actuar; explicita costos y riesgos.
5. Construye el dossier de arquitectura con decisiones y escenarios con los archivos indicados abajo.
6. Introduce deliberadamente el fallo controlado y registra síntomas antes de corregirlo.
7. Pide una revisión: la otra persona debe reconstruir la decisión solo con el artefacto.
8. Actualiza la conclusión y anota qué evidencia cambiaría la decisión.

Ejercicios

1. Fundamental: define Monolito y modular con un ejemplo propio, un contraejemplo y un criterio que permita distinguirlos.
2. Aplicado: resuelve el caso de la servicio financiero, compara tres opciones y entrega context.md con trazabilidad completa.
3. Avanzado: cambia una restricción crítica —plataforma, escala, conectividad, regulación o capacidad del equipo— y demuestra qué partes de la decisión se conservan y cuáles deben revisarse.

Reto verificable

Entrega el dossier de arquitectura con decisiones y escenarios de forma que una persona que no participó en la clase pueda reconstruir problema, supuestos, opciones, decisión y evidencia. El reto se acepta únicamente si esa persona puede señalar una condición concreta que cambiaría la decisión y reproducir al menos una comprobación sin pedir contexto oral adicional.

Fallo controlado y diagnóstico

Provoca de forma segura este fallo: elegir un estilo arquitectónico antes de identificar fuerzas y atributos. No lo ejecutes sobre producción ni datos reales. Captura la decisión inicial, el síntoma observable y la primera hipótesis. Después reduce el caso, busca evidencia que pueda refutar tu hipótesis y corrige la causa, no solo el síntoma. Cierra con una medida preventiva y un procedimiento de recuperación.

Entorno y archivos clave

Entorno de referencia: editor Markdown, Mermaid y repositorio de ADR. La actividad es documental y portable; cualquier comando adicional debe declarar sistema operativo y versión.

work/SE-303/
├── README.md
│   ├── context.md
│   ├── architecture.md
│   ├── adr.md
├── activity.yaml
└── rubric.json

README.md explica cómo reproducir la actividad; context.md contiene el resultado principal; los demás archivos separan evidencia y revisión. activity.yaml y rubric.json son contratos generados junto a esta guía.

Seguridad, ética y accesibilidad

• usa datos sintéticos o anonimizados y aplica minimización;
• no incluyas tokens, rutas privadas ni información personal en evidencias;
• identifica personas que reciben beneficios, cargas o riesgo de exclusión;
• ofrece una alternativa textual a diagramas y no uses color como única señal;
• verifica navegación por teclado y lenguaje comprensible cuando exista interfaz;
• detén la práctica si requiere acceso no autorizado o puede afectar sistemas reales.

Transferencia

Repite la decisión en un segundo contexto: cambia la servicio financiero por otro de los dominios persistentes, o cambia Windows por Linux/macOS cuando aplique. Conserva problema, criterios y evidencia; modifica únicamente los supuestos dependientes del entorno. Explica por escrito qué conocimiento fue transferible y qué parte pertenecía a la herramienta.

Evaluación y evidencia

Entrega el directorio work/SE-303/ y una reflexión de máximo 300 palabras. La rúbrica machine-readable está en rubric.json; no se aprueba solo por completar pasos.

Fuentes

Fuentes verificadas el 2026-09-30:

• C4 model — C4 model project. https://c4model.com/ — se usa para contrastar vocabulario, límites y criterios aplicables.
• ISO/IEC 25010:2023 — ISO. https://www.iso.org/standard/78176.html — se usa para contrastar vocabulario, límites y criterios aplicables.
• SWEBOK Guide v4.0a — IEEE Computer Society. https://www.computer.org/education/bodies-of-knowledge/software-engineering — se usa para contrastar vocabulario, límites y criterios aplicables.

Preguntas frecuentes

¿Basta con definir los términos del título?

No. Debes mostrar cómo se relacionan, qué mecanismo explican, qué evidencia los contrasta y qué decisión profesional cambia gracias a esa comprensión.

¿La herramienta recomendada es obligatoria?

No. El entorno de referencia hace reproducible la práctica, pero puedes usar otro si documentas equivalencias, versiones, diferencias y procedimiento de recuperación.

¿Completar los archivos aprueba automáticamente la clase?

No. Los archivos son contenedores de evidencia. La aprobación depende de la calidad del razonamiento, la reproducibilidad, el diagnóstico y la revisión contra las fuentes.

Límites y siguiente paso

Esta guía enseña a razonar y producir evidencia sobre Monolito, modular monolith y servicios; no certifica dominio profesional ni valida una implementación productiva. El siguiente enlace curricular es SE-304. Si la actividad necesita código o infraestructura real, debe añadir pruebas y documentar versiones, limpieza, resultados y recuperación antes de afirmar que fue ejecutada.

← SE-302 — Vistas lógica, runtime, datos y despliegue · ↑ Parte 25 · 📚 Índice completo · 🌐 Portal · SE-304 — Capas, hexagonal, clean y ports and adapters →