Przejdź do głównej treści
docs przechowuje zawartość edytowalnych plików tekstowych projektu (Overleaf nazywa je docs), na przykład main.tex lub sample.bib. Jeden dokument na każdy doc: jego wiersze, komentarze i śledzone zmiany, dwa liczniki i stan usunięcia. Nazwy pliku i jego miejsca w drzewie tu nie ma, są w projects.rootFolder (zobacz Kolekcja projektów). Plików binarnych też tu nie ma. Poza migracjami i skryptami konserwacyjnymi do tej kolekcji zapisuje tylko docstore, w services/docstore/app/js/MongoManager.js. Nie ma modelu Mongoose; web i document-updater korzystają z niej przez HTTP API docstore (services/docstore/app.js:31-70). W kolumnie Źródło same nazwy plików znajdują się w services/docstore/app/js/.

Pola

Ranges

ranges ma dwie tablice. document-updater buduje je za pomocą libraries/ranges-tracker/index.cjs; docstore przed zapisem zamienia id na ObjectId, a ts na Date (RangeManager.js:41-63). Doc bez komentarzy i śledzonych zmian ma ranges: {} albo nie ma ranges. Tekstu komentarza i odpowiedzi na niego nie ma w docs: znajduje się w kolekcji messages, w room, której thread_id jest id komentarza. To, czy komentarz jest rozwiązany, jest zapisywane w tej room, nie tutaj; docstore odrzuca flagę resolved, jeśli zostanie przesłana (RangeManager.js:59-61). Zobacz Kolekcja Rooms i Kolekcja Messages.

Kto zapisuje

Kto odczytuje

Indeksy

Wszystkie pochodzą z migracji z tagiem server-ce w tools/migrations/.

Uwagi

  • Gdy doc jest otwarty, jego najnowszy tekst znajduje się w document-updater (Redis), nie tutaj. Mongo jest aktualizowane dopiero przy flushu document-updater (services/document-updater/app/js/PersistenceManager.js:128-160). Kod odczytujący docs całego projektu powinien najpierw wywołać flushProjectToMongo, tak jak robi to ProjectDuplicator.
  • Usunięte docs pozostają w tej kolekcji z deleted: true, dopóki projekt nie zostanie zniszczony. docstore zwraca najwyżej MAX_DELETED_DOCS (domyślnie 2000) z nich, od najnowszych (MongoManager.js:29-44, services/docstore/config/settings.defaults.cjs:40). Panel historii ich nie używa; odczytuje history-v1.
  • Liczniki rev i version nie mają związku z wersjami historii projektu w history-v1.
Oto prawdziwe przykłady docs w Overleaf.
Ostatnia modyfikacja 21 listopada 2026