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

# Kolekce Templates

`templates` obsahuje jeden dokument na každou šablonu v galerii šablon. Soubory šablony (zip projektu a PDF) tu nejsou: uchovávají se ve filestore pod `template/<_id>/v/<version>/`. Kolekce patří webovému modulu `template-gallery` (`services/web/modules/template-gallery`). Schéma je model Mongoose `Template` v `services/web/modules/template-gallery/app/src/models/Template.mjs`; logika je v `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` a v sousedním `TemplateGalleryHelper.mjs`.

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Nastavuje Mongoose. Je to také složka souborů šablony ve filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Název. Povinný, nejvýše 150 znaků. Publikování vyhledává šablonu podle názvu a úprava odmítne název, který má jiná šablona, takže názvy zůstávají jedinečné bez indexu. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Odkaz na kategorii `/templates/<key>`, kde `<key>` je jedna z hodnot `OVERLEAF_TEMPLATE_CATEGORIES` nebo `all`. Povinné. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Popis tak, jak byl zadán, v Markdownu. Nejvýše 4096 znaků. Prohledává jej galerie. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML vykreslené z `descriptionMD` a vyčištěné. Nastaví se vždy, když se nastaví `descriptionMD`. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Autor tak, jak byl zadán, v Markdownu. Nejvýše 512 znaků. Prohledává jej galerie. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML vykreslené z `authorMD`, jen odkazy. Nastaví se vždy, když se nastaví `authorMD`. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Text licence zvolený ve formuláři. Povinný, nejvýše 512 znaků. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Cesta ke kořenovému doc zdrojového projektu bez úvodního lomítka. Povinná: projekt bez kořenového doc nelze publikovat. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Překladač zdrojového projektu. Povinný. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Obraz TeX Live zdrojového projektu. Stránka šablony zobrazuje jen jeho poslední část. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Jazyk kontroly pravopisu zdrojového projektu. Lze jej změnit ve formuláři úprav. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Začíná na 1 a zvýší se o jedna pokaždé, když je šablona znovu publikována pod stejným názvem. Soubory každé verze jsou pod `v/<version>/`. Povinná. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Uživatel, který šablonu publikoval jako první. Opětovné publikování přes ni vlastníka zachová. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Projekt, ze kterého byla naposledy publikována. Aktualizuje se při každém publikování. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Kdy byla naposledy publikována nebo upravena. Povinné, výchozí je teď. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Klíč verze Mongoose. Schéma jej nevypíná. | Výchozí v Mongoose |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Zkopíruje nastavení projektu (`TemplateGalleryHelper.mjs:94-134`), nahraje zip a PDF do filestore a uloží. Pokud je název obsazený, odpoví konfliktem, ledaže klient požádal o přepsání: pak tuto šablonu aktualizuje, zvýší její `version` a poté smaže soubory předchozí verze. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Přiřadí odeslaná pole dokumentu, znovu vykreslí `description` a `author` a nastaví `lastUpdated`. Formulář úprav odesílá změněná pole z `name`, `license`, `category`, `language`, `authorMD` a `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` smaže dokument a soubory dané verze (`TemplateGalleryManager.mjs:49-51`). |

Tyto tři trasy mohou volat jen administrátoři webu a uživatel v `OVERLEAF_TEMPLATES_USER_ID` (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Najde jednu šablonu podle `_id` nebo `name` pro stránku šablony a pro `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Pokud `project_id` ukazuje na projekt, který už neexistuje, odpověď jej vynechá; dokument se nemění. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: jedna stránka kategorie, prohledávaná v `name`, `authorMD` a `descriptionMD`, řazená podle `lastUpdated` nebo podle `name` (bez rozlišení velikosti písmen). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Čte `owner`, aby uvedl vlastníka ve zprávě o konfliktu. |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `_id_` | `_id: 1` | | výchozí |

Mongoose `autoIndex` je vypnutý (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (jedinečné `project_id`, `user_id`, `name`) má značky `server-pro` a `saas`, takže neběží v CE, které spouští jen migrace `server-ce` (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Poznámky

* Upstream považuje `templates` za zastaralou kolekci a na vlastním webu ji odstraňuje (`tools/migrations/20241002180623_drop_unused_collections.mjs`, se značkou `saas`). V Ayakaleaf Pro ji používá modul galerie šablon.
* Řazení podle názvu používá porovnávání bez rozlišení velikosti písmen a komentář u `TemplateGalleryManager.mjs:186-188` poznamenává, že index `name` by potřeboval totéž. CE index `name` nemá, takže Mongo řadí v paměti.
* Smazání zdrojového projektu nebo vlastníka šablonu nesmaže.


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