تكامل التقويم

اربط مرة واحدة، وأدِر من أي مكان. بمجرد ربط Google Calendar أو Microsoft Outlook (Teams)، ستظهر دروس Voilà في تقويمك تماماً كأي اجتماع آخر — وكل ما تجريه على الحدث من تقويمك ينعكس تلقائياً في Voilà. أعِد الجدولة، أو ألغِ، أو اقبل، أو ارفض — يبقى الطرفان متزامنَين في غضون ثوانٍ.

هذه الصفحة موجَّهة للمدرّسين. يشرح قسم "ما يراه طلابك" بالتفصيل ما يظهر للطلاب على طرفهم، حتى تتمكن من إدارة جدولك بالكامل من تقويمك بثقة.

مزوّدو الخدمة المدعومون

المزوّد	رابط الفيديو المُرفق تلقائياً	ما يُنشأ
Google Calendar	Google Meet	حدث واحد لكل درس، وحدث رئيسي لكل سلسلة متكررة
Microsoft Outlook / Teams	Microsoft Teams	حدث واحد لكل درس، وحدث واحد لكل تكرار

يمكنك ربط مزوّد تقويم واحد في كل مرة. للتبديل، افصل المزوّد الحالي أولاً من الإعدادات ← التكاملات.

ربط Google Calendar

1. انتقل إلى الإعدادات ← التكاملات، أو الجدولة ← ربط Google Calendar.
2. انقر على ربط Google Calendar.
3. سجّل الدخول بحساب Google الخاص بك وامنح Voilà صلاحية قراءة الأحداث وكتابتها.
4. يبدأ تقويمك بالمزامنة فوراً.

ما يحدث لحظة الربط: تُنقل كل دروس Voilà المؤكدة المستقبلية إلى Google Calendar — كل منها يحمل رابط Google Meet، وقائمة الحضور مُعبَّأة مسبقاً، ونصاً يحمل عبارة "تم الحجز عبر Voilà". لا يلزمك فعل أي شيء آخر.

ربط Microsoft Outlook / Teams

1. انتقل إلى الإعدادات ← التكاملات، أو الجدولة ← ربط Outlook Calendar.
2. انقر على ربط Outlook Calendar.
3. سجّل الدخول بحساب Microsoft الخاص بك وامنح Voilà صلاحية قراءة الأحداث وكتابتها.
4. يبدأ تقويمك بالمزامنة فوراً.

يظهر كل درس في تقويم Outlook كاجتماع Teams (يُرفق رابط الانضمام تلقائياً)، مع إدراج الطالب ضمن الحضور. ينطبق نفس سلوك الاستيراد الأولي: تظهر دروس Voilà المستقبلية في تقويم Outlook فوراً.

ما يظهر في تقويمك (Voilà ← التقويم)

حدث Voilà	ما تراه في التقويم
تأكيد حجز فردي (1:1)	دعوة في وقت الدرس، تحتوي على رابط Meet/Teams، والطالب ضمن الحضور، ونص من Voilà.
تأكيد درس جماعي	الحدث ذاته، مع جميع الأعضاء المقبولين في قائمة الحضور. يُضاف الأعضاء عند قبولهم، ويُزالون عند انسحابهم.
إنشاء درس متكرر	Google: حدث رئيسي متكرر واحد يغطي السلسلة كاملة. Outlook: حدث لكل تكرار (لضمان تدفق التحديثات الفردية عبر Microsoft Graph بسلاسة).
قبول إعادة جدولة في Voilà	يتحدث وقت بدء الدعوة ونهايتها في مكانه، ويتلقى الحضور إشعار تحديث. يعمل على Google وOutlook.
إلغاء درس في Voilà	يُحذف حدث التقويم ويتلقى الحضور إشعار إلغاء. يعمل على Google وOutlook.
تخطّي تكرار واحد في Voilà	يُلغى ذلك التكرار وحده — تبقى بقية السلسلة سليمة.

ما يُزامَن مجدداً في Voilà (التقويم ← Voilà)

هذا هو القسم الذي يتيح لك "العيش في تقويمك". كل ما يلي يُغيّر حالة Voilà تلقائياً.

تحريك وقت الحدث

سحب حدث Voilà إلى فترة زمنية مختلفة، أو تعديل وقت بدايته أو نهايته، يفتح اقتراح إعادة جدولة داخل Voilà. بمجرد تأكيد الطالب (من التطبيق أو بالرد على البريد الإلكتروني)، يُثبَّت وقت الحدث في كلا النظامَين. حتى ذلك الحين، يبقى الحدث كاقتراح معلّق — ولا يزال بإمكان الطالب رؤيته وقبوله أو رفضه من داخل Voilà.

حذف الحدث أو إلغاؤه

تُعلّم Voilà الدرس ملغىً وتُشغّل فرع إلغاء المدرّس من سياسة الإلغاء:

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

إنشاء حدث جديد مع أحد طلابك كحاضر

إن كانت هناك علاقة نشطة بين الطالب والمدرّس، ستقوم Voilà بما يلي:

• إنشاء اقتراح حجز تلقائياً لذلك الدرس.
• إرسال بريد إلكتروني للطالب ليؤكد الوقت.
• حجز الفترة الزمنية في جدول توفّرك ريثما يُقبل الاقتراح.

إن لم يكن الحاضر طالباً معروفاً لديك، تُسجّل Voilà الحدث كفترة مشغولة عادية في جدول توفّرك — دون إنشاء حجز.

إضافة أي حدث آخر إلى تقويمك

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

ما يراه طلابك

عند تأكيد أي درس، يتلقى طالبك دعوة تقويم للحدث ذاته — تحتوي على رابط انضمام Meet أو Teams. وبذلك يمكنه إدارة الدرس من تقويمه الخاص أيضاً. إليك بالتفصيل كيف تتعامل Voilà مع كل إجراء يمكن للطالب اتخاذه من صندوق بريده أو تطبيق التقويم:

إجراء الطالب	ما تفعله Voilà
قبول الدعوة	لا شيء إضافي — هو مسجَّل في الدرس أصلاً. يُسجَّل ردّه للاطلاع.
رفض اقتراح معلّق من تقويمه	يُرفض الاقتراح في Voilà. تتلقى إشعاراً بالبريد الإلكتروني والمحادثة.
رفض درس فردي (1:1) مؤكد من تقويمه	تُشغّل Voilà فرع إلغاء الطالب من سياسة الإلغاء. قبل الموعد النهائي = استرداد كامل أو إعادة الرصيد؛ بعد الموعد النهائي = مصادرة المبلغ (تحتفظ بالدفعة).
الرفض من درس جماعي مؤكد	يُستردّ مقعد ذلك الطالب فقط؛ يستمر الدرس للبقية (وفق قاعدة الحد الأدنى للمقاعد لديك).
رفض تكرار متكرر	يُتخطى ذلك التكرار الواحد (استرداد أو مصادرة وفق سياسة الإلغاء). تبقى بقية السلسلة دون تغيير.
إعادة توجيه الدعوة إلى صندوق بريد آخر	لا أثر على الدرس — Voilà هي المرجع الأساسي، وإعادة توجيه الدعوة لا تُغيّر الدرس ولا تُعيد إصدار المبالغ المستردة.

باختصار: يمكن للطلاب إدارة مشاركتهم بالكامل من دعوة التقويم، وستظهر كل إجراءاتهم على طرف Voilà في غضون ثوانٍ.

الدروس الجماعية عبر التقويم

تُضيف الدروس الجماعية تفصيلاً إضافياً واحداً — قاعدة الحد الأدنى للمقاعد:

• رفض أحد الأعضاء ← يُستردّ مقعده، ويُزال من حدث التقويم، ويستمر الدرس.
• إذا أدى الرفض إلى انخفاض العدد دون min_seats قبل الموعد النهائي للإلغاء ← يُلغى الدرس بالكامل، ويُستردّ المبلغ لكل مقعد مدفوع، ويُحذف حدث التقويم.
• إذا أدى الرفض إلى انخفاض العدد دون min_seats بعد الموعد النهائي للإلغاء ← يستمر الدرس (من دفعوا مقاعدهم سبق أن سدّدوا)، وتتلقى بريداً إلكترونياً تنبيهياً لتقرر كيفية التعامل مع الأمر.

الدروس المتكررة عبر التقويم

تُخزَّن الدروس المتكررة بشكل مختلف لدى كل مزوّد، لكن التجربة واحدة:

• Google: السلسلة عبارة عن حدث رئيسي متكرر واحد. رفض تكرار واحد من التقويم يتخطى ذلك التكرار فقط في Voilà؛ رفض الحدث الرئيسي يُلغي كل التكرارات المستقبلية.
• Outlook: كل تكرار مرتبط بشكل فردي لضمان تدفق التحديثات الفردية من Microsoft Graph بسلاسة. رفض تكرار واحد يتخطاه في Voilà؛ رفض السلسلة ينهي التكرارات المستقبلية.
• تخطّي تكرار من داخل Voilà يُلغي تلقائياً التكرار المقابل في التقويم مع إرسال إشعار إلغاء واضح للحضور.
• تغيير سياسة الإلغاء لدى المدرّس لا يُطبَّق بأثر رجعي على التكرارات الموجودة مسبقاً — كل تكرار يُثبَّت بالسياسة التي كانت سارية عند إنشائه.

كيفية تسليم المزامنة

تستخدم Voilà إشعارات الدفع (webhooks) كمحرّك أساسي:

• Google Calendar — تشترك Voilà في تقويمك عبر قناة events.watch من Google؛ تصل التحديثات في غضون ثوانٍ من حفظك في Google Calendar.
• Microsoft Outlook / Teams — تشترك Voilà عبر webhooks من Microsoft Graph؛ السلوك ذاته.

مجموعة صغيرة من الشبكات الأمان تحافظ على صحة القناة:

• مهمة صيانة كل ساعة تجدّد الاشتراكات قبل انتهاء صلاحيتها وتُعيد تشغيل أي مراقبة مفقودة.
• الاستيراد الأولي عند الربط ينقل دروس Voilà المستقبلية الموجودة إلى تقويمك الجديد (ويستورد أوقات الانشغال من تقويمك الحالي).
• التحديث اليدوي متاح من صفحة الجدولة — مفيد عند الاختبار أو إذا فاتت webhook تسليمة لفترة وجيزة.

أشارت الإصدارات السابقة من هذه الصفحة إلى "دورة استطلاع كل 5 دقائق". هذا لم يعد دقيقاً — المزامنة قائمة على الدفع وتصل عادةً في أقل من 30 ثانية.

سياسة الإلغاء والمبالغ المستردة عبر التقويم

تتبع إلغاءات التقويم سياسة الإلغاء ذاتها التي ضبطتها للحجوزات المدفوعة عبر Stripe (انظر مدفوعات Stripe Connect):

• إلغاؤك (حذف/إلغاء من تقويمك): يُستردّ للطالب المبلغ كاملاً، بصرف النظر عن التوقيت.
• رفض الطالب من تقويمه قبل الموعد النهائي: استرداد كامل أو إعادة الرصيد للطالب.
• رفض الطالب من تقويمه بعد الموعد النهائي: تُصادَر الدفعة (تحتفظ بها) أو يُستهلك رصيد الجلسة.
• الدروس الجماعية: استرداد لكل مقعد عند الرفض الفردي؛ استرداد كامل لكل مقعد مدفوع في حال إلغاء المدرّس أو انخفاض العدد دون min_seats قبل الموعد النهائي.

الخصوصية والصلاحيات

• تقرأ Voilà وتكتب الأحداث في التقويم الذي تربطه فقط — لا في أي تقويمات أخرى على حسابك.
• تُستخدم الأحداث التي تقرأها Voilà حصراً لأغراض الجدولة وحسابات التوفّر.
• يمكنك إلغاء الوصول في أي وقت من الإعدادات ← التكاملات (أو مباشرةً من إعدادات حساب Google / Microsoft الخاص بك).

استكشاف الأخطاء وإصلاحها

انتهاء صلاحية الرمز المميز

إذا توقفت المزامنة، فمن المرجح أن رمز OAuth قد انتهت صلاحيته. افتح الإعدادات ← التكاملات وانقر على إعادة الاتصال.

تأخيرات المزامنة

تُسلَّم Webhooks عادةً في غضون ~30 ثانية. مهمة الصيانة الساعية شبكة أمان تجدّد الاشتراكات وتُعيد مزامنة أي تسليمة فشلت لفترة وجيزة. يمكنك أيضاً تشغيل تحديث يدوي من صفحة الجدولة.

التعارضات مع أحداث غير Voilà

إذا حاولت تأكيد حجز Voilà في فترة زمنية يغطيها حدث غير Voilà في تقويمك، ستُنبّهك Voilà وتتيح لك تجاوز التعارض — مفيد عندما يكون حدث التقويم حجزاً "مؤقتاً" لا مانع لديك من إلغائه.

التبديل بين المزوّدين

يمكن ربط تقويم واحد فقط في كل مرة. افصل Google قبل ربط Outlook (أو العكس) من الإعدادات ← التكاملات.

مزامنة ثنائية الاتجاه، من البداية إلى النهاية

sequenceDiagram
    participant Student
    participant StudentCal as "Student Calendar"
    participant Voila
    participant TutorCal as "Tutor Calendar (Google or Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Lesson confirmed in Voilà
    Voila->>TutorCal: Create event with Meet or Teams link
    TutorCal-->>Student: Invite delivered
    TutorCal-->>StudentCal: Invite delivered

    Note over Student,StudentCal: Student declines from inbox
    StudentCal->>TutorCal: RSVP declined
    TutorCal->>Voila: Webhook fires
    Voila->>Voila: Run cancellation policy
    Voila-->>Tutor: In-app and email notice
    Voila-->>Student: Refund or forfeit confirmation

    Note over Tutor,TutorCal: Tutor cancels the event
    TutorCal->>Voila: Webhook fires
    Voila->>Voila: Cancel and refund
    Voila->>StudentCal: Calendar event removed

ذات صلة

• الجدولة — التوفّر الأسبوعي، وسياسات الحجز، ووضع الإجازة
• الدروس الجماعية — الحد الأدنى للمقاعد، وإدارة الأعضاء، وسلوك الإلغاء الجماعي
• مدفوعات Stripe Connect — سياسات الإلغاء وكيفية تطبيق المبالغ المستردة