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

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

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

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

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

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

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

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

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

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

التسجيل

سجّل عبر 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.

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