Aptli

إدارة الإصدارات

يتيح لك نظام إدارة الإصدارات في Aptli تحرير الخرائط والرسوم التخطيطية دون اتصال بالإنترنت — في أنفاق مترو الأنفاق، أو المواقع النائية، أو المناطق ذات الاتصال الضعيف — وإرسال تغييراتك عندما تكون جاهزاً. يكتشف النظام التعارضات عندما يحرر مستخدمان المنطقة نفسها، ويحتفظ بسجل إصدارات دائم لكل تثبيت، ويمنح المسؤولين قائمة انتظار للمراجعة قبل نشر التعديلات الميدانية. تغطي هذه الصفحة كيفية استخدام عناصر التحكم في الإصدارات وحل التعارضات.

واجهة عناصر التحكم في الإصدارات

تظهر عناصر التحكم في الإصدارات في شريط أدوات الخريطة نفسه – على سطح المكتب تكون في الصف الأول من الأيقونات بجوار محدد الوضع وزر نقل البيانات، بينما على الأجهزة المحمولة تشكّل السطر الأول من شريط التنقل السفلي. تُظهر الصورة المرفقة تخطيط سطح المكتب؛ وإذا نظرت إلى شريط أدوات الخريطة ستلاحظ أيضاً زر نقل البيانات بجانب عناصر التحكم (المستخدم للاستيراد/التصدير).

عناصر التحكم الأساسية:

  • تراجع - التراجع عن آخر تغيير في الجلسة الحالية
  • إعادة - إعادة تطبيق تغيير تم التراجع عنه
  • إعادة مزامنة - إعادة تحميل البيانات من الخادم، وتجاهل التغييرات المحلية غير الملتزم بها
  • إرسال - دفع جميع التغييرات غير الملتزم بها إلى الخادم

شارة التغييرات غير الملتزم بها:

  • تُظهر الشارة البرتقالية على زر الميزات المحددة عدد التغييرات غير الملتزم بها
  • تتحدث تفاعلياً أثناء إنشاء/تحرير/حذف الميزات
  • تساعد في تتبع العمل المعلّق قبل الإرسال

كيف يعمل نظام الإصدارات

(عمليات الاستيراد من الخادم: المهام التي تعمل في الخلفية مثل موجزات البيانات الآلية تُنشئ إصداراتها الخاصة وتلتزم بها. لا يحتاج المستخدمون النهائيون إلى تحميلها يدوياً – تظهر الميزات المستوردة ببساطة على الخريطة بمجرد انتهاء المهمة.)

تدفق الإصدار/التثبيت

1. إنشاء المسودة          → يوجد التغيير في تخزين المتصفح
   ↓                         تحمل الميزة علامة _uncommitted
   
2. تحرير دون اتصال        → تعديل الخصائص والهندسة والعلاقات
   ↓                         تُتتبع جميع التغييرات محلياً
   
3. الإرسال                → دفع التغييرات إلى الخادم
   ↓                         يُنشئ الخادم سجل إصدار
   
4. فحص التعارضات          → يكتشف الخادم التعارضات المكانية/المعرّفات
   ↓                         خيار عرض مسودات الآخرين
   
5. الدمج أو التراجع       → قبول التغييرات أو التراجع
   ↓
   
6. ضغط الإصدار            → تُحفظ الحالة التاريخية إلى الأبد
                            يصبح التغيير سجلاً دائماً

ثلاثة أنظمة لتتبع التغييرات

يستخدم Aptli أنماطاً مختلفة بناءً على احتياجات سير العمل:

١. النماذج ذات الإصدارات (ميزات الخريطة، الطبقات، الرسوم التخطيطية):

  • تُخزَّن التغييرات في تخزين المتصفح حتى الإرسال
  • تتتبع علامة _uncommitted حالة المسودة
  • تُكتشف التعارضات عبر التحليل المكاني
  • سجل إصدارات دائم (لا يُحذف أبداً)

٢. نماذج الوقت الفعلي (المهام الموكلة، التقارير، المعاملات):

  • تُحفظ التغييرات فوراً على الخادم
  • لا توجد مسودات دون اتصال (يتطلب التنفيذ تأكيداً)
  • لا يوجد سجل إصدارات (بيانات تشغيلية)

٣. المهام (هجينة):

  • ذات إصدار لمرحلة التخطيط (تصميم دون اتصال)
  • في الوقت الفعلي للتنفيذ (المهام الموكلة تتجاوز الإصدارات)
  • راجع دليل إنجاز العمل للحصول على التفاصيل

استخدام عناصر التحكم في الإصدارات

الإرسال - دفع التغييرات إلى الخادم

متى تُرسل:

  • نهاية جلسة العمل (حفظ التقدم)
  • قبل التبديل بين المشاريع (إبقاء التغييرات)
  • بعد التعديلات الكبرى (إنشاء نقطة تفتيش)
  • قبل الانفصال التام عن الإنترنت (مزامنة أحدث إصدار)

ما الذي يُرسَل:

  • جميع الميزات التي تحمل علامة _uncommitted
  • تعديلات الطبقات
  • تغييرات الرسوم التخطيطية
  • تحديثات الخصائص، تعديلات الهندسة، الميزات الجديدة
  • أي ملفات مرفقة بتلك السجلات (صور، مستندات)

ملاحظة: تُنشئ مهام الاستيراد من جانب الخادم (مثل عمليات استيراد GeoJSON الليلية) أيضاً إصدارات تلقائياً؛ وتظهر هذه في صفحة الإدارة ← الإصدارات وتصبح ميزاتها مرئية للمستخدمين فور اكتمال المهمة، تماماً مثل عمليات التثبيت العادية.

سير العمل:

1. إجراء التغييرات (رسم، تحرير، استيراد ميزات)
2. مراقبة عدد شارة التغييرات غير الملتزم بها
3. انقر إرسال عند الاستعداد
4. التحقق من التعارضات (إن وُجدت)
5. حل التعارضات أو قبول الإرسال

طلب التثبيت ومراجعة المسؤول

بالنسبة لغير المسؤولين، يعمل زر الإرسال في البداية كـ طلب مراجعة بدلاً من النشر الفوري. عند اختيار طلب التثبيت تُوضع علامة submittedForReview على الإصدار ويُحفظ على الخادم؛ ولا يصبح مرئياً للمستخدمين الآخرين حتى يوافق عليه أحد المسؤولين. يفتح المسؤولون صفحة الإدارة ← الإصدارات الجديدة (انظر دليل الإدارة) لعرض قائمة انتظار الإصدارات المعلّقة؛ ويمكنهم إما تثبيت الإصدار (جعله نشطاً) أو حذفه. يضمن سير العمل هذا مراجعة التعديلات الميدانية قبل تطبيقها على مجموعة البيانات المشتركة.

مرفقات الملفات

أي ملفات تُرفقها بسجل (صور، مستندات، إلخ) تُجهَّز محلياً كجزء من إصدارك الحالي. تُرفع تلقائياً عند إرسال الإصدار وتُدرج في عملية التثبيت؛ وإذا تراجعت عن التغييرات أو تجاهلتها تُزال الملفات المجهّزة. راجع وثائق التطوير للحصول على تفاصيل تقنية حول تجهيز الملفات.

النتيجة:

  • التغييرات مرئية لجميع المستخدمين
  • إنشاء سجل إصدار على الخادم
  • إزالة علامة _uncommitted
  • إعادة تعيين عدد الشارات إلى ٠

تراجع - التراجع عن آخر تغيير

ماذا يفعل:

  • يرجع خطوة للخلف عبر سجل التغييرات
  • يعمل على التغييرات المحلية غير الملتزم بها
  • يحافظ على مكدس الإعادة (يمكن الإعادة بعد التراجع)

القيود:

  • يؤثر فقط على تغييرات الجلسة الحالية
  • لا يمكن التراجع عن التغييرات المرسَلة/الملتزم بها (استخدم إعادة المزامنة بدلاً من ذلك)
  • يُمسح السجل عند إعادة تحميل الصفحة

حالات الاستخدام:

  • "أوه، حذفتُ الميزة الخطأ"
  • "أحتاج إلى تجربة نهج مختلف"
  • "حرّكتُ الميزة عن طريق الخطأ"

إعادة - إعادة تطبيق التغيير المتراجَع عنه

ماذا تفعل:

  • تتقدم للأمام عبر سجل التغييرات
  • متاحة فقط بعد التراجع
  • تُمسح عند إجراء تغيير جديد

سير العمل:

1. التراجع يزيل التغيير
2. الإعادة تستعيده
3. تابع التراجع/الإعادة حسب الحاجة
4. إجراء تغيير جديد ← يمسح مكدس الإعادة

حل التعارضات

عندما يحرر مستخدمان الميزة/الإصدار نفسه في وقت واحد، يظهر تحذير تعارض في أعلى الخريطة.

انقر على عرض تفاصيل التعارض لفتح عرض مقارنة حيث يمكنك قبول أو رفض التغييرات الفردية. تُبرز لوحة السجل الإصدارات التي ساهمت في كل تعديل.

عارض قائمة انتظار دون اتصال

عند العمل دون اتصال، تُوضع التغييرات في قائمة انتظار محلية؛ ويعرض عارض قائمة الانتظار دون اتصال العمليات المعلّقة وحالة المزامنة ويسمح بإعادة المحاولة يدوياً.

(لقطات شاشة لمؤشر الشبكة: دون اتصال ومتصل)

إعادة مزامنة - إعادة التحميل من الخادم

متى تستخدمها:

  • تجاهل جميع التغييرات غير الملتزم بها
  • إعادة تحميل أحدث نسخة من الخادم (عمل الآخرين)
  • خيار "التراجع عن كل شيء" النووي
  • حل حالة محلية تالفة

⚠️ تحذير:

  • تُفقد جميع التغييرات غير الملتزم بها
  • لا يمكن التراجع عنها
  • تأكيد قبل المتابعة

بديل آمن:

  • أرسل أولاً للحفاظ على العمل
  • ثم أعد المزامنة للحصول على الأحدث

سير عمل متوازٍ: مباشر مقابل تجهيزي

يدعم Aptli سير عمليْن لمعالجة الميزات:

المعالجة المباشرة (تعديلات بسيطة)

الأفضل لـ:

  • نقل ميزات مفردة
  • تحديثات سريعة للخصائص
  • حذف الميزات
  • تعديلات هندسية بسيطة

كيف تعمل:

1. حدد ميزة على الخريطة أو في الجدول
2. حرّر مباشرة (سحب، نموذج الخصائص)
3. يُتتبع التغيير تلقائياً
4. أرسل عندما تكون مستعداً

المزايا:

  • سريع، بدون خطوات وسيطة
  • نمط مألوف (تحرير في المكان)
  • حمل أدنى على واجهة المستخدم

تجهيز الرسم (عمليات معقدة)

الأفضل لـ:

  • استيراد بيانات خارجية (ملفات GeoJSON، ESRI)
  • تحرير هندسي معقد (إعادة تشكيل المضلعات)
  • عمليات دفعية (إنشاء العديد من الميزات)
  • المراجعة قبل التثبيت

كيف تعمل:

1. حمّل الميزات إلى Draw (عمليات الاستيراد، زر تحميل إلى Draw)
2. حرّر في وضع Draw (إعادة تشكيل، تقسيم، دمج)
3. حدد الطبقة المستهدفة
4. ثبّت إلى الميزات (تُتتبع كغير ملتزم بها)
5. أرسل عندما تكون مستعداً

المزايا:

  • منطقة تجهيز للمراجعة
  • أدوات هندسية متقدمة
  • فصل عمليات الاستيراد عن الميزات الحقيقية
  • تراجع على مستوى Draw (قبل التثبيت)

ترميز الألوان:

  • أزرق - ميزاتك المحددة المحمّلة إلى Draw
  • برتقالي - تعارضات من مستخدمين آخرين (للقراءة فقط)
  • افتراضي - عمليات الاستيراد والميزات المرسومة يدوياً

حل التعارضات

كيف تحدث التعارضات

التعارضات المكانية:

  • يضيف مستخدمان ميزات في الموقع نفسه
  • وضع بنية تحتية متداخلة
  • تصميمات شبكة متنافسة

تعارضات المعرّف:

  • الميزة نفسها يحررها عدة مستخدمين
  • تغييرات خصائص مختلفة
  • تعديلات هندسية

عرض التعارضات

زر تحميل التعارضات (DrawToolbar):

  • يجلب التغييرات غير الملتزم بها من المستخدمين الآخرين
  • يعرضها كميزات برتقالية في Draw
  • للقراءة فقط - لا يمكن تثبيت مسودات الآخرين
  • يساعد في التنسيق قبل الإرسال

سير العمل:

1. انقر "تحميل التعارضات" في DrawToolbar
2. تظهر ميزات برتقالية (مسودات الآخرين)
3. راجع التداخل المكاني
4. عدّل ميزاتك إذا لزم الأمر
5. أرسل تغييراتك (تُؤشَّر التعارضات)

حل التعارضات

الخيار ١: التنسيق مع الفريق

  • اعرف من يقوم بالتحرير (يُظهر التعارض بريد المستخدم الإلكتروني)
  • تناقشوا عبر الدردشة/الهاتف
  • اتفقوا على من يُرسل أولاً

الخيار ٢: الإرسال التسلسلي

  • يُرسل مستخدم واحد
  • يُعيد المستخدم الآخر المزامنة
  • يعدّل المستخدم الثاني ويُرسل

الخيار ٣: الدمج اليدوي

  • حمّل التعارضات لرؤية كلا الإصدارين
  • أنشئ ميزة مدموجة يدوياً
  • يعيد كلا المستخدمَيْن المزامنة ويقبلان الدمج

تتبع التغييرات غير الملتزم بها

الميزات التي أنشأتَها أو حرّرتَها أو استوردتَها — ولكن لم تُرسلها بعد — تُتتبع كـ غير ملتزم بها. تُظهر شارة برتقالية على زر الميزات المحددة عدد التغييرات غير الملتزم بها في جلستك الحالية.

تتحدث الشارة في الوقت الفعلي:

  • تزيد عند تثبيت الميزات من منطقة تجهيز Draw
  • تُعاد إلى الصفر عند الإرسال
  • تُعاد إلى الصفر عند إعادة المزامنة (تجاهل جميع التغييرات غير الملتزم بها)

استخدم عدد الشارة كتذكير للإرسال بانتظام. العدد المرتفع يعني أن الكثير من العمل قد يُفقد إذا أُغلق المتصفح قبل الإرسال.

أفضل الممارسات

متى تُرسل

الأوقات الموصى بها:

  • نهاية كل جلسة عمل
  • بعد إكمال وحدة عمل منطقية
  • قبل التبديل بين المشاريع
  • عندما يبدو عدد الشارة "مرتفعاً جداً"
  • قبل الانفصال عن الإنترنت (يحفظ كنقطة تفتيش)

تجنّب:

  • إرسال عمل غير مكتمل (يربك الفريق)
  • عدم الإرسال مطلقاً (خطر فقدان البيانات)
  • الإرسال المستمر (يُحدث ضوضاء إصدارات)

استراتيجية التحرير دون اتصال

١. المزامنة قبل الانفصال عن الإنترنت:

1. أعد المزامنة للحصول على الأحدث
2. قم بالتغييرات دون اتصال
3. أرسل عند عودة الاتصال

٢. التحقق من التعارضات:

1. حمّل التعارضات قبل التعديلات الكبرى
2. نسّق مع المستخدمين الظاهرين
3. أرسل العمل غير المتداخل أولاً

٣. نقاط تفتيش منتظمة:

1. أرسل كل ٣٠-٦٠ دقيقة
2. ينشئ نقاط استعادة
3. يشارك التقدم مع الفريق

مراجعة سجل الإصدارات

تحقق من من غيّر ماذا:

  • تُظهر سجلات الإصدارات المستخدم والطابع الزمني والعملية
  • لا تزال الإصدارات المضغوطة قابلة لإعادة البناء
  • سجل تدقيق للامتثال

عملية التراجع:

1. حدّد الإصدار المُشكل
2. أعد المزامنة لما قبل التثبيت المُشكل
3. أعد التغييرات بشكل صحيح
4. أرسل إصداراً جديداً

ميزة تحميل إلى Draw

الغرض

تتيح معالجة هندسية معقدة تتجاوز السحب والإفلات البسيط:

  • إعادة تشكيل حدود المضلعات
  • تقسيم الخطوط إلى مقاطع
  • دمج المناطق المتجاورة
  • عمليات هندسية متقدمة

كيفية الاستخدام

من جدول الميزات المحددة:

1. حدد الصفوف في الجدول (مربع اختيار)
2. انقر زر "تحميل إلى Draw" (أيقونة القلم)
3. تظهر الميزات في Draw (أزرق)
4. حرّر باستخدام أدوات Draw
5. حدد الطبقة المستهدفة
6. انقر زر التثبيت
7. تحصل الميزات على علامة _uncommitted
8. أرسل عندما تكون مستعداً

التصميم:

  • اختيارات المستخدم: أزرق (#3b82f6)
  • التعارضات: برتقالي (#f97316، للقراءة فقط)
  • عمليات الاستيراد: ألوان Draw الافتراضية

العمليات المتقدمة

إعادة تشكيل المضلعات: ١. حمّل المضلع إلى Draw ٢. انقر على الرؤوس لتحريكها ٣. أضف/أزل نقاطاً ٤. ثبّت مرة أخرى إلى الميزات

تقسيم الميزات: ١. حمّل الخط/المضلع إلى Draw ٢. استخدم أدوات Draw لإنشاء التقسيم ٣. ثبّت كميزات منفصلة

دمج المناطق: ١. حمّل مضلعات متعددة إلى Draw ٢. احذف الحدود بينها ٣. أنشئ مضلعاً واحداً مدموجاً ٤. ثبّت النتيجة

استكشاف الأخطاء وإصلاحها

"التغييرات لا تُحفَظ"

تحقق من:

  • هل يتزايد عدد شارة غير الملتزم بها؟
  • هل زر الإرسال نشط؟
  • هل توجد أخطاء في وحدة تحكم المتصفح؟

الحل:

  • تحقق من اتصال الشبكة
  • تأكد من أن تخزين المتصفح ليس ممتلئاً
  • أرسل لإبقاء التغييرات

"فقدتُ تغييراتي بعد إعادة التحميل"

السبب:

  • التغييرات غير الملتزم بها مخزّنة في تخزين المتصفح
  • أدّت إعادة المزامنة إلى مسح التغييرات المحلية
  • مُسح تخزين المتصفح

الوقاية:

  • أرسل قبل إغلاق المتصفح
  • نقاط تفتيش إرسال منتظمة
  • لا تعتمد على ذاكرة التخزين المؤقت للمتصفح

"التعارض لا يُحل"

الخطوات: ١. حمّل التعارضات لرؤية الإصدار الآخر ٢. تواصل مع المستخدم الآخر ٣. يُعيد مستخدم واحد المزامنة ٤. عدّل وأرسل مرة أخرى ٥. يُعيد المستخدم الثاني المزامنة ويُتابع

"التراجع/الإعادة لا يعملان"

القيود:

  • تغييرات الجلسة فقط
  • تُمسح عند إعادة تحميل الصفحة
  • لا يمكن التراجع عن التغييرات المرسلة

الحل البديل:

  • أعد المزامنة إلى ما قبل التثبيت المُشكل
  • أعد التغييرات بشكل صحيح
  • أرسل إصداراً جديداً

أدلة ذات صلة