feat: Update .env.example and Docker Compose configurations to enhance service performance and health checks. Adjust OCR settings for improved document processing efficiency, and refine API Gateway health checks for better service monitoring. Revise desktop application documentation to reflect new API Gateway URL and installation instructions.

.env.example

@@ -37,11 +37,32 @@ REDIS_URL=redis://redis:6379/0
 IPS_DOCUMENT_ROOT=./data
 
 # ── Servicio de conteo (count-api) ────────────────────────
-OCR_DPI=300
+# OCR_DPI: resolución para Tesseract.
+#   300 = alta calidad (recomendado para documentos escaneados de baja calidad)
+#   150 = 4× más rápido, suficiente para la mayoría de facturas digitales
+#   Para procesar MILES de archivos se recomienda OCR_DPI=150
+OCR_DPI=150
 OCR_LANG=spa
-OCR_POOL_SIZE=4
+# OCR_POOL_SIZE y SYNC_PROCESS_CONCURRENCY: igualar al número de núcleos de CPU.
+# Ejemplo: máquina con 8 núcleos → OCR_POOL_SIZE=8, SYNC_PROCESS_CONCURRENCY=8
+# El frontend envía BATCH_CONCURRENCY=6 requests simultáneos × SYNC_PROCESS_CONCURRENCY archivos c/u.
+OCR_POOL_SIZE=8
 SYNC_MAX_FILES=50
-SYNC_PROCESS_CONCURRENCY=4
+SYNC_PROCESS_CONCURRENCY=8
+# Memoria para el contenedor count-api. Con 8 workers Tesseract se necesitan ~3 GB.
+COUNT_API_MEMORY=3g
 
 # ── Misc ──────────────────────────────────────────────────
 ALLOWED_DOCUMENT_TYPES=CC,TI,CE,RC,PA,PPT,PEP,EPT,NUIP
+
+# ── Desktop app (API Gateway) ─────────────────────────────
+# En Windows use 127.0.0.1 en lugar de localhost (evita colgar con IPv6).
+# La app desktop guarda esta URL en localStorage; valor por defecto: http://127.0.0.1:8189
+
+# ── Build paralelo (solo si falla docker compose up --build) ──────────────────
+# Compose v2.37+ usa Bake por defecto y lanza todos los builds en paralelo.
+# Si BuildKit se satura (error "frontend grpc server closed unexpectedly"),
+# desactivar Bake y limitar el paralelismo resuelve el problema.
+# Descomentar solo si se produce ese error.
+#COMPOSE_BAKE=false
+#COMPOSE_PARALLEL_LIMIT=2