Projects 集合

Project 代表 Overleaf 中的單一 LaTeX 專案。它儲存專案中繼資料、擁有權與存取控制、檔案結構、編譯設定以及協作狀態。

​

核心識別與中繼資料

• _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：主要 LaTeX 進入點文件（通常為 main.tex）的 ObjectId。
• 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
}