g360-cli 1.13.1 → 1.15.0

package/package.json

@@ -1,71 +1,71 @@
-{
-  "name": "g360-cli",
-  "version": "1.13.1",
-  "description": "CLI tool for bootstrapping G360 projects with standardized structure, assets, identity, and ERP data processing",
-  "type": "module",
-  "main": "src/cli.js",
-  "bin": {
-    "g360": "src/cli.js"
-  },
-  "files": [
-    "src/",
-    "!src/assets/templates/**/node_modules",
-    "!src/assets/templates/**/package-lock.json",
-    "!src/assets/templates/**/__pycache__",
-    "!src/assets/templates/**/.pytest_cache",
-    "py/",
-    "README.md",
-    "LICENSE",
-    "package.json"
-  ],
-  "scripts": {
-    "prepublishOnly": "node -e \"console.log('Use: npm install -g g360-cli')\"",
-    "test": "vitest",
-    "test:watch": "vitest --watch",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
-    "build": "npm run build:portable",
-    "build:portable": "pkg . --targets node18-win-x64 --output dist/g360.exe",
-    "postinstall": "node -e \"try{require('child_process').execSync('python --version',{encoding:'utf8',stdio:'pipe'})}catch{console.log('⚠️  Python no detectado. Instala Python 3.11+ para funcionalidad completa.')}\""
-  },
-  "pkg": {
-    "assets": [
-      "src/assets/**/*",
-      "py/**/*"
-    ],
-    "outputPath": "dist",
-    "scripts": [],
-    "targets": "node18-win-x64"
-  },
-  "keywords": [
-    "g360",
-    "cli",
-    "scaffolding",
-    "generator",
-    "erp",
-    "data-processing"
-  ],
-  "author": "Carlos Cusi",
-  "license": "MIT",
-  "dependencies": {
-    "ajv": "^8.20.0",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.3",
-    "fs-extra": "^11.3.4",
-    "inquirer": "^13.4.2",
-    "ora": "^9.4.0",
-    "winston": "^3.19.0"
-  },
-  "devDependencies": {
-    "@vitest/ui": "^4.1.6",
-    "pkg": "^5.8.1",
-    "vitest": "^4.1.6"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ccusi/g360-cli.git"
-  }
-}
+{
+  "name": "g360-cli",
+  "version": "1.15.0",
+  "description": "CLI tool for bootstrapping G360 projects with standardized structure, assets, identity, and ERP data processing",
+  "type": "module",
+  "main": "src/cli.js",
+  "bin": {
+    "g360": "src/cli.js"
+  },
+  "files": [
+    "src/",
+    "!src/assets/templates/**/node_modules",
+    "!src/assets/templates/**/package-lock.json",
+    "!src/assets/templates/**/__pycache__",
+    "!src/assets/templates/**/.pytest_cache",
+    "py/",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "prepublishOnly": "node -e \"console.log('Use: npm install -g g360-cli')\"",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "build": "npm run build:portable",
+    "build:portable": "pkg . --targets node18-win-x64 --output dist/g360.exe",
+    "postinstall": "node -e \"try{require('child_process').execSync('python --version',{encoding:'utf8',stdio:'pipe'})}catch{console.log('⚠️  Python no detectado. Instala Python 3.11+ para funcionalidad completa.')}\""
+  },
+  "pkg": {
+    "assets": [
+      "src/assets/**/*",
+      "py/**/*"
+    ],
+    "outputPath": "dist",
+    "scripts": [],
+    "targets": "node18-win-x64"
+  },
+  "keywords": [
+    "g360",
+    "cli",
+    "scaffolding",
+    "generator",
+    "erp",
+    "data-processing"
+  ],
+  "author": "Carlos Cusi",
+  "license": "MIT",
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3.4",
+    "inquirer": "^13.4.2",
+    "ora": "^9.4.0",
+    "winston": "^3.19.0"
+  },
+  "devDependencies": {
+    "@vitest/ui": "^4.1.6",
+    "pkg": "^5.8.1",
+    "vitest": "^4.1.6"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ccusi/g360-cli.git"
+  }
+}

package/src/assets/config/g360-skills.json

@@ -279,6 +279,171 @@
       "framework": "flet",
       "portable": true,
       "brand": "cipsa"
+    },
+    {
+      "name": "flet-desktop-polished",
+      "description": "App Flet desktop con patrones UI avanzados: dual theme, auto-refresh, hash cache, search debounce, KPI glow, G360 signature widget",
+      "version": "1.0.0",
+      "device": "pc",
+      "colors": {
+        "bg": "#0b1220",
+        "surface": "#1a2333",
+        "accent": "#34d399",
+        "text": "#f0f6fc",
+        "muted": "#8b949e",
+        "success": "#34d399",
+        "warning": "#f59e0b",
+        "error": "#ef4444"
+      },
+      "effects": {
+        "glassmorphism": true,
+        "blur": "12px",
+        "rounded": "12px"
+      },
+      "signature": {
+        "mode": "powered",
+        "text": "powered by G360"
+      },
+      "framework": "flet",
+      "portable": true,
+      "features": [
+        "dual-theme",
+        "auto-launcher",
+        "portable-sync",
+        "g360-signature-flet",
+        "custom-fonts",
+        "cache-hash-diff",
+        "auto-refresh-thread",
+        "search-debounce",
+        "kpi-glow-cards",
+        "rotating-logger"
+      ]
+    },
+    {
+      "name": "react-web",
+      "description": "Aplicaciones web con React/JSX - estilo G360 moderno",
+      "device": "pc",
+      "colors": {
+        "bg": "#0b1220",
+        "surface": "#1a2332",
+        "accent": "#00d084",
+        "text": "#f0f4f8",
+        "muted": "#94a3b8",
+        "success": "#22c55e",
+        "warning": "#f59e0b",
+        "error": "#ef4444"
+      },
+      "effects": {
+        "glassmorphism": true,
+        "blur": "12px",
+        "rounded": "12px"
+      },
+      "signature": {
+        "mode": "powered",
+        "text": "powered by G360"
+      },
+      "framework": "react"
+    },
+    {
+      "name": "solid-web",
+      "description": "Aplicaciones web con SolidJS - estilo G360 moderno",
+      "device": "pc",
+      "colors": {
+        "bg": "#0b1220",
+        "surface": "#1a2332",
+        "accent": "#00d084",
+        "text": "#f0f4f8",
+        "muted": "#94a3b8",
+        "success": "#22c55e",
+        "warning": "#f59e0b",
+        "error": "#ef4444"
+      },
+      "effects": {
+        "glassmorphism": true,
+        "blur": "12px",
+        "rounded": "12px"
+      },
+      "signature": {
+        "mode": "powered",
+        "text": "powered by G360"
+      },
+      "framework": "solid"
+    },
+    {
+      "name": "svelte-web",
+      "description": "Aplicaciones web con Svelte/SvelteKit - estilo G360 moderno",
+      "device": "pc",
+      "colors": {
+        "bg": "#0b1220",
+        "surface": "#1a2332",
+        "accent": "#00d084",
+        "text": "#f0f4f8",
+        "muted": "#94a3b8",
+        "success": "#22c55e",
+        "warning": "#f59e0b",
+        "error": "#ef4444"
+      },
+      "effects": {
+        "glassmorphism": true,
+        "blur": "12px",
+        "rounded": "12px"
+      },
+      "signature": {
+        "mode": "powered",
+        "text": "powered by G360"
+      },
+      "framework": "svelte"
+    },
+    {
+      "name": "lit-web",
+      "description": "Aplicaciones web con Lit Web Components - estilo G360 moderno",
+      "device": "pc",
+      "colors": {
+        "bg": "#0b1220",
+        "surface": "#1a2332",
+        "accent": "#00d084",
+        "text": "#f0f4f8",
+        "muted": "#94a3b8",
+        "success": "#22c55e",
+        "warning": "#f59e0b",
+        "error": "#ef4444"
+      },
+      "effects": {
+        "glassmorphism": true,
+        "blur": "12px",
+        "rounded": "12px"
+      },
+      "signature": {
+        "mode": "powered",
+        "text": "powered by G360"
+      },
+      "framework": "lit"
+    },
+    {
+      "name": "customtkinter",
+      "description": "Aplicaciones desktop con CustomTkinter - estilo G360 moderno",
+      "device": "pc",
+      "colors": {
+        "bg": "#0b1220",
+        "surface": "#1a2332",
+        "accent": "#00d084",
+        "text": "#f0f4f8",
+        "muted": "#94a3b8",
+        "success": "#22c55e",
+        "warning": "#f59e0b",
+        "error": "#ef4444"
+      },
+      "effects": {
+        "glassmorphism": true,
+        "blur": "12px",
+        "rounded": "12px"
+      },
+      "signature": {
+        "mode": "powered",
+        "text": "powered by G360"
+      },
+      "framework": "customtkinter",
+      "portable": true
     }
   ]
 }

package/src/assets/config/project-types.json

@@ -21,13 +21,24 @@
       "framework": "python",
       "features": ["cli", "argparse", "rich"]
     },
+    {
+      "id": "python-flet-polished",
+      "name": "Python Flet Polished",
+      "description": "Python desktop app with Flet — estandar actual (dual theme, auto-refresh, hash cache, search debounce, KPI glow, G360 signature)",
+      "framework": "flet",
+      "features": ["desktop", "gui", "cross-platform", "portable", "dual-theme", "auto-refresh", "search-debounce", "kpi-glow", "g360-signature"],
+      "portable": true,
+      "default": true
+    },
     {
       "id": "python-flet",
-      "name": "Python Flet Desktop",
-      "description": "Python desktop app with Flet framework",
+      "name": "Python Flet (Legacy)",
+      "description": "Python desktop app with Flet framework — LEGACY: usar python-flet-polished para nuevos proyectos",
       "framework": "flet",
-      "features": ["desktop", "gui", "cross-platform", "portable"],
-      "portable": true
+      "features": ["desktop", "gui", "cross-platform"],
+      "portable": true,
+      "deprecated": true,
+      "deprecationNote": "Usa 'python-flet-polished' en su lugar. Este template se mantiene solo por compatibilidad con proyectos existentes."
     },
     {
       "id": "python-flet-migrate",
@@ -43,6 +54,14 @@
       "description": "Excel VBA macros",
       "framework": "vba",
       "features": ["excel", "macros", "forms"]
+    },
+    {
+      "id": "python-customtkinter",
+      "name": "Python CustomTkinter Desktop",
+      "description": "Python desktop app with CustomTkinter framework",
+      "framework": "customtkinter",
+      "features": ["desktop", "gui", "cross-platform"],
+      "portable": true
     }
   ]
 }

package/src/assets/snippets/snippets.json

@@ -45,21 +45,25 @@
     {
       "name": "g360-header",
       "description": "Standard G360 header",
+      "language": "html",
       "code": "<header class='g360-header'>...</header>"
     },
     {
       "name": "g360-button",
       "description": "G360 styled button",
+      "language": "html",
       "code": "<button class='g360-btn'>Click</button>"
     },
     {
       "name": "g360-card",
       "description": "G360 card component",
+      "language": "html",
       "code": "<div class='g360-card'>...</div>"
     },
     {
       "name": "g360-badge",
       "description": "G360 status badge",
+      "language": "html",
       "code": "<span class='g360-badge g360-badge-success'>Active</span>"
     },
     {

package/src/assets/templates/lit-web/src/index.js

@@ -5,4 +5,4 @@
  * @version 1.0.0
  */
 
-import './src/components/app-root.js';
+import './components/app-root.js';

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

@@ -1,5 +1,8 @@
 # Mi Proyecto G360 Flet
 
+> ⚠️ **LEGACY** — Este template fue reemplazado por `python-flet-polished` (estandar actual).
+> Para nuevos proyectos usar: `g360 init <name> --template python-flet-polished --skill flet-desktop-polished`
+
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="g360/brand/g360/logotypes/logo-g360-light.svg">
   <img alt="G360" height="64" src="g360/brand/g360/logotypes/logo-g360-dark.svg">
@@ -65,5 +68,7 @@ page.add(g360_footer())
 
 ---
 
+> **Nota**: Este es el template base original. Para proyectos nuevos se recomienda `python-flet-polished` que incluye: dual theme, auto-refresh con hash cache, search debounce, KPI glow cards, G360 signature widget y launcher auto-instalable de 5 pasos.
+
 **Marca**: G360 · **Isotipo**: 3 puntos + chevron `>`
-**Signature**: G360 Desktop · **Powered by**: [g360-signature](https://github.com/carloscus/g360-signature)
+**Signature**: G360 Desktop · **Powered by**: [g360-signature](https://github.com/carloscus/g360-signature)

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

@@ -7,11 +7,11 @@ authors = [
 ]
 requires-python = ">=3.11,<4.0"
 dependencies = [
-    "flet>=0.25.0",
+    "flet>=0.28.3",
+    "numpy>=1.24.0",
     "openpyxl>=3.1.0",
     "pandas>=2.0.0",
     "xlrd>=2.0.0",
-    "g360-core>=0.1.0",
 ]
 
 [project.optional-dependencies]

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

@@ -29,7 +29,7 @@
     "name": "G360-App"
   },
   "dependencies": {
-    "flet": ">=0.25.0"
+    "flet": ">=0.28.3"
   },
   "guidelines": {
     "architecture": "src/core (logica), src/ui (componentes), src/export (reportes)",

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

@@ -7,9 +7,7 @@ authors = [
 ]
 requires-python = ">=3.11,<4.0"
 dependencies = [
-    "flet>=0.25.0",
-    "openpyxl>=3.1.0",
-    "pandas>=2.0.0",
+    "flet>=0.28.3",
 ]
 
 [project.optional-dependencies]

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

@@ -0,0 +1,170 @@
+# G360 App Polished
+
+> 🚀 **Plantilla estandar G360 para apps Flet desktop** — La evolucion de `python-flet` con patrones de UI avanzados heredados de produccion.
+
+[![Version](https://img.shields.io/badge/version-1.0.0-blue)]()
+[![Python](https://img.shields.io/badge/Python-3.11+-blue)](https://python.org)
+[![Flet](https://img.shields.io/badge/Flet-0.28.3-green)](https://flet.dev)
+
+## Quick Start
+
+```bash
+# La app auto-instala uv, Python 3.11, dependencias y crea acceso directo
+run.bat
+
+# O lanzador minimizado (sin consola visible)
+launch.vbs
+```
+
+## Caracteristicas
+
+| Caracteristica | Detalle |
+|---|---|
+| **Dual theme** | Dark/light con toggle y persistencia en `~/.g360/` |
+| **Auto-refresh** | Cada 15 min con lock thread-safe |
+| **Cache con hash diff** | SHA-256 evita rebuilds si los datos no cambiaron |
+| **Search overlay** | Buscador flotante con debounce 250ms, Enter abre, Escape cierra |
+| **KPI cards con glow** | Colores semanticos + efecto de luz |
+| **G360 Signature** | Isotipo G360 detecta tema automaticamente (dark/light) |
+| **Fonts embebidas** | Inter + JetBrains Mono Variable |
+| **Launcher 5 pasos** | Auto-instala uv → Python 3.11 → .venv → deps → shortcut |
+| **Portable** | `sync_portable.py` + `launch.vbs` para PCs sin Python |
+| **Logger rotativo** | `RotatingFileHandler` max 2MB, backupCount=3 |
+| **Shutdown limpio** | `page.on_close` detiene threads |
+
+## Estructura
+
+```
+g360-app-polished/
+├── main.py                    # Entry point (ft.app + logger setup)
+├── src/
+│   ├── __init__.py
+│   ├── app.py                 # G360App base (orquestador)
+│   ├── config/
+│   │   ├── __init__.py
+│   │   └── theme.py           # Paleta dual + rgba() + persistencia
+│   ├── core/
+│   │   ├── __init__.py
+│   │   ├── constants.py       # Rutas, versiones, configuracion global
+│   │   ├── processor.py       # BaseProcessor (heredar y extender)
+│   │   └── skill.json         # Skill metadata
+│   └── ui/
+│       ├── __init__.py
+│       ├── dashboard.py       # Layout base: sidebar, KPIs, search
+│       ├── kpi_card.py        # Card reutilizable con glow
+│       └── search_overlay.py  # Buscador flotante con debounce
+├── g360_flet/
+│   ├── __init__.py
+│   └── g360_signature.py      # Widget isotipo G360
+├── assets/
+│   ├── fonts/                 # Inter + JetBrains Mono Variable
+│   ├── images/                # Logo + icono
+│   └── data/                  # Sample data + cache runtime
+├── skill.json                 # Skill G360 aplicado
+├── run.bat                    # Launcher 5 pasos auto-instalable
+├── launch.vbs                 # Lanzador minimizado
+├── launch_minimized.bat       # Delega a launch.vbs
+├── build-portable.bat         # PyInstaller onefile + windowed
+├── sync_portable.py           # Sync sincronizacion
+├── create_shortcut.vbs        # Acceso directo escritorio
+├── requirements.txt           # Dependencias
+├── pyproject.toml             # Metadata del proyecto
+└── .gitignore
+```
+
+## Como extender
+
+### 1. Implementar tu logica de datos
+
+En `src/app.py`, sobrescribe `_fetch_data`:
+
+```python
+from src.app import G360App
+
+class MiApp(G360App):
+    def _fetch_data(self) -> dict | None:
+        """Descarga datos desde tu API/ERP."""
+        import requests
+        resp = requests.get("https://mi-api.com/data")
+        return resp.json() if resp.ok else None
+```
+
+### 2. Procesar y renderizar
+
+En `src/core/processor.py`, extiende `BaseProcessor`:
+
+```python
+from src.core.processor import BaseProcessor
+
+class MiProcessor(BaseProcessor):
+    def calcular_kpis(self, raw_data: dict) -> dict:
+        # Tu logica de KPIs
+        return {
+            "primary": {"value": "100", "subtext": "items"},
+            ...
+        }
+```
+
+### 3. Customizar el dashboard
+
+```python
+from src.ui.dashboard import Dashboard
+
+class MiDashboard(Dashboard):
+    def _render(self):
+        """Renderiza los datos procesados en el UI."""
+        kpis = MiProcessor().calcular_kpis(self._raw_data)
+        self._kpi_row.controls = self._build_kpi_row(kpis)
+        self.page.update()
+```
+
+## Theme Colors
+
+Colores semanticos definidos en `skill.json`, accesibles via `get_colors(mode)`:
+
+| Token | Dark | Light | Uso |
+|-------|------|-------|-----|
+| `bg` | `#0A0F1E` | `#F3F5F9` | Fondo principal |
+| `surface` | `#141D33` | `#FFFFFF` | Cards, contenedores |
+| `accent` | `#10B981` | `#047857` | Accentos principales |
+| KPI cyan | `#06B6D4` | `#0891B2` | Indicador 1 |
+| KPI violet | `#8B5CF6` | `#7C3AED` | Indicador 2 |
+| KPI red | `#EF4444` | `#DC2626` | Indicador critico |
+| KPI amber | `#F59E0B` | `#B45309` | Indicador warning |
+
+## Arquitectura
+
+```
+main.py → G360App ──→ Dashboard ──→ KPICard, SearchOverlay
+                    ├──→ theme.py       (colores)
+                    └──→ processor.py   (logic)
+```
+
+### Capas (Regla G360: Core sin UI, UI con Core)
+
+| Capa | Archivo | Responsabilidad |
+|------|---------|-----------------|
+| **Entry** | `main.py` | Boot, sys.path, ft.app, logger |
+| **App** | `src/app.py` | Page setup, ciclo de vida, cache, auto-refresh, overlay |
+| **Core** | `src/core/processor.py` | BaseProcessor (heredar) — KPIs, export |
+| **Core** | `src/core/constants.py` | URL, rutas, version |
+| **UI** | `src/ui/dashboard.py` | Layout completo, callbacks |
+| **Config** | `src/config/theme.py` | Paleta dual, utility rgba, persistencia |
+| **Brand** | `g360_flet/g360_signature.py` | Isotipo G360 auto-temado |
+
+## Comandos G360
+
+```bash
+g360 init mi-app --template python-flet-polished --skill flet-desktop-polished --portable
+
+# El template se resuelve automaticamente si usas un skill Flet:
+g360 init mi-app --skill flet-desktop-polished
+# ↓ usa python-flet-polished por defecto
+```
+
+---
+
+> **Estandar desde v1.14.0.** El template `python-flet` clasico queda en **legacy** — usa `python-flet-polished` para nuevos proyectos.
+
+**Marca**: G360 · **Isotipo**: 3 puntos + chevron `>` · **Signature**: powered by G360
+**Powered by**: [g360-signature](https://github.com/carloscus/g360-signature)

package/src/assets/templates/python-flet-polished/assets/data/sample_data.json

@@ -0,0 +1,12 @@
+{
+  "items": [
+    {"sku": "1001", "descripcion": "Producto ejemplo A", "stock": 150, "predespacho": 30, "disponible": 120, "linea": "PELOTAS", "categoria": "DEPORTES"},
+    {"sku": "1002", "descripcion": "Producto ejemplo B", "stock": 80, "predespacho": 20, "disponible": 60, "linea": "ESCRITURA", "categoria": "OFICINA"},
+    {"sku": "1003", "descripcion": "Producto ejemplo C", "stock": 200, "predespacho": 50, "disponible": 150, "linea": "PELOTAS", "categoria": "DEPORTES"},
+    {"sku": "1004", "descripcion": "Producto ejemplo D", "stock": 10, "predespacho": 5, "disponible": 5, "linea": "ARCHIVO", "categoria": "OFICINA"},
+    {"sku": "1005", "descripcion": "Producto ejemplo E", "stock": 300, "predespacho": 0, "disponible": 300, "linea": "PINTURA", "categoria": "ARTE"},
+    {"sku": "1006", "descripcion": "Producto ejemplo F", "stock": 45, "predespacho": 40, "disponible": 5, "linea": "MASCOTAS", "categoria": "OTROS"},
+    {"sku": "1007", "descripcion": "Producto ejemplo G", "stock": 120, "predespacho": 25, "disponible": 95, "linea": "DIBUJO", "categoria": "ARTE"},
+    {"sku": "1008", "descripcion": "Producto ejemplo H", "stock": 60, "predespacho": 10, "disponible": 50, "linea": "PEGAMENTOS", "categoria": "OFICINA"}
+  ]
+}