Control de Versiones
Rastree cada cambio en una simulacion RodSim. PetroBench guarda una instantanea cada vez que ejecuta, restaura, duplica o importa. Compare versiones, restaure estados anteriores y limpie las antiguas.
El historial de versiones esta disponible solo en el paquete Enterprise.
Cada simulacion RodSim tiene historial de versiones integrado. PetroBench guarda una instantanea cuando ocurre algo significativo (una ejecucion, una duplicacion, una importacion) y cada version es totalmente restaurable.
Como se crean las versiones
PetroBench crea una version automaticamente. Dos categorias, siete disparadores.
| Categoria | Disparador | Cuando ocurre |
|---|---|---|
| Base Case | Create | Primera vez que se crea la simulacion |
| Import | Importada desde un archivo RodStar o SRod | |
| Sync | Sincronizada desde una integracion externa | |
| Auto | Run | Despues de que termina una simulacion estatica o dinamica |
| Duplicate | Cuando duplica la simulacion | |
| Restore | Cuando restaura una version anterior | |
| Migration | El sistema migro el esquema de la simulacion |
Las versiones Base Case marcan el estado original de la simulacion. Las versiones Auto tienen limite y se limpian con el tiempo.
1. Abrir Version History
- Abra la simulacion
- Haga clic en el icono Version History en la barra superior derecha
- La hoja de historial se desliza desde la derecha
Cada version muestra:
- Version number (v1, v2, ...)
- Trigger badge (Simulation Run, Duplicated, Restore)
- Date and time, quien la disparo
- Inline diff de que cambio desde la version anterior (por ejemplo, 17 changes since v2) con tachados rojos y valores nuevos verdes
- Boton Add note para etiquetar la version
- Boton Restore (en cada version excepto la actual)
- Etiqueta verde Current en la version mas reciente
2. Agregar una nota
Las notas convierten una version autogenerada en una etiquetada, lo que la protege de la limpieza y la hace localizable despues.
- Haga clic en Add note bajo cualquier version
- Escriba la etiqueta (por ejemplo, "Version 3 Note" o "Before rod redesign")
- Haga clic en la marca verde para guardar
Para cambiar una etiqueta despues, pase el cursor sobre la version y haga clic en Edit note.
Agregue una nota a cualquier version que quiera conservar. La limpieza nunca toca una version etiquetada.
3. Comparar versiones
Dos flujos.
3.1 Comparar una version con la actual
Flujo predeterminado cuando tiene una version seleccionada (o cero, en cuyo caso elige la mas reciente).
- Abra la hoja de historial
- Haga clic en Compare with current abajo
La vista Compare muestra dos columnas lado a lado. La franja de pestanas arriba agrupa cambios por seccion con conteos:
| Pestaña | Muestra |
|---|---|
| All | Cada campo cambiado en la simulacion |
| Simulation Preferences | Objetivos, amortiguamiento, step length |
| Well Data | Propiedades de fluido, especificaciones de bomba, pumping unit |
| Tubing Data | PSN depth, anchor, sarta de tuberia |
| Rod Data | Sarta de conos de varillas |
| IPR Data | Datos de prueba de yacimiento |
El toggle arriba a la derecha (Changes only) oculta campos identicos para ver solo lo que difiere.
3.2 Comparar dos versiones
- En la hoja de historial, marque las casillas en dos versiones
- Haga clic en Compare with current (la etiqueta del boton cambia para comparar las dos)
El diseno del diff es el mismo. Use las flechas chevron arriba a la derecha de la vista Compare para avanzar entre versiones sin salir de la pagina.
4. Restaurar una version
Desde la vista Compare, haga clic en el boton Restore to v[N] abajo a la derecha. Desde la lista de historial, haga clic en Restore en cualquier version.
El dialogo confirma:
Restore to v2? This will revert the simulation to the selected version. A backup of the current state will be saved automatically before restoring.
Haga clic en Restore. PetroBench:
- Guarda el estado actual como una version nueva (para que el rollback mismo sea reversible)
- Reemplaza las entradas de la simulacion con la instantanea
- Agrega una version nueva con disparador Restore y etiqueta "Restored from v[N]"
No puede restaurar mientras una simulacion dinamica esta ejecutandose. Espere a que termine.
Si una restauracion esta bloqueada, la hoja muestra "This version cannot be restored" con la razon.
5. Limpiar versiones antiguas
La limpieza esta restringida a roles de app Admin. Los Engineers pueden crear y restaurar versiones pero no eliminarlas.
Las versiones Auto Run pueden acumularse rapido. Use Cleanup para reducirlas sin perder las que le importan.
- En la hoja de historial, haga clic en Cleanup
- Elija un alcance:
| Opcion | Que se elimina |
|---|---|
| Delete all old versions | Cada version auto sin etiqueta excepto la mas reciente |
| Older than 7 days | Versiones auto de mas de 7 dias |
| Older than 30 days | Versiones auto de mas de 30 dias |
| Older than 90 days | Versiones auto de mas de 90 dias |
El popup indica exactamente cuantas se quitaran: "2 unlabeled version(s) eligible for cleanup. Labeled versions and the latest version are always preserved."
El selector Filter by trigger arriba del mismo popup le permite reducir el alcance a tipos de disparador especificos (solo Run, solo Duplicate, etc.) antes de ejecutar la limpieza.
6. Atajos del pie
El pie de la hoja de historial tiene mas controles junto a Cleanup:
- Save version: instantanea manual del estado actual. Aparece cuando tiene cambios aun no capturados en una version.
- Reset: menu desplegable (mostrado una vez que existe una version Base Case) con dos restauraciones de un clic:
- Reset to Base Case (v[N]): revertir al estado original de la simulacion
- Restore Previous (v[N]): revertir a la version justo antes de la actual
Ambos siguen el mismo flujo de respaldo y reemplazo que una Restore normal.
Un conteo X of Y versions queda a la izquierda. Cuando hay mas versiones de las cargadas, un boton Load more al fondo de la lista trae la siguiente pagina.
Permisos
Las acciones de version verifican permisos de rol:
| Accion | Permiso requerido |
|---|---|
| View history | Ver simulacion |
| Compare | Ver simulacion |
| Edit note | Editar simulacion |
| Restore | Editar simulacion |
| Delete / Cleanup | Solo rol Admin |
Si no tiene permiso para una accion, el boton permanece visible pero deshabilitado con un tooltip que explica por que.