Rebex Tele - لوحة تحكم Telegram Bot

Rebex Tele هي لوحة تحكم إدارية ذاتية الاستضافة (Self-hosted) ومصممة خصيصاً لإدارة وإرسال الرسائل المجدولة والفورية عبر بوتات تلغرام إلى المجموعات العادية ومجموعات المنتديات (Forum Groups). تم بناء التطبيق بالاعتماد على Next.js 16 App Router و Supabase لتقديم تجربة سريعة وآمنة تماماً على مستوى الإنتاج.

التقنيات المستخدمة

• Next.js 16
• Supabase
• TypeScript
• Tailwind CSS v4
• Telegram API

---

المزايا التقنية والمعمارية

1. إدارة المجموعات والتحقق اللحظي

إضافة وتوثيق مجموعات تلغرام عبر الـ Chat ID مع إجراء تحقق تلقائي ولحظي من صلاحيات البوت باستخدام دالة getChat الخاصة بـ Telegram Bot API قبل الاعتماد.

2. معالجة ذكية لمحدودية API المواضيع (Forum Topics)

نظرًا لأن Telegram Bot API لا يتيح وسيلة مباشرة لاستعراض كافة مواضيع المنتدى (Topics)، تم الالتفاف على هذه المحدودية عبر بناء ذاكرة تخزين مؤقت متعلمة (Learned Cache) في قاعدة البيانات (telegram_topics):

• الالتقاط التلقائي: تسجيل أزواج Chat + Thread فورياً عند الإرسال.
• التحديث التفاعلي: ميزة "Refresh from Telegram" التي تعتمد على تقنية Long-polling لالتقاط أحداث forum_topic_created و forum_topic_edited واستخراج أسماء المواضيع وتحديثها في قاعدة البيانات دون المساس بالأسماء التي تم تعديلها يدوياً.

3. محرر نصوص غني متوافق مع Telegram

محرر معتمد على contenteditable مدعوم بطبقة تحويل مخصصة تحوّل HTML المتصفح إلى وسوم HTML آمنة ومحددة متوافقة تماماً مع معايير Telegram (تتضمن دعم وسم الـ Spoiler عبر <tg-spoiler>) لمنع حدوث أي أخطاء أثناء الإرسال.

4. نظام جدولة خادمي مستقل (Scheduled Messages)

نظام جدولة معتمد بالكامل على قاعدة البيانات دون الحاجة لإبقاء خادم الويب متصلاً باستمرار:

• يعتمد على ملحقات pg_cron و pg_net في Supabase لإطلاق الطلبات نحو Endpoint آمن (/api/cron).
• حماية من ظاهرة السباق (Race Condition) والإرسال المزدوج عن طريق نظام حجز الصفوف المتقدم (Optimistic Locking).
• دعم إعادة المحاولة التلقائية والتراجع الإيجابي (Backoff with retry limits) عند فشل الإرسال.

5. إدارة الأوامر والتكامل المباشر (Bot Commands & Webhook)

• واجهة WYSIWYG لإدارة أوامر البوت وتحديثها على سيرفرات تلغرام مباشرة بنقرة زر عبر setMyCommands.
• استقبال أوامر البوت عبر Webhook آمن يتأكد من مطابقة التوقيع زمنياً (Timing-safe token compare) مع تحديد معدل الطلبات لحماية السيرفر من هجمات الإغراق (Rate Limiting).

6. أمان متقدم على مستوى الإنتاج (Production-Grade Security)

• عزل التوكن: تخزين Bot Token في عمود خاص بالخادم فقط، وعدم تعريضه إطلاقاً لمتصفح المستخدم عبر متغيرات البيئة العامة.
• سياسات RLS صارمة: اعتماد سياسات RLS في PostgreSQL مرتبطة بدالة is_admin() للتحقق من هوية المدير المسموح له بالوصول.
• التحقق من الجلسات: حماية كافة الـ Server Actions والـ API Routes بالتحقق من جلسة المدير الفعالة ورفض الطلبات غير المصرح بها فوراً.

---

الجمهور المستهدف

• مدراء المجتمعات الرقمية: إدارة وتنسيق القنوات والمجموعات البرمجية والتقنية.
• أصحاب المشاريع: أتمتة نشر التحديثات والإعلانات الدورية إلى المجموعات.
• فرق العمل: جدولة الرسائل التنبيهية اليومية أو الأسبوعية لمجموعات المنتديات داخل تلغرام.

---

ما يميّز هذا المشروع

• حلول معمارية لمحدودية الـ API: تجاوز قيود Telegram Bot API عبر الـ Learned Caching والـ Long-polling.
• اعتمادية عالية في الجدولة: جدولة الرسائل من داخل قاعدة البيانات مباشرة (PostgreSQL Native Cron) لضمان عدم ضياع أي مهام.
• محرر مخصص تماماً: تحويل محتوى HTML المتصفح العشوائي إلى صيغة Telegram HTML قياسية وصارمة.
• معايير أمان عالية: عزل تام للقيم الحساسة وتطبيق سياسات RLS صارمة.