Saltar a contenido

0010. Navegación fija con barra inferior, no dirigida por el backend

Estado: Propuesto Fecha: 2026-11-02 Autor: David Garcia Módulo(s) afectado(s): app/router/, app/shell/, modules/*/routes.dart, pages/mi_ruta/

Contexto

La web dibuja su navegación desde identidad (GET /dashboard y el menú de cada módulo, ADR 0009 del frontend), porque es un ERP con muchas aplicaciones y módulos que cambian por empresa y permisos. La app tiene un solo usuario objetivo, el promotor, y un puñado de pantallas que usa con una mano entre tienda y tienda. Quién entra ya lo decide el alcance (ADR 0007).

Decisión

  • Rutas fijas en la app con go_router. No se lee GET /dashboard: el árbol de identidad describe los módulos de la web.
  • Barra inferior con cuatro pestañas (StatefulShellRoute, cada una conserva su pila): Mi ruta (inicio), Agenda, Clientes y Pedidos. Los requerimientos se ven dentro de la visita y en Mi ruta.
  • Mi ruta es una composición de pages/mi_ruta/: la visita en curso arriba, las del día por hacer y los requerimientos pendientes. Usa la API pública de visitas, pedidos y requerimientos, nunca sus archivos.
  • Cada módulo declara sus rutas en routes.dart; app/router/ las ensambla. El detalle de un registro va por id en la ruta (/agenda/visitas/:id), así una pantalla se puede abrir de nuevo sin depender de lo que había en memoria.
  • Guard único en el redirect del router: sin sesión → /login; con sesión sin la puerta del promotor resuelta → pantalla de verificación (ADR 0007). Escucha el stream de sesión (ADR 0008), así un refresh rechazado lleva al login desde cualquier pantalla.
  • Sin enlaces profundos externos por ahora.

Alternativas descartadas

  • Navegación dirigida por el backend, como la web — habría que dar de alta en identidad entradas que sólo existen en el teléfono, y cada pantalla nueva igual exige publicar la app.
  • Menú lateral (drawer) — esconde lo que el promotor usa cada minuto y se alcanza peor con una mano.
  • Navigator imperativo sin go_router — sin guard central ni rutas por id.

Consecuencias

  • Una pantalla nueva es un cambio de la app, no de configuración en identidad.
  • Cuando existan permisos de fuerza de ventas en el token, se ocultan acciones por permiso dentro de las pantallas; la barra sigue fija.
  • Un supervisor ve en las pestañas lo propio; ver a sus supervisados es otra decisión.

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.