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

# مجموعة Templates

تحتوي `templates` على مستند واحد لكل قالب في معرض القوالب. ملفات القالب (ملف zip للمشروع وملف PDF) ليست هنا: تُحفظ في filestore تحت `template/<_id>/v/<version>/`. تنتمي المجموعة إلى وحدة web ‏`template-gallery` ‏(`services/web/modules/template-gallery`). المخطط هو نموذج Mongoose ‏`Template` في `services/web/modules/template-gallery/app/src/models/Template.mjs`؛ والمنطق في `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` و`TemplateGalleryHelper.mjs` المجاور له.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | يضبطه Mongoose. وهو أيضًا مجلد ملفات القالب في filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | العنوان. مطلوب، وبحد أقصى 150 حرفًا. يبحث النشر عن القالب بالاسم، ويرفض التحرير اسمًا يحمله قالب آخر، لذا تبقى الأسماء فريدة دون فهرس. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | رابط الفئة `/templates/<key>`، حيث `<key>` إحدى قيم `OVERLEAF_TEMPLATE_CATEGORIES` أو `all`. مطلوب. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | الوصف كما كُتب، بصيغة Markdown. بحد أقصى 4096 حرفًا. يبحث فيه المعرض. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | ‏HTML مُصيَّر من `descriptionMD` ومُنقّى. يُضبط كلما ضُبط `descriptionMD`. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | المؤلف كما كُتب، بصيغة Markdown. بحد أقصى 512 حرفًا. يبحث فيه المعرض. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | ‏HTML مُصيَّر من `authorMD`، يتضمن الروابط فقط. يُضبط كلما ضُبط `authorMD`. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | نص الترخيص المختار في النموذج. مطلوب، وبحد أقصى 512 حرفًا. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | مسار doc الجذر للمشروع المصدر، دون الشرطة المائلة في البداية. مطلوب: لا يمكن نشر مشروع بلا doc جذر. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | مُصرِّف المشروع المصدر. مطلوب. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | صورة TeX Live للمشروع المصدر. تعرض صفحة القالب الجزء الأخير منها فقط. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | لغة التدقيق الإملائي للمشروع المصدر. يمكن تغييرها في نموذج التحرير. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | يبدأ من 1 ويزيد بواحد في كل مرة يُعاد فيها نشر القالب بالاسم نفسه. ملفات كل إصدار تحت `v/<version>/`. مطلوب. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | المستخدم الذي نشر القالب أولًا. تُبقي إعادة النشر فوقه على المالك. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | المشروع الذي نُشر منه آخر مرة. يُحدَّث مع كل نشر. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | آخر وقت نُشر فيه أو حُرّر. مطلوب، والقيمة الافتراضية الآن. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | مفتاح الإصدار في Mongoose. لا يعطّله المخطط. | افتراضي Mongoose |

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

| الشيفرة | ما تفعله |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | ‏`POST /template/new/:Project_id`. تنسخ إعدادات المشروع (`TemplateGalleryHelper.mjs:94-134`)، وترفع ملف zip وملف PDF إلى filestore، ثم تحفظ. إذا كان الاسم مستخدمًا، تردّ بتعارض، ما لم يطلب العميل الكتابة فوقه: عندئذٍ تحدّث ذلك القالب وترفع `version` الخاص به، ثم تحذف ملفات الإصدار السابق. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | ‏`POST /template/:template_id/edit`. تُسند الحقول المرسلة إلى المستند، وتعيد تصيير `description` و`author`، وتضبط `lastUpdated`. يرسل نموذج التحرير الحقول المتغيرة من بين `name` و`license` و`category` و`language` و`authorMD` و`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` المستند وملفات الإصدار المحدد (`TemplateGalleryManager.mjs:49-51`). |

لا يُسمح باستدعاء هذه المسارات الثلاثة إلا لمسؤولي الموقع والمستخدم الموجود في `OVERLEAF_TEMPLATES_USER_ID` ‏(`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

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

| الشيفرة | ما تفعله |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | تعثر على قالب واحد عبر `_id` أو `name` لصفحة القالب ولـ `GET /api/template` ‏(`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). إذا أشار `project_id` إلى مشروع لم يعد موجودًا، يحذفه الرد؛ ولا يتغير المستند. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | ‏`GET /api/templates`: صفحة واحدة من فئة، مع البحث في `name` و`authorMD` و`descriptionMD`، مرتبة حسب `lastUpdated` أو حسب `name` (دون التمييز بين الأحرف الكبيرة والصغيرة). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | تقرأ `owner` لذكر المالك في رسالة التعارض. |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `_id_` | `_id: 1` | | افتراضي |

‏`autoIndex` في Mongoose معطّل (`services/web/app/src/infrastructure/Mongoose.mjs:7`). يحمل `tools/migrations/20190912145030_create_templates_indexes.mjs` (الحقول الفريدة `project_id` و`user_id` و`name`) الوسمين `server-pro` و`saas`، لذا لا يعمل في CE، الذي لا يشغّل إلا ترحيلات `server-ce` ‏(`server-ce/init_scripts/900_run_web_migrations.sh`).

#### ملاحظات

* يعدّ المشروع الأصلي (upstream) `templates` مجموعة قديمة ويحذفها في موقعه (`tools/migrations/20241002180623_drop_unused_collections.mjs`، بالوسم `saas`). في Ayakaleaf Pro تستخدمها وحدة معرض القوالب.
* يستخدم الترتيب حسب الاسم ترتيبًا لا يميّز بين الأحرف الكبيرة والصغيرة، ويشير التعليق في `TemplateGalleryManager.mjs:186-188` إلى أن فهرس `name` سيحتاج إلى الترتيب نفسه. لا يوجد في CE فهرس `name`، لذا يرتّب Mongo في الذاكرة.
* حذف المشروع المصدر أو المالك لا يحذف القالب.


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