في Aurabase، قدمنا لأنفسنا قيودًا قوية من مرحلة التصميم: يجب أن يكون سطح SDK واتفاقيات RLS متوافقة مع مع Supabase. نفس createClient()، نفس .from().select().eq()، نفس سياسات SQL Postgres. الفكرة: إذا كنت تريد الرحيل، فارحل – نحن نجعل الأمر تافهًا. هنا هو كتاب اللعب الكامل.
ما يتحرك، ما يبقى
قبل أن تبدأ، قم بإدراج ما سيتغير وما سيبقى. المفسد: الأغلبية باقية.
| Postgres المخطط | نفسه | pg_dump → pg_restore. الإضافات، والمشغلات، والوظائف، والفهارس - كل شيء على ما يرام. |
|---|---|---|
| RLS السياسات | نفسه | نفس بناء الجملة. auth.uid()، auth.role()، auth.jwt() تعمل كما هي. |
| جافا سكريبت SDK | 95% متطابقة | استبدل @supabase/supabase-js بـ @aurabase/aurabase-js. نفس واجهة برمجة التطبيقات القابلة للتسلسل. |
| تدفقات المصادقة | نفسه | SignUp، وsignInWithPassword، وsignInWithOAuth، وmfa - نفس الأسماء، ونفس التوقيعات. |
| واجهة برمجة تطبيقات التخزين | نفسه | aura.storage.from(bucket).upload(...) · متوافق مع S3 · سياسات RLS قابلة للتحويل. |
| الوقت الحقيقي | نفسه | القناة ().on ("postgres_changes"، ...) لم تتغير. حضور + بث نفس الشيء . |
| Edge Functions | نفسه | Deno.serve() تم لصقه كما هو في محرر الاستوديو. سيكون لواجهة سطر الأوامر (CLI) وظائف منتشرة تستهدف مسارًا منفصلاً (Rust تم تجميعها إلى WASM). |
| لوحة القيادة | مختلفة | ستوديو Aurabase · نساعدك في العثور على اتجاهاتك. |
قم بإنشاء المشروع Aurabase الهدف
أنشئ مشروع Aurabase جديد باستخدام واجهة سطر الأوامر الرسمية، ثم اربط هذا المجلد بالمشروع بحيث تنطبق عليه الأوامر التالية تلقائيًا.
# Aurabase حساب + واجهة سطر الأوامر
npm i -g @aurabase/cli
aura login
# إنشاء المشروع (محرك Postgres)
aura projects create my-app --engine postgres
# ربط هذا المجلد بالمشروع الذي تم إنشاؤه
aura link --project-id <uuid-du-projet>
# استرجع مفاتيح API للمشروع المرتبط
aura projects api-keys
تفريغ Supabase، استعادة Aurabase
يعرض المعيار pg_dump / pg_restore: Aurabase سلسلة اتصال مباشرة Postgres لكل مشروع (Studio → الإعدادات → Connection)، دون الحاجة إلى تحويل وسيط.
# استرجع سلسلة الاتصال Supabase من لوحة المعلومات الخاصة بهم
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# تفريغ المخطط العام (بدون مخططات النظام Supabase)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# استرداد سلسلة الاتصال Aurabase (الاستوديو → الإعدادات → الاتصال)
# المعلمة ?search_path= إلزامية: فهي تقوم بالتوجيه إلى مخطط مشروعك
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# قم بالاستعادة باستخدام pg_restore القياسي
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# إعادة إنشاء أنواع TypeScript
aura db generate > src/aurabase.types.ts
ترحيل المستخدمين
هناك نقطة للتصحيح مقارنة بما ذكرناه هنا سابقًا: Aurabase يقوم بتجزئة كلمات المرور باستخدام Argon2id، لكن Supabase (GoTrue) يقوم بتجزئة كلمات المرور الخاصة به افتراضيًا باستخدام bcrypt - التنسيقان غير قابلين للتبديل. لذلك سيتعين على المستخدمين لديك إعادة تعيين كلمة المرور الخاصة بهم مرة واحدة، كما هو الحال مع معظم عمليات الترحيل.
Aurabase لا يقدم حاليًا أداة استيراد جماعي من Supabase. هناك خياران: السماح للمستخدمين بإعادة تسجيل أنفسهم (signUp بنفس عنوان البريد الإلكتروني)، أو إعادة إنشائهم واحدًا تلو الآخر من جانب المسؤول باستخدام aura auth users create --email <email> قبل بدء إعادة تعيين كلمة المرور.
لا يتم نقل الجلسات النشطة على الجانب Supabase (مستحيل تقنيًا - تقوم كل منصة بتوقيع JWTs الخاصة بها بمفتاحها الخاص). سيحتاج المستخدمون إلى تسجيل الدخول مرة أخرى باستخدام كلمة المرور الجديدة.
التكيف مع رمز العميل
البحث/الاستبدال يكفي لـ 95% من الحالات.
// قبل (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// بعد (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// بقية الكود لا يتغير:
await aura.from('posts').select('*').eq('author_id', userId)
نشر Edge Functions
يقدم Aurabase مسارين لـ Edge Functions: محرر كود الاستوديو (وقت تشغيل Deno، مثل Supabase - الصق وظيفتك كما هي) وaura functions deployCLI، الذي يهدف إلى إنشاء مسار منفصل للوظائف المكتوبة في Rust والمجمعة في WASM. لترحيل كود Deno الموجود دون إعادة كتابته، استخدم Studio.
// يعمل بنفس الطريقة، ويتم لصقه كما هو في محرر الاستوديو
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
تبديل DNS وإطلاق الإنتاج
استراتيجيتان محتملتان. يوصى بالأول في 99٪ من الحالات.
- قطع مباشر - قم بتغيير
NEXT_PUBLIC_AURABASE_URLوNEXT_PUBLIC_AURABASE_ANON_KEYفي env vars، وأعد النشر. إعادة الاتصال للمستخدمين، ويعمل كل شيء. الموصى بها لغالبية المشاريع. - الكتابة المزدوجة المؤقتة - اكتب Supabase + Aurabase في وقت واحد لمدة 48 ساعة، وتحقق من تناسق الجداول المهمة يدويًا (عد الصفوف، المجاميع الاختبارية)، ثم قم بإيقاف تشغيل Supabase. المفضل للتطبيقات الهامة.
نحن هنا إذا تعطلت الأمور
بالنسبة للمشاريع الكبيرة أو ذات قيود الامتثال الصارمة، يمكن لفريقنا تقديم الدعم لك في عملية الترحيل. اتصل بنا للحصول على عرض مخصص لمشروعك.