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

`templates` menyimpan satu dokumen per templat di galeri templat. File sebuah templat (zip proyek dan PDF) tidak ada di sini: file tersebut disimpan di filestore di bawah `template/<_id>/v/<version>/`. Koleksi ini milik modul web `template-gallery` (`services/web/modules/template-gallery`). Skemanya adalah model Mongoose `Template` di `services/web/modules/template-gallery/app/src/models/Template.mjs`; logikanya ada di `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` dan `TemplateGalleryHelper.mjs` di sebelahnya.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Diatur oleh Mongoose. Ini juga folder file templat di filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Judul. Wajib, paling banyak 150 karakter. Penerbitan mencari templat berdasarkan nama, dan penyuntingan menolak nama yang dimiliki templat lain, sehingga nama tetap unik tanpa indeks. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Tautan kategori, `/templates/<key>`, dengan `<key>` salah satu dari `OVERLEAF_TEMPLATE_CATEGORIES` atau `all`. Wajib. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Deskripsi sebagaimana diketik, dalam Markdown. Paling banyak 4096 karakter. Dicari oleh galeri. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML yang dirender dari `descriptionMD` dan dibersihkan. Diatur setiap kali `descriptionMD` diatur. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Penulis sebagaimana diketik, dalam Markdown. Paling banyak 512 karakter. Dicari oleh galeri. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML yang dirender dari `authorMD`, hanya tautan. Diatur setiap kali `authorMD` diatur. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Teks lisensi yang dipilih di formulir. Wajib, paling banyak 512 karakter. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Path doc utama proyek sumber, tanpa garis miring di depan. Wajib: proyek tanpa doc utama tidak dapat diterbitkan. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Kompiler proyek sumber. Wajib. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Image TeX Live proyek sumber. Halaman templat hanya menampilkan bagian terakhirnya. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Bahasa pemeriksa ejaan proyek sumber. Dapat diubah di formulir penyuntingan. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Dimulai dari 1 dan bertambah satu setiap kali templat diterbitkan ulang dengan nama yang sama. File setiap versi ada di bawah `v/<version>/`. Wajib. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Pengguna yang pertama kali menerbitkan templat. Menerbitkan ulang di atasnya mempertahankan pemilik. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Proyek tempat templat terakhir kali diterbitkan. Diperbarui pada setiap penerbitan. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Kapan terakhir diterbitkan atau disunting. Wajib, bawaan sekarang. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Kunci versi Mongoose. Skema tidak menonaktifkannya. | Bawaan Mongoose |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Menyalin pengaturan proyek (`TemplateGalleryHelper.mjs:94-134`), mengunggah zip dan PDF ke filestore, lalu menyimpan. Jika nama sudah dipakai, ia menjawab dengan konflik, kecuali klien meminta untuk menimpa: dalam hal itu ia memperbarui templat tersebut dan menaikkan `version`-nya, lalu menghapus file versi sebelumnya. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Menetapkan field yang dikirim ke dokumen, merender ulang `description` dan `author`, dan mengatur `lastUpdated`. Formulir penyuntingan mengirim field yang berubah di antara `name`, `license`, `category`, `language`, `authorMD`, dan `descriptionMD` (`services/web/modules/template-gallery/frontend/js/pages/template/util/api.ts:22-29`). |
| `TemplateGalleryHelper.mjs:186-222` (`deleteTemplateAssets`) | `DELETE /template/:template_id/delete` menghapus dokumen dan file versi yang ditentukan (`TemplateGalleryManager.mjs:49-51`). |

Hanya admin situs dan pengguna di `OVERLEAF_TEMPLATES_USER_ID` yang boleh memanggil ketiga rute ini (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Menemukan satu templat berdasarkan `_id` atau `name` untuk halaman templat dan untuk `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Jika `project_id` menunjuk ke proyek yang sudah tidak ada, jawaban menghilangkannya; dokumen tidak diubah. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: satu halaman dari sebuah kategori, dicari di `name`, `authorMD`, dan `descriptionMD`, diurutkan berdasarkan `lastUpdated` atau `name` (tanpa membedakan huruf besar kecil). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Membaca `owner` untuk menyebutkan pemilik dalam pesan konflik. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `_id_` | `_id: 1` | | bawaan |

`autoIndex` Mongoose dinonaktifkan (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (`project_id`, `user_id`, `name` unik) diberi tag `server-pro` dan `saas`, sehingga tidak berjalan di CE, yang hanya menjalankan migrasi `server-ce` (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Catatan

* Upstream memperlakukan `templates` sebagai koleksi usang dan menghapusnya di situsnya sendiri (`tools/migrations/20241002180623_drop_unused_collections.mjs`, bertag `saas`). Di Ayakaleaf Pro, modul galeri templat menggunakannya.
* Pengurutan berdasarkan nama menggunakan collation yang tidak membedakan huruf besar kecil, dan komentar di `TemplateGalleryManager.mjs:186-188` mencatat bahwa indeks `name` akan membutuhkan collation yang sama. CE tidak memiliki indeks `name`, sehingga Mongo mengurutkan di memori.
* Menghapus proyek sumber atau pemilik tidak menghapus templat.


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