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
HttpClientAdapterfalso paraDioque 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:
TokenStorageen memoria yEnvfijo inyectados con overrides deProviderScope. - 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 porKey, salvo en widgets auxiliares. - E2E con
integration_testcuando 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 analyzeyflutter test.
Alternativas descartadas¶
mocktailomockito— 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.