zpl-pdf-microservice/AGENTS.md

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:

C:\Users\Dorado\Desktop\Pampero\Proyectos\zpl-pdf-microservice\node-v24.15.0\node.exe server.js