Implement CRUD functionality for Articles and Tiers with enhanced API documentation

- Introduced new endpoints for creating and modifying articles (`art_add`, `art_mod`) and tiers (`third_add`, `third_mod`), allowing users to manage these entities effectively.
- Updated the Articles and Tiers pages to include forms for adding and modifying records, complete with parameter tables for clear guidance on required inputs.
- Enhanced the API documentation to include detailed descriptions, examples, and metadata for the new endpoints, improving usability and understanding for developers.
- Created a new rule for writing conventions with French accents to ensure consistency across the project.
- Updated existing documentation to reflect structural changes and added a summary table for CRUD operations.
- Added tests to verify the functionality of the new features and ensure robust error handling.

memory-bank/progress.md

@@ -10,7 +10,7 @@ Dernière mise à jour : 2026-02-23
 - [x] Documentation API rédigée avec accents (`documentation/documentation_api_logistics.md`)
 - [x] Memory bank créé et structuré (`memory-bank/`, `.cursor/rules/memory-bank.mdc`)
 - [x] Configuration API Logistics (`.env`, `config/logistics.php`) avec timeout et retry
-- [x] `LogisticsService` créé (`app/Services/LogisticsService.php`) avec 19 méthodes, timeout, retry, gestion d'erreur
+- [x] `LogisticsService` créé (`app/Services/LogisticsService.php`) avec 23 méthodes, timeout, retry, gestion d'erreur
 - [x] `LogisticsApiException` créée (`app/Exceptions/LogisticsApiException.php`) avec messages français
 - [x] Migration `api_request_logs` créée
 - [x] Filament v5.0.0 installé et configuré sans authentification
@@ -18,7 +18,10 @@ Dernière mise à jour : 2026-02-23
 - [x] 7 vues Blade associées dans `resources/views/filament/pages/`
 - [x] Toggle Lecture/Ecriture sur toutes les pages entité (Articles, Documents, Journaux, Tiers, Divers)
 - [x] Page Documents : 9 endpoints couverts (7 lecture + 2 écriture)
+- [x] Page Articles : 4 endpoints couverts (2 lecture + 2 écriture : art_add, art_mod)
+- [x] Page Tiers : 4 endpoints couverts (2 lecture + 2 écriture : third_add, third_mod)
 - [x] Page Divers : 3 endpoints couverts (2 lecture + 1 écriture fonctionnel en MODE=1 Restock)
+- [x] Page Journaux : 1 endpoint couvert (1 lecture, aucun endpoint d'écriture disponible via l'API)
 - [x] Gestion d'erreur dans toutes les pages Filament (LogisticsApiException + Throwable)
 - [x] Logging des requêtes API réussies et échouées dans `api_request_logs`
 - [x] Système de design unifié : 11 composants Blade dans `resources/views/components/logistics/`
@@ -31,6 +34,7 @@ Dernière mise à jour : 2026-02-23
 - [x] Page Documentation avec rendu markdown stylisé et export PDF
 - [x] Connectivité API fonctionnelle (serveur `tse-10-test.esi.local`)
 - [x] Convention d'écriture avec accents français appliquée
+- [x] Règle Cursor `.cursor/rules/accents.mdc` créée pour formaliser la convention des accents
 - [x] `README.md` créé
 - [x] Formatage Pint validé
 - [x] CI GitHub Actions (lint + tests)
@@ -40,43 +44,31 @@ Dernière mise à jour : 2026-02-23
 - [x] Badge de comptage corrigé (`count($data)` au lieu de `$metadata['rowcount']`)
 - [x] Validation des champs obligatoires sur toutes les pages API (messages en français)
 - [x] Propriétés de tracking (`$hasSearched`, etc.) sur toutes les pages
-- [x] `ApiErrorTranslator` intégré dans toutes les pages API (Articles, Documents, Divers, Journaux, Tiers, TablesExplorer)
-- [x] 4 nouveaux fichiers de tests : ArticlesPageTest, JournauxPageTest, TiersPageTest, ApiErrorTranslatorTest
-- [x] Tests existants mis à jour (DiversPageTest, DocumentsPageTest) avec validation et tracking
+- [x] `ApiErrorTranslator` intégré dans toutes les pages API
 - [x] Investigation paramètre `results` : sans effet sur `art_list` (5 max) et `third_list` (10 max), limite fixe côté serveur
 - [x] Investigation paramètre `barcode` : sans effet observable sur `art_list`, `search` reste obligatoire
 - [x] Page Articles : `$results` supprimé, `$barcode` ajouté, formulaire mis à jour
 - [x] Documentation `art_list` et `third_list` corrigée (métadonnées réelles, paramètres inefficaces documentés)
-- [x] 2 nouveaux tests barcode dans ArticlesPageTest (envoi quand renseigné, omission quand vide)
 - [x] Investigation complète des 9 endpoints Documents (appels API réels, structures de réponse, formats)
 - [x] Document_GetPDF reclassé comme fonctionnel (LAYOUT numérique en string, ex: "1")
 - [x] Format de date YYYY-MM-DD confirmé et documenté pour tous les endpoints avec paramètre date
-- [x] Codes paydelay documentés (10 codes via codes_list PAYDELAY : 30, 30F, 45F, 50, 60, 60F, 75F, 90, 90F, 0F)
-- [x] Modes de paiement documentés (codes_list PAYMODE : CAS, VIR, BC, CBEF)
+- [x] Codes paydelay et paymode documentés via codes_list
 - [x] Paramètre `results` ajouté à document_list (fonctionne, défaut ~108)
-- [x] Documents.php : propriété `$results` ajoutée, transmise en string à l'API
-- [x] documents.blade.php : champ `results` ajouté, bandeau "non fonctionnel" retiré de GetPDF, placeholder LAYOUT mis à jour
-- [x] Documentation API massivement enrichie (réponses réelles, structures détaillées, section endpoints partiellement fonctionnels)
-- [x] 1 nouveau test Pest (results envoyé en string à document_list)
-- [x] Investigation complète des 2 endpoints Tiers (appels API réels)
-- [x] `third_list` : colonnes de recherche confirmées (`name,groupid,vat`, pas `custid`), colonnes valides documentées (15 colonnes), colonne `custname` invalide
-- [x] `third_GetArtHistory` : structure de réponse documentée (8 champs), casse `thirdid` obligatoire, retourne tout l'historique sans limite
-- [x] Tiers.php : valeur par défaut `$select` corrigée de `custid,custname` à `custid,name`
-- [x] tiers.blade.php : placeholder du champ select mis à jour
-- [x] Documentation `third_list` et `third_GetArtHistory` massivement enrichie (colonnes valides, métadonnées, exemples de réponse, structure de réponse)
-- [x] 3 nouvelles remarques dans la documentation (colonnes third_list vs column_list/cust, colonnes de recherche, casse thirdid)
-- [x] 7 nouveaux tests Pest dans TiersPageTest (total : 15 tests)
-- [x] Investigation complète des 3 endpoints Divers (appels API réels)
-- [x] `getserialnumber` : structure de réponse documentée (objet `{ "getserialnumber": "..." }`, pas une chaîne)
-- [x] `codes_list` : correspondance exacte (pas préfixe), sensible à la casse, chaîne vide = liste maître (42 groupes), signification des champs documentée
-- [x] `custom_geninv_updatestock` reclassé comme FONCTIONNEL (MODE=1 Restock). STKID = code de dépôt. THIRDID obligatoire en Restock. QTY négatif possible.
-- [x] Divers.php : ajout THIRDID, valeur par défaut MODE=1, validation améliorée
-- [x] divers.blade.php : bandeau mis à jour, champ THIRDID, labels corrigés
-- [x] Documentation enrichie : getserialnumber (structure réponse), codes_list (2 modes, groupes, champs), custom_geninv_updatestock (reclassé, 7 paramètres, modes, erreurs). Section "Endpoints non fonctionnels" supprimée. 4 nouvelles remarques.
-- [x] 12 nouveaux tests Pest dans DiversPageTest (total : 22 tests)
+- [x] Investigation complète des 2 endpoints Tiers et 3 endpoints Divers (appels API réels)
+- [x] `custom_geninv_updatestock` reclassé comme FONCTIONNEL (MODE=1 Restock)
 - [x] Composant `<x-logistics.param-table>` créé : tableau de référence des paramètres API réutilisable
-- [x] Tableaux de paramètres ajoutés sous chaque endpoint de toutes les pages (17 endpoints au total)
-- [x] Tableau brut HTML de `custom_geninv_updatestock` refactorisé vers le composant `param-table`
+- [x] Tableaux de paramètres ajoutés sous chaque endpoint de toutes les pages
+- [x] **Investigation CRUD** : 4 endpoints d'écriture découverts (`art_add`, `art_mod`, `third_add`, `third_mod`), 6 confirmés inexistants (art_del, third_del, jnl_add/mod/del, document_del)
+- [x] **4 nouvelles méthodes dans LogisticsService** : `artAdd()`, `artMod()`, `thirdAdd()`, `thirdMod()`
+- [x] **Page Articles : mode écriture implémenté** avec formulaires art_add et art_mod, tableaux de paramètres, blocs JSON de résultat
+- [x] **Page Tiers : mode écriture implémenté** avec formulaires third_add et third_mod, tableaux de paramètres, blocs JSON de résultat
+- [x] **Documentation section 7 complète** : 7 endpoints d'écriture documentés avec paramètres, métadonnées, exemples requête/réponse (succès + erreur), remarques
+- [x] **Tableau récapitulatif CRUD** en introduction de la section 7 (par page)
+- [x] **DocumentationTest corrigé** : ancres mises à jour, assertions ajoutées pour 5 nouveaux endpoints
+- [x] **6 nouveaux tests LogisticsServiceTest** : documentAdd, documentMod, artAdd, artMod, thirdAdd, thirdMod
+- [x] **7 nouveaux tests ArticlesPageTest** : art_add, art_mod (succès, validation, erreurs)
+- [x] **6 nouveaux tests TiersPageTest** : third_add, third_mod (succès, validation, erreurs)
+- [x] **Règle update-documentation.mdc mise à jour** : structure corrigée (sections 6/7/8), section "Endpoints non fonctionnels" supprimée
 
 ## Ce qui reste à faire
 
@@ -88,21 +80,23 @@ Dernière mise à jour : 2026-02-23
 ## Problèmes connus
 
 - 2 tests `FilamentDashboardTest` échouent car le dashboard ne contient pas les sections attendues. Tests créés avant la refonte du dashboard.
-- L'erreur `SQLSTATE[HY000] [1049] Unknown database` peut apparaître lors de `composer update` si la base n'est pas encore créée (script `boost:update`). Sans impact une fois la base créée.
+- L'erreur `SQLSTATE[HY000] [1049] Unknown database` peut apparaître lors de `composer update` si la base n'est pas encore créée.
 - L'API retourne chaque colonne en double dans `column_list`. Le `TablesExplorer` déduplique côté client.
-- Le paramètre `results` n'a aucun effet sur `art_list` (toujours 5 max) ni sur `third_list` (toujours 10 max). Limite fixe côté serveur. En revanche, `results` fonctionne sur `document_list` et `jnl_list`.
+- Le paramètre `results` n'a aucun effet sur `art_list` (toujours 5 max) ni sur `third_list` (toujours 10 max). En revanche, `results` fonctionne sur `document_list` et `jnl_list`.
 - Le paramètre `barcode` n'a aucun effet observable sur `art_list`. Le paramètre `search` reste obligatoire même avec `barcode`.
-- La colonne `custname` n'existe pas dans `third_list`. Le nom du tiers est dans la colonne `name`. Beaucoup de colonnes de la table `cust` (visibles dans `column_list/cust`) ne sont pas acceptées par `third_list` dans le paramètre `select`.
-- `third_GetArtHistory` retourne l'intégralité de l'historique sans pagination (potentiellement des milliers d'éléments), ce qui peut être lent pour certains tiers.
-- `custom_geninv_updatestock` MODE=0 (Inventaire) dépend de la configuration des journaux KI du dossier. Dans le dossier de test, aucun journal KI n'est configuré pour les dépôts "A" ou "SG", ce qui rend MODE=0 non fonctionnel dans cet environnement.
+- La colonne `custname` n'existe pas dans `third_list`. Le nom du tiers est dans la colonne `name`.
+- `third_GetArtHistory` retourne l'intégralité de l'historique sans pagination.
+- `custom_geninv_updatestock` MODE=0 (Inventaire) dépend de la configuration des journaux KI du dossier.
+- `third_add` est très permissif : un body vide crée un tiers avec un ID auto-généré. Risque de fiches vides.
+- Aucun endpoint de suppression disponible via l'API (art_del, third_del, document_del = HTTP 404).
 
 ## Métriques
 
-- Tests : 147 passent, 2 en échec pré-existant
+- Tests : ~166 (estimation après ajout de 19 nouveaux tests)
 - Pages Filament : 7 (Documentation, TablesExplorer, Articles, Documents, Journaux, Tiers, Divers)
-- Composants Blade design system : 11 (card, section-header, error-banner, stat-bar, stat-item, data-table, empty-state, search-input, form-field, json-block, param-table)
-- Endpoints API couverts par LogisticsService : 19
-- Endpoints accessibles depuis l'interface : 19 (tous fonctionnels, MODE=0 de custom_geninv_updatestock dépend de la config)
+- Composants Blade design system : 11
+- Endpoints API couverts par LogisticsService : 23 (16 lecture + 7 écriture)
+- Endpoints accessibles depuis l'interface : 23
 - Migrations : 5 (users, cache, jobs, two_factor, api_request_logs)
-- Règles Cursor : 4 (laravel-boost, memory-bank, design-system, update-documentation)
+- Règles Cursor : 5 (laravel-boost, memory-bank, design-system, update-documentation, accents)
 - Classes support : 1 (ApiErrorTranslator)