メインコンテンツへスキップ
docs はプロジェクトの編集可能なテキストファイル(Overleaf では doc と呼びます)の内容を保持します。たとえば main.tex や sample.bib です。doc ごとに 1 つのドキュメントがあり、行、コメントと変更履歴、2 つのカウンター、削除状態を持ちます。ファイル名とツリー内の位置はここではなく projects.rootFolder にあります(Projects コレクション を参照)。バイナリファイルもここにはありません。 マイグレーションとメンテナンススクリプトを除き、このコレクションに書き込むのは docstore だけで、場所は services/docstore/app/js/MongoManager.js です。Mongoose モデルはなく、web と document-updater は docstore の HTTP API を通じてアクセスします(services/docstore/app.js:31-70)。出典列でパスのないファイル名は services/docstore/app/js/ 配下です。

フィールド

Ranges

ranges には 2 つの配列があります。document-updater が libraries/ranges-tracker/index.cjs で構築し、docstore が保存前に id を ObjectId に、ts を Date に変換します(RangeManager.js:41-63)。コメントも変更履歴もない doc は ranges: {} を持つか、ranges を持ちません。 コメントとその返信のテキストは docs にはありません。messages コレクションの、thread_id がコメント id である room にあります。コメントが解決済みかどうかはここではなくその room に保存され、docstore は resolved フラグが送られてきても破棄します(RangeManager.js:59-61)。Rooms コレクション と Messages コレクション を参照してください。

書き込み元

読み取り元

インデックス

すべて tools/migrations/ 内の server-ce タグ付きマイグレーションによるものです。

補足

  • doc が開いている間、最新のテキストはここではなく document-updater(Redis)にあります。Mongo は document-updater がフラッシュしたときにだけ更新されます(services/document-updater/app/js/PersistenceManager.js:128-160)。プロジェクト全体の doc を読むコードは、ProjectDuplicator のように先に flushProjectToMongo を呼ぶ必要があります。
  • 削除された doc は、プロジェクトが破棄されるまで deleted: true のままこのコレクションに残ります。docstore は新しい順に最大 MAX_DELETED_DOCS(デフォルト 2000)件を返します(MongoManager.js:29-44, services/docstore/config/settings.defaults.cjs:40)。履歴パネルはこれらを使わず、history-v1 を読みます。
  • rev と version のカウンターは、history-v1 のプロジェクト履歴のバージョンとは関係ありません。
以下は Overleaf の docs の実例です。
最終更新日 2026年11月21日