projects indeholder ét dokument pr. projekt: navn, ejer og medlemmer, deling, filtræet og projektindstillingerne. Teksten i dokumenterne ligger ikke her (se Docs-samlingen), og binære filer ligger i blob-lageret i history-v1 under deres hash. Skemaet er services/web/app/src/models/Project.mjs, med filtræet i Folder.mjs, File.mjs og Doc.mjs ved siden af.I kolonnen Kilde er Project.mjs:N en linje i det skema, andre filnavne uden sti ligger under services/web/app/src/Features/, og modules/... ligger under services/web/. Linjenumrene stammer fra server-pro på skrivetidspunktet.
Grundlæggende identifikation og metadata
Felt
Type
Betydning
Kilde
_id
ObjectId
Projektets id.
MongoDB
name
String
Projektnavn.
Project.mjs:18
description
String
Projektbeskrivelse. Tom som standard.
Project.mjs:50
version
Number
Øges med 1 ved hver ændring af filtræet (tilføj, omdøb, flyt, slet, erstat).
false, efter projektet er blevet deaktiveret: dets dokumenter er arkiveret ud af Mongo (docs.inS3). Når projektet åbnes, bliver de genoprettet, og værdien sættes tilbage til true. I CE kører det cron-job, der deaktiverer gamle projekter, kun med ENABLE_CRON_RESOURCE_DELETION=true.
Brugere, der har arkiveret projektet. Arkivering gælder pr. bruger. Gamle booleske værdier blev konverteret af migreringen 20221111111111_ce_sp_convert_archived_state.
Forældet, { _id, name, deletedAt }. Slettede dokumenter bliver nu i docs med deleted: true. Dette array læses kun, når et gammelt slettet projekt gendannes: posterne kopieres til docstore, og arrayet tømmes. Intet skriver til det.
Kun i skemaet: CE-kernen og vores moduler bruger det ikke.
Project.mjs:28
Ejerskab og adgangskontrol
Felt
Type
Betydning
Kilde
owner_ref
ObjectId
Ejer.
Project.mjs:29
collaberator_refs
Array of ObjectId
Brugere, der kan redigere (stavemåden er det faktiske feltnavn).
Project.mjs:30
reviewer_refs
Array of ObjectId
Brugere, der kan gennemse: kommentere og foreslå med sporede ændringer.
Project.mjs:31
readOnly_refs
Array of ObjectId
Brugere, der kun kan se.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Ikke invitationer (de ligger i projectInvites). Brugere, der blev tilføjet som redaktør eller korrekturlæser, mens ejeren ikke havde en ledig samarbejdsplads. De føjes til readOnly_refs og står her, indtil de kan opgraderes.
Læsere, der har bedt om mere adgang: userId, privilegeLevel, requestedAt. Én post pr. bruger. Fjernes, når anmodningen imødekommes eller afvises, eller brugeren forlader projektet.
Tilstand for sporede ændringer. true betyder slået til for alle (gammelt format); ellers et objekt med bruger-id’er som nøgler og true for hver bruger, der har det slået til. Modulet track-changes skriver det, og kernen slår det til for en bruger, der gøres til korrekturlæser.
IEEE Collabratec-links: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. Bruges ikke i CE.
Project.mjs:104-116
Linkdeling
Felt
Type
Betydning
Kilde
publicAccesLevel
String
private eller tokenBased (linkdeling slået til). Gamle projekter kan stadig have de forældede værdier readOnly eller readAndWrite. Der findes ingen public. Stavemåden er det faktiske feltnavn.
Numerisk præfiks for redigeringstokenet, bruges til at slå tokenet op. Unikt.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Brugere, der kom med via visningslinket (bruger-id’er, ikke tokens).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Brugere, der kom med via redigeringslinket.
Project.mjs:84
Når linkdeling slås fra, fjernes tokens, og publicAccesLevel sættes tilbage til private (ProjectDetailsHandler.mjs:233-238).
Aktivitetssporing
Felt
Type
Betydning
Kilde
lastUpdated
Date
Tidspunkt for den seneste ændring af indholdet eller filtræet. Bevæger sig kun fremad.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Brugeren bag den seneste ændring.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Seneste gang nogen åbnede projektet.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true, når projektmappen blev slettet på Dropbox-siden. Selve projektet slettes ikke; editoren viser en meddelelse, og flaget ryddes, næste gang projektet åbnes.
TeX Live-image, der bruges til dette projekt ved sandkassekompileringer. Et nyt projekt får Settings.currentImageName; skabelongalleriet og MCP-serveren kan ændre det.
Importdata fra overleaf.com v1. Sættes ikke i CE. overleaf.id har et unikt indeks.
Project.mjs:88-91
__v
Number
Mongoose-versionsnøgle.
Mongoose
history-v1 kan også skrive overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt og overleaf.backup.*, men kun når dens backupStore er konfigureret (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE konfigurerer den ikke, så disse felter forekommer ikke.
Indekser
Alle stammer fra migreringer mærket server-ce i tools/migrations/.
Navn
Nøgler
Indstillinger
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
Bemærkninger
Mongoose autoIndex er slået fra (services/web/app/src/infrastructure/Mongoose.mjs:7): index-indstillingerne i skemaet findes kun, fordi migreringerne ovenfor opretter dem.
Migreringen 20250620152657_ensure_collaborator_arrays sætter manglende collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs og reviewer_refs til [].