projects, proje başına bir belge tutar: ad, sahip ve üyeler, paylaşım, dosya ağacı ve proje ayarları. Belgelerin metni burada değildir (bkz. Docs Koleksiyonu) ve ikili dosyalar history-v1 blob deposunda kendi hash değerleri altında durur. Şema services/web/app/src/models/Project.mjs dosyasıdır; dosya ağacı yanındaki Folder.mjs, File.mjs ve Doc.mjs dosyalarındadır.Kaynak sütununda Project.mjs:N bu şemanın bir satırıdır, yolu olmayan diğer dosya adları services/web/app/src/Features/ altında, modules/... ise services/web/ altındadır. Satır numaraları yazım anındaki server-pro sürümünden alınmıştır.
Temel Tanımlama ve Meta Veriler
Alan
Tür
Anlamı
Kaynak
_id
ObjectId
Projenin id’si.
MongoDB
name
String
Proje adı.
Project.mjs:18
description
String
Proje açıklaması. Varsayılan olarak boş.
Project.mjs:50
version
Number
Dosya ağacındaki her değişiklikte (ekleme, yeniden adlandırma, taşıma, silme, değiştirme) 1 artar.
Proje devre dışı bırakıldıktan sonra false olur: belgeleri Mongo dışına arşivlenmiştir (docs.inS3). Projeyi açmak arşivden çıkarır ve değeri yeniden true yapar. CE’de eski projeleri devre dışı bırakan cron yalnızca ENABLE_CRON_RESOURCE_DELETION=true ile çalışır.
Eski alan, { _id, name, deletedAt }. Silinen belgeler artık deleted: true ile docs içinde kalır. Bu dizi yalnızca eski bir silinmiş proje geri yüklenirken okunur: girdiler docstore’a kopyalanır ve dizi boşaltılır. Hiçbir şey ona yazmaz.
Yalnızca şemada: CE çekirdeği ve modüllerimiz bunu kullanmaz.
Project.mjs:28
Sahiplik ve Erişim Denetimi
Alan
Tür
Anlamı
Kaynak
owner_ref
ObjectId
Sahip.
Project.mjs:29
collaberator_refs
Array of ObjectId
Düzenleyebilen kullanıcılar (bu yazım alanın gerçek adıdır).
Project.mjs:30
reviewer_refs
Array of ObjectId
İnceleyebilen kullanıcılar: yorum yapabilir ve değişiklik izleme ile öneride bulunabilir.
Project.mjs:31
readOnly_refs
Array of ObjectId
Yalnızca görüntüleyebilen kullanıcılar.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Davetler değildir (onlar projectInvites içindedir). Sahibin boş ortak çalışan yeri yokken düzenleyici veya gözden geçiren olarak eklenen kullanıcılar. readOnly_refs alanına eklenir ve yükseltilebilene kadar burada listelenirler.
Daha fazla erişim isteyen görüntüleyenler: userId, privilegeLevel, requestedAt. Kullanıcı başına bir girdi. İstek kabul edildiğinde, reddedildiğinde veya kullanıcı projeden ayrıldığında kaldırılır.
Değişiklik izleme durumu. true herkes için açık anlamına gelir (eski biçim); aksi halde, kullanıcı id’lerini anahtar olarak kullanan ve açık olan her kullanıcı için true içeren bir nesnedir. track-changes modülü bunu yazar; çekirdek ise gözden geçiren yapılan bir kullanıcı için açar.
private veya tokenBased (bağlantıyla paylaşım açık). Eski projelerde hâlâ eski readOnly veya readAndWrite değerleri olabilir. public diye bir değer yoktur. Bu yazım alanın gerçek adıdır.
Düzenleme belirtecinin sayısal öneki; belirteci aramak için kullanılır. Benzersiz.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Salt görüntüleme bağlantısıyla katılan kullanıcılar (belirteçler değil, kullanıcı id’leri).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Düzenleme bağlantısıyla katılan kullanıcılar.
Project.mjs:84
Bağlantıyla paylaşımı kapatmak tokens alanını kaldırır ve publicAccesLevel değerini yeniden private yapar (ProjectDetailsHandler.mjs:233-238).
Etkinlik Takibi
Alan
Tür
Anlamı
Kaynak
lastUpdated
Date
İçerikte veya dosya ağacında yapılan son değişikliğin zamanı. Yalnızca ileri gider.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Bu son değişikliği yapan kullanıcı.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Birinin projeyi en son açtığı zaman.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
Proje klasörü Dropbox tarafında silindiğinde true olur. Projenin kendisi silinmez; düzenleyici bir uyarı gösterir ve proje bir sonraki açılışında bayrak temizlenir.
Bağlantılı dosyalar için ayarlanır (bir URL’den, başka bir projeden, bir çıktı dosyasından, Zotero veya Mendeley’den): provider, kaynak verileri ve importedAt.
Bu projenin korumalı alan derlemelerinde kullanılan TeX Live imajı. Yeni bir proje Settings.currentImageName değerini alır; şablon galerisi ve MCP sunucusu bunu değiştirebilir.
overleaf.com v1 içe aktarım verileri. CE’de ayarlanmaz. overleaf.id benzersiz bir dizine sahiptir.
Project.mjs:88-91
__v
Number
Mongoose sürüm anahtarı.
Mongoose
history-v1 ayrıca overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt ve overleaf.backup.* alanlarını da yazabilir, ancak yalnızca backupStore yapılandırıldığında (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE bunu yapılandırmaz, bu yüzden bu alanlar görünmez.
Dizinler
Hepsi tools/migrations/ içindeki server-ce etiketli taşımalardan gelir.
Ad
Anahtarlar
Seçenekler
Taşıma
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
Notlar
Mongoose autoIndex kapalıdır (services/web/app/src/infrastructure/Mongoose.mjs:7): şemadaki index seçenekleri yalnızca yukarıdaki taşımalar onları oluşturduğu için vardır.
20250620152657_ensure_collaborator_arrays taşıması eksik collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs ve reviewer_refs alanlarını [] olarak ayarlar.