projects enthält ein Dokument pro Projekt: Name, Eigentümer und Mitglieder, Freigabe, den Dateibaum und die Projekteinstellungen. Der Text der Dokumente liegt nicht hier (siehe Docs-Collection), und Binärdateien liegen im Blob-Speicher von history-v1 unter ihrem hash. Das Schema ist services/web/app/src/models/Project.mjs, der Dateibaum steht in Folder.mjs, File.mjs und Doc.mjs daneben.In der Spalte Quelle ist Project.mjs:N eine Zeile dieses Schemas, andere Dateinamen ohne Pfad liegen unter services/web/app/src/Features/, und modules/... liegt unter services/web/. Die Zeilennummern stammen aus server-pro zum Zeitpunkt der Erstellung.
Kernidentifikation & Metadaten
Feld
Typ
Bedeutung
Quelle
_id
ObjectId
Id des Projekts.
MongoDB
name
String
Projektname.
Project.mjs:18
description
String
Projektbeschreibung. Standardmäßig leer.
Project.mjs:50
version
Number
Wird bei jeder Änderung am Dateibaum (Hinzufügen, Umbenennen, Verschieben, Löschen, Ersetzen) um 1 erhöht.
false, nachdem das Projekt deaktiviert wurde: Seine Dokumente wurden aus Mongo archiviert (docs.inS3). Beim Öffnen des Projekts werden sie wiederhergestellt, und der Wert wird wieder auf true gesetzt. In CE läuft der Cronjob, der alte Projekte deaktiviert, nur mit ENABLE_CRON_RESOURCE_DELETION=true.
Benutzer, die das Projekt archiviert haben. Die Archivierung gilt pro Benutzer. Alte boolesche Werte wurden von der Migration 20221111111111_ce_sp_convert_archived_state umgewandelt.
Veraltet, { _id, name, deletedAt }. Gelöschte Dokumente bleiben jetzt mit deleted: true in docs. Dieses Array wird nur gelesen, wenn ein altes gelöschtes Projekt wiederhergestellt wird: Die Einträge werden in den Docstore kopiert und das Array wird geleert. Nichts schreibt hinein.
Nur im Schema: Der CE-Kern und unsere Module verwenden es nicht.
Project.mjs:28
Eigentümerschaft & Zugriffskontrolle
Feld
Typ
Bedeutung
Quelle
owner_ref
ObjectId
Eigentümer.
Project.mjs:29
collaberator_refs
Array of ObjectId
Benutzer, die bearbeiten dürfen (die Schreibweise ist der echte Feldname).
Project.mjs:30
reviewer_refs
Array of ObjectId
Benutzer, die prüfen dürfen: kommentieren und mit Änderungsverfolgung Vorschläge machen.
Project.mjs:31
readOnly_refs
Array of ObjectId
Benutzer, die nur ansehen dürfen.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Keine Einladungen (diese liegen in projectInvites). Benutzer, die als Bearbeiter oder Prüfer hinzugefügt wurden, während der Eigentümer keinen freien Mitarbeiterplatz hatte. Sie werden zu readOnly_refs hinzugefügt und hier geführt, bis sie hochgestuft werden können.
Betrachter, die mehr Zugriff angefragt haben: userId, privilegeLevel, requestedAt. Ein Eintrag pro Benutzer. Wird entfernt, wenn die Anfrage gewährt oder abgelehnt wird oder der Benutzer das Projekt verlässt.
Zustand der Änderungsverfolgung. true bedeutet für alle eingeschaltet (altes Format); andernfalls ein Objekt mit Benutzer-Ids als Schlüssel und true für jeden Benutzer, bei dem sie eingeschaltet ist. Das Modul track-changes schreibt es, und der Kern schaltet sie für einen Benutzer ein, der zum Prüfer gemacht wird.
IEEE-Collabratec-Verknüpfungen: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. In CE nicht verwendet.
Project.mjs:104-116
Freigabe per Link
Feld
Typ
Bedeutung
Quelle
publicAccesLevel
String
private oder tokenBased (Freigabe per Link eingeschaltet). Alte Projekte können noch die veralteten Werte readOnly oder readAndWrite haben. Es gibt kein public. Die Schreibweise ist der echte Feldname.
Numerisches Präfix des Bearbeitungs-Tokens, mit dem das Token nachgeschlagen wird. Eindeutig.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Benutzer, die über den Link zum Ansehen beigetreten sind (Benutzer-Ids, keine Tokens).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Benutzer, die über den Link zum Bearbeiten beigetreten sind.
Project.mjs:84
Beim Ausschalten der Freigabe per Link wird tokens entfernt und publicAccesLevel wieder auf private gesetzt (ProjectDetailsHandler.mjs:233-238).
Aktivitätsverfolgung
Feld
Typ
Bedeutung
Quelle
lastUpdated
Date
Zeitpunkt der letzten Änderung am Inhalt oder am Dateibaum. Bewegt sich nur vorwärts.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Benutzer dieser letzten Änderung.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Letzter Zeitpunkt, zu dem jemand das Projekt geöffnet hat.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true, wenn der Projektordner auf der Dropbox-Seite gelöscht wurde. Das Projekt selbst wird nicht gelöscht; der Editor zeigt einen Hinweis, und das Flag wird beim nächsten Öffnen des Projekts gelöscht.
Altlast aus dem Import von overleaf.com v1. Ist der Wert größer als 0, wird das Projekt beim Laden einmal zu Dropbox übertragen und der Zähler zurückgesetzt.
Gesetzt für verknüpfte Dateien (aus einer URL, einem anderen Projekt, einer Ausgabedatei, Zotero oder Mendeley): der provider, seine Quelldaten und importedAt.
TeX-Live-Image, das für dieses Projekt bei Sandbox-Kompilierungen verwendet wird. Ein neues Projekt erhält Settings.currentImageName; die Vorlagengalerie und der MCP-Server können es ändern.
Der Verlauf speichert auch Kommentare und verfolgte Änderungen. Beim Wiederherstellen einer Version werden sie nur wiederhergestellt, wenn dieser Wert true ist.
Importdaten von overleaf.com v1. In CE nicht gesetzt. overleaf.id hat einen eindeutigen Index.
Project.mjs:88-91
__v
Number
Mongoose-Versionsschlüssel.
Mongoose
history-v1 kann außerdem overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt und overleaf.backup.* schreiben, aber nur, wenn sein backupStore konfiguriert ist (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE konfiguriert ihn nicht, daher kommen diese Felder nicht vor.
Indizes
Alle stammen aus Migrationen mit dem Tag server-ce in tools/migrations/.
Name
Schlüssel
Optionen
Migration
owner_ref_1
owner_ref: 1
20190912145024_create_projects_indexes
collaberator_refs_1
collaberator_refs: 1
20190912145024_create_projects_indexes
readOnly_refs_1
readOnly_refs: 1
20190912145024_create_projects_indexes
tokenAccessReadOnly_refs_1
tokenAccessReadOnly_refs: 1
20190912145024_create_projects_indexes
tokenAccessReadAndWrite_refs_1
tokenAccessReadAndWrite_refs: 1
20190912145024_create_projects_indexes
tokens.readOnly_1
tokens.readOnly: 1
unique, partial (field exists)
20190912145024_create_projects_indexes
tokens.readAndWrite_1
tokens.readAndWrite: 1
unique, partial
20190912145024_create_projects_indexes
tokens.readAndWritePrefix_1
tokens.readAndWritePrefix: 1
unique, partial
20190912145024_create_projects_indexes
overleaf.history.id_1
overleaf.history.id: 1
unique, partial
20190912145024_create_projects_indexes
overleaf.id_1
overleaf.id: 1
unique, partial
20190912145024_create_projects_indexes
collabratecUsers.user_id_1
collabratecUsers.user_id: 1
sparse
20190912145024_create_projects_indexes
imageName_1
imageName: 1
20240730155209_create_project_imageName_index
reviewer_refs_1
reviewer_refs: 1
20241204103349_create_reviewer_refs_index
active_true_lastOpened_1
lastOpened: 1
partial (active: true)
20250320161029_update_inactive_project_index
Hinweise
Mongoose-autoIndex ist ausgeschaltet (services/web/app/src/infrastructure/Mongoose.mjs:7): Die index-Optionen im Schema gibt es nur, weil die obigen Migrationen sie anlegen.
Die Migration 20250620152657_ensure_collaborator_arrays setzt fehlende collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs und reviewer_refs auf [].
Beim Löschen eines Projekts wird das Dokument nach deletedProjects verschoben (siehe Deleted-Projects-Collection).
Hier ist ein echtes Beispiel für ein Overleaf-Projekt.