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.
This commit is contained in:
2026-02-20 14:16:24 +01:00
parent 4aef33f270
commit 657c5ad5e3
46 changed files with 3318 additions and 857 deletions

View File

@@ -1,36 +1,42 @@
# Project Brief
Derniere mise a jour : 2026-02-20
Dernière mise à jour : 2026-02-20
## Vision
Application Laravel de test dont l'objectif est de comprendre le fonctionnement de l'API Logistics (Flex/ESI Gescom) et d'en produire une documentation complete et comprehensible.
Application Laravel de test dont l'objectif est de comprendre le fonctionnement de l'API Logistics (Flex/ESI Gescom) et d'en produire une documentation complète et compréhensible.
## Objectifs
1. Comprendre le fonctionnement de l'API Logistics.
2. Creer une application simple permettant d'envoyer et de recuperer des donnees vers/depuis l'API.
3. Produire une documentation complete et comprehensible de l'API.
2. Créer une application simple permettant d'envoyer et de récupérer des données vers/depuis l'API.
3. Produire une documentation complète et compréhensible de l'API.
## Perimetre fonctionnel
## Périmètre fonctionnel
- Dashboard Filament v5 accessible sans authentification sur `/admin`.
- Pages de consultation pour les principales entites de l'API : tables, articles, documents, journaux, tiers.
- Formulaires de recherche parametrables pour chaque endpoint.
- Affichage des resultats bruts retournes par l'API.
- Tracage des requetes effectuees dans une table `api_request_logs`.
- Gestion robuste des erreurs API (timeout, retry, messages utilisateur en francais).
- Pages de consultation pour les principales entités de l'API : tables, articles, documents, journaux, tiers.
- Page de documentation intégrée avec rendu stylisé du markdown et export PDF.
- Formulaires de recherche paramétrables pour chaque endpoint.
- Affichage des résultats sous forme de tableaux structurés et de blocs JSON formatés.
- Système de design unifié avec composants Blade réutilisables (`x-logistics.*`).
- Traçage des requêtes effectuées dans une table `api_request_logs`.
- Gestion robuste des erreurs API (timeout, retry, messages utilisateur en français).
## Contraintes
- Pas d'authentification sur le dashboard (projet de test interne).
- L'API Logistics est hebergee sur le serveur TSE-10-TEST (`http://tse-10-test.esiweb.pro`).
- Le serveur API est accessible uniquement via le reseau interne (connexion Bureau a distance / RDP requise). L'application doit etre deployee sur ce reseau ou un tunnel doit etre mis en place.
- Toutes les requetes API sont en POST et necessitent un header `X-API-KEY`.
- Le nom du dossier dans les URLs de l'API doit etre en minuscules.
- L'API Logistics est hébergée sur le serveur TSE-10-TEST (`http://tse-10-test.esi.local`).
- Le serveur API est accessible via le réseau interne.
- Toutes les requêtes API sont en POST et nécessitent un header `X-API-KEY`.
- Le nom du dossier dans les URLs de l'API doit être en minuscules.
## Convention d'écriture
Tous les contenus rédigés en français (documentation, memory bank, règles Cursor, commentaires) doivent utiliser les accents appropriés.
## Ressources
- Documentation Postman : https://documenter.getpostman.com/view/40440561/2sB2qaj2Pz
- Documentation interne : `documentation/WEB-A-1 (3).md` et `documentation/result.pdf`
- Documentation interne : `documentation/documentation_api_logistics.md`
- Fichier projet : `project.md`