Skip to main content

Versionnage & Déploiement

Le projet suit le versionnage sémantique (SemVer) au format MAJOR.MINOR.PATCH.


Règles SemVer

NiveauFormatDéclenché par
PATCH1.0.XCorrection de bug, fix CSS, ajustement SQL mineur, typo
MINOR1.X.0Nouvelle fonctionnalité, nouveau composant UI, nouvelle page, refactoring sans breaking change
MAJORX.0.0Refonte 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éfixeImpact versionExemples
feat:MINORAjout d'un filtre, nouveau module
fix:PATCHCorrection SQL, bug UI
perf:PATCHOptimisation requête, cache
refactor:PATCH ou MINORRestructuration code
style:PATCHCSS, mise en page
docs:PATCHDocumentation
chore:PATCHDépendances, config
breaking:MAJORChangement incompatible

Conventions CSS

  • Utiliser les variables CSS définies dans chaque fichier
  • CODE_MACHINE : police Consolas, monospace, text-transform: uppercase
  • Boutons interactifs : gradients CSS
  • Animations : utiliser @keyframes nommé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