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

# Kolekcja projektów

`Project` reprezentuje pojedynczy projekt LaTeX w Overleaf. Przechowuje metadane projektu, informacje o właścicielu i kontroli dostępu, strukturę plików, ustawienia kompilacji oraz stan współpracy.

#### Podstawowa identyfikacja i metadane

* `_id`: Unikalny identyfikator MongoDB ObjectId projektu.
* `name`: Wyświetlana nazwa projektu.
* `description`: Opcjonalny tekstowy opis projektu.
* `active`: Wskazuje, czy projekt jest obecnie aktywny.
* `version`: Wewnętrzna wersja schematu lub formatu projektu.
* `trashed`: Lista elementów przeniesionych do kosza (miękkie usunięcie).
* `deletedDocs`: Rejestr trwale usuniętych dokumentów.

#### Własność i kontrola dostępu

* `owner_ref`: Odwołanie do użytkownika będącego właścicielem projektu.
* `collaberator_refs`: Użytkownicy z uprawnieniami do edycji.
* `reviewer_refs`: Użytkownicy z dostępem na poziomie recenzenta.
* `readOnly_refs`: Użytkownicy z dostępem tylko do odczytu.
* `pendingEditor_refs` / `pendingReviewer_refs`: Oczekujące zaproszenia.

#### Dostęp oparty na tokenach

* `tokens`: Rejestr tokenów dla udostępnianych linków.
* `tokenAccessReadOnly_refs`: Tokeny przyznające dostęp tylko do odczytu.
* `tokenAccessReadAndWrite_refs`: Tokeny przyznające dostęp do odczytu i zapisu.

#### Śledzenie aktywności

* `lastUpdated`: Znacznik czasu ostatniej modyfikacji.
* `lastUpdatedBy`: Użytkownik, który dokonał ostatniej aktualizacji.
* `lastOpened`: Znacznik czasu ostatniego otwarcia projektu.
* `deletedByExternalDataSource`: Czy usunięcie zostało wywołane przez zewnętrzną integrację.

#### Struktura projektu

Dokument główny i folder

* `rootDoc_id`: ObjectId głównego dokumentu wejściowego LaTeX (zwykle `main.tex`).
* `rootFolder`: Osadzona reprezentacja drzewa plików projektu.

Każdy wpis folderu zawiera:

* `name` / `_id`: Nazwę i identyfikator folderu.
* `docs`: Listę dokumentów źródłowych LaTeX z nazwą i `_id`.
* `fileRefs`: Odwołania do plików binarnych (obrazy, pliki danych), w tym:
  * `name`: Nazwa pliku
  * `created`: Znacznik czasu przesłania
  * `rev`: Licznik rewizji
  * `hash`: Skrót zawartości używany do deduplikacji
  * `linkedFileData`: Powiązanie z zewnętrznym magazynem (jeśli istnieje)
* `folders`: Zagnieżdżone podfoldery.

#### Ustawienia kompilacji i edytora

* `compiler`: Wybrany silnik LaTeX (`pdflatex`, `xelatex`, `lualatex` itd.).
* `spellCheckLanguage`: Język sprawdzania pisowni dla tego projektu.

#### Ustawienia publiczne i udostępniania

* `publicAccesLevel`: Widoczność projektu (`private`, `readOnly`, `public` itd.).
* `collabratecUsers`: Powiązani użytkownicy z zewnętrznych platform współpracy.

#### Rozszerzenia specyficzne dla Overleaf

* `overleaf.history`:
  * `id`: Identyfikator używany przez usługę historii.
  * `display`: Czy historia jest włączona i widoczna.

#### Wewnętrzne wersjonowanie

* `__v`: Wewnętrzny klucz wersji Mongoose służący do kontroli współbieżności.

Oto rzeczywisty przykład dla użytkownika Overleaf.

<Accordion title="Przykład 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.