تطوير نظام متطور لتوثيق الأنساب والتراث العائلي

منصة قبيلة

1. نظرة عامة على المشروع والهوية

منصة “قبيلة” هي نظام متطور لتوثيق الأنساب والتراث العائلي، مصمم ليعمل كبيئة متعددة المستأجرين (Multi-tenant) تضمن الخصوصية الكاملة لكل عائلة.

* تحديد الهوية: يتم الوصول إلى كل عائلة عبر نطاق فرعي خاص بها

مثال: familyname.ansab.com

* الصفحة الرئيسية للمنصة (ansab.com):

تعمل كواجهة تسويقية فقط لعرض ميزات المنصة، ولا يوجد بها تسجيل حسابات مباشر، بل تحتوي على نموذج “طلب انضمام” للعائلات الجديدة للتفاوض معهم.

* نموذج العمل:

نظام اشتراك مبسط؛ الحالة تكون إما:

* نشط (Active)

* غير نشط (Inactive)

⸻

2. المعمارية التقنية وقواعد البيانات

تعتمد المنصة على نموذج قواعد البيانات المتعددة الديناميكية لضمان عدم تداخل بيانات العائلات.

قاعدة البيانات العامة (Global Master DB)

تخزن:

* بيانات المستأجرين (العائلات)

* طلبات الانضمام

* حالة الاشتراك

* بيانات مدير المنصة (Super Admin)

قواعد بيانات المستأجرين (Tenant Specific DBs)

كل عائلة تحصل على قاعدة بيانات مستقلة تحتوي على:

* شجرة العائلة

* الأعضاء

* الفعاليات

وسيط اكتشاف المستأجر (Tenant Discovery Middleware)

يقوم النظام بالتعرف على العائلة من خلال الرابط (URL) وتوجيه الاستعلامات تلقائياً إلى قاعدة البيانات الصحيحة.

تخزين الملفات

تُخزن الصور والبيانات في مساحات سحابية مثل:

* DigitalOcean

* Bunny.net

مع فصلها داخل مجلدات خاصة بكل عائلة.

⸻

3. أدوار المستخدمين والصلاحيات الهرمية

تم تصميم نظام الصلاحيات ليكون هرمياً وواضحاً لضمان دقة البيانات.

عضو عادي (Standard Member)

يمكنه:

* استعراض الشجرة

* تعديل ملفه الشخصي فقط:

* السيرة

* الصور

* التواريخ

وتنعكس التعديلات فوراً على الشجرة.

مدير فرع (Branch Manager)

يمتلك صلاحية:

* تعديل بياناته الشخصية

* تعديل بيانات جميع الأشخاص الموجودين ضمن فرعه بالشجرة

مدير العائلة (Tenant Admin)

يمتلك صلاحيات كاملة داخل نطاق عائلته، بما في ذلك:

* الموافقة على الأعضاء الجدد

* تعيين مدراء الفروع

مدير المنصة (Super Admin)

يدير المنصة بالكامل عبر مسار آمن وخاص مثل:

admin-core-platform.ansab.com

ويتحكم في:

* تفعيل الاشتراكات

* تعطيل اشتراكات العائلات

⸻

4. ميزات شجرة العائلة والتفاعل (تركيز على المحمول)

تم تحسين تجربة المستخدم لتكون سلسة على الهواتف والمتصفحات.

تجربة شجرة العائلة على المحمول

* تصفح ذكي:

واجهة تدعم:

* السحب والإفلات

* التكبير والتصغير (Pinch-to-zoom)

* التركيز العميق (Deep-Link Focus):

عند الضغط على أي فرد يتم:

* توسيط الشجرة عليه

* عرض أسلافه وخلفه بسلاسة

* تحديثات لحظية:

أي تعديل على ملف المستخدم يظهر مباشرة في عقدة الشجرة الخاصة به.

فعاليات العائلة (Events)

* جدول زمني للمناسبات:

* الاجتماعات

* الزواجات

* المناسبات التاريخية

* ربط الفعاليات بالشجرة:

يمكن ربط المناسبات بأشخاص أو تواريخ لتظهر كنقاط تفاعلية داخل الشجرة.

⸻

5. آلية الانضمام والتسجيل

بالنسبة للعائلات (طلبات جديدة)

1. يرى الزائر نموذج “طلب انضمام للعائلة”.

2. يقدم معلومات التواصل وتفاصيل العائلة.

3. بعد الموافقة يقوم مدير المنصة يدوياً بـ:

* إنشاء النطاق الفرعي

* تفعيل الحساب

بالنسبة للأفراد

1. يسجل الأفراد عبر النطاق الخاص بعائلتهم

مثال:

signup.smith.ansab.com

2. يتم ربط المستخدم تلقائياً بتلك العائلة داخل قاعدة البيانات.

3. لا يمكن الدخول للبيانات إلا بعد موافقة مدير العائلة يدوياً.

⸻

6. واجهات الإدارة

لوحة تحكم مدير المنصة (Super Admin)

* رابط منفصل وآمن عن الواجهة العامة

* إدارة الاشتراكات

* تفعيل أو تعطيل العائلات

* مراجعة طلبات الانضمام

لوحة تحكم مدير العائلة (Tenant Admin)

* تخصيص الصفحة الترحيبية

* إدارة الأعضاء

* قبول أو رفض التسجيلات

* تعيين مدراء الفروع

* إدارة المناسبات العائلية

⸻

7. المواصفات التقنية

الواجهة الأمامية

* React + Vite

* Tailwind CSS

الواجهة الخلفية

* Node.js + Express

* Mongoose مع تبديل قواعد البيانات الديناميكي

البنية التحتية

* Nginx

* إدارة النطاقات الفرعية

* إنشاء SSL تلقائي

التخزين

* S3 Compatible Storage

* Bunny.net لضمان سرعة تحميل الصور عالمياً