# Mapa de pantallas de la app actual

> Relevado el 2026-11-11 navegando https://proyecto-iberofarmacos.vercel.app con sesión de administrador.
> Solo se **visitaron** pantallas, sin pulsar botones ni guardar nada.
> Las **98 funciones RPC** que llama el frontend existen en la copia local `supabase_copia` (114 en `core`, 4 en `public`; el cliente usa `.schema('core')`). Su código está en `supabase_clone\out\funciones\`.

## Tecnología del frontend actual
- **Next.js** (App Router, Turbopack) desplegado en Vercel, con cliente Supabase (`supabase-js`) en el navegador.
- Al cargar cualquier pantalla se llama a `get_current_app_context`, que devuelve el usuario, el rol, los permisos y el alcance.
- La mayoría de pantallas llama a `get_effective_sales_scope_v1`, que define qué zonas, vendedores o clientes puede ver el usuario.
- Rutas API propias de Next (código **no** visible, corre en el servidor de Vercel):
  - `/api/dashboard-update-status`: estado de "Última actualización".
  - `/api/admin/users` y `/api/admin/users/reset-password`: alta de usuarios en Supabase Auth.
  - `/api/broadcast` y `/api/client-log`.

## Menú y pantallas

### Menú principal
| Menú | Ruta | Funciones que carga |
|---|---|---|
| Vista Ejecutiva | `/executive` | `get_dashboard_executive`, `get_dashboard_executive_anual`, `get_dashboard_pedidos_kpi`, `get_dashboard_producto_scope_facturacion_v1` |
| Devoluciones | `/devoluciones` | `get_dashboard_devoluciones_executive`, `get_dashboard_devoluciones_anual` |
| Resumen de Ventas | `/ventas-desglosadas` | `get_dashboard_ventas_desglosadas`, `get_dashboard_producto_scope`, `get_dashboard_devoluciones_kpi`, tabla `dim_calendario_no_laboral` |
| Vista Comparativa | `/comparativa` | `get_dashboard_producto_scope_facturacion_v1` (+ `get_dashboard_comparativa` en el código) |
| Análisis → Productos | `/productos` | `get_dashboard_productos_analisis_v7`, `get_dashboard_productos_evolucion_anual_v1` (+ `_busqueda_analisis_v6`, `_detalle_v2` en el código) |
| Análisis → Clientes | `/analisis-clientes` | `get_dashboard_clientes_catalogos_v1`, `get_dashboard_clientes_analisis_v1` |
| Ventas vs Presupuesto → Vendedores | `/presupuesto/vendedores` | `get_dashboard_ventas_cumplimiento_v2` (+ `_ciudades_v2`) |
| Ventas vs Presupuesto → Visitadores | `/presupuesto/visitadores` | `get_dashboard_visitadores_nucleo_v1` (+ `get_dashboard_visitadores_*`: cadenas, ciudades, detalle, devoluciones 70/30, estimación pendiente) |
| Ventas Diarias | `/diarias` | `get_dashboard_diarias_v2` |
| Comisiones → Visitadores | `/comisiones` | `get_dashboard_comisiones_nucleo_v1` |
| Comisiones → Vendedores | `/comisiones-vendedores` | `get_dashboard_comisiones_v7` (+ `get_comisiones_vendedores_por_tipo_v1`, `get_dashboard_comisiones_front_v6`) |

### Administración
| Menú | Ruta | Lecturas | Acciones (escritura, según el código) |
|---|---|---|---|
| Usuarios | `/admin/usuarios` | tablas `app_profiles`, `app_user_visitador`, `app_visitador_jerarquia`, `app_role_permissions`; `get_visitadores_catalogo_admin`, `get_admin_accesos_v1`, `get_admin_user_dashboard_overrides_v1` | `set_usuario_rol_v1`, `set_usuario_dashboard_v1`, `restablecer_usuario_dashboard_v1`, `guardar/desactivar_usuario_alcance_v1`, `guardar/desactivar_usuario_vendedor_producto_v1`, `/api/admin/users*` |
| Config. Clientes | `/admin/clientes` | `get_admin_clientes_config_v1`, `get_admin_clientes_maestro_v1`, `get_admin_cliente_detalle_v1` | `guardar_cliente_config_v1`, `importar_clientes_config_v1`, `guardar/desactivar_cliente_responsable_v1`, `sustituir_vendedor_v1`, `sustituir_vendedor_clientes_v1` |
| Config. Productos | `/admin_productos` | (carga productos) | — |
| Presupuesto y Comisiones | `/admin/presupuesto` | `get_productos_sin_presupuesto_aviso_v1`, `get_config_presupuesto_unificada_v1`, `get_distribucion_tipo_producto_unificada_v1`, `get_grafica_presupuesto_asignado_v1`, `get_presupuesto_admin_*`, `get_presupuesto_vendedor*` | `generar_presupuesto_propuesta`, `generar_presupuesto_vendedores_v3`, `guardar_presupuesto_vendedor_*` (catálogo, comisión, exclusión, pesos, pesos zona, producto pesos), `actualizar/restaurar_presupuesto_detalle`, `aplicar_ajuste_presupuesto`, `clonar_presupuesto_version`, `publicar_presupuesto_version_parcial`, `validar_*`, `importar_presupuesto_fiel_v1`, `recalcular_presupuesto_configuracion_v1`, `renombrar_presupuesto_version_v3_5_2`, `admin_cargar_cobros_vendedores_v1`, `get_facturadores_sin_mapeo_v1` |
| Feriados | `/admin/feriados` | `get_admin_feriados_v1` | `guardar_feriado_v1`, `eliminar_feriado_v1` |
| Control Procesamiento | `/procesamiento` | — | — |
| Config. Sucursales | `/admin_sucursales` | — | — |
| (visitadores: rutas y asignaciones) | dentro de Presupuesto/Visitadores | `vis_get_catalogo_admin_v1`, `vis_get_pendientes_v1`, `vis_get_rutas_admin_v1` | `vis_guardar_asignacion_v1`, `vis_anular_asignacion_v1`, `vis_asignar_ciudad_v1`, `vis_guardar_ruta_v1`, `vis_dar_baja_ruta_v1`, `vis_reactivar_ruta_v1`, `vis_quitar_ciudad_ruta_v1`, `vis_dar_baja_v1`, `vis_importar_listado_v1`, `vis_renombrar_equipo_v1` |

Otras rutas: `/login`, `/recovery` (recuperar clave), `/unauthorized`, `/diagnostico` (salud de Supabase). `/customer`, `/products`, `/iceberg` y `/vector` son rutas viejas o redirecciones sin contenido propio.

## Filtros comunes (vistos en Resumen de Ventas / Vista Ejecutiva)
Rango de fechas, Zona, Provincia, Línea médica, Grupo producto, Producto, Cadena; modo **Facturación / Ventas desglosadas**; moneda **RD$ / Unidades**; botón **Actualizar**; indicador "Última actualización".

## Implicación para Laravel
- Cada pantalla puede empezar llamando a la **misma función** en `supabase_copia` (`select * from core.get_dashboard_xxx(...)`) desde un controlador Laravel, y después ir reemplazándola por consultas propias si conviene.
- Las funciones usan `auth.uid()` para saber el usuario. En Laravel habrá que pasar el usuario o su alcance como parámetro, o reescribir esa parte.
- El copiado del código de los chunks del frontend está en el scratchpad de la sesión (temporal). Si hace falta, se vuelve a descargar.
