🚀 CLI de Generación de Aplicaciones y Componentes SEV (create-sev-app)

Esta herramienta de línea de comandos (CLI) permite generar proyectos base limpios con Ionic y Angular, así como inyectar páginas y componentes UI estandarizados institucionales (Tablas Dinámicas, Formularios, Login, Menús) en cualquier proyecto de la SEV.

🛠 Instalación y Uso

Te recomendamos instalar el CLI de forma global en tu computadora para que puedas usarlo en cualquier momento y en cualquier carpeta de manera rápida.

npm install -g create-sev-app

Dependiendo de dónde ejecutes el comando, el CLI se comportará de forma diferente:

1. Crear un proyecto nuevo desde cero

Si ejecutas el comando en una carpeta vacía (o donde no hay un proyecto de Angular/Ionic):

create-sev-app

El asistente interactivo te guiará para crear la aplicación:

1. Nombre del proyecto: (ej. mi-nuevo-sistema).
2. Tipo de Logueo: Selecciona qué estilo de login necesitas (Estándar, MSEV, Dual o Ninguno).
3. Menú Lateral: Estructura de sev-menu.
4. Notificaciones institucionales: Configuración de SevToastService y SevAlertService.

El CLI ejecutará ionic start, inyectará la plantilla base SEV, configurará las rutas y levantará tu aplicación en el navegador automáticamente.

2. Trabajar dentro de un proyecto existente

Si ejecutas el comando dentro de la carpeta de un proyecto Angular/Ionic ya existente (donde existe un archivo angular.json o ionic.config.json):

create-sev-app

El CLI detectará el proyecto y te desplegará un menú interactivo con opciones avanzadas de inyección:

1. Generar nueva página e inyectar componentes:

   • Te pedirá el nombre de la página (ej. gestion-usuarios).
   • Generará automáticamente los archivos .html, .ts, y .scss de la página.
   • Configurará el ruteo interno.
   • Te permitirá usar listas de selección con Checkbox para elegir múltiples componentes prefabricados (Tabla Dinámica, Login, etc.) e inyectarlos directamente en el HTML y TypeScript recién creados.

2. Inyectar componentes en una página existente:

   • Te mostrará un menú desplegable con todas tus páginas actuales para que elijas una.
   • Te permitirá elegir mediante Checkboxes (con tecla Espacio) los componentes de UI de la SEV a inyectar en esa página específica.
   • El código TypeScript (Imports, Datos falsos de prueba, Configuraciones) y HTML (Tags de Angular) se inyectarán listos para usarse.

💻 Desarrollo Local (Para Mantenedores)

Si quieres hacer cambios al CLI y probarlo en tu máquina:

1. Ingresa a la carpeta del generador (cli/).
2. Ejecuta npm link para registrar el comando globalmente en tu máquina:

   npm link

3. A partir de ahora, puedes usar create-sev-app en cualquier parte de tu computadora como si lo hubieras descargado de internet.

Para desvincularlo localmente, usa: npm unlink -g create-sev-app