> ## 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` inneholder ett dokument per prosjekt som er blitt resynkronisert: tilstanden til den pågående eller siste resynkroniseringen, når project-history bygger opp et prosjekts historikk på nytt fra det web og docstore inneholder. Samlingen eies av project-history og har ikke noe Mongoose-skjema; koden er klassen `SyncState` og hjelpefunksjonene dens i `services/project-history/app/js/SyncManager.js`.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Opprettes av upserten. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Prosjektet. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true` mens project-history venter på prosjektstrukturen (filtreet) fra web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Stier til docs som den fortsatt venter på innholdet til. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Hvem som ba om resynkroniseringen, for eksempel `{ kind: 'history-resync' }`, standardverdien. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` for en hard resynkronisering, som først forkaster køede oppdateringer og den gamle synkroniseringstilstanden. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Alternativ i resynkroniseringsforespørselen (`HttpController.js:963-964`). Ved en hard resynkronisering fjernes et doc med skadet historikkinnhold og legges til igjen fra docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | De siste 100 tilstandene, nyeste først, hver `{ syncState, timestamp }`; `syncState` inneholder de fem feltene ovenfor. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Tidspunktet for siste skriving. | `SyncManager.js:209` |
| `resyncCount` | Number | Antall startede resynkroniseringer. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Når den pågående resynkroniseringen startet; fjernes når den er ferdig. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Settes til 90 dager etter at en resynkronisering er ferdig, og fjernes mens en pågår. TTL-indeksen sletter dokumentet på dette tidspunktet. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Hvor ofte en fastlåst resynkronisering er tømt og startet på nytt; fjernes når en resynkronisering er ferdig. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Tidspunktet for siste slike tømming. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Doc-stier som fortsatt ventet ved siste tømming. | `SyncManager.js:262`, `228` |

#### Hvem skriver

| Kode | Hva den gjør |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert av tilstanden. Kalles når en resynkronisering starter (`SyncManager.js:163`), og mens project-history behandler resynkroniseringsoppdateringene (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: teller en fastlåst resynkronisering som tømmes. |
| `SyncManager.js:251-255` | `clearResyncState`: sletter dokumentet, ved starten av en hard 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 av bare strukturen må begynne på nytt (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: sletter en fullført tilstand der hele historikken er nyere enn en dato. Ingenting i `app/js` kaller den. |
| `SyncManager.js:171-181` | `cloneResyncState`: kopierer tilstanden til et annet prosjekt, for project-history `POST /project/:project_id/clone` (`HttpController.js:57`, `124`), som ingenting i web kaller. |

En resynkronisering startes av project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), av cronjobbene for nye forsøk (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) og av project-history selv når behandlingen av oppdateringer trenger en (`UpdatesProcessor.js:75`, `224`).

#### Hvem leser

| Kode | Hva den gjør |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: laster inn tilstanden. Brukes til å avgjøre om en resynkronisering kjører før en ny starter (`SyncManager.js:106-149`), til å hoppe over vanlige oppdateringer mens den kjører (`SyncManager.js:291-300`) og etter en flush til å rapportere en pågående resynkronisering (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: om en resynkronisering kjører eller har låst seg. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: synkroniseringstilstanden med feilposten. |

#### Indekser

| Navn | Nøkler | Alternativer | 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` |

#### Merknader

* En resynkronisering kjører så lenge `resyncProjectStructure` er `true` eller `resyncDocContents` ikke er tom (`SyncManager.js:565-567`). Den regnes som fastlåst etter 4 timer, og som permanent fastlåst etter 5 tømminger (`SyncManager.js:43-44`, `569-585`).
* Når en resynkronisering er ferdig, setter project-history også `overleaf.history.lastResyncedAt` på prosjektet (`SyncManager.js:239-248`).


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