Antes de empezar. Ya has implementado búsquedas y paginación en Servidor. Hoy comprobarás sus límites y revisarás cómo se utilizan desde fuera del backend.
Se explica
25 minutos · explicación y demostración
En Servidor ya has trabajado búsquedas y paginación. Intermodular comprueba cómo se revisa ese cambio y si otra persona puede utilizarlo sin conocer su implementación. Una página de resultados necesita un orden estable y una interpretación clara de sus límites.
El resultado de una revisión debe relacionar necesidad, comportamiento observado y decisión. Comprobar solo que la respuesta es 200 no demuestra que el filtro seleccione bien ni que al cambiar de página no desaparezcan o se repitan elementos.
Se trabaja
140 minutos · trabajo guiado
Bloque A · Recuperar el cambio
Localiza las rutas de consulta trabajadas en Servidor y la versión que las contiene. Ejecuta una consulta sin filtro y otra con un filtro conocido. Compara la respuesta con la necesidad descrita en la issue y señala los parámetros disponibles.
Bloque B · Preparar datos reconocibles
Crea suficientes datos ficticios para obtener al menos tres páginas. Incluye valores repetidos en el campo principal de ordenación y un criterio que no tenga coincidencias. Anota qué elementos esperas en cada consulta antes de ejecutarla.
Bloque C · Comprobar los límites
Ejecuta primera página, última página, página sin resultados y tamaño no válido. Compara resultados, orden y respuesta de error. Repite la misma consulta y verifica que su orden sea estable. Si un caso falla, describe entrada, resultado real y resultado esperado en una issue.
Bloque D · Revisar la comprensión del contrato
Intercambia la colección con tu pareja. Pídele que localice un dato mediante filtro y explique cómo obtiene la página siguiente. Revisa qué información de la respuesta necesita un futuro cliente para mostrar resultados y navegación.
Bloque E · Cerrar la revisión
Corrige las instrucciones o ejemplos ambiguos, revisa los cambios por PR y comprueba el resultado de CI. Conserva las rutas actuales: la transición a rutas versionadas se trabajará después en Servidor y se revisará en el siguiente taller.
Cierre
15 minutos · comprobación del resultado
Al terminar la sesión: las búsquedas y la paginación tienen casos de prueba reproducibles, los límites están comprobados y los defectos encontrados están descritos con precisión. Debes poder explicar qué necesita saber quien consuma esas consultas.