feat: add processor service with Redis-backed job queue

- Introduced a new `processor` service in the Docker Compose setup to handle face matching jobs.
- Configured Redis as a job queue and state management system for processing searches.
- Updated the backend to enqueue jobs and manage user locks using Redis.
- Added environment variables for Redis configuration and runtime paths.
- Created technical design documentation for the processor service outlining architecture, queue model, and search lifecycle.
- Updated package.json and package-lock.json to include dependencies for BullMQ and ioredis in the processor workspace.
- Added sample PKL files for local testing in the `test_pkl` directory.

faceai/apps/frontend/src/views/HomeView.vue

@@ -46,6 +46,10 @@ const statusLabel = computed(() => {
     return `Ricerca completata. Trovate ${activeSearch.value.matchCount} foto corrispondenti.`;
   }
 
+  if (activeSearch.value.status === 'failed') {
+    return 'La ricerca non e stata completata. Verifica il messaggio di errore e riprova.';
+  }
+
   return 'Ricerca in corso. Il sistema aggiorna automaticamente lo stato finche il risultato non e pronto.';
 });
 
@@ -75,6 +79,12 @@ async function pollSearch(searchId) {
   }
 
   activeSearch.value = await response.json();
+  if (activeSearch.value.status === 'failed') {
+    isSubmitting.value = false;
+    errorMessage.value = activeSearch.value.errorMessage || 'The search failed.';
+    return;
+  }
+
   if (activeSearch.value.status === 'completed') {
     isSubmitting.value = false;
     const redirectResponse = await fetch(`/api/searches/${searchId}/redirect`, { credentials: 'include' });
@@ -108,16 +118,14 @@ async function submitSearch() {
 
   isSubmitting.value = true;
 
+  const formData = new FormData();
+  formData.set('raceId', session.value.race.id);
+  formData.set('selfie', selectedFile.value);
+
   const response = await fetch('/api/searches', {
     method: 'POST',
-    headers: {
-      'Content-Type': 'application/json'
-    },
     credentials: 'include',
-    body: JSON.stringify({
-      raceId: session.value.race.id,
-      selfieName: selectedFile.value.name
-    })
+    body: formData
   });
 
   const payload = await response.json();