السجل واللقطات والاستعادة — ما تتذكره الطبقة القابلة للتحرير

ثلاثة أنواع من الذاكرة¶

تتذكر الطبقة القابلة للتحرير بثلاث طرق، وتجيب كلٌّ عن أسئلة مختلفة:

الذاكرة	تجيب عن	أين
سجل التعديلات	من غيّر أي معلم، ومتى، ومن ماذا إلى ماذا	تبويب التحرير ← السجل في العنصر، والواجهة البرمجية
اللقطات	كيف كانت الطبقة كلها في لحظة	تبويب التحرير ← اللقطات في العنصر وسجل إصداراته
الإصدارات	ما رُفع وما أُخذت له لقطة، بالترتيب	سجل إصدارات العنصر

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

سجل التعديلات¶

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

يعرض تبويب السجل آخر خمسين قيدًا وعمليات السحب التي تحتفظ بها الأدوات الأخرى. وتعيد الواجهة البرمجية السجل الكامل مرشَّحًا بالمعلم أو الشخص أو الإصدار. قراءة السجل تحتاج إلى صلاحية السجل (المحررون فأعلى على العنصر؛ المساهمون فأعلى في المنظمة).

الاحتفاظ. تطوي المنصة السجل بعد نافذة احتفاظها، تسعون يومًا افتراضيًا يضبطها مسؤول. الطيّ يزيل القيود القديمة ويرفع أرضية السجل للطبقة؛ نسخة جيو حيّز التي إصدارها تحت الأرضية لا تستطيع طلب «كل شيء منذ» بعدها ويُطلب منها سحب الطبقة من جديد. اللقطات لا يمسها الطيّ.

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

اللقطات¶

اللقطة تصدّر الصفوف الحية وتحفظها إصدارًا جديدًا للعنصر، معلَّمًا لقطة في سجل الإصدارات، مع إصدار التحرير وعدد المعالم عند قطعها. أخذها يحتاج إلى صلاحية القفل وطبقة مفعَّل فيها التحرير.

تتصرف اللقطة كأي إصدار:

• تُفحص قبل أن تُقدَّم؛
• يمكن تنزيلها (GeoJSON) ومشاركتها برابط أو في غرفة بيانات؛
• تُحتسب على التخزين؛
• لا تُستضاف طبقةً مستقلة أبدًا، ولا تستبدل الطبقة الحية من تلقاء نفسها أبدًا.

عمودان يسافران مع اللقطة: مراجعة المعلم وعلم قفله. أما من غيّر معلمًا ومتى فلا يسافران، لأن اللقطة بيانات لا سجل.

خذ لقطة قبل أي شيء قد تريد التراجع عنه: قبل إيقاف التحرير لرفع ملف جديد، وقبل قفل كبير بمرشّح، وقبل فتح طبقة لفريق جديد، وبجدول إن كانت الطبقة مهمة.

الاستعادة¶

الاستعادة تعيد صفوف لقطة إلى الطبقة الحية. تحتاج إلى صلاحية القفل، وتحرير مفعَّل، ولقطة فُحصت سليمة. بالترتيب:

1. تُحفظ الحالة الحالية لقطةَ أمان، فالاستعادة نفسها قابلة للتراجع؛
2. تحل صفوف اللقطة محل الصفوف الحية؛ يحصل كل معلم على هوية جديدة، وتعود معها أعلام القفل المحفوظة في اللقطة؛
3. يتحرك إصدار التحرير وتُرفع أرضية السجل إلى ما بعد الاستعادة، فلا يستطيع عميل طلب تغييرات عبرها؛
4. تنتهي صلاحية كل سحب للطبقة في جيو حيّز؛ يطلب سطح المكتب من كل شخص سحب الطبقة من جديد، وتبقى تعديلاتهم غير المزامَنة في طبقتهم القديمة لينسخوها؛
5. تتحرك مراجعة النشر، فتعرض الخرائط التي تتبع الطبقة المنشورة الصفوف المستعادة، ويصبح أرشيف PMTiles قديمًا.

الاستعادة لا تحذف أي إصدار: اللقطة التي استعدت منها، ولقطة الأمان، والرفع الأصلي تبقى كلها في السجل.

الرفع أثناء تفعيل التحرير¶

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

العنصر المرتبط هو الاستثناء الذي عليك إدارته بنفسك: مزامنته لا يحجبها التحرير، فجمّد الرابط نسخةً ثابتة قبل أن تفعّل التحرير. انظر قابل للتحرير أم لا.

ما لا يُتذكَّر¶

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