projects obsahuje jeden dokument na projekt: název, vlastníka a členy, sdílení, strom souborů a nastavení projektu. Text dokumentů tu není (viz Kolekce Docs) a binární soubory jsou uloženy v úložišti blobů history-v1 pod svým hash. Schéma je services/web/app/src/models/Project.mjs, strom souborů je vedle v Folder.mjs, File.mjs a Doc.mjs.Ve sloupci Zdroj je Project.mjs:N řádek tohoto schématu, ostatní názvy souborů bez cesty jsou v services/web/app/src/Features/ a modules/... je v services/web/. Čísla řádků pocházejí ze server-pro v době psaní.
Základní identifikace a metadata
Pole
Typ
Význam
Zdroj
_id
ObjectId
Id projektu.
MongoDB
name
String
Název projektu.
Project.mjs:18
description
String
Popis projektu. Ve výchozím stavu prázdný.
Project.mjs:50
version
Number
Zvyšuje se o 1 při každé změně stromu souborů (přidání, přejmenování, přesunutí, smazání, nahrazení).
false po deaktivaci projektu: jeho dokumenty byly archivovány mimo Mongo (docs.inS3). Otevření projektu je obnoví z archivu a hodnotu znovu nastaví na true. V CE běží cron, který deaktivuje staré projekty, jen s ENABLE_CRON_RESOURCE_DELETION=true.
Uživatelé, kteří projekt archivovali. Archivace platí pro každého uživatele zvlášť. Staré logické hodnoty převedla migrace 20221111111111_ce_sp_convert_archived_state.
Zastaralé, { _id, name, deletedAt }. Smazané dokumenty nyní zůstávají v docs s deleted: true. Toto pole se čte jen při obnově starého smazaného projektu: záznamy se zkopírují do docstore a pole se vyprázdní. Nic do něj nezapisuje.
Pouze ve schématu: jádro CE a naše moduly ho nepoužívají.
Project.mjs:28
Vlastnictví a řízení přístupu
Pole
Typ
Význam
Zdroj
owner_ref
ObjectId
Vlastník.
Project.mjs:29
collaberator_refs
Array of ObjectId
Uživatelé, kteří mohou upravovat (tento pravopis je skutečný název pole).
Project.mjs:30
reviewer_refs
Array of ObjectId
Uživatelé, kteří mohou revidovat: komentovat a navrhovat se sledováním změn.
Project.mjs:31
readOnly_refs
Array of ObjectId
Uživatelé, kteří mohou pouze prohlížet.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Nejde o pozvánky (ty jsou v projectInvites). Uživatelé přidaní jako editoři nebo revizoři v době, kdy vlastník neměl volné místo pro spolupracovníka. Přidají se do readOnly_refs a jsou zde uvedeni, dokud je nelze povýšit.
Čtenáři, kteří požádali o větší přístup: userId, privilegeLevel, requestedAt. Jeden záznam na uživatele. Odstraní se, když je žádost schválena nebo zamítnuta, nebo když uživatel projekt opustí.
Stav sledování změn. true znamená zapnuto pro všechny (starý formát); jinak objekt s id uživatelů jako klíči a true pro každého uživatele, který ho má zapnuté. Zapisuje ho modul track-changes a jádro ho zapne uživateli, který se stane revizorem.
Propojení IEEE Collabratec: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. V CE se nepoužívá.
Project.mjs:104-116
Sdílení odkazem
Pole
Typ
Význam
Zdroj
publicAccesLevel
String
private nebo tokenBased (sdílení odkazem zapnuto). Staré projekty mohou mít ještě zastaralé hodnoty readOnly nebo readAndWrite. Hodnota public neexistuje. Tento pravopis je skutečný název pole.
Číselná předpona tokenu pro úpravy, podle které se token vyhledává. Jedinečná.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Uživatelé, kteří se připojili přes odkaz pouze pro čtení (id uživatelů, ne tokeny).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Uživatelé, kteří se připojili přes odkaz pro úpravy.
Project.mjs:84
Vypnutí sdílení odkazem odstraní tokens a vrátí publicAccesLevel na private (ProjectDetailsHandler.mjs:233-238).
Sledování aktivity
Pole
Typ
Význam
Zdroj
lastUpdated
Date
Čas poslední změny obsahu nebo stromu souborů. Pouze roste.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Uživatel, který provedl tuto poslední změnu.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Kdy naposledy někdo projekt otevřel.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true, když byla složka projektu smazána na straně Dropboxu. Samotný projekt se nesmaže; editor zobrazí upozornění a příznak se vymaže při příštím otevření projektu.
Obraz TeX Live použitý pro tento projekt při kompilaci v sandboxu. Nový projekt dostane Settings.currentImageName; galerie šablon a MCP server ho mohou změnit.
Data importu z overleaf.com v1. V CE se nenastavují. overleaf.id má jedinečný index.
Project.mjs:88-91
__v
Number
Klíč verze Mongoose.
Mongoose
history-v1 může také zapisovat overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt a overleaf.backup.*, ale jen když je nakonfigurován jeho backupStore (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE ho nekonfiguruje, takže se tato pole neobjevují.
Indexy
Všechny pocházejí z migrací označených server-ce v tools/migrations/.
Název
Klíče
Volby
Migrace
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
Poznámky
autoIndex v Mongoose je vypnutý (services/web/app/src/infrastructure/Mongoose.mjs:7): volby index ve schématu existují jen proto, že je vytvářejí výše uvedené migrace.
Migrace 20250620152657_ensure_collaborator_arrays nastaví chybějící collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs a reviewer_refs na [].