قراءة الوزن من الميزان مباشرة في نظام بيع يعمل بالمتصفح
باختصار: إذا كان محل الحلويات أو الملحمة أو محل البهارات عندك يستخدم نظام بيع أو شاشة طلبات تعمل في المتصفح، فيمكن قراءة الوزن من الميزان الرقمي مباشرة بدل أن يكتبه الموظف بيده، عبر واجهة Web Serial في المتصفح، بشرط أن يكون الميزان يرسل الوزن عبر منفذ تسلسلي أو USB يظهر كمنفذ تسلسلي. الواجهة متاحة في بعض المتصفحات فقط، وتحتاج اتصالاً آمناً HTTPS وموافقة الموظف على اختيار الجهاز، لذلك خطط للحالة التي لا تعمل فيها.
لماذا يستحق الأمر التفكير
في محل يبيع بالوزن، يتكرر المشهد مئات المرات يومياً: الموظف يضع الكنافة أو اللحمة أو القهوة على الميزان، يقرأ الرقم، ثم يكتبه في شاشة النظام. كل إدخال يدوي فرصة لخطأ صغير: رقم مقلوب، أو فاصلة في مكان خاطئ، أو وزن الطلب السابق. والخطأ في الوزن يعني خطأ في السعر، إما على الزبون أو على المحل.
إذا كان الميزان قادراً على إرسال قراءته إلى جهاز آخر، فالأفضل أن يصل الرقم إلى النظام مباشرة، ويبقى للموظف دور التأكيد فقط.
ما هي Web Serial
تصف وثائق MDN واجهة Web Serial بأنها طريقة تتيح للمواقع القراءة من الأجهزة التسلسلية والكتابة إليها، سواء كانت أجهزة حقيقية متصلة بمنفذ تسلسلي أو أجهزة USB أو بلوتوث تحاكي المنفذ التسلسلي. كثير من الموازين التجارية، وقارئات الباركود القديمة، وبعض الطابعات، تتواصل بهذه الطريقة.
وتذكر الوثائق نقاطاً مهمة قبل أن تبدأ:
- الواجهة ليست مدعومة في كل المتصفحات الشائعة، وMDN تصنفها «توفر محدود».
- تعمل فقط في سياق آمن، أي على صفحة بعنوان HTTPS.
- لا يستطيع الموقع الوصول إلى جهاز من تلقاء نفسه. يجب أن يختار المستخدم المنفذ من نافذة يعرضها المتصفح بعد نقرة أو إجراء منه، ويمكن تقييد القائمة بمعرّف الشركة المصنعة للجهاز.
- بعد منح الإذن مرة، يستطيع الموقع معرفة المنافذ التي سبق أن سُمح له بها، والاستماع لحدثي الاتصال والانفصال.
قبل كتابة أي كود: اعرف ميزانك
هذه الخطوة تحدد إن كان المشروع ممكناً أصلاً. ابحث في دليل الميزان أو اسأل المورّد عن ثلاثة أشياء:
- هل في الميزان منفذ اتصال بالحاسوب، تسلسلي أو USB؟
- ما إعدادات الاتصال المطلوبة، مثل سرعة النقل؟
- ما شكل الرسالة التي يرسلها، وهل يرسل الوزن باستمرار أم عند الطلب أو عند الضغط على زر؟
كل شركة لها صيغة مختلفة لرسالة الوزن، وأحياناً كل طراز. لا تفترض صيغة؛ اطلبها مكتوبة من الدليل، أو اقرأ ما يصل من الميزان وحلّله بنفسك في بيئة اختبار.
الشكل العام للكود
بعد أن يضغط الموظف زر «ربط الميزان»، يطلب الموقع اختيار المنفذ، ثم يفتحه بالإعدادات التي يحددها دليل الميزان، ثم يقرأ البيانات في حلقة. الوثائق تعرض نمطاً للقراءة: حلقة خارجية تعيد إنشاء القارئ بعد الأخطاء غير القاتلة، وحلقة داخلية تقرأ القطع واحدة واحدة حتى يُلغى القارئ.
button.addEventListener('click', async () => {
const port = await navigator.serial.requestPort();
await port.open({ baudRate: 9600 }); // القيمة من دليل الميزان
// ثم اقرأ من port.readable وحلّل الأسطر حسب صيغة الجهاز
});
البيانات تصل بايتات، وقد تصل الرسالة الواحدة على عدة قطع. لذلك اجمع النص حتى نهاية السطر أو العلامة التي يستخدمها الميزان، ثم استخرج الرقم والوحدة.
اجعل الوزن «ثابتاً» قبل اعتماده
الموازين ترسل غالباً قراءات أثناء تحرك البضاعة على الكفة، وكثير منها يضيف علامة تقول إن القراءة مستقرة. اعتمد القراءة المستقرة فقط، أو انتظر حتى تتكرر القيمة نفسها عدة مرات متتالية. واعرض الوزن على الشاشة بخط كبير، مع زر «اعتمد» يضغطه الموظف، بدل أن يدخل الرقم في الفاتورة تلقائياً عند أول قراءة.
الوحدة والتقريب
تحقق من الوحدة التي يرسلها الميزان، غرام أو كيلوغرام، وحوّل إلى وحدة نظامك بطريقة واحدة ثابتة. وقرر قاعدة التقريب مسبقاً، واكتبها في مكان واحد في الكود، حتى لا يختلف الحساب بين شاشة الطلب والفاتورة. لا تحسب الأسعار من الوزن في المتصفح وحده؛ أرسل الوزن إلى الخادم ليحسب السعر من جدولك، كما تفعل مع أي مدخل آخر.
خطة بديلة لا غنى عنها
بما أن الواجهة غير مدعومة في كل المتصفحات، وقد ينقطع الكيبل أو يُعاد تشغيل الجهاز، يجب أن يبقى حقل الإدخال اليدوي موجوداً دائماً. اعرض حالة الاتصال بوضوح: «الميزان متصل» أو «غير متصل، أدخل الوزن يدوياً». واستمع لحدث الانفصال لتغيير الحالة فوراً. وحدد متصفحاً واحداً مدعوماً لأجهزة نقاط البيع في المحل، بدل أن تحاول دعم كل شيء.
الأمان والخصوصية
الواجهة لا تعطي أي موقع وصولاً صامتاً إلى أجهزتك، لأن اختيار المنفذ قرار المستخدم. ومع ذلك، اجعل صفحة نظام البيع خلف تسجيل دخول الموظفين، وعلى HTTPS، ولا تضع أكواد طرف ثالث غير ضرورية في الصفحة نفسها التي تتحدث مع الأجهزة.
سجل صغير يحميك من الخلاف
بما أن الوزن صار يصل آلياً، احفظ مع كل بند في الطلب الوزن كما وصل من الميزان، ووقت القراءة، وهل اعتُمد آلياً أم أُدخل يدوياً. هذا السجل لا يحتاجه الزبون، لكنه يفيدك عندما يسأل أحدهم عن فاتورة، أو عندما تلاحظ أن الإدخالات اليدوية كثرت في وردية معينة، ما قد يعني أن الكيبل يحتاج تبديلاً أو أن أحد الموظفين لا يعرف كيف يعيد الربط. وراجع معايرة الميزان نفسه حسب تعليمات الشركة المصنعة، فالربط بالمتصفح ينقل الرقم بدقة لكنه لا يصحح ميزاناً غير معاير.
مثال توضيحي: محل حلويات يبيع بالكيلو
هذا مثال توضيحي لطريقة العمل، دون جهاز أو نتائج حقيقية. محل حلويات في السلط يستخدم شاشة طلبات على حاسوب صغير بجانب الميزان. حصل المحل من المورّد على دليل يوضح إعدادات الاتصال وصيغة سطر الوزن. أضاف المطور زر «ربط الميزان» يظهر مرة عند بداية الدوام، وحلقة قراءة تعرض الوزن المستقر بخط كبير، وزر «أضف للطلب» يرسل الوزن إلى الخادم. بقي الحقل اليدوي ظاهراً، وتحولت حالة الاتصال إلى اللون الرمادي عند فصل الكيبل. ثم اختبر الفريق عدة أوزان معروفة مسبقاً للتأكد أن الرقم على الشاشة يطابق شاشة الميزان نفسها.
أسئلة شائعة
هل أي ميزان بيشتغل مع المتصفح؟
لا. يجب أن يكون للميزان منفذ اتصال يرسل القراءات، وأن تعرف صيغة رسالته من الدليل أو المورّد. الموازين البسيطة دون منفذ لا تتصل.
على أي متصفح بتشتغل Web Serial؟
ليس على كل المتصفحات. MDN تصنفها محدودة التوفر، فاختر متصفحاً يدعمها لأجهزة المحل واختبره قبل الاعتماد عليه.
هل الموقع بيقدر يوصل للميزان بدون إذني؟
لا. المستخدم يختار المنفذ بنفسه من نافذة المتصفح، والواجهة تعمل فقط على صفحات HTTPS.
شو بصير إذا انقطع الاتصال وقت الزحمة؟
يجب أن يبقى الإدخال اليدوي متاحاً دائماً، مع إشارة واضحة لحالة الاتصال، حتى لا يتوقف البيع.
إذا كان موظفوك يكتبون الأوزان بأيديهم في نظام البيع، اكتب لنا ونفحص معك إن كان ميزانك يمكن ربطه بالمتصفح.