Kolekce Projects

Project představuje jeden LaTeXový projekt v Overleafu. Ukládá metadata projektu, vlastnictví a řízení přístupu, strukturu souborů, nastavení kompilace a stav spolupráce.

​

Základní identifikace a metadata

• _id: Jedinečný MongoDB ObjectId identifikující projekt.
• name: Zobrazovaný název projektu.
• description: Volitelný textový popis projektu.
• active: Určuje, zda je projekt aktuálně aktivní.
• version: Interní verze schématu nebo formátu projektu.
• trashed: Seznam položek přesunutých do koše (měkké smazání).
• deletedDocs: Záznamy o trvale smazaných dokumentech.

​

Vlastnictví a řízení přístupu

• owner_ref: Odkaz na uživatele, který projekt vlastní.
• collaberator_refs: Uživatelé s oprávněním k úpravám.
• reviewer_refs: Uživatelé s přístupem na úrovni recenzenta.
• readOnly_refs: Uživatelé s přístupem pouze pro čtení.
• pendingEditor_refs / pendingReviewer_refs: Čekající pozvánky.

​

Přístup na základě tokenů

• tokens: Registr tokenů pro sdílené odkazy.
• tokenAccessReadOnly_refs: Tokeny udělující přístup pouze pro čtení.
• tokenAccessReadAndWrite_refs: Tokeny udělující přístup pro čtení i zápis.

​

Sledování aktivity

• lastUpdated: Časové razítko poslední změny.
• lastUpdatedBy: Uživatel, který provedl poslední aktualizaci.
• lastOpened: Časové razítko posledního otevření projektu.
• deletedByExternalDataSource: Zda bylo smazání vyvoláno externí integrací.

​

Struktura projektu

Kořenový dokument a složka

• rootDoc_id: ObjectId hlavního vstupního dokumentu LaTeXu (obvykle main.tex).
• rootFolder: Vložená reprezentace stromu souborů projektu.

Každý záznam složky obsahuje:

• name / _id: Název a identifikátor složky.
• docs: Seznam zdrojových dokumentů LaTeXu s názvem a _id.
• fileRefs: Odkazy na binární soubory (obrázky, datové soubory), včetně:
  • name: Název souboru
  • created: Časové razítko nahrání
  • rev: Počítadlo revizí
  • hash: Hash obsahu pro deduplikaci
  • linkedFileData: Propojení s externím úložištěm (pokud existuje)
• folders: Vnořené podsložky.

​

Nastavení kompilace a editoru

• compiler: Zvolený LaTeXový engine (pdflatex, xelatex, lualatex atd.).
• spellCheckLanguage: Jazyk kontroly pravopisu pro tento projekt.

​

Nastavení veřejného přístupu a sdílení

• publicAccesLevel: Viditelnost projektu (private, readOnly, public atd.).
• collabratecUsers: Propojení uživatelé z externích platforem pro spolupráci.

​

Rozšíření specifická pro Overleaf

• overleaf.history:
  • id: Identifikátor používaný službou historie.
  • display: Zda je historie povolena a viditelná.

​

Interní verzování

• __v: Interní klíč verze Mongoose pro řízení souběžnosti.

Zde je skutečný příklad pro uživatele Overleafu.

Příklad projektu

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