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 leeGET /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 devisitas,pedidosyrequerimientos, 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
redirectdel 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.
Navigatorimperativo singo_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.