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