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 (
422si cruza empresas).empresayaplicacionsó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,codigoy auditoría), y los códigos se reconstruyen concodigos.py(ADR 0058). Un test falla si un modelo copiado gana una clave foránea que no figura enREGLAS. - Mover reutiliza
reordenar_menus(nivel, ciclo, tope de 3 niveles, cascada de códigos); mover un módulo cambia suaplicacion_idy 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_runo con conflictos (nivel > 3, código que no fusiona, destino ajeno o inexistente, aplicación inexistente) no se escribe nada: sindry_runlos conflictos responden409. Sin conflictos se aplica todo en un únicocommit.
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_runy la aplicación leen el mismo estado; entre ambos pasos puede haber cambios concurrentes, y en tal caso la aplicación responde409.
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.