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

# Collection Templates

`templates` contient un document par modèle de la galerie de modèles. Les fichiers d’un modèle (le zip du projet et le PDF) ne sont pas ici : ils sont conservés dans filestore sous `template/<_id>/v/<version>/`. La collection appartient au module web `template-gallery` (`services/web/modules/template-gallery`). Le schéma est le modèle Mongoose `Template` dans `services/web/modules/template-gallery/app/src/models/Template.mjs` ; la logique se trouve dans `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` et dans `TemplateGalleryHelper.mjs` à côté.

#### Champs

| Champ | Type | Signification | Source |
| - | - | - | - |
| `_id` | ObjectId | Défini par Mongoose. C’est aussi le dossier des fichiers du modèle dans filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Le titre. Obligatoire, 150 caractères au plus. La publication recherche un modèle par son nom, et la modification refuse un nom déjà utilisé par un autre modèle ; les noms restent donc uniques sans index. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Le lien de catégorie, `/templates/<key>`, où `<key>` est l’une des valeurs de `OVERLEAF_TEMPLATE_CATEGORIES` ou `all`. Obligatoire. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | La description telle que saisie, en Markdown. 4096 caractères au plus. Utilisée par la recherche de la galerie. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML généré à partir de `descriptionMD` et nettoyé. Défini chaque fois que `descriptionMD` l’est. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | L’auteur tel que saisi, en Markdown. 512 caractères au plus. Utilisé par la recherche de la galerie. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML généré à partir de `authorMD`, liens uniquement. Défini chaque fois que `authorMD` l’est. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Le texte de licence choisi dans le formulaire. Obligatoire, 512 caractères au plus. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Le chemin du doc racine du projet source, sans la barre oblique initiale. Obligatoire : un projet sans doc racine ne peut pas être publié. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Le compilateur du projet source. Obligatoire. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | L’image TeX Live du projet source. La page du modèle n’en affiche que la dernière partie. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | La langue de vérification orthographique du projet source. Modifiable dans le formulaire d’édition. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Commence à 1 et augmente de un chaque fois que le modèle est republié sous le même nom. Les fichiers de chaque version se trouvent sous `v/<version>/`. Obligatoire. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | L’utilisateur qui a publié le modèle en premier. Une republication par-dessus conserve le propriétaire. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Le projet à partir duquel il a été publié en dernier. Mis à jour à chaque publication. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Date de la dernière publication ou modification. Obligatoire, maintenant par défaut. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | La clé de version de Mongoose. Le schéma ne la désactive pas. | Valeur par défaut de Mongoose |

#### Qui écrit

| Code | Rôle |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Copie les paramètres du projet (`TemplateGalleryHelper.mjs:94-134`), téléverse le zip et le PDF dans filestore, puis enregistre. Si le nom est pris, répond par un conflit, sauf si le client a demandé l’écrasement : il met alors à jour ce modèle et augmente sa `version`, puis supprime les fichiers de la version précédente. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Affecte les champs envoyés au document, régénère `description` et `author`, et définit `lastUpdated`. Le formulaire d’édition envoie les champs modifiés parmi `name`, `license`, `category`, `language`, `authorMD` et `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` supprime le document et les fichiers de la version donnée (`TemplateGalleryManager.mjs:49-51`). |

Seuls les admins du site et l’utilisateur de `OVERLEAF_TEMPLATES_USER_ID` peuvent appeler ces trois routes (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Qui lit

| Code | Rôle |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Trouve un modèle par `_id` ou `name` pour la page du modèle et pour `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Si `project_id` désigne un projet qui n’existe plus, la réponse l’omet ; le document n’est pas modifié. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates` : une page d’une catégorie, recherchée dans `name`, `authorMD` et `descriptionMD`, triée par `lastUpdated` ou par `name` (sans tenir compte de la casse). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Lit `owner` pour nommer le propriétaire dans le message de conflit. |

#### Index

| Nom | Clés | Options | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | par défaut |

`autoIndex` de Mongoose est désactivé (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (`project_id`, `user_id`, `name` uniques) est marquée `server-pro` et `saas` ; elle ne s’exécute donc pas dans CE, qui n’exécute que les migrations `server-ce` (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Remarques

* L’amont considère `templates` comme une collection obsolète et la supprime sur son propre site (`tools/migrations/20241002180623_drop_unused_collections.mjs`, marquée `saas`). Dans Ayakaleaf Pro, le module de galerie de modèles l’utilise.
* Le tri par nom utilise une collation insensible à la casse, et le commentaire de `TemplateGalleryManager.mjs:186-188` note qu’un index `name` aurait besoin de la même. CE n’a pas d’index `name`, donc Mongo trie en mémoire.
* Supprimer le projet source ou le propriétaire ne supprime pas le modèle.


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