هذه الصفحة مرجع الحقول لصفحة الأجهزة والطباعة في لوحة معلومات التاجر، وهي ما يفتحه زر مساعدة أعلى الصفحة في تبويب جديد. لخطوات العمل اليومي راجع الأجهزة والطباعة.
الغرض من الشاشة: تعرض هذه الصفحة الحالة المطلوبة مقابل الحالة المرصودة لكل جهاز مسجّل في المنشأة، وتتيح إصدار أوامر موقّعة مرتبطة بجهاز واحد وذات مدة انتهاء. نظرة عامة هي تقرير الأسطول، والإدارة هي محرّر الحالة المطلوبة والأوامر الأخيرة لجهاز مختار. تُعاد قراءة القائمة كل ١٥ ثانية.
رأس الصفحة والإجراءات
| الحقل | المعنى |
|---|
| إبطال جهاز | ينقلك إلى الإعدادات حيث يُبطل الجهاز نهائيًا. التعطيل من هذه الصفحة قابل للتراجع، أما الإبطال فيُنهي بيانات اعتماد الجهاز ولا يمكن التراجع عنه. |
|---|
| نشر الإعدادات | الإجراء الرئيسي: يفتح صفحة نشر الإعدادات التي تبيّن أي لقطة إعدادات يشغّلها كل جهاز. إعداد الطابعات وأدراج النقد ليس على هذه الشاشة. |
|---|
| وضع الصفحة | مفتاح بين «نظرة عامة» (البطاقات وجدول الأجهزة) و«الإدارة» (محرّر الجهاز المختار). الوضع محفوظ في عنوان الصفحة فيمكن مشاركة رابط لأي منهما. |
|---|
| صلاحية مطلوبة | تنبيه يظهر لمن يملك صلاحية عرض الأسطول fleet-view دون صلاحية إدارته fleet-manage: الصفحة كلها للقراءة، وحقول الحالة المطلوبة معطّلة، ولا يظهر زرا الحفظ وإصدار الأمر ولا زر الإلغاء التعويضي. |
|---|
بطاقات النظرة العامة
| الحقل | المعنى |
|---|
| أجهزة مسجّلة | عدد الأجهزة المسجّلة في هذه المنشأة كما أعادها الخادم، بغضّ النظر عن اتصالها. |
|---|
| مُبلِّغة | الأجهزة التي بلّغت عن حالتها داخل فترتها المتوقعة؛ ما تعرضه لها هو حالتها الآن. |
|---|
| متوقفة عن التبليغ | الأجهزة التي لم تبلّغ داخل فترتها. ما يظهر لها هو آخر ما قالته لا ما تفعله الآن، وهذا لا يعني بالضرورة أنها معطوبة. تتلوّن البطاقة تحذيريًا عندما يكون العدد أكبر من صفر. |
|---|
| أوامر معلّقة | مجموع الأوامر الصادرة لكل الأجهزة التي لم يقرّ بها الجهاز ولم تنتهِ صلاحيتها بعد. |
|---|
جدول الأجهزة
| الحقل | المعنى |
|---|
| الجهاز | رمز الجهاز بخط لاتيني وتحته اسمه المعروض. الضغط على الصف يفتح الجهاز في وضع الإدارة. |
|---|
| الإصدار | إصدار التطبيق الذي رصده الجهاز آخر مرة، أو إصداره المسجّل إن لم يبلّغ، أو شرطة إن لم يُعرف. يظهر تحته سهم وإصدار مستهدف عندما تحدّد الحالة المطلوبة إصدارًا أعلى. |
|---|
| الحلقة | حلقة التحديث المطلوبة للجهاز: تجريبية أو مبكرة أو واسعة. جهاز بلا حالة مطلوبة يُعرض في الحلقة الواسعة. |
|---|
| آخر ظهور | تاريخ ووقت آخر تبليغ من الجهاز. «لم يظهر بعد» يعني أن الجهاز لم يتصل قط منذ تسجيله. |
|---|
| الحالة | «مُبلِّغ» عندما بلّغ الجهاز داخل فترته، و«متوقف» عندما تجاوزها. يظهر تحتها «الجهاز معطّل» بالأحمر عندما تكون الحالة المطلوبة له موقوفة، فيرفض الخادم منه كل بيع جديد. |
|---|
البطاقة الجانبية والملاحظات
| الحقل | المعنى |
|---|
| إصدار أمر | بطاقة تشرح مراحل تفعيل الأوامر وتسرد أي أمر في أي مرحلة: قراءة فقط (تشخيص)، خطورة منخفضة (مزامنة قسرية وتحديث الإعدادات)، مرحلة متقدمة (تعطيل وتسجيل خروج وتحضير تحديث). الأوامر خارج المرحلة المفعّلة حاليًا يرفضها الخادم لا هذه الشاشة. زر البطاقة يفتح نشر الإعدادات. |
|---|
| التوقف عن التبليغ ليس عطلًا | ملاحظة تذكّر بأن الجهاز الصامت يعرض آخر ما قاله، وأن كل أمر يُكتب في سجل التدقيق باسم من أصدره. |
|---|
| إعداد الطباعة ليس على هذه الشاشة | حالة غير متاحة صريحة: الطابعات وأدراج النقد جزء من إعدادات الجهاز التي تُنشر كلقطات، وهذه اللوحة تقرأ نتيجة النشر فقط عبر «نشر الإعدادات» ولا تحرّر الطابعات. |
|---|
الإدارة: قائمة الأجهزة والحالة المطلوبة
| الحقل | المعنى |
|---|
| الأجهزة في المنشأة | قائمة السجلات: رمز الجهاز، ثم اسمه وإصداره وحلقته، وشارة «مُبلِّغ» أو «متوقف». اختيار سجل يملأ المحرّر بحالته المطلوبة الحالية. يُفتح المحرّر على أول جهاز حتى تختار غيره، ويقع كل حفظ أو أمر على الجهاز الذي يعرضه المحرّر. |
|---|
| الحد الأدنى للإصدار | أقل إصدار تطبيق يُسمح للجهاز بالعمل عليه. اتركه فارغًا لعدم فرض حدّ. معطّل بدون صلاحية إدارة الأسطول. |
|---|
| الإصدار المستهدف | الإصدار الذي يُطلب من الجهاز الترقية إليه. يظهر في جدول النظرة العامة بعد سهم تحت الإصدار الحالي. اتركه فارغًا لعدم طلب ترقية. |
|---|
| الحلقة | قائمة اختيار حلقة التحديث: تجريبية أو مبكرة أو واسعة. تحدّد متى يصل التحديث إلى هذا الجهاز نسبةً إلى بقية الأسطول. |
|---|
| الجهاز مفعّل | مفتاح الحالة المطلوبة للبيع، وشارته «مفعّل» أو «موقوف». عند إيقافه وحفظه يرفض الخادم من هذا الجهاز كل بيع جديد واسترجاع وتصريح بيع دون اتصال، لكن المبيعات المسجّلة قبل التعطيل تُرفع كالمعتاد. إعادة تفعيله تعيد له البيع فورًا. |
|---|
| الجهاز معطّل | ملاحظة تحذيرية تظهر فوق الحقول عندما تكون الحالة المطلوبة المحفوظة للجهاز موقوفة، وتذكّر بأن التعطيل قابل للتراجع بخلاف الإبطال. |
|---|
| حفظ الحالة المطلوبة | يكتب الحقول الأربعة على الخادم مع رقم الإصدار المتوقع للحالة المطلوبة؛ إذا عدّلها شخص آخر في الأثناء يرفض الخادم الحفظ بخطأ ٤٠٩ فأعد تحميل الجهاز. يطبّق الجهاز الحالة الجديدة عند اتصاله التالي. يظهر الزر لمن يملك صلاحية إدارة الأسطول فقط. |
|---|
| استعادة القيم | يعيد الحقول إلى الحالة المطلوبة المحفوظة للجهاز المختار دون كتابة شيء. |
|---|
الأوامر الأخيرة
| الحقل | المعنى |
|---|
| نوع الأمر | اسم الأمر (مزامنة قسرية، تحديث الإعدادات، تشخيص، تحضير تحديث، تسجيل خروج، تعطيل) وتحته السبب المكتوب عند إصداره. «لا توجد أوامر حديثة على هذا الجهاز» عندما لم يُصدر له أمر. |
|---|
| الحالة | صادر: كُتب ولم يستلمه الجهاز بعد. مُسلَّم: استلمه الجهاز. مُقرّ: نفّذه الجهاز وأقرّ به. منتهي: انقضت صلاحيته قبل الإقرار. ملغى: أُصدر له أمر تعويضي. |
|---|
| الإقرار | نتيجة الإقرار كما أعادها الجهاز، ورمز الخطأ بعدها إن وُجد. شرطة عندما لم يقرّ الجهاز بعد. |
|---|
| إلغاء تعويضي | زر يظهر للأوامر الصادرة أو المُسلَّمة فقط، ولمن يملك صلاحية إدارة الأسطول. يُصدر أمرًا تعويضيًا ولا يحذف الأمر الأصلي، فيبقى الاثنان في السجل. |
|---|
نافذة إصدار أمر
| الحقل | المعنى |
|---|
| إصدار أمر | الإجراء الوحيد في لوحة «الإجراءات» بوضع الإدارة، ويفتح النافذة على الجهاز المختار. معطّل بدون صلاحية إدارة الأسطول. تعرض النافذة أولًا رمز الجهاز وإصداره وعدد أوامره المعلّقة. |
|---|
| نوع الأمر | قائمة الأوامر الستة. الأمر خارج المرحلة المفعّلة حاليًا يُرفض من الخادم عند الإرسال ويظهر خطؤه أعلى الصفحة. |
|---|
| مدة الصلاحية (ثوانٍ) | كم ثانية يبقى الأمر صالحًا قبل أن ينتهي دون إقرار. القيمة الافتراضية ٩٠٠ ثانية، وتُستخدم أيضًا إذا تُرك الحقل فارغًا. |
|---|
| الإصدار المستهدف | يظهر فقط عند اختيار «تحضير تحديث»: الإصدار الذي يُطلب من الجهاز تنزيله تمهيدًا للتحديث. |
|---|
| السبب | سبب مكتوب يُحفظ مع الأمر ويظهر في سجل التدقيق والأوامر الأخيرة. زر الإصدار معطّل حتى يبلغ السبب أربعة أحرف على الأقل. |
|---|
| إصدار الأمر | يرسل الأمر موقّعًا ومرتبطًا بهذا الجهاز وحده. يظهر بعدها في الأوامر الأخيرة حتى يقرّ به الجهاز أو تنتهي صلاحيته. |
|---|
شريط الملخص
| الحقل | المعنى |
|---|
| الحالة | «مفعّل» أو «معطّل — لا يمكنه البيع» بحسب الحالة المطلوبة المحفوظة للجهاز المختار. شرطة عندما لا يوجد جهاز مختار. |
|---|
| الإصدار | الإصدار المرصود للجهاز المختار، أو المسجّل، أو شرطة. |
|---|
| الطابور / التعارضات / غير المؤكدة | ثلاثة أرقام من آخر تبليغ للجهاز: عدد الكتابات المنتظرة في طابور المزامنة، وعدد التعارضات، وعدد النتائج غير المؤكدة. شرطة عندما لم يبلّغ الجهاز قط. |
|---|
| آخر ظهور | وقت آخر تبليغ من الجهاز المختار، أو «لم يظهر بعد». |
|---|
| الإصدار المتوقع expected_version | رقم إصدار الحالة المطلوبة المحفوظة الذي يُرسل مع الحفظ لمنع الكتابة فوق تغيير أحدث؛ نسخة قديمة تعيد ٤٠٩. شرطة حتى تُقرأ تفاصيل الجهاز. |
|---|
| ما تكتبه هذه الإجراءات | قائمة المسارات الثلاثة التي تستدعيها الصفحة عند الكتابة (حفظ الحالة المطلوبة، إصدار أمر، إلغاء أمر) مع أثر كل منها، لتكون الادعاءات على الشاشة قابلة للتحقق. |
|---|
حالات الوصول
| الحقل | المعنى |
|---|
| خارج صلاحيات دورك | تظهر بدل الصفحة كلها لمن لا يملك أيًا من صلاحيتي fleet-view أو fleet-manage، مع اسمَي الصلاحيتين وزر العودة إلى الرئيسية. يمنحها مسؤول حسابكم من الإعدادات ← المستخدمون والصلاحيات، وتُتحقق من الخادم في كل طلب. |
|---|
| غير مشمولة في خطتك | تظهر عندما لا تشمل خطتك قدرة «التحكم بالأجهزة» fleet.control، مع اسم خطتك الحالية وزر التواصل مع أيدي للترقية. بياناتك محفوظة كما هي، وتظهر الصفحة فور تغيير الخطة. |
|---|
| تعذر تحميل الأسطول | حالة خطأ تحل محل التقرير عندما تفشل قراءة الأجهزة، مع سبب الخطأ وزر «إعادة المحاولة». الأخطاء عند الحفظ أو إصدار أمر تظهر كملاحظة تحذيرية أعلى الصفحة مع رمز الخطأ. |
|---|