Collection Projects

Project représente un projet LaTeX unique dans Overleaf. Il stocke les métadonnées du projet, la propriété et le contrôle d’accès, l’arborescence des fichiers, les paramètres de compilation et l’état de la collaboration.

​

Identification et métadonnées principales

• _id : ObjectId MongoDB unique identifiant le projet.
• name : nom d’affichage du projet.
• description : description textuelle facultative du projet.
• active : indique si le projet est actuellement actif.
• version : version interne du schéma ou du format du projet.
• trashed : liste des éléments placés dans la corbeille (suppression logique).
• deletedDocs : enregistrements des documents définitivement supprimés.

​

Propriété et contrôle d’accès

• owner_ref : référence à l’utilisateur propriétaire du projet.
• collaberator_refs : utilisateurs disposant de droits de modification.
• reviewer_refs : utilisateurs disposant d’un accès de niveau relecteur.
• readOnly_refs : utilisateurs disposant d’un accès en lecture seule.
• pendingEditor_refs / pendingReviewer_refs : invitations en attente.

​

Accès par jeton

• tokens : registre des jetons pour les liens partagés.
• tokenAccessReadOnly_refs : jetons accordant un accès en lecture seule.
• tokenAccessReadAndWrite_refs : jetons accordant un accès en lecture-écriture.

​

Suivi de l’activité

• lastUpdated : horodatage de la modification la plus récente.
• lastUpdatedBy : utilisateur ayant effectué la dernière mise à jour.
• lastOpened : horodatage de la dernière ouverture du projet.
• deletedByExternalDataSource : indique si la suppression a été déclenchée par une intégration externe.

​

Structure du projet

Document et dossier racines

• rootDoc_id : ObjectId du document LaTeX principal (généralement main.tex).
• rootFolder : représentation intégrée de l’arborescence des fichiers du projet.

Chaque entrée de dossier contient :

• name / _id : nom et identifiant du dossier.
• docs : liste des documents sources LaTeX avec leur nom et leur _id.
• fileRefs : références aux fichiers binaires (images, fichiers de données), notamment :
  • name : nom du fichier
  • created : horodatage du téléversement
  • rev : compteur de révisions
  • hash : empreinte du contenu pour la déduplication
  • linkedFileData : lien vers un stockage externe (le cas échéant)
• folders : sous-dossiers imbriqués.

​

Paramètres de compilation et de l’éditeur

• compiler : moteur LaTeX sélectionné (pdflatex, xelatex, lualatex, etc.).
• spellCheckLanguage : langue du correcteur orthographique pour ce projet.

​

Paramètres publics et de partage

• publicAccesLevel : visibilité du projet (private, readOnly, public, etc.).
• collabratecUsers : utilisateurs liés provenant de plateformes de collaboration externes.

​

Extensions spécifiques à Overleaf

• overleaf.history :
  • id : identifiant utilisé par le service d’historique.
  • display : indique si l’historique est activé et visible.

​

Gestion interne des versions

• __v : clé de version interne de Mongoose pour le contrôle de la concurrence.

Voici un exemple réel de projet Overleaf.

Exemple de projet

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