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

الاتفاقيات

تسمية المخططات والأعمدة وسياسات RLS ومساعدي المصادقة والفهارس. اصطلاحات مستقرة وموثقة بحيث يكون لدى فريقك طريقة واحدة لتسمية الأشياء.

المرجع6 د قراءةالمستوى مبتدئتمت المراجعة في 15‏/04‏/2026

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

بادئة واحدة لكل مجال#

يتلقى كل مشروع أربعة مخططات فرعية مسبوقة بـ project_{uuid}. تدخل جداول الأعمال الخاصة بك في المخطط الرئيسي؛ لا تقم أبدًا بإنشاء كائنات في مخططات النظام.

المخططالمالكاستخدم
project_{uuid}أنتالجداول وطرق العرض ووظائف الأعمال. هذا هو المخطط الذي وصلت إليه SQL غير المؤهلة (create table posts …) ؛ يتم تسميته public فقط في SQL التي تقوم بتصديرها باستخدام aura db backup download و schema/dump، وهي محمولة.
project_{uuid}_authaura-authالمستخدمون والجلسات وMFA. لا تقم بتعديل.
project_{uuid}_storageaura-storageالدلاء والأشياء وسياسات التخزين
project_{uuid}_platformمنصةالوظائف والوظائف والكرون والأسرار

Snake_case، الجمع، معرف uuid#

  • الجمع الجداول: posts, comments, invoices
  • الأعمدة في snake_case: created_at, user_id, last_seen_at
  • المفاتيح الأساسية id uuid primary key default gen_random_uuid() — لا uuid_generate_v4(). تفضيل uuid على bigint generated always as identity عندما تكون المعرفات مكشوفة للعملاء (لا يمكن تخمينها، لا توجد مشكلة دقة 2^53 في JavaScript)؛ يعمل عمود الهوية أيضًا، وتتعامل معه عمليات النسخ الاحتياطي والاستعادة.
  • الطوابع الزمنية timestamptz، لا timestamp عارٍ أبدًا
  • FKs لاحقة _id: author_id, tenant_id
  • القيم المنطقية مسبوقة بـ is_ أو has_
  • لا يوجد عمود project_id — المخطط هو العازل بالفعل
exemplesql
create table posts (
  id            uuid primary key default gen_random_uuid(),
  author_id     uuid not null references users(id) on delete cascade,
  title         text not null,
  is_published  boolean not null default false,
  created_at    timestamptz not null default now()
);
انتبه

لا تقم مطلقًا بإضافة عمود project_id. يأتي العزل بالفعل من المخطط، وسيضيف مثل هذا العمود فهارس دون إضافة أمان.

يتم إدخال ثلاث وظائف في كل جلسة#

تفتح البوابة اتصالات Postgres مع تحديد request.jwt.claims. يقرأ المساعدون الثلاثة أدناه هذه المطالبات ويمكن استخدامها في أي مكان في سياساتك.

  • auth.uid() — uuid للمستخدم الحالي، NULL إذا كان مجهولاً
  • auth.role() — نص · حالًا / مصادق عليه / دور_الخدمة
  • auth.tenant() — uuid للمستأجر الحالي (RBAC متعدد المستأجرين)
  • auth.has_role(name) — منطقي · صحيح إذا كان لدى المستخدم دور التطبيق هذا
  • auth.email() — نص · البريد الإلكتروني للمستخدم، اقرأ من JWT
  • auth.claim(key) — jsonb · الوصول الأولي إلى المطالبة المخصصة

اسم يمكن التنبؤ به، عملية، دور#

الاتفاقية: <table>_<scope>_<operation>. مثال: posts_own_read, orders_admin_delete. حدد دائمًا to aura_authenticated أو to aura_anon.

namingsql
-- ✓ جيد: table_scope_op
create policy "posts_own_read"   on posts for select …
create policy "orders_admin_all" on orders for all …

-- ✗ لتجنب
create policy "allow_stuff"    -- غامضة جدا
create policy "new_policy_42" -- ليست وصفية

التسمية ومتى يتم الفهرسة#

  • الاسم: idx_<table>_<colonnes> أو uq_<table>_<colonnes> (فريد)
  • فهرسة دائمًا: FKs، أعمدة filter المتكررة /order_by، where لسياسات RLS
  • لا تقم بالفهرسة: الأعمدة المنطقية ذات العلاقة الأساسية العالية المنخفضة (استخدم الفهرس الجزئي)، والجداول <1000 صف
  • pgvector: using hnsw لأكثر من 100 ألف متجه، ivfflat خلاف ذلك

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