Saltar a contenido

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).