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

# Collezione Templates

`templates` contiene un documento per ogni modello della galleria dei modelli. I file di un modello (lo zip del progetto e il PDF) non sono qui: sono conservati in filestore sotto `template/<_id>/v/<version>/`. La collezione appartiene al modulo web `template-gallery` (`services/web/modules/template-gallery`). Lo schema è il modello Mongoose `Template` in `services/web/modules/template-gallery/app/src/models/Template.mjs`; la logica è in `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` e nel vicino `TemplateGalleryHelper.mjs`.

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Impostato da Mongoose. È anche la cartella dei file del modello in filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Il titolo. Obbligatorio, al massimo 150 caratteri. La pubblicazione cerca un modello per nome e la modifica rifiuta un nome già usato da un altro modello, quindi i nomi restano univoci senza un indice. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Il link della categoria, `/templates/<key>`, dove `<key>` è uno dei valori di `OVERLEAF_TEMPLATE_CATEGORIES` oppure `all`. Obbligatorio. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | La descrizione così come è stata digitata, in Markdown. Al massimo 4096 caratteri. Usata dalla ricerca della galleria. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML generato da `descriptionMD` e ripulito. Impostato ogni volta che viene impostato `descriptionMD`. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | L’autore così come è stato digitato, in Markdown. Al massimo 512 caratteri. Usato dalla ricerca della galleria. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML generato da `authorMD`, solo link. Impostato ogni volta che viene impostato `authorMD`. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Il testo della licenza scelto nel modulo. Obbligatorio, al massimo 512 caratteri. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Il percorso del doc radice del progetto di origine, senza la barra iniziale. Obbligatorio: un progetto senza doc radice non può essere pubblicato. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Il compilatore del progetto di origine. Obbligatorio. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | L’immagine TeX Live del progetto di origine. La pagina del modello ne mostra solo l’ultima parte. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | La lingua del controllo ortografico del progetto di origine. Modificabile nel modulo di modifica. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Parte da 1 e aumenta di uno ogni volta che il modello viene ripubblicato con lo stesso nome. I file di ogni versione si trovano sotto `v/<version>/`. Obbligatorio. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | L’utente che ha pubblicato per primo il modello. Ripubblicarlo sopra mantiene il proprietario. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Il progetto da cui è stato pubblicato l’ultima volta. Aggiornato a ogni pubblicazione. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Quando è stato pubblicato o modificato l’ultima volta. Obbligatorio, predefinito adesso. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | La chiave di versione di Mongoose. Lo schema non la disattiva. | Predefinito di Mongoose |

#### Chi scrive

| Codice | Cosa fa |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Copia le impostazioni del progetto (`TemplateGalleryHelper.mjs:94-134`), carica lo zip e il PDF in filestore e salva. Se il nome è già usato risponde con un conflitto, a meno che il client non abbia chiesto di sovrascrivere: in quel caso aggiorna quel modello e ne aumenta la `version`, poi elimina i file della versione precedente. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Assegna i campi inviati al documento, rigenera `description` e `author` e imposta `lastUpdated`. Il modulo di modifica invia i campi modificati tra `name`, `license`, `category`, `language`, `authorMD` e `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 il documento e i file della versione indicata (`TemplateGalleryManager.mjs:49-51`). |

Solo gli amministratori del sito e l’utente in `OVERLEAF_TEMPLATES_USER_ID` possono chiamare queste tre route (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Chi legge

| Codice | Cosa fa |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Trova un modello per `_id` o `name` per la pagina del modello e per `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Se `project_id` punta a un progetto che non esiste più, la risposta lo omette; il documento non viene modificato. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: una pagina di una categoria, con ricerca in `name`, `authorMD` e `descriptionMD`, ordinata per `lastUpdated` o per `name` (senza distinzione tra maiuscole e minuscole). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Legge `owner` per indicare il proprietario nel messaggio di conflitto. |

#### Indici

| Nome | Chiavi | Opzioni | Migrazione |
| - | - | - | - |
| `_id_` | `_id: 1` | | predefinito |

`autoIndex` di Mongoose è disattivato (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (`project_id`, `user_id`, `name` univoci) è contrassegnata con `server-pro` e `saas`, quindi non viene eseguita in CE, che esegue solo le migrazioni `server-ce` (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Note

* Il progetto upstream considera `templates` una collezione obsoleta e la elimina sul proprio sito (`tools/migrations/20241002180623_drop_unused_collections.mjs`, contrassegnata con `saas`). In Ayakaleaf Pro il modulo della galleria dei modelli la usa.
* L’ordinamento per nome usa una collation senza distinzione tra maiuscole e minuscole, e il commento in `TemplateGalleryManager.mjs:186-188` osserva che un indice su `name` avrebbe bisogno della stessa. CE non ha un indice su `name`, quindi Mongo ordina in memoria.
* L’eliminazione del progetto di origine o del proprietario non elimina il modello.


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