Přejít na hlavní obsah
docs uchovává obsah upravitelných textových souborů projektu (Overleaf jim říká docs), například main.tex nebo sample.bib. Jeden dokument na každý doc: jeho řádky, komentáře a sledované změny, dva čítače a stav smazání. Název souboru a jeho místo ve stromu tu nejsou, jsou v projects.rootFolder (viz Kolekce Projects). Binární soubory tu také nejsou. Kromě migrací a údržbových skriptů do této kolekce zapisuje jen docstore, v services/docstore/app/js/MongoManager.js. Model Mongoose neexistuje; web a document-updater k ní přistupují přes HTTP API docstore (services/docstore/app.js:31-70). Ve sloupci Zdroj jsou samotné názvy souborů v services/docstore/app/js/.

Pole

Ranges

ranges má dvě pole. document-updater je sestavuje pomocí libraries/ranges-tracker/index.cjs; docstore před uložením převede id na ObjectId a ts na Date (RangeManager.js:41-63). Doc bez komentářů a sledovaných změn má ranges: {} nebo žádné ranges. Text komentáře a jeho odpovědí v docs není: je v kolekci messages, v room, jejíž thread_id je id komentáře. Zda je komentář vyřešený, se ukládá na této room, ne zde; docstore zahodí příznak resolved, pokud jej někdo pošle (RangeManager.js:59-61). Viz Kolekce Rooms a Kolekce Messages.

Kdo zapisuje

Kdo čte

Indexy

Všechny pocházejí z migrací se značkou server-ce v tools/migrations/.

Poznámky

  • Dokud je doc otevřený, jeho nejnovější text je v document-updater (Redis), ne zde. Mongo se aktualizuje až při flushi document-updater (services/document-updater/app/js/PersistenceManager.js:128-160). Kód, který čte docs celého projektu, by měl nejprve zavolat flushProjectToMongo, jako to dělá ProjectDuplicator.
  • Smazané docs zůstávají v této kolekci s deleted: true, dokud není projekt zničen. docstore jich vrátí nejvýše MAX_DELETED_DOCS (výchozí 2000), nejnovější první (MongoManager.js:29-44, services/docstore/config/settings.defaults.cjs:40). Panel historie je nepoužívá; čte history-v1.
  • Čítače rev a version nesouvisejí s verzemi historie projektu v history-v1.
Zde jsou skutečné příklady docs v Overleafu.
Naposledy změněno 21. listopadu 2026