الهندسة المعمارية
كيف ينتقل الطلب من عميلك إلى Postgres، وكيف يتم عزل المؤسسات والمشاريع، وكيف يتم توسيع نطاق الخدمات.
واجهة خلفية واحدة وثماني خدمات#
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-functions | Edge 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}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, 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:
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. ينضم إلى المجموعة ويخدم الطلبات عندما يكون جاهزًا. لا يوجد انتخاب للزعيم ولا يوجد تنسيق موزع.
للذهاب أبعد من ذلك#
- قاعدة البيانات
Postgres، المخططات، عمليات الترحيل، RLS، TypeScript إنشاء النوع
- مصادقة
OAuth, MFA, دورة حياة الجلسة, RBAC
- الوقت الحقيقي
تغييرات WebSocket وSSE والتواجد وPostgres
- التخزين
S3- مجموعات متوافقة، وتحويلات، وعناوين URL موقعة
- Edge Functions
أوقات التشغيل WASM وDeno، وكرون، وقائمة انتظار الحروف الميتة
- الاتفاقيات
تسمية المخططات والأعمدة وسياسات RLS