saaim3-sync 2.0.0 → 2.0.2

package/README.md

@@ -1,36 +1,52 @@
-# saaim3batch
+# SaaiM3 Sync
 
-Batch que procesa los archivos **M/A/E** que genera la aduana (SAAI M3) para los pedimentos y los
-carga a Oracle. Antes vivía suelto como proyecto Eclipse/Ant; ahora es un módulo **Maven, Java 25**,
-que se distribuye como **fat jar**.
+App de escritorio (residente en la **bandeja del sistema**) que procesa los archivos **M/A/E** que
+genera la aduana (SAAI M3) y carga los pedimentos a **Oracle**. Módulo Maven **Java 25**, distribuido
+por **jDeploy** (paquete npm `saaim3-sync`, instaladores nativos con Java embebido y auto-update).
 
-## Build
+## Instalación (usuario final, Windows)
 
-```bash
-mvn -DskipTests package
-# genera target.tmp/saaim3batch-1.0.0.jar (fat jar autocontenido)
-```
+Descarga el instalador desde **https://www.jdeploy.com/~saaim3-sync** (elige Windows) y ejecútalo.
+Trae el runtime de Java incluido y crea el acceso directo **"SaaiM3 Sync"** con su ícono. Se
+autoactualiza solo (jDeploy) cuando se publica una versión nueva.
 
-## Ejecución
+> Equipos de aduana (Windows + Bitdefender): el launcher de jDeploy necesita las mismas exclusiones
+> de AV que InteliAduana (`%LOCALAPPDATA%\.jdeploy`, `client4j-*` en `%TEMP%`, y la carpeta de la app).
+> Como InteliAduana ya corre ahí, el entorno normalmente ya está listo.
 
-```bash
-java -jar target.tmp/saaim3batch-1.0.0.jar <directorio> [oficina] [debug]
-```
+## Uso
 
-- `<directorio>`: carpeta con los archivos `m*/a*/e*`. Los procesados se mueven a `Procesados/`
-  y los que fallan a `Errores/` (subcarpetas del mismo directorio).
-- `[oficina]`: p.ej. `sice_qa_mata` (o `qa_mata`). Si se omite, usa la `oficina.actual`.
-- `[debug]`: sube el nivel de log a DEBUG.
+La app vive en la bandeja (junto al reloj). Clic derecho = menú (Ejecutar ahora / Abrir / Pausar /
+Salir); doble clic = abrir la ventana. En **Configuración**:
 
-### Credenciales (broker, sin exposición)
+- **Carpeta** de los archivos M/A/E (selector nativo).
+- **Oficina** (la conexión a la BD se resuelve por **broker**; al cambiarla avisa para no mezclar
+  pedimentos de otra oficina). Si el equipo no tiene InteliAduana, pide una vez el **API key**.
+- **Ejecución**: al detectar archivos nuevos (watch, por defecto), cada N minutos, o manual.
+- **Iniciar con Windows** (opcional).
 
-Las credenciales de Oracle **ya no se pasan por línea de comandos**. Se obtienen del **credential
-broker** de InteliAduana: el batch lee el API key de la oficina en `~/.inteliaduana/broker.properties`
-(que la instalación de InteliAduana del mismo equipo ya gestiona) y pide al broker el host/sid/usuario/
-contraseña. Rotar la contraseña = editar el secreto del broker, sin recompilar.
+Botón **"Ejecutar ahora"** para procesar bajo demanda. La **consola** muestra los mensajes (también en
+`%USERPROFILE%\log\saaim3batch.log`). Los archivos se mueven a `Procesados/` o `Errores/`; si uno
+falla, llega un aviso por correo. La versión (del pom) se muestra en la ventana, la bandeja y los
+avisos, para identificar por screenshot qué versión corre cada equipo.
 
-## Logging
+## Credenciales
 
-SLF4J + Logback (`src/main/resources/logback.xml`): consola + archivo rotativo diario en
-`~/log/saaim3batch.log` (30 días de historia), con timestamp, nivel, hilo, clase y stack traces
-completos en los errores.
+Oracle **por broker** de InteliAduana (nada de credenciales en el equipo). El broker vive aparte
+(`~/git/inteliaduana-broker`); solo se comparte `~/.inteliaduana/broker.properties`.
+
+## Desarrollo / build
+
+```bash
+mvn -DskipTests package            # genera target.tmp/saaim3batch.jar (fat jar, mainClass AppBandeja)
+java -jar target.tmp/saaim3batch.jar   # corre la app (macOS/Windows) para probar
+```
+
+## Publicar una versión
+
+Sube `<version>` en `pom.xml` y `package.json` (deben coincidir), luego:
+
+```bash
+./deploy-jdeploy.sh                 # mvn package + jdeploy publish  (npm 'saaim3-sync')
+DRY_RUN=1 ./deploy-jdeploy.sh       # solo empaqueta, sin publicar
+```

package/jdeploy-bundle/jdeploy.js

@@ -3,7 +3,7 @@
 var path = require('path');
 var os = require('os');
 var jdeployHomeDir = process.env.JDEPLOY_HOME || path.join(os.homedir(), '.jdeploy');
-var jarName = "saaim3batch-2.0.0.jar";
+var jarName = "saaim3batch.jar";
 var mainClass = "{{MAIN_CLASS}}";
 var classPath = "{{CLASSPATH}}";
 var port = "0";

package/package.json

@@ -1 +1 @@
-{"license":"UNLICENSED","author":"Englobar","name":"saaim3-sync","description":"SaaiM3 Sync","files":["jdeploy-bundle"],"version":"2.0.0","jdeploy":{"jdk":false,"checksums":{"icon.png":"491aaf3020865e0e89b74609f93a9f0e"},"mainClass":"com.englobar.saaim3batch.AppBandeja","javaVersion":"25","winAppDir":"AppData\\Local\\Programs","jar":"target.tmp/saaim3batch-2.0.0.jar","javafx":false,"title":"SaaiM3 Sync"}}
+{"license":"UNLICENSED","author":"Englobar","name":"saaim3-sync","description":"SaaiM3 Sync","files":["jdeploy-bundle"],"version":"2.0.2","jdeploy":{"jdk":false,"checksums":{"icon.png":"491aaf3020865e0e89b74609f93a9f0e"},"mainClass":"com.englobar.saaim3batch.AppBandeja","javaVersion":"25","winAppDir":"AppData\\Local\\Programs","jar":"target.tmp/saaim3batch.jar","javafx":false,"title":"SaaiM3 Sync"}}