وثاق
وثيقة داخلية

التقرير التقني

تقرير تقني تفصيلي عن منصة وثاق — البنية والتقنيات والمميزات والأمان.

تعريف المنصة

وثاق منصّة أتمتة ذكية متعددة المستأجرين (SaaS) تساعد الأفراد والفرق على إنجاز أعمالهم اليومية: صياغة وإرسال البريد الرسمي، تنظيم المهام، جلب وتنسيق المحتوى من مصادر متعددة، والنشر عبر قنوات التواصل والبريد من مركز قيادة واحد. يربط كل مستخدم حساباته الخاصة بشكل معزول وآمن، ويتولّى «مستشارك الرقمي» الصياغة والتنفيذ مع مراجعة بشرية قبل الإرسال.

أبرز المميزات

صياغة وإرسال بريد رسمي باسم المستخدم مع مراجعة قبل الإرسال
مساعد ذكي يتحكم بكامل المنصة وينفّذ الإجراءات
تحليل المرفقات وملفات Google Sheets والمستندات بدون تكاليف إضافية
جلب دوري تلقائي للمحتوى وتنسيقه قبل النشر
نشر متعدد المنصات مع تنسيق مخصص لكل قناة
واجهة ثنائية اللغة بالكامل (عربي/إنجليزي) مع تصميم رسمي فاخر

التفاصيل التقنية

الواجهة والبنية التقنية

تطبيق ويب كامل المكدّس مبني على TanStack Start (React 19) مع التصيير من الخادم، Vite كأداة بناء، وTailwind CSS للتصميم. منطق الخادم عبر Server Functions وServer Routes، والنشر على بيئة Edge.

  • React 19 + TanStack Router/Query للتوجيه وجلب البيانات
  • تصميم بنظام رموز دلالية (Sora / Manrope / IBM Plex Arabic)
  • دعم كامل للعربية والإنجليزية مع اتجاه RTL/LTR

قاعدة البيانات والخلفية

خلفية مُدارة (Lovable Cloud) مع قاعدة بيانات PostgreSQL، مصادقة، وتخزين. حماية صفوف البيانات (RLS) مفعّلة على الجداول، وأدوار المستخدمين تُخزّن في جدول منفصل لمنع تصعيد الصلاحيات.

  • عزل بيانات كل مستخدم عبر سياسات RLS
  • تخزين آمن للأسرار ومفاتيح الربط
  • دوال قاعدة بيانات آمنة (has_role) للتحقق من الصلاحيات

مستشارك الرقمي (الذكاء الاصطناعي)

مساعد ذكي يتحكم بكامل المنصة عبر أدوات (Tools): صياغة البريد الرسمي، تحديد المستلمين ونسخة CC، قراءة الوارد، تحليل المرفقات وملفات Google Sheets/المستندات، والتنقل بين الصفحات وتنفيذ الإجراءات.

  • صياغة رسمية بترميز عربي سليم بدون رموز مزيفة
  • بطاقات مراجعة قبل الإرسال (Human-in-the-loop)
  • قراءة وتحليل المرفقات والجداول والمستندات

الربط والتكاملات

كل مستخدم يربط حساباته الخاصة عبر OAuth الفردي (Gmail، التقويم، Sheets) إضافة إلى موصّلات مركزية احتياطية. النشر فعلي عبر بوابة الموصّلات.

  • Gmail / Outlook كقنوات إرسال بريد
  • LinkedIn، تيك توك، إنستقرام، تيليجرام، ثريد
  • Google Sheets والمستندات للقراءة والتحليل

محرك الأتمتة

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

  • جدولة نشر فورية أو نوافذ موزعة بأي توقيت
  • منع التكرار وذاكرة المحتوى طويلة المدى
  • سجل أحداث مباشر لمراقبة سير العمل

الأمان والخصوصية

تحقق على جانب الخادم لكل العمليات الحساسة، تحقق من صلاحية الجلسة والدور قبل تنفيذ أي إجراء، وعدم كشف أي أسرار في الواجهة. التحقق من المدخلات بمكتبة Zod في نقاط الخدمة العامة.

  • مصادقة عبر البريد وGoogle
  • فصل الأدوار في جدول مستقل
  • توقيع التحقق من الويب هوك للنقاط العامة
جاهزة للإنتاج والنشر
العودة للرئيسية