Contrôle de version
Suivez chaque modification d'une simulation RodSim. PetroBench enregistre un instantane a chaque execution, restauration, duplication ou import. Comparez les versions, restaurez des etats anterieurs et nettoyez les anciennes.
L'historique des versions est disponible uniquement sur le forfait Enterprise.
Chaque simulation RodSim a un historique de versions integre. PetroBench enregistre un instantane lorsque quelque chose de significatif se produit (execution, duplication, import) et chaque version est entierement restaurable.
Comment les versions sont creees
PetroBench cree une version automatiquement. Deux categories, sept declencheurs.
| Categorie | Declencheur | Quand il se produit |
|---|---|---|
| Base Case | Create | Premiere creation de la simulation |
| Import | Import depuis un fichier RodStar ou SRod | |
| Sync | Synchronisation depuis une integration externe | |
| Auto | Run | Apres la fin d'une simulation static ou dynamic |
| Duplicate | Lors de la duplication de la simulation | |
| Restore | Lors de la restauration d'une version anterieure | |
| Migration | Migration du schema de simulation par le systeme |
Les versions Base Case marquent l'etat original de la simulation. Les versions Auto sont plafonnee et nettoyees au fil du temps.
1. Ouvrir Version History
- Ouvrez la simulation
- Cliquez sur l'icone Version History dans la barre d'outils en haut a droite
- La feuille d'historique glisse depuis la droite
Chaque version affiche :
- Numero de version (v1, v2, ...)
- Badge de declencheur (Simulation Run, Duplicated, Restore)
- Date et heure, qui l'a declenchee
- Diff inline de ce qui a change depuis la version precedente (par ex. 17 changes since v2) avec barrages rouges et nouvelles valeurs vertes
- Bouton Add note pour etiqueter la version
- Bouton Restore (sur chaque version sauf la courante)
- Tag vert Current sur la derniere version
2. Ajouter une note
Les notes transforment une version auto-generee en version etiquetee, ce qui la protege du nettoyage et la rend retrouvable plus tard.
- Cliquez sur Add note sous une version
- Saisissez le libelle (par exemple "Version 3 Note" ou "Before rod redesign")
- Cliquez sur la coche verte pour enregistrer
Pour modifier un libelle plus tard, survolez la version et cliquez sur Edit note.
Ajoutez une note a toute version que vous voulez conserver. Le nettoyage ne touche jamais une version etiquetee.
3. Comparer des versions
Deux flux.
3.1 Comparer une version a Current
Flux par defaut lorsqu'une version est selectionnee (ou zero, auquel cas la plus recente est choisie).
- Ouvrez la feuille d'historique
- Cliquez sur Compare with current en bas
La vue Compare affiche deux colonnes cote a cote. La bande d'onglets en haut regroupe les changements par section avec compteurs :
| Onglet | Affiche |
|---|---|
| All | Chaque champ modifie dans la simulation |
| Simulation Preferences | Cibles, amortissement, longueur de pas |
| Well Data | Proprietes fluide, specs pompe, unite de pompage |
| Tubing Data | Profondeur PSN, ancre, tubing string |
| Rod Data | Train de tiges coniques |
| IPR Data | Donnees de test reservoir |
Le toggle en haut a droite (Changes only) masque les champs identiques pour ne voir que les differences.
3.2 Comparer deux versions
- Dans la feuille d'historique, cochez deux versions
- Cliquez sur Compare with current (le libelle du bouton passe a la comparaison des deux)
La disposition du diff est la meme. Utilisez les fleches chevron en haut a droite de la vue Compare pour parcourir les versions sans quitter la page.
4. Restaurer une version
Depuis la vue Compare, cliquez sur le bouton Restore to v[N] en bas a droite. Depuis la liste d'historique, cliquez sur Restore sur une version.
Le dialogue confirme :
Restore to v2? This will revert the simulation to the selected version. A backup of the current state will be saved automatically before restoring.
Cliquez sur Restore. PetroBench :
- Enregistre l'etat courant comme nouvelle version (le rollback lui-meme est reversible)
- Remplace les entrees de simulation par l'instantane
- Ajoute une nouvelle version avec declencheur Restore et un libelle "Restored from v[N]"
Vous ne pouvez pas restaurer pendant qu'une simulation dynamic est en cours. Attendez la fin.
Si une restauration est bloquee, la feuille affiche "This version cannot be restored" avec la raison.
5. Nettoyer les anciennes versions
Le nettoyage est reserve aux roles applicatifs Admin. Les Engineers peuvent creer et restaurer des versions mais ne peuvent pas les supprimer.
Les versions Auto Run peuvent s'accumuler vite. Utilisez Cleanup pour les reduire sans perdre celles qui comptent.
- Dans la feuille d'historique, cliquez sur Cleanup
- Choisissez un perimetre :
| Option | Ce qui est supprime |
|---|---|
| Delete all old versions | Chaque version auto non etiquetee sauf la plus recente |
| Older than 7 days | Versions auto de plus de 7 jours |
| Older than 30 days | Versions auto de plus de 30 jours |
| Older than 90 days | Versions auto de plus de 90 jours |
La popup indique exactement combien seront retires : "2 unlabeled version(s) eligible for cleanup. Labeled versions and the latest version are always preserved."
Le selecteur Filter by trigger en haut de la meme popup permet de restreindre le perimetre a des types de declencheur specifiques (uniquement Run, uniquement Duplicate, etc.) avant le nettoyage.
6. Raccourcis du pied de page
Le pied de la feuille d'historique contient d'autres controles a cote de Cleanup :
- Save version : instantane manuel de l'etat courant. Apparait lorsque vous avez des changements pas encore captures dans une version.
- Reset : menu deroulant (affiche une fois qu'une version Base Case existe) avec deux restaurations en un clic :
- Reset to Base Case (v[N]) : revenir a l'etat original de la simulation
- Restore Previous (v[N]) : revenir a la version juste avant la courante
Les deux suivent le meme flux sauvegarde-puis-remplacement qu'une Restore normale.
Un compteur X of Y versions est a gauche. Lorsqu'il existe plus de versions que chargees, un bouton Load more en bas de liste charge la page suivante.
Autorisations
Les actions sur les versions verifient les permissions de role :
| Action | Permission requise |
|---|---|
| View history | View simulation |
| Compare | View simulation |
| Edit note | Edit simulation |
| Restore | Edit simulation |
| Delete / Cleanup | Role Admin uniquement |
Si vous n'avez pas la permission pour une action, le bouton reste visible mais desactive avec une infobulle expliquant pourquoi.