Consola de Scripts de Reparación

Descripción, Propósito y Objetivo

NOTE

La Consola de Scripts es una herramienta de mantenimiento y soporte de nivel avanzado dentro del ERP, diseñada para la ejecución controlada de rutinas y comandos programados que operan directamente sobre las bases de datos de la organización en tiempo real.

Un Script de Reparación (o Script de Mantenimiento) es una rutina de código previamente compilada y testeada que realiza tareas de corrección masiva de datos, reestructuración de índices, recálculo de acumulados históricos o activación forzada de servicios que no pueden realizarse a través de las interfaces de usuario estándar.

El objetivo de esta vista es proveer al equipo de soporte de desarrollo y superadministradores una consola unificada para realizar reparaciones y despliegues técnicos inmediatos sin necesidad de realizar paradas de servicio ni actualizaciones de la aplicación.

---

Contexto de Uso

Este panel de control avanzado está restringido exclusivamente a ingenieros de soporte técnico sénior y superadministradores para:

• Corregir inconsistencias masivas: Reparar registros dañados o huérfanos generados por fallas fortuitas de red.
• Recalcular reportes: Forzar el recálculo manual de métricas en eventos históricos de calidad.
• Actualizaciones en caliente: Ejecutar parches de base de datos directamente desde el frontend web de administración de forma segura.

---

Acciones Posibles

1. Seleccionar un Script de la Galería

El sistema cuenta con un catálogo de scripts predefinidos.

1. Haga clic en el campo Script.

2. Escriba palabras clave del script que desea ejecutar o consulte la lista autocompletable.

3. Seleccione el script requerido.

2. Ejecutar Script de Mantenimiento

Una vez seleccionado el script:

1. Haga clic en el botón "Ejecutar".

2. El botón cambiará a un indicador de carga circular (loading spinner) mientras la rutina de código se ejecuta en el servidor de base de datos.
3. Al finalizar, el sistema desplegará un mensaje emergente de notificación confirmando el éxito de la operación o detallando los registros modificados.

CAUTION

La ejecución de scripts de base de datos en caliente es una operación de alto riesgo. Asegúrese de realizar una copia de seguridad (backup) y de haber validado el script en entornos de pruebas antes de proceder con su ejecución en producción.

---

Roles y Permisos Requeridos

Para acceder e interactuar con este módulo de administración avanzada, el usuario debe contar con un rol de Soporte TI o Superadministrador y tener activos los siguientes permisos específicos:

• Acceso y visualización: data_migration_read (para consolas de reestructuración general) o migrate_lab_new_model_read (para actualización de laboratorios a v2).
• Operaciones de escritura y ejecución: data_migration_create / data_migration_update o migrate_lab_new_model_create / migrate_lab_new_model_update que permiten lanzar los scripts sobre la base de datos de producción.