projects przechowuje jeden dokument na projekt: nazwę, właściciela i członków, udostępnianie, drzewo plików i ustawienia projektu. Treści dokumentów tu nie ma (zobacz Kolekcja Docs), a pliki binarne znajdują się w magazynie blobów history-v1 pod swoim hash. Schemat to services/web/app/src/models/Project.mjs, a drzewo plików jest obok w Folder.mjs, File.mjs i Doc.mjs.W kolumnie Źródło Project.mjs:N to wiersz tego schematu, inne nazwy plików bez ścieżki znajdują się w services/web/app/src/Features/, a modules/... w services/web/. Numery wierszy pochodzą z server-pro w chwili pisania.
Podstawowa identyfikacja i metadane
Pole
Typ
Znaczenie
Źródło
_id
ObjectId
Id projektu.
MongoDB
name
String
Nazwa projektu.
Project.mjs:18
description
String
Opis projektu. Domyślnie pusty.
Project.mjs:50
version
Number
Zwiększany o 1 przy każdej zmianie drzewa plików (dodanie, zmiana nazwy, przeniesienie, usunięcie, zastąpienie).
false po dezaktywacji projektu: jego dokumenty zostały zarchiwizowane poza Mongo (docs.inS3). Otwarcie projektu przywraca je z archiwum i ponownie ustawia true. W CE cron, który dezaktywuje stare projekty, działa tylko z ENABLE_CRON_RESOURCE_DELETION=true.
Użytkownicy, którzy zarchiwizowali projekt. Archiwizacja dotyczy każdego użytkownika osobno. Stare wartości logiczne przekształciła migracja 20221111111111_ce_sp_convert_archived_state.
Przestarzałe, { _id, name, deletedAt }. Usunięte dokumenty pozostają teraz w docs z deleted: true. Ta tablica jest odczytywana tylko przy przywracaniu starego usuniętego projektu: wpisy są kopiowane do docstore, a tablica jest opróżniana. Nic do niej nie zapisuje.
Tylko w schemacie: rdzeń CE i nasze moduły go nie używają.
Project.mjs:28
Własność i kontrola dostępu
Pole
Typ
Znaczenie
Źródło
owner_ref
ObjectId
Właściciel.
Project.mjs:29
collaberator_refs
Array of ObjectId
Użytkownicy, którzy mogą edytować (ta pisownia to prawdziwa nazwa pola).
Project.mjs:30
reviewer_refs
Array of ObjectId
Użytkownicy, którzy mogą recenzować: komentować i proponować zmiany ze śledzeniem zmian.
Project.mjs:31
readOnly_refs
Array of ObjectId
Użytkownicy, którzy mogą tylko przeglądać.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
To nie zaproszenia (te są w projectInvites). Użytkownicy dodani jako edytorzy lub recenzenci, gdy właściciel nie miał wolnego miejsca na współpracownika. Są dodawani do readOnly_refs i wymieniani tutaj, dopóki nie będzie można ich awansować.
Czytelnicy, którzy poprosili o większy dostęp: userId, privilegeLevel, requestedAt. Jeden wpis na użytkownika. Usuwany, gdy prośba zostanie przyjęta lub odrzucona albo użytkownik opuści projekt.
Stan śledzenia zmian. true oznacza włączone dla wszystkich (stary format); w przeciwnym razie obiekt z id użytkowników jako kluczami i true dla każdego użytkownika, który ma je włączone. Zapisuje je moduł track-changes, a rdzeń włącza je dla użytkownika mianowanego recenzentem.
Powiązania IEEE Collabratec: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. Nieużywane w CE.
Project.mjs:104-116
Udostępnianie przez link
Pole
Typ
Znaczenie
Źródło
publicAccesLevel
String
private lub tokenBased (udostępnianie przez link włączone). Stare projekty mogą nadal mieć przestarzałe wartości readOnly lub readAndWrite. Nie ma wartości public. Ta pisownia to prawdziwa nazwa pola.
Numeryczny prefiks tokenu edycji, używany do wyszukania tokenu. Unikalny.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Użytkownicy, którzy dołączyli przez link tylko do odczytu (id użytkowników, nie tokeny).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Użytkownicy, którzy dołączyli przez link do edycji.
Project.mjs:84
Wyłączenie udostępniania przez link usuwa tokens i przywraca publicAccesLevel do private (ProjectDetailsHandler.mjs:233-238).
Śledzenie aktywności
Pole
Typ
Znaczenie
Źródło
lastUpdated
Date
Czas ostatniej zmiany treści lub drzewa plików. Tylko rośnie.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Użytkownik, który wprowadził tę ostatnią zmianę.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Ostatni raz, gdy ktoś otworzył projekt.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true, gdy folder projektu został usunięty po stronie Dropbox. Sam projekt nie jest usuwany; edytor wyświetla komunikat, a flaga jest czyszczona przy następnym otwarciu projektu.
Pozostałość po imporcie z overleaf.com v1. Gdy wartość jest większa niż 0, projekt jest jednorazowo wysyłany do Dropbox przy wczytaniu, a licznik jest zerowany.
Obraz TeX Live używany dla tego projektu przy kompilacjach w piaskownicy. Nowy projekt dostaje Settings.currentImageName; galeria szablonów i serwer MCP mogą go zmienić.
Dane importu z overleaf.com v1. Nieustawiane w CE. overleaf.id ma unikalny indeks.
Project.mjs:88-91
__v
Number
Klucz wersji Mongoose.
Mongoose
history-v1 może też zapisywać overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt i overleaf.backup.*, ale tylko wtedy, gdy skonfigurowano jego backupStore (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE go nie konfiguruje, więc te pola się nie pojawiają.
Indeksy
Wszystkie pochodzą z migracji oznaczonych tagiem server-ce w tools/migrations/.
Nazwa
Klucze
Opcje
Migracja
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
Uwagi
autoIndex w Mongoose jest wyłączony (services/web/app/src/infrastructure/Mongoose.mjs:7): opcje index w schemacie istnieją tylko dlatego, że tworzą je powyższe migracje.
Migracja 20250620152657_ensure_collaborator_arrays ustawia brakujące collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs i reviewer_refs na [].