mpa/logisticsAPI
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
657c5ad5e3d8f35e6bf2e6790096b880eb0d1e86
logisticsAPI/memory-bank/productContext.md
Marvin 657c5ad5e3 Update project dependencies and enhance documentation 
- Added `barryvdh/laravel-dompdf` to `composer.json` for PDF generation capabilities.
- Updated `boost.json` to include `tailwindcss-development` in skills.
- Modified `package.json` and `package-lock.json` to upgrade Tailwind CSS and related packages.
- Improved README.md for clarity and corrected French language errors.
- Created design system documentation for Filament components.
- Added new Filament pages for Dashboard and Documentation with dynamic content loading.
- Enhanced TablesExplorer functionality with improved table and column management.
2026-02-20 14:16:24 +01:00

2.8 KiB
Raw Blame History

Product Context

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

Pourquoi ce projet existe

L'API Logistics (Flex/ESI Gescom) est un système de gestion commerciale accessible via une API REST. La documentation officielle est limitée. Ce projet a été créé pour :

  • Explorer les endpoints disponibles de manière interactive.
  • Comprendre les paramètres attendus et les formats de réponse.
  • Servir de base pour une documentation plus complète.

Problèmes résolus

  • Exploration de l'API : Le dashboard permet de tester chaque endpoint avec des paramètres personnalisables, sans avoir besoin de Postman.
  • Compréhension de la structure : La page "Tables" permet de découvrir les tables et colonnes disponibles dans l'API, avec déduplication automatique des colonnes retournées en double par l'API.
  • Documentation intégrée : La page "Documentation" affiche le markdown de la documentation API avec un rendu stylisé (typographie, tableaux, blocs de code) et propose un export PDF.
  • Traçabilité : Chaque requête effectuée (réussie ou échouée) est enregistrée dans api_request_logs pour pouvoir analyser les échanges.
  • Résilience : Les erreurs de connexion sont gérées avec retry automatique et messages explicites en français.
  • Cohérence visuelle : Un système de design unifié (composants x-logistics.*) garantit une présentation homogène sur toutes les pages.

Expérience utilisateur

L'utilisateur accède au dashboard Filament sur http://api-logistics.test/admin. La navigation latérale propose 6 pages :

  1. Documentation : Affichage stylisé de la documentation API complète (markdown converti en HTML). Actions : télécharger en PDF, ouvrir dans un nouvel onglet. Rendu avec typographie soignée (titres hiérarchisés, tableaux bordés, blocs de code colorés, liens bleus).
  2. Tables : Barre de statistiques (endpoint, type base, nombre de tables). Liste filtrable des tables avec compteur de colonnes. Clic sur une table pour voir ses colonnes avec badges de type colorés (Caractère, Numérique, Date/Heure, Logique, Mémo).
  3. Articles : Formulaire de recherche (search, select, results) + vérification du stock d'un article par son ARTID. Résultats en tableau structuré, stock en JSON formaté.
  4. Documents : Recherche par tiers (thirdid) + consultation du détail d'un document (jnl + number). Détail en JSON formaté.
  5. Journaux : Recherche par type de journal (TYPE). Résultats en tableau structuré.
  6. Tiers : Recherche de tiers (search obligatoire) + historique des articles d'un tiers. Historique en JSON formaté.

Toutes les pages utilisent le même système de design : cartes à en-tête séparé, badges de compteur, indicateurs de chargement sur les actions réseau, et états vides avec icônes explicatives. En cas d'erreur API, un bandeau rouge s'affiche avec le message en français.