Eduardo Dorado
28 lines
1.5 KiB
Markdown
28 lines
1.5 KiB
Markdown
# 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
|
|
```
|