المسرد

مرجع سريع للمصطلحات الخاصة بـ Aptli المستخدمة في جميع أنحاء المنصة وهذا الدليل.

البيانات والسجلات

النموذج ذو الإصدارات

سجلات تمر بدورة مسودة → مقارنة → تأكيد قبل أن تصبح التغييرات دائمة. تدعم السجلات ذات الإصدارات التحرير دون اتصال والتراجع/الإعادة واكتشاف التعارضات وتاريخًا كاملًا للإصدارات. في Aptli، تستخدم عناصر الخريطة (النقاط والخطوط والمضلعات والطبقات والمخططات) والمهام النموذج ذا الإصدارات.

المقابل: النموذج الفوري

النموذج الفوري

سجلات تُحفظ فورًا على الخادم دون أي خطوة وسيطة. التغييرات مرئية لجميع المستخدمين على الفور. تستخدم أوامر العمل والتقارير والتحققات والمعاملات والمواقع النموذج الفوري.

المقابل: النموذج ذو الإصدارات

المسودة

مجموعة من التغييرات المحلية على السجلات ذات الإصدارات لم يتم تأكيدها على الخادم بعد. تُخزَّن المسودات في المتصفح (IndexedDB) وتستمر عبر إعادة تحميل الصفحة دون الحاجة إلى اتصال بالشبكة. يمكن للمستخدم امتلاك مسودة نشطة واحدة لكل إصدار. يمكن رفع المسودات إلى الخادم لمراجعة المسؤول قبل نشرها.

التأكيد (Commit)

فعل تطبيق تغييرات المسودة بشكل دائم على مجموعة البيانات الحية. يُنشئ التأكيد إدخالًا جديدًا غير قابل للتعديل في تاريخ الإصدارات. يمكن فقط للمستخدمين الذين يمتلكون حق المسؤول allowCommits إجراء التأكيد.

تعارض الإصدارات

يحدث عندما يكون مستخدمان قد عدّلا نفس العنصر في مسودتين منفصلتين دون اتصال. يكتشف Aptli التعارضات عند التأكيد بمقارنة الإصدار الأساسي الذي بُنيت عليه كل مسودة بالإصدار الحي الحالي. تُوضَع التأكيدات المتعارضة للمراجعة من قِبل المسؤول ولا يمكن تطبيقها حتى يتم حلها — دون أي كتابة صامتة فوق البيانات.

المخزون

المورد

تعريف لمادة أو مستهلك أو نوع معدات أو فئة عمالة. تحدد الموارد وحدة القياس والتحويلات الاختيارية للوحدات وما إذا كان استلام المورد يتطلب منسّقًا. أمثلة: كابل ألياف ضوئية 500 م، مسمار تثبيت خرساني، ساعة فريق تركيب.

عنصر المخزون

الرصيد الحالي لمورد محدد في موقع محدد. تُحدَّث عناصر المخزون حصريًا عبر المعاملات — ولا تُعدَّل مباشرةً أبدًا. يمكن أن يمتلك المورد عناصر مخزون في مواقع متعددة في وقت واحد.

الموقع

مكان مادي أو منطقي يحتوي على مخزون. تشمل المواقع المستودعات وساحات التخزين والمستودعات الميدانية و«المواقع الشخصية» للعمال الأفراد والمركبات. يمكن لكل مستخدم امتلاك موقع شخصي يتلقى المخزون عبر مسح رموز الاستلام بالرمز المربّع.

المعاملة

إدخال دفتر أستاذ غير قابل للتعديل يسجّل كل حركة مخزون. لا يمكن تعديل المعاملات أو حذفها — تُجرى التصحيحات دائمًا بإنشاء معاملة تعديل جديدة. أنواع المعاملات:

رمز الاستلام

رمز مربّع موقّع بـ JWT ومحدود المدة، يُصدر عند إسناد أمر عمل. يقوم العمال الميدانيون بمسح رمز الاستلام في المستودع لتفويض استلام المواد المخصصة لهم. تُشفَّر في رموز الاستلام الكميات المُفوَّضة من الموارد والإسناد الذي تنتمي إليه ووقت الانتهاء. يمكن فقط للعامل المُسند إليه — أو مستخدم يمتلك حق canFacilitatePickups — مسحه.

رمز النقل

رمز مربّع موقّع بـ JWT يُفوّض نقل مخزون من نظير إلى نظير بين المواقع. على خلاف رموز الاستلام، لا ترتبط رموز النقل بأمر عمل. يمكن إنشاؤها لأي حركة بين موقعين ومسحها من قِبل المستلم لتنفيذ النقل وتسجيل المعاملة تلقائيًا.

تنفيذ الأعمال

المهمة

وحدة عمل مخطط لها بموقع جغرافي مكاني ومتطلبات موارد محددة. المهام ذات إصدارات — تمر بمسودة → تأكيد كعناصر الخريطة. يمكن تحديد موقع مهمة عند نقطة (بئر تفتيش)، أو خط (قطعة طريق)، أو مضلع (مجمع سكني)، أو تركها بدون موقع للعمل المكتبي. تنتمي المهام إلى مشاريع وتُنجز عبر أوامر العمل.

أمر العمل

تخصيص مهمة واحدة أو أكثر لفريق، مع تاريخ استحقاق ورمز استلام اختياري للمواد. تتتبع أوامر العمل الحالة (معلّق → قيد التنفيذ → مكتمل) في الوقت الفعلي. يُشار إليه أيضًا بـ الإسناد.

التقرير

سجل العامل الميداني للعمل المنجز. تلتقط التقارير ما تم إنجازه وموقع GPS والموارد المستهلكة فعليًا والصور. يمكن تقديم التقارير لمهمة رسمية أو بشكل مخصص للصيانة غير المخطط لها. يؤدي تقديم تقرير إلى تشغيل خصومات المخزون التلقائية وإخطار المشرفين.

التحقق

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

المشروع

مجموعة من المهام ذات الصلة تشترك في تاريخ استحقاق وتعيين فريق. توفر المشاريع عرضًا شاملًا لمستوى التقدم عبر جميع مهامها وتقاريرها.

الأمان والوصول

حقوق المسؤول

صلاحيات تتحكم فيما يمكن للمستخدم القيام به. يمتلك Aptli أكثر من 40 حق مسؤول دقيق يغطي كل إجراء إنشاء وقراءة وتحديث وحذف في النظام. أمثلة: workOrdersCreate، reportsDelete، allowCommits، canFacilitatePickups، canRunAiQueries. حقوق المسؤول تراكمية — لا يمكن للمستخدم الذي لا يمتلك أي حقوق سوى قراءة إسناداته الخاصة.

قيد الدور

فلاتر مقيِّدة على مستوى الحقول تتحكم في البيانات التي لا يمكن للمستخدم رؤيتها. تُطبَّق قيود الأدوار من جانب الخادم: لا تُرسَل البيانات غير المصرح بها إلى العميل أبدًا، بل تُخفى فقط في واجهة المستخدم. مثال: يحدّ قيد assignedTo = currentUser المتعاقدَ برؤية أوامر عمله الخاصة فقط. تعمل قيود الأدوار وحقوق المسؤول كطبقتين مستقلتين.

الخريطة ونظم المعلومات الجغرافية

الطبقة

مجموعة مسمّاة من عناصر الخريطة تشترك في نوع هندسي (نقاط أو خطوط أو مضلعات) وأسلوب بصري (أيقونة ولون وسماكة خط). تحدد الطبقات ماهية العنصر — على سبيل المثال، طبقة «أعمدة الهاتف» أو طبقة «مسارات القنوات». الطبقات ذات إصدارات.

المخطط التخطيطي

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

منطقة الرسم المؤقتة

منطقة تحرير مؤقتة يُرسم فيها الشكل الهندسي ويُنقَّح قبل تأكيده في عناصر الخريطة الدائمة. تتيح منطقة الرسم المؤقتة إجراء تعديلات معقدة — الرسم الحر والتقطير وعمليات متعددة العناصر — لمراجعتها قبل نشرها.