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

`Project` rappresenta un singolo progetto LaTeX in Overleaf. Memorizza i metadati del progetto, la proprietà e il controllo degli accessi, la struttura dei file, le impostazioni di compilazione e lo stato della collaborazione.

#### Identificazione principale e metadati

* `_id`: ObjectId MongoDB univoco che identifica il progetto.
* `name`: nome visualizzato del progetto.
* `description`: descrizione testuale facoltativa del progetto.
* `active`: indica se il progetto è attualmente attivo.
* `version`: versione interna dello schema o del formato del progetto.
* `trashed`: elenco degli elementi spostati nel cestino (eliminazione logica).
* `deletedDocs`: registrazioni dei documenti eliminati definitivamente.

#### Proprietà e controllo degli accessi

* `owner_ref`: riferimento all'utente proprietario del progetto.
* `collaberator_refs`: utenti con permessi di modifica.
* `reviewer_refs`: utenti con accesso da revisore.
* `readOnly_refs`: utenti con accesso in sola lettura.
* `pendingEditor_refs` / `pendingReviewer_refs`: inviti in sospeso.

#### Accesso basato su token

* `tokens`: registro dei token per i link condivisi.
* `tokenAccessReadOnly_refs`: token che concedono l'accesso in sola lettura.
* `tokenAccessReadAndWrite_refs`: token che concedono l'accesso in lettura e scrittura.

#### Tracciamento dell'attività

* `lastUpdated`: timestamp della modifica più recente.
* `lastUpdatedBy`: utente che ha eseguito l'ultimo aggiornamento.
* `lastOpened`: timestamp dell'ultima apertura del progetto.
* `deletedByExternalDataSource`: indica se l'eliminazione è stata attivata da un'integrazione esterna.

#### Struttura del progetto

Documento radice e cartella

* `rootDoc_id`: ObjectId del documento LaTeX principale (di solito `main.tex`).
* `rootFolder`: rappresentazione incorporata dell'albero dei file del progetto.

Ogni voce di cartella contiene:

* `name` / `_id`: nome e identificatore della cartella.
* `docs`: elenco dei documenti sorgente LaTeX con nome e `_id`.
* `fileRefs`: riferimenti a file binari (immagini, file di dati), tra cui:
  * `name`: nome del file
  * `created`: timestamp del caricamento
  * `rev`: contatore delle revisioni
  * `hash`: hash del contenuto per la deduplicazione
  * `linkedFileData`: collegamento a uno storage esterno (se presente)
* `folders`: sottocartelle annidate.

#### Impostazioni di compilazione ed editor

* `compiler`: motore LaTeX selezionato (`pdflatex`, `xelatex`, `lualatex`, ecc.).
* `spellCheckLanguage`: lingua del correttore ortografico per questo progetto.

#### Impostazioni pubbliche e di condivisione

* `publicAccesLevel`: visibilità del progetto (`private`, `readOnly`, `public`, ecc.).
* `collabratecUsers`: utenti collegati da piattaforme di collaborazione esterne.

#### Estensioni specifiche di Overleaf

* `overleaf.history`:
  * `id`: identificatore utilizzato dal servizio di cronologia.
  * `display`: indica se la cronologia è abilitata e visibile.

#### Versionamento interno

* `__v`: chiave di versione interna di Mongoose per il controllo della concorrenza.

Ecco un esempio reale per un utente Overleaf.

<Accordion title="Esempio di progetto">
  ```json5 theme={null}
  {
      _id: ObjectId('69686c09bcb72ccea226ff33'),
      name: 'overleaf-example',
      lastUpdated: ISODate('2026-01-15T04:25:34.637Z'),
      lastUpdatedBy: ObjectId('696868f6bcb72ccea226fe5f'),
      lastOpened: ISODate('2026-01-15T04:25:22.286Z'),
      active: true,
      owner_ref: ObjectId('696868f6bcb72ccea226fe5f'),
      collaberator_refs: [],
      reviewer_refs: [],
      readOnly_refs: [],
      pendingEditor_refs: [],
      pendingReviewer_refs: [],
      rootDoc_id: ObjectId('69686c09bcb72ccea226ff38'),
      rootFolder: [
          {
              name: 'rootFolder',
              _id: ObjectId('69686c09bcb72ccea226ff32'),
              docs: [
                  {
                      name: 'main.tex',
                      _id: ObjectId('69686c09bcb72ccea226ff38')
                  },
                  {
                      name: 'sample.bib',
                      _id: ObjectId('69686c09bcb72ccea226ff3f')
                  }
              ],
              fileRefs: [
                  {
                      name: 'frog.jpg',
                      created: ISODate('2026-01-15T04:24:41.963Z'),
                      rev: 0,
                      linkedFileData: null,
                      hash: '5b889ef3cf71c83a4c027c4e4dc3d1a106b27809',
                      _id: ObjectId('69686c09bcb72ccea226ff45')
                  }
              ],
              folders: []
          }
      ],
      version: 3,
      publicAccesLevel: 'private',
      compiler: 'pdflatex',
      spellCheckLanguage: 'en',
      deletedByExternalDataSource: false,
      description: '',
      trashed: [],
      deletedDocs: [],
      tokens: {},
      tokenAccessReadOnly_refs: [],
      tokenAccessReadAndWrite_refs: [],
      overleaf: {
          history: {
              id: '69686c09bcb72ccea226ff33',
              display: true
          }
      },
      collabratecUsers: [],
      __v: 0
  }
  ```
</Accordion>


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