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

`projectHistorySyncState` indeholder ét dokument pr. projekt, der er blevet resynkroniseret: tilstanden for den igangværende eller seneste resynkronisering, når project-history genopbygger et projekts historik ud fra det, web og docstore indeholder. Samlingen ejes af project-history og har intet Mongoose-skema; koden er klassen `SyncState` og dens hjælpefunktioner i `services/project-history/app/js/SyncManager.js`.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Oprettes af upserten. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Projektet. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true`, mens project-history venter på projektstrukturen (filtræet) fra web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Stier til de docs, hvis indhold den stadig venter på. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Hvem der bad om resynkroniseringen, for eksempel `{ kind: 'history-resync' }`, standardværdien. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` for en hård resynkronisering, som først kasserer køede opdateringer og den gamle synkroniseringstilstand. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Indstilling i resynkroniseringsanmodningen (`HttpController.js:963-964`). Ved en hård resynkronisering fjernes et doc med beskadiget historikindhold og tilføjes igen fra docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | De seneste 100 tilstande, nyeste først, hver `{ syncState, timestamp }`; `syncState` indeholder de fem felter ovenfor. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Tidspunktet for seneste skrivning. | `SyncManager.js:209` |
| `resyncCount` | Number | Antal startede resynkroniseringer. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Hvornår den igangværende resynkronisering startede; fjernes, når den er færdig. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Sættes til 90 dage efter, at en resynkronisering er færdig, og fjernes, mens en kører. TTL-indekset sletter dokumentet på dette tidspunkt. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Hvor ofte en fastlåst resynkronisering er ryddet og startet igen; fjernes, når en resynkronisering er færdig. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Tidspunktet for seneste sådan rydning. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Doc-stier, der stadig ventede ved seneste rydning. | `SyncManager.js:262`, `228` |

#### Hvem skriver

| Kode | Hvad den gør |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert af tilstanden. Kaldes, når en resynkronisering starter (`SyncManager.js:163`), og mens project-history behandler resynkroniseringens opdateringer (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: tæller en fastlåst resynkronisering, der ryddes. |
| `SyncManager.js:251-255` | `clearResyncState`: sletter dokumentet ved starten af en hård resynkronisering (`SyncManager.js:87`), ved project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1363-1396`) og når en resynkronisering af kun strukturen skal starte forfra (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: sletter en afsluttet tilstand, hvis hele historik er nyere end en dato. Intet i `app/js` kalder den. |
| `SyncManager.js:171-181` | `cloneResyncState`: kopierer tilstanden til et andet projekt, til project-history `POST /project/:project_id/clone` (`HttpController.js:57`, `124`), som intet i web kalder. |

En resynkronisering startes af project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), af cronjobbene til nye forsøg (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) og af project-history selv, når behandlingen af opdateringer kræver en (`UpdatesProcessor.js:75`, `224`).

#### Hvem læser

| Kode | Hvad den gør |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: indlæser tilstanden. Bruges til at afgøre, om en resynkronisering kører, før en ny starter (`SyncManager.js:106-149`), til at springe almindelige opdateringer over, mens den kører (`SyncManager.js:291-300`), og efter en flush til at rapportere en igangværende resynkronisering (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: om en resynkronisering kører eller er gået i stå. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: synkroniseringstilstanden med fejlposten. |

#### Indekser

| Navn | Nøgler | Indstillinger | Migrering |
| - | - | - | - |
| `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` |

#### Bemærkninger

* En resynkronisering kører, så længe `resyncProjectStructure` er `true` eller `resyncDocContents` ikke er tom (`SyncManager.js:565-567`). Den regnes som fastlåst efter 4 timer og som permanent fastlåst efter 5 rydninger (`SyncManager.js:43-44`, `569-585`).
* Når en resynkronisering er færdig, sætter project-history også `overleaf.history.lastResyncedAt` på projektet (`SyncManager.js:239-248`).


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