مسرد المصطلحات

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

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

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

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

على عكس: النموذج في الوقت الفعلي

النموذج في الوقت الحقيقي

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

على عكس: النموذج ذو الإصدارات

المسودة

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

التثبيت

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

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

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

المخزون

المورد

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

النشاط

تعريف نوع العمل الذي يؤديه طاقم العمل — الربط، سحب الكابلات، الحفر، الفحص. الأنشطة هي النظير الخاص بجانب العمل لـ الموارد: سجل مستقل بوحدات قياس خاصة به (§193)، يُشار إليه من خلال سطر النشاط في أمر العمل، إما عن طريق اختياره من الفهرس أو إدخاله بشكل مخصص. اختياري — لا يلزم أن يحدد أمر العمل أحدها. أمثلة: الربط بالانصهار، سحب الألياف (م)، الحفر الموجه (م). تُدار ضمن الإدارة → الأنشطة (activitiesCreate / activitiesUpdate / activitiesDelete).

عنصر المخزون

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

الموقع

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

المعاملة

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

رمز الاستلام

رمز QR محدد المدة ومقاوم للتلاعب يُصدر عند تخصيص أمر عمل. يقوم العاملون الميدانيون بمسح رمز الاستلام ضوئيًا في المستودع لتفويض واستلام المواد المخصصة لهم. تحتوي رموز الاستلام على كميات الموارد المصرح بها، والمهمة التي تنتمي إليها، ووقت انتهاء الصلاحية. لا يمكن مسحها ضوئيًا إلا للعامل المعين — أو المستخدم الذي يمتلك حق canFacilitatePickups.

رمز النقل

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

المورد المؤقت

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

سياسة الاستلام

الإعداد الوحيد على مستوى التحكم في المورد الذي يحكم من يحق له توزيع المورد أو استلامه، في كل مسار (استلام المهمة، الاستلام الذاتي، النقل). إحدى القيم الثلاث التالية:

الاستلام المُيسَّر

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

إنجاز العمل

المهمة

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

أمر العمل

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

المهمة

يُستخدم هذا المصطلح بالتبادل مع أمر العمل في جميع أنحاء Aptli. لا تزال بعض واجهات المستخدم تسمي هذا المفهوم «المهمة»، لكن السجل الأساسي وحقوق الإدارة الخاصة به تُسمى أمر العمل (workOrdersCreate، workOrdersUpdate، workOrdersDelete). وهي تشير إلى نفس الشيء.

التقرير

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

التحقق

مراجعة ضمان الجودة التي يجريها المشرف على التقرير المقدم. تسجل عمليات التحقق النتيجة (مقبول / مرفوض / يحتاج إلى مراجعة / معتمد مع ملاحظات) وأي نتائج تم التوصل إليها. يؤدي التحقق المرفوض أو الذي يحتاج إلى مراجعة إلى إعادة التقرير إلى العامل؛ أما التحقق المعتمد فيمكن أن يؤدي إلى بدء حسابات صرف المدفوعات.

المشروع

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

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

حقوق الإدارة

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

قيود الأدوار

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

طلب الوصول

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

جلسة نشطة واحدة

يسمح نموذج الجلسة في Aptli بتسجيل دخول نشط واحد لكل حساب عبر جميع الأجهزة في أي وقت. يؤدي تسجيل الدخول على جهاز جديد إلى إنهاء الجلسة السابقة؛ ويظهر على الجهاز الذي تم طرده إشعار لمرة واحدة ثم يعود إلى صفحة تسجيل الدخول. تتشارك علامتا تبويب في نفس ملف تعريف المتصفح الجلسة ولا تطرد إحداهما الأخرى.

القفل التام

حالة الحساب التي تمنع تسجيل الدخول بأي طريقة. يتم تفعيلها تلقائيًا بعد محاولات تسجيل دخول فاشلة متكررة (الافتراضي: 10 محاولات فاشلة متتالية) أو يتم تعيينها يدويًّا بواسطة المسؤول. لا يمكن إلغاء هذا الإغلاق إلا من قبل مسؤول يمتلك حق usersUpdate.

وضع الصيانة

وضع يتم تشغيله من قبل المسؤول ويحظر عمليات الكتابة من قبل غير المسؤولين ويعرض لافتة لجميع المستخدمين. يُقصد به فترات قصيرة عند تشغيل عملية ترحيل أو مهمة دفعية، حيث قد تتداخل عمليات الكتابة من قبل المستخدمين مع الأعمال التشغيلية. يحتفظ المسؤولون بالوصول الكامل.

سجل التدقيق

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

مؤرشف (محذوف مؤقتًا)

سجل تم وضع علامة «محذوف» عليه ولكن تم الاحتفاظ به فعليًا. يتم إخفاء السجلات المؤرشفة عن القوائم والاستعلامات العادية؛ ويمكن للمستخدمين الذين يتمتعون بحق viewDeleted الكشف عنها وإلغاء حذفها إذا لزم الأمر. نادرًا ما يقوم Aptli بالحذف النهائي — حيث يحافظ الأرشيف على سجل التدقيق والتاريخ التشغيلي.

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

الطبقة

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

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

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

منطقة التحضير للرسم

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

سجلات الحقل

اسم سطح الخريطة في نظام التنقل في Aptli — حيث توجد الميزات الجغرافية ويتم رسمها وتحريرها وتتبعها. (تُفتح أدوات الخريطة كـ نوافذ من شريط أدواتها.)

النافذة

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

عدسة التنفيذ

طبقة خريطة تعيد تلوين الميزات الموجودة وفقًا لحالة العمل المستمدة منها، بحيث يمكن قراءة حالة المنطقة بنظرة واحدة. يمكن تفعيل عدة عدسات في آن واحد. تشمل العدسات التقدم، أوامر العمل الخاصة بي، تحتاج إلى التحقق، فاشلة، تم التحقق منها، تحتاج إلى مراجعة، موافق عليها مع ملاحظات، وغير مخصصة. يتم تشغيلها من مدير الطبقات → التراكبات.

عدسة التواجد

مكمل لـ عدسات التنفيذ الذي يبرز الميزات التي تحمل نوعًا معينًا من السجلات المرفقة: لديها مهمة، لديها مخطط، لديها موقع.

البحث الشامل

لوحة الأوامر على مستوى التطبيق، تُفتح بضغطة Cmd/Ctrl-K من أي صفحة. تبحث في سجلاتك عبر التطبيق وتنقلك إلى النتيجة. تختلف عن نافذة البحث في الخريطة، التي تبحث عن الميزات وتنتقل إليها.

العمل من الجهاز

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

الأتمتة والمراقبة

Hook

وجهة خارجية موقعة ومشتركة في الأحداث التي تختارها: قم بتزويدها بعنوان URL وسر التوقيع، وسيتم إرسال كل حدث مطابق إلى هناك عبر طلب POST. أبسط تكامل خارجي. انظر الأتمتة والمراقبة.

مشغل الأحداث

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

موصل الاستيعاب

مصدر بيانات خارجي يغذي قراءات المستشعرات/الأجهزة إلى Aptli — إما عن طريق السحب (يقوم Aptli باستقصاء واجهة برمجة تطبيقات المورد وفقًا لجدول زمني) أو الدفع (يقوم المرسل بإرسال طلبات POST إلى نقطة نهاية الموصل باستخدام مفتاح واجهة برمجة تطبيقات الاستيعاب).

المحطة

ميزة خريطة يُبلغ عنها المستشعر. بمجرد وصول القراءات، يُظهر سجل الميزة أحدث قيمة لكل مقياس وخط بياني مصغر لمدة 7 أيام.

الإنذار

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

النتيجة

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

حد الاستخدام

مقياس الاستهلاك التجاري لـ «الأتمتة»: يستهلك كل موصل استيعاب، ومفتاح API، وخطاف قابل لإعادة الاستخدام وحدة واحدة من رصيد مشترك (قواعد تشغيل الأحداث الداخلية غير محددة الاستهلاك). وتُدرج «الأتمتة» نفسها في كل خطة.

الاستلام العام (بوابة الخدمة)

الإرسال

سجل يتم إنشاؤه عندما يقدم أحد أفراد الجمهور طلبًا عبر بوابة الخدمة العامة — دون الحاجة إلى تسجيل الدخول. يحتوي على رقم مرجعي عام، وهندسة اختيارية، ومرفقات. يقوم الموظفون بفرز الطلب ويمكنهم تحويله إلى أمر عمل أو تقرير أو ميزة خريطة.

الرقم المرجعي

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

إعادة التوجيه للمتابعة

تحويل البلاغ إلى نظام خارجي كعملية تسليم أحادية الاتجاه، مصحوبة برابط رد قابل للاستخدام مرة واحدة وينتهي صلاحيته، حتى يتمكن النظام الخارجي من إرسال النتيجة مرة واحدة. لا يغير ذلك حالة البلاغ؛ ويظهر على النحو التالي: تم إعادة التوجيه → في انتظار الرد → تم الرد (أو منتهي الصلاحية / ملغى).

الرد للتنفيذ

إرسال أمر عمل عبر البريد الإلكتروني أو الرسائل القصيرة (SMS) حتى يتمكن المستلم من تقديم تقرير الإنجاز عن طريق الرد على الرسالة — دون الحاجة إلى تسجيل الدخول. روابط الرد قابلة للاستخدام مرة واحدة وتنتهي صلاحيتها.

التعاون والاستدامة

جلسة متعددة اللاعبين

جلسة تحرير مشترك مباشرة وفي الوقت الفعلي (الملحق «التصميم المشترك») يتم الدخول إليها بواسطة رمز مكون من 6 أرقام: يقوم شخصان أو أكثر بتحرير نفس الخريطة أو التسجيل معًا باستخدام مؤشرات مرئية، ويقوم المضيف بتثبيت النتيجة المتفق عليها في الخط الرئيسي. انظر متعدد اللاعبين.

ملف تعريف الأصول / الانبعاثات

تتيح الوظيفة الإضافية «Carbon» (في سجل ميزة الخريطة) إرفاق ملف تعريف الانبعاثات — الذي يربط الميزة بما تستهلكه بمعدل معين — بحيث يتم تتبع بصمتها من غازات الدفيئة مقارنةً بعوامل الانبعاث القياسية. انظر Carbon.

شريط معدل التحميل

مقياس صغير داخل التطبيق يوضح مدى قربك من حد معدل الطلبات — يظهر باللون الكهرماني عند الاقتراب منه، وباللون الأحمر عند بلوغ الحد الأقصى، مع حالة «Catching up…» (جاري اللحاق…) عندما يقوم التطبيق بتقنين الطلبات عمدًا. وهو مقياس إعلامي؛ يحمي سرعة الاستجابة في حالات الاستخدام المكثف.