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 conserver-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 chiamareflushProjectToMongo, come faProjectDuplicator. - I doc eliminati restano in questa collezione, con
deleted: true, finché il progetto non viene distrutto. docstore ne restituisce al massimoMAX_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
reveversionnon hanno relazione con le versioni della cronologia del progetto in history-v1.
docs di Overleaf.
Un doc eliminato
Un doc eliminato
Un doc con commenti
Un doc con commenti

