operx-cli 0.11.1__tar.gz → 0.13.0__tar.gz

{operx_cli-0.11.1/operx_cli.egg-info → operx_cli-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operx-cli
-Version: 0.11.1
+Version: 0.13.0
 Summary: La línea de comandos de OperX: tu empresa desde la terminal, con tu token de API.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -8,6 +8,7 @@ Requires-Dist: typer>=0.27
 Requires-Dist: httpx>=0.28
 Requires-Dist: keyring>=25
 Requires-Dist: openpyxl>=3.1
+Requires-Dist: paho-mqtt>=2.2
 Requires-Dist: prompt_toolkit>=3.0
 Provides-Extra: test
 Requires-Dist: pytest>=8; extra == "test"
@@ -224,8 +225,51 @@ operx connect mapear d-7f3k2m planta/comp2/temp --equipo "Compresor 2" --punto "
 operx connect silenciar d-7f3k2m planta/comp2/temp --hasta "05/11/2026 18:00" --motivo "Mantenimiento"
 ```
 
-Las claves de los dispositivos no pasan por el CLI: se crean y se ven en la
-app, en la pestaña Clave del dispositivo.
+Los indicadores de Connect (la pestaña Indicadores de la app):
+
+```
+operx connect estado --lugar "Planta Yumbo"                 # cada máquina por su punto peor ahora; --todas, también las que están bien
+operx connect fuera-de-rango --dias 7                        # las máquinas con más tiempo fuera de rango
+operx connect limite                                         # los puntos que se acercan a su límite, y en cuántos días
+operx connect disponibilidad --bajo-95                       # cuánto llegó de lo que debía enviar cada dispositivo
+operx connect horas --dias 30                                # horas de marcha por máquina, desde su horómetro
+operx connect informe --mes octubre --lugar "Planta Yumbo"   # el informe del mes
+operx connect informe --mes 2026-10 --pdf informe.pdf        # el mismo, en PDF
+```
+
+Comparar máquinas no tiene comando propio: `operx api GET connect/indicators/compare/ -q days=7`.
+
+Las claves de los dispositivos se crean y se ven solo en la app, en la
+pestaña Clave del dispositivo: el CLI no las crea ni las muestra.
+
+### Reenviar desde un computador de la planta
+
+`operx connect forward` corre en un computador de la planta, sin parar: lee el
+broker de la planta o una carpeta de archivos CSV y lo envía a OperX por HTTPS.
+Lo que no puede enviar queda en ese computador, en orden, hasta que vuelve
+internet.
+
+```sh
+operx connect forward "mqtt://localhost/planta/#"                   # el broker de la planta
+operx connect forward "mqtts://broker.planta:8883/planta/#" --usuario lector --ca ca.crt
+operx connect forward "C:\scada\exportes"                           # una carpeta de CSV
+```
+
+- Usa la clave de un dispositivo, no tu sesión: créalo en la app, en Agregar
+  dispositivo › «Computador de la planta» (hasta 300.000 valores al día). Ponla en la variable
+  `OPERX_DEVICE_KEY`, o te la pide sin mostrarla; nunca va como opción. La
+  clave del broker va en `OPERX_BROKER_CLAVE`.
+- Cada tema es un canal (`planta/comp2/temp`); en un JSON, cada clave va bajo
+  su tema. De cada canal envía el primer valor de cada minuto.
+- Un CSV lleva una columna Fecha y una columna por canal, o Fecha, Canal y
+  Valor. Lee lo nuevo de la carpeta cada 30 segundos.
+- Lo que espera queda en la carpeta de `operx` (o en el archivo de `--datos`),
+  hasta 2 millones de valores. Cada minuto escribe una línea con lo leído, lo
+  enviado y lo que espera.
+- Para que corra solo al prender el computador: el Programador de tareas de
+  Windows o un servicio de systemd, con la clave en `OPERX_DEVICE_KEY` y lo que
+  escribe guardado en un archivo. La guía «Desde un computador de la planta»
+  de Connect lo explica paso a paso.
 
 SG-SST y Ambiental van por empresa: sin `--empresa`, la de tu cuenta. Si
 llevas el SG-SST o lo ambiental de tus clientes, `operx sst empresas` y