projects menyimpan satu dokumen per proyek: nama, pemilik dan anggota, berbagi, pohon berkas, dan pengaturan proyek. Teks dokumen tidak ada di sini (lihat Koleksi Docs), dan berkas biner berada di penyimpanan blob history-v1 di bawah hash-nya. Skemanya adalah services/web/app/src/models/Project.mjs, dengan pohon berkas di Folder.mjs, File.mjs, dan Doc.mjs di sebelahnya.Di kolom Sumber, Project.mjs:N adalah satu baris skema tersebut, nama berkas lain tanpa jalur berada di bawah services/web/app/src/Features/, dan modules/... berada di bawah services/web/. Nomor baris berasal dari server-pro pada saat penulisan.
Identifikasi Inti & Metadata
Bidang
Tipe
Arti
Sumber
_id
ObjectId
Id proyek.
MongoDB
name
String
Nama proyek.
Project.mjs:18
description
String
Deskripsi proyek. Kosong secara default.
Project.mjs:50
version
Number
Bertambah 1 pada setiap perubahan pohon berkas (tambah, ubah nama, pindah, hapus, ganti).
false setelah proyek dinonaktifkan: dokumennya telah diarsipkan keluar dari Mongo (docs.inS3). Membuka proyek akan mengeluarkannya dari arsip dan mengembalikan nilainya ke true. Di CE, cron yang menonaktifkan proyek lama hanya berjalan dengan ENABLE_CRON_RESOURCE_DELETION=true.
Pengguna yang mengarsipkan proyek. Pengarsipan berlaku per pengguna. Nilai boolean lama dikonversi oleh migrasi 20221111111111_ce_sp_convert_archived_state.
Lama, { _id, name, deletedAt }. Dokumen yang dihapus kini tetap berada di docs dengan deleted: true. Array ini hanya dibaca saat proyek lama yang dihapus dipulihkan: entri disalin ke docstore dan array dikosongkan. Tidak ada yang menulis ke dalamnya.
Hanya ada di skema: inti CE dan modul kami tidak menggunakannya.
Project.mjs:28
Kepemilikan & Kontrol Akses
Bidang
Tipe
Arti
Sumber
owner_ref
ObjectId
Pemilik.
Project.mjs:29
collaberator_refs
Array of ObjectId
Pengguna yang dapat mengedit (ejaan ini adalah nama bidang yang sebenarnya).
Project.mjs:30
reviewer_refs
Array of ObjectId
Pengguna yang dapat meninjau: berkomentar dan memberi saran dengan pelacakan perubahan.
Project.mjs:31
readOnly_refs
Array of ObjectId
Pengguna yang hanya dapat melihat.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
Bukan undangan (undangan ada di projectInvites). Pengguna yang ditambahkan sebagai editor atau peninjau ketika pemilik tidak memiliki slot kolaborator kosong. Mereka ditambahkan ke readOnly_refs dan dicantumkan di sini sampai dapat ditingkatkan.
Penonton yang meminta akses lebih: userId, privilegeLevel, requestedAt. Satu entri per pengguna. Dihapus ketika permintaan dikabulkan, ditolak, atau pengguna keluar dari proyek.
Status pelacakan perubahan. true berarti aktif untuk semua orang (format lama); jika tidak, berupa objek dengan id pengguna sebagai kunci dan true untuk setiap pengguna yang mengaktifkannya. Modul track-changes menulisnya, dan inti mengaktifkannya untuk pengguna yang dijadikan peninjau.
Tautan IEEE Collabratec: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. Tidak digunakan di CE.
Project.mjs:104-116
Berbagi Tautan
Bidang
Tipe
Arti
Sumber
publicAccesLevel
String
private atau tokenBased (berbagi tautan aktif). Proyek lama mungkin masih memiliki nilai lama readOnly atau readAndWrite. Tidak ada public. Ejaan ini adalah nama bidang yang sebenarnya.
Prefiks numerik token edit, digunakan untuk mencari token. Unik.
Project.mjs:73-81, TokenAccessHandler.mjs:120
tokenAccessReadOnly_refs
Array of ObjectId
Pengguna yang bergabung melalui tautan khusus lihat (id pengguna, bukan token).
Project.mjs:83
tokenAccessReadAndWrite_refs
Array of ObjectId
Pengguna yang bergabung melalui tautan edit.
Project.mjs:84
Menonaktifkan berbagi tautan akan menghapus tokens dan mengembalikan publicAccesLevel ke private (ProjectDetailsHandler.mjs:233-238).
Pelacakan Aktivitas
Bidang
Tipe
Arti
Sumber
lastUpdated
Date
Waktu perubahan terakhir pada konten atau pohon berkas. Hanya bergerak maju.
Project.mjs:19, ProjectUpdateHandler.mjs:5-17
lastUpdatedBy
ObjectId
Pengguna yang membuat perubahan terakhir tersebut.
Project.mjs:25, ProjectUpdateHandler.mjs:17
lastOpened
Date
Terakhir kali seseorang membuka proyek.
Project.mjs:26, ProjectUpdateHandler.mjs:24
deletedByExternalDataSource
Boolean
true ketika folder proyek dihapus di sisi Dropbox. Proyeknya sendiri tidak dihapus; editor menampilkan pemberitahuan dan penanda dihapus saat proyek dibuka berikutnya.
Image TeX Live yang digunakan untuk proyek ini dengan kompilasi sandbox. Proyek baru mendapatkan Settings.currentImageName; galeri templat dan server MCP dapat mengubahnya.
Data impor overleaf.com v1. Tidak diatur di CE. overleaf.id memiliki indeks unik.
Project.mjs:88-91
__v
Number
Kunci versi Mongoose.
Mongoose
history-v1 juga dapat menulis overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt, dan overleaf.backup.*, tetapi hanya jika backupStore-nya dikonfigurasi (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE tidak mengonfigurasinya, sehingga bidang-bidang ini tidak muncul.
Indeks
Semuanya berasal dari migrasi bertag server-ce di tools/migrations/.
Nama
Kunci
Opsi
Migrasi
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
Catatan
autoIndex Mongoose dinonaktifkan (services/web/app/src/infrastructure/Mongoose.mjs:7): opsi index di skema hanya ada karena migrasi di atas membuatnya.
Migrasi 20250620152657_ensure_collaborator_arrays mengatur collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs, dan reviewer_refs yang tidak ada menjadi [].