g360-cli 1.12.0 → 1.13.0

package/README.md

@@ -1,11 +1,34 @@
 # g360-cli
 
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="src/assets/brand/g360/logotypes/logo-g360-light.svg">
+  <img alt="G360" height="64" src="src/assets/brand/g360/logotypes/logo-g360-dark.svg">
+</picture>
+
 > CLI tool for bootstrapping G360 projects with standardized structure, assets, and identity
 
 [![npm version](https://img.shields.io/npm/v/g360-cli?color=00d084&label=version)](https://www.npmjs.com/package/g360-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm downloads](https://img.shields.io/npm/dm/g360-cli?color=94a3b8)](https://www.npmjs.com/package/g360-cli)
 
+## ¿Cómo está organizado el proyecto?
+
+```mermaid
+flowchart TD
+    CLI["g360 CLI<br/>cli.js"]
+    CMD["Comandos<br/>init · bring · audit · ingest · scan · validate"]
+    LIB["Librerías<br/>manifest · auditor · validator · logger"]
+    ASSETS["Assets<br/>templates · brand · signature · ingestion"]
+    PY["g360-core (PyPI)<br/>commercial_engine · pipeline · batch_processor"]
+    ERP["Datos ERP<br/>.xls · .xlsx · .csv"]
+
+    CLI --> CMD
+    CMD --> LIB
+    CMD --> ASSETS
+    CMD --> PY
+    PY --> ERP
+```
+
 ## Tabla de Contenidos
 
 - [Descripción](#descripción)
@@ -20,6 +43,7 @@
 - [Configuración](#configuración)
 - [API](#api)
 - [Estructura](#estructura)
+- [Reglas de negocio](#reglas-de-negocio)
 - [Scripts](#scripts)
 - [Testing](#testing)
 - [Contribución](#contribución)
@@ -71,7 +95,7 @@ CLI tool para el ecosistema G360 que permite inicializar proyectos con estructur
 
 ## Versión
 
-**Current: v1.12.0** — [Ver en npm](https://www.npmjs.com/package/g360-cli)
+**Current: v1.13.0** — [Ver en npm](https://www.npmjs.com/package/g360-cli)
 
 ---
 
@@ -92,7 +116,7 @@ npm install -g g360-cli
 
 ```bash
 g360 --version
-# → 1.12.0
+# → 1.13.0
 
 g360 health
 ```
@@ -150,6 +174,7 @@ g360 init <nombre> [opciones]
 | `-d, --dir <ruta>` | Directorio destino | `.` |
 | `--dry-run` | Previsualizar sin crear | `false` |
 | `--force` | Sobrescribir existente | `false` |
+| `--brand` | Aplicar marca G360 (logo, colores, firma) después de init | `false` |
 
 **Ejemplos:**
 
@@ -165,6 +190,9 @@ g360 init mi-script --template svelte-web --skill minimalista
 
 # Preview sin crear
 g360 init mi-proyecto --dry-run
+
+# Crear proyecto con marca G360 aplicada automáticamente
+g360 init mi-proyecto --brand
 ```
 
 ---
@@ -343,14 +371,25 @@ Motor de lógica de negocio para clasificación documental. Única fuente de ver
 | `calculate_prices()` | PRECIO_BASE, RECARGO_UNITARIO, PRECIO_EFECTIVO |
 | `parse_referencia()` | Descompone REFERENCIA "F01/204-56287" en tipo/serie/número |
 
-**Clasificación de documentos:**
+**Clasificación de documentos** (`classify_base` → primero, `resolve_document_relationships` → después para AJUSTE):
+```
+TPO_DOC          CANTIDAD   →  CATEGORIA_OP   SUBTIPO_AJUSTE (cruce vs índice)
+F01/BDI/F03/...  cualquiera →  VENTA          —
+NC*              ≠ 0        →  DEVOLUCION     —
+NC*              = 0        →  AJUSTE         (ver reglas de cruce abajo)
+ND*              cualquiera →  AJUSTE         (ver reglas de cruce abajo)
 ```
-TPO_DOC  CANTIDAD  CANTIDAD_FAE  → CATEGORIA_OP  SUBTIPO_AJUSTE
-F01/BDI     ≠0         =           VENTA            —
-NCR         ≠0         =           DEVOLUCION       —
-NCR          0         ≠0          AJUSTE           PRECIO_LINEA / SIN_BASE
-NDB          0         ≠0          AJUSTE           CARGO_FIJO / SIN_BASE
+Subtipos de AJUSTE (`resolve_document_relationships` cruza `REFERENCIA` contra `build_invoice_index`):
 ```
+Clave con SKU coincide   CANTIDAD_FAE = 0            → CARGO_FIJO
+Clave con SKU coincide   CANTIDAD_FAE ≈ CANT_FACT    → PRECIO_LINEA
+Clave con SKU coincide   CANTIDAD_FAE < CANT_FACT    → PRECIO_PARCIAL
+Clave con SKU coincide   CANTIDAD_FAE > CANT_FACT    → SIN_BASE
+Clave no coincide        CANTIDAD_FAE = 1            → CARGO_FIJO
+Clave no coincide        CANTIDAD_FAE ≠ 1            → SIN_BASE
+Sin facturas en dataset  —                            → SIN_BASE (todo AJUSTE)
+```
+> Ver detalle completo en [`BUSINESS_RULES.md`](./BUSINESS_RULES.md).
 
 #### `batch_processor.py`
 
@@ -1091,6 +1130,94 @@ g360 addon remove @google/design.md
 
 ---
 
+### `g360 docs`
+
+Genera o actualiza la documentación del proyecto.
+
+```bash
+g360 docs [level] [opciones]
+```
+
+**Niveles:**
+
+| Nivel | Archivo generado | Descripción |
+|---|---|---|
+| `readme` (default) | `README.md` | Logo, diagrama Mermaid, quick start, identidad, firma |
+| `architecture` | `ARCHITECTURE.md` | Diagrama de arquitectura general + flujo de datos |
+| `business-rules` | `BUSINESS_RULES.md` | Reglas de negocio (solo Python con commercial_engine) |
+| `dependencies` | `docs/generated/dependencies.mmd` | Dependencias entre módulos |
+| `classes` | `docs/generated/classes.mmd` | Relaciones entre clases e interfaces |
+| `code-graph` | `docs/generated/code_graph.mmd` | Grafo de código (proyectos grandes) |
+| `all` | Todos los anteriores | Todos los niveles aplicables |
+
+**Opciones:**
+
+| Opción | Descripción | Valor por defecto |
+|--------|-------------|-------------------|
+| `--level <nivel>` | Nivel de documentación | `readme` |
+| `--project <ruta>` | Ruta del proyecto | `.` |
+| `--dry-run` | Previsualizar sin escribir | `false` |
+
+**Ejemplos:**
+
+```bash
+# Generar README con diagrama
+g360 docs
+
+# Generar toda la documentación
+g360 docs --level all
+
+# Generar BUSINESS_RULES para un proyecto Python
+g360 docs --level business-rules --project ./mi-proyecto
+
+# Previsualizar sin escribir
+g360 docs --level all --dry-run
+```
+
+---
+
+### `g360 lint`
+
+Revisa la consistencia de nomenclatura, detecta funciones duplicadas y verifica la sintaxis del proyecto.
+
+```bash
+g360 lint [level] [opciones]
+```
+
+**Niveles:**
+
+| Nivel | Qué revisa |
+|---|---|
+| `naming` | Nomenclatura de funciones, clases, variables y archivos |
+| `duplicates` | Funciones duplicadas con nombres iguales o diferentes |
+| `syntax` | Errores de sintaxis en archivos JS y Python |
+| `structure` | Archivos faltantes (README.md, skill.json, manifest) |
+| `all` (default) | Todas las anteriores |
+
+**Opciones:**
+
+| Opción | Descripción | Valor por defecto |
+|--------|-------------|-------------------|
+| `--level <nivel>` | Nivel de lint | `all` |
+| `--project <ruta>` | Ruta del proyecto | `.` |
+
+**Ejemplos:**
+
+```bash
+# Revisar todo el proyecto
+g360 lint
+
+# Solo revisar nomenclatura
+g360 lint --level naming
+
+# Revisar un proyecto específico
+g360 lint --project ./mi-proyecto
+```
+
+**Puntaje:** `g360 lint` asigna un puntaje de 0 a 100 basado en la cantidad de hallazgos.
+
+---
+
 ## Integración con OpenCode
 
 g360-cli incluye integración con **OpenCode** para desarrollo asistido por IA. Esta integración permite que los agentes de IA tengan acceso a los recursos de g360-cli durante el desarrollo.
@@ -1220,10 +1347,12 @@ Para mantener la integración con OpenCode actualizada:
 - [GitHub](https://github.com/carloscus/g360-cli)
 - [Documentación](#)
 - [Reportar Issue](https://github.com/carloscus/g360-cli/issues)
-
 ---
-**Marca**: G360
+
+**Marca**: G360 · Microherramientas para apoyo CRM y datos en escritorio
 **Isotipo**: 3 puntos verticales paralelos (gris-verde-gris) + chevron `>`
-**Autor**: Carlos Cusi
-**Desarrollo**: Con asistencia de herramientas de código IA (Vibe Code)
+**Signature**: G360 by ccusi (`mode: own`, definido en `brand/g360/signature`)
 **Powered by**: [g360-signature](https://github.com/carloscus/g360-signature)
+
+> Identidad generada desde `src/assets/brand/brand.json` (Brand System v2.0.0).
+> El logo arriba usa `<picture>` con `prefers-color-scheme` para light/dark.

package/package.json

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

package/src/assets/brand/brand.json

@@ -10,9 +10,7 @@
       "assets": {
         "logotypes": [
           "logotypes/logo-g360-dark.svg",
-          "logotypes/logo-g360-light.svg",
-          "logotypes/logo_g360_dark_b64.txt",
-          "logotypes/logo_g360_light_b64.txt"
+          "logotypes/logo-g360-light.svg"
         ],
         "favicons": {
           "svg": "favicons/favicon.svg",

package/src/assets/templates/ARCHITECTURE.md

@@ -0,0 +1,50 @@
+# ARCHITECTURE.md
+
+> Arquitectura del proyecto. Generado automaticamente por `g360 docs --level architecture`.
+
+## Arquitectura General
+
+```mermaid
+flowchart TD
+    subgraph Frontend["Frontend"]
+        Index["index.html / App"]
+        Main["Main entry"]
+        Components["Components"]
+        Styles["Styles"]
+    end
+    subgraph Assets["Assets"]
+        Brand["Brand / logo"]
+        Signature["Signature"]
+        Favicon["Favicon"]
+    end
+    subgraph Config["Config"]
+        Skill["skill.json"]
+        Manifest["manifest"]
+    end
+    Frontend --> Assets
+    Frontend --> Config
+```
+
+## Flujo de Datos
+
+```mermaid
+flowchart LR
+    INPUT["Entrada del usuario"] --> PROCESS["Procesamiento"]
+    PROCESS --> VALIDATE["Validacion"]
+    VALIDATE --> OUTPUT["Resultado"]
+    OUTPUT --> PERSIST["Persistencia"]
+```
+
+## Componentes
+
+| Componente | Responsabilidad |
+|---|---|
+| Entry point | Punto de inicio de la aplicacion |
+| Core | Logica de negocio y configuracion |
+| UI | Presentacion e interaccion con el usuario |
+| Assets | Recursos estaticos (imagenes, iconos, marca) |
+| Config | Archivos de configuracion (skill.json, manifest) |
+
+---
+
+*Generado por `g360 docs --level architecture`*

package/src/assets/templates/lit-web/README.md

@@ -0,0 +1,47 @@
+# Mi Proyecto G360
+
+<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">
+</picture>
+
+> Aplicacion web G360 con Lit Web Components
+
+## Quick Start
+
+```bash
+npm install
+npm run dev
+```
+
+## Estructura del Proyecto
+
+```mermaid
+flowchart TD
+    Frontend["Frontend<br/>Lit Web Components"]
+    Assets["Assets<br/>brand · signature · favicon"]
+    Config["Config<br/>skill.json"]
+
+    Frontend --> Assets
+    Frontend --> Config
+```
+
+## Identidad de Marca
+
+| Elemento | Valor |
+|---|---|
+| Marca | G360 |
+| Color primario | `#00d084` |
+| Signature mode | `powered` |
+| Signature text | "powered by G360" |
+
+## Footer
+
+```html
+<g360-signature mode="powered"></g360-signature>
+```
+
+---
+
+**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-cli/README.md

@@ -0,0 +1,47 @@
+# Mi Proyecto G360 CLI
+
+<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">
+</picture>
+
+> Aplicacion CLI G360 con Python y argparse
+
+## Quick Start
+
+```bash
+uv sync
+uv run python src/main.py --help
+```
+
+## Estructura del Proyecto
+
+```mermaid
+flowchart TD
+    CLI["CLI<br/>argparse"]
+    Core["Core<br/>business logic"]
+    Config["Config<br/>skill.json"]
+
+    CLI --> Core
+    CLI --> Config
+```
+
+## Identidad de Marca
+
+| Elemento | Valor |
+|---|---|
+| Marca | G360 |
+| Color primario | `#00d084` |
+| Signature mode | `powered` |
+| Signature text | "powered by G360" |
+
+## Footer
+
+```
+G360 by ccusi
+```
+
+---
+
+**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-customtkinter/README.md

@@ -1,48 +1,59 @@
-# G360 Python CustomTkinter App
+# Mi Proyecto G360 CustomTkinter
 
-## Estructura
+<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">
+</picture>
 
-```
-mi-proyecto/
-├── src/
-│   ├── main.py              # Entry point
-│   └── core/
-│       ├── skill.json       # Configuracion G360
-│       └── g360_theme.py    # Theme engine
-├── assets/images/
-├── skill.json
-├── pyproject.toml
-├── run.bat                  # Ejecutar app
-├── build.bat                # Build EXE (PyInstaller)
-└── README.md
-```
-
-## Requisitos
+> Aplicacion de escritorio G360 con CustomTkinter (tema oscuro)
 
-- **Python**: 3.11+ (instalado automaticamente por uv)
-- **uv**: https://docs.astral.sh/uv/
-
-## Ejecucion
+## Quick Start
 
 ```bash
-run.bat
+uv sync
+uv run python src/main.py
 ```
 
-## Build Windows
+## Estructura del Proyecto
 
-```bash
-build.bat
+```mermaid
+flowchart TD
+    UI["UI<br/>CustomTkinter"]
+    Core["Core<br/>business logic"]
+    Theme["Theme<br/>G360Theme"]
+
+    UI --> Core
+    UI --> Theme
 ```
 
-Genera `dist/G360-App.exe` usando PyInstaller.
+## Theme y Colores
 
-## Theme
+| Token | Color | Uso |
+|---|---|---|
+| `bg` | `#0b1220` | Fondo principal |
+| `surface` | `#1a2332` | Cards, contenedores |
+| `accent` | `#00d084` | Verde G360 primary |
+| `text` | `#f0f4f8` | Texto principal |
 
-Colores definidos en `src/core/skill.json`, cargados via `G360Theme`.
+## Identidad de Marca
 
-| Token | Color |
+| Elemento | Valor |
 |---|---|
-| `bg` | `#0b1220` |
-| `surface` | `#1a2332` |
-| `accent` | `#00d084` |
-| `text` | `#f0f4f8` |
+| Marca | G360 |
+| Color primario | `#00d084` |
+| Signature mode | `powered` |
+| Signature text | "powered by G360" |
+
+## Footer
+
+```python
+# Logo embebido como base64 (sin archivos externos)
+from core.g360_theme import G360Theme
+theme = G360Theme()
+logo = theme.logo_base64()
+```
+
+---
+
+**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/README.md

@@ -1,61 +1,37 @@
-# G360 Python Flet Desktop App
+# Mi Proyecto G360 Flet
 
-## Estructura del Proyecto
-
-```
-mi-proyecto/
-├── src/
-│   ├── main.py              # Entry point: ft.run(main)
-│   ├── core/
-│   │   ├── skill.json       # Configuracion del skill G360
-│   │   └── g360_theme.py    # Theme engine (lee colores de skill.json)
-│   ├── ui/
-│   │   └── __init__.py      # Componentes Flet (PascalCase)
-│   └── export/
-│       └── __init__.py      # Reportes Excel (openpyxl)
-├── assets/
-│   └── images/
-│       └── app.ico          # Icono de la app
-├── skill.json               # Skill G360 aplicado
-├── pyproject.toml           # Dependencias (uv sync)
-├── run.bat                  # Ejecutar app
-├── build.bat                # Build EXE standalone
-└── README.md
-```
-
-## Requisitos
+<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">
+</picture>
 
-- **Python**: 3.11+ (instalado automaticamente por uv)
-- **uv**: Gestor de paquetes Python (https://docs.astral.sh/uv/)
-- **Windows**: 10/11 x64
+> Aplicacion de escritorio G360 con Flet (ERP)
 
-## Ejecucion
+## Quick Start
 
-### Con uv (recomendado)
-```bash
-run.bat
-```
-
-### Manual
 ```bash
+uv sync
 uv run python src/main.py
 ```
 
-`uv run` detecta/instala Python y dependencias automaticamente.
-
-## Build Windows (EXE standalone)
+## Estructura del Proyecto
 
-```bash
-build.bat
+```mermaid
+flowchart TD
+    UI["UI<br/>Flet widgets"]
+    Core["Core<br/>business logic"]
+    Theme["Theme<br/>G360Theme"]
+    Export["Export<br/>openpyxl"]
+    Signature["Signature<br/>g360_signature"]
+
+    UI --> Core
+    UI --> Theme
+    Core --> Export
+    UI --> Signature
 ```
 
-Genera ejecutable en `build/windows/` usando `flet build`.
-
 ## Theme y Colores
 
-Los colores se definen en `src/core/skill.json` y se cargan via `G360Theme`.
-
-### Paleta G360
 | Token | Color | Uso |
 |---|---|---|
 | `bg` | `#0b1220` | Fondo principal |
@@ -63,27 +39,31 @@ Los colores se definen en `src/core/skill.json` y se cargan via `G360Theme`.
 | `accent` | `#00d084` | Verde G360 primary |
 | `text` | `#f0f4f8` | Texto principal |
 | `muted` | `#94a3b8` | Texto secundario |
-| `success` | `#22c55e` | Exito/positivo |
-| `warning` | `#f59e0b` | Advertencia |
-| `error` | `#ef4444` | Error/peligro |
-
-## Snippets Flet
-
-- `flet-page` - Configuracion de pagina con tema
-- `flet-card` - Tarjetas con estilo G360
-- `flet-button` - Botones G360
-- `flet-kpi-card` - Card de KPI para dashboards
-- `flet-drop-zone` - Zona de carga de archivos
-- `flet-datatable` - Tablas de datos
-- `flet-dialog` - Dialogos modales
-- `flet-loading-overlay` - Overlay de carga
-- `flet-footer-signature` - Footer con branding G360
 
 ## Lineamientos de Arquitectura
 
-1. **src/core/**: NO importa `flet`. Solo logica de negocio
-2. **src/ui/**: Importa `flet` y `core`. Solo presentacion
-3. **src/export/**: Importa `openpyxl` y `core`. Solo reportes
-4. **Threading**: Usar `threading.Thread` para operaciones bloqueantes
-5. **Estado**: Atributos de clase. Evitar variables globales
-6. **Colores**: Siempre via `G360Theme`. Nunca hardcodear
+1. **src/core/**: Solo logica de negocio, sin importar flet
+2. **src/ui/**: Importa flet y core. Solo presentacion
+3. **src/export/**: Importa openpyxl y core. Solo reportes
+4. **Colores**: Siempre via G360Theme. Nunca hardcodear
+
+## Identidad de Marca
+
+| Elemento | Valor |
+|---|---|
+| Marca | G360 |
+| Color primario | `#00d084` |
+| Signature mode | `own` |
+| Signature text | "G360 Desktop" |
+
+## Footer
+
+```python
+from core.components.g360_signature import g360_footer
+page.add(g360_footer())
+```
+
+---
+
+**Marca**: G360 · **Isotipo**: 3 puntos + chevron `>`
+**Signature**: G360 Desktop · **Powered by**: [g360-signature](https://github.com/carloscus/g360-signature)