Versionnage et publication

Cette page fixe la façon dont les versions de Docora sont numérotées, fabriquées, publiées et annoncées. Elle s'adresse à la personne qui livre l'application. La procédure à suivre, case par case, est le mode opératoire MO-07 · Publier une version.

Numérotation

Docora suit le versionnage sémantique : MAJEUR.MINEUR.CORRECTIF, par exemple 1.4.2.

On incrémente	Quand	Exemple
CORRECTIF	Une correction, sans changement de comportement attendu.	`1.4.2` → `1.4.3`
MINEUR	Une fonctionnalité nouvelle, compatible avec les données existantes.	`1.4.3` → `1.5.0`
MAJEUR	Un changement qui rompt la compatibilité : format des données, serveur, façon de travailler.	`1.5.0` → `2.0.0`

Le numéro se règle à un seul endroit : la ligne version: du fichier pubspec.yaml de l'application. Les scripts de fabrication, l'installateur, l'application et le manifeste le relisent tous. Un suffixe de build (1.4.2+7) est ignoré dans les comparaisons.

Le cycle d'une version

pubspec.yaml ──► fabrication ──► manifeste ──► publication ──► annonce
   1.4.3          .exe / .zip      maj.json      hébergement      site web

Numéroter : incrémenter version: dans pubspec.yaml.
Fabriquer : un installateur par plateforme, chacun sur sa machine — Windows sous Windows, macOS sur un Mac.
Générer le manifeste et l'historique : dart run tool/generer_manifeste_maj.dart calcule l'empreinte de chaque paquet et écrit maj.json et historique.json, avec les notes de la version.
Publier : déposer les paquets, historique.json puis maj.json sur l'hébergement des mises à jour. À partir de cet instant, les postes voient la nouvelle version.
Annoncer : rien à faire — ce site relit les fichiers publiés et affiche la version sur Nouveautés et Télécharger dans les cinq minutes.

Le manifeste

maj.json est le seul fichier que les postes consultent. Le site le lit aussi : la page Télécharger affiche toujours la version réellement publiée.

{
  "derniereVersion": "1.4.3",
  "publieLe": "2026-11-02T08:15:00Z",
  "notes": ["Correction de l'export Word des certificats"],
  "obligatoire": false,
  "versionMinimale": "1.2.0",
  "paquets": {
    "windows": {
      "url": "https://…/Docora-1.4.3-windows-x64.exe",
      "sha256": "f66a88a0…",
      "taille": 17468432,
      "nomFichier": "Docora-1.4.3-windows-x64.exe"
    }
  }
}

Champ	Rôle
`derniereVersion`	Comparée à la version installée : plus récente, elle est proposée.
`notes`	Les nouveautés, affichées dans les paramètres avant d'installer.
`obligatoire`	Retire le bouton Plus tard.
`versionMinimale`	En dessous, la mise à jour devient obligatoire.
`paquets`	Une entrée par plateforme ; une plateforme absente n'est simplement pas proposée.

Ne jamais modifier un manifeste à la main

L'empreinte sha256 doit correspondre au fichier publié à l'octet près. Régénérez toujours le manifeste avec le script après avoir refabriqué un paquet.

Revenir en arrière

Les postes n'installent qu'une version plus récente que la leur : republier un ancien manifeste ne les fait pas revenir en arrière. Pour annuler une version défectueuse :

corrigez — ou revenez au code de la version précédente ;
publiez-le sous un numéro de correctif supérieur (1.4.4) ;
marquez-le --obligatoire si la version défectueuse ne doit plus être utilisée.

En attendant, retirer le paquet défectueux de l'hébergement empêche de nouveaux postes de l'installer.

Les notes de version sur ce site

Le site assemble l'historique à partir de trois sources, de la plus éditoriale à la plus brute :

src/content/versions.json, rédigé à la main dans le projet du site — il l'emporte toujours ;
historique.json, publié avec les paquets ;
maj.json, le manifeste des postes.

Une version publiée apparaît donc sans redéployer le site, avec ses nouveautés, améliorations et corrections. Pour réécrire après coup le texte d'une version, ajoutez-la à versions.json : votre texte remplace celui publié.

Le contenu est relu toutes les cinq minutes. Pour l'afficher immédiatement après une publication, appelez l'adresse protégée /api/revalider avec le secret REVALIDATION_SECRET du site.

Conserver les paquets

Gardez chaque paquet publié, avec son manifeste, dans un dossier daté. Ils servent à réinstaller une version précise sur un poste, et à vérifier après coup ce qui a été livré.