projects inneholder ett dokument per prosjekt: navn, eier og medlemmer, deling, filtreet og prosjektinnstillingene. Teksten i dokumentene ligger ikke her (se Docs-samlingen), og binære filer ligger i blob-lageret til history-v1 under sin hash. Skjemaet er services/web/app/src/models/Project.mjs, med filtreet i Folder.mjs, File.mjs og Doc.mjs ved siden av.I kolonnen Kilde er Project.mjs:N en linje i det skjemaet, andre filnavn uten sti ligger under services/web/app/src/Features/, og modules/... ligger under services/web/. Linjenumrene er fra server-pro da dette ble skrevet.
Grunnleggende identifikasjon og metadata
Felt
Type
Betydning
Kilde
_id
ObjectId
Prosjektets id.
MongoDB
name
String
Prosjektnavn.
Project.mjs:18
description
String
Prosjektbeskrivelse. Tom som standard.
Project.mjs:50
version
Number
Økes med 1 ved hver endring i filtreet (legge til, gi nytt navn, flytte, slette, erstatte).
false etter at prosjektet er deaktivert: dokumentene er arkivert ut av Mongo (docs.inS3). Når prosjektet åpnes, blir de gjenopprettet, og verdien settes tilbake til true. I CE kjører cron-jobben som deaktiverer gamle prosjekter bare med ENABLE_CRON_RESOURCE_DELETION=true.
Brukere som har arkivert prosjektet. Arkivering gjelder per bruker. Gamle boolske verdier ble konvertert av migreringen 20221111111111_ce_sp_convert_archived_state.
Foreldet, { _id, name, deletedAt }. Slettede dokumenter blir nå liggende i docs med deleted: true. Denne arrayen leses bare når et gammelt slettet prosjekt gjenopprettes: oppføringene kopieres til docstore, og arrayen tømmes. Ingenting skriver til den.
Bare i skjemaet: CE-kjernen og modulene våre bruker det ikke.
Project.mjs:28
Eierskap og tilgangskontroll
Felt
Type
Betydning
Kilde
owner_ref
ObjectId
Eier.
Project.mjs:29
collaberator_refs
Array of ObjectId
Brukere som kan redigere (stavemåten er det faktiske feltnavnet).
Project.mjs:30
reviewer_refs
Array of ObjectId
Brukere som kan gå gjennom: kommentere og foreslå med sporede endringer.
Project.mjs:31
readOnly_refs
Array of ObjectId
Brukere som bare kan se.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Ikke invitasjoner (de ligger i projectInvites). Brukere som ble lagt til som redaktør eller gjennomgåer mens eieren ikke hadde ledig samarbeidsplass. De legges til i readOnly_refs og står her til de kan oppgraderes.
Lesere som har bedt om mer tilgang: userId, privilegeLevel, requestedAt. Én oppføring per bruker. Fjernes når forespørselen innvilges eller avslås, eller brukeren forlater prosjektet.
Tilstand for sporede endringer. true betyr på for alle (gammelt format); ellers et objekt med bruker-id-er som nøkler og true for hver bruker som har det på. Modulen track-changes skriver det, og kjernen slår det på for en bruker som blir gjort til gjennomgåer.
IEEE Collabratec-koblinger: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. Brukes ikke i CE.
Project.mjs:104-116
Lenkedeling
Felt
Type
Betydning
Kilde
publicAccesLevel
String
private eller tokenBased (lenkedeling på). Gamle prosjekter kan fortsatt ha de foreldede verdiene readOnly eller readAndWrite. Det finnes ingen public. Stavemåten er det faktiske feltnavnet.
Numerisk prefiks for redigeringstokenet, brukes til å slå opp tokenet. Unik.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Brukere som ble med via visningslenken (bruker-id-er, ikke tokens).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Brukere som ble med via redigeringslenken.
Project.mjs:84
Når lenkedeling slås av, fjernes tokens, og publicAccesLevel settes tilbake til private (ProjectDetailsHandler.mjs:233-238).
Aktivitetssporing
Felt
Type
Betydning
Kilde
lastUpdated
Date
Tidspunkt for siste endring i innholdet eller filtreet. Går bare fremover.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Brukeren bak den siste endringen.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Siste gang noen åpnet prosjektet.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true når prosjektmappen ble slettet på Dropbox-siden. Selve prosjektet slettes ikke; redigeringsverktøyet viser et varsel, og flagget fjernes neste gang prosjektet åpnes.
TeX Live-image som brukes for dette prosjektet ved sandkassekompilering. Et nytt prosjekt får Settings.currentImageName; malgalleriet og MCP-serveren kan endre det.
Importdata fra overleaf.com v1. Settes ikke i CE. overleaf.id har en unik indeks.
Project.mjs:88-91
__v
Number
Mongoose-versjonsnøkkel.
Mongoose
history-v1 kan også skrive overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt og overleaf.backup.*, men bare når backupStore er konfigurert (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE konfigurerer den ikke, så disse feltene forekommer ikke.
Indekser
Alle kommer fra migreringer merket server-ce i tools/migrations/.
Navn
Nøkler
Alternativer
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
Merknader
Mongoose autoIndex er slått av (services/web/app/src/infrastructure/Mongoose.mjs:7): index-alternativene i skjemaet finnes bare fordi migreringene ovenfor oppretter dem.
Migreringen 20250620152657_ensure_collaborator_arrays setter manglende collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs og reviewer_refs til [].