علامة المستأجر التجارية

تعد علامة المستأجر التجارية التكوين الشامل للعلامة البيضاء (White-label) لمنصة Bizaldo. يقوم المستأجر بتعيين هويته المشتركة مرة واحدة في لوحة الإدارة، وتطلب التطبيقات المدعومة العلامة التجارية المحفوظة عند تحميلها. وهي منفصلة عن الشعار والألوان المحددة لصفحة الطلب أو الحجز العامة لشركة فردية.
تتوفر علامة المستأجر التجارية لـ المسؤول المتميز (Super Admin) للمستأجر في عمليات النشر المؤسسية. في الإدارة السحابية، يدير مسؤول المنصة العلامة التجارية للترخيص المعني بدلاً من ذلك.

تعيين علامة المستأجر التجارية في لوحة الإدارة

  1. تسجيل الدخول إلى لوحة إدارة المستأجر كمسؤول.
  2. افتح الإعدادات ← العلامة التجارية.
  3. قم بتعيين اسم التطبيق، ومعرف حزمة Android، واللغة الافتراضية، وعنوان URL الأساسي لـ API، وعنوان URL للتحقق من التحديثات.
  4. قم بتحميل أيقونة المستأجر، وعند الحاجة، صورة شاشة البداية (Splash image).
  5. قم بتعيين ألوان العلامة التجارية الأساسية والثانوية.
  6. حدد حفظ.
يؤدي الحفظ إلى إرسال سجل العلامة التجارية إلى خدمة الترخيص. تقوم الواجهة الخلفية للمستأجر على الفور بتحديث ذاكرة التخزين المؤقت المحلية بعد الحفظ الناجح، حتى تتمكن التطبيقات المدعومة من استلام الإصدار الجديد دون انتظار دورة التحقق المجدولة للترخيص.

ماذا يحدث بعد الحفظ

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

ما تتم مشاركته

تنشر الواجهة الخلفية حمولة علامة تجارية ذات إصدار محدد بدون مصادقة على `GET /api/config/branding`. تتضمن اسم الشركة ورابط الشعار ورابط السمة واللغة الافتراضية والإصدار. يحل رابط السمة الألوان الأساسية والثانوية. يتم إلحاق الإصدار بعناوين URL الخاصة بالشعار وأصول السمة. يؤدي ذلك إلى قيام العملاء بطلب الأصول المحدثة بعد تغيير العلامة التجارية بدلاً من الاستمرار في استخدام شعار أو سمة قديمة مخزنة مؤقتًا. إذا لم تكن لدى الخدمة علامة تجارية مخزنة مؤقتًا للمستأجر، أو تعذر على العميل تحميلها، يعود العميل إلى هوية Bizaldo المدمجة. تستمر ذاكرة التخزين المؤقت للواجهة الخلفية، بحيث يمكن لنقطة النهاية العامة الاستمرار في تقديم آخر تكوين صالح للعلامة التجارية بعد إعادة تشغيل الواجهة الخلفية أو انقطاع خدمة الترخيص مؤقتًا.

أين تظهر العلامة التجارية اليوم

الواجهةالسلوك الحالي
لوحة الإدارةفي إصدارات المؤسسات، تطبق اسم الشركة والشعار والأيقونة المفضلة وعنوان المتصفح/PWA وبيانات التعريف وقيم سمات CSS الأساسية/الثانوية. يتم تحميل العلامة التجارية على الخادم للعرض الأولي، ثم تحديثها في المتصفح.
صفحة الطلبتطبق اسم الشركة والشعار والأيقونة المفضلة وعنوان المتصفح وبيانات تعريف لون السمة ومتغيرات CSS الأساسية/الثانوية في وقت التشغيل. يتم تحميلها من جانب الخادم وتحديثها على العميل، مع التخزين المحلي كخيار احتياطي دون اتصال.
شاشة المطبخ (KDS)تستهلك نقطة نهاية العلامة التجارية في وقت التشغيل. تطبق اسم الشركة وعنوان التطبيق والشعار وألوان السمة من العلامة التجارية بدلاً من الإعدادات الافتراضية المجمعة لـ Bizaldo.
الجهاز اللوحي / نظام البيعتستهلك نقطة نهاية العلامة التجارية في وقت التشغيل. تطبق اسم الشركة وعناوين نظام البيع وعرض العميل وأصل الشعار وألوان السمة من العلامة التجارية بدلاً من الإعدادات الافتراضية المجمعة لـ Bizaldo.
شاشة التلفازتوفر روابط التلفاز شاشة حالة الطلب الموجهة للعملاء، لكن المستودع الحالي لا يحتوي على مستهلك للعلامة التجارية في وقت التشغيل لتلك الواجهة. يجب التعامل معها على أنها تحمل علامة Bizaldo حتى يضيف تطبيق التلفاز جلب العلامة التجارية العام.
لذلك اكتمل تدفق إعداد المستأجر للوحة الإدارة وصفحة الطلب: احفظ في لوحة الإدارة، ثم أعد تحميل تطبيق الويب لرؤية العلامة التجارية الجديدة. لا تقوم عملاء المطبخ والأجهزة اللوحية والتلفاز الحالية بعد بتحميل تكوين العلامة التجارية العام، لذا تحتفظ بهوية Bizaldo المجمعة. وتتطلب تغييرًا في تنفيذ العميل قبل أن يظهر حفظ المستأجر هناك أيضًا.

كيف تطبقها تطبيقات الويب المدعومة

  1. يطلب التطبيق تكوين العلامة التجارية العام للواجهة الخلفية.
  2. يقرأ ملف JSON المستضاف للسمة للحصول على الألوان الأساسية والثانوية.
  3. يحقن متغيرات CSS ويحدث إطار المتصفح: العنوان، والأيقونة المفضلة، وأيقونة Apple touch، ولون السمة.
  4. يخزن أحدث حمولة صالحة محليًا، ثم يحدثها دون استخدام ذاكرة التخزين المؤقت لـ HTTP في الزيارات اللاحقة.
تطبق لوحة الإدارة هذا فقط في إصدار المؤسسات. يتحقق تطبيق العلامة التجارية في وقت التشغيل لصفحة الطلب أيضًا من وضع إصدار المؤسسة. تحتفظ القوالب السحابية بهوية Bizaldo على الرغم من أن مسؤولي المنصة يمكنهم الاحتفاظ بسجلات العلامة التجارية للتراخيص.

التحقق من تغيير علامة المستأجر التجارية

بعد الحفظ، استخدم التحقق السريع التالي:
  1. أعد تحميل لوحة الإدارة وتأكد من شعار الرأس/تسجيل الدخول، واللون الأساسي، وعنوان المتصفح، والأيقونة المفضلة.
  2. افتح صفحة الطلب في نافذة خاصة/تصفح متخفٍ جديدة وتأكد من شعارها وعنوان الصفحة والأيقونة المفضلة واللمسات الأساسية/الثانوية.
  3. تحقق من شاشة المطبخ والأجهزة اللوحية/نظام البيع وشاشة التلفاز بشكل منفصل. مظهر Bizaldo الحالي هو السلوك المتوقع حاليًا، وليس فشل مزامنة.
  4. إذا كان تطبيق الويب المدعوم لا يزال يعرض الشعار القديم، فقم بإجراء تحديث كامل أو افتح نافذة خاصة. تأكد من زيادة إصدار العلامة التجارية المحفوظة وإمكانية الوصول إلى الأصول التي تم تحميلها من العميل.

ملاحظة تنفيذية لتطبيقات الأجهزة الذكية والتلفاز

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