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.

Przykład 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
}