> ## 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.

# Project History Sync State Koleksiyonu

`projectHistorySyncState`, yeniden eşitlenmiş her proje için bir belge tutar: project-history'nin bir projenin geçmişini web ve docstore'un tuttuklarından yeniden oluşturduğu, devam eden veya son yeniden eşitlemenin durumu. Koleksiyonun sahibi project-history'dir ve Mongoose şeması yoktur; kod, `services/project-history/app/js/SyncManager.js` içindeki `SyncState` sınıfı ve yardımcılarıdır.

#### Alanlar

| Alan | Tür | Anlam | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Upsert tarafından oluşturulur. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Proje. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | project-history web'den proje yapısını (dosya ağacı) beklerken `true`. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | İçeriğini hâlâ beklediği doc'ların yolları. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Yeniden eşitlemeyi kimin istediği, örneğin varsayılan olan `{ kind: 'history-resync' }`. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | Önce kuyruktaki güncellemeleri ve eski eşitleme durumunu atan sert yeniden eşitleme için `true`. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Yeniden eşitleme isteğinin seçeneği (`HttpController.js:963-964`). Sert bir yeniden eşitlemede, geçmiş içeriği bozuk olan bir doc kaldırılır ve docstore'dan yeniden eklenir (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | En yenisi önce olmak üzere son 100 durum, her biri `{ syncState, timestamp }`; `syncState` yukarıdaki beş alanı içerir. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Son yazma zamanı. | `SyncManager.js:209` |
| `resyncCount` | Number | Başlatılan yeniden eşitleme sayısı. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Devam eden yeniden eşitlemenin başladığı zaman; bittiğinde kaldırılır. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Bir yeniden eşitleme bittikten 90 gün sonrasına ayarlanır, biri çalışırken kaldırılır. TTL indeksi belgeyi bu zamanda siler. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Takılan bir yeniden eşitlemenin kaç kez temizlenip yeniden başlatıldığı; bir yeniden eşitleme bittiğinde kaldırılır. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Bu tür son temizlemenin zamanı. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Son temizlemede hâlâ bekleyen doc yolları. | `SyncManager.js:262`, `228` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: durumun upsert edilmesi. Bir yeniden eşitleme başladığında (`SyncManager.js:163`) ve project-history yeniden eşitleme güncellemelerini işlerken (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`) çağrılır. |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: temizlenen takılmış bir yeniden eşitlemeyi sayar. |
| `SyncManager.js:251-255` | `clearResyncState`: belgeyi siler; sert bir yeniden eşitlemenin başında (`SyncManager.js:87`), project-history `DELETE /project/:project_id` sırasında (`services/project-history/app/js/HttpController.js:1363-1396`) ve yalnızca yapı için yapılan bir yeniden eşitlemenin baştan başlaması gerektiğinde (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: geçmişinin tamamı bir tarihten yeni olan tamamlanmış bir durumu siler. `app/js` içinde onu çağıran bir şey yoktur. |
| `SyncManager.js:171-181` | `cloneResyncState`: project-history `POST /project/:project_id/clone` için (`HttpController.js:57`, `124`) durumu başka bir projeye kopyalar; web'de bunu çağıran bir şey yoktur. |

Bir yeniden eşitleme; project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), yeniden deneme cron işleri (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) ve güncellemeleri işlerken gerektiğinde project-history'nin kendisi (`UpdatesProcessor.js:75`, `224`) tarafından başlatılır.

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: durumu yükler. Yenisi başlamadan önce bir yeniden eşitlemenin çalışıp çalışmadığına karar vermek (`SyncManager.js:106-149`), çalışırken sıradan güncellemeleri atlamak (`SyncManager.js:291-300`) ve bir flush sonrasında devam eden bir yeniden eşitlemeyi bildirmek (`UpdatesProcessor.js:463-466`) için kullanılır. |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: bir yeniden eşitlemenin çalışıp çalışmadığı veya takılıp takılmadığı. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: hata kaydıyla birlikte eşitleme durumu. |

#### İndeksler

| Ad | Anahtarlar | Seçenekler | Migration |
| - | - | - | - |
| `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` |

#### Notlar

* `resyncProjectStructure` `true` olduğu veya `resyncDocContents` boş olmadığı sürece bir yeniden eşitleme çalışıyordur (`SyncManager.js:565-567`). 4 saatten sonra takılmış, 5 temizlemeden sonra kalıcı olarak takılmış sayılır (`SyncManager.js:43-44`, `569-585`).
* Bir yeniden eşitleme bittiğinde project-history projede `overleaf.history.lastResyncedAt` alanını da ayarlar (`SyncManager.js:239-248`).


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