التحكم بالإصدارات

لكل محاكاة RodSim سجل إصدارات مدمج. يحفظ PetroBench لقطة whenever يحدث شيء مهم (تشغيل، نسخ، استيراد) وكل إصدار قابل للاستعادة بالكامل.

كيف تُنشأ الإصدارات

ينشئ PetroBench إصدارًا تلقائيًا. فئتان، سبعة محفّزات.

إصدارات Base Case تعلّم الحالة الأصلية. إصدارات Auto تُحدّ ويُنظّف منها مع الوقت.

---

1. فتح Version History

1. افتح المحاكاة
2. انقر أيقونة Version History في شريط الأدوات أعلى اليمين
3. تنزلق لوحة السجل من اليمين

يعرض كل إصدار:

• رقم الإصدار (v1، v2، ...)
• شارة المحفّز (Simulation Run، Duplicated، Restore)
• التاريخ والوقت، من أطلقه
• فرق inline لما تغيّر منذ الإصدار السابق (مثل 17 changes since v2) مع قيم محذوفة بالأحمر وجديدة بالأخضر
• زر Add note لتسمية الإصدار
• زر Restore (على كل إصدار ما عدا الحالي)
• علامة Current خضراء على أحدث إصدار

---

2. إضافة ملاحظة

الملاحظات تحوّل إصدارًا مُولّدًا تلقائيًا إلى مُسمّى، ما يحميه من التنظيف ويجعله قابلًا للعثور لاحقًا.

1. انقر Add note تحت أي إصدار
2. اكتب التسمية (مثل "Version 3 Note" أو "Before rod redesign")
3. انقر علامة الصح الخضراء للحفظ

لتغيير تسمية لاحقًا، مرّر على الإصدار وانقر Edit note.

---

3. مقارنة الإصدارات

مساران.

3.1 مقارنة إصدار مع الحالي

المسار الافتراضي عند اختيار إصدار واحد (أو صفر، فيختار الأحدث).

1. افتح لوحة السجل
2. انقر Compare with current في الأسفل

Compare يعرض عمودين جنبًا إلى جنب. شريط التبويبات في الأعلى يجمّع التغييرات حسب القسم مع العدد:

المفتاح أعلى اليمين (Changes only) يخفي الحقول المتطابقة لترى الاختلاف فقط.

3.2 مقارنة إصدارين

1. في لوحة السجل، فعّل خانات اختيار على إصدارين
2. انقر Compare with current (يتغيّر تسمية الزر لمقارنة الاثنين)

تخطيط الفرق نفسه. استخدم أسهم chevron أعلى يمين Compare للتنقل بين الإصدارات دون مغادرة الصفحة.

---

4. استعادة إصدار

من Compare، انقر Restore to v[N] أسفل اليمين. من قائمة السجل، انقر Restore على أي إصدار.

يؤكد الحوار:

Restore to v2? This will revert the simulation to the selected version. A backup of the current state will be saved automatically before restoring.

انقر Restore. PetroBench:

1. يحفظ الحالة الحالية كإصدار جديد (لذا التراجع نفسه قابل للعكس)
2. يستبدل مدخلات المحاكاة باللقطة
3. يضيف إصدارًا جديدًا بمحفّز Restore وتسمية "Restored from v[N]"

إذا حُظرت الاستعادة، تعرض اللوحة "This version cannot be restored" مع السبب.

---

5. تنظيف الإصدارات القديمة

إصدارات Auto Run تتراكم بسرعة. استخدم Cleanup لتخفيفها دون فقدان ما يهمك.

1. في لوحة السجل، انقر Cleanup
2. اختر نطاقًا:

النافذة المنبثقة تخبرك بالضبط كم سيُزال: "2 unlabeled version(s) eligible for cleanup. Labeled versions and the latest version are always preserved."

Filter by trigger في أعلى نفس النافذة يضيّق النطاق لأنواع محفّز محددة (Run فقط، Duplicate فقط، إلخ) قبل التنظيف.

---

6. اختصارات التذييل

تذييل لوحة السجل يحتوي ضوابط إضافية بجانب Cleanup:

• Save version - لقطة يدوية للحالة الحالية. تظهر عند وجود تغييرات لم تُلتقط بعد في إصدار.
• Reset - قائمة منسدلة (تظهر بعد وجود Base Case) باستعادتين بنقرة:
  • Reset to Base Case (v[N]) - العودة للحالة الأصلية للمحاكاة
  • Restore Previous (v[N]) - العودة للإصدار قبل الحالي

كلاهما يتبع نفس تدفق النسخ الاحتياطي ثم الاستبدال كـ Restore العادي.

عدد X of Y versions على اليسار. عند وجود إصدارات أكثر من المحمّلة، زر Load more أسفل القائمة يسحب الصفحة التالية.

---

الصلاحيات

إجراءات الإصدار تتحقق من صلاحيات الدور:

إذا لم تكن لديك صلاحية لإجراء، يبقى الزر ظاهرًا لكن معطّلًا مع tooltip يشرح السبب.

---

ما التالي