Refactor error handling and enhance API interactions across Filament pages

- Introduced `ApiErrorTranslator` to normalize and translate API error messages, providing clearer feedback in French.
- Updated all Filament pages (Articles, Documents, Divers, Journaux, Tiers, TablesExplorer) to utilize the new error translation mechanism, improving user experience during API interactions.
- Added validation for required fields before API calls, ensuring users receive immediate feedback when mandatory inputs are missing.
- Implemented tracking properties to distinguish between "never searched" and "searched without results," enhancing the user interface.
- Removed the obsolete `$results` property from the Articles page and added a new `$barcode` property to align with API requirements.
- Updated documentation to reflect changes in API behavior and error handling, including new metadata returned by the `art_list` endpoint.
- Added new tests to verify the functionality of the barcode handling and validation logic.

app/Filament/Pages/Journaux.php

@@ -4,6 +4,7 @@ namespace App\Filament\Pages;
 
 use App\Exceptions\LogisticsApiException;
 use App\Services\LogisticsService;
+use App\Support\ApiErrorTranslator;
 use Filament\Pages\Page;
 use Filament\Support\Icons\Heroicon;
 
@@ -33,8 +34,20 @@ class Journaux extends Page
 
     public ?string $errorMessage = null;
 
+    public bool $hasSearched = false;
+
     public function searchJournaux(): void
     {
+        $this->errorMessage = null;
+
+        if (blank($this->type)) {
+            $this->errorMessage = 'Le champ type de journal (TYPE) est obligatoire.';
+
+            return;
+        }
+
+        $this->hasSearched = true;
+
         try {
             $service = app(LogisticsService::class);
 
@@ -48,12 +61,12 @@ class Journaux extends Page
 
             $this->data = $response['data'] ?? [];
             $this->metadata = $response['metadata'] ?? null;
-            $this->errorMessage = $response['error'] ?? null;
+            $this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
         } catch (LogisticsApiException $e) {
-            $this->errorMessage = $e->getMessage();
+            $this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
             $this->data = [];
         } catch (\Throwable $e) {
-            $this->errorMessage = "Erreur inattendue : {$e->getMessage()}";
+            $this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
             $this->data = [];
         }
     }