# Matriz Sidebar vs Rutas

Fecha de actualización: 2026-03-17
Archivo fuente de menú: `app/Views/partials/sidebar.php`
Archivo fuente de rutas: `app/Config/Routes.php`

## Criterio

- Se consideran "módulos/funcionalidades" las rutas `GET` de pantalla sin parámetros dinámicos.
- En este corte **no se aplican restricciones por rol en el sidebar**.
- La columna "En sidebar" valida visibilidad directa desde el menú lateral.

## Matriz de Cobertura (Módulos de Pantalla)

| Ruta | Controlador::método | En sidebar | Etiqueta en menú | Estado |
|---|---|---|---|---|
| `/mostrador` | `Home::sale` | Sí | Inicio | Cubierto |
| `/cumpleanos` | `Home::birthdays` | Sí | Notificar | Cubierto |
| `/inventario` | `Home::inventory` | Sí | Inventario | Cubierto |
| `/ingresos` | `Home::incomes` | Sí | Ingresos | Cubierto |
| `/gastos` | `Expenses::new` | Sí | Gastos | Cubierto |
| `/reportes` | `Home::reports` | Sí | Reportes | Cubierto |
| `/mis-ventas` | `Home::mySales` | Sí | Mis Ventas | Cubierto |
| `/ventas` | `Home::salesHistory` | Sí | Ventas | Cubierto |
| `/entregas` | `Home::deliver` | Sí | Entregas | Cubierto |
| `/ordenes` | `Order::main` | Sí | Órdenes | Cubierto |
| `/guias` | `Shipment::main` | Sí | Guías | Cubierto |
| `/apartados` | `Home::aside` | Sí | Apartados | Cubierto |
| `/mi-corte` | `CashOut::index` | Sí | Mi Corte | Cubierto |
| `/articulos` | `Home::articles` | Sí | Artículos | Cubierto |
| `/articulos/armazones` | `Frame::main` | Sí | Armazones | Cubierto |
| `/micas` | `Lens::main` | Sí | Micas | Cubierto |
| `/pupilentes` | `Contact::new` | Sí | Pupilentes | Cubierto |
| `/precios` | `ItemPrice::main` | Sí | Precios | Cubierto |
| `/promociones` | `Promotion::main` | Sí | Promociones | Cubierto |
| `/pagos` | `Payment::main` | Sí | Pagos | Cubierto |
| `/facturas` | `Invoice::main` | Sí | Facturas | Cubierto |
| `/commission/settings` | `Commission::settings` | Sí | Comisiones > Configuración | Cubierto |
| `/commission/monthly-review` | `Commission::monthlyReview` | Sí | Comisiones > Corte Mensual | Cubierto |
| `/compras` | `Home::purchases` | Sí | Compras | Cubierto |
| `/garantias` | `Home::warranty` | Sí | Garantías | Cubierto |
| `/pacientes` | `Home::patients` | Sí | Pacientes | Cubierto |
| `/empleados` | `Employee::main` | Sí | Empleados | Cubierto |
| `/usuarios` | `Home::users` | Sí | Usuarios | Cubierto |
| `/perfil` | `Home::profile` | Sí | Perfil | Cubierto |
| `/creditos` | `Home::credits` | Sí | Créditos | Cubierto |
| `/proveedores` | `Home::suppliers` | Sí | Proveedores | Cubierto |
| `/laboratorios` | `Home::labs` | Sí | Laboratorios | Cubierto |
| `/convenios` | `Home::contracts` | Sí | Convenios | Cubierto |
| `/tiendas` | `Home::store` | Sí | Tiendas | Cubierto |
| `/traspasos` | `Home::transfers` | Sí | Traspasos | Cubierto |
| `/lineas` | `Line::main` | Sí | Catálogos > Lineas | Cubierto |
| `/marcas` | `Brand::main` | Sí | Catálogos > Marcas | Cubierto |
| `/colores` | `Color::main` | Sí | Catálogos > Colores | Cubierto |
| `/materiales` | `Material::main` | Sí | Catálogos > Materiales | Cubierto |
| `/rangos` | `Range::main` | Sí | Catálogos > Rangos | Cubierto |
| `/categorias` | `Home::categories` | Sí | Catálogos > Categorías | Cubierto |
| `/tarjetas-pago` | `Home::paymentCards` | Sí | Catálogos > Tarjetas pago | Cubierto |
| `/ocupaciones` | `Home::occupations` | Sí | Catálogos > Ocupaciones | Cubierto |

## Rutas Funcionales Fuera de Sidebar (intencional)

| Ruta | Controlador::método | Razón |
|---|---|---|
| `/commission` | `Commission::index` | Vista auxiliar/legacy de comisiones |
| `/commission/detail` | `Commission::detail` | Detalle operativo de comisiones |
| `/commission/monthly-commissions` | `Commission::getMonthlyCommissions` | Endpoint de soporte para la revisión mensual |
| `/payments` | `Payment::index` | Vista alternativa técnica de pagos |
| `/payments/pending-cash` | `Payment::pendingCash` | Flujo específico de depósito de efectivo |
| `/invoice/from-payments` | `Invoice::showFromPayments` | Flujo secundario de facturación |
| `/pin` | `Pin::main` | Flujo utilitario de autenticación por PIN |

## Nota de mantenimiento

Cuando se agregue un nuevo módulo con ruta `GET` de pantalla, actualizar esta matriz y validar si debe exponerse en sidebar o dejarse como ruta operativa.