Ingeniería de Sistemas · Semestre IV · 2026-2 · Clase 8 de 16

Rómpelo a
propósito

Una IA les construye el sistema en cinco minutos. Eso ya no es mérito de nadie. Lo que se califica hoy es que ustedes decidan sus fronteras, las escriban, y demuestren que se hacen cumplir solas. — Elkin Rodríguez E.

Cómo se reparte la clase de hoy

Hoy se trabaja

35
La explicación minutos. Qué se construye, qué se entrega y cómo se califica. Ahora.
115
Ustedes trabajando minutos. Yo circulando por las mesas. Salen con el repositorio hecho.
20
Cierre y sorteo minutos. Y se sortea quién sustenta qué el próximo martes.
Esto no es tarea para la casaEl repositorio se termina hoy, aquí. Lo que queda para el martes es sustentarlo.
Reconexión

Todo lo del semestre aterriza aquí

1
Los drivers mandan Y las decisiones que salen de ellos se escriben en un ADR.
6
Un pipeline puede rechazar Lo que viola una decisión no entra, aunque el código funcione.
7
Esperar tiene precio Si una pieza espera a otra, la falla de una tumba a las dos.
HoyLas tres cosas, en su propio sistema — no en el mío ni en un ejemplo de libro.
Lo que cambió en este oficio

Escribir el código
dejó de ser el trabajo.

Hace tres años, construir este sistema era la tarea. Hoy una IA lo hace mientras usted lee esta diapositiva. Lo que no hace la IA es decidir qué NO debe poder hacer su sistema. Eso es arquitectura, y es lo único que hoy se califica.

Paso 1 · 10 min

La IA construye

Elijan un dominio que no sea canchas: biblioteca, parqueadero, cafetería, gimnasio, veterinaria, lavandería. Que sea suyo.

Péguenle esto a la IA · solo cambian la primera línea
Actúa como desarrollador. Construye un sistema web
mínimo de [MI DOMINIO].

Requisitos estrictos:
1. Exactamente 4 archivos en una carpeta src/.
2. Módulos ES6 con import/export. SIN frameworks, SIN npm.
3. Un index.html que importe src/app.js.
4. Los módulos se llaman entre sí DIRECTAMENTE con import.
5. Datos en memoria, sin base de datos.

Entrégame los archivos completos, listos para copiar.
Ojo con el punto 4 del prompt

Le pedimos que lo haga mal a propósito

El prompt dice que los módulos se llamen directamente. Eso es exactamente la llamada directa de la clase pasada: si una pieza espera a otra y la otra falla, se cae toda la cadena.

Por eso lo pedimos asíPorque su segundo ADR va a ser justamente arreglar eso. Necesitamos el problema presente en el código para poder decidir sobre él.
Paso 2 · 10 min · aquí es donde se van a atascar

Ustedes deciden los drivers

Un driver no es una funcionalidad. Es una propiedad que el negocio necesita y que la arquitectura tiene que proteger.

No es driver«que sea rápido»
«que use buenas prácticas»
«que sea escalable»
«que preste libros»
Sí es driver«si el correo se cae,
el préstamo no se puede caer»

«el catálogo solo consulta,
nunca modifica»
La prueba de una líneaSi su driver no se puede violar con una línea de código, no es un driver: es un deseo.
Cómo encontrar sus dos drivers

Tres preguntas al sistema

  1. ¿Cuál módulo solo debería leer? El que consulta y nunca modifica. Si pudiera modificar, un error de consulta haría un daño real.
  2. ¿Cuál módulo es el menos confiable? Casi siempre el que avisa, notifica o manda correos. Nadie debería depender de que ese responda.
  3. ¿Qué dos cosas no deberían caerse juntas? Si una se cae, ¿por qué tendría que caerse la otra?
Con eso ya tienen los dosLa pregunta 1 les da un driver de responsabilidad. La 2 y la 3 les dan uno de disponibilidad. Escríbanlos en la hoja antes de seguir.
Paso 3 · 12 min

Un ADR por driver

Cinco secciones. La quinta es la que separa un ADR de verdad de una tarea copiada.

1
Contexto Qué situación obliga a decidir esto.
2
Driver que manda El del paso 2, tal cual lo escribieron.
3
Decisión Qué módulo NO puede importar a cuál, y por qué.
4
Alternativa descartada Qué era lo obvio, y por qué no.
5
Qué pagamos Toda decisión cuesta algo. Si esto está vacío, el ADR no sirve.
La sección 5, que es la que se cae

«Qué pagamos»

Es la única sección donde no se puede improvisar, porque exige haber pensado en el costo y no solo en el beneficio.

No sirve«ninguno»
«un poco más de código»
«nada relevante»
Sí sirve«el aviso llega con demora
y a veces no llega;
hay que darle al usuario
una forma de pedirlo de nuevo»
Si no encuentran qué paganEntonces no tomaron una decisión: escribieron algo obvio. Toda frontera real cuesta algo.
Paso 4 · 10 min

Un ADR convertido en regla

Descarguen el kit del taller, peguen su carpeta src/ adentro, y llenen arquitectura/reglas.json:

arquitectura/reglas.json
[
  {
    "id": "R1",
    "adr": "ADR-002",
    "modulo": "prestamos",
    "no_puede_importar": ["avisos"],
    "porque": "Si el correo se cae, el prestamo NO se puede caer."
  }
]
El campo que más importa

El porque va en lenguaje de negocio

Técnico · no sirve«viola el principio de
inversión de dependencias»
Negocio · sí sirve«si el correo se cae,
el préstamo no se puede caer»
Por quéEse texto es lo que va a leer, dentro de seis meses, alguien que no estuvo en esta clase y que está a punto de romper la regla. Tiene que entender qué se rompe, no cómo se llama el principio.
Paso 5 · 13 min · ESTO ES LA ENTREGA

Tres commits, en este orden

#Qué hacenQué debe pasar
1Suben el sistema sanoVerde
2Agregan a mano el import que su regla prohíbeROJO, con el texto de su porque
3Quitan esa líneaVerde otra vez
El commit rojo es la pruebaSin él no hay evidencia de que su regla funcione. Una regla que nunca se violó a propósito no se sabe si sirve. Y sí, lo voy a mirar en el historial.
Lo que va a pasar cuando lo vean rojo

Van a querer arreglarlo rápido

Y ese es el momento del semestre. Cuando el pipeline se pone rojo hay dos caminos, y solo uno es el correcto:

Lo fácil

Borrar la regla de reglas.json. El pipeline pasa a verde. Y el problema sigue ahí, ahora invisible.

Lo correcto

Quitar el import. El pipeline pasa a verde porque el problema se resolvió.

Y si de verdad creen que la regla está malSe puede cambiar. Pero primero se cambia el ADR, con su razón escrita. Cambiar la regla sin cambiar el ADR es esconder una decisión.
Lo que necesitan de GitHub · al subir

Tres cosas al montarlo

  1. Repositorio público. Si es privado, Actions tiene tope y no vamos a pelear con eso.
  2. Suban la carpeta completa: src/, arquitectura/, tools/ y .github/.
  3. La carpeta .github empieza con punto y es oculta. Si no la ven, activen «mostrar archivos ocultos» — sin ella el pipeline no existe.
Lo que necesitan de GitHub · al correrlo

Tres cosas al probarlo

  1. Pestaña Actions → si sale un aviso amarillo, presionen el botón verde para habilitar los flujos.
  2. Cada push dispara el pipeline solo. No hay que hacer nada más.
  3. Para leer el rojo: Actions → el flujo con la X → clic en el paso → ahí está el texto de su porque.
Para todo lo demásLa Guía de campo · Git y GitHub está en los recursos del curso. Su módulo 4 es esto mismo, paso a paso y con los comandos copiables.
Los tres atascos que voy a ver hoy

Y cómo se resuelven

SíntomaLa causaEl arreglo
El pipeline no correFlujos deshabilitadosActions → botón verde del aviso
Dice «no encontré archivos .js»La carpeta no se llama srcRenómbrenla a src
Verde aunque violaron la reglaEl nombre del módulo en reglas.json no coincide con el archivoQue modulo sea el nombre del archivo, sin .js
El tercero es el más traicioneroSi el verificador dice verde cuando ustedes esperaban rojo, la regla no está apuntando a donde creen. Revisen que el nombre coincida exactamente.
Cómo se califica · y esto es lo que más les importa

Tres partes, tres pesos

QuéPesoCómo se mide
Los tres commits40%Objetivo. Están o no están en el historial: verde, rojo, verde
Los dos ADR30%Las cinco secciones, y que «qué pagamos» diga algo concreto
La sustentación30%El próximo martes, individual, sin notas
El 40% es regalado y nadie lo va a perder por no saberLos tres commits no requieren talento: requieren hacerlos. Si salen hoy con eso, ya tienen casi la mitad.
La sustentación · próximo martes

Cinco minutos, sin notas

Al final de la clase de hoy sorteo una pregunta por grupo. La saben desde hoy — lo que no saben es a quién del grupo le va a tocar responderla.

Qué traen

Su repositorio abierto en pantalla. Nada más.

Qué hacen

Responden la pregunta sorteada mostrando su código y su ADR.

Qué no vale

Leer el ADR en voz alta. Hay que explicarlo.

Las preguntas del sorteo · 1 a 3

Ya las saben

  1. Muéstreme su commit rojo y explíqueme, sin leer, qué se rompía y por qué eso le importaba al negocio.
  2. ¿Qué pagaron por su ADR-002? Y si alguien dijera que ese costo es muy alto, ¿qué le responde?
  3. Si borro su regla de reglas.json, el pipeline pasa a verde. ¿Por qué eso no resuelve nada?
Las preguntas del sorteo · 4 y 5

Y las dos difíciles

  1. ¿Cuál de sus cuatro módulos es el menos confiable, y qué hicieron para que su caída no tumbe al resto?
  2. La IA escribió su sistema. ¿Qué parte de este trabajo no habría podido hacer ella, y por qué?
La quinta es la que de verdad evalúoSi pueden responderla bien, entendieron el semestre completo. Y es la única que no está en ningún archivo del repositorio: hay que haberla pensado.
A trabajar · 115 minutos

Todo está en la hoja

Los cinco pasos con sus minutos, el prompt completo, la plantilla del ADR, la plantilla de la regla y la lista de verificación. Si me preguntan algo, les voy a decir en qué parte de la hoja está.

Yo voy a estar circulandoLlámenme cuando estén atascados de verdad — no para que les diga si su driver está bien. Eso lo decide usted, que es el arquitecto.
El orden importa · no se salten pasos

Dos errores de secuencia

Error 1 · escribir la regla antes del ADR

Sale una regla técnica sin razón de negocio. El orden es: driver → ADR → regla → código.

Error 2 · subir todo al final

Suban el sistema sano primero y confirmen el verde. Si suben todo junto y sale rojo, no van a saber por qué.

Punto de control · a las dos horas de claseA esa hora quiero ver el primer verde en la pantalla de todos. Quien no lo tenga, me avisa y lo vemos juntos.
Hacia dónde va todo esto

No hay parcial escrito

El 40% del segundo corte es este trabajo: su sistema, sus decisiones documentadas, y la prueba de que se hacen cumplir solas.

Y esto es lo que se lleva a una entrevistaUn repositorio público donde se ve que usted tomó decisiones, escribió por qué, y las hizo verificables. Eso vale más que cualquier certificado, porque no se puede fingir: el historial está ahí.
Cierre

Se llevan tres ideas

El próximo martes: sustentación. Cinco minutos, sin notas, con su repositorio en pantalla.
Antes de irse

Lo que dejo anotado

Y un consejo para el martesPreparen la sustentación los cinco, no uno solo. No saben a quién le va a tocar hablar.
← Portal
← → o el apuntador para avanzar · F pantalla completa · clic en los términos azules
1 / 26