Update Tiers functionality and enhance API documentation
- Changed the default value of the `$select` property in Tiers.php from `custid,custname` to `custid,name` to reflect valid column names. - Updated the tiers.blade.php view to align the placeholder for the select field with the new default value. - Enhanced the documentation for the `third_list` and `third_GetArtHistory` endpoints, detailing valid search columns, metadata, and response structures. - Added new tests in TiersPageTest.php to verify the default select value, API parameter handling, and metadata storage. - Overall, improved the user experience and API interaction for managing tiers.
This commit is contained in:
@@ -31,7 +31,6 @@ 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] 84 tests Pest passent (205 assertions)
|
||||
- [x] `README.md` créé
|
||||
- [x] Formatage Pint validé
|
||||
- [x] CI GitHub Actions (lint + tests)
|
||||
@@ -59,26 +58,36 @@ Dernière mise à jour : 2026-02-23
|
||||
- [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)
|
||||
|
||||
## Ce qui reste à faire
|
||||
|
||||
- [ ] Corriger les 2 tests pré-existants `FilamentDashboardTest`
|
||||
- [ ] Corriger le test pré-existant `FilamentDashboardTest`
|
||||
- [ ] Vérifier le rendu visuel de toutes les pages avec de vraies données API
|
||||
- [ ] Éventuellement : pagination / tri côté client pour les grands tableaux
|
||||
- [ ] Éventuellement : page de consultation des logs API
|
||||
|
||||
## Problèmes connus
|
||||
|
||||
- 2 tests `FilamentDashboardTest` échouent car le dashboard ne contient pas les sections attendues. Tests créés avant la refonte du dashboard.
|
||||
- 1 test `FilamentDashboardTest` échoue car le dashboard ne contient pas les sections attendues. Test créé 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'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 `barcode` n'a aucun effet observable sur `art_list`. Le paramètre `search` reste obligatoire même avec `barcode`.
|
||||
- L'endpoint `custom_geninv_updatestock` reste non fonctionnel (paramètre STKID inconnu).
|
||||
- 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.
|
||||
|
||||
## Métriques
|
||||
|
||||
- Tests : 125 passent, 2 en échec pré-existants
|
||||
- Tests : 134 passent, 1 en échec pré-existant
|
||||
- Pages Filament : 7 (Documentation, TablesExplorer, Articles, Documents, Journaux, Tiers, Divers)
|
||||
- Composants Blade design system : 10
|
||||
- Endpoints API couverts par LogisticsService : 19
|
||||
|
||||
Reference in New Issue
Block a user