mpa/logisticsAPI
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
dfe20e79d720a852092ca56835508bc25cf4843e
logisticsAPI/memory-bank/progress.md
Marvin dfe20e79d7 Enhance Documents page functionality and update API documentation 
- Added a new `$results` property to the Documents page to allow users to specify the maximum number of results returned by the `document_list` endpoint, defaulting to ~108.
- Updated the `searchDocuments` method to include the `results` parameter in API requests, ensuring it is sent as a string.
- Modified the documents.blade.php view to include an input field for the `results` parameter, with appropriate placeholder text and guidance.
- Improved the documentation for the `document_list` endpoint to clarify the behavior of the `results` parameter and its interaction with `thirdid`.
- Updated the `Document_GetPDF` section to reflect its functionality and correct usage of the `LAYOUT` parameter.
- Added a new test to verify that the `results` parameter is correctly sent to the API.
- Overall, enhanced the user experience and API interaction for document management.
2026-02-23 11:24:57 +01:00

6.4 KiB
Raw Blame History

Progress

Dernière mise à jour : 2026-02-23

Ce qui fonctionne

  • Projet Laravel 12 initialisé (livewire-starter-kit)
  • Livewire 4 + Flux UI Free v2 installés
  • Fortify installé (authentification existante, non utilisée par Filament)
  • Documentation API rédigée avec accents (documentation/documentation_api_logistics.md)
  • Memory bank créé et structuré (memory-bank/, .cursor/rules/memory-bank.mdc)
  • Configuration API Logistics (.env, config/logistics.php) avec timeout et retry
  • LogisticsService créé (app/Services/LogisticsService.php) avec 19 méthodes, timeout, retry, gestion d'erreur
  • LogisticsApiException créée (app/Exceptions/LogisticsApiException.php) avec messages français
  • Migration api_request_logs créée
  • Filament v5.0.0 installé et configuré sans authentification
  • 7 pages Filament créées : Documentation, TablesExplorer, Articles, Documents, Journaux, Tiers, Divers
  • 7 vues Blade associées dans resources/views/filament/pages/
  • Toggle Lecture/Ecriture sur toutes les pages entité (Articles, Documents, Journaux, Tiers, Divers)
  • Page Documents : 9 endpoints couverts (7 lecture + 2 écriture)
  • Page Divers : 3 endpoints couverts (2 lecture + 1 écriture non fonctionnel)
  • Gestion d'erreur dans toutes les pages Filament (LogisticsApiException + Throwable)
  • Logging des requêtes API réussies et échouées dans api_request_logs
  • Système de design unifié : 10 composants Blade dans resources/views/components/logistics/
  • Convention de design documentée dans .cursor/rules/design-system.mdc
  • Toutes les pages Filament utilisent les composants x-logistics.*
  • Thème Filament personnalisé (resources/css/filament/admin/theme.css)
  • Plugin @tailwindcss/typography activé pour le rendu prose
  • Styles .documentation-prose personnalisés pour le dark mode
  • TablesExplorer amélioré : selectTable, déduplication colonnes, filtre, badges de types
  • Page Documentation avec rendu markdown stylisé et export PDF
  • Connectivité API fonctionnelle (serveur tse-10-test.esi.local)
  • Convention d'écriture avec accents français appliquée
  • 84 tests Pest passent (205 assertions)
  • README.md créé
  • Formatage Pint validé
  • CI GitHub Actions (lint + tests)
  • ApiErrorTranslator créé (app/Support/ApiErrorTranslator.php) : normalisation et traduction des erreurs API
  • Composant error-banner amélioré (supporte nl2br pour les explications)
  • Composant json-block amélioré (prop $searched + état vide)
  • Badge de comptage corrigé (count($data) au lieu de $metadata['rowcount'])
  • Validation des champs obligatoires sur toutes les pages API (messages en français)
  • Propriétés de tracking ($hasSearched, etc.) sur toutes les pages
  • ApiErrorTranslator intégré dans toutes les pages API (Articles, Documents, Divers, Journaux, Tiers, TablesExplorer)
  • 4 nouveaux fichiers de tests : ArticlesPageTest, JournauxPageTest, TiersPageTest, ApiErrorTranslatorTest
  • Tests existants mis à jour (DiversPageTest, DocumentsPageTest) avec validation et tracking
  • Investigation paramètre results : sans effet sur art_list (5 max) et third_list (10 max), limite fixe côté serveur
  • Investigation paramètre barcode : sans effet observable sur art_list, search reste obligatoire
  • Page Articles : $results supprimé, $barcode ajouté, formulaire mis à jour
  • Documentation art_list et third_list corrigée (métadonnées réelles, paramètres inefficaces documentés)
  • 2 nouveaux tests barcode dans ArticlesPageTest (envoi quand renseigné, omission quand vide)
  • Investigation complète des 9 endpoints Documents (appels API réels, structures de réponse, formats)
  • Document_GetPDF reclassé comme fonctionnel (LAYOUT numérique en string, ex: "1")
  • Format de date YYYY-MM-DD confirmé et documenté pour tous les endpoints avec paramètre date
  • Codes paydelay documentés (10 codes via codes_list PAYDELAY : 30, 30F, 45F, 50, 60, 60F, 75F, 90, 90F, 0F)
  • Modes de paiement documentés (codes_list PAYMODE : CAS, VIR, BC, CBEF)
  • Paramètre results ajouté à document_list (fonctionne, défaut ~108)
  • Documents.php : propriété $results ajoutée, transmise en string à l'API
  • documents.blade.php : champ results ajouté, bandeau "non fonctionnel" retiré de GetPDF, placeholder LAYOUT mis à jour
  • Documentation API massivement enrichie (réponses réelles, structures détaillées, section endpoints partiellement fonctionnels)
  • 1 nouveau test Pest (results envoyé en string à document_list)

Ce qui reste à faire

  • Corriger les 2 tests pré-existants 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.
  • 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).

Métriques

  • Tests : 125 passent, 2 en échec pré-existants
  • Pages Filament : 7 (Documentation, TablesExplorer, Articles, Documents, Journaux, Tiers, Divers)
  • Composants Blade design system : 10
  • Endpoints API couverts par LogisticsService : 19
  • Endpoints accessibles depuis l'interface : 19 (dont 1 non fonctionnel, 1 partiellement fonctionnel)
  • Migrations : 5 (users, cache, jobs, two_factor, api_request_logs)
  • Règles Cursor : 4 (laravel-boost, memory-bank, design-system, update-documentation)
  • Classes support : 1 (ApiErrorTranslator)