Instalador de Módulos y Plugins

El sistema ContaPortable incorpora un formulario dedicado para instalar o actualizar módulos y plugins de forma autónoma. Los módulos se entregan como comprimidos .zip y el instalador gestiona automáticamente si es nueva instalación o actualización.

📌 Introducción

Formulario de Instalación de Módulos y Plugins

Desde la sección de Datos Generales del menú del sistema, se accede al formulario de instalación. Este detecta automáticamente si el módulo ya fue instalado previamente para ofrecer las opciones de instalación nueva o actualización. El sistema gestiona los espacios de nombres, directorios y todos los componentes de cada módulo instalado.

Con esta funionalidad se podran instalar nuevos plugin/módulos que seran parte de la estructura de CP, pero a la vez independientes en sus versiones, esto permitia actualizar el modulo unicamente sin tener que modificar todo el sistema.

🎯 Objetivo

Propósito

Permitir la instalación autónoma de módulos y plugins sin activación manual de parámetros.
Detectar instalaciones previas para ofrecer la opción de reinstalación o actualización.
Estandarizar la forma de entrega y despliegue de nuevos módulos mediante comprimidos .zip.
Gestionar el espacio de nombres de cada módulo.

🔍 Alcance

Funciones del instalador

Acceso: menú del sistema → sección Datos Generales → opción Instalar plugin/módulo.
Instalación nueva: instala el módulo desde cero, incluso cuando detecta una instalación anterior.
Actualización: actualiza un módulo ya instalado, detectando la versión existente.
Formato de entrega: comprimidos .zip.

✨ Solución Implementada

Descripción de la solución

Se implementa el formulario de instalación accesible desde el menú principal. El sistema detecta automáticamente el estado de instalación del módulo y presenta las opciones correspondientes.

Espacio de nombres y directorios generados

Ubicación del formulario

La opción de instalación de módulos se encuentra en:

Menú → Datos Generales → Instalar plugin/módulo

🆕 Instalación nueva (desde cero)

Modo instalación nueva

Al seleccionar la instalación nueva, el sistema instala el módulo desde cero. Si detecta una instalación anterior, informa al usuario y permite continuar con la instalación limpia.

🔄 Actualización de módulo existente

Modo actualización

Al seleccionar actualizar, el sistema detecta la instalación existente y aplica los cambios del nuevo compilado .app sobre la versión instalada.

⚙️ Configuración Requerida

Requisitos

Requisito	Descripción
Comprimido `.zip`	Archivo del módulo o plugin proporcionado por el equipo de desarrollo de ContaPortable.
Acceso al menú	El usuario debe tener acceso a la sección Datos Generales del sistema.

🔄 Flujo Funcional

Flujo de instalación de un módulo

1️⃣ Instalación nueva2️⃣ Actualización

Abrir el menú del sistema → Datos Generales → Instalar plugin/módulo.
Seleccionar el compilado .app del módulo a instalar.
Elegir la opción Instalación nueva.
Si el sistema detecta una instalación anterior, confirmar continuar con instalación limpia.
El instalador crea el namespace del módulo mediante NameSpaceForNewModule.
El módulo queda instalado y habilitado automáticamente.

Abrir el menú del sistema → Datos Generales → Instalar plugin/módulo.
Seleccionar el compilado .app con la nueva versión del módulo.
Elegir la opción Actualizar.
El sistema detecta la versión instalada y aplica la actualización.
El módulo queda actualizado manteniendo la configuración existente.

☑️ Validaciones y Pruebas Realizadas 🧪

Compilado validado

Las pruebas se realizaron sobre el compilado EXE_2026_05_19.exe.

Tipos de validaciones y pruebas Realizadas

Proceso de instalación completo

Se confirmó que el proceso de instalación y actualización se realiza correctamente en el compilado EXE_2026_05_19.

Acceso al formulario desde menú Datos Generales: confirmado
Instalación nueva desde cero: exitosa
Detección de instalación anterior: funcional
Actualización de módulo existente: confirmada