> ## 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.

# Koleksi Migrations

`migrations` mencatat migrasi basis data mana yang sudah dijalankan. Satu dokumen adalah satu migrasi dari `tools/migrations/`. Dokumen ditulis oleh adaptor alat migrasi [east](https://github.com/okv/east), `tools/migrations/lib/adapter.mjs`, bukan oleh layanan yang sedang berjalan.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id dokumen. | `adapter.mjs:103` |
| `name` | String | Nama file migrasi tanpa ekstensi, misalnya `20190912145029_create_tags_indexes`. | `adapter.mjs:104` |
| `migratedAt` | Date | Kapan migrasi selesai. | `adapter.mjs:105` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `adapter.mjs:101-107` (`markExecuted`) | Menyisipkan dokumen setelah migrasi dijalankan. |
| `adapter.mjs:109-114` (`unmarkExecuted`) | Menghapusnya lagi saat migrasi dibatalkan. |

CE menjalankan `yarn run migrations migrate -t server-ce` setiap kali kontainer dimulai (`server-ce/init_scripts/900_run_web_migrations.sh:4-12`; `-t server-pro` saat `OVERLEAF_IS_SERVER_PRO=true`). Hanya migrasi yang `tags`-nya mencakup lingkungan tersebut yang dijalankan, sehingga hanya migrasi itu yang mendapat dokumen di sini.

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `adapter.mjs:72-99` (`getExecutedMigrationNames`) | east melewati setiap migrasi yang namanya sudah ada di sini. |
| `tools/migrations/lib/helpers.mjs:67-75` (`assertDependency`) | Migrasi yang memerlukan migrasi lain dijalankan lebih dulu akan melempar galat jika nama itu tidak ada. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `name_1` | `{ name: 1 }` | unique | `tools/migrations/20190720165251_create_migrations.mjs` |

#### Catatan

* Menghapus dokumen membuat migrasi tersebut berjalan lagi saat kontainer dimulai berikutnya, jika tag-nya cocok.
* Dengan klaster Mongo tambahan (`mongo.auxUrl`), migrasi bertag `auxiliary` dicatat di koleksi `migrations` milik klaster tersebut (`adapter.mjs:8-15`, `:64-70`). `mongo.auxUrl` berasal dari `MONGO_AUX_CONNECTION_STRING` (`tools/migrations/config/settings.defaults.js:19`), yang secara default tidak diatur.


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