> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Koleksi Project History Sync State

`projectHistorySyncState` menyimpan satu dokumen per proyek yang pernah disinkronkan ulang: status sinkronisasi ulang yang sedang berjalan atau yang terakhir, ketika project-history membangun ulang riwayat proyek dari apa yang disimpan web dan docstore. Koleksi ini dimiliki project-history dan tidak memiliki skema Mongoose; kodenya adalah kelas `SyncState` beserta fungsi pembantunya di `services/project-history/app/js/SyncManager.js`.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Dibuat oleh upsert. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Proyeknya. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true` selama project-history menunggu struktur proyek (pohon file) dari web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Path doc yang isinya masih ditunggu. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Siapa yang meminta sinkronisasi ulang, misalnya `{ kind: 'history-resync' }`, nilai bawaan. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` untuk sinkronisasi ulang keras, yang lebih dulu membuang pembaruan yang mengantre dan status sinkronisasi lama. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Opsi permintaan sinkronisasi ulang (`HttpController.js:963-964`). Dalam sinkronisasi ulang keras, doc yang isi riwayatnya rusak dihapus lalu ditambahkan lagi dari docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | 100 status terakhir, terbaru lebih dulu, masing-masing `{ syncState, timestamp }`; `syncState` berisi lima field di atas. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Waktu penulisan terakhir. | `SyncManager.js:209` |
| `resyncCount` | Number | Jumlah sinkronisasi ulang yang dimulai. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Kapan sinkronisasi ulang yang berjalan dimulai; dihapus saat selesai. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Diatur ke 90 hari setelah sinkronisasi ulang selesai, dihapus selama ada yang berjalan. Indeks TTL menghapus dokumen pada waktu ini. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Berapa kali sinkronisasi ulang yang macet dibersihkan dan dimulai ulang; dihapus saat sinkronisasi ulang selesai. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Waktu pembersihan semacam itu yang terakhir. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Path doc yang masih tertunda saat pembersihan terakhir. | `SyncManager.js:262`, `228` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert status. Dipanggil saat sinkronisasi ulang dimulai (`SyncManager.js:163`) dan selama project-history memproses pembaruan sinkronisasi ulang (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: menghitung sinkronisasi ulang macet yang dibersihkan. |
| `SyncManager.js:251-255` | `clearResyncState`: menghapus dokumen di awal sinkronisasi ulang keras (`SyncManager.js:87`), pada project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1363-1396`), dan ketika sinkronisasi ulang yang hanya untuk struktur harus dimulai ulang (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: menghapus status selesai yang seluruh riwayatnya lebih baru dari suatu tanggal. Tidak ada apa pun di `app/js` yang memanggilnya. |
| `SyncManager.js:171-181` | `cloneResyncState`: menyalin status ke proyek lain, untuk project-history `POST /project/:project_id/clone` (`HttpController.js:57`, `124`), yang tidak dipanggil apa pun di web. |

Sinkronisasi ulang dimulai oleh project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), oleh cron job percobaan ulang (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`), dan oleh project-history sendiri ketika pemrosesan pembaruan membutuhkannya (`UpdatesProcessor.js:75`, `224`).

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: memuat status. Digunakan untuk memutuskan apakah sinkronisasi ulang sedang berjalan sebelum yang baru dimulai (`SyncManager.js:106-149`), untuk melewati pembaruan biasa selama berjalan (`SyncManager.js:291-300`), dan setelah flush untuk melaporkan sinkronisasi ulang yang sedang berjalan (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: apakah sinkronisasi ulang sedang berjalan atau macet. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: status sinkronisasi beserta catatan kegagalan. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145021_create_projectHistorySyncState_indexes.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0` | `tools/migrations/20190912145021_create_projectHistorySyncState_indexes.mjs` |

#### Catatan

* Sinkronisasi ulang berjalan selama `resyncProjectStructure` bernilai `true` atau `resyncDocContents` tidak kosong (`SyncManager.js:565-567`). Ia dianggap macet setelah 4 jam, dan macet permanen setelah 5 kali pembersihan (`SyncManager.js:43-44`, `569-585`).
* Saat sinkronisasi ulang selesai, project-history juga mengatur `overleaf.history.lastResyncedAt` pada proyek (`SyncManager.js:239-248`).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.