====== Procédure de gestion des versions de LoGeAs (procédure #06) ====== ===== Informations qualité ===== |**Suivi des modifications majeures** |5 mars 2015 - Nicolas Marchand - Création du document \\ 1 décembre 2015 - Nicolas Marchand - Modification par rapport aux tests à passer suivant le niveau des mises à jour \\ 14 décembre 2015 - Guillaume Natali - Modification des règles de numérotation\\ 02 aout 2017 - Nicolas Marchand - Portage sur DoKuWiKi & Evolutions\\ 28 août 2020 - Nicolas Marchand - Evolution raisons changement de version| |**Suivi des approbations** |Ce document correspond à l'élément ProjeQtor Document #06 - Gestion des versions de LoGeAs (PROC-NFlog-5)| |**Objet** |L'objet de ce document est de définir les différents types des versions mises à disposition, les différences entre elles, et les actions à faire lors de la sortie d'une nouvelle version.| |**Destinataires** |**- Validation des modifications : ** Gérant \\ **- Approbation du document** : Equipe dev & Equipe Ass| \\ ===== Objectif du versionnage ===== Selon le [[http://fr.wikipedia.org/wiki/Grand_dictionnaire_terminologique|Grand dictionnaire terminologique]], le versionnage (équivalent francophone de l'anglais //versioning//) est le mécanisme qui consiste à conserver la version d'une entité logicielle quelconque, de façon à pouvoir la retrouver facilement, même après l'apparition et la mise en place de versions plus récentes [[https://fr.wikipedia.org/wiki/Version_d'un_logiciel|Wikipedia]] ===== Définition des types des versions de LoGeAs ===== Pour LoGeAs, une **version du logiciel** correspond à un état donné de l'évolution du produit mis à disposition des clients à jour de leur contrat. Contrairement à certains éditeurs qui différencient le numéro de version de développement de celui de commercialisation (Microsoft par exemple), Logeas Informatique utilise une numérotation unique La numérotation utilisée est une série de 4 chiffres séparés de points (LoGeAs v7.3.2.1). Pour permettre une meilleure compréhension, nous nommerons cette suite de chiffres de la manière suivante. ^LoGeAs version^7^3^2| | | |Majeur|Mineur|Release|Build| ==== Règles ==== - Une fois qu'une version est publiée, le contenu de sa version NE DOIT PAS être modifié. Toute modification DOIT être publiée dans une nouvelle version. - Le numéro Mineur 99 est réservé pour indiquer une version béta. Ainsi 7.99.3 indique qu'il s'agit de la version 8 Beta 3. Toutes les versions autres que celles de ce type sont réputées "stables" - Quand le segment Majeur est changé, les "Mineur", "Release" et "Build" sont remis à 0.De même quand le segment "Mineur" est changé, les "Release" et "Build" sont remis à 0 et ainsi de suite. ==== Quand le numéro "Majeur" est-il changé ? ==== Logeas Informatique considère le numéro "Majeur" plus comme un numéro "marketing" que "technique", bien que parfois les deux coïncident. En effet LoGeAs Informatique ne bride pas la possibilité de mettre à jour une version Majeure à partir de son site, même si le client a renoncé à adhérer au service d'assistance et de mise à jour. Par contre il ne peut passer à la version majeure suivante, celle-ci étant réservée aux clients à jour de leur assistance. __Par exemple :__ * la version 5.0 a vu la migration de la base de données du logiciel de BDE (propriétaire Borland) vers un système multi-base compatible SQL (par exemple SQLite ou Postgress) * la version 6.0 est une simple évolution de la version 5.0, sans changement majeur, mais a été mise en place pour les raisons précédentes après 2 ans et demi de bons services de la V5…. ==== Quand le numéro "Mineur" est-il changé ? ==== Le numéro de version « Mineure » est changé quand la version met en place de nouvelles fonctionnalités et/ou des changements sont réalisés dans la structure de la base de données (ajout d'un champ par exemple). Quand il y a des changements de règlementation pris en compte ou une nouvelle certification ==== Quand le numéro "Release" est-il changé ? ==== Le numéro de version « Release » est changé à chaque publication du logiciel (publication obligatoire). ==== Quand le numéro "Build" est-il changé ? ==== Le numéro de version «Build» est utilisé en interne pour le suivi des exécutables, des bugs et des tests. ===== Changement de version et actions à faire ===== ==== Dans le cas d'une « Majeure» ==== === Avant le début des développements === * Séparation de la documentation utilisateurs wiki (accès concurrent) [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] === Avant de « livrer » la version === * Validation de tous les tests définis dans ProjeQtOr [[https://wiki.logeas.fr/certif:test|[PROC-NFlog-10]]] * Evolution et Archivage de la documentation technique [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] * Mise en ligne sur le site de la description des modifications effectuées à partir du log de SVN (actualité sur le site) [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Taguage de l’arborescence SVN avec le numéro de version et enregistrement des binaires [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Archivage des fichiers binaires, Installateur et Mise à jour dans le dossier Cloud\LoGeAs Historique des versions [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Changement de l'URL des mises à jour et du dossier sur le serveur [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Mise à jour de la documentation EPUdF REGALE [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] === Après « livraison » de la version === * Envoi par mail à tous les utilisateurs de l'information * Dépôt des codes, documentation … auprès de l'EPUdF [[https://wiki.logeas.fr/intranet:procedure:develop:proceduremiseaucoffredescodes|[PROC-NFlog-8] ]] * Dépôt des codes et des binaires dans le coffre numérique [[https://wiki.logeas.fr/intranet:procedure:develop:proceduremiseaucoffredescodes|[PROC-NFlog-8]]] ==== Dans le cas d'une « Mineure » ==== === Avant de « livrer » la version === * Validation de tous les tests définis dans ProjeQtOr [[https://wiki.logeas.fr/certif:test|[PROC-NFlog-10]]] * Evolution et Archivage de la documentation utilisateur [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] * Evolution et Archivage de la documentation technique [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] * Mise en ligne sur le site de la description des modifications effectuéees à partir du log de SVN (actualité sur le site) [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Taguage de l’arborescence SVN avec le numéro de version et enregistrement des binaires [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Archivage des fichiers binaires, Installateur et Mise à jour dans le dossier Cloud\LoGeAs Historique des versions [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Mise à jour de la documentation EPUdF REGALE [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] === Après « livraison » de la version === * Envoi d'un mail à tous les utilisateurs pour leur indiquer la mise à jour * Dépôt des codes et des binaires dans le coffre numérique [[https://wiki.logeas.fr/intranet:procedure:develop:proceduremiseaucoffredescodes|[PROC-NFlog-8]]] * Extension de la certification du logiciel ==== Dans le cas d'une « Release » ==== === Avant de « livrer » la version === * Validation des tests en rapport avec les fonctionnalités impactées [[https://wiki.logeas.fr/certif:test|[PROC-NFlog-10]]] * Evolution et Archivage de la documentation technique [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] * Mise en ligne sur le site de la description des modifications effectuées à partir du log de SVN (actualité sur le site) [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Taguage de l’arborescence SVN avec le numéro de version et enregistrement des binaires [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Archivage des fichiers binaires, Installateur et Mise à jour dans le dossier Cloud\LoGeAs Historique des versions [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-7]]] * Mise à jour de la documentation EPUdF REGALE [[https://wiki.logeas.fr/intranet:procedure:gestion:documentation|[PROC-NFlog-6]]] === Après « livraison » de la version === * Dépôt des codes et des binaires dans le coffre numérique [[https://wiki.logeas.fr/intranet:procedure:develop:proceduremiseaucoffredescodes|[PROC-NFlog-8]]] \\