التكاملات وواجهة البرمجة
لا نستبدل أدواتك — نصلها ببعضها. ملفاتك في Drive، بريدك في Gmail، تواصلك عبر واتساب وتلجرام، وإشعاراتك في جوال ولي الأمر — كلها تعمل من داخل منظومة واحدة بواجهة برمجة آمنة.
لماذا التكامل وليس الاستبدال؟
المرشد لديه بريده، وملفاته في Drive، وتواصله اليومي عبر واتساب. بدل أن نطلب منه ترك كل ذلك، ربطنا المنظومة بأدواته الحالية — فيبقى كل شيء في مكانه، لكنه يعمل معاً.
- ملفاتك تبقى في حسابك. المستندات والصور تُرفع مباشرة إلى Google Drive الخاص بالمرشد — لا تخزين وسيط ولا نسخ في خوادم خارجية.
- بريدك هو بريدك. ترسل وتستقبل من عنوانك في Gmail (SMTP/IMAP) — لا بريد وسيط باسم النظام.
- واجهة واحدة، قنوات متعددة. رسالة واحدة تصل عبر واتساب أو تلجرام أو إشعار جوال حسب تفضيل ولي الأمر — من نفس لوحة الإرسال.
المبدأ: التكامل يقلل الاحتكاك. كلما قلّت الخطوات بين الأداة والعمل، زاد استخدامها — وزاد أثرها.
التكاملات الأساسية — 8 جسور حقيقية
كل تكامل له وظيفته الدقيقة. هذه ليست شعارات — بل دوال وEdge Functions تعمل فعلاً داخل النظام.
Supabase — العمود الفقري
قاعدة البيانات، المصادقة، الصلاحيات (RLS)، والدوال المخزنة (أكثر من 50 RPC). كل سجل — من الغياب إلى الخطة — يمر من هنا مع عزل كامل بين حسابات المرشدين.
Google Drive — ملفاتك في حسابك
رفع مباشر عبر Drive API v3 بترخيص OAuth 2.0 (offline + consent). مجلدان يُنشآن تلقائياً: «ملفات بوابة السلوك» و«صور الطلاب» ببنية صف → شعبة، والتوكنات مشفّرة AES-256-GCM.
البريد — للتحقق + Gmail للمراسلة
رموز OTP (6 أرقام، 10 دقائق، bcrypt) عبر SMTP منفصلة تماماً عن بريد المرشد. والمراسلة اليومية عبر بريد المرشد نفسه (Gmail SMTP على 587 + IMAP على 993) مع سجل إرسال واستقبال.
واتساب عبر WasenderAPI
إرسال واستقبال عبر WasenderAPI (ليس Cloud API المباشر). يدعم PAT وSession Key، وويب هوك messages.received + session.status، و26 قالب رسالة قابل للتخصيص.
تلجرام Bot API
بوت كامل بـ setWebhook و getMe و sendMessage مع أزرار reply_markup. نفس آلة الحالة مع واتساب — من الترحيب إلى القائمة — بنفس الإعدادات والقوالب.
FCM — إشعارات جوال ولي الأمر
دفع عبر FCM v1 (JWT RS256) عند كل إشعار جديد لولي الأمر. يُستدعى تلقائياً عبر Trigger بعد INSERT في parent_notifications، ويحترم إعدادات الأقسام، ويُعطّل التوكنات المنتهية.
Groq AI — مساعد ذكي آمن
وسيط خادمي إلى Groq (openai/gpt-oss-20b). المفتاح لا يظهر في الواجهة أبداً — يُحفظ في ai_settings ويُمرر عبر Edge Function groq-chat كبروكسي مع حماية Retry-After.
تشفير النقل — ملف .sbp محلي
تصدير/استيراد بيانات الطلاب مشفّر محلياً بـ WebCrypto (AES-256-GCM + PBKDF2 بـ 310,000 تكرار). كلمة السر لا تُخزن ولا تغادر المتصفح.
واجهة البرمجة — 18 وظيفة سحابية بواجهة موحّدة
كل تكامل يمر عبر Edge Functions على Supabase. استدعاء موحّد عبر edgeUrl(path) أو supabase.functions.invoke مع Authorization.
Trigger تلقائي: بعد كل INSERT في parent_notifications يُستدعى send-push عبر supabase_functions.http_request — ويُعطّل التوكنات المنتهية تلقائياً.
تخصيص بلا تعقيد — إعداداتك في مكانها
لا ملفات إعداد خارجية. كل شيء يُضبط من داخل النظام ويُحفظ في جداولك الخاصة.
بريدك الشخصي
عنوان Gmail + كلمة مرور التطبيقات + smtp.gmail.com:587 — مع اختبار إرسال مباشر.
قوالب البوت (26 قالب)
ترحيب، طلب رقم الطالب/ولي الأمر، نجاح التحقق، قائمة، مع متغيرات {{student_name}} {{grade}} {{school_name}}.
قوالب إشعارات السلوك
قالب واتساب وآخر لتلجرام بمتغيرات {{behavior_type}} {{fields}} {{date}} — مع تفعيل/إيقاف لكل قناة.
الذكاء والوحدات
مفتاح Groq في ai_settings (لا يُعرض)، و41 مفتاح وحدة (ai_assistant, whatsapp_bot, student_photos...) عبر isModuleEnabled.
أمان بلا مساومة
كل استدعاء يحمل Authorization Bearer، وكل جدول محمي بـ RLS حسب المرشد — فلا يرى أحد بيانات غيره، حتى عبر API.
شفافية: ما لا نفعله أيضاً مهم — لا نستخدم Supabase Storage (كل الملفات في Drive الخاص بك)، ولا نرسل OTP عبر واتساب/SMS (عبر فقط)، ولا نخزن كلمة سر النقل (.sbp) في الخادم.
بعد الربط — العمل يصبح متصلاً
التكامل ليس غاية، بل بداية تدفق متصل: سجل يُنشأ، إشعار يُرسل، ملف يُرفع، تقرير يُطبع — بلا نسخ يدوي بين أدوات منفصلة.
هكذا يقرأ النظام التكاملات: ليست إضافات جانبية، بل نسيج واحد يجعل كل أداة تغذي الأخرى — ومتى اكتمل النسيج كان العمل سلساً لا مجتزأً.
"التكامل الجيد لا يُرى — يُحسّ. المرشد لا يفكر في API أو توكن، بل يضغط إرسال فيصل الإشعار، يرفع ملفاً فيجده في Drive، يطلب تقريراً فيُطبع بترويسة مدرسته."
— من فلسفة النظام، أدواتك الحالية تعمل معاً
للمزيد: راجع التقارير والإحصائيات لترى كيف تُعرض بيانات التكاملات في لوحة التحليل، والمتابعة اليومية لفهم مصدر كل سجل يُغذّي هذه القنوات.