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
¿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.
¿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.
¿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é hacen
Qué debe pasar
1
Suben el sistema sano
Verde
2
Agregan a mano el import que su regla prohíbe
ROJO, con el texto de su porque
3
Quitan esa línea
Verde 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
Repositorio público. Si es privado, Actions tiene tope y no vamos a pelear con eso.
Suban la carpeta completa:src/, arquitectura/, tools/ y .github/.
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
Pestaña Actions → si sale un aviso amarillo, presionen el botón verde para habilitar los flujos.
Cada push dispara el pipeline solo. No hay que hacer nada más.
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íntoma
La causa
El arreglo
El pipeline no corre
Flujos deshabilitados
Actions → botón verde del aviso
Dice «no encontré archivos .js»
La carpeta no se llama src
Renómbrenla a src
Verde aunque violaron la regla
El nombre del módulo en reglas.json no coincide con el archivo
Que 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é
Peso
Cómo se mide
Los tres commits
40%
Objetivo. Están o no están en el historial: verde, rojo, verde
Los dos ADR
30%
Las cinco secciones, y que «qué pagamos» diga algo concreto
La sustentación
30%
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
Muéstreme su commit rojo y explíqueme, sin leer, qué se rompía y por qué eso le importaba al negocio.
¿Qué pagaron por su ADR-002? Y si alguien dijera que ese costo es muy alto, ¿qué le responde?
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
¿Cuál de sus cuatro módulos es el menos confiable, y qué hicieron para que su caída no tumbe al resto?
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
Un driver es una propiedad, no una funcionalidad. Si no se puede violar con una línea, es un deseo.
Un ADR sin «qué pagamos» no es un ADR. Es una decisión a medias.
Una regla que nunca se violó a propósito no se sabe si funciona. El commit rojo es la prueba.
El próximo martes: sustentación. Cinco minutos, sin notas, con su repositorio en pantalla.
Antes de irse
Lo que dejo anotado
Su enlace de GitHub, por el canal, antes de salir del salón.
Su hoja del taller con los dos drivers escritos, en papel.
La pregunta sorteada a su grupo, apuntada por ustedes.
Y un consejo para el martesPreparen la sustentación los cinco, no uno solo. No saben a quién le va a tocar hablar.