g360-cli 1.15.1 → 1.16.0

package/src/assets/pptx/templates/app-manual.js

@@ -0,0 +1,275 @@
+/**
+ * Template Manual de App G360 — 12 slides A4.
+ * 
+ * Estructura:
+ * 1.  Portada
+ * 2.  ¿Qué es esta app?
+ * 3.  Requisitos / Instalacion
+ * 4.  Inicio — primera pantalla
+ * 5-N. Funcionalidades (una por feature detectada)
+ * N+1. Flujos de trabajo (modals)
+ * N+2. Arquitectura
+ * N+3. Buenas prácticas
+ * N+4. Resumen
+ */
+import PptxGenJS from 'pptxgenjs';
+import { createG360Theme, createCipsaTheme } from '../themes/index.js';
+import {
+  coverSlide,
+  screenshotSlide,
+  featureSlide,
+  workflowSlide,
+  architectureSlide,
+  checklistSlide,
+  kpiSlide,
+  addFooter,
+  addSectionHeader,
+} from '../layouts/base.js';
+
+/**
+ * Genera un manual PPTX completo para una app G360.
+ * 
+ * @param {object} appData — resultado de analyzeApp()
+ * @param {object} options — { mode, theme, outDir }
+ * @returns {Promise<string>} — ruta del archivo .pptx generado
+ */
+export async function generateManualPptx(appData, options = {}) {
+  const { mode = 'manual', theme: themeName = null } = options;
+  
+  // Seleccionar theme
+  const theme = themeName === 'cipsa' || (!themeName && appData.brand === 'cipsa')
+    ? createCipsaTheme()
+    : createG360Theme();
+  
+  const { pptx, colors } = theme;
+  
+  // Configurar tamaño segun modo
+  if (mode === 'demo') {
+    pptx.layout = 'LAYOUT_16x9';
+  } else {
+    pptx.layout = 'A4';
+  }
+
+  // ===== SLIDE 1: Portada =====
+  let slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  coverSlide(slide, {
+    appName: appData.name || 'Mi Aplicacion G360',
+    description: appData.description || 'Documentacion de uso y funcionalidades',
+    version: appData.version,
+    brand: appData.brand,
+  }, theme);
+  addFooter(slide, theme, 1, 12);
+
+  // ===== SLIDE 2: ¿Qué es? =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'INTRODUCCION', theme);
+  featureSlide(slide, {
+    title: '¿Qué es ' + (appData.name || 'esta app') + '?',
+    description: appData.description || 'Aplicacion de escritorio construida con Flet y los estandares G360.',
+    bullets: [
+      'Monitoriza datos en tiempo real desde el ERP',
+      'Genera reportes y analisis automaticos',
+      'Soporta dual theme (claro/oscuro)',
+      'Funciona offline con cache local',
+    ],
+  }, theme);
+  addFooter(slide, theme, 2, 12);
+
+  // ===== SLIDE 3: Instalacion =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'INSTALACION', theme);
+  const installSteps = [
+    { title: 'Ejecutar run.bat', desc: 'El launcher instala uv, Python 3.11, dependencias y crea acceso directo.' },
+    { title: 'O usar comando directo', desc: 'uv sync && uv run python main.py' },
+    { title: 'Version portable', desc: 'Descomprimir zip y ejecutar launch.vbs (sin dependencias).' },
+  ];
+  workflowSlide(slide, {
+    title: 'Como iniciar la aplicacion',
+    steps: installSteps,
+  }, theme);
+  addFooter(slide, theme, 3, 12);
+
+  // ===== SLIDES 4+: Features / Screenshots =====
+  let slideNum = 4;
+  const totalFeatures = Math.min(appData.features.length, 6); // max 6 features en manual
+  const totalSlides = 3 + totalFeatures + 3; // intro + features + workflows + arch + summary
+  
+  // Slide 4: Dashboard / inicio
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'PRIMERA VISTA', theme);
+  const dashScreen = appData.screenshots?.find(s => s.filename.toLowerCase().includes('dash'));
+  screenshotSlide(slide, {
+    title: 'Dashboard Principal',
+    description: appData.hasAutoRefresh
+      ? 'Vista principal con KPIs en tiempo real y auto-refresh cada 15 minutos.'
+      : 'Vista principal de la aplicacion con los indicadores clave del negocio.',
+    screenshotPath: dashScreen?.path,
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+  slideNum++;
+
+  // Features individual slides
+  for (const feature of appData.features.slice(0, totalFeatures)) {
+    slide = pptx.addSlide();
+    slide.background = { color: colors.bg };
+    addSectionHeader(slide, 'FUNCIONALIDAD', theme);
+    
+    const shot = appData.screenshots?.find(s =>
+      feature.name.toLowerCase().includes(s.filename.toLowerCase().slice(0, 6))
+    );
+    
+    const classification = classifyFeatureForSlide(feature);
+    
+    if (classification === 'kpi' && feature.name.includes('Kpi')) {
+      kpiSlide(slide, {
+        title: feature.display || feature.name,
+        kpis: generateKpiPlaceholders(feature),
+      }, theme);
+    } else if (classification === 'workflow') {
+      workflowSlide(slide, {
+        title: feature.display || feature.name,
+        steps: [`Acceder desde el menu principal`, 'Seleccionar opciones disponibles', 'Confirmar y generar resultado'],
+      }, theme);
+    } else {
+      featureSlide(slide, {
+        title: feature.display || feature.name,
+        description: `Module ubicado en src/ui/${feature.file}`,
+        bullets: [
+          'Clase exportada desde src/ui/',
+          'Integracion con Dashboard principal',
+          'Soporta dual theme automaticamente',
+        ],
+      }, theme);
+    }
+    
+    if (!shot) {
+      // Agregar placeholder si no hay screenshot
+      slide.addShape('rect', [1, 3.5, 8, 6], {
+        fill: { color: colors.surface },
+        line: { color: colors.border, width: 1, dashType: 'dash' },
+      });
+      slide.addText('📷 Screenshot: ' + (feature.display || feature.name), [1, 6, 8, 0.5], {
+        fontSize: 12, color: colors.textLight, fontFace: 'Inter', align: 'center',
+      });
+    } else {
+      screenshotSlide(slide, {
+        title: feature.display || feature.name,
+        description: `Módulo: src/ui/${feature.file}`,
+        screenshotPath: shot.path,
+      }, theme);
+      slide.clearShapes?.(); // remove placeholder
+    }
+    
+    addFooter(slide, theme, slideNum, totalSlides);
+    slideNum++;
+  }
+
+  // ===== Workflows (modals) =====
+  if (appData.hasModals.length > 0) {
+    slide = pptx.addSlide();
+    slide.background = { color: colors.bg };
+    addSectionHeader(slide, 'FLUJOS DE TRABAJO', theme);
+    
+    const steps = appData.hasModals.slice(0, 4).map((modal, i) => ({
+      title: `Modal: ${modal}`,
+      desc: 'Paso 1 → Paso 2 → Paso 3',
+    }));
+    
+    workflowSlide(slide, {
+      title: 'Modales y flujos de usuario',
+      steps,
+    }, theme);
+    addFooter(slide, theme, slideNum, totalSlides);
+    slideNum++;
+  }
+
+  // ===== Architecture =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'ARQUITECTURA', theme);
+  architectureSlide(slide, {
+    title: 'Estructura de capas',
+    layers: [
+      { name: 'UI', desc: 'Dashboard, Cards, Modals, Overlays', color: colors.accent },
+      { name: 'Core', desc: 'Processor, Downloader, Models', color: colors.info },
+      { name: 'Config', desc: 'Theme, Constants, Skill', color: colors.violet },
+      { name: 'Data', desc: 'API S1, Catalogo JSON, Cache', color: colors.success },
+    ],
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+  slideNum++;
+
+  // ===== Checklist / Buenas prácticas =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'BUENAS PRÁCTICAS', theme);
+  checklistSlide(slide, {
+    title: 'Recomendaciones de uso',
+    items: [
+      { text: 'Mantener nombres de clases siguiendo PascalCase (KpiCard, Dashboard)', checked: true },
+      { text: 'Usar theme.py para colores, nunca hardcodear #HEX', checked: true },
+      { text: 'Registrar eventos con publish_g360_event() para comunicacion entre apps', checked: true },
+      { text: 'Implementar shutdown() para limpieza de threads al cerrar', checked: true },
+      { text: 'Documentar funciones con docstrings en español', checked: true },
+      { text: 'Usar G360 Signature widget en el footer de la app', checked: true },
+    ],
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+  slideNum++;
+
+  // ===== Summary =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'RESUMEN', theme);
+  
+  const summaryItems = [
+    `Nombre: ${appData.name || 'N/A'}`,
+    `Version: ${appData.version || '1.0.0'}`,
+    `Framework: ${appData.framework || 'Flet'}`,
+    `Skills: ${appData.skill || 'N/A'}`,
+    `Caracteristicas: ${appData.features.length} modulos UI`,
+    appData.hasAutoRefresh ? 'Auto-refresh activado' : '',
+    appData.hasSearch ? 'Buscador flotante implementado' : '',
+    appData.hasExport ? 'Exportacion a Excel disponible' : '',
+    appData.hasModals.length > 0 ? `${appData.hasModals.length} modales de trabajo` : '',
+  ].filter(Boolean);
+  
+  checklistSlide(slide, {
+    title: 'Resumen de la aplicacion',
+    items: summaryItems.map(t => ({ text: t, checked: true })),
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+
+  // Save
+  const outPath = options.outPath || path.join(process.cwd(), `${(appData.name || 'app').toLowerCase().replace(/\s+/g, '-')}-manual.pptx`);
+  await pptx.writeFile({ fileName: outPath });
+  return outPath;
+}
+
+/**
+ * Classifica feature para decidir que slide usar.
+ */
+function classifyFeatureForSlide(feature) {
+  if (feature.name.includes('Kpi')) return 'kpi';
+  if (feature.name.includes('Modal') || feature.name.includes('Dialog')) return 'workflow';
+  if (feature.name.includes('Dashboard')) return 'screenshot';
+  return 'feature';
+}
+
+/**
+ * Genera placeholders de KPIs basado en features detectadas.
+ */
+function generateKpiPlaceholders(feature) {
+  return [
+    { label: 'Total', value: '—', color: '#64748B' },
+    { label: 'Con Stock', value: '—', color: '#34D399' },
+    { label: 'Sin Stock', value: '—', color: '#EF4444' },
+    { label: 'Alertas', value: '—', color: '#F59E0B' },
+  ];
+}
+
+import path from 'path';

package/src/assets/pptx/themes/base.js

@@ -0,0 +1,63 @@
+/**
+ * Tema G360 — paleta esmeralda, fuente Inter, fondo oscuro/claro.
+ * Usa los colores definidos en skill.json del proyecto (fallback a valores G360).
+ */
+import PptxGenJS from 'pptxgenjs';
+
+export function createG360Theme() {
+  const colors = {
+    accent: '#10B981',
+    accentDark: '#047857',
+    success: '#34D399',
+    warning: '#F59E0B',
+    error: '#EF4444',
+    text: '#0F172A',
+    textLight: '#64748B',
+    bg: '#FFFFFF',
+    surface: '#F3F5F9',
+    border: '#E3E8F0',
+    darkBg: '#0A0F1E',
+    darkText: '#F1F5FB',
+    darkSurface: '#141D33',
+  };
+
+  // Definir layout A4 vertical para manual (portrait)
+  const pptx = new PptxGenJS();
+  pptx.defineLayout({ name: 'A4', width: 10, height: 14.28 }); // A4 portrait en pulgadas
+  pptx.defineLayout({ name: 'LAYOUT_16x9', width: 10, height: 5.625 });
+  pptx.defineLayout({ name: 'LAYOUT_4x3', width: 10, height: 7.5 });
+
+  // Usar A4 como default (manual mode)
+  pptx.layout = 'A4';
+
+  // Theme global
+  pptx.author = 'g360-cli';
+  pptx.title = '';
+  pptx.subject = 'Documentacion generada por g360-cli';
+
+  return {
+    pptx,
+    colors,
+    layout: 'A4',
+    fonts: ['Inter', 'Arial'],
+    /**
+     * Agregar logo de marca a la presentacion
+     */
+    setLogo(pptxObj, brand, width = 1.2, height = 0.6) {
+      const logoPath = brand === 'cipsa'
+        ? path.join(__dirname, '..', 'brand', 'cipsa', 'logotypes', 'Logo_cipsa_solid.svg')
+        : path.join(__dirname, '..', 'brand', 'g360', 'logotypes', 'logo-g360-light.svg');
+      // Nota: SVG no soportado nativamente por PptxGenJS; fallback a PNG
+      const pngPath = brand === 'cipsa'
+        ? path.join(__dirname, '..', 'brand', 'cipsa', 'logotypes', 'Logo_cipsa_solid.png')
+        : path.join(__dirname, '..', 'brand', 'g360', 'logotypes', 'logo-g360-dark.png');
+      if (require('fs').existsSync(pngPath)) {
+        return { path: pngPath, width, height };
+      }
+      return null;
+    },
+  };
+}
+
+import path from 'path';
+import fs from 'fs';

package/src/assets/pptx/themes/cipsa.js

@@ -0,0 +1,46 @@
+/**
+ * Tema CIPSA — verde corporativo con logo CIPSA.
+ */
+import PptxGenJS from 'pptxgenjs';
+import path from 'path';
+import fs from 'fs';
+
+export function createCipsaTheme() {
+  const colors = {
+    accent: '#00d084',
+    accentDark: '#00796B',
+    success: '#22c55e',
+    warning: '#f59e0b',
+    error: '#ef4444',
+    text: '#0F172A',
+    textLight: '#64748B',
+    bg: '#FFFFFF',
+    surface: '#F0F9F4',
+    border: '#CCF0E0',
+    darkBg: '#0d1117',
+    darkText: '#f0f6fc',
+    darkSurface: '#161b22',
+  };
+
+  const pptx = new PptxGenJS();
+  pptx.defineLayout({ name: 'A4', width: 10, height: 14.28 });
+  pptx.defineLayout({ name: 'LAYOUT_16x9', width: 10, height: 5.625 });
+  pptx.layout = 'A4';
+
+  pptx.author = 'g360-cli';
+  pptx.title = '';
+  pptx.subject = 'Documentacion CIPSA generada por g360-cli';
+
+  const cipsaLogo = path.join(process.cwd(), 'assets', 'images', 'Logo_cipsa_solid.png');
+  const fallbackLogo = fs.existsSync(cipsaLogo)
+    ? cipsaLogo
+    : path.join(__dirname, '..', '..', 'brand', 'cipsa', 'logotypes', 'Logo_cipsa_solid.png');
+
+  return {
+    pptx,
+    colors,
+    layout: 'A4',
+    fonts: ['Inter', 'Arial'],
+    logo: fs.existsSync(fallbackLogo) ? { path: fallbackLogo, width: 1.5, height: 0.5 } : null,
+  };
+}

package/src/assets/pptx/themes/g360.js

@@ -0,0 +1,32 @@
+/**
+ * Tema G360 — paleta esmeralda, fuente Inter.
+ */
+import PptxGenJS from 'pptxgenjs';
+
+const colors = {
+  accent: '#10B981',
+  accentDark: '#047857',
+  success: '#34D399',
+  warning: '#F59E0B',
+  error: '#EF4444',
+  info: '#3B82F6',
+  violet: '#8B5CF6',
+  text: '#0F172A',
+  textLight: '#64748B',
+  bg: '#FFFFFF',
+  surface: '#F3F5F9',
+  border: '#E3E8F0',
+};
+
+export function createG360Theme() {
+  const pptx = new PptxGenJS();
+  pptx.defineLayout({ name: 'A4', width: 10, height: 14.28 });
+  pptx.defineLayout({ name: 'LAYOUT_16x9', width: 10, height: 5.625 });
+  pptx.layout = 'A4';
+  pptx.author = 'g360-cli';
+  pptx.subject = 'Documentacion generada por g360-cli';
+
+  return { pptx, colors, layout: 'A4' };
+}
+
+export { colors };

package/src/assets/pptx/themes/index.js

@@ -0,0 +1,2 @@
+export { createG360Theme } from './g360.js';
+export { createCipsaTheme } from './cipsa.js';

package/src/assets/templates/python-flet-polished/README.md

@@ -132,6 +132,45 @@ Colores semanticos definidos en `skill.json`, accesibles via `get_colors(mode)`:
 | KPI red | `#EF4444` | `#DC2626` | Indicador critico |
 | KPI amber | `#F59E0B` | `#B45309` | Indicador warning |
 
+### Personalizar Colores
+
+Los colores se leen automaticamente de `skill.json`. Para personalizar:
+
+**Opcion 1: Modificar skill.json**
+```json
+{
+  "colors": {
+    "accent": "#2563eb",      // Azul corporativo
+    "surface": "#1e293b",     // Gris oscuro
+    "success": "#16a34a",     // Verde mas oscuro
+    ...
+  }
+}
+```
+
+**Opcion 2: Sobrescribir en runtime**
+```python
+from src.config.theme import set_brand_colors
+
+set_brand_colors({
+    "dark": {
+        "accent": "#2563eb",
+        "surface": "#1e273e",
+    },
+    "light": {
+        "accent": "#1d4ed8",
+    }
+})
+```
+
+**Opcion 3: Usar paleta existente**
+- **Verde esmeralda** (default): `#10B981` — Moderno, fresco
+- **Verde corporativo**: `#2563eb` — Azul/verde profesional
+- **Verde bosque**: `#059669` — Mas sobrio, enterprise
+- **Verde fluorescente**: `#34d399` — Mas vibrante, tech
+
+> **Nota**: Todos los colores deben ser validos hex (`#RRGGBB`). El sistema usa defaults G360 y aplica overrides solo de los colores especificados.
+
 ## Arquitectura
 
 ```

package/src/assets/templates/python-flet-polished/main.py

@@ -6,6 +6,13 @@ import traceback
 from logging.handlers import RotatingFileHandler
 from pathlib import Path
 
+# Import pip-system-certs to fix SSL issues on Windows corporate networks
+try:
+    import pip_system_certs
+    pip_system_certs.install()
+except ImportError:
+    pass  # Not available, continue without it
+
 import flet as ft
 
 BASE_DIR = Path(__file__).resolve().parent

package/src/assets/templates/python-flet-polished/pyproject.toml

@@ -5,6 +5,7 @@ description = "G360 Desktop Application - Polished Template"
 requires-python = ">=3.11"
 dependencies = [
     "flet[desktop]==0.28.3",
+    "pip-system-certs>=4.38",
     "requests>=2.31.0",
     "openpyxl>=3.0.0",
 ]

package/src/assets/templates/python-flet-polished/requirements.txt

@@ -1,3 +1,4 @@
 flet[desktop]==0.28.3
+pip-system-certs>=4.38
 requests>=2.31.0
 openpyxl>=3.0.0

package/src/assets/templates/python-flet-polished/skill.json

@@ -6,16 +6,30 @@
   "brand": "g360",
   "description": "G360 Flet Polished - Plantilla base con patrones de UI avanzada",
   "framework": "flet",
+  "flet_version": "0.28.3",
   "portable": true,
   "colors": {
     "bg": "#0b1220",
     "surface": "#1a2333",
     "accent": "#34d399",
+    "accent_dark": "#047857",
     "text": "#f0f6fc",
     "muted": "#8b949e",
     "success": "#34d399",
     "warning": "#f59e0b",
-    "error": "#ef4444"
+    "error": "#ef4444",
+    "info": "#3b82f6",
+    "violet": "#8b5cf6",
+    "pink": "#ec4899",
+    "cyan": "#06b6d4",
+    "orange": "#f97316",
+    "surface_variant": "#1b2740",
+    "surface_sunken": "#0e1627",
+    "background": "#0a0f1e",
+    "border": "#ffffff17",
+    "text_muted": "#8fa0ba",
+    "text_primary": "#f1f5fb",
+    "text_secondary": "#c9d4e6"
   },
   "effects": {
     "glassmorphism": true,
@@ -24,5 +38,17 @@
   "signature": {
     "mode": "powered",
     "text": "powered by G360"
+  },
+  "events": [
+    "app:{name}:refresh",
+    "app:{name}:data:update",
+    "app:{name}:theme:change",
+    "g360:app:list",
+    "g360:app:register"
+  ],
+  "endpoints": {
+    "health": "/api/health",
+    "data": "/api/data",
+    "events": "/api/events"
   }
 }

package/src/assets/templates/python-flet-polished/src/app.py

@@ -24,6 +24,7 @@ from src.core.constants import (
     get_app_name,
 )
 from src.ui.dashboard import Dashboard
+from src.core.g360_registry import register_g360_app, get_event_bus
 
 import logging
 _log_logger = logging.getLogger("g360.app")
@@ -156,6 +157,9 @@ class G360App:
         self.dashboard.register_overlay()
         _log("_build: overlay (FilePickers) registrado")
 
+        # Registrar app en registry G360
+        self._register_app()
+
         sample_path = Path(__file__).resolve().parent.parent / "assets" / "data" / "sample_data.json"
         cache, ts = _load_cache()
         if cache:
@@ -215,8 +219,38 @@ class G360App:
         except Exception as ex:
             _log(f"_start_auto_refresh: ERROR {ex}")
 
+    def _register_app(self):
+        """Registrar la app en el registry G360."""
+        try:
+            skill_data = self._load_skill_config()
+            events = skill_data.get("events", [])
+            endpoints = skill_data.get("endpoints", {})
+            
+            register_g360_app(
+                name=get_app_name(),
+                version=self._local_version,
+                skill=skill_data.get("skill", "custom"),
+                framework="flet",
+                events=events,
+                endpoints=endpoints,
+                description=skill_data.get("description", ""),
+            )
+            _log(f"_register_app: {get_app_name()} registrado en G360 registry")
+        except Exception as ex:
+            _log(f"_register_app: ERROR {ex}")
+
+    def _load_skill_config(self) -> dict:
+        """Cargar config del skill actual."""
+        import json
+        from pathlib import Path
+        skill_path = Path(__file__).resolve().parent.parent.parent / "skill.json"
+        if skill_path.exists():
+            with open(skill_path, encoding="utf-8") as f:
+                return json.load(f)
+        return {}
+
     def shutdown(self):
-        """Detiene el auto-refresh de forma limpia antes de cerrar."""
+        """Detiene el auto-refresh y desregistra la app antes de cerrar."""
         if self._auto_refresh_stop:
             _log("_shutdown: deteniendo auto-refresh...")
             self._auto_refresh_stop.set()
@@ -224,6 +258,15 @@ class G360App:
             if t and t.is_alive():
                 t.join(timeout=3)
             _log("_shutdown: auto-refresh detenido")
+        
+        # Desregistrar del registry
+        try:
+            from src.core.g360_registry import get_app_registry
+            registry = get_app_registry()
+            registry.update_status(get_app_name(), "offline")
+            _log(f"_shutdown: {get_app_name()} desregistrado")
+        except Exception as ex:
+            _log(f"_shutdown: ERROR desregistrando {ex}")
 
     def _auto_refresh_loop(self):
         while not self._auto_refresh_stop.is_set():