Auditoría — menú de la aplicación vs manual Docusaurus
Este documento resume la relación entre el código del menú del usuario empresa y la documentación en documentacion/docs/, sin modificar el plan de producto.
Fuentes de verdad
| Fuente | Ubicación | Alcance |
|---|---|---|
| Menú renderizado | admin/src/views/componentes/Menu_sidebar.js | Usuario empresa (tipo != 'SUPER USUARIO'): ítems visibles antes del filtrado por permisos/plan. |
| Sidebar del manual | documentacion/sidebars.js | Entradas publicadas bajo docs/ (id sin extensión .md). |
| Cobertura pantalla a pantalla | Verificación de cobertura | Tabla menú ↔ archivo .md. |
Resultado del cruce (usuario empresa)
- Coincidencia: los ítems del menú estándar (no superusuario) tienen entrada en
sidebars.jsy fila en verificación de cobertura. Total documentado en verificación: 109 pantallas de menú. - Ítem comentado en HTML del menú: Tesorería → Bóveda (
control_ingreso_egreso) no se documenta a propósito (no visible para el usuario). - Menú condicional: Soporte al Cliente aparece solo si
usuario.fl_soporte_cliente == 1. No hay página dedicada en el manual Docusaurus; la acción suele abrir un flujo externo o modal. Si se documenta en el futuro, añadirpaqueteria/soporte-cliente.mdy una fila en verificación.
SUPER USUARIO (fuera del manual paquetería)
Los ítems solo para SUPER USUARIO (Membresías, Estado membresías, Administrativo, Envíos automáticos, Usuarios globales, Configuración restringida, Programación de activación, etc.) no están en el sidebar manualSidebar de paquetería. Eso es intencional: este sitio está orientado al usuario final de la empresa.
Duplicados o matices en Venta pasaje
En el menú existen dos entradas de ruta relacionadas con “configuración ruta” (vp_configuracion_ruta y configuracion_ruta). El manual las separa en:
Mantener ambas páginas evita confusiones si el operador sigue el texto literal del menú.
Facturación: “Nuevo comprobante”
La ruta de la app #/facturacion/nuevo_comprobante se documenta en Cómo emitir una factura (unifica creación y edición en la explicación de usuario).
Permisos y plan
El menú completo se recorta en el navegador según permisos / plan_permiso. El manual lista capacidades; lo que cada usuario ve debe validarse en su entorno real.
Mantenimiento
Tras agregar un ítem en Menu_sidebar.js:
- Añadir o actualizar el
.mdendocs/paqueteria/.... - Registrar la fila en verificación de cobertura (o regenerar con el script indicado al pie de ese archivo).
- Añadir el id del doc en
documentacion/sidebars.js.
Véase también la Guía de estudio para el orden pedagógico frente al orden alfabético del menú.