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

# Kolekce Project History Sync State

`projectHistorySyncState` obsahuje jeden dokument na každý projekt, který prošel opětovnou synchronizací: stav probíhající nebo poslední opětovné synchronizace, při níž project-history znovu sestavuje historii projektu z toho, co uchovávají web a docstore. Kolekce patří project-history a nemá schéma Mongoose; kódem je třída `SyncState` a její pomocné funkce v `services/project-history/app/js/SyncManager.js`.

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Vytvořeno upsertem. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Projekt. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true`, dokud project-history čeká na strukturu projektu (strom souborů) z web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Cesty docs, na jejichž obsah ještě čeká. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Kdo opětovnou synchronizaci vyžádal, například výchozí `{ kind: 'history-resync' }`. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` pro tvrdou opětovnou synchronizaci, která nejprve zahodí aktualizace ve frontě a starý stav synchronizace. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Volba požadavku na opětovnou synchronizaci (`HttpController.js:963-964`). Při tvrdé opětovné synchronizaci se doc s poškozeným obsahem historie odstraní a znovu přidá z docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | Posledních 100 stavů, nejnovější první, každý `{ syncState, timestamp }`; `syncState` obsahuje pět výše uvedených polí. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Čas posledního zápisu. | `SyncManager.js:209` |
| `resyncCount` | Number | Počet spuštěných opětovných synchronizací. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Kdy začala probíhající opětovná synchronizace; po jejím dokončení se odstraní. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Nastaví se na 90 dní po dokončení opětovné synchronizace a odstraní se, dokud nějaká běží. TTL index v tomto čase dokument smaže. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Kolikrát byla zaseknutá opětovná synchronizace vymazána a znovu spuštěna; odstraní se po dokončení opětovné synchronizace. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Čas posledního takového vymazání. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Cesty docs, které při posledním vymazání ještě čekaly. | `SyncManager.js:262`, `228` |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert stavu. Volá se při spuštění opětovné synchronizace (`SyncManager.js:163`) a během zpracování jejích aktualizací v project-history (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: započítá vymazanou zaseknutou opětovnou synchronizaci. |
| `SyncManager.js:251-255` | `clearResyncState`: smaže dokument na začátku tvrdé opětovné synchronizace (`SyncManager.js:87`), při `DELETE /project/:project_id` v project-history (`services/project-history/app/js/HttpController.js:1363-1396`) a když musí opětovná synchronizace jen struktury začít znovu (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: smaže dokončený stav, jehož celá historie je novější než dané datum. Nic v `app/js` to nevolá. |
| `SyncManager.js:171-181` | `cloneResyncState`: zkopíruje stav do jiného projektu pro `POST /project/:project_id/clone` v project-history (`HttpController.js:57`, `124`), které nic ve web nevolá. |

Opětovnou synchronizaci spouští `POST /project/:project_id/resync` v project-history (`HttpController.js:950-994`), úlohy cron pro opakování (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) a samotné project-history, když ji zpracování aktualizací potřebuje (`UpdatesProcessor.js:75`, `224`).

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: načte stav. Používá se k rozhodnutí, zda už opětovná synchronizace běží, než se spustí nová (`SyncManager.js:106-149`), k přeskakování běžných aktualizací během jejího běhu (`SyncManager.js:291-300`) a po flushi k nahlášení probíhající opětovné synchronizace (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: zda opětovná synchronizace běží nebo je zaseknutá. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: stav synchronizace se záznamem o selhání. |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `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` |

#### Poznámky

* Opětovná synchronizace běží, dokud je `resyncProjectStructure` `true` nebo `resyncDocContents` není prázdné (`SyncManager.js:565-567`). Po 4 hodinách se považuje za zaseknutou a po 5 vymazáních za trvale zaseknutou (`SyncManager.js:43-44`, `569-585`).
* Po dokončení opětovné synchronizace nastaví project-history v projektu také `overleaf.history.lastResyncedAt` (`SyncManager.js:239-248`).


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