Versionskontrolle
Jede Änderung an einer RodSim-Simulation nachverfolgen. PetroBench speichert einen Snapshot bei jedem Run, Restore, Duplicate oder Import. Versionen vergleichen, vorherige Zustände wiederherstellen und alte bereinigen.
Die Versionshistorie ist nur im Enterprise-Paket verfügbar.
Jede RodSim-Simulation hat eine eingebaute Versionshistorie. PetroBench speichert einen Snapshot, wenn etwas Wesentliches passiert (Run, Duplicate, Import), und jede Version ist vollständig wiederherstellbar.
Wie Versionen entstehen
PetroBench erzeugt Versionen automatisch. Zwei Kategorien, sieben Trigger.
| Kategorie | Trigger | Wann ausgelöst |
|---|---|---|
| Base Case | Create | Erste Erstellung der Simulation |
| Import | Import aus RodStar- oder SRod-Datei | |
| Sync | Sync aus externer Integration | |
| Auto | Run | Nach Abschluss einer Static- oder Dynamic-Simulation |
| Duplicate | Beim Duplizieren der Simulation | |
| Restore | Beim Wiederherstellen einer vorherigen Version | |
| Migration | System hat das Simulationsschema migriert |
Base-Case-Versionen markieren den ursprünglichen Zustand. Auto-Versionen haben ein Cap und werden mit der Zeit bereinigt.
1. Versionshistorie öffnen
- Öffnen Sie die Simulation
- Klicken Sie auf das Symbol Version History in der Toolbar oben rechts
- Das History-Sheet gleitet von rechts ein
Jede Version zeigt:
- Versionsnummer (v1, v2, ...)
- Trigger-Badge (Simulation Run, Duplicated, Restore)
- Datum und Uhrzeit, wer sie ausgelöst hat
- Inline-Diff der Änderungen seit der vorherigen Version (z. B. 17 changes since v2) mit rotem Durchstreichen und grünen neuen Werten
- Button Add note, um die Version zu beschriften
- Button Restore (auf jeder Version außer der aktuellen)
- Grünes Tag Current auf der neuesten Version
2. Notiz hinzufügen
Notizen machen aus einer auto-generierten Version eine beschriftete - geschützt vor Cleanup und später auffindbar.
- Klicken Sie unter einer Version auf Add note
- Tippen Sie das Label (z. B. "Version 3 Note" oder "Before rod redesign")
- Klicken Sie auf das grüne Häkchen zum Speichern
Um ein Label später zu ändern, hovern Sie die Version und klicken Sie auf Edit note.
Fügen Sie einer Version, die Sie behalten wollen, eine Notiz hinzu. Cleanup berührt nie eine beschriftete Version.
3. Versionen vergleichen
Zwei Abläufe.
3.1 Version gegen Current vergleichen
Standardablauf, wenn eine Version ausgewählt ist (oder keine - dann die neueste).
- Öffnen Sie das History-Sheet
- Klicken Sie unten auf Compare with current
Die Compare-Ansicht zeigt zwei Spalten nebeneinander. Die Tab-Leiste oben gruppiert Änderungen nach Abschnitt mit Zählern:
| Tab | Zeigt |
|---|---|
| All | Jedes geänderte Feld in der Simulation |
| Simulation Preferences | Targets, Damping, Step Length |
| Well Data | Fluideigenschaften, Pump Specs, Pumping Unit |
| Tubing Data | PSN Depth, Anchor, Tubing String |
| Rod Data | Gestänge-Taper-Strang |
| IPR Data | Reservoir-Testdaten |
Der Toggle oben rechts (Changes only) blendet identische Felder aus, sodass Sie nur Differenzen sehen.
3.2 Zwei Versionen vergleichen
- Im History-Sheet die Checkboxen zweier Versionen aktivieren
- Auf Compare with current klicken (das Label wechselt zum Vergleich der beiden)
Das Diff-Layout ist dasselbe. Nutzen Sie die Chevron-Pfeile oben rechts in der Compare-Ansicht, um Versionen durchzuschalten, ohne die Seite zu verlassen.
4. Version wiederherstellen
Aus der Compare-Ansicht klicken Sie unten rechts auf Restore to v[N]. Aus der History-Liste klicken Sie auf Restore bei einer Version.
Der Dialog bestätigt:
Restore to v2? This will revert the simulation to the selected version. A backup of the current state will be saved automatically before restoring.
Klicken Sie auf Restore. PetroBench:
- Speichert den aktuellen Zustand als neue Version (damit der Rollback selbst umkehrbar ist)
- Ersetzt die Simulationseingaben durch den Snapshot
- Fügt eine neue Version mit Trigger Restore und Label "Restored from v[N]" hinzu
Sie können nicht wiederherstellen, während eine Dynamic-Simulation läuft. Warten Sie, bis sie fertig ist.
Ist ein Restore blockiert, zeigt das Sheet "This version cannot be restored" mit dem Grund.
5. Alte Versionen bereinigen
Cleanup ist auf Admin-App-Rollen beschränkt. Ingenieure können Versionen erstellen und wiederherstellen, aber nicht löschen.
Auto-Run-Versionen sammeln sich schnell an. Nutzen Sie Cleanup, um sie auszudünnen, ohne die wichtigen zu verlieren.
- Im History-Sheet auf Cleanup klicken
- Scope wählen:
| Option | Was gelöscht wird |
|---|---|
| Delete all old versions | Jede unbeschriftete Auto-Version außer der neuesten |
| Older than 7 days | Auto-Versionen älter als 7 Tage |
| Older than 30 days | Auto-Versionen älter als 30 Tage |
| Older than 90 days | Auto-Versionen älter als 90 Tage |
Das Popup sagt genau, wie viele entfernt werden: "2 unlabeled version(s) eligible for cleanup. Labeled versions and the latest version are always preserved."
Der Selektor Filter by trigger oben im selben Popup lässt Sie den Scope auf bestimmte Trigger-Typen eingrenzen (nur Run, nur Duplicate usw.), bevor Cleanup läuft.
6. Footer-Shortcuts
Der Footer des History-Sheets hält neben Cleanup weitere Steuerung:
- Save version - aktuellen Zustand manuell snapshotten. Erscheint, wenn Sie Änderungen haben, die noch nicht in einer Version erfasst sind.
- Reset - Dropdown (sobald eine Base-Case-Version existiert) mit zwei One-Click-Restores:
- Reset to Base Case (v[N]) - zum ursprünglichen Zustand der Simulation zurück
- Restore Previous (v[N]) - zur Version direkt vor der aktuellen
Beide folgen demselben Backup-dann-Ersetzen-Ablauf wie ein normales Restore.
Links steht ein Zähler X of Y versions. Existieren mehr Versionen als geladen, lädt Load more unten in der Liste die nächste Seite.
Berechtigungen
Versionsaktionen prüfen Rollenberechtigungen:
| Aktion | Erforderliche Berechtigung |
|---|---|
| View history | View simulation |
| Compare | View simulation |
| Edit note | Edit simulation |
| Restore | Edit simulation |
| Delete / Cleanup | Nur Admin-Rolle |
Haben Sie keine Berechtigung für eine Aktion, bleibt der Button sichtbar, aber deaktiviert, mit Tooltip zum Warum.