Saltar a contenido

0009. Tests: unidad y widgets con el borde HTTP simulado, sin servicios reales

Estado: Propuesto Fecha: 2026-11-02 Autor: David Garcia Módulo(s) afectado(s): test/, integration_test/, core/network/

Contexto

Lo de más riesgo en la app es la renovación de sesión con peticiones simultáneas (ADR 0008), la puerta del promotor (ADR 0007), el guard del router (ADR 0010), las reglas de la ejecución de visitas (ADR 0011) y los decimales de los pedidos (ADR 0013). Los servicios cambian y no se pueden levantar en cada corrida. La web simula sólo el borde HTTP y deja reales queries, stores y componentes (ADR 0011 del frontend).

Decisión

  • Dos niveles con flutter_test:
Nivel Qué prueba Dónde
Unidad Validación del entorno, renovación de sesión, errores, repositorios, modelos y decimales test/ replicando lib/
Widgets Pantallas con sus providers y el router reales test/ replicando lib/
  • Se simula sólo el borde HTTP: un HttpClientAdapter falso para Dio que responde como FastAPI ({"detail"}, 401, 409, 422) y registra lo recibido. Repositorios, providers y router son los reales.
  • Fakes escritos a mano, sin librería de mocks: TokenStorage en memoria y Env fijo inyectados con overrides de ProviderScope.
  • Respuestas de ejemplo tomadas del contrato (test/fixtures/), con los DTO generados (ADR 0006): un cambio del contrato rompe el test.
  • Buscar por texto visible y semántica (find.text, find.bySemanticsLabel), no por Key, salvo en widgets auxiliares.
  • E2E con integration_test cuando haya flujos completos (login → Mi día → check-in → pedido), en emulador y con el mismo adaptador falso: nunca contra servicios reales.
  • Antes de cada PR: dart format --set-exit-if-changed, flutter analyze y flutter test.

Alternativas descartadas

  • mocktail o mockito — simular cada repositorio prueba el mock, no la app; los fakes de borde alcanzan.
  • Tests contra los servicios levantados — lentos, frágiles y dependen de datos que cambian.
  • Golden tests desde ya — se rompen con cada ajuste visual mientras el diseño no está fijo.

Consecuencias

  • Las respuestas de ejemplo se actualizan a mano cuando cambia el contrato, como el backend simulado de la web.
  • La geolocalización y el almacenamiento seguro se prueban detrás de su interfaz; lo nativo queda para los E2E en emulador.

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.