nexusflex-mcp 3.74.0 → 3.75.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +33 -33
- package/docs.mjs +564 -562
- package/package.json +52 -52
- package/server.mjs +1569 -1560
- package/skills/control-por-foto/SKILL.md +75 -73
|
@@ -1,73 +1,75 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: control-por-foto
|
|
3
|
-
description: Control por foto de Nexus Flex — preparar las carpetas del día y cargar y cerrar lo que un nodo dio, recibió y repartió en un día, a partir de carpetas de fotos de etiquetas (DADOS/RECIBIDOS por día). Usar cuando el usuario quiere "hacer el control por foto", "controlar las fotos del día", "marcar lo que salió con los grupos/cadetes" o suelta carpetas de fotos de etiquetas de Mercado Libre. Requiere el MCP de Nexus Flex local (npx nexusflex-mcp) con escritura habilitada.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Control por foto (Nexus Flex)
|
|
7
|
-
|
|
8
|
-
Sirve para cualquier nodo y cualquiera de sus grupos logísticos. El servidor hace el trabajo foto por foto (lee el QR o la etiqueta con IA, busca o da de alta el envío sin duplicar, lo asigna y lo cierra en el día real, y le cuelga la foto). Vos guiás al usuario, mostrás lo que va a pasar y **no adivinás nada**: lo dudoso se pregunta.
|
|
9
|
-
|
|
10
|
-
## 0. Empezar: crear las carpetas
|
|
11
|
-
|
|
12
|
-
Cuando el usuario dice "hagamos el control por foto del día tal", corré:
|
|
13
|
-
|
|
14
|
-
`control_foto_preparar fechas:"<día o días>"`
|
|
15
|
-
|
|
16
|
-
Por seguridad, el MCP solo lee y crea adentro de **la carpeta del control por foto**: la que el usuario eligió al instalar el plugin (si no eligió, `Documentos\Control por foto`). `control_foto_estructura` te dice cuál es (`carpetaDelControl`). Las rutas se pasan relativas a ella (`Lunes 14-9-2026`); si el usuario tiene las fotos en otro lado, pedile que las mueva ahí: una ruta de afuera se rechaza.
|
|
17
|
-
|
|
18
|
-
Las fechas pueden ser un día (`14/09/2026`), un rango (`14/09 a 19/09`) o una lista (`14/09, 16/09`). Se crea una carpeta por día, con las subcarpetas de todos sus grupos y cadetes con el nombre exacto y un `LEEME.txt`. Decile dónde quedaron y que suelte cada foto en la carpeta que corresponde. Las que no use quedan vacías y no pasa nada.
|
|
19
|
-
|
|
20
|
-
## 1. Las carpetas
|
|
21
|
-
|
|
22
|
-
Una carpeta por día. El nombre tiene que traer la fecha (`Lunes 14-9-2026`, `14-09-2026`, `2026-09-14`). Adentro:
|
|
23
|
-
|
|
24
|
-
| Carpeta | Qué significa | Qué se hace |
|
|
25
|
-
|---|---|---|
|
|
26
|
-
| `DADOS/<grupo>/` | Lo que el nodo pasó a ese grupo | Se asigna al nodo responsable de la zona del destino en ese grupo |
|
|
27
|
-
| `DADOS/<cadete>/` | Lo repartió un cadete del nodo | Cadete asignado, Entregado |
|
|
28
|
-
| `RECIBIDOS/…/<cadete>/` | Otro nodo se lo dio y lo repartió ese cadete | Origen = nodo del vendedor → entrega = este nodo, por el grupo que comparten |
|
|
29
|
-
| `RECIBIDOS/<grupo>/<cadete>/` | Igual, pero llegó por ese grupo | Cuando el vendedor comparte varios grupos con el nodo |
|
|
30
|
-
| `RECIBIDOS/<grupo>/` | Se lo dieron y lo derivó por ese grupo | Cadena: vendedor → este nodo → responsable de ese grupo |
|
|
31
|
-
|
|
32
|
-
- Los nombres de `<grupo>` y `<cadete>` son los del nodo. Llamá a `control_foto_estructura` para tenerlos y mostrárselos al usuario la primera vez.
|
|
33
|
-
- Carpetas intermedias que no son grupo ni cadete (ej. `Matanza`, `1ra vuelta`) se ignoran.
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
- **
|
|
47
|
-
- **
|
|
48
|
-
- **
|
|
49
|
-
|
|
50
|
-
**
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
-
|
|
1
|
+
---
|
|
2
|
+
name: control-por-foto
|
|
3
|
+
description: Control por foto de Nexus Flex — preparar las carpetas del día y cargar y cerrar lo que un nodo dio, recibió y repartió en un día, a partir de carpetas de fotos de etiquetas (DADOS/RECIBIDOS por día). Usar cuando el usuario quiere "hacer el control por foto", "controlar las fotos del día", "marcar lo que salió con los grupos/cadetes" o suelta carpetas de fotos de etiquetas de Mercado Libre. Requiere el MCP de Nexus Flex local (npx nexusflex-mcp) con escritura habilitada.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Control por foto (Nexus Flex)
|
|
7
|
+
|
|
8
|
+
Sirve para cualquier nodo y cualquiera de sus grupos logísticos. El servidor hace el trabajo foto por foto (lee el QR o la etiqueta con IA, busca o da de alta el envío sin duplicar, lo asigna y lo cierra en el día real, y le cuelga la foto). Vos guiás al usuario, mostrás lo que va a pasar y **no adivinás nada**: lo dudoso se pregunta.
|
|
9
|
+
|
|
10
|
+
## 0. Empezar: crear las carpetas
|
|
11
|
+
|
|
12
|
+
Cuando el usuario dice "hagamos el control por foto del día tal", corré:
|
|
13
|
+
|
|
14
|
+
`control_foto_preparar fechas:"<día o días>"`
|
|
15
|
+
|
|
16
|
+
Por seguridad, el MCP solo lee y crea adentro de **la carpeta del control por foto**: la que el usuario eligió al instalar el plugin (si no eligió, `Documentos\Control por foto`). `control_foto_estructura` te dice cuál es (`carpetaDelControl`). Las rutas se pasan relativas a ella (`Lunes 14-9-2026`); si el usuario tiene las fotos en otro lado, pedile que las mueva ahí: una ruta de afuera se rechaza.
|
|
17
|
+
|
|
18
|
+
Las fechas pueden ser un día (`14/09/2026`), un rango (`14/09 a 19/09`) o una lista (`14/09, 16/09`). Se crea una carpeta por día, con las subcarpetas de todos sus grupos y cadetes con el nombre exacto y un `LEEME.txt`. Decile dónde quedaron y que suelte cada foto en la carpeta que corresponde. Las que no use quedan vacías y no pasa nada.
|
|
19
|
+
|
|
20
|
+
## 1. Las carpetas
|
|
21
|
+
|
|
22
|
+
Una carpeta por día. El nombre tiene que traer la fecha (`Lunes 14-9-2026`, `14-09-2026`, `2026-09-14`). Adentro:
|
|
23
|
+
|
|
24
|
+
| Carpeta | Qué significa | Qué se hace |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| `DADOS/<grupo>/` | Lo que el nodo pasó a ese grupo | Se asigna al nodo responsable de la zona del destino en ese grupo |
|
|
27
|
+
| `DADOS/<cadete>/` | Lo repartió un cadete del nodo | Cadete asignado, Entregado |
|
|
28
|
+
| `RECIBIDOS/…/<cadete>/` | Otro nodo se lo dio y lo repartió ese cadete | Origen = nodo del vendedor → entrega = este nodo, por el grupo que comparten |
|
|
29
|
+
| `RECIBIDOS/<grupo>/<cadete>/` | Igual, pero llegó por ese grupo | Cuando el vendedor comparte varios grupos con el nodo |
|
|
30
|
+
| `RECIBIDOS/<grupo>/` | Se lo dieron y lo derivó por ese grupo | Cadena: vendedor → este nodo → responsable de ese grupo |
|
|
31
|
+
|
|
32
|
+
- Los nombres de `<grupo>` y `<cadete>` son los del nodo. Llamá a `control_foto_estructura` para tenerlos y mostrárselos al usuario la primera vez.
|
|
33
|
+
- Carpetas intermedias que no son grupo ni cadete (ej. `Matanza`, `1ra vuelta`) se ignoran.
|
|
34
|
+
- El mismo paquete en `DADOS/…` y en `RECIBIDOS/…` el mismo día NO es un duplicado: te lo dieron y lo pasaste. Vale DADOS (cómo salió); RECIBIDOS es el respaldo por si algo no se registró y esa foto solo se suma al envío. No le preguntes al usuario por eso.
|
|
35
|
+
- Un grupo que solo sale ciertos días (ej. un "Sábado …") va como `DADOS/<ese grupo>`.
|
|
36
|
+
- Si las fotos vienen en `.zip`, descomprimilas antes. Las carpetas que empiezan con `_` se ignoran.
|
|
37
|
+
|
|
38
|
+
## 2. Simular primero (nunca escribir sin mostrar)
|
|
39
|
+
|
|
40
|
+
`control_foto_carpeta ruta:"<carpeta del día o de varios días>"`, sin `aplicar`.
|
|
41
|
+
|
|
42
|
+
Mostrá un resumen corto por día: fotos, ok, altas nuevas, preguntas y errores de carpeta. Si hay `zipsSinDescomprimir` o `fuera_de_DADOS_RECIBIDOS`, avisá.
|
|
43
|
+
|
|
44
|
+
## 3. Resolver las preguntas
|
|
45
|
+
|
|
46
|
+
- **cuentasMLDesconocidas**: preguntá de qué nodo y cliente es cada cuenta. Mostrá el vendedor, la marca a mano y la foto de ejemplo. Con el id del cliente: `control_foto_foto ruta:<foto> carpeta:<…> fecha:<…> cliente:<id>`. Si es un vendedor de otro nodo, puede vincular o aprender la cuenta ese nodo, y después se vuelve a correr la carpeta.
|
|
47
|
+
- **responsable** (la zona tiene varios responsables o ninguno): preguntá quién lo llevó y repetí la foto con `nodoEntrega`.
|
|
48
|
+
- **sin_codigo** (la etiqueta no tiene número: es un envío particular que imprimió el vendedor): leé la dirección de la foto (y localidad/destinatario si se ven) y repetí `control_foto_foto ruta:<foto> carpeta:<…> fecha:<…> direccion:<…> localidad:<…>` con `cliente:<id>` o `nodo:<…>` (el nodo que te lo dio, queda sin vendedor). Busca por dirección si ya está cargado; si no, lo carga con un tracking propio de Nexus Flex. Si la dirección no se lee, no la inventes: va a revisión manual.
|
|
49
|
+
- **duplicado / no_ml / fuera_de_red**: van a revisión manual. La foto quedó copiada en `<día>/_sin_identificar`.
|
|
50
|
+
- **erroresDeCarpeta**: una carpeta no coincide con un grupo o cadete del nodo. Que la renombren (con `control_foto_estructura` a la vista).
|
|
51
|
+
|
|
52
|
+
**Más cómodo:** al aplicar, lo dudoso se sube solo a la app, en **Logística → 📷 Control por foto**. Ahí cada foto se ve grande y se elige:
|
|
53
|
+
- el cliente (de cualquier nodo de la red);
|
|
54
|
+
- o el nodo que se lo dio;
|
|
55
|
+
- quién lo llevó, o la carpeta.
|
|
56
|
+
|
|
57
|
+
La opción "Recordar" asocia la cuenta de ML para la próxima vez. No la marques si el vendedor despacha con varias logísticas. En esa misma pantalla están los envíos **sin vendedor** del nodo (paquetes de otro nodo que escaneó un cadete), para asignarles el nodo o el cliente.
|
|
58
|
+
|
|
59
|
+
## 4. Aplicar
|
|
60
|
+
|
|
61
|
+
Con el OK del usuario: `control_foto_carpeta ruta:"<…>" aplicar:true`.
|
|
62
|
+
|
|
63
|
+
- Es reanudable: una foto ya procesada no se repite. Se puede correr de nuevo después de contestar preguntas.
|
|
64
|
+
- Cada paquete queda Entregado, con los estados fechados en el día real, su grupo, el nodo que entrega, el cadete y la foto en el historial (la que ven los nodos en su cuenta semanal).
|
|
65
|
+
- No toca envíos de fuera de la red del nodo, no crea duplicados y no reasigna lo que ya entró en un cierre semanal congelado. Lo nuevo de una semana ya cerrada entra en el cierre siguiente, marcado como tarde.
|
|
66
|
+
|
|
67
|
+
## 5. Cierre
|
|
68
|
+
|
|
69
|
+
Resumí por día lo que se cargó y lo que quedó en `_sin_identificar` con su motivo. El detalle completo queda en `<día>/_control-foto-<fecha>.json`.
|
|
70
|
+
|
|
71
|
+
## Reglas
|
|
72
|
+
|
|
73
|
+
- No mueve dinero: registra el movimiento y el traspaso entre nodos; los cierres y las liquidaciones los hace el sistema.
|
|
74
|
+
- No adivines un nodo, un cliente ni un responsable. Si no está claro, preguntá.
|
|
75
|
+
- Los Flex de cuentas vinculadas los cierra Mercado Libre: el control solo los asigna.
|