feat: initial zpl pdf microservice

2026-05-21 09:34:45 -03:00
commit 46ed03ac31
6 changed files with 2057 additions and 0 deletions
@@ -0,0 +1,27 @@
+# ZPL to PDF Microservice - Agent Orchestration
+
+Este microservicio actúa como un sidecar local para el ecosistema GT:Sync / Pampero. Resuelve la incompatibilidad de versiones de Node.js en el backend principal (Next.js con Node 12), renderizando etiquetas ZPL a formato PDF de forma aislada y 100% offline utilizando un entorno gráfico simulado en memoria.
+
+## Infraestructura y Ejecución
+
+- **Puerto del servicio:** `3040`
+- **Host:** `127.0.0.1` (Localhost)
+- **Motor Node:** Binario aislado (v24.15.0) para no afectar el PATH global.
+- **Core Stack:** `fastify` (Web Server), `zpl-js` (Parser), `canvas` (Render gráfico), `jspdf` (Exportación binaria).
+
+## Control De Versiones
+
+- **Repositorio oficial Gitea:** `https://gitea.globaltechscm.com/gt-microservices/zpl-pdf-microservice.git`
+- Este microservicio usa Gitea, no Bonobo. Para este proyecto, configurar siempre `origin` contra el remoto Gitea anterior.
+- No versionar `node_modules/`, `.cache/` ni el runtime local `node-v24.15.0/`. El runtime aislado se instala/restaura localmente en la ruta documentada abajo.
+
+### Ruta Absoluta del Intérprete
+Para ejecutar el servidor o instalar paquetes a través de PM2 o consola, se DEBE utilizar obligatoriamente la siguiente ruta absoluta:
+`C:\Users\Dorado\Desktop\Pampero\Proyectos\zpl-pdf-microservice\node-v24.15.0\node.exe`
+
+### Comandos de Gestión (Usar CMD/PowerShell)
+
+**Levantar el servicio manualmente:**
+```powershell
+C:\Users\Dorado\Desktop\Pampero\Proyectos\zpl-pdf-microservice\node-v24.15.0\node.exe server.js
+```