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

`templates` bevat één document per sjabloon in de sjablonengalerij. De bestanden van een sjabloon (de projectzip en de pdf) staan hier niet: ze worden in filestore bewaard onder `template/<_id>/v/<version>/`. De collectie hoort bij de webmodule `template-gallery` (`services/web/modules/template-gallery`). Het schema is het Mongoose-model `Template` in `services/web/modules/template-gallery/app/src/models/Template.mjs`; de logica staat in `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` en het `TemplateGalleryHelper.mjs` ernaast.

#### Velden

| Veld | Type | Betekenis | Bron |
| - | - | - | - |
| `_id` | ObjectId | Ingesteld door Mongoose. Het is ook de map van de sjabloonbestanden in filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | De titel. Verplicht, maximaal 150 tekens. Publiceren zoekt een sjabloon op naam, en bewerken weigert een naam die een ander sjabloon heeft, zodat namen zonder index uniek blijven. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | De categorielink, `/templates/<key>`, waarbij `<key>` een van `OVERLEAF_TEMPLATE_CATEGORIES` of `all` is. Verplicht. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | De beschrijving zoals ingevoerd, in Markdown. Maximaal 4096 tekens. Doorzocht door de galerij. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML gerenderd uit `descriptionMD` en opgeschoond. Wordt ingesteld wanneer `descriptionMD` wordt ingesteld. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | De auteur zoals ingevoerd, in Markdown. Maximaal 512 tekens. Doorzocht door de galerij. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML gerenderd uit `authorMD`, alleen links. Wordt ingesteld wanneer `authorMD` wordt ingesteld. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | De licentietekst die in het formulier is gekozen. Verplicht, maximaal 512 tekens. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Het pad van de hoofddoc van het bronproject, zonder de voorloopslash. Verplicht: een project zonder hoofddoc kan niet worden gepubliceerd. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | De compiler van het bronproject. Verplicht. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | De TeX Live-image van het bronproject. De sjabloonpagina toont alleen het laatste deel ervan. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | De spellingcontroletaal van het bronproject. Kan worden gewijzigd in het bewerkingsformulier. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Begint bij 1 en gaat met één omhoog telkens wanneer het sjabloon opnieuw onder dezelfde naam wordt gepubliceerd. De bestanden van elke versie staan onder `v/<version>/`. Verplicht. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | De gebruiker die het sjabloon als eerste heeft gepubliceerd. Opnieuw publiceren eroverheen behoudt de eigenaar. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Het project waaruit het het laatst is gepubliceerd. Bij elke publicatie bijgewerkt. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Wanneer het het laatst is gepubliceerd of bewerkt. Verplicht, standaard nu. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | De versiesleutel van Mongoose. Het schema schakelt die niet uit. | Mongoose-standaard |

#### Wie schrijft

| Code | Wat het doet |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Kopieert de instellingen van het project (`TemplateGalleryHelper.mjs:94-134`), uploadt de zip en de pdf naar filestore en slaat op. Als de naam bezet is, antwoordt het met een conflict, tenzij de client om overschrijven vroeg: dan werkt het dat sjabloon bij, verhoogt het de `version` en verwijdert het daarna de bestanden van de vorige versie. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Wijst de verzonden velden toe aan het document, rendert `description` en `author` opnieuw en stelt `lastUpdated` in. Het bewerkingsformulier verstuurt de gewijzigde velden uit `name`, `license`, `category`, `language`, `authorMD` en `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` verwijdert het document en de bestanden van de opgegeven versie (`TemplateGalleryManager.mjs:49-51`). |

Alleen sitebeheerders en de gebruiker in `OVERLEAF_TEMPLATES_USER_ID` mogen deze drie routes aanroepen (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Wie leest

| Code | Wat het doet |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Zoekt één sjabloon op `_id` of `name` voor de sjabloonpagina en voor `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Als `project_id` verwijst naar een project dat niet meer bestaat, laat het antwoord het weg; het document wordt niet gewijzigd. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: één pagina van een categorie, doorzocht in `name`, `authorMD` en `descriptionMD`, gesorteerd op `lastUpdated` of op `name` (hoofdletterongevoelig). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Leest `owner` om de eigenaar in de conflictmelding te noemen. |

#### Indexen

| Naam | Sleutels | Opties | Migratie |
| - | - | - | - |
| `_id_` | `_id: 1` | | standaard |

Mongoose `autoIndex` staat uit (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (unieke `project_id`, `user_id`, `name`) heeft de tags `server-pro` en `saas`, dus het draait niet in CE, dat alleen de `server-ce`-migraties uitvoert (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Opmerkingen

* Upstream behandelt `templates` als een verouderde collectie en verwijdert die op de eigen site (`tools/migrations/20241002180623_drop_unused_collections.mjs`, met de tag `saas`). In Ayakaleaf Pro gebruikt de sjablonengalerijmodule haar.
* Sorteren op naam gebruikt een hoofdletterongevoelige collatie, en het commentaar bij `TemplateGalleryManager.mjs:186-188` merkt op dat een `name`-index dezelfde nodig zou hebben. CE heeft geen `name`-index, dus Mongo sorteert in het geheugen.
* Het verwijderen van het bronproject of de eigenaar verwijdert het sjabloon niet.


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