Add processor heartbeat management and improve health check functionality

- Introduced processor heartbeat configuration in environment variables and Docker setup.
- Implemented heartbeat publishing in the processor worker.
- Enhanced health check endpoint to include processor availability status.
- Updated frontend components to handle processor unavailability messages.
- Added legacy return functionality in the upload panel.

stacks/faceai.yml

@@ -3,14 +3,20 @@ services:
     image: forgejo.maddoscientisto.net/maddo/faceai-client:latest
     container_name: regalami-faceai
     restart: unless-stopped
-    command: sh -c "mkdir -p /data/logs && npm run start >> /data/logs/backend.log 2>&1"
+    command:
+      - node
+      - docker/run-with-log-file.mjs
+      - /data/logs/backend.log
+      - npm
+      - run
+      - start
     environment:
       NODE_ENV: production
       PORT: 3001
       FACEAI_FRONTEND_URL: https://ai.regalamiunsorriso.it
       FACEAI_PUBLIC_BASE_URL: https://ai.regalamiunsorriso.it
       FACEAI_LEGACY_RETURN_URL: https://www.regalamiunsorriso.it/faceai_return.php
-      FACEAI_LEGACY_HOME_URL: https://www.regalamiunsorriso.it/
+      FACEAI_LEGACY_HOME_URL: https://www.regalamiunsorriso.it
       FACEAI_SHARED_SECRET: disagio-spaghetti-science-lol-boh
       FACEAI_SESSION_COOKIE: rus_faceai_session
       FACEAI_REDIS_URL: redis://redis:6379
@@ -19,21 +25,35 @@ services:
       FACEAI_UPLOAD_ROOT: /data/runtime/uploads
       FACEAI_LOG_ROOT: /data/logs
       FACEAI_PKL_ROOT: /data/pkl
+      FACEAI_PROCESSOR_HEARTBEAT_GRACE_MS: 20000
       FACEAI_ENABLE_LOCAL_LEGACY_STATIC: 0
     volumes:
-      - /var/docker/faceai/runtime:/data/runtime
-      - /var/docker/faceai/logs:/data/logs
+      - /mnt/storage/data/faceai/runtime:/data/runtime
+      - /mnt/storage/data/faceai/logs:/data/logs
       - /mnt/nas12/nas2/RUS:/data/pkl:ro
     ports:
-      - "127.0.0.1:3001:3001"
+      - "3001:3001"
+    healthcheck:
+      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3001/health').then(async (response) => { const payload = await response.json().catch(() => ({})); if (!response.ok || payload.ok !== true) { console.error(JSON.stringify(payload)); process.exit(1); } }).catch((error) => { console.error(error.stack || error.message); process.exit(1); })"]
+      interval: 10s
+      timeout: 5s
+      retries: 6
+      start_period: 20s
     depends_on:
-      - redis
+      redis:
+        condition: service_healthy
 
   processor:
     image: forgejo.maddoscientisto.net/maddo/faceai-processor:latest
     container_name: regalami-faceai-processor
     restart: unless-stopped
-    command: sh -c "mkdir -p /data/logs && npm run start:processor >> /data/logs/processor.log 2>&1"
+    command:
+      - node
+      - docker/run-with-log-file.mjs
+      - /data/logs/processor.log
+      - npm
+      - run
+      - start:processor
     environment:
       NODE_ENV: production
       FACEAI_REDIS_URL: redis://redis:6379
@@ -41,18 +61,26 @@ services:
       FACEAI_RUNTIME_ROOT: /data/runtime
       FACEAI_LOG_ROOT: /data/logs
       FACEAI_PKL_ROOT: /data/pkl
-      FACEAI_MATCHER_BINARY: /opt/face-recognition/face_matcher
-      FACEAI_WORKER_CONCURRENCY: 2
+      FACEAI_MATCHER_BINARY: /app/bin/face_matcher
+      FACEAI_PROCESSOR_HEARTBEAT_INTERVAL_MS: 5000
+      FACEAI_PROCESSOR_HEARTBEAT_TTL_SECONDS: 20
+      FACEAI_WORKER_CONCURRENCY: 8
       FACEAI_WORKER_TIMEOUT_MS: 300000
     volumes:
-      - /var/docker/faceai/runtime:/data/runtime
-      - /var/docker/faceai/logs:/data/logs
+      - /mnt/storage/data/faceai/runtime:/data/runtime
+      - /mnt/storage/data/faceai/logs:/data/logs
       - /mnt/nas12/nas2/RUS:/data/pkl:ro
     depends_on:
-      - redis
+      redis:
+        condition: service_healthy
 
   redis:
     image: redis:7-alpine
     container_name: regalami-faceai-redis
     restart: unless-stopped
-    command: redis-server --appendonly no
+    command: redis-server --appendonly no
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 12