sokko-g/docs/FEATURE_CHECKLIST.md
Shinuwa e043d31fa8
All checks were successful
Deploy Sokko G / deploy (push) Successful in 7s
Add manual toolbox module ordering
2026-08-09 20:51:51 +02:00

63 lines
2.6 KiB
Markdown

# Feature Checklist
Checklist à suivre lors de l'ajout ou de la modification d'un outil, d'une page jeu ou d'un format de données.
## Outil Toolbox
- Ajouter ou modifier le composant dans `website/src/features/toolboxes/modules/`.
- Déclarer l'outil dans `website/src/features/toolboxes/modules/index.jsx`.
- Ajouter les textes nécessaires dans `website/public/data/site.json`.
- Mettre à jour la validation de `site.json` dans `tests/helpers/data-validation.mjs`.
- Mettre à jour la normalisation et le stockage compact dans `website/src/features/toolboxes/storage/toolboxStorage.js`.
- Mettre à jour `docs/STORAGE_SCHEMA.md`.
- Vérifier l'import et l'export si l'outil stocke des données.
- Si l'outil a un contenu représentable en texte, ajouter ou vérifier l'import/export texte round-trip dans le panneau d'ajout.
- Si l'outil porte un état de progression, vérifier que l'import texte repart de l'état initial attendu.
- Vérifier l'affichage dans la page toolbox complète.
- Vérifier l'affichage dans le panneau latéral.
- Vérifier le mode une colonne et deux colonnes.
- Vérifier que l'ajout, la suppression et la réorganisation respectent `moduleOrder.one` et `moduleOrder.two`.
- Vérifier le quota de stockage si l'outil manipule des données lourdes.
## Page Jeu
- Ajouter les données dans `website/public/data/`.
- Ajouter les images dans `website/public/static/img/games/<gameId>/`.
- Déclarer le jeu dans `website/public/data/site.json`.
- Vérifier la page `/games`.
- Vérifier la page `/games/<gameId>`.
- Vérifier le bouton toolbox et le panneau latéral.
- Vérifier le breadcrumb.
- Vérifier les textes avec retours à la ligne.
## Listes de jeu
- Ajouter la liste JSON dans `website/public/data/<gameId>/lists/`.
- Lancer `npm run lists:index`.
- Vérifier que `index.json` est régénéré.
- Vérifier que `nom` est présent sur chaque élément.
- Vérifier que `description` et `quantite` restent facultatifs.
- Vérifier la copie au format checklist.
- Vérifier la création directe de checklist quand une toolbox est associée.
## Style
- Réutiliser les tokens existants avant d'ajouter une nouvelle couleur ou taille.
- Réutiliser les classes de boutons existantes.
- Vérifier les boutons icon, danger, primary et secondary.
- Vérifier les cartes, panels et scrollbars.
- Vérifier les états hover/focus.
- Vérifier mobile et desktop quand le changement touche la mise en page.
## Validation avant push
```bash
npm run check
```
Le check doit passer avant de pousser :
- syntaxe serveur et Vite ;
- génération des index de listes ;
- tests Node ;
- build de production.