> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# مجموعة الترحيلات (Migrations)

`migrations` تسجّل ترحيلات قاعدة البيانات التي نُفّذت. كل مستند هو ترحيل واحد من `tools/migrations/`. يكتبه محوّل أداة الترحيل [east](https://github.com/okv/east)، أي `tools/migrations/lib/adapter.mjs`، وليس خدمة قيد التشغيل.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف المستند. | `adapter.mjs:103` |
| `name` | String | اسم ملف الترحيل دون الامتداد، مثل `20190912145029_create_tags_indexes`. | `adapter.mjs:104` |
| `migratedAt` | Date | وقت انتهاء الترحيل. | `adapter.mjs:105` |

#### من يكتب فيها

| الشيفرة | ما الذي تفعله |
| - | - |
| `adapter.mjs:101-107` (`markExecuted`) | تُدرج مستندًا بعد تنفيذ ترحيل. |
| `adapter.mjs:109-114` (`unmarkExecuted`) | تحذفه مجددًا عند التراجع عن ترحيل. |

يشغّل CE الأمر `yarn run migrations migrate -t server-ce` عند كل بدء تشغيل للحاوية (`server-ce/init_scripts/900_run_web_migrations.sh:4-12`؛ و`-t server-pro` عندما `OVERLEAF_IS_SERVER_PRO=true`). لا تُنفَّذ إلا الترحيلات التي تتضمن `tags` الخاصة بها تلك البيئة، لذا لا يحصل على مستند هنا سواها.

#### من يقرأ منها

| الشيفرة | ما الذي تفعله |
| - | - |
| `adapter.mjs:72-99` (`getExecutedMigrationNames`) | يتخطى east كل ترحيل يوجد اسمه هنا بالفعل. |
| `tools/migrations/lib/helpers.mjs:67-75` (`assertDependency`) | الترحيل الذي يحتاج إلى تنفيذ ترحيل آخر قبله يرمي خطأً عندما يكون ذلك الاسم مفقودًا. |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `name_1` | `{ name: 1 }` | unique | `tools/migrations/20190720165251_create_migrations.mjs` |

#### ملاحظات

* حذف مستند يجعل ذلك الترحيل يُنفَّذ مجددًا عند بدء تشغيل الحاوية التالي، إذا تطابقت وسومه.
* مع عنقود Mongo مساعد (`mongo.auxUrl`)، تُسجَّل الترحيلات الموسومة بـ `auxiliary` بدلًا من ذلك في مجموعة `migrations` الخاصة بذلك العنقود (`adapter.mjs:8-15`، `:64-70`). تأتي `mongo.auxUrl` من `MONGO_AUX_CONNECTION_STRING` (`tools/migrations/config/settings.defaults.js:19`)، وهو غير مضبوط افتراضيًا.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.