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

`templates` sisältää yhden dokumentin jokaista mallipohjagallerian mallipohjaa kohden. Mallipohjan tiedostot (projektin zip ja PDF) eivät ole täällä: ne säilytetään filestoressa polussa `template/<_id>/v/<version>/`. Kokoelma kuuluu web-moduuliin `template-gallery` (`services/web/modules/template-gallery`). Skeema on Mongoose-malli `Template` tiedostossa `services/web/modules/template-gallery/app/src/models/Template.mjs`; logiikka on tiedostossa `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` ja sen vieressä olevassa `TemplateGalleryHelper.mjs`-tiedostossa.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Mongoosen asettama. Se on myös mallipohjan tiedostojen kansio filestoressa. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Otsikko. Pakollinen, enintään 150 merkkiä. Julkaisu hakee mallipohjan nimen perusteella, ja muokkaus hylkää nimen, joka on jo toisella mallipohjalla, joten nimet pysyvät yksilöllisinä ilman indeksiä. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Kategorialinkki `/templates/<key>`, jossa `<key>` on jokin arvoista `OVERLEAF_TEMPLATE_CATEGORIES` tai `all`. Pakollinen. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Kuvaus sellaisena kuin se kirjoitettiin, Markdownina. Enintään 4096 merkkiä. Galleria hakee siitä. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | Kentästä `descriptionMD` renderöity ja puhdistettu HTML. Asetetaan aina, kun `descriptionMD` asetetaan. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Tekijä sellaisena kuin se kirjoitettiin, Markdownina. Enintään 512 merkkiä. Galleria hakee siitä. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | Kentästä `authorMD` renderöity HTML, vain linkit. Asetetaan aina, kun `authorMD` asetetaan. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Lomakkeessa valittu lisenssiteksti. Pakollinen, enintään 512 merkkiä. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Lähdeprojektin juuri-docin polku ilman alussa olevaa vinoviivaa. Pakollinen: projektia ilman juuri-docia ei voi julkaista. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Lähdeprojektin kääntäjä. Pakollinen. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Lähdeprojektin TeX Live -kuva. Mallipohjasivu näyttää siitä vain viimeisen osan. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Lähdeprojektin oikeinkirjoituksen tarkistuskieli. Voidaan muuttaa muokkauslomakkeessa. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Alkaa arvosta 1 ja kasvaa yhdellä aina, kun mallipohja julkaistaan uudelleen samalla nimellä. Kunkin version tiedostot ovat polussa `v/<version>/`. Pakollinen. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Käyttäjä, joka julkaisi mallipohjan ensimmäisenä. Uudelleenjulkaisu sen päälle säilyttää omistajan. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Projekti, josta se viimeksi julkaistiin. Päivitetään jokaisessa julkaisussa. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Milloin se viimeksi julkaistiin tai muokattiin. Pakollinen, oletuksena nyt. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Mongoosen versioavain. Skeema ei poista sitä käytöstä. | Mongoosen oletus |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Kopioi projektin asetukset (`TemplateGalleryHelper.mjs:94-134`), lataa zipin ja PDF:n filestoreen ja tallentaa. Jos nimi on varattu, se vastaa ristiriidalla, ellei asiakas pyytänyt korvaamista: silloin se päivittää kyseisen mallipohjan ja kasvattaa sen `version`-arvoa ja poistaa sitten edellisen version tiedostot. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Asettaa lähetetyt kentät dokumenttiin, renderöi kentät `description` ja `author` uudelleen ja asettaa kentän `lastUpdated`. Muokkauslomake lähettää muuttuneet kentät joukosta `name`, `license`, `category`, `language`, `authorMD` ja `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` poistaa dokumentin ja annetun version tiedostot (`TemplateGalleryManager.mjs:49-51`). |

Vain sivuston ylläpitäjät ja käyttäjä kohdassa `OVERLEAF_TEMPLATES_USER_ID` voivat kutsua näitä kolmea reittiä (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Etsii yhden mallipohjan kentän `_id` tai `name` perusteella mallipohjasivulle ja reitille `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Jos `project_id` osoittaa projektiin, jota ei enää ole, vastaus jättää sen pois; dokumenttia ei muuteta. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: yksi kategorian sivu, haku kentistä `name`, `authorMD` ja `descriptionMD`, lajiteltuna kentän `lastUpdated` tai `name` mukaan (kirjainkoosta riippumatta). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Lukee kentän `owner` nimetäkseen omistajan ristiriitailmoituksessa. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `_id_` | `_id: 1` | | oletus |

Mongoosen `autoIndex` on pois päältä (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (yksilölliset `project_id`, `user_id`, `name`) on merkitty tunnisteilla `server-pro` ja `saas`, joten sitä ei ajeta CE:ssä, joka ajaa vain `server-ce`-migraatiot (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Huomautukset

* Upstream pitää kokoelmaa `templates` vanhentuneena ja poistaa sen omalta sivustoltaan (`tools/migrations/20241002180623_drop_unused_collections.mjs`, merkitty `saas`). Ayakaleaf Prossa mallipohjagalleriamoduuli käyttää sitä.
* Nimen mukaan lajittelu käyttää kirjainkoosta riippumatonta lajittelujärjestystä, ja kohdan `TemplateGalleryManager.mjs:186-188` kommentti huomauttaa, että `name`-indeksi tarvitsisi saman. CE:ssä ei ole `name`-indeksiä, joten Mongo lajittelee muistissa.
* Lähdeprojektin tai omistajan poistaminen ei poista mallipohjaa.


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