logisticsAPI/memory-bank/activeContext.md

Active Context

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

Travail en cours

Aucun travail en cours.

Décisions récentes

• Convention d'écriture avec accents (2026-02-20) : Tous les contenus rédigés en français (documentation, memory bank, règles Cursor) doivent utiliser les accents appropriés. La documentation API et le memory bank ont été entièrement réécrits avec les accents.
• Page Documentation ajoutée (2026-02-20) : Nouvelle page Filament Documentation qui affiche le fichier markdown documentation/documentation_api_logistics.md converti en HTML via Str::markdown(). Actions d'en-tête : télécharger en PDF et ouvrir dans un nouvel onglet.
• Styles prose personnalisés (2026-02-20) : Le thème CSS Filament (theme.css) a été enrichi avec des styles .documentation-prose dédiés au rendu du markdown en dark mode : hiérarchie de titres avec bordures, tableaux avec bordures et en-têtes stylisés, blocs de code avec fond sombre, code inline coloré, liens bleus, listes à marqueurs, séparateurs visibles.
• Plugin @tailwindcss/typography (2026-02-20) : Ajout du plugin via @plugin "@tailwindcss/typography" dans le thème Filament pour activer les classes prose.
• Export PDF de la documentation (2026-02-20) : Route documentation.download-pdf dans routes/web.php utilisant barryvdh/laravel-dompdf pour générer un PDF téléchargeable de la documentation.
• Règle update-documentation (2026-02-20) : Nouvelle règle Cursor .cursor/rules/update-documentation.mdc définissant la procédure de mise à jour de la documentation quand l'utilisateur dit "update documentation".
• Filament v5 sans authentification : Le AdminPanelProvider a été configuré sans ->login() et sans authMiddleware pour permettre un accès libre au dashboard.
• Pages personnalisées plutôt que Resources : L'application interroge une API externe, il n'y a pas de modèles Eloquent à gérer en CRUD.
• MySQL au lieu de SQLite : Choix de l'utilisateur pour la base de données.
• LogisticsService : Toutes les interactions avec l'API sont centralisées dans un seul service.
• Heroicon enum : Filament v5 impose l'utilisation de BackedEnum pour $navigationIcon au lieu de strings.
• $view non-static : Filament v5 a changé $view de static à instance property.
• Timeout et retry configurables : Les paramètres sont dans config/logistics.php et pilotés par .env.
• LogisticsApiException : Exception dédiée créée pour distinguer les erreurs de connexion des erreurs de requête génériques.
• Logging des échecs : Les requêtes échouées sont aussi enregistrées dans api_request_logs avec response_status = 0.
• Système de design unifié (2026-02-20) : Création de 10 composants Blade réutilisables dans resources/views/components/logistics/ et d'une convention documentée dans .cursor/rules/design-system.mdc.
• Thème Filament personnalisé (2026-02-20) : Création de resources/css/filament/admin/theme.css enregistré dans AdminPanelProvider via ->viteTheme().
• TablesExplorer amélioré (2026-02-20) : Remplacement de wire:then (invalide) par une méthode selectTable(). Ajout de la déduplication des colonnes, d'un filtre de tables, de la propriété computed filteredTables, des labels de type (getDataTypeLabel), et du stockage des métadonnées.
• Connectivité API résolue (2026-02-20) : Le serveur API est accessible via http://tse-10-test.esi.local (réseau interne). Le timeout a été augmenté à 300s dans .env.

Changements récents (2026-02-20, session documentation)

• Page Filament Documentation créée (app/Filament/Pages/Documentation.php).
• Vue Blade resources/views/filament/pages/documentation.blade.php créée.
• Documentation markdown réécrite intégralement avec accents français.
• Styles CSS .documentation-prose ajoutés dans theme.css (titres, tableaux, code, liens, listes).
• Plugin @tailwindcss/typography activé dans le thème Filament.
• Route PDF (documentation.download-pdf) ajoutée dans routes/web.php.
• Template PDF (resources/views/pdf/documentation.blade.php) créé.
• 5 tests Pest créés pour la page Documentation (tests/Feature/DocumentationTest.php).
• Règle Cursor update-documentation.mdc créée.
• Memory bank entièrement réécrit avec accents français.
• Total : 61 tests passent (165 assertions).

Historique

2026-02-20 (session design)

• 10 composants Blade créés dans resources/views/components/logistics/.
• Convention de design documentée dans .cursor/rules/design-system.mdc.
• 5 pages Filament refactorisées pour utiliser les composants du système de design.
• TablesExplorer.php amélioré : selectTable(), déduplication, filtre, computed property, métadonnées, labels de types.
• Thème Filament personnalisé créé (resources/css/filament/admin/theme.css).
• AdminPanelProvider.php mis à jour avec ->viteTheme().
• 6 tests Pest créés pour TablesExplorer (Livewire).

2026-02-20 (session robustesse)

• LogisticsService mis à jour : timeout, connectTimeout, retry, gestion d'erreur avec LogisticsApiException.
• LogisticsApiException créée dans app/Exceptions/.
• config/logistics.php étendu avec timeout et retry.
• .env et .env.example complétés avec les nouvelles variables.
• Les 5 pages Filament mises à jour pour attraper LogisticsApiException.
• Tests passés de 8 à 12.

2026-02-19

• Installation de Filament v5.0.0 (31 packages ajoutés).
• 5 pages Filament créées : TablesExplorer, Articles, Documents, Journaux, Tiers.
• LogisticsService créé avec 17 endpoints.
• Migration api_request_logs créée.
• 8 tests Pest écrits et validés.

Prochaines étapes

• Tester toutes les pages avec de vraies données API et vérifier le rendu visuel.
• Éventuellement : ajouter des pages pour les endpoints d'écriture (document_add, document_mod).
• Éventuellement : ajouter de la pagination ou du tri côté client pour les grands tableaux.
• Éventuellement : ajouter une page de consultation des logs API.