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

`projectHistorySyncState` bevat één document per project dat opnieuw is gesynchroniseerd: de toestand van de huidige of laatste resync, waarbij project-history de geschiedenis van een project opnieuw opbouwt uit wat web en docstore bevatten. De collectie is van project-history en heeft geen Mongoose-schema; de code is de klasse `SyncState` en de hulpfuncties ervan in `services/project-history/app/js/SyncManager.js`.

#### Velden

| Veld | Type | Betekenis | Bron |
| - | - | - | - |
| `_id` | ObjectId | Aangemaakt door de upsert. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Het project. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true` zolang project-history wacht op de projectstructuur (bestandsboom) van web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Paden van de docs waarvan het nog op de inhoud wacht. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Wie om de resync heeft gevraagd, bijvoorbeeld `{ kind: 'history-resync' }`, de standaard. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` voor een harde resync, die eerst de updates in de wachtrij en de oude synchronisatietoestand weggooit. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Optie van het resyncverzoek (`HttpController.js:963-964`). Bij een harde resync wordt een doc waarvan de geschiedenisinhoud beschadigd is verwijderd en opnieuw toegevoegd vanuit docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | De laatste 100 toestanden, nieuwste eerst, elk `{ syncState, timestamp }`; `syncState` bevat de vijf velden hierboven. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Tijdstip van de laatste schrijfbewerking. | `SyncManager.js:209` |
| `resyncCount` | Number | Aantal gestarte resyncs. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Wanneer de lopende resync begon; wordt verwijderd als die klaar is. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Ingesteld op 90 dagen nadat een resync klaar is, en verwijderd terwijl er een loopt. De TTL-index verwijdert het document op dat tijdstip. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Hoe vaak een vastgelopen resync is gewist en opnieuw gestart; wordt verwijderd als een resync klaar is. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Tijdstip van de laatste zulke wisactie. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Docpaden die bij de laatste wisactie nog openstonden. | `SyncManager.js:262`, `228` |

#### Wie schrijft

| Code | Wat het doet |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert van de toestand. Aangeroepen wanneer een resync start (`SyncManager.js:163`) en terwijl project-history de resyncupdates verwerkt (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: telt een vastgelopen resync die wordt gewist. |
| `SyncManager.js:251-255` | `clearResyncState`: verwijdert het document, aan het begin van een harde resync (`SyncManager.js:87`), bij project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1363-1396`) en wanneer een resync van alleen de structuur opnieuw moet beginnen (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: verwijdert een voltooide toestand waarvan de hele geschiedenis nieuwer is dan een datum. Niets in `app/js` roept het aan. |
| `SyncManager.js:171-181` | `cloneResyncState`: kopieert de toestand naar een ander project, voor project-history `POST /project/:project_id/clone` (`HttpController.js:57`, `124`), dat niets in web aanroept. |

Een resync wordt gestart door project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), door de cronjobs voor nieuwe pogingen (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) en door project-history zelf wanneer de verwerking van updates er een nodig heeft (`UpdatesProcessor.js:75`, `224`).

#### Wie leest

| Code | Wat het doet |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: laadt de toestand. Gebruikt om vóór het starten van een nieuwe resync te bepalen of er al een loopt (`SyncManager.js:106-149`), om gewone updates over te slaan zolang die loopt (`SyncManager.js:291-300`) en om na een flush een lopende resync te melden (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: of een resync loopt of vastzit. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: de synchronisatietoestand met het foutrecord. |

#### Indexen

| Naam | Sleutels | Opties | Migratie |
| - | - | - | - |
| `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` |

#### Opmerkingen

* Een resync loopt zolang `resyncProjectStructure` `true` is of `resyncDocContents` niet leeg is (`SyncManager.js:565-567`). Na 4 uur geldt hij als vastgelopen, en na 5 wisacties als permanent vastgelopen (`SyncManager.js:43-44`, `569-585`).
* Wanneer een resync klaar is, stelt project-history ook `overleaf.history.lastResyncedAt` in op het project (`SyncManager.js:239-248`).


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