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

# Kolekcja Project History Sync State

`projectHistorySyncState` zawiera jeden dokument na każdy projekt, który przeszedł ponowną synchronizację: stan bieżącej lub ostatniej ponownej synchronizacji, podczas której project-history odbudowuje historię projektu z tego, co przechowują web i docstore. Kolekcja należy do project-history i nie ma schematu Mongoose; kodem jest klasa `SyncState` i jej funkcje pomocnicze w `services/project-history/app/js/SyncManager.js`.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Tworzone przez upsert. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Projekt. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true`, dopóki project-history czeka na strukturę projektu (drzewo plików) z web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Ścieżki docs, na których zawartość jeszcze czeka. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Kto poprosił o ponowną synchronizację, na przykład domyślne `{ kind: 'history-resync' }`. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` dla twardej ponownej synchronizacji, która najpierw odrzuca zakolejkowane aktualizacje i stary stan synchronizacji. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Opcja żądania ponownej synchronizacji (`HttpController.js:963-964`). Przy twardej ponownej synchronizacji doc z uszkodzoną zawartością historii jest usuwany i ponownie dodawany z docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | Ostatnie 100 stanów, od najnowszego, każdy `{ syncState, timestamp }`; `syncState` zawiera pięć powyższych pól. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Czas ostatniego zapisu. | `SyncManager.js:209` |
| `resyncCount` | Number | Liczba uruchomionych ponownych synchronizacji. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Kiedy rozpoczęła się bieżąca ponowna synchronizacja; usuwane po jej zakończeniu. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Ustawiane na 90 dni po zakończeniu ponownej synchronizacji i usuwane, gdy jakaś trwa. Indeks TTL usuwa dokument w tym czasie. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Ile razy zawieszona ponowna synchronizacja została wyczyszczona i uruchomiona ponownie; usuwane po zakończeniu ponownej synchronizacji. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Czas ostatniego takiego czyszczenia. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Ścieżki docs, które przy ostatnim czyszczeniu nadal oczekiwały. | `SyncManager.js:262`, `228` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert stanu. Wywoływane, gdy rozpoczyna się ponowna synchronizacja (`SyncManager.js:163`), oraz gdy project-history przetwarza aktualizacje ponownej synchronizacji (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: zlicza wyczyszczoną zawieszoną ponowną synchronizację. |
| `SyncManager.js:251-255` | `clearResyncState`: usuwa dokument na początku twardej ponownej synchronizacji (`SyncManager.js:87`), przy `DELETE /project/:project_id` w project-history (`services/project-history/app/js/HttpController.js:1363-1396`) oraz gdy ponowna synchronizacja samej struktury musi zacząć się od nowa (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: usuwa zakończony stan, którego cała historia jest nowsza niż podana data. Nic w `app/js` tego nie wywołuje. |
| `SyncManager.js:171-181` | `cloneResyncState`: kopiuje stan do innego projektu, dla `POST /project/:project_id/clone` w project-history (`HttpController.js:57`, `124`), czego nic w web nie wywołuje. |

Ponowną synchronizację uruchamiają `POST /project/:project_id/resync` w project-history (`HttpController.js:950-994`), zadania cron ponawiania (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) oraz sam project-history, gdy przetwarzanie aktualizacji jej wymaga (`UpdatesProcessor.js:75`, `224`).

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: wczytuje stan. Służy do sprawdzenia przed uruchomieniem nowej ponownej synchronizacji, czy jakaś już trwa (`SyncManager.js:106-149`), do pomijania zwykłych aktualizacji w jej trakcie (`SyncManager.js:291-300`) oraz po flushu do zgłoszenia trwającej ponownej synchronizacji (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: czy ponowna synchronizacja trwa lub jest zawieszona. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: stan synchronizacji wraz z rekordem błędu. |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `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` |

#### Uwagi

* Ponowna synchronizacja trwa, dopóki `resyncProjectStructure` ma wartość `true` lub `resyncDocContents` nie jest puste (`SyncManager.js:565-567`). Po 4 godzinach uznaje się ją za zawieszoną, a po 5 czyszczeniach za trwale zawieszoną (`SyncManager.js:43-44`, `569-585`).
* Po zakończeniu ponownej synchronizacji project-history ustawia też w projekcie `overleaf.history.lastResyncedAt` (`SyncManager.js:239-248`).


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