Versionnage & Déploiement
Le projet suit le versionnage sémantique (SemVer) au format MAJOR.MINOR.PATCH.
Règles SemVer
| Niveau | Format | Déclenché par |
|---|---|---|
| PATCH | 1.0.X | Correction de bug, fix CSS, ajustement SQL mineur, typo |
| MINOR | 1.X.0 | Nouvelle fonctionnalité, nouveau composant UI, nouvelle page, refactoring sans breaking change |
| MAJOR | X.0.0 | Refonte complète, changement de schéma BDD, breaking change API, migration technologique |
Fichiers de versionnage
VERSION
Contient uniquement le numéro de version courant, ex :
1.2.3
CHANGELOG.md
Historique détaillé de toutes les modifications par version. Format recommandé :
## [1.2.3] - 2026-02-24
### Fixed
- Correction du bug de doublon sur les contrats
## [1.2.0] - 2026-02-20
### Added
- Nouvelle fonctionnalité d'export filtré
Workflow de commit
# 1. Effectuer les modifications
# 2. Mettre à jour le fichier VERSION
echo "1.2.4" > VERSION
# 3. Ajouter une entrée dans CHANGELOG.md
# 4. Committer avec le bon format
git add .
git commit -m "[v1.2.4] fix: Correction de la pagination sur mobile"
git push
Format du message de commit
[vX.Y.Z] Préfixe: Description courte
Description détaillée si nécessaire.
Co-Authored-By: Claude <noreply@anthropic.com>
Préfixes de commit
| Préfixe | Impact version | Exemples |
|---|---|---|
feat: | MINOR | Ajout d'un filtre, nouveau module |
fix: | PATCH | Correction SQL, bug UI |
perf: | PATCH | Optimisation requête, cache |
refactor: | PATCH ou MINOR | Restructuration code |
style: | PATCH | CSS, mise en page |
docs: | PATCH | Documentation |
chore: | PATCH | Dépendances, config |
breaking: | MAJOR | Changement incompatible |
Conventions CSS
- Utiliser les variables CSS définies dans chaque fichier
CODE_MACHINE: policeConsolas, monospace,text-transform: uppercase- Boutons interactifs : gradients CSS
- Animations : utiliser
@keyframesnommées explicitement
Structure des assets
/assets/css/
main.css # Styles généraux, layout, tableau principal
crud.css # Modales et formulaires CRUD inline
admin.css # Interface d'administration des référentiels
import.css # Styles spécifiques à l'import
/assets/js/
main.js # Navigation onglets, dropdowns personnalisés, pagination
crud.js # Logique CRUD (ajout, édition, suppression de références)
admin.js # Logique modale admin + filterTable()
client.js # Gestion upload et affichage fichier client