Vai al contenuto principale
docs contiene il contenuto dei file di testo modificabili di un progetto (Overleaf li chiama doc), ad esempio main.tex o sample.bib. Un documento per doc: le sue righe, i suoi commenti e le modifiche tracciate, due contatori e lo stato di eliminazione. Il nome del file e la sua posizione nell’albero non sono qui ma in projects.rootFolder (vedi Collezione Projects). Nemmeno i file binari sono qui. A parte le migrazioni e gli script di manutenzione, solo docstore scrive questa collezione, in services/docstore/app/js/MongoManager.js. Non esiste un modello Mongoose; web e document-updater vi accedono tramite l’API HTTP di docstore (services/docstore/app.js:31-70). Nella colonna Fonte, i nomi di file senza percorso si trovano sotto services/docstore/app/js/.

Campi

Ranges

ranges ha due array. document-updater li costruisce con libraries/ranges-tracker/index.cjs; docstore converte gli id in ObjectId e ts in Date prima del salvataggio (RangeManager.js:41-63). Un doc senza commenti né modifiche tracciate ha ranges: {} oppure nessun ranges. Il testo di un commento e delle sue risposte non è in docs: si trova nella collezione messages, nella room il cui thread_id è l’id del commento. Se un commento è risolto viene memorizzato su quella room, non qui; docstore scarta un flag resolved se ne riceve uno (RangeManager.js:59-61). Vedi Collezione Rooms e Collezione Messages.

Chi scrive

Chi legge

Indici

Provengono tutti da migrazioni contrassegnate con server-ce in tools/migrations/.

Note

  • Mentre un doc è aperto, il suo testo più recente si trova in document-updater (Redis), non qui. Mongo viene aggiornato solo quando document-updater esegue il flush (services/document-updater/app/js/PersistenceManager.js:128-160). Il codice che legge i doc di un intero progetto dovrebbe prima chiamare flushProjectToMongo, come fa ProjectDuplicator.
  • I doc eliminati restano in questa collezione, con deleted: true, finché il progetto non viene distrutto. docstore ne restituisce al massimo MAX_DELETED_DOCS (predefinito 2000), dal più recente (MongoManager.js:29-44, services/docstore/config/settings.defaults.cjs:40). Il pannello della cronologia non li usa; legge history-v1.
  • I contatori rev e version non hanno relazione con le versioni della cronologia del progetto in history-v1.
Ecco alcuni esempi reali di docs di Overleaf.
Ultima modifica il 21 novembre 2026