g360-cli 1.6.0 → 1.7.0

package/README.md

@@ -54,6 +54,8 @@ CLI tool para el ecosistema G360 que permite inicializar proyectos con estructur
 
 - **Inicialización rápida** - Crea proyectos G360 con estructura estándar
 - **Gestión de assets** - Trae componentes, skills y plantillas embebidas
+- **Ingesta ERP** - Normaliza `.xls/.xlsx` de SAP, StarSoft, Spring con `g360 bring ingestion`
+- **Paquete Python** - `g360-core` en PyPI para pipelines de datos independientes
 - **Auditoría** - Verifica compliance de proyectos G360
 - **Limpieza** - Elimina assets embebidos antes de deployment
 - **Multi-plantilla** - Web (Lit, Solid, Svelte, React), Python (CLI, Flet, CustomTkinter), VBA Excel
@@ -270,6 +272,41 @@ g360 bring skills
 
 # Traer engine específico
 g360 bring engine/g360-skill-audit
+
+# Traer ingestion module ERP a proyecto Flet existente
+g360 bring ingestion
+```
+
+### `g360 bring ingestion`
+
+Instala el módulo de normalización de datos ERP en proyectos Flet.
+
+```bash
+g360 bring ingestion [opciones]
+```
+
+**Opciones:**
+
+| Opción | Descripción |
+|--------|-------------|
+| `-p, --path <ruta>` | Ruta al proyecto |
+| `--dry-run` | Previsualizar |
+| `--force` | Sobrescribir archivos existentes |
+
+**Archivos instalados:**
+- `src/core/ingestion.py` — Normalización de datos (estabilizar_excel_crudo)
+- `src/ui/ingestion_panel.py` — Panel Flet para carga de archivos
+
+**Importación (auto-detects pip → local):**
+```python
+# Si g360-core está instalado via pip → from g360_core.ingestion import ...
+# Si no → from core.ingestion import ...
+from ui.ingestion_panel import IngestionPanel
+```
+
+El paquete pip acompañante `g360-core` se publica en PyPI:
+```bash
+pip install g360-core
 ```
 
 ---
@@ -289,6 +326,7 @@ g360 list [tipo] [opciones]
 | `templates` | Lista de plantillas |
 | `components` | Lista de componentes |
 | `skills` | Lista de skills |
+| `ingestion` | Módulo de ingesta ERP |
 | `all` | Todo (por defecto) |
 
 **Ejemplos:**
@@ -530,20 +568,34 @@ mi-cli/
 
 ### python-flet
 
-Plantilla GUI de escritorio con **Flet** (flask-like para Flutter).
+Plantilla GUI de escritorio con **Flet** para apps de contexto ERP.
 
 ```
 mi-app/
 ├── src/
-│   ├── main.py
-│   └── core/
-│       └── skill.json
-├── requirements.txt
+│   ├── main.py                  ← Punto de entrada con IngestionPanel integrado
+│   ├── core/
+│   │   ├── ingestion.py         ← Normalizador de datos ERP
+│   │   ├── g360_theme.py        ← Tema visual G360
+│   │   └── skill.json
+│   ├── ui/
+│   │   └── ingestion_panel.py   ← Panel Flet para carga .xls/.xlsx
+│   └── export/
+│       └── __init__.py
+├── pyproject.toml                ← Dependencias: flet, pandas, g360-core
 ├── run.bat
-├── build-portable.bat
+├── build.bat
 └── skill.json
 ```
 
+**Normalización de datos:** La ingesta aplica 16 transformaciones automáticas:
+- Parseo de referencias (`F01/201-243065` → tipo, serie, periodo, número)
+- Separación de sucursales (nombre + dirección)
+- Clasificación de documentos (RUC 11 dígitos / DNI 8 dígitos)
+- Normalización monetaria con auto-detección de formato SAP/Spring
+- Cantidad + Cantidad FAE → cantidad_total + tipo_transaccion
+- Purga de filas total/general/acumulado
+
 ### python-flet-migrate
 
 Plantilla para migrar aplicaciones Tkinter/CTkinter a Flet.
@@ -749,9 +801,12 @@ g360-cli/
 │   └── assets/          # Assets embebidos
 │       ├── templates/    # Plantillas de proyecto
 │       ├── components/   # Componentes G360
-│       ├── skills/      # Skills de identidad
+│       ├── ingestion/    # Módulo de ingesta ERP (bring)
 │       ├── engine/      # G360 Engine
 │       └── config/      # Configuraciones
+├── py/                  # Paquete Python publicable en PyPI
+│   ├── pyproject.toml   # g360-core
+│   └── src/g360_core/   # ingestion.py + flet/ingestion_panel.py
 ├── package.json
 ├── README.md
 └── LICENSE
@@ -765,7 +820,7 @@ g360-cli/
 |---------|-------------|
 | `npm run build` | Build portable con pkg (g360.exe) |
 | `npm run build:portable` | Especificar target node18-win-x64 |
-| `npm test` | Ejecutar tests (actualmente placeholder) |
+| `npm test` | Ejecutar tests con Vitest (51 tests, 7 suites) |
 | `npm run prepublishOnly` | Validación antes de publicar en npm |
 
 ---
@@ -773,10 +828,16 @@ g360-cli/
 ## Testing
 
 ```bash
-npm test
+npm test            # Vitest — 51 tests, 8 suites
+npm run test:watch  # Modo watch
+npm run test:ui     # UI interactiva
+npm run test:coverage
 ```
 
-Actualmente configurado con un placeholder. Próximamente se integrará con Vitest para testing de comandos y utilidades.
+**Cobertura actual (v1.7.0):**
+- `commands/`: init, bring, list, audit, set-skill
+- `lib/`: manifest, validator, asset-validator
+- **51 passing / 1 timeout** (init.test.js requiere import pesado de inquirer)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "g360-cli",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "CLI tool for bootstrapping G360 projects with standardized structure, assets, and identity",
   "type": "module",
   "main": "src/cli.js",

package/py/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "g360-core"
+version = "0.1.0"
+description = "G360 ERP data ingestion engine — normalize .xls/.xlsx from SAP, StarSoft, Spring"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+    { name = "ccusi", email = "ccusi@cipsa.com.pe" },
+]
+keywords = ["g360", "erp", "data", "normalization", "flet"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+]
+
+dependencies = [
+    "pandas>=2.0.0",
+    "numpy>=1.24.0",
+    "openpyxl>=3.1.0",
+    "xlrd>=2.0.0",
+]
+
+[project.optional-dependencies]
+flet = ["flet>=0.25.0"]
+
+[project.urls]
+Homepage = "https://github.com/ccusi/g360-cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/g360_core"]

package/py/src/g360_core/__init__.py

@@ -0,0 +1,7 @@
+from g360_core.ingestion import estabilizar_excel_crudo, _MAPA_TPO_DOC, _MAPA_MESES
+
+__all__ = [
+    "estabilizar_excel_crudo",
+    "_MAPA_TPO_DOC",
+    "_MAPA_MESES",
+]

package/py/src/g360_core/flet/__init__.py

@@ -0,0 +1,3 @@
+from g360_core.flet.ingestion_panel import IngestionPanel
+
+__all__ = ["IngestionPanel"]

package/py/src/g360_core/flet/ingestion_panel.py

@@ -0,0 +1,218 @@
+import threading
+from pathlib import Path
+
+import flet as ft
+import pandas as pd
+
+from g360_core.ingestion import estabilizar_excel_crudo
+
+
+class IngestionPanel(ft.Container):
+    def __init__(self, theme, on_data_loaded=None):
+        super().__init__()
+        self.theme = theme
+        self.on_data_loaded = on_data_loaded
+        self.df: pd.DataFrame | None = None
+        self.metadata: dict | None = None
+        self._build()
+
+    def _build(self):
+        self.file_picker = ft.FilePicker(on_result=self._on_file_result)
+        self.status_text = ft.Text(
+            "Selecciona un archivo .xls o .xlsx del ERP",
+            size=14,
+            color=self.theme.muted,
+        )
+        self.stats_container = ft.Column(spacing=4, visible=False)
+        self.alertas_container = ft.Column(spacing=2, visible=False)
+        self.preview_table = ft.Column(scroll=ft.ScrollMode.AUTO, visible=False)
+
+        self.content = ft.Column(
+            controls=[
+                self.file_picker,
+                ft.Row(
+                    controls=[
+                        self.theme.accent_button(
+                            text="Cargar Archivo Excel",
+                            on_click=self._open_picker,
+                        ),
+                        ft.Container(width=12),
+                        self.status_text,
+                    ],
+                    alignment=ft.MainAxisAlignment.START,
+                    vertical_alignment=ft.CrossAxisAlignment.CENTER,
+                ),
+                ft.Container(height=12),
+                self.stats_container,
+                ft.Container(height=8),
+                self.alertas_container,
+                ft.Container(height=8),
+                self.preview_table,
+            ],
+            spacing=0,
+        )
+        self.bgcolor = self.theme.surface
+        self.border_radius = self.theme.rounded
+        self.padding = 20
+        self.expand = True
+
+    def _open_picker(self, e):
+        self.file_picker.pick_files(
+            file_type=ft.FilePickerFileType.CUSTOM,
+            allowed_extensions=["xls", "xlsx", "xlsm"],
+            dialog_title="Seleccionar reporte del ERP",
+        )
+
+    def _on_file_result(self, e: ft.FilePickerResultEvent):
+        if not e.files:
+            self.status_text.value = "No se selecciono ningun archivo."
+            self.status_text.color = self.theme.warning
+            self.update()
+            return
+
+        archivo = e.files[0]
+        ruta = archivo.path
+        nombre = archivo.name
+        self.status_text.value = f"Procesando: {nombre}..."
+        self.status_text.color = self.theme.text
+        self.update()
+
+        self._show_loading(True)
+
+        def _procesar():
+            try:
+                df, metadata = estabilizar_excel_crudo(ruta)
+                self.df = df
+                self.metadata = metadata
+                self._mostrar_resultado(df, metadata, nombre)
+                if self.on_data_loaded:
+                    self.on_data_loaded(df, metadata)
+            except Exception as exc:
+                self.status_text.value = f"Error: {exc}"
+                self.status_text.color = self.theme.error
+                self._show_loading(False)
+                self.update()
+
+        thread = threading.Thread(target=_procesar, daemon=True)
+        thread.start()
+
+    def _show_loading(self, visible: bool):
+        pass
+
+    def _mostrar_resultado(self, df: pd.DataFrame, metadata: dict, nombre: str):
+        self.status_text.value = f"OK: {nombre} ({len(df):,} filas)"
+        self.status_text.color = self.theme.success
+
+        columnas = metadata.get("columnas_finales", metadata.get("columnas", []))
+        transformaciones = metadata.get("transformaciones", [])
+        alertas = metadata.get("alertas", [])
+        columnas_nuevas = metadata.get("columnas_nuevas", [])
+
+        self.stats_container.controls = [
+            ft.Text("Resumen de Ingesta", size=16, weight=ft.FontWeight.BOLD, color=self.theme.text),
+            ft.Text(f"Filas estabilizadas: {len(df):,}", size=13, color=self.theme.muted),
+            ft.Text(f"Columnas originales: {metadata.get('filas_originales', 0)}", size=13, color=self.theme.muted),
+            ft.Text(f"Columnas finales: {len(columnas)}", size=13, color=self.theme.muted),
+            ft.Text(f"Archivo: {metadata.get('archivo', 'N/A')}", size=13, color=self.theme.muted),
+            ft.Text(f"Moneda: {metadata.get('moneda', 'N/A')}", size=13, color=self.theme.muted),
+            ft.Divider(color=self.theme.bg, height=8),
+        ]
+
+        if columnas_nuevas:
+            nuevas_text = ft.Text(
+                "Columnas derivadas:",
+                size=13, weight=ft.FontWeight.BOLD, color=self.theme.accent,
+            )
+            chips = ft.Row(
+                controls=[
+                    ft.Container(
+                        content=ft.Text(col, size=10, color=self.theme.bg),
+                        bgcolor=self.theme.accent,
+                        border_radius=12,
+                        padding=ft.padding.only(left=8, right=8, top=3, bottom=3),
+                    )
+                    for col in columnas_nuevas
+                ],
+                spacing=6,
+                wrap=True,
+            )
+            self.stats_container.controls.extend([nuevas_text, chips])
+
+        if transformaciones:
+            self.stats_container.controls.append(
+                ft.Divider(color=self.theme.bg, height=8)
+            )
+            self.stats_container.controls.append(
+                ft.Text("Transformaciones:", size=13, weight=ft.FontWeight.BOLD, color=self.theme.text)
+            )
+            for t in transformaciones[-8:]:
+                self.stats_container.controls.append(
+                    ft.Row(
+                        controls=[
+                            ft.Container(
+                                content=ft.Text(">", size=11, color=self.theme.accent),
+                                width=16,
+                            ),
+                            ft.Text(t, size=11, color=self.theme.muted),
+                        ],
+                        spacing=0,
+                    )
+                )
+
+        self.stats_container.visible = True
+
+        if alertas:
+            self.alertas_container.controls = [
+                ft.Divider(color=self.theme.bg, height=4),
+                ft.Text("Alertas:", size=13, weight=ft.FontWeight.BOLD, color=self.theme.warning),
+            ]
+            for a in alertas:
+                self.alertas_container.controls.append(
+                    ft.Row(
+                        controls=[
+                            ft.Icon(ft.icons.WARNING_AMBER_ROUNDED, size=14, color=self.theme.warning),
+                            ft.Text(a, size=11, color=self.theme.warning),
+                        ],
+                        spacing=4,
+                    )
+                )
+            self.alertas_container.visible = True
+
+        filas_preview = df.head(5)
+        columnas_preview = columnas[:8]
+
+        data_rows = []
+        for _, row in filas_preview.iterrows():
+            cells = []
+            for col in columnas_preview:
+                val = row.get(col, "")
+                v_str = str(val)[:30] if not pd.isna(val) else "-"
+                cells.append(
+                    ft.DataCell(ft.Text(v_str, size=10, color=self.theme.text))
+                )
+            data_rows.append(ft.DataRow(cells=cells))
+
+        header_cells = [
+            ft.DataColumn(ft.Text(col[:16], size=10, color=self.theme.accent, weight=ft.FontWeight.BOLD))
+            for col in columnas_preview
+        ]
+
+        tabla = ft.DataTable(
+            columns=header_cells,
+            rows=data_rows,
+            heading_text_color=self.theme.accent,
+            horizontal_margin=4,
+            column_spacing=16,
+        )
+
+        self.preview_table.controls = [
+            ft.Text("Vista previa (5 primeras filas):", size=13, weight=ft.FontWeight.BOLD, color=self.theme.text),
+            ft.Container(
+                content=tabla,
+                bgcolor=self.theme.bg,
+                border_radius=8,
+                padding=8,
+            ),
+        ]
+        self.preview_table.visible = True
+        self.update()