📄 DocForge API — Motor de Generación de Documentos PDF, Tirillas POS (80mm) & QR en Stream (Go 1.22)
DocForge API es un microservicio 100% Backend de ultra-baja latencia escrito en Go (Golang 1.22+) sin dependencias externas pesadas (CGO_ENABLED=0), diseñado para generar Facturas A4, Tirillas Térmicas POS (80mm y 58mm), Colillas de Pago de Nómina, Fórmulas Médicas y Códigos QR Vectoriales directamente en flujos de memoria (Memory Streams) sin escribir un solo archivo temporal en el disco duro.
Generar documentos PDF en arquitecturas tradicionales (levantando instancias de Chromium/Puppeteer o guardando archivos temporales en /tmp) agota rápidamente la memoria RAM y los IOPS del servidor cuando decenas de clientes descargan facturas o tirillas POS al mismo tiempo.
DocForge API resuelve este cuello de botella mediante:
- Renderizado Directo sobre
*bytes.Buffer(PDF 1.4 Native Stream Builder): Construye la tabla de referencias cruzadas (xref), fuentes vectoriales y flujos de contenido en memoria en< 0.3 mspor documento. - Reciclaje de Memoria con
sync.PoolyWorker PoolAcotado: Un pool de Goroutines con canales (chan renderJob) reutiliza los buffers de memoria ya reservados para evitar presión sobre el Garbage Collector de Go. - Sello Criptográfico de Integridad (
SHA-256+HMAC-SHA256): Cada PDF emitido incluye en las cabeceras HTTP (X-Document-SHA256,X-Document-HMAC,X-Render-Latency-Ms,X-Pool-Worker-Id) su huella criptográfica verificable enGET /api/v1/documents/verify/{hash}.
-
Template Method Pattern(internal/application/template/): Define el algoritmo invariante de generación documental (Validate$\rightarrow$ CreateGeometry$\rightarrow$ PopulateBuilder$\rightarrow$ WithSecurityFooter$\rightarrow$ WriteToBuffer), con implementaciones paraInvoiceA4Template,PosThermalTicketTemplate,PayrollStubTemplateyMedicalOrderTemplate. -
Abstract Factory Pattern(internal/domain/factory/): Provee las familias geométricas exactas paraA4_PORTRAIT(595x842 pt),THERMAL_80MM(226 pt) yTHERMAL_58MM(164 pt). -
Fluent Builder Pattern(internal/infrastructure/pdf/): Construcción fluida de encabezados, tablas e ítems sobre el stream PDF. -
Worker Pool + Object Pool Pattern(internal/application/pool/): Concurrencia controlada con canales ysync.Pool.
cp .env.example .env
docker compose up -d --build- Documentación Interactiva Scalar OpenAPI 3.1:
http://localhost:8086/(o/docs) - Health & Métricas del Worker Pool:
http://localhost:8086/api/v1/health