projectHistoryChunks, her geçmiş chunk’ı için bir belge tutar; chunk, bir projenin geçmişindeki bir dizi sürümdür. Mongo yalnızca chunk’ın meta verilerini tutar; chunk’ın kendisi (bir anlık görüntü ve ondan sonraki değişiklikler) chunks bucket’ında gzip ile sıkıştırılmış bir JSON nesnesidir. Mongoose şeması yoktur: history-v1 koleksiyonu services/history-v1/storage/lib/chunk_store/mongo.js içinde yazar ve CE’de olduğu gibi 24 onaltılık karakterli her geçmiş kimliği için bunu kullanır (services/history-v1/storage/lib/chunk_store/index.js:644-652).
Alanlar
Kim yazar
Yeni chunk’lar project-history’den gelir; project-history kuyruktaki düzenlemeleri history-v1
POST /projects/:project_id/legacy_changes adresine gönderir (services/history-v1/api/routes/project_import.js:29-31); history-v1 ardından chunkStore.update veya chunkStore.create çağırır (services/history-v1/storage/lib/persist_changes.js:215, 229). Yeni bir proje ilk chunk’ını chunkStore.initializeProject üzerinden alır (chunk_store/index.js:54-80).
Kim okur
İndeksler
Notlar
- Durum akışı:
pending(kayıt yazıldı, yükleme sürüyor) →active(en son chunk, hâlâ genişletilebilir) →closed(ardından daha yeni bir chunk geliyor) veyadeleted(yerine başkası geçti ya da proje silindi). Okumalar yalnızcaactivevecloseddurumlarına bakar. - Chunk nesnesi gzip ile sıkıştırılmış JSON’dur (
services/history-v1/storage/lib/history_store.js:151-170) ve<project key>/<chunk id>anahtarındadır (history_store.js:65-67). Proje anahtarı, sıfırlarla doldurulmuş geçmiş kimliğinin ters çevrilip 3/3/kalan karakter olarak bölünmüş halidir (libraries/object-persistor/src/ProjectKey.js:8-15). BucketOVERLEAF_EDITOR_CHUNKS_BUCKETdeğeridir (services/history-v1/config/custom-environment-variables.json:53-56): geliştirme ortamında/buckets/chunks(develop/docker-compose.yml:90),S3_ENABLED=trueileoverleaf-chunks(develop/s3/docker-compose.yml:51). deletedveyapendingdurumundaki kayıtlar ve bucket nesneleri yalnızcadelete_old_chunks.jstarafından kaldırılır (yarn delete_old_chunks,services/history-v1/package.json:79). CE imajında bunun için bir cron işi yoktur (server-ce/config/crontab-history,server-ce/config/crontab-deletion), bu nedenle CE’de kalırlar.- Web silinmiş bir projenin süresini doldurduğunda history-v1
DELETE /projects/:history_idçağırır (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391,HistoryManager.mjs:127-135,152-162); bu, projenin tüm chunk’larınıdeletedolarak işaretler. - Bir
backupStoreyapılandırılmışsa, bir chunk’ı onaylamak projeye ayrıcaoverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtveoverleaf.backup.pendingChangeAtyazar (mongo.js:232-262). CEbackupStoreyapılandırmaz, bu yüzdenmongo.js:238-240erken döner.

