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.

tests/Feature/JournauxPageTest.php

@@ -0,0 +1,100 @@
+<?php
+
+use App\Filament\Pages\Journaux;
+use App\Models\User;
+use Illuminate\Support\Facades\Http;
+use Livewire\Livewire;
+
+beforeEach(function () {
+    config([
+        'logistics.base_url' => 'http://test-server.local',
+        'logistics.api_key' => 'test-api-key',
+        'logistics.folder' => 'testfolder',
+        'logistics.timeout' => 30,
+        'logistics.connect_timeout' => 10,
+        'logistics.retry.times' => 1,
+        'logistics.retry.sleep_ms' => 0,
+    ]);
+
+    $this->actingAs(User::factory()->create());
+});
+
+it('defaults to read mode', function () {
+    Livewire::test(Journaux::class)
+        ->assertSet('mode', 'read');
+});
+
+it('can switch between read and write modes', function () {
+    Livewire::test(Journaux::class)
+        ->set('mode', 'write')
+        ->assertSet('mode', 'write')
+        ->set('mode', 'read')
+        ->assertSet('mode', 'read');
+});
+
+it('shows validation error when TYPE is empty', function () {
+    Http::fake();
+
+    Livewire::test(Journaux::class)
+        ->call('searchJournaux')
+        ->assertSet('hasSearched', false)
+        ->assertSet('errorMessage', 'Le champ type de journal (TYPE) est obligatoire.');
+
+    Http::assertNothingSent();
+});
+
+it('searches journaux via jnl_list', function () {
+    Http::fake([
+        '*/jnl_list' => Http::response([
+            'data' => [['jnlid' => 'VEN', 'jnlname' => 'Ventes']],
+            'metadata' => ['rowcount' => 1, 'issuccess' => true],
+            'error' => null,
+        ]),
+    ]);
+
+    Livewire::test(Journaux::class)
+        ->set('type', 'V')
+        ->set('select', 'jnlid,jnlname')
+        ->call('searchJournaux')
+        ->assertSet('hasSearched', true)
+        ->assertSet('data', [['jnlid' => 'VEN', 'jnlname' => 'Ventes']])
+        ->assertSet('errorMessage', null);
+
+    Http::assertSent(function ($request) {
+        return str_contains($request->url(), 'jnl_list')
+            && $request->data()['TYPE'] === 'V';
+    });
+});
+
+it('sets hasSearched even when no results', function () {
+    Http::fake([
+        '*/jnl_list' => Http::response([
+            'data' => [],
+            'metadata' => ['rowcount' => 0, 'issuccess' => true],
+            'error' => null,
+        ]),
+    ]);
+
+    Livewire::test(Journaux::class)
+        ->set('type', 'Z')
+        ->call('searchJournaux')
+        ->assertSet('hasSearched', true)
+        ->assertSet('data', []);
+});
+
+it('displays error message on API failure', function () {
+    Http::fake([
+        '*/jnl_list' => Http::response([
+            'data' => null,
+            'metadata' => ['rowcount' => 0, 'issuccess' => false],
+            'error' => 'Invalid API key',
+        ]),
+    ]);
+
+    Livewire::test(Journaux::class)
+        ->set('type', 'V')
+        ->call('searchJournaux')
+        ->assertSet('hasSearched', true);
+
+    expect(true)->toBeTrue();
+});