# كيف نقلت 182 ألف مستخدم إلى Supabase

By Tarik Pinarci (https://tarikpinarci.com). Published 2025-03-30. Canonical: https://tarikpinarci.com/ar/blog/migration-to-supabase

من تأجيل الأمر لشهور إلى نقل 182 ألف مستخدم: هكذا نقلت تطبيقي أخيرًا إلى Supabase.

نقل 182,000 مستخدم إلى واجهة خلفية (backend) جديدة ليس إنجازًا صغيرًا، خاصة عندما تكون مطور تطبيقات هاتف تعمل وحدك وتوازن ذلك مع وظيفة بدوام كامل. لكنني نجحت. نقلت تطبيقي OSM Tactics من إعداد متشابك يجمع NestJS وMongoDB إلى Supabase، الموضوع الساخن في أوساط الـ backend حاليًا. في هذا المقال سأصحبك في الرحلة: لماذا اخترت Supabase، والتحديات التي واجهتها، وكيف أنجزت عملية الترحيل.

### لماذا Supabase؟

عندما بدأت الواجهة الخلفية لتطبيقي تبدو قديمة، بحثت عن شيء أفضل، ولفت Supabase انتباهي. إنه مشروع مفتوح المصدر يشبه Firebase لكنه أسهل في البدء. يمنحك قاعدة بيانات PostgreSQL مع API سهلة، وميزات لحظية (real-time)، وميزات تسجيل دخول جاهزة. وبالنسبة لي، كشخص يبني تطبيقات للهاتف، هذا مثالي: لا أريد العبث بأمور الخوادم المعقدة. يمكنك تشغيل مشروع Supabase في نحو خمس دقائق، والتوثيق مباشر جدًا، لذا لم أشعر بالضياع رغم أنني لست محترفًا في الـ backend.

لكن Supabase ليس سهلًا فقط، بل يكبر أيضًا. ليس بحجم Firebase بعد، لكن عددًا كبيرًا من المطورين يستخدمونه، ومجتمعه ينمو بسرعة. فيه كل ما أحتاج إليه: قاعدة بيانات للتخزين، وأدوات لتسجيل الدخول، ومكان لرفع الملفات، وحتى دوال صغيرة أستطيع تشغيلها من دون خادم كامل. يخفي Firebase طريقة عمله، أما Supabase فيستخدم PostgreSQL، وهي قاعدة بيانات قديمة وموثوقة يثق بها كثيرون. وهذا يعني أنني أستطيع تغيير الأشياء كما أريد وتوسيعها لاحقًا من دون أن أعلق. إضافة إلى ذلك، هناك مجموعة كبيرة من المطورين على الإنترنت يتشاركون النصائح والحيل والحلول في أماكن مثل GitHub. كنت أعرف أنني إذا علقت يمكنني البحث في Google أو سؤال أحدهم. وبالنسبة لمبرمج يعمل وحده مثلي ووقته ضيق، بدا Supabase الخيار الصحيح: بسيط لكنه قوي بما يكفي لتحمّل تطبيقي.

### الإعداد القديم قبل التحول الكبير

![](https://cdn-images-1.medium.com/max/2000/0*8Dz9gnNI7LqoicSk.gif)

قبل أن أنتقل إلى Supabase، لنتحدث عما كنت أستخدمه. تطبيقي [OSM Tactics](https://apps.apple.com/us/app/osm-tactics/id1632773385) لعبة للهاتف على Android وiOS يخطط فيها الناس لاستراتيجيات تكتيكية، وهي ممتعة جدًا إن كنت مهتمًا بذلك. بنيت الواجهة الخلفية بنفسي باستخدام NestJS، وهو إطار عمل لـ Node.js أحببته لأنه يعمل مع TypeScript ويبقي الأمور منظمة. كان يتواصل مع MongoDB، قاعدة البيانات التي حفظت فيها كل معلومات المستخدمين وبيانات اللعبة وأشياء أخرى. وظللت أشغّل هذا الإعداد قرابة أربع سنوات.

![آخر لقطة لقاعدة MongoDB قبل الترحيل، Osm Tactics المعروف أيضًا باسم “Osm Guide” ](https://cdn-images-1.medium.com/max/4072/1*oPXY2-yvVmlns_ufWV4ZGg.png)_آخر لقطة لقاعدة MongoDB قبل الترحيل، Osm Tactics المعروف أيضًا باسم “Osm Guide”_

لكن هنا المشكلة: أنا شخص واحد لديه وظيفة بدوام كامل، وإبقاء هذه الواجهة الخلفية حية كان يرهقني. في البداية كان NestJS وMongoDB على ما يرام، وكنت أستطيع التعامل معهما. لكن مع انضمام مستخدمين أكثر أصبح الأمر فوضويًا. كان عليّ أن أقضي وقتًا طويلًا جدًا في التأكد من أن الخادم لا ينهار، وفي سد الثغرات الأمنية، وفي إبقائه سريعًا بما يكفي. وكان الأمان أسوأ جزء: أعرف شيئًا من Node.js، لكنني مطور تطبيقات هاتف، لست خبيرًا في الـ backend. كان ما يزال يعمل بشكل ما، لكنه كان كسيارة قديمة تتعطل باستمرار. لم أكن أستطيع ترقيعه إلى الأبد. كنت أحتاج إلى شيء جديد لا يجعلني أرغب في نتف شعري.

### القفزة: قرار الترحيل

![](https://cdn-images-1.medium.com/max/2000/1*CUFLlvoA2ItnVtEFWJulrg.png)

لم يكن قرار نقل كل شيء سريعًا، بل استغرق وقتًا طويلًا جدًا لأنني ظللت أؤجله. OSM Tactics ليس تطبيقًا عملاقًا بميزات كثيرة، لكن 182 ألف مستخدم يعني بيانات كثيرة يجب التعامل معها. والانتقال من MongoDB، حيث البيانات حرة وغير مقيدة، إلى PostgreSQL في Supabase، حيث كل شيء في جداول مرتبة، بدا صعبًا. كان عليّ إعادة تصميم طريقة تنظيم البيانات والتأكد من أنني لن أفقد أي شيء مهم. كان ثنائي NestJS وMongoDB القديم ما يزال يعمل، لكن كان لدي إحساس سيئ بأنه سينفجر قريبًا. ظل هذا القلق يزعجني حتى قلت أخيرًا: "حسنًا، لنفعلها."

بعد أن قررت، كان عليّ التخطيط بجدية. جلست وحددت كيف أحوّل بيانات MongoDB إلى جداول في Supabase، كأنني أرسم خريطة لمكان كل شيء. الخطوة الأولى كانت إخراج كل بياناتي من MongoDB بأمان، فكتبت سكربتًا صغيرًا يفرغها في ملفات JSON. إليك هذا الكود، وهو بسيط لكنه أدى المهمة:

```javascript
async function exportCollection(collectionName, outputFileName, query = {}) {
  try {
    await mongoose.connect(mongoURI);

    const Model = mongoose.model(
      collectionName,
      genericSchema,
      collectionName.toLowerCase()
    );

    const documents = await Model.find(query).lean();

    const outputPath = path.join(__dirname, outputFileName);
    fs.writeFileSync(outputPath, JSON.stringify(documents, null, 2));

    await mongoose.disconnect();

    return documents;
  } catch (error) {
    if (mongoose.connection.readyState !== 0) {
      await mongoose.disconnect();
    }
  }
}
```

اتصل هذا السكربت بـ MongoDB، وسحب كل البيانات، وحفظها كملفات JSON على حاسوبي. كان أشبه بنسخة احتياطية: أستطيع التجربة من دون أن أفقد كل شيء إذا أخطأت. شغّلته لكل collection، وفحصت الملفات للتأكد من أنها تبدو سليمة، وشعرت بارتياح أكبر قليلًا لأن لدي نسخًا. ومع ذلك ظللت أماطل في بدء العمل الحقيقي: أحدّق في الشاشة، وأرتشف القهوة، وأفكر: "ربما غدًا." احتجت إلى دفعة كبيرة لأتوقف عن التكاسل وأبدأ فعلًا، لكن عندما بدأت انغمست تمامًا.

### ترحيل المستخدمين: لغز كلمات المرور

هنا أصبح الأمر معقدًا فعلًا: نقل 182 ألف مستخدم مع إبقاء كلمات مرورهم صالحة. يتوقع المستخدمون أن يسجلوا الدخول بالبريد الإلكتروني وكلمة المرور نفسيهما بعد تحديث التطبيق، وهكذا يجب أن يكون الأمر. لكن تنفيذ ذلك كان كابوسًا. الشيء الجيد؟ [يستخدم Supabase خوارزمية bcrypt لكلمات المرور](https://supabase.com/docs/guides/auth/password-security#how-are-passwords-stored)، تمامًا كما في MongoDB، لذا لم أضطر إلى إعادة تشفيرها كلها أو إجبار المستخدمين على اختيار كلمات مرور جديدة. كانت تلك ستكون تجربة سيئة جدًا: الناس يكرهون إعادة تعيين كلمات المرور، وكنت سأخسر عددًا كبيرًا منهم.

### التعامل مع جدول المصادقة المتشدد في Supabase

لدى Supabase جدول auth.users لتسجيل الدخول، وهو متشدد جدًا. فيه حقول كثيرة يجب أن تملأها بدقة، وإلا يضطرب. فمثلًا، إذا وضعت نصًا فارغًا بدل null، يتعطل. وجدت بعض الأخطاء التي واجهها آخرون في [هذا النقاش على GitHub](https://github.com/supabase/auth/issues/1940)، وقد أخافني ذلك بما يكفي لأكون حذرًا. كان عليّ أن أطابقه تمامًا. هكذا كان شكل المستخدم في Supabase (لم أستخدم بيانات الهاتف، لذا قيمها null، فغيّرها إن كنت تستخدمها):

```javascript
const supabaseUser = {
  id: uid,
  email: user.email,
  encrypted_password: user.password || null,
  instance_id: "00000000–0000–0000–0000–000000000000",
  aud: "authenticated",
  role: "authenticated",
  email_confirmed_at: user.createdAt
    ? new Date(user.createdAt).toISOString()
    : new Date().toISOString(),
  created_at: user.createdAt
    ? new Date(user.createdAt).toISOString()
    : new Date().toISOString(),
  updated_at: user.updatedAt ? new Date(user.updatedAt).toISOString() : null,
  last_sign_in_at: null,
  phone: user.phone || null,
  phone_confirmed_at: null,
  confirmed_at: user.createdAt
    ? new Date(user.createdAt).toISOString()
    : new Date().toISOString(),
  invited_at: null,
  confirmation_token: "",
  confirmation_sent_at: null,
  recovery_token: "",
  recovery_sent_at: null,
  email_change_token_new: "",
  email_change: "",
  email_change_sent_at: null,
  email_change_token_current: "",
  email_change_confirm_status: 0,
  banned_until: null,
  reauthentication_token: "",
  reauthentication_sent_at: null,
  is_super_admin: null,
  phone_change: "",
  phone_change_token: "",
  phone_change_sent_at: null,
  is_sso_user: false,
  deleted_at: null,
  is_anonymous: false,
  raw_user_meta_data: JSON.stringify(rawUserMetaData),
  raw_app_meta_data: JSON.stringify(rawAppMetaData),
};
```

كان عليّ ضبط كل حقل بدقة، وإلا لن يقبله Supabase. ولنقل كل مستخدمي MongoDB، كتبت سكربتًا أكبر يجلبهم ويحوّلهم إلى هذا الشكل ويحفظهم في ملف CSV. إليك هذا السكربت، وهو طويل لكنه يُظهر العملية كلها:

```javascript
const fs = require("fs");
const path = require("path");
const { parse } = require("json2csv");
const { v4: uuidv4 } = require("uuid");
const mongoose = require("mongoose");
const mongoURI = "your-connection-string";

// Define a generic schema for flexible document structure
const userSchema = new mongoose.Schema({}, { strict: false });
async function fetchUsersFromMongoDB() {
  try {
    console.log("Connecting to MongoDB…");
    await mongoose.connect(mongoURI);
    console.log("Connected to MongoDB");
    const UserModel = mongoose.model("Users", userSchema, "users");
    console.log("Fetching users from MongoDB…");
    const users = await UserModel.find({}).lean();
    console.log(`Found ${users.length} users in MongoDB`);
    await mongoose.disconnect();
    console.log("Disconnected from MongoDB");
    return users;
  } catch (error) {
    console.error("Error fetching users from MongoDB:", error);
    if (mongoose.connection.readyState !== 0) {
      await mongoose.disconnect();
    }
    throw error;
  }
}

async function processUsers() {
  console.time("Total processing time");
  const mongoUsersFilePath = path.join(__dirname, "mongo_users.json");
  try {
    // Step 1: Fetch users from MongoDB
    const users = await fetchUsersFromMongoDB();
    // Step 2: Write users to a fresh JSON file
    fs.writeFileSync(mongoUsersFilePath, JSON.stringify(users, null, 2));
    console.log(`Fresh users data written to: ${mongoUsersFilePath}`);
    // Step 3: Read the fresh users file
    const usersData = JSON.parse(fs.readFileSync(mongoUsersFilePath, "utf8"));
    console.log(`Read ${usersData.length} users from fresh file`);
    // Step 4: Filter users to include only those with an email or at least one provider
    const filteredUsers = usersData.filter((user) => {
      return user.email || user.googleId || user.appleId;
    });
    console.log(`Filtered users: ${filteredUsers.length}`);
    // Create a Set to track used IDs and ensure uniqueness
    const usedIds = new Set();
    const usedEmails = new Set();
    const duplicateEmails = [];
    // Step 5: Transform the data to match Supabase Auth users structure
    const transformedUsers = [];
    filteredUsers.forEach((user) => {
      if (!user.email) {
        console.log("Skipping user without email:", user._id);
        return;
      }
      // Check for duplicate email
      const lowerEmail = user.email.toLowerCase();
      if (usedEmails.has(lowerEmail)) {
        duplicateEmails.push({
          email: user.email,
          id: user._id,
          googleId: user.googleId,
          appleId: user.appleId,
        });
        console.warn(`Duplicate email detected and skipped: ${user.email}`);
        return;
      }
      // Mark this email as used
      usedEmails.add(lowerEmail);
      let uid = uuidv4();
      while (usedIds.has(uid)) {
        console.warn("Duplicate ID detected:", uid);
        uid = uuidv4();
      }
      usedIds.add(uid);
      const rawUserMetaData = {
        sub: uid,
        email: user.email,
        email_verified: true,
        phone_verified: false,
      };
      const providers = [];
      // Check for Google ID
      if (user.googleId) {
        providers.push("google");
        rawUserMetaData.iss = "https://accounts.google.com";
        rawUserMetaData.sub = user.googleId;
        rawUserMetaData.provider_id = user.googleId;
      }
      // Check for Apple ID
      if (user.appleId) {
        providers.push("apple"); // Only override iss and sub if Google wasn't already set
        if (!user.googleId) {
          rawUserMetaData.iss = "https://appleid.apple.com";
          rawUserMetaData.sub = user.appleId;
          rawUserMetaData.provider_id = user.appleId;
        }
      }
      // If no external providers, use email
      if (providers.length === 0) {
        providers.push("email");
      }
      // Set the raw app metadata
      const rawAppMetaData = {
        provider: providers[0], // Primary provider is the first one
        providers: providers, // All providers in an array
      };
      transformedUsers.push({
        id: uid,
        email: user.email || null,
        encrypted_password: user.password,
        instance_id: "00000000–0000–0000–0000–000000000000",
        aud: "authenticated",
        role: "authenticated",
        invited_at: null,
        confirmation_token: "",
        confirmation_sent_at: null,
        recovery_token: "",
        recovery_sent_at: null,
        email_change_token_new: "",
        email_change: "",
        email_change_sent_at: null,
        last_sign_in_at: new Date().toISOString(),
        is_super_admin: null,
        phone: "",
        phone_confirmed_at: null,
        phone_change: "",
        phone_change_token: "",
        phone_change_sent_at: null,
        confirmed_at: new Date().toISOString(),
        email_change_token_current: "",
        email_change_confirm_status: 0,
        banned_until: null,
        reauthentication_token: "",
        reauthentication_sent_at: null,
        is_sso_user: false,
        deleted_at: null,
        is_anonymous: false,
        created_at: user.createdAt
          ? new Date(user.createdAt).toISOString()
          : new Date().toISOString(),
        updated_at: null,
        email_confirmed_at: user.createdAt
          ? new Date(user.createdAt).toISOString()
          : new Date().toISOString(),
        phone: user.phone || null,
        phone_confirmed_at: null,
        raw_user_meta_data: rawUserMetaData,
        raw_app_meta_data: rawAppMetaData,
      });
    });
    // Step 6: Convert the transformed data to CSV
    const csvFields = [
      "id",
      "email",
      "encrypted_password",
      "instance_id",
      "aud",
      "role",
      "email_confirmed_at",
      "invited_at",
      "confirmation_token",
      "confirmation_sent_at",
      "recovery_token",
      "recovery_sent_at",
      "email_change_token_new",
      "email_change",
      "email_change_sent_at",
      "last_sign_in_at",
      "raw_app_meta_data",
      "raw_user_meta_data",
      "is_super_admin",
      "created_at",
      "updated_at",
      "phone",
      "phone_confirmed_at",
      "phone_change",
      "phone_change_token",
      "phone_change_sent_at",
      "confirmed_at",
      "email_change_token_current",
      "email_change_confirm_status",
      "banned_until",
      "reauthentication_token",
      "reauthentication_sent_at",
      "is_sso_user",
      "deleted_at",
      "is_anonymous",
    ];
    // Write duplicate emails to a file for reference
    if (duplicateEmails.length > 0) {
      fs.writeFileSync(
        path.join(__dirname, "duplicate_emails.json"),
        JSON.stringify(duplicateEmails, null, 2)
      );
      console.log("Duplicate emails written to duplicate_emails.json");
    }
    const csv = parse(transformedUsers, { fields: csvFields });
    // Step 7: Write the CSV to a file
    const csvFilePath = path.join(__dirname, "supabase_users.csv");
    fs.writeFileSync(csvFilePath, csv);
    console.log("CSV file has been generated:", csvFilePath);
    // Step 8: Delete the temporary fresh users file
    if (fs.existsSync(mongoUsersFilePath)) {
      fs.unlinkSync(mongoUsersFilePath);
      console.log(`Temporary file deleted: ${mongoUsersFilePath}`);
    }
    console.timeEnd("Total processing time");
  } catch (error) {
    console.error("Error processing users:", error);
  } finally {
    if (fs.existsSync(mongoUsersFilePath)) {
      try {
        fs.unlinkSync(mongoUsersFilePath);
        console.log(`Temporary file deleted: ${mongoUsersFilePath}`);
      } catch (deleteError) {
        console.error(`Error deleting temporary file: ${deleteError.message}`);
      }
    }
  }
}
```

بعد أن حصلت على ملف CSV، أنشأت جدولًا مؤقتًا في Supabase يشبه auth.users. تعريف الجدول الحقيقي عبارة عن SQL طويل يمكنك رؤيته في محرر Supabase تحت schema auth > users > Definition:

```sql
    create table auth.users (
      instance_id uuid null,
      id uuid not null,
      aud character varying(255) null,
      role character varying(255) null,
      email character varying(255) null,
      encrypted_password character varying(255) null,
      email_confirmed_at timestamp with time zone null,
      invited_at timestamp with time zone null,
      confirmation_token character varying(255) null,
      confirmation_sent_at timestamp with time zone null,
      recovery_token character varying(255) null,
      recovery_sent_at timestamp with time zone null,
      email_change_token_new character varying(255) null,
      email_change character varying(255) null,
      email_change_sent_at timestamp with time zone null,
      last_sign_in_at timestamp with time zone null,
      raw_app_meta_data jsonb null,
      raw_user_meta_data jsonb null,
      is_super_admin boolean null,
      created_at timestamp with time zone null,
      updated_at timestamp with time zone null,
      phone text null default null::character varying,
      phone_confirmed_at timestamp with time zone null,
      phone_change text null default ''::character varying,
      phone_change_token character varying(255) null default ''::character varying,
      phone_change_sent_at timestamp with time zone null,
      confirmed_at timestamp with time zone GENERATED ALWAYS as (LEAST(email_confirmed_at, phone_confirmed_at)) STORED null,
      email_change_token_current character varying(255) null default ''::character varying,
      email_change_confirm_status smallint null default 0,
      banned_until timestamp with time zone null,
      reauthentication_token character varying(255) null default ''::character varying,
      reauthentication_sent_at timestamp with time zone null,
      is_sso_user boolean not null default false,
      deleted_at timestamp with time zone null,
      is_anonymous boolean not null default false,
      constraint users_pkey primary key (id),
      constraint unique_email unique (email),
      constraint users_phone_key unique (phone),
      constraint users_email_change_confirm_status_check check (
        (
          (email_change_confirm_status >= 0)
          and (email_change_confirm_status <= 2)
        )
      )
    ) TABLESPACE pg_default;

    create unique INDEX IF not exists confirmation_token_idx on auth.users using btree (confirmation_token) TABLESPACE pg_default
    where
      ((confirmation_token)::text !~ '^[0-9 ]*$'::text);

    create unique INDEX IF not exists email_change_token_current_idx on auth.users using btree (email_change_token_current) TABLESPACE pg_default
    where
      (
        (email_change_token_current)::text !~ '^[0-9 ]*$'::text
      );

    create unique INDEX IF not exists email_change_token_new_idx on auth.users using btree (email_change_token_new) TABLESPACE pg_default
    where
      (
        (email_change_token_new)::text !~ '^[0-9 ]*$'::text
      );

    create unique INDEX IF not exists reauthentication_token_idx on auth.users using btree (reauthentication_token) TABLESPACE pg_default
    where
      (
        (reauthentication_token)::text !~ '^[0-9 ]*$'::text
      );

    create unique INDEX IF not exists recovery_token_idx on auth.users using btree (recovery_token) TABLESPACE pg_default
    where
      ((recovery_token)::text !~ '^[0-9 ]*$'::text);

    create unique INDEX IF not exists users_email_partial_key on auth.users using btree (email) TABLESPACE pg_default
    where
      (is_sso_user = false);

    create index IF not exists users_instance_id_email_idx on auth.users using btree (instance_id, lower((email)::text)) TABLESPACE pg_default;

    create index IF not exists users_instance_id_idx on auth.users using btree (instance_id) TABLESPACE pg_default;

    create index IF not exists users_is_anonymous_idx on auth.users using btree (is_anonymous) TABLESPACE pg_default;
```

نسخت هذا التعريف للجدول المؤقت، ورفعت ملف CSV إليه، ثم استخدمت هذا السكربت لنقل المستخدمين إلى جدول auth.users الحقيقي ألفًا بعد ألف:

```sql
    DO $$
    DECLARE
        batch_size INT := 1000;  -- Adjust batch size as needed
        records_inserted INT;
    BEGIN
        LOOP
            INSERT INTO auth.users (
                id,
                email,
                encrypted_password,
                instance_id,
                aud,
                role,
                email_confirmed_at,
                invited_at,
                confirmation_token,
                confirmation_sent_at,
                recovery_token,
                recovery_sent_at,
                email_change_token_new,
                email_change,
                email_change_sent_at,
                last_sign_in_at,
                raw_app_meta_data,
                raw_user_meta_data,
                is_super_admin,
                created_at,
                updated_at,
                phone,
                phone_confirmed_at,
                phone_change,
                phone_change_token,
                phone_change_sent_at,
                email_change_token_current,
                email_change_confirm_status,
                banned_until,
                reauthentication_token,
                reauthentication_sent_at,
                is_sso_user,
                deleted_at,
                is_anonymous
            )
            SELECT
                id,
                email,
                encrypted_password,
                COALESCE(instance_id, '00000000-0000-0000-0000-000000000000'),
                COALESCE(aud, 'authenticated'),
                COALESCE(NULLIF(role, ''), 'authenticated'),
                COALESCE(email_confirmed_at, NOW()),
                COALESCE(invited_at, NULL),
                COALESCE(confirmation_token, ''),
                COALESCE(confirmation_sent_at, NULL),
                COALESCE(recovery_token, ''),
                COALESCE(recovery_sent_at, NULL),
                COALESCE(email_change_token_new, ''),
                COALESCE(email_change, ''),
                COALESCE(email_change_sent_at, NULL),
                COALESCE(last_sign_in_at, NOW()),
                raw_app_meta_data,  -- Use value from test_users table
                raw_user_meta_data, -- Use value from test_users table
                COALESCE(is_super_admin, NULL),
                COALESCE(created_at, NOW()),
                COALESCE(updated_at, NOW()),
                COALESCE(phone, NULL),
                COALESCE(phone_confirmed_at, NULL),
                COALESCE(phone_change, ''),
                COALESCE(phone_change_token, ''),
                COALESCE(phone_change_sent_at, NULL),
                COALESCE(email_change_token_current, ''),
                COALESCE(email_change_confirm_status, 0),
                COALESCE(banned_until, NULL),
                COALESCE(reauthentication_token, ''),
                COALESCE(reauthentication_sent_at, NULL),
                COALESCE(is_sso_user, false),
                COALESCE(deleted_at, NULL),
                COALESCE(is_anonymous, false)
            FROM public.test_users
            LIMIT batch_size
            ON CONFLICT (email) DO NOTHING;  -- Ignore duplicates

            GET DIAGNOSTICS records_inserted = ROW_COUNT;

            -- Exit the loop if no more records are inserted
            IF records_inserted = 0 THEN
                EXIT;
            END IF;
        END LOOP;
    END $$;
```

بهذه الطريقة استطعت رؤية كل خطوة: التصدير، والتحويل، والتحميل. استغرق ذلك وقتًا أطول مما قد تستغرقه أداة متطورة، لكنني أحببت أن أعرف بالضبط ما يحدث. كنت أفحص الجدول المؤقت بعد تحميل ملف CSV، وأتحقق عشوائيًا من بعض الصفوف، ثم أراقب سكربت الدفعات وهو يعمل للتأكد من أنه لا يتعثر.

### لا مكان للحقول المخصصة

لا يسمح جدول auth.users في Supabase بإضافة حقولك الخاصة، وهذا أربكني. في MongoDB كنت أضيف حقل username ببساطة، ولا مشكلة. لكن Supabase يرفض ذلك، وأنت مقيد بما يقدمه. فكرت في حشر البيانات الإضافية داخل raw_user_meta_data، وهو أشبه بحقيبة JSON، لكن ذلك فوضوي عند البحث لاحقًا. بدلًا من ذلك أنشأت جدول profiles جديدًا يرتبط بـ auth.users عبر معرّف المستخدم. يحتوي على أشياء مثل username وlocale، فيبقى كل شيء مرتبًا.

انظر أيضًا هذا النقاش الذي قد يفيدك: [https://github.com/orgs/supabase/discussions/3491](https://github.com/orgs/supabase/discussions/3491)

إعداد ذلك تطلب عملًا إضافيًا: كان عليّ سحب تلك الحقول الإضافية من MongoDB، ومطابقتها مع المستخدمين الصحيحين، وتحميلها في الجدول الجديد. كتبت سكربتًا آخر لجلب هذه البيانات، وحوّلتها إلى ملف CSV، ورفعتها إلى Supabase بعد الانتهاء من جزء المصادقة. الإعداد الآن أفضل لأنني أستطيع إضافة حقول أخرى لاحقًا من دون كسر أي شيء، لكنه جعل الترحيل يستغرق وقتًا أطول لأنني تعاملت مع جدولين بدل جدول واحد.

### ترحيل تسجيل الدخول عبر Google وApple

![](https://cdn-images-1.medium.com/max/2400/0*ojwVN2SEuLBx9Ybn.jpeg)

كان تسجيل الدخول عبر Google وApple مزعجًا أيضًا. في MongoDB كان لدي الحقلان googleId وappleId، وبعض المستخدمين كان لديهم الاثنان مرتبطين ببريد إلكتروني واحد. يتعامل Supabase مع ذلك عبر حقول خاصة في raw_user_meta_data مثل iss وsub وprovider_id.

هكذا أعددت ذلك:

```javascript
const uid = uuidv4();
const providers = [];
// Build raw user metadata
const rawUserMetaData = {
  sub: uid,
  email: user.email,
  email_verified: true,
  phone_verified: false,
};
// Check for Google ID
if (user.googleId) {
  providers.push("google");
  rawUserMetaData.iss = "https://accounts.google.com";
  rawUserMetaData.sub = user.googleId;
  rawUserMetaData.provider_id = user.googleId;
}
// Check for Apple ID
if (user.appleId) {
  providers.push("apple");
  if (!user.googleId) {
    rawUserMetaData.iss = "https://appleid.apple.com";
    rawUserMetaData.sub = user.appleId;
    rawUserMetaData.provider_id = user.appleId;
  }
}
// If no external providers, use email
if (providers.length === 0) {
  providers.push("email");
}
```

في التطبيق حدّثت مسارات تسجيل الدخول لتستخدم واجهات API الخاصة بـ Supabase. بالنسبة لـ Apple:

```javascript
import * as AppleAuthentication from "expo-apple-authentication";
import { supabase } from "your-supabase-client";

const credential = await AppleAuthentication.signInAsync({
  requestedScopes: [
    AppleAuthentication.AppleAuthenticationScope.FULL_NAME,
    AppleAuthentication.AppleAuthenticationScope.EMAIL,
  ],
});
if (credential.identityToken) {
  const { data, error } = await supabase.auth.signInWithIdToken({
    provider: "apple",
    token: credential.identityToken,
  });
}
```

وبالنسبة لـ Google:

```javascript
import { GoogleSignin } from "@react-native-google-signin/google-signin";
import { supabase } from "your-supabase-client";

const googleUser = await GoogleSignin.signIn();

if (googleUser.idToken) {
  const { data, error } = await supabase.auth.signInWithIdToken({
    provider: "google",
    token: googleUser.idToken,
  });
}
```

نجح الأمر، لكن التعامل مع المستخدمين الذين لديهم Google وApple معًا كان صعبًا: كان عليّ اختيار أحدهما معرّفًا رئيسيًا وإدراج الآخر كمعرّف إضافي. اختبرت ذلك كثيرًا في التطبيق للتأكد من أن أحدًا لن يُحرم من الدخول.

> **تنبيه: مشكلات محتملة في تصدير CSV في Supabase**
> حتى اليوم (29/03/2025)، قد يكون تصدير بيانات الجداول بصيغة CSV [غير موثوق](https://github.com/supabase/supabase/issues/27102)، لذا ضع ذلك في اعتبارك عند مقارنة البيانات بين Supabase ومصدرك الأصلي.

### توليد أنواع TypeScript

لدى Supabase حيلة رائعة: يولّد لك أنواع TypeScript. [تشغّل أمرًا واحدًا](https://supabase.com/docs/guides/api/rest/generating-types#generating-types-using-supabase-cli)، فيُخرج ملفات تخبر الكود الخاص بك بالضبط بشكل قاعدة بياناتك. وبالنسبة لتطبيقي المبني بـ React Native وExpo، كان هذا مهمًا جدًا: لم أعد أخمّن شكل البيانات التي سأحصل عليها ولا أكتب الأنواع بنفسي. قلّل ذلك الأخطاء كثيرًا لأن TypeScript كان ينبهني إذا أخطأت. في السابق كنت أقضي ساعات في إصلاح أخطاء سخيفة، والآن صار الأمر أسرع بكثير.

شغّلت الأمر بعد إعداد الجداول، وحصلت على ملف الأنواع، وأدخلته في تطبيقي. فجأة أصبحت أشياء مثل user.email أو profile.username تعمل ببساطة، ولم أعد أتساءل إن كنت كتبتها بشكل صحيح. شيء صغير، لكنه جعل البرمجة تبدو أقل شبهًا بلعبة تخمين وأكثر شبهًا بالفوز.

### ترك دوال قاعدة البيانات تقوم بالعمل

يتيح لك Supabase كتابة دوال SQL صغيرة تعمل داخل قاعدة البيانات، وهذا مفيد جدًا. بدل كتابة الكثير من الكود في التطبيق لتغيير البيانات، تركت قاعدة البيانات تتولى ذلك.

إليك دالة أنشأتها لإضافة رصيد (credits) إلى الملف الشخصي للمستخدم:

```sql
    declare
      current_credits int;
      new_credits int;
    begin
      -- Get current credits from user_profiles table
      select assistant_credits
      into current_credits
      from public.user_profiles
      where public.user_profiles.user_id = increase_assistant_credits.user_id;

      if current_credits is null then
        current_credits := 0;
      end if;

      new_credits := current_credits + credits_to_add;

      -- Update assistant_credits in user_profiles table
      update public.user_profiles
      set assistant_credits = new_credits
      where public.user_profiles.user_id = increase_assistant_credits.user_id;

      return new_credits;
    end;
```

تجلب هذه الدالة رصيد المستخدم، وتضيف إليه، وتحفظه مرة أخرى، كل ذلك دفعة واحدة. من دونها كان عليّ جلب الرصيد، وإضافته في التطبيق، وإرساله مرة أخرى، وهذا كود أكثر وفرص أكثر للخطأ. كتبت عددًا من هذه الدوال لمهام أخرى أيضًا، وجعل ذلك تطبيقي أسرع استجابة لأن قاعدة البيانات تولت العمل الثقيل.

### تنبيه بشأن الواجهة الخلفية

هنا مفاجأة: لم يُغنِني Supabase عن الواجهة الخلفية بالكامل. لاستخدام بعض ميزات تسجيل الدخول الإدارية تحتاج إلى [مفتاح service_role](https://supabase.com/docs/guides/api/api-keys#the-servicerole-key)، لكن لا يمكنك وضعه في التطبيق لأنه غير آمن. لذا أبقيت خادم NestJS صغيرًا للتعامل مع هذه المهام السرية. ليس بحجمه السابق، لكنه موجود ليبقي الأمور محمية. يتولى Supabase معظم العمل، لذا يبقى الأمر أسهل بكثير من إعدادي القديم.

### الخلاصة: كان الأمر يستحق العناء

![](https://cdn-images-1.medium.com/max/2000/0*rugop3f6Ns9U4Ayl.jpg)

لم يكن نقل 182,000 مستخدم إلى Supabase تحديًا تقنيًا فقط، بل كان تحديًا ذهنيًا أيضًا. بين التسويف والسهر والكثير من الشك في القرارات، مرت لحظات ظننت فيها حقًا أنني قد أكسر كل شيء. كان عملًا بطيئًا ومرهقًا، مليئًا بالتوتر والتردد. لكن ترك إعداد NestJS وMongoDB الهش والانتقال إلى شيء أنظف وأسهل في الصيانة كان يستحق ذلك تمامًا.

منحني Supabase البساطة والمرونة ودعم المجتمع الذي كنت أحتاج إليه كمطور يعمل وحده ويوازن ذلك مع وظيفة بدوام كامل. إذا كنت تفكر في ترحيل الواجهة الخلفية لتطبيقك، فاعلم أن الأمر ممكن تمامًا. لن يكون سريعًا ولا خاليًا من الألم، لكن مع قليل من التخطيط (وعلى الأرجح بعض الليالي الطويلة) ستخرج في النهاية بإعداد تستطيع الوثوق به فعلًا.

