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

# Samlingen Project History Sync State

`projectHistorySyncState` innehåller ett dokument per projekt som har synkroniserats om: tillståndet för den pågående eller senaste omsynkroniseringen, när project-history bygger upp ett projekts historik på nytt från det som web och docstore innehåller. Samlingen ägs av project-history och har inget Mongoose-schema; koden är klassen `SyncState` och dess hjälpfunktioner i `services/project-history/app/js/SyncManager.js`.

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Skapas av upserten. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Projektet. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true` medan project-history väntar på projektstrukturen (filträdet) från web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Sökvägar till de docs vars innehåll den fortfarande väntar på. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Vem som begärde omsynkroniseringen, till exempel `{ kind: 'history-resync' }`, standardvärdet. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` för en hård omsynkronisering, som först kastar köade uppdateringar och det gamla synkroniseringstillståndet. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Alternativ i begäran om omsynkronisering (`HttpController.js:963-964`). Vid en hård omsynkronisering tas ett doc vars historikinnehåll är skadat bort och läggs till igen från docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | De senaste 100 tillstånden, nyast först, vart och ett `{ syncState, timestamp }`; `syncState` innehåller de fem fälten ovan. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Tidpunkt för den senaste skrivningen. | `SyncManager.js:209` |
| `resyncCount` | Number | Antal startade omsynkroniseringar. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | När den pågående omsynkroniseringen startade; tas bort när den är klar. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Sätts till 90 dagar efter att en omsynkronisering är klar och tas bort medan en pågår. TTL-indexet raderar dokumentet vid den tidpunkten. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Hur ofta en fastnad omsynkronisering har rensats och startats om; tas bort när en omsynkronisering är klar. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Tidpunkt för den senaste sådana rensningen. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Doc-sökvägar som fortfarande väntade vid den senaste rensningen. | `SyncManager.js:262`, `228` |

#### Vem skriver

| Kod | Vad den gör |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert av tillståndet. Anropas när en omsynkronisering startar (`SyncManager.js:163`) och medan project-history bearbetar omsynkroniseringens uppdateringar (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: räknar en fastnad omsynkronisering som rensas. |
| `SyncManager.js:251-255` | `clearResyncState`: raderar dokumentet, i början av en hård omsynkronisering (`SyncManager.js:87`), vid project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1363-1396`) och när en omsynkronisering av bara strukturen måste börja om (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: raderar ett avslutat tillstånd vars historik i sin helhet är nyare än ett datum. Inget i `app/js` anropar den. |
| `SyncManager.js:171-181` | `cloneResyncState`: kopierar tillståndet till ett annat projekt, för project-history `POST /project/:project_id/clone` (`HttpController.js:57`, `124`), som inget i web anropar. |

En omsynkronisering startas av project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), av cronjobben för nya försök (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) och av project-history självt när bearbetningen av uppdateringar behöver en (`UpdatesProcessor.js:75`, `224`).

#### Vem läser

| Kod | Vad den gör |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: läser in tillståndet. Används för att avgöra om en omsynkronisering pågår innan en ny startar (`SyncManager.js:106-149`), för att hoppa över vanliga uppdateringar medan den pågår (`SyncManager.js:291-300`) och efter en flush för att rapportera en pågående omsynkronisering (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: om en omsynkronisering pågår eller har fastnat. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: synkroniseringstillståndet med felposten. |

#### Index

| Namn | Nycklar | Alternativ | 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` |

#### Anteckningar

* En omsynkronisering pågår så länge `resyncProjectStructure` är `true` eller `resyncDocContents` inte är tom (`SyncManager.js:565-567`). Den räknas som fastnad efter 4 timmar och som permanent fastnad efter 5 rensningar (`SyncManager.js:43-44`, `569-585`).
* När en omsynkronisering är klar sätter project-history även `overleaf.history.lastResyncedAt` på projektet (`SyncManager.js:239-248`).


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