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

# Colección Templates

`templates` contiene un documento por plantilla de la galería de plantillas. Los archivos de una plantilla (el zip del proyecto y el PDF) no están aquí: se guardan en filestore bajo `template/<_id>/v/<version>/`. La colección pertenece al módulo web `template-gallery` (`services/web/modules/template-gallery`). El esquema es el modelo de Mongoose `Template` en `services/web/modules/template-gallery/app/src/models/Template.mjs`; la lógica está en `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` y en `TemplateGalleryHelper.mjs`, junto a él.

#### Campos

| Campo | Tipo | Significado | Origen |
| - | - | - | - |
| `_id` | ObjectId | Lo establece Mongoose. También es la carpeta de los archivos de la plantilla en filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | El título. Obligatorio, 150 caracteres como máximo. La publicación busca una plantilla por nombre y la edición rechaza un nombre que tenga otra plantilla, así que los nombres siguen siendo únicos sin índice. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | El enlace de la categoría, `/templates/<key>`, donde `<key>` es uno de `OVERLEAF_TEMPLATE_CATEGORIES` o `all`. Obligatorio. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | La descripción tal como se escribió, en Markdown. 4096 caracteres como máximo. La galería busca en ella. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML generado a partir de `descriptionMD` y saneado. Se establece siempre que se establece `descriptionMD`. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | El autor tal como se escribió, en Markdown. 512 caracteres como máximo. La galería busca en él. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML generado a partir de `authorMD`, solo enlaces. Se establece siempre que se establece `authorMD`. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | El texto de licencia elegido en el formulario. Obligatorio, 512 caracteres como máximo. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | La ruta del doc raíz del proyecto de origen, sin la barra inicial. Obligatorio: un proyecto sin doc raíz no se puede publicar. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | El compilador del proyecto de origen. Obligatorio. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | La imagen de TeX Live del proyecto de origen. La página de la plantilla solo muestra su última parte. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | El idioma del corrector ortográfico del proyecto de origen. Se puede cambiar en el formulario de edición. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Empieza en 1 y aumenta en uno cada vez que la plantilla se vuelve a publicar con el mismo nombre. Los archivos de cada versión están bajo `v/<version>/`. Obligatorio. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | El usuario que publicó la plantilla por primera vez. Volver a publicar encima conserva el propietario. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | El proyecto desde el que se publicó por última vez. Se actualiza en cada publicación. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Cuándo se publicó o editó por última vez. Obligatorio; por defecto, ahora. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | La clave de versión de Mongoose. El esquema no la desactiva. | Valor predeterminado de Mongoose |

#### Quién escribe

| Código | Qué hace |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Copia la configuración del proyecto (`TemplateGalleryHelper.mjs:94-134`), sube el zip y el PDF a filestore y guarda. Si el nombre está en uso, responde con un conflicto, salvo que el cliente haya pedido sobrescribir: entonces actualiza esa plantilla y aumenta su `version`, y luego elimina los archivos de la versión anterior. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Asigna los campos enviados al documento, vuelve a generar `description` y `author` y establece `lastUpdated`. El formulario de edición envía los campos modificados entre `name`, `license`, `category`, `language`, `authorMD` y `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` elimina el documento y los archivos de la versión indicada (`TemplateGalleryManager.mjs:49-51`). |

Solo los administradores del sitio y el usuario de `OVERLEAF_TEMPLATES_USER_ID` pueden llamar a estas tres rutas (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Quién lee

| Código | Qué hace |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Encuentra una plantilla por `_id` o `name` para la página de la plantilla y para `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Si `project_id` apunta a un proyecto que ya no existe, la respuesta lo omite; el documento no se modifica. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: una página de una categoría, con búsqueda en `name`, `authorMD` y `descriptionMD`, ordenada por `lastUpdated` o por `name` (sin distinguir mayúsculas y minúsculas). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Lee `owner` para nombrar al propietario en el mensaje de conflicto. |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `_id_` | `_id: 1` | | predeterminado |

`autoIndex` de Mongoose está desactivado (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (`project_id`, `user_id`, `name` únicos) está etiquetada `server-pro` y `saas`, así que no se ejecuta en CE, que solo ejecuta las migraciones `server-ce` (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Notas

* El proyecto original trata `templates` como una colección obsoleta y la elimina en su propio sitio (`tools/migrations/20241002180623_drop_unused_collections.mjs`, etiquetada `saas`). En Ayakaleaf Pro, el módulo de la galería de plantillas la usa.
* Ordenar por nombre usa una intercalación que no distingue mayúsculas y minúsculas, y el comentario de `TemplateGalleryManager.mjs:186-188` señala que un índice de `name` necesitaría la misma. CE no tiene índice de `name`, así que Mongo ordena en memoria.
* Eliminar el proyecto de origen o el propietario no elimina la plantilla.


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