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

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

<Accordion title="Příklad projektu">
  ```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.