تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

عزل الحسابات ونموذج البيانات

uMarker يشغّل مستأجرين كثيرين داخل تطبيق Laravel واحد وقاعدة بيانات واحدة. العزل مو حزمة مضافة، بل trait مع نطاق عام، مقصود يكون صغيراً عشان يسهل تدقيقه ويصعب الخطأ فيه. هذي الصفحة تشرح بالضبط كيف يُحصَر الطلب في مستأجر واحد، والطبقتين اللي تضيّقانه أكثر داخل المستأجر، وكيف يُعاد فحص كل ذلك على الخادم.

كل مستأجر حساب، والكيانات الأساسية معلّقة فيه:

users

أعضاء فريق اللوحة. كل واحد يحمل account_id ومقعداً (admin أو member)، وممكن دوراً مخصّصاً فوقه، وممكن أدواراً أضيق لكل مساحة أو لكل مشروع.

widget_users

هويّات مختبِري إضافة المتصفّح (مصادقة بتوكن). تحمل account_id، قابلة للسحب والحذف، ومربوطة many-to-many بالمشاريع اللي يحقّ لها الالتقاط عليها.

projects

تحمل account_id وworkspace_id ومفتاح نشر widget_visible وpublic_key، ونطاقاتها المسموحة الخاصة فيها. وتملك إعدادات الودجت وملاحظاتها.

feedback وما حوله

التقارير وكل اللي يزيّنها (الدبابيس، التعليقات، التسميات، الاستبيانات، الإعلانات، مفاتيح الـAPI، العروض المحفوظة، الحقول المخصّصة) كلها تحمل account_id. إشعارات الجرس هي الاستثناء الوحيد: مفتاحها هو الشخص اللي يستلمها، مو الحساب، فالقراءة ما توصل إلا صفوف ذاك الزميل وحده.

النماذج المملوكة للمستأجر تستخدم BelongsToAccount. يسوّي شيئين، ولا شي غيرهما:

  1. ينطّق كل استعلام تلقائياً. نطاق عام اسمه account يضيف where account_id = <الحساب الحالي> لكل استعلام يشغّله النموذج، فما يقدر الاستعلام يشوف إلا صفوف المستأجر الحالي.

  2. يملأ عند الإنشاء. لمّا يُنشأ صفّ جديد بلا account_id، الـtrait يملأه من الحساب الحالي، فما يقدر مطوّر يكتب صفّاً خارج النطاق بالغلط.

«الحساب الحالي» يجي من مُحلِّل واحد، Tenancy::currentAccountId(). يقرأ هويّة الطلب المُصادَقة: مستخدم لوحة User، أو WidgetUser على حارس التوكن، وكلاهما يحمل account_id. وهويّات المصادقة نفسها مو منطّقة بالحساب (وإلا صار المُحلِّل يستدعي نفسه)، فالملكية عليها تُفحص صراحة بدل ذلك.

فيه صفّان (users وwidget_users) مستثنيان قصداً من نطاق الحساب العام، لأنهما هويّتا المصادقة اللي يقرأهما المُحلِّل نفسه — ولو نُطِّقا بالحساب صار يستدعي نفسه. ملكيّتهما تُفرض بفحص صريح: أي طلب لواحد منهما يخصّ حساباً ثانياً يُجاب بـ404، أبداً ببيانات مستأجر ثاني. أما invitations فهي منطّقة مثل كل شي، وفوقها فحص صريح ثانٍ، لأن مسار قبول الدعوة يشتغل قبل ما يثبت المستأجر. القاعدة وحدة في كل مكان: ارفض افتراضياً.

المساحة تجمّع المشاريع داخل الحساب الواحد، بهرمية حساب ← مساحة ← مشروع. الحساب الجديد يُنشأ والمساحات مفعّلة ومعه مساحة وحدة اسمها General، وكل مشروع ينتمي لمساحة، فـworkspace_id ما يكون NULL أبداً وما فيه مشاريع معلّقة بلا مكان.

ولمّا يحمل طلب اللوحة ترويسة X-Workspace-Id، نطاق عام ثانٍ يُرشِّح بصرامة Project وFeedback والتسميات وغيرها إلى تلك المساحة وحدها. وبدون الترويسة يرجع للمجموعة الكاملة اللي يوصلها القارئ. أما الودجت العام ومفاتيح الـAPI ومهامّ الطابور فما تُنطَّق بمساحة أبداً. الترويسة حقيقة تنقّل في اللوحة، مو اعتماد.

داخل المساحة، الوصول يُقرَّر لكل مشروع: العضو يشوف بالضبط المشاريع المُسنَد لها (project_user). الإسناد هو الوصول. وفيه ثلاثة استثناءات مقصودة، وكلها صريحة مو ضمنيّة: مديرو الحساب — مقعد admin، واللي يمكن يكون في الحساب أكثر من واحد منه — ومشغّلو المنصّة يوصلون كل شي؛ والدور اللي يحمل صلاحية workspaces.allprojects يقدر يفتح كل مشروع في مساحته بلا ما يكون مُسنَداً لكل واحد؛ وإيقاف نظام المساحات للحساب يشيل طبقة المساحة وطبقة المشروع مرّة وحدة، فيوصل كل عضو كل مشروع.

الوصول والصلاحية محوران منفصلان، والاثنان يُسألان. قائمة المشاريع اللي يقدر الشخص يقرأ تقاريرها هي «يوصلها وممنوح feedback.view عليها»، وتُسأل لكل مشروع على حدة عشان يقدر تجاوز الدور على مستوى المشروع يقرّر. يعني دور المشروع يقدر يوسّع أو يضيّق اللي أعطاه دور المساحة.

الحالة الوصول
مدير الحساب أو مشغّل المنصّة كل المشاريع
دور يحمل workspaces.allprojects كل مشاريع المساحة
عضو مُسنَد لمشاريع تلك المشاريع فقط
عضو غير مُسنَد لشي ولا مشروع، والقائمة الفاضية جواب صحيح
نظام المساحات موقَّف للحساب كل المشاريع، لكل عضو — ولا صفّ فوق ينطبق
الودجت العام / مفتاح API / الطابور لا تنطبق: هذي الطبقات ما توصلها أبداً

إعادة التحقّق على الخادم، كل طلب

Section titled “إعادة التحقّق على الخادم، كل طلب”

حالة العميل ما يُوثَق فيها وحدها. السنيبت والإضافة يحرسان ظهورهما لأجل التجربة؛ والخادم يعيد اشتقاق كل قرار وصول من الصفر.

  1. الإعدادات والظهور. لمّا يسأل الودجت هل يظهر، الخادم يفحص أصل الصفحة مقابل نطاقات المشروع المسموحة، ويحلّ رابط الصفحة إلى مشروع، ويتأكّد أن المشروع منشور، ويتأكّد أن المُنادي مخوّل له. وأي شي غير كذا يرجع «مخفي»، بلا أي مشروع ولا حمولة إعدادات مرفقة.

  2. الإدخال. لمّا يُرسَل تقرير، نقطة الإدخال تعيد اشتقاق القرار بنفسها بدل ما تثق باللي قالته الإعدادات للعميل — بس السطحين يُفحصان بطريقتين مختلفتين. إدخال السنيبت يعيد حلّ المفتاح العام ويعيد فحص أصل الصفحة مقابل نطاقاتك المسموحة كما هي في تلك اللحظة. وإدخال الإضافة يفحص هويّة المختبِر وإسناده لذاك المشروع بدلاً عن ذلك، وعمداً ما يشترط أن مضيف الصفحة يكون واحداً من نطاقاتك المدرجة: وهذا اللي يخلّي المختبِر يقدر يلتقط على مضيف تجريبي ما أدرجته أبداً. وفي الاثنين، الحساب اللي يُكتب على التقرير الجديد يُؤخَذ من حلّ الخادم، أبداً من جسم الطلب.

  3. قراءة الوسائط. اللقطات اللي تُجلب عبر API اللوحة تُربَط عبر نموذج منطّق بالحساب، فطلب ملفّ مستأجر ثاني يُحلّ إلى 404 بدل البايتات، وفوق ذلك تتطلّب صلاحية feedback.download المنفصلة — لأن قراءة التقرير وأخذ ملفّاته حقّان مختلفان. ومعرض الوسائط هو المسار الثاني، وبوّابته feedback.gallery بدلها: يعطي المتصفّح رابطاً موقّعاً ينتهي بعد ست ساعات، لأن <img src> ما يقدر يحمل توكن. وفيه مسار ثالث يطلع من الحساب كليّاً — رابط اللقطة اللي يكتبه uMarker في تذكرة Jira أو رسالة Slack أو حمولة webhook، حيث التوقيع هو التحكّم بالوصول وما فيه جلسة تُفحص. شوف التخزين والوسائط لمدّة حياة تلك الروابط.

الأحداث الحسّاسة أمنياً تُسجَّل في audit_logs عبر مساعد واحد. كل صفّ يحمل action، والفاعل user_id أو widget_user_id، وaccount_id، وsubject_type/subject_id اختياريين، وmeta حرّة، ووقتاً. ومن الأفعال المسجَّلة: إصدار المختبِرين وسحبهم، وتدوير مفتاح الودجت وسحبه، وإنشاء التقارير وحذفها، وتغيير الحالة والإسناد، وتغيير نافذة الاحتفاظ، وتصدير الحساب، وتغيير الباقة، ودخول الدعم. أما سكّ مفتاح الودجت فيصير كجزء من إنشاء المشروع أو نشره، فاللي يظهر بالسجلّ له هو project.created أو project.published — ما فيه صفّ منفصل يقول «صدر مفتاح».

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