[Informe de clase] Desarrollo de Sistemas (3.º año), Semana 53
Ajustes finales y preparación para la presentación: convertir la finalización en algo que comunique
En la Semana 53, la clase entró en la fase final de pulido del proyecto.
El alumnado trabajó en la corrección de errores, mejoras de la UI y actualizaciones de la documentación, centrándose en dar forma al proyecto para que comunique con claridad en la presentación final.
El tema clave de esta semana fue:
De “funciona” a “comunica”.
■ Introducción del profesor: “La calidad se decide desde la perspectiva del usuario”
Sr. Tanaka: “Lo importante no es si el desarrollador lo entiende,
sino si alguien que lo usa por primera vez puede utilizarlo sin problemas.
Hoy revisaremos sus sistemas desde ese punto de vista.”
El profesor presentó los siguientes puntos de revisión:
- ¿Una persona que lo usa por primera vez puede manejarlo sin confundirse?
- ¿Las personas usuarias sabrán qué hacer cuando ocurra un error?
- ¿La visualización es clara y fácil de entender?
- ¿El comportamiento de la IA es apropiado?
■ Objetivos de hoy
- Hacer que los principales casos de uso funcionen de forma fiable
- Mejorar la UI para que sea más fácil de entender
- Completar el README y los materiales de presentación
- Crear el flujo para la demo de la presentación
■ Ejercicio práctico 1: Corrección de errores y estabilización
Primero, el alumnado corrigió los problemas encontrados durante las pruebas de integración.
Errores comunes
- Incoherencia en las claves de respuesta de la API
- Salida de la IA que excedía el límite de caracteres
- Fallos provocados por entradas no válidas
- El procesamiento de fallback no funcionaba
Lo que hicieron
- Reforzaron la validación
- Añadieron manejo de excepciones
- Identificaron las causas mediante logs
Estudiante A: “¡Cada vez se me da mejor arreglar cosas mientras reviso los logs!”
■ Ejercicio práctico 2: Mejoras de la UI desde la perspectiva del usuario
Después, el alumnado revisó a fondo la UI.
Puntos de mejora
- Hacer más claros los pasos de operación
- Mejorar la claridad de botones y campos de entrada
- Mejorar los mensajes de error
- Añadir explicaciones para la salida generada por la IA
Ejemplo:
*Este texto fue generado por IA.*
Estudiante B: “Solo con añadir explicaciones, se vuelve mucho más fácil de usar.”
■ Ejercicio práctico 3: Actualizaciones finales de la documentación
El alumnado completó el README y los documentos de diseño.
Contenido incluido
- Visión general del sistema
- Descripción de funciones
- Cómo usarlo (paso a paso)
- Qué hacer cuando ocurren errores
- Explicación de las APIs y la IA utilizadas
- Puntos clave del diseño de seguridad
Estudiante C: “Es difícil escribir pensando en que otra persona lo va a leer.”
■ Ejercicio práctico 4: Diseño de la estructura de la demo para la presentación
Cada equipo planificó el flujo de su presentación final.
Estructura común de la presentación
- Visión general del sistema
- Explicación del caso de uso
- Demo (escenario normal)
- Manejo de errores y fallback
- Ideas principales y puntos destacados del diseño (IA y arquitectura)
Profesor: “Lo importante en una demo no es solo que salga bien,
sino que su intención se transmita con claridad.”**
■ Ejercicio práctico 5: Ensayo (presentación simulada)
Cada equipo practicó una presentación breve.
Comentarios que recibieron
- La explicación dependía demasiado de terminología técnica
- El flujo de la demo era difícil de seguir
- La explicación sobre la IA no era suficiente
- La explicación del manejo de errores era sólida
Estudiante D: “Cuando realmente lo explico en voz alta, noto en qué partes mi comprensión sigue siendo débil.”
■ Lo que toda la clase comprendió
- La calidad cambia según cómo la comuniques
- La UI y la explicación deben trabajar juntas
- El manejo de errores es algo que se evaluará en la presentación
- Las funciones de IA no se transmiten a menos que se expliquen claramente
■ Comentario final del profesor
“Todas y todos ustedes han adquirido
la capacidad de construir sistemas.
Lo que necesitan ahora es
la capacidad de comunicarlos a otras personas.
Una presentación no es la meta en sí.
Es una oportunidad para poner en palabras su pensamiento de diseño.”
■ Tarea (antes de la presentación final)
- Crear las diapositivas de la presentación
- Hacer una comprobación final del procedimiento de la demo
- Pensar en tres posibles preguntas que podrían hacerles
■ Avance de la próxima semana: Día de la presentación final
La próxima semana será por fin
el Día de la Presentación Final.
El alumnado presentará un sistema completo que reúne
todo lo que ha aprendido durante los últimos tres años,
y la clase compartirá los resultados en conjunto.
La Semana 53 fue una clase importante no solo para terminar el sistema,
sino para darle forma como algo que comunique con claridad.
El alumnado está puliendo tanto sus habilidades técnicas como su capacidad para expresar sus ideas
mientras se prepara para la presentación final.