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

`templates` enthält ein Dokument pro Vorlage in der Vorlagengalerie. Die Dateien einer Vorlage (die Projekt-ZIP-Datei und das PDF) stehen nicht hier: Sie liegen in filestore unter `template/<_id>/v/<version>/`. Die Collection gehört zum Web-Modul `template-gallery` (`services/web/modules/template-gallery`). Das Schema ist das Mongoose-Modell `Template` in `services/web/modules/template-gallery/app/src/models/Template.mjs`; die Logik steht in `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` und dem danebenliegenden `TemplateGalleryHelper.mjs`.

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Von Mongoose gesetzt. Es ist auch der Ordner der Vorlagendateien in filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Der Titel. Pflichtfeld, höchstens 150 Zeichen. Beim Veröffentlichen wird eine Vorlage über den Namen gesucht, und beim Bearbeiten wird ein Name abgelehnt, den eine andere Vorlage hat, sodass Namen ohne Index eindeutig bleiben. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Der Kategorielink `/templates/<key>`, wobei `<key>` einer der Werte aus `OVERLEAF_TEMPLATE_CATEGORIES` oder `all` ist. Pflichtfeld. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Die Beschreibung wie eingegeben, in Markdown. Höchstens 4096 Zeichen. Wird von der Galerie durchsucht. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | Aus `descriptionMD` gerendertes und bereinigtes HTML. Wird immer gesetzt, wenn `descriptionMD` gesetzt wird. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Der Autor wie eingegeben, in Markdown. Höchstens 512 Zeichen. Wird von der Galerie durchsucht. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | Aus `authorMD` gerendertes HTML, nur Links. Wird immer gesetzt, wenn `authorMD` gesetzt wird. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Der im Formular gewählte Lizenztext. Pflichtfeld, höchstens 512 Zeichen. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Der Pfad des Root-Docs des Quellprojekts, ohne führenden Schrägstrich. Pflichtfeld: Ein Projekt ohne Root-Doc kann nicht veröffentlicht werden. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Der Compiler des Quellprojekts. Pflichtfeld. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Das TeX-Live-Image des Quellprojekts. Die Vorlagenseite zeigt nur dessen letzten Teil. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Die Rechtschreibprüfungssprache des Quellprojekts. Kann im Bearbeitungsformular geändert werden. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Beginnt bei 1 und steigt um eins, jedes Mal wenn die Vorlage unter demselben Namen erneut veröffentlicht wird. Die Dateien jeder Version liegen unter `v/<version>/`. Pflichtfeld. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Der Benutzer, der die Vorlage zuerst veröffentlicht hat. Erneutes Veröffentlichen darüber behält den Eigentümer. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Das Projekt, aus dem sie zuletzt veröffentlicht wurde. Wird bei jeder Veröffentlichung aktualisiert. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Wann sie zuletzt veröffentlicht oder bearbeitet wurde. Pflichtfeld, Standard ist jetzt. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Der Versionsschlüssel von Mongoose. Das Schema schaltet ihn nicht ab. | Mongoose-Standard |

#### Wer schreibt

| Code | Funktion |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Kopiert die Einstellungen des Projekts (`TemplateGalleryHelper.mjs:94-134`), lädt die ZIP-Datei und das PDF in filestore hoch und speichert. Ist der Name vergeben, antwortet es mit einem Konflikt, es sei denn, der Client hat das Überschreiben verlangt: Dann aktualisiert es diese Vorlage, erhöht ihre `version` und löscht anschließend die Dateien der vorherigen Version. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Weist die gesendeten Felder dem Dokument zu, rendert `description` und `author` neu und setzt `lastUpdated`. Das Bearbeitungsformular sendet die geänderten Felder unter `name`, `license`, `category`, `language`, `authorMD` und `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` löscht das Dokument und die Dateien der angegebenen Version (`TemplateGalleryManager.mjs:49-51`). |

Nur Site-Admins und der Benutzer in `OVERLEAF_TEMPLATES_USER_ID` dürfen diese drei Routen aufrufen (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Wer liest

| Code | Funktion |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Findet eine Vorlage über `_id` oder `name` für die Vorlagenseite und für `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Zeigt `project_id` auf ein Projekt, das nicht mehr existiert, lässt die Antwort es weg; das Dokument wird nicht geändert. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: eine Seite einer Kategorie, durchsucht in `name`, `authorMD` und `descriptionMD`, sortiert nach `lastUpdated` oder nach `name` (ohne Beachtung der Groß- und Kleinschreibung). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Liest `owner`, um den Eigentümer in der Konfliktmeldung zu nennen. |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | Standard |

Mongoose `autoIndex` ist ausgeschaltet (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (eindeutig `project_id`, `user_id`, `name`) ist mit `server-pro` und `saas` markiert und läuft daher nicht in CE, das nur die `server-ce`-Migrationen ausführt (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Hinweise

* Upstream behandelt `templates` als veraltete Collection und löscht sie auf der eigenen Website (`tools/migrations/20241002180623_drop_unused_collections.mjs`, markiert mit `saas`). In Ayakaleaf Pro verwendet das Vorlagengalerie-Modul sie.
* Das Sortieren nach Namen verwendet eine Collation ohne Beachtung der Groß- und Kleinschreibung, und der Kommentar bei `TemplateGalleryManager.mjs:186-188` merkt an, dass ein `name`-Index dieselbe bräuchte. CE hat keinen `name`-Index, daher sortiert Mongo im Speicher.
* Das Löschen des Quellprojekts oder des Eigentümers löscht die Vorlage nicht.


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