Saltar a contenido

0059. Copiar y mover navegación, y habilitación automática de aplicaciones

Estado: Aceptado Fecha: 2026-11-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/navegacion/, tests/unit/navegacion/, docs/adr/

Contexto

Configurar la navegación de una empresa nueva obliga a recrear a mano módulos, menús y acciones que otra empresa ya tiene. Además, crear_modulo nunca aseguraba la fila de rel_empresa_aplicacion: un módulo podía quedar en una aplicación que la empresa no tenía habilitada (y por eso sin efecto en los permisos, que filtran por aplicaciones habilitadas). La plantilla base (plantilla.py, ADR 0034) no sirve para esto: es un catálogo fijo en código, no refleja lo que una empresa ajustó.

Decisión

Habilitación automática. asegurar_aplicacion_habilitada(empresa, aplicación, actor?) garantiza una relación activa: si ya está activa no hace nada; si está pausada la reactiva; si falta, la inserta (las filas borradas son historial y no se reactivan; ver ADR 0060, que reemplazó el único total por uno parcial). No confirma: se llama dentro de la transacción de crear_modulo, de actualizar_modulo cuando cambia la aplicación o la empresa, y de copiar/mover.

Endpoint único POST /api/v1/navegacion/admin/copiar (guard administrativo, pool BYPASSRLS, empresa_id explícito en cada consulta). Cuerpo: modo (copiar|mover), origen (empresa|aplicacion|modulo|menu con su empresa_id e id), destinos[] (empresa_id, y según el caso aplicacion_id, modulo_id, padre_id) y dry_run. Responde un plan por destino con filas {tipo, codigo, nombre, resultado, detalle?} y totales; resultado es crear, existe, reactivar, habilitar_aplicacion, mover o conflicto.

  • Copiar admite varios destinos; mover exactamente uno y sólo dentro de la misma empresa (422 si cruza empresas). empresa y aplicacion sólo se copian.
  • Fusión por código. En el destino se busca por (ámbito, código): lo activo se conserva intacto (y se desciende a sus hijos), lo borrado lógicamente se reactiva con los valores copiados y lo que falta se crea. Nunca se pisan filas activas. Las nuevas se agregan al final de sus hermanos conservando el orden relativo del origen.
  • Copiador genérico (copiador.py): recorre el origen en la base e introspecciona las columnas del mapper; copia todo salvo un conjunto explícito (id, empresa_id, claves foráneas estructurales, nivel, orden, codigo y auditoría), y los códigos se reconstruyen con codigos.py (ADR 0058). Un test falla si un modelo copiado gana una clave foránea que no figura en REGLAS.
  • Mover reutiliza reordenar_menus (nivel, ciclo, tope de 3 niveles, cascada de códigos); mover un módulo cambia su aplicacion_id y exige que su código esté libre en la aplicación destino (activo o borrado).
  • Transacción. Siempre se planifica primero sin escribir. Con dry_run o con conflictos (nivel > 3, código que no fusiona, destino ajeno o inexistente, aplicación inexistente) no se escribe nada: sin dry_run los conflictos responden 409. Sin conflictos se aplica todo en un único commit.

Alternativas descartadas

  • Reutilizar la plantilla base — es estática y no refleja la configuración real de una empresa; el usuario la descartó explícitamente.
  • Sobrescribir lo existente — destruiría ajustes de la empresa destino; la fusión es aditiva.
  • Un endpoint por origen — repetiría validación, fusión y plan.

Consecuencias

  • Un módulo creado o movido a una aplicación la deja habilitada en esa empresa.
  • Una columna nueva de dominio en módulos, menús o acciones se copia sola; una clave foránea nueva obliga a declarar su tratamiento antes de que pasen los tests.
  • El plan de dry_run y la aplicación leen el mismo estado; entre ambos pasos puede haber cambios concurrentes, y en tal caso la aplicación responde 409.

Qué no cubre

  • No copia permisos (rel_usuario_accion): son concesiones a usuarios de la empresa de origen y no tienen sentido en otra.
  • No copia variables del sistema ni catálogos por empresa.