تنظيم مدى التوفّر في الخلاصات

اختيار تنسيق لمدى التوفّر

تتوفّر طريقتان لتحديد بيانات مدى التوفّر: (1) مواضع مفتوحة أو (2) التكرار. اختَر طريقة واحدة فقط لاستخدامها مع جميع التجّار والخدمات. بعد اختيار طريقة، يجب الالتزام بها لدمجها بالكامل (الخلاصات وخادم الحجز والتحديثات في الوقت الفعلي).

استخدِم الدليل التالي لمساعدتك في تحديد تنسيق مدى التوفّر الأكثر ملاءمة:

  • في نظامك، هل يتم تخزين معلومات مدى التوفّر كخانات صريحة، مثل 8:00 صباحًا - 8:30 صباحًا؟
  • في النظام الذي تستخدمه، هل تخزّن مدى التوفّر بتنسيق متكرّر، أي أنّ التجّار يقدّمون خدمات تحدث بوتيرة ثابتة مع انحرافات قليلة؟ على سبيل المثال، تكرّر الخانات كل 15 دقيقة من 9:00 صباحًا حتى 5:00 مساءً، ولا يتوفّر سوى مقعد واحد كل 15 دقيقة.
  • بالنسبة إلى خدمات التجّار، هل يمكن توفير أكثر من مكان واحد في الوقت نفسه؟ على سبيل المثال، 30 موقعًا مفتوحًا لصف
  • لا ينطبق أي مما سبق.
    • استخدِم Spots Open.
    • ملاحظة: مع أنّ استخدام معدّل التكرار أكثر فعالية، يمكن أن يؤدي ذلك إلى تقليل حجم الخلاصات، إذا كان نموذج البيانات لا يتيح التكرار في الأصل، لا ننصحك باستخدام معدّل التكرار، لأنّك ستحتاج إلى إعادة حساب قيمة الخانات المتكررة لكل يوم في كل تعديل في الوقت الفعلي.

    أماكن مفتوحة

    تعريفات المعلّمات:

    • spot_open: عدد الأماكن المتاحة حاليًا لإدخال مدى التوفّر.
    • spot_total: إجمالي عدد المواضع التي يملكها التاجر في هذه الإعدادات، بما في ذلك الأماكن غير المتوفّرة.

    تشير طريقة Spot Open Open بشكل صريح إلى كل مدى توفّر في الخانة وتدعم نموذج وجود أماكن متعددة للخدمة نفسها. وتعمل هذه المعلَمات معًا لبناء تمثيل رقمي لسعة الخدمة.

    عند إجراء حجز، من المفترض أن ينخفض عدد spot_open بمقدار 1 من خلال تعديل في الوقت الفعلي (يجب أن يظل عدد spot_total كما هو). بعدالفتحة = 0، من المفترض ألا تظهر الخانة.

    أمثلة على الخدمات

    تتوفّر أدناه خطط لليوغا أو صالون تجميل ولا تتوفر حجوزات نشطة.

    الشكل 1: مخطط طابق بدون حجوزات نشطة

    ستظهر خلاصة مدى التوفّر لخانتَين لهؤلاء التجار على النحو التالي:

    JSON

        {
          "availability": [
                {
                  "spots_total": 6,
                  "spots_open": 6,
                  "duration_sec": 3600,
                  "service_id": "1001",
                  "start_sec": 1535817600, # Sept 1, 2018 4:00:00 PM GMT
                  "merchant_id": "1001"
                },
                {
                  "spots_total": 6,
                  "spots_open": 6,
                  "duration_sec": 3600,
                  "service_id": "1001",
                  "start_sec": 1535832000, # Sept 1, 2018 8:00:00 PM GMT
                  "merchant_id": "1001",
                }
              ]
        }
        

    أمثلة على الخدمات التي لها حجز

    الشكل 2: مخطط طابق مع حجز نشط واحد

    يحجز مستخدم الآن إحدى المواضع. وعند إجراء الحجز، يتم إصدار تعديل في الوقت الفعلي لتعديل مدى التوفّر. في خلاصة مدى التوفّر اليومية التالية، يجب أن يظهر هذا الحجز. من المفترض أن تكون خلاصة مدى التوفّر لهؤلاء التجّار قد شهدت انخفاضًا في spot_open بقيمة 1 في خانة 1 أيلول (سبتمبر) 2018 الساعة 4:00:00 مساءً بتوقيت غرينتش. لم تتغيّر خانة 1 أيلول (سبتمبر) 2018 الساعة 8:00:00 مساءً بتوقيت غرينتش.

    مقتطف من الخلاصة يتضمّن حجزًا

    JSON

        {
          "availability": [
                {
                  "spots_total": 6,
                  "spots_open": 5,
                  "duration_sec": 3600,
                  "service_id": "1001",
                  "start_sec": 1535817600, # Sept 1, 2018 4:00:00 PM GMT
                  "merchant_id": "1001"
                },
                {
                  "spots_total": 6,
                  "spots_open": 6,
                  "duration_sec": 3600,
                  "service_id": "1001",
                  "start_sec": 1535832000, # Sept 1, 2018 8:00:00 PM GMT
                  "merchant_id": "1001",
                }
              ]
    }
        

    التكرار

    تعريفات المعلّمات

    • التكرار: تمثيل خانات تكرار مدى التوفّر بشكل متكرر
    • تكرار_حتى_ثانية: الطابع الزمني للتوقيت العالمي المتفق عليه لوقت الانتهاء من الخانة الأخيرة، والذي يتكرر ذلك حتى.
    • تكرار_كل_ثانية: عدد الثواني بين خانات مدى التوفّر المتتالية. على سبيل المثال، إذا تكرّر_every_sec = 1800 (30 دقيقة)، وتبدأ Start_sec في الساعة 9:00 صباحًا، تكرر الخانات كل 30 دقيقة في 9:00 صباحًا و9:30 صباحًا و10:00 صباحًا، وما إلى ذلك.
      • ملاحظة: ما مِن حاجة لتحديدSpot_open وspot_total، ويُفترَض أنّهما يكونان 1، ما لم يكن هناك جدول زمني_استثناء

    تحدّد طريقة التكرار مدى التوفّر يوميًا للخدمات التي تتم على فترات زمنية منتظمة، على سبيل المثال، خدمة تتم كل 30 دقيقة من الساعة 9:00 صباحًا حتى الساعة 5:00 مساءً كل يوم. بالنسبة إلى التكرار، يمكنك تحديد مدة الخانة، لأول مرة في اليوم الذي تقع فيه الخانة، وعدد المرات التي يجب تكرارها فيها، ووقت إيقاف تكرارها في اليوم نفسه. ملاحظة: يجب تحديد مجموعة جديدة من الخانات المتكررة لكل يوم بشكل منفصل. إذا سبق أن تم حجز خانة ضمن النطاق الزمني، سيتم تحديد استثناء للجدول الزمني. على سبيل المثال، كرِّر كل نصف ساعة من الساعة 9 صباحًا حتى الساعة 9 مساءً باستثناء الساعة 11:00 صباحًا إلى 11:30 صباحًا، وستتضمّن كل خدمة فردية استثناءات خاصة بها للجدولة والتكرار.

    أمثلة على الخدمات

    يحتوي صالون تجميل على مخطط الطابق التالي ولا تتوفّر حجوزات نشطة.

    الشكل 3: مخططات طوابق بدون حجوزات نشطة. تفترض توفّر نقطة واحدة فقط لكل خدمة (على سبيل المثال، توفّر سالي خدمات قص الشعر كل 30 دقيقة، ولكن لا يمكن حضورها إلا لعميل واحد في كل مرة).

    ستظهر خلاصة مدى التوفّر لخانة واحدة في حسابات هؤلاء التجار على النحو التالي:

    مقتطف الخلاصة:

    JSON

        {
        "availability": [
              {
                "merchant_id": "1001",
                "service_id": "1001",  # haircut
                "start_sec": 1493888400, # May 4, 2017 9:00:00 AM GMT
                "duration_sec": 1800,
                "recurrence": {
                  "repeat_every_sec": 1800,
                  "repeat_until_sec": 1493915400 # May 4, 2017 4:30:00 PM GMT
                }
              }
            ]
        }
        

    أمثلة على الخدمات التي لها حجز

    الشكل 4: مخططات طابقية تشمل حجزًا نشطًا واحدًا. تفترض توفّر نقطة واحدة فقط لكل خدمة (على سبيل المثال، توفّر سالي خدمات قص الشعر كل 30 دقيقة، ولكن لا يمكن حضورها إلا لعميل واحد في كل مرة).

    لنفترض أنّ أحد المستخدمين حجز موعد لقص شعره مع سالي في الساعة 12:30 ظهرًا. وعند الحجز، يتم إصدار تعديل في الوقت الفعلي لتعديل مدى التوفّر. ويجب أن يظهر هذا الحجز في خلاصة مدى التوفّر اليومية التالية. سيكون لخلاصة مدى التوفّر لهؤلاء التجّار استثناء مُجدوَل خلال الفترة من 12:30 ظهرًا إلى 1:00 ظهرًا لخدمة مدتها 30 دقيقة.

    مقتطف الخلاصة مع حجز:

    JSON

        {
          "availability": [
                {
                  "merchant_id": "1001",
                  "service_id": "1001",
                  "start_sec": 1493888400, # May 4, 2017 9:00:00 AM GMT
                  "duration_sec": 1800,
                  "recurrence": {
                    "repeat_every_sec": 1800,
                    "repeat_until_sec": 1493915400 # May 4, 2017 4:30:00 PM GMT
                  },
                  "schedule_exception": [
                    {
                      "time_range": {
                        "begin_sec": 1493901000, # May 4, 2017 12:30:00 PM GMT
                        "end_sec": 1493902800 # May 4, 2017 1:00:00 PM GMT
                      }
                    }
                  ],
                }
              ]
        }