0014. Navegación por empresa con árbol y arrastrar y soltar¶
Estado: Aceptado
Fecha: 2026-11-04
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): dominio navegación
Evidencia: commits deb5a89 (2026-11-04, alta y edición) y de3c73c (2026-11-04, ajuste del arrastrar y soltar) y vue-draggable-plus
Contexto¶
La navegación se administra por empresa: cada tenant arma sus módulos y menús sobre un catálogo global de aplicaciones. El orden de los nodos es visible para el usuario final del tenant y el árbol tiene como máximo tres niveles (aplicación → módulo → menú). Reordenar por pares generaba varias escrituras por movimiento y estados intermedios inconsistentes.
Decisión¶
cat_aplicaciones es global; módulos, menús y acciones llevan empresa_id
obligatorio por query. El árbol se edita con VueDraggable y grupo compartido, y
cada drop persiste la lista completa y ordenada de ids en
POST /navegacion/admin/modulos/reordenar o
POST /navegacion/admin/menu/reordenar (con padre_id y recálculo de nivel);
después se recarga el árbol. El contrato es explícito: "ids is the complete,
ordered list".
Alternativas descartadas¶
- Reordenar por pares o por índice incremental — cada movimiento requiere varias llamadas y deja el árbol en estados intermedios si una falla.
Consecuencias¶
El servidor recibe el estado final y puede validarlo de una vez, lo que hace el movimiento predecible. El costo es un payload con todos los ids y una recarga completa del árbol en cada arrastre.
Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).