Колекція 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.

Приклад проєкту

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