انتقل إلى المحتوى
شعار أوراباسي
aurabase

الهندسة المعمارية

كيف ينتقل الطلب من عميلك إلى Postgres، وكيف يتم عزل المؤسسات والمشاريع، وكيف يتم توسيع نطاق الخدمات.

شرح7 د قراءةالمستوى وسيطةتمت المراجعة في 04‏/11‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

واجهة خلفية واحدة وثماني خدمات#

Aurabase هو Rust monorepo الذي يبني ثماني خدمات Axum. كل خدمة لها منفذها الخاص ومسارات /v1/<service>/… الخاصة بها، وتتواصل الخدمات مع بعضها البعض عبر طلب/رد NATS. تمر كل حركة المرور من تطبيقاتك عبر بوابة واحدة.

يمكن إعادة تشغيل الخدمة أو تعطلها أو نشرها من تلقاء نفسها. تقوم البوابة بتتبع صحة كل خدمة باستخدام قاطع الدائرة: بعد 5 حالات فشل خلال 60 ثانية، تجيب على 503 لهذه الخدمة لمدة 30 ثانية، ثم تحاول ذلك مرة أخرى.

الخدمات والمسؤوليات#

تمتلك كل خدمة مجالًا واحدًا وعمليات ترحيل SQL الخاصة بها وبياناتها الخاصة. تصل تطبيقاتك إليهم فقط من خلال البوابة.

الخدمةالمجالالمسؤوليات
aura-gatewayبوابة APIالوكيل، البرامج الوسيطة للمصادقة، تحديد المعدل، قاطع الدائرة
aura-authالمصادقةالتسجيل، تسجيل الدخول، OAuth 2.1، TOTP MFA وWebAuthn، الجلسات، JWKS
aura-dbقاعدة البياناتCRUD عبر PostgREST، عمليات الترحيل ذات الإصدارات، وإنشاء النوع، وإدارة المخطط
aura-realtimeالوقت الحقيقيWebSocket، SSE، تتابع الأحداث، الحضور، Postgres تغيير التقاط البيانات
aura-storageالتخزينS3- تخزين الكائنات المتوافقة، والتحميل متعدد الأجزاء، وعناوين URL الموقعة، وتحويلات الصور
aura-functionsEdge Functionsأوقات التشغيل WASM وDeno، وكرون، وقائمة انتظار المهام غير المتزامنة، وقائمة انتظار الأحرف الميتة
aura-notificationsالإخطاراتالبريد الإلكتروني للمعاملات (SMTP)، والرسائل النصية القصيرة، والدفع عبر الهاتف المحمول، وخطافات الويب الموقعة HMAC
aura-aiبوابة الذكاء الاصطناعياستنتاج LLM من خلال نقطة نهاية واحدة، والتضمينات، وRAG مع pgvector

العزلة حسب المنظمة والمشروع#

تحصل كل مؤسسة على مجموعتها PostgreSQL الخاصة بها، والتي يتم توفيرها بواسطة CloudNativePG (CNPG) في مساحة اسم Kubernetes المحجوزة لها. لا تتم مشاركة أي مجموعة أو مساحة اسم أو تجمع اتصال بين مؤسستين. تتبع سعة المجموعة (وحدة المعالجة المركزية الافتراضية والذاكرة والنسخ المتماثلة) خطة المؤسسة.

داخل هذه المجموعة، يحصل كل مشروع على قاعدة بيانات Postgres الخاصة به، مقسمة إلى أربعة مخططات. كل مشروع له دور اتصال خاص به، وهو عضو فقط في الأدوار الخاصة به. يتم منح الحقوق في مخططات المشروع لتلك الأدوار وليس لـ PUBLIC مطلقًا. تقوم البوابة بتعيين الاتصال search_path من المشروع في JWT الخاص بالعميل، وتكون جداول التطبيق محمية بأمان على مستوى الصف (RLS).

في عرض المؤسسة، يمكن للمشروع أيضًا الحصول على مجموعة CNPG مخصصة في مساحة الاسم الخاصة به. ثم يأتي العزل من الفصل المادي للمجموعات، بالإضافة إلى الأذونات.

المخططالمالكالمحتوى
project_{uuid}أنتجداول التطبيقات الخاصة بك
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformمنصةfunctions, jobs, cron, api_keys, webhooks

يتبع ذلك ثلاث عواقب:

  • لا يوجد وصول عبر المستأجرين. لا تشترك مؤسستان مطلقًا في مجموعة أو مساحة اسم أو تجمع اتصال.
  • الهجرات المستقلة. يتم ترحيل كل مشروع ثم التراجع من تلقاء نفسه.
  • تصدير عادي. pg_dump --schema='project_*' يتخلص من بيانات المشروع وملحقاته وسياساته.
مخطط مشترك

تمت مشاركة مخطط aura_console. يحتوي على طاولة projects وجلسات الاستوديو. لا تمر أي بيانات التطبيق من خلال ذلك.

من الضفيرة إلى Postgres#

تتحقق البوابة من كل طلب قبل توجيهه. هذا هو مسار GET /v1/db/{projectId}/devices من عميل REST:

مسار الطلبtext
1. TLS termination        client → aura-gateway
2. Request ID and tracing request_id and trace_id are attached to the request
3. Rate limit             token bucket, answers 429 when the limit is reached
4. Authentication         JWT decoded and claims checked: sub, project_id, role
5. Circuit breaker        the target service is HEALTHY, so the request goes through
6. Execution              search_path set to the project's schemas, then the query runs under RLS

تكتب كل خطوة سجلات منظمة باستخدام tracing، مرتبطة بـ request_id.

التحجيم#

الخدمات عديمة الجنسية. لإضافة سعة، ابدأ نسخة أخرى من الملف الثنائي وقم بتوصيله بـ NATS. ينضم إلى المجموعة ويخدم الطلبات عندما يكون جاهزًا. لا يوجد انتخاب للزعيم ولا يوجد تنسيق موزع.

للذهاب أبعد من ذلك#