Objetivo de la práctica

Antes de escribir una línea de código de tu MVP, vas a planificar su diseño con ayuda de la IA.

Hoy vas a:

1. Usar un chat de IA para explorar 2-3 arquitecturas posibles de tu MVP y compararlas.
2. Escribir un documento de diseño inicial de una página.
3. Redactar una reflexión individual sobre una decisión que cambió al hablar con la IA.

Es el puente entre el MVP que definiste (TP 0) y el código que vas a escribir después.

El entregable

Un documento de diseño inicial (una página) con tres secciones + una reflexión individual.

Todo lo relacionado con la IA (prompts y respuestas) va al prompt-log/ desde el primer prompt.

Paso 1 — Prepará el contexto de tu MVP

La IA solo ayuda si le das buen contexto. Antes de pedir nada, tené a mano:

• Qué resuelve tu MVP y quién lo usa (lo del README del TP 0).
• El stack: Kotlin / JVM, consola, sin servicios externos.
• Las restricciones: alcanzable en el cuatrimestre, testeable, sin frameworks pesados.

Si no podés explicar tu MVP en dos frases, cerralo con el profesor antes de seguir.

Paso 3 — Compará las alternativas

No te quedes con la primera respuesta. Poné las opciones lado a lado con criterios claros:

La mejor arquitectura no es la más completa: es la más simple que resuelve tu problema.

Paso 4 — Elegí y justificá

De la comparación sale una arquitectura elegida.

• Marcá cuál elegís y por qué (dos o tres razones).
• Anotá qué opciones descartaste y qué te hizo descartarlas.
• Si la IA propuso algo que no entendés, preguntale hasta entenderlo.

Si no podés defender por qué elegiste esa arquitectura, todavía no la elegiste: la aceptaste.

Sección 1 — Responsabilidades

Listá las piezas de tu MVP y qué hace cada una. Una línea por responsabilidad.

- Entrada:        lee lo que ingresa el usuario
- Validación:     rechaza datos inválidos
- Almacenamiento: guarda y recupera los registros
- Cálculo:        produce totales y estadísticas
- Presentación:   muestra resultados al usuario

Buscá que cada pieza cambie por un solo motivo. Si cambia por dos, probablemente sean dos.

Sección 2 — Historias de usuario mínimas

Describí lo mínimo que el usuario necesita poder hacer. Un formato simple:

Como <tipo de usuario>, quiero <acción>, para <beneficio>.

Ejemplos para una app de gastos:

• Como usuario, quiero registrar un gasto, para llevar la cuenta.
• Como usuario, quiero ver el total, para saber cuánto gasté.
• Como usuario, quiero ver el gasto por categoría, para entender en qué se me va.

Mínimas de verdad: solo lo que el MVP necesita para entregar valor.

Sección 3 — Boceto de arquitectura

Un diagrama caja / flecha de la arquitectura que elegiste. Una caja por responsabilidad, una flecha por dato.

  [entrada] -> [validacion] -> [almacenamiento] -> [calculo] -> [pantalla]
                    |
                    v
                [errores]

Puede ser texto (como este) o una foto de un dibujo a mano. Lo importante es que se entienda el flujo.

Checklist de entrega

Antes de dar por terminada la práctica, verificá:

• [ ] Exploraste 2-3 arquitecturas con la IA y las comparaste.
• [ ] El documento de diseño tiene responsabilidades, historias de usuario y boceto de arquitectura.
• [ ] Entra en una página.
• [ ] Escribiste la reflexión de 5 líneas (individual).
• [ ] Cada prompt y respuesta quedó en prompt-log/, sin secretos.

Dónde va y qué sigue

• El documento de diseño va en tu repo del MVP (por ejemplo DISENO.md, junto al README).
• Los prompts y respuestas, en prompt-log/.
• Pusheá todo a la rama principal.

Próximo paso. Con el diseño cerrado, empezás a construir con IA: prompts de construcción sobre el plan que ya aprobaste.

De la idea al modelo, del modelo al código. Este documento es tu punto de partida.