> ## 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` は Overleaf における 1 つの 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`: 名前と `_id` を持つ LaTeX ソースドキュメントのリスト。
* `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.