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.

Esempio di progetto

{
    _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
}