projects innehåller ett dokument per projekt: namn, ägare och medlemmar, delning, filträdet och projektinställningarna. Texten i dokumenten finns inte här (se Samlingen Docs), och binära filer ligger i blob-lagringen i history-v1 under sin hash. Schemat är services/web/app/src/models/Project.mjs, med filträdet i Folder.mjs, File.mjs och Doc.mjs bredvid.I kolumnen Källa är Project.mjs:N en rad i det schemat, andra filnamn utan sökväg ligger under services/web/app/src/Features/, och modules/... ligger under services/web/. Radnumren kommer från server-pro när detta skrevs.
Grundläggande identifiering och metadata
Fält
Typ
Betydelse
Källa
_id
ObjectId
Projektets id.
MongoDB
name
String
Projektnamn.
Project.mjs:18
description
String
Projektbeskrivning. Tom som standard.
Project.mjs:50
version
Number
Ökas med 1 vid varje ändring i filträdet (lägga till, byta namn, flytta, ta bort, ersätta).
false efter att projektet har inaktiverats: dess dokument har arkiverats ut ur Mongo (docs.inS3). När projektet öppnas avarkiveras de och värdet sätts tillbaka till true. I CE körs cron-jobbet som inaktiverar gamla projekt bara med ENABLE_CRON_RESOURCE_DELETION=true.
Användare som har arkiverat projektet. Arkivering gäller per användare. Gamla booleska värden konverterades av migreringen 20221111111111_ce_sp_convert_archived_state.
Äldre fält, { _id, name, deletedAt }. Borttagna dokument ligger nu kvar i docs med deleted: true. Den här arrayen läses bara när ett gammalt borttaget projekt återställs: posterna kopieras till docstore och arrayen töms. Inget skriver till den.
Bara i schemat: CE-kärnan och våra moduler använder det inte.
Project.mjs:28
Ägarskap och åtkomstkontroll
Fält
Typ
Betydelse
Källa
owner_ref
ObjectId
Ägare.
Project.mjs:29
collaberator_refs
Array of ObjectId
Användare som kan redigera (stavningen är det verkliga fältnamnet).
Project.mjs:30
reviewer_refs
Array of ObjectId
Användare som kan granska: kommentera och föreslå med spårade ändringar.
Project.mjs:31
readOnly_refs
Array of ObjectId
Användare som bara kan visa.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Inte inbjudningar (de finns i projectInvites). Användare som lades till som redigerare eller granskare när ägaren inte hade någon ledig medarbetarplats. De läggs till i readOnly_refs och listas här tills de kan uppgraderas.
Läsare som har bett om mer åtkomst: userId, privilegeLevel, requestedAt. En post per användare. Tas bort när begäran beviljas, avslås eller användaren lämnar projektet.
Läget för spårade ändringar. true betyder på för alla (gammalt format); annars ett objekt med användar-id som nycklar och true för varje användare som har det på. Modulen track-changes skriver det, och kärnan slår på det för en användare som görs till granskare.
IEEE Collabratec-länkar: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. Används inte i CE.
Project.mjs:104-116
Länkdelning
Fält
Typ
Betydelse
Källa
publicAccesLevel
String
private eller tokenBased (länkdelning på). Gamla projekt kan fortfarande ha de äldre värdena readOnly eller readAndWrite. Det finns inget public. Stavningen är det verkliga fältnamnet.
Numeriskt prefix för redigeringstoken, används för att slå upp token. Unik.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Användare som gick med via visningslänken (användar-id, inte tokens).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Användare som gick med via redigeringslänken.
Project.mjs:84
När länkdelning stängs av tas tokens bort och publicAccesLevel sätts tillbaka till private (ProjectDetailsHandler.mjs:233-238).
Aktivitetsspårning
Fält
Typ
Betydelse
Källa
lastUpdated
Date
Tidpunkt för den senaste ändringen av innehållet eller filträdet. Går bara framåt.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Användaren bakom den senaste ändringen.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Senaste gången någon öppnade projektet.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true när projektmappen togs bort på Dropbox-sidan. Själva projektet tas inte bort; redigeraren visar ett meddelande och flaggan rensas nästa gång projektet öppnas.
TeX Live-avbildning som används för projektet vid sandlådekompileringar. Ett nytt projekt får Settings.currentImageName; mallgalleriet och MCP-servern kan ändra den.
Importdata från overleaf.com v1. Sätts inte i CE. overleaf.id har ett unikt index.
Project.mjs:88-91
__v
Number
Mongoose versionsnyckel.
Mongoose
history-v1 kan också skriva overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt och overleaf.backup.*, men bara när dess backupStore är konfigurerad (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE konfigurerar den inte, så dessa fält förekommer inte.
Index
Alla kommer från migreringar taggade server-ce i tools/migrations/.
Namn
Nycklar
Alternativ
Migrering
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
Anteckningar
Mongoose autoIndex är avstängt (services/web/app/src/infrastructure/Mongoose.mjs:7): index-alternativen i schemat finns bara för att migreringarna ovan skapar dem.
Migreringen 20250620152657_ensure_collaborator_arrays sätter saknade collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs och reviewer_refs till [].