163 lines
5.1 KiB
Markdown
163 lines
5.1 KiB
Markdown
# AG Grid Session Index
|
|
|
|
## Point d'entree
|
|
|
|
Ce fichier sert de synthese rapide pour reprendre le projet AG Grid / SAO a la prochaine session.
|
|
|
|
## Documents a lire dans l'ordre
|
|
|
|
1. [AG_GRID_COMPATIBILITY_ANALYSIS.md](c:\DataS\OpenSquared\Tradon\Source\Sao\AG_GRID_COMPATIBILITY_ANALYSIS.md)
|
|
- vision d'ensemble
|
|
- contraintes structurelles SAO / AG Grid
|
|
- architecture cible et risques
|
|
|
|
2. [AG_GRID_PROGRESS.md](c:\DataS\OpenSquared\Tradon\Source\Sao\AG_GRID_PROGRESS.md)
|
|
- etat d'avancement du POC
|
|
- ce qui est deja branche dans le code
|
|
- ce qui restait a faire apres les premieres passes
|
|
|
|
3. [AG_GRID_STYLING_NOTES.md](c:\DataS\OpenSquared\Tradon\Source\Sao\AG_GRID_STYLING_NOTES.md)
|
|
- retour d'experience de la grosse session de debug CSS
|
|
- ce qui a fait perdre du temps
|
|
- ce qui a vraiment aide
|
|
- methode recommandee pour les prochaines retouches visuelles
|
|
|
|
## Synthese globale
|
|
|
|
### 1. Ce qui est valide
|
|
|
|
- POC AG Grid Community en JavaScript pur branche dans SAO
|
|
- fallback historique SAO conserve
|
|
- selection de lignes fonctionnelle
|
|
- tri fonctionnel
|
|
- filtres popup fonctionnels
|
|
- rendu visuel fortement rapproche du style AG Grid standard
|
|
- persistance locale du layout utilisateur
|
|
- panneau `Columns` custom stable
|
|
- grouping multi-level avec agregations, sous-totaux et grand total
|
|
|
|
### 2. Ce qu'on a appris
|
|
|
|
- le principal risque n'est pas AG Grid, mais le vieux CSS global SAO
|
|
- les pseudo-elements et les styles globaux sur les controles natifs peuvent casser le theme AG Grid
|
|
- les retouches visuelles doivent etre debuggees avec des traces DOM/cascade, pas seulement "a l'oeil"
|
|
- les bugs de state doivent eux aussi etre traces tres tot
|
|
- les traces utiles a partager doivent etre en JSON plat
|
|
- si 1 ou 2 corrections "intuitives" ne suffisent pas, il faut instrumenter immediatement
|
|
|
|
### 3. Strategie pour la prochaine session
|
|
|
|
- ne pas repartir de zero
|
|
- relire d'abord cette page puis la section la plus recente de `AG_GRID_PROGRESS.md`
|
|
- relire ensuite `AG_GRID_STYLING_NOTES.md`
|
|
- si un bug visuel resiste a 1 ou 2 corrections, passer tout de suite a un dump cible
|
|
- si un bug de state ou de rendering resiste a 1 ou 2 corrections, ajouter tout de suite une trace `..._FLAT_JSON`
|
|
- eviter les gros changements globaux de priorite CSS sans isolation claire
|
|
|
|
## Point de reprise apres la session du 2026-03-30
|
|
|
|
Le POC a franchi un palier important:
|
|
|
|
- panneau `Columns` hors Bootstrap, stable et persiste
|
|
- configuration utilisateur locale de la grille
|
|
- panneau `Grouping`
|
|
- grouping multi-level client-side
|
|
- agregations
|
|
- sous-totaux
|
|
- grand total
|
|
- toolbar simplifiee et icones plus propres
|
|
|
|
Les traces suivantes ont ete introduites pour accelerer le debug:
|
|
|
|
- `COLUMNS_MENU_LAYOUT_FLAT_JSON`
|
|
- `GROUPING_ACTION_FLAT_JSON`
|
|
- `GROUPING_STATE_FLAT_JSON`
|
|
- `GROUPING_PERSISTED_FLAT_JSON`
|
|
- `ROW_DATA_KIND_FLAT_JSON`
|
|
|
|
Memo important:
|
|
|
|
- produire les traces plus frequemment
|
|
- preferer des JSON plats des le debut
|
|
- ne pas attendre plusieurs tentatives "a l'aveugle" quand un symptome resiste
|
|
|
|
## Point de reprise apres la session du 2026-03-31
|
|
|
|
Deux chantiers supplementaires ont ete consolides:
|
|
|
|
- diagnostic de fallback AG Grid plus riche
|
|
- dark mode V1 safe sur le shell principal et la grille
|
|
|
|
### Fallback renderer
|
|
|
|
La trace a lire en premier est maintenant:
|
|
|
|
- `TREE_VIEW_DECISION_FLAT_JSON`
|
|
|
|
Elle permet de savoir immediatement si une vue part sur:
|
|
|
|
- `ag_grid`
|
|
- `legacy_tree`
|
|
|
|
Et pourquoi, avec notamment:
|
|
|
|
- `children_field`
|
|
- `editable_view`
|
|
- `embedded_relation_tree`
|
|
|
|
Le nouveau garde-fou `embedded_relation_tree` est important:
|
|
|
|
- il evite que des sous-listes embarquees de type `one2many` ou relationnelles partent par erreur sur AG Grid
|
|
|
|
### Dark mode V1
|
|
|
|
Le dark mode est maintenant present dans une version prudente:
|
|
|
|
- toggle global pres du logo
|
|
- persistance locale
|
|
- logo light/dark dedie
|
|
- topbar, menu, shell, filtres modernises, toolbar de formulaire et AG Grid traites
|
|
|
|
Ne pas supposer que tout legacy est theme en dark:
|
|
|
|
- les composants fragiles n'ont pas encore tous ete traites
|
|
- il faut continuer par zones locales
|
|
|
|
## Next steps produit memorises
|
|
|
|
### Priorite probable
|
|
|
|
- presets / bookmarks d'affichage par user/vue
|
|
|
|
Idee retenue:
|
|
|
|
- permettre au user de choisir une configuration nommee de grille
|
|
- separer si besoin:
|
|
- bookmark de filtre SAO
|
|
- preset de layout/tri/grouping AG Grid
|
|
|
|
### Suite logique apres grouping / sous-totaux
|
|
|
|
- `Reset layout`
|
|
- `Reset grouping`
|
|
- `Expand all / Collapse all`
|
|
- presets nommes de vue
|
|
- support de plus de colonnes speciales
|
|
- meilleure visibilite des raisons de fallback vers l'ancien tree
|
|
- plus tard: agregations backend sur tout le dataset filtre
|
|
|
|
### Suite logique dark mode
|
|
|
|
- finir le perimetre safe du dark mode
|
|
- verifier les toolbars / panneaux encore heterogenes
|
|
- traiter ensuite les modales et dropdowns les plus utilises
|
|
- garder la bascule light/dark strictement non destructive
|
|
|
|
## Recommandation long terme
|
|
|
|
Si AG Grid doit devenir central dans les vues `tree`, il faudra probablement:
|
|
|
|
- mieux isoler AG Grid du CSS global SAO
|
|
- ou rationaliser les anciennes regles SAO sur `input/select/radio/checkbox`
|
|
- ou definir une vraie zone de styles AG Grid maitrisee
|