Mapas de sitio (Wave 3 UX)
Este documento agrupa los tres mapas de sitio que cubren los tres canales
operativos de ExpressMX: panel administrativo web (apps/web), aplicacion
movil del cliente (apps/mobile-client) y aplicacion movil del prestador
(apps/mobile-provider). Cada mapa se entrega como un archivo PlantUML
independiente para facilitar el render y la insercion en el documento
final formato carta retrato.
Ultima actualizacion: 2026-05-05
1. Panel administrativo web
Archivo: ux-sitemap-web.puml
El panel se organiza en torno a siete espacios de trabajo (workspaces)
persona-based segun la doctrina ServiceNow descrita en
feedback_agent_workspaces.md. Cada workspace integra un menu de
contexto, una bandeja de trabajo (work queue) y la vista detalle de cada
entidad. El sitemap distingue rutas legado (/dashboard/ordenes,
/dashboard/tickets) de rutas nuevas vinculadas al workspace
(/dashboard/operaciones/orden/[id], /dashboard/soporte/ticket/[id]).
| Workspace | Ruta raiz | Vistas indexadas |
|---|---|---|
| Operaciones | /dashboard/operaciones |
9 |
| Finanzas | /dashboard/finanzas |
11 |
| Soporte | /dashboard/soporte |
12 |
| Marketing | /dashboard/marketing |
7 |
| RRHH | /dashboard/rrhh |
8 |
| Compliance | /dashboard/compliance |
4 |
| Identidad y sistema | /dashboard/equipo, /dashboard/roles, /dashboard/sistema |
7 |
| Personal y autenticacion | /login, /dashboard, /dashboard/mi, /dashboard/cuenta, recuperacion |
7 |
| Total verificado | - | 65 |
Cada nodo del mapa cita la ruta exacta que sirve la pagina en
Next.js App Router. Las anotaciones [rol: X] indican el rol RBAC
exigido por la matriz roles_admin -> permisos. El mapa cubre los
22 grupos de vistas administrativas exigidos por la guia y excede el
umbral de 50 rutas verificables.
2. Aplicacion movil del cliente
Archivo: ux-sitemap-mobile-cliente.puml
La app del cliente esta construida sobre Expo Router con dos grupos
((auth), (tabs)) y rutas de stack para los flujos transaccionales
(detalle de servicio, solicitud, tracking, pago, calificacion). El
arbol arranca en index.tsx que decide la redireccion segun la sesion.
Conteo total: 17 pantallas (rutas principales, sin layouts privados).
| Cluster | Pantallas |
|---|---|
| Splash | 1 (index.tsx) |
| Autenticacion | 3 (login, register, forgot-password) |
| Pestanas principales | 4 (home, services, orders, profile) |
| Flujo transaccional de servicio | 5 (service-detail, service-request, order-tracking, payment, order-rating) |
| Cuenta y secundarias | 4 (profile-edit, addresses, notifications, support) |
Total: 17 rutas verificables. Las sub-rutas addresses/new y
addresses/edit aparecen como L4 en el mindmap pero pertenecen al
mismo cluster addresses. No se contabilizan layouts privados
(_layout.tsx, _form.tsx).
3. Aplicacion movil del prestador
Archivo: ux-sitemap-mobile-prestador.puml
La app del prestador comparte la estructura general con la del cliente,
pero introduce el cluster job-active con cuatro sub-pantallas modales
(PIN cliente, PIN prestador, evidencias, sobrecosto) que materializan el
checklist operativo en sitio.
Conteo total: 15 pantallas principales (sin contar modales del cluster
job-active ni sub-rutas de provider-services, provider-availability
y support, que aparecen como L4 en el mindmap).
| Cluster | Pantallas |
|---|---|
| Splash | 1 (index.tsx) |
| Autenticacion | 2 (login, register) |
| Pestanas principales | 4 (home, jobs, earnings, profile) |
| Ciclo de trabajo | 2 (job-detail, job-active) + 4 modales |
| Catalogo y disponibilidad | 3 (provider-services, provider-availability, reviews) |
| Cuenta y soporte | 3 (profile-edit, notifications, support) |
Total: 15 rutas principales. Las sub-pantallas pin-cliente,
pin-prestador, evidencias y sobrecosto se modelan como modales
del cluster job-active y se documentan en el sitemap pero no
incrementan el conteo de rutas raiz.
Convenciones aplicadas
- PlantUML mindmap para todos los sitemaps por su legibilidad jerarquica.
- Estilo monocromo academico de
_style.iuml. - Cada nodo cita el archivo
.tsxo ruta Next.js que lo materializa. - Sin emojis ni iconografia decorativa.
- Letter portrait: la profundidad maxima es 4 niveles para evitar overflow.