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

# Колекція Projects

`Project` представляє окремий LaTeX-проєкт в Overleaf. Він зберігає метадані проєкту, інформацію про власника та керування доступом, файлову структуру, налаштування компіляції та стан спільної роботи.

#### Основна ідентифікація та метадані

* `_id`: унікальний MongoDB ObjectId, що ідентифікує проєкт.
* `name`: відображувана назва проєкту.
* `description`: необов'язковий текстовий опис проєкту.
* `active`: показує, чи проєкт наразі активний.
* `version`: внутрішня версія схеми або формату проєкту.
* `trashed`: список елементів, переміщених до кошика (м'яке видалення).
* `deletedDocs`: записи про остаточно видалені документи.

#### Власність і керування доступом

* `owner_ref`: посилання на користувача, якому належить проєкт.
* `collaberator_refs`: користувачі з правами редагування.
* `reviewer_refs`: користувачі з доступом рівня рецензента.
* `readOnly_refs`: користувачі з доступом лише для читання.
* `pendingEditor_refs` / `pendingReviewer_refs`: очікувані запрошення.

#### Доступ на основі токенів

* `tokens`: реєстр токенів для спільних посилань.
* `tokenAccessReadOnly_refs`: токени, що надають доступ лише для читання.
* `tokenAccessReadAndWrite_refs`: токени, що надають доступ для читання й запису.

#### Відстеження активності

* `lastUpdated`: позначка часу останньої зміни.
* `lastUpdatedBy`: користувач, який виконав останнє оновлення.
* `lastOpened`: позначка часу, коли проєкт востаннє відкривали.
* `deletedByExternalDataSource`: чи було видалення ініційоване зовнішньою інтеграцією.

#### Структура проєкту

Кореневий документ і папка

* `rootDoc_id`: ObjectId головного вхідного LaTeX-документа (зазвичай `main.tex`).
* `rootFolder`: вбудоване представлення файлового дерева проєкту.

Кожен запис папки містить:

* `name` / `_id`: назву та ідентифікатор папки.
* `docs`: список вихідних LaTeX-документів з назвою та `_id`.
* `fileRefs`: посилання на бінарні файли (зображення, файли даних), зокрема:
  * `name`: ім'я файлу
  * `created`: позначка часу завантаження
  * `rev`: лічильник ревізій
  * `hash`: хеш вмісту для дедуплікації
  * `linkedFileData`: зв'язок із зовнішнім сховищем (якщо є)
* `folders`: вкладені підпапки.

#### Налаштування компіляції та редактора

* `compiler`: вибраний рушій LaTeX (`pdflatex`, `xelatex`, `lualatex` тощо).
* `spellCheckLanguage`: мова перевірки орфографії для цього проєкту.

#### Налаштування публічності та спільного доступу

* `publicAccesLevel`: видимість проєкту (`private`, `readOnly`, `public` тощо).
* `collabratecUsers`: пов'язані користувачі із зовнішніх платформ для спільної роботи.

#### Специфічні розширення Overleaf

* `overleaf.history`:
  * `id`: ідентифікатор, який використовує служба історії.
  * `display`: чи увімкнена та видима історія.

#### Внутрішнє версіонування

* `__v`: внутрішній ключ версії Mongoose для керування паралельним доступом.

Ось реальний приклад для Overleaf.

<Accordion title="Приклад проєкту">
  ```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.