المؤسسات والأدوار - وثائق Entity Enricher

المؤسسات والأدوار

يستخدم Entity Enricher نظام تعدّد المستأجرين القائم على المؤسسات. فينتمي كل مستخدم إلى مؤسسة واحدة، وتُعزل جميع البيانات — السجلات والمخططات ومفاتيح API — لكل مؤسسة على حدة.

تعدد المستأجرين

تمثّل المؤسسات الحدّ الأعلى لعزل البيانات. عند التسجيل، تُنشئ مؤسسة جديدة أو تنضم إلى مؤسسة قائمة. تنتمي جميع سجلات الإثراء والمخططات ومفاتيح API إلى مؤسستك، وتكون متاحة لأعضاء الفريق بناءً على أدوارهم.

ما الذي يخص المؤسسة

سجلات الإثراءجميع نتائج الإثراء والمُوجّهات وبيانات التكلفة
المخططات المحفوظةمخططات JSON التي أنشأها أو ولّدها أعضاء الفريق
مفاتيح APIمفاتيح وصول المؤسسة للتكامل البرمجي
مفاتيح المزوّدمفاتيح API لمزوّد LLM للفوترة على مستوى كل مؤسسة
المستخدمونأعضاء الفريق بأذونات قائمة على الأدوار
الإعداداتتفضيلات المؤسسة وحدود الاستخدام
المفاهيم الدلاليةمفردات هويات الكيانات الثابتة التي تُطابَق عليها عمليات الإثراء لديك
عمليات Database Syncقواعد البيانات المستهلِكة المسجَّلة والفروق المنتظرة في طوابيرها
سيناريوهات قياس الأداءاختبارات النماذج المحفوظة ونتائجها، بما فيها ما استُخدم لتقييم اختيار النموذج
الأرصدة والفوترةالخطة والرصيد وكل معاملة أُجريت عليه

تسلسل الأدوار الهرمي

يستخدم Entity Enricher تسلسلًا هرميًا للأدوار من 4 مستويات. ويتضمّن كل دور جميع صلاحيات الأدوار الأدنى منه:

مسؤول النظامالمستوى 5 · على مستوى النظام
  • إدارة جميع المؤسسات والمستخدمين عبر النظام
  • الوصول إلى البيانات وإعداد التقارير عبر المؤسسات
  • الوصول إلى وثائق API التفاعلية (Swagger UI وReDoc)
  • تحكّم كامل في إعدادات النظام
المالكالمستوى 4 · المؤسسة
  • تحكم كامل في المؤسسة
  • إدارة أعضاء الفريق: الدعوة، والموافقة، وتغيير الأدوار، والإلغاء
  • إنشاء مفاتيح API وإدارتها (بما في ذلك مفاتيح وصول المؤسسة)
  • قم بتهيئة إعدادات المؤسسة ومفاتيح API الخاصة بالمزوّدين
  • إدارة الفوترة: الخطة، وعمليات شراء الأرصدة، وسجلّ الفواتير
  • اضبط الإعدادات الافتراضية على مستوى المؤسسة: النماذج المفضّلة لكل مهمة، وأوزان درجات معايير القياس، ونموذج التضمين
  • حذف المؤسسة (بصفتك المالك الأخير)
المحرّرالمستوى 2 · المؤسسة
  • تشغيل عمليات الإثراء (فردية وبالدُّفعات)
  • إنشاء المخططات وتحريرها وحذفها
  • استخدام توليد المخطط وتحريره بالذكاء الاصطناعي
  • اعرض جميع سجلات المؤسسة وتكاليفها
مُشغِّلالمستوى 1 · المؤسسة
  • تشغيل عمليات الإثراء باستخدام المخططات الموجودة (وصول للمخطط للقراءة فقط)
  • عرض لوحة السجلات والتكاليف
  • حدّد النماذج واضبط خيارات الإثراء

الحسابات الفردية وحسابات الأعمال

كل مؤسسة من نوعين اثنين، ومعظم ما يصفه بقية هذه الصفحة — الانضمام والموافقة والأدوار — لا ينطبق إلا على النوع الثاني.

فردي — مساحة عمل شخصية

تُنشأ لك تلقائيًا عند التسجيل، وتحمل اسم حسابك. تضم عضوًا واحدًا فقط، وهي مخفية عن بحث الانضمام وترفض طلبات الانضمام حتى عبر رابط مباشر، وتعرض دعوة للترقية في الموضع الذي يعرض فيه حساب الأعمال صفحة المستخدمين. ولا ينقصها شيء آخر: فالمخططات وعمليات الإثراء وعمليات Database Sync والفوترة تعمل جميعها بالطريقة نفسها.

Business — مستأجر مشترك

مؤسسة متعددة المستخدمين: يمكن العثور عليها في بحث الانضمام، مع طلبات انضمام وأدوار وموافقة المالك. وينتقل المالك في أي من الاتجاهين من إعدادات المؤسسة — غير أن العودة إلى الوضع الفردي مرفوضة ما دام هناك أعضاء آخرون، لأنها ستتركهم بلا مؤسسة.

التسجيل

سجّل باستخدام Google أو GitHub أو البريد الإلكتروني عبر مصادقة Firebase. ستحصل على مساحة عمل شخصية فورًا؛ ومنها يمكنك إنشاء مؤسسة أعمال أو طلب الانضمام إلى واحدة. ولا تظهر في البحث أدناه سوى مؤسسات الأعمال.

إنشاء مؤسسة

  1. سجّل عبر مزوّد الهوية الخاص بك
  2. اختر اسم المؤسسة ومُعرّفًا مختصرًا آمنًا لعنوان URL
  3. تصبح مالك المؤسسة الجديدة
  4. إذا لم يكن هناك مسؤول نظام بعد، تصبح أنت مسؤول النظام

الانضمام إلى المؤسسة

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

حالات المستخدم

يمر المستخدمون بسير عمل للموافقة عند الانضمام إلى مؤسسة:

الحالةالمعنىيمكنه تسجيل الدخول؟
نشطوصول كامل إلى النظام بناءً على الدور المُسنَدنعم
قيد الانتظارتم إرسال طلب الانضمام، في انتظار موافقة المالكلا
مرفوضرفض أحد المالكين طلب الانضماملا
مُلغى التفعيلتم تعطيل الحساب (حذف مرن يحافظ على مسار التدقيق)لا

مغادرة مؤسسة

يمكن لأي مستخدم مغادرة مؤسسته. يعتمد السلوك على الملكية:

الأعضاء العاديون

تم إلغاء تنشيط حسابك وتسجيل خروجك. تبقى سجلات الإثراء الخاصة بك في المؤسسة لأغراض التدقيق.

آخر مالك

إذا كنت المالك الوحيد المتبقي، فيجب عليك تأكيد حذف المؤسسة. تُفصَل سجلات الإثراء والمخططات (ولا تُحذف)، بينما يُزال المستخدمون ومفاتيح API ومفاتيح المزوّدين مع المؤسسة.

إدارة المستخدمين

يدخل المالكون إلى صفحة إدارة المستخدمين لإدارة فريقهم، ويرى مسؤولو النظام تبويبًا إضافيًا:

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

قواعد الأمان:

  • لا يمكن للمستخدمين إلغاء تنشيط أنفسهم أو حذفها
  • يؤدي الحذف الدائم إلى إزالة الحساب وهوية تسجيل الدخول الخاصة به نهائيًا؛ ويتم الاحتفاظ بسجلات الإثراء والمخططات لكنها تفقد مؤلفها
  • لا يمكن للمستخدمين خفض رتبتهم دون دورهم الحالي
  • المالكون وحدهم يمكنهم ترقية الأعضاء الآخرين أو خفض رتبهم داخل المؤسسة؛ أما منح دور مسؤول النظام فمقصور على مسؤولي النظام الحاليين

إعدادات المؤسسة

صفحة الإعدادات هي المكان الذي يضبط فيه المالك المؤسسة نفسها، في جزأين:

الهوية وبيانات الاتصال

اسم المؤسسة الظاهر وبيانات الاتصال والعنوان البريدي ونوع الحساب (فردي أو تجاري). أما مُعرِّف الرابط فيثبت بمجرد إنشائه، لأن الروابط والتكاملات مبنية عليه.

الإعدادات الافتراضية

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

المصادقة

يدعم Entity Enricher عدّة طرق للمصادقة:

تسجيل الدخول عبر مواقع التواصل

سجّل الدخول عبر Google أو GitHub من خلال Firebase. لا حاجة لكلمة مرور.

البريد الإلكتروني + كلمة المرور

مصادقة تقليدية بالبريد الإلكتروني وكلمة المرور عبر Firebase.

مفاتيح API

مفاتيح وصول برمجي لتكاملات CI/CD والخدمات.

بعد المصادقة، يُصدر الخادم الخلفي رموز وصول JWT قصيرة العمر (15 دقيقة) ورموز تجديد طويلة العمر (7 أيام). تعرّف على المزيد حول الوصول البرمجي في دليل مفاتيح API.

الخطوات التالية