projects sisältää yhden dokumentin projektia kohden: nimen, omistajan ja jäsenet, jakamisen, tiedostopuun ja projektin asetukset. Dokumenttien teksti ei ole täällä (katso Docs-kokoelma), ja binääritiedostot ovat history-v1:n blob-tallennustilassa hash-arvonsa alla. Skeema on services/web/app/src/models/Project.mjs, ja tiedostopuu on sen vieressä tiedostoissa Folder.mjs, File.mjs ja Doc.mjs.Lähde-sarakkeessa Project.mjs:N on kyseisen skeeman rivi, muut polkua vailla olevat tiedostonimet ovat hakemistossa services/web/app/src/Features/, ja modules/... on hakemistossa services/web/. Rivinumerot ovat server-pro:sta kirjoitushetkellä.
Perustunnisteet ja metatiedot
Kenttä
Tyyppi
Merkitys
Lähde
_id
ObjectId
Projektin id.
MongoDB
name
String
Projektin nimi.
Project.mjs:18
description
String
Projektin kuvaus. Oletuksena tyhjä.
Project.mjs:50
version
Number
Kasvaa yhdellä jokaisen tiedostopuun muutoksen yhteydessä (lisäys, uudelleennimeäminen, siirto, poisto, korvaus).
false, kun projekti on poistettu käytöstä: sen dokumentit on arkistoitu pois Mongosta (docs.inS3). Projektin avaaminen palauttaa ne arkistosta ja asettaa arvon takaisin true. CE:ssä vanhat projektit käytöstä poistava cron-ajo toimii vain, kun ENABLE_CRON_RESOURCE_DELETION=true.
Käyttäjät, jotka ovat arkistoineet projektin. Arkistointi on käyttäjäkohtainen. Vanhat totuusarvot muunsi migraatio 20221111111111_ce_sp_convert_archived_state.
Vanha kenttä, { _id, name, deletedAt }. Poistetut dokumentit jäävät nyt kokoelmaan docs arvolla deleted: true. Tämä taulukko luetaan vain, kun vanha poistettu projekti palautetaan: merkinnät kopioidaan docstoreen ja taulukko tyhjennetään. Mikään ei kirjoita siihen.
Vain skeemassa: CE:n ydin ja moduulimme eivät käytä sitä.
Project.mjs:28
Omistajuus ja käyttöoikeuksien hallinta
Kenttä
Tyyppi
Merkitys
Lähde
owner_ref
ObjectId
Omistaja.
Project.mjs:29
collaberator_refs
Array of ObjectId
Käyttäjät, jotka voivat muokata (kirjoitusasu on kentän todellinen nimi).
Project.mjs:30
reviewer_refs
Array of ObjectId
Käyttäjät, jotka voivat tarkistaa: kommentoida ja ehdottaa muutosten seurannalla.
Project.mjs:31
readOnly_refs
Array of ObjectId
Käyttäjät, jotka voivat vain katsella.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Eivät ole kutsuja (ne ovat kokoelmassa projectInvites). Käyttäjät, jotka lisättiin muokkaajiksi tai tarkistajiksi, kun omistajalla ei ollut vapaata yhteistyökumppanipaikkaa. Heidät lisätään kenttään readOnly_refs ja luetellaan tässä, kunnes heidät voidaan korottaa.
Katselijat, jotka ovat pyytäneet lisää oikeuksia: userId, privilegeLevel, requestedAt. Yksi merkintä käyttäjää kohden. Poistetaan, kun pyyntö hyväksytään tai hylätään tai käyttäjä poistuu projektista.
Muutosten seurannan tila. true tarkoittaa päällä kaikille (vanha muoto); muuten objekti, jonka avaimina ovat käyttäjien id:t ja arvona true jokaiselle käyttäjälle, jolla se on päällä. Moduuli track-changes kirjoittaa sen, ja ydin kytkee sen päälle käyttäjälle, josta tehdään tarkistaja.
IEEE Collabratec -linkitykset: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. Ei käytössä CE:ssä.
Project.mjs:104-116
Linkillä jakaminen
Kenttä
Tyyppi
Merkitys
Lähde
publicAccesLevel
String
private tai tokenBased (linkillä jakaminen päällä). Vanhoissa projekteissa voi yhä olla vanhat arvot readOnly tai readAndWrite. Arvoa public ei ole. Kirjoitusasu on kentän todellinen nimi.
Muokkaustunnisteen numeerinen etuliite, jolla tunniste haetaan. Yksilöllinen.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Käyttäjät, jotka liittyivät katselulinkin kautta (käyttäjien id:t, eivät tunnisteet).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Käyttäjät, jotka liittyivät muokkauslinkin kautta.
Project.mjs:84
Linkillä jakamisen poistaminen käytöstä poistaa kentän tokens ja palauttaa publicAccesLevel-arvoksi private (ProjectDetailsHandler.mjs:233-238).
Toiminnan seuranta
Kenttä
Tyyppi
Merkitys
Lähde
lastUpdated
Date
Sisällön tai tiedostopuun viimeisimmän muutoksen aika. Liikkuu vain eteenpäin.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Viimeisimmän muutoksen tehnyt käyttäjä.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Viimeisin kerta, kun joku avasi projektin.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true, kun projektikansio poistettiin Dropboxin puolella. Itse projektia ei poisteta; editori näyttää ilmoituksen, ja lippu tyhjennetään, kun projekti avataan seuraavan kerran.
Asetetaan linkitetyille tiedostoille (URL-osoitteesta, toisesta projektista, tulostiedostosta, Zoterosta tai Mendeleystä): provider, sen lähdetiedot ja importedAt.
TeX Live -levykuva, jota käytetään tälle projektille hiekkalaatikkokäännöksissä. Uusi projekti saa arvon Settings.currentImageName; mallivalikoima ja MCP-palvelin voivat muuttaa sitä.
overleaf.com v1 -tuonnin tiedot. Ei asetettu CE:ssä. Kentällä overleaf.id on yksilöllinen indeksi.
Project.mjs:88-91
__v
Number
Mongoosen versioavain.
Mongoose
history-v1 voi kirjoittaa myös kentät overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt ja overleaf.backup.*, mutta vain kun sen backupStore on määritetty (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE ei määritä sitä, joten näitä kenttiä ei esiinny.
Indeksit
Kaikki tulevat server-ce-tunnisteella merkityistä migraatioista hakemistossa tools/migrations/.
Nimi
Avaimet
Asetukset
Migraatio
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
Huomioita
Mongoosen autoIndex on pois päältä (services/web/app/src/infrastructure/Mongoose.mjs:7): skeeman index-asetukset ovat olemassa vain siksi, että yllä olevat migraatiot luovat ne.
Migraatio 20250620152657_ensure_collaborator_arrays asettaa puuttuvat kentät collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs ja reviewer_refs arvoon [].