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

`projectHistorySyncState` enthält ein Dokument pro Projekt, das neu synchronisiert wurde: den Zustand des laufenden oder letzten Resyncs, bei dem project-history den Verlauf eines Projekts aus dem neu aufbaut, was Web und docstore enthalten. Die Collection gehört project-history und hat kein Mongoose-Schema; der Code ist die Klasse `SyncState` mit ihren Hilfsfunktionen in `services/project-history/app/js/SyncManager.js`.

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Vom Upsert angelegt. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Das Projekt. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true`, solange project-history auf die Projektstruktur (Dateibaum) von Web wartet. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Pfade der Docs, auf deren Inhalt es noch wartet. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Wer den Resync angefordert hat, zum Beispiel `{ kind: 'history-resync' }`, der Standard. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` für einen harten Resync, der zuerst die eingereihten Updates und den alten Synchronisierungszustand verwirft. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Option der Resync-Anfrage (`HttpController.js:963-964`). Bei einem harten Resync wird ein Doc, dessen Verlaufsinhalt beschädigt ist, entfernt und aus docstore neu hinzugefügt (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | Die letzten 100 Zustände, neueste zuerst, jeweils `{ syncState, timestamp }`; `syncState` enthält die fünf Felder oben. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Zeitpunkt des letzten Schreibvorgangs. | `SyncManager.js:209` |
| `resyncCount` | Number | Anzahl der gestarteten Resyncs. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Wann der laufende Resync begann; wird entfernt, wenn er endet. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Wird 90 Tage nach Ende eines Resyncs gesetzt und entfernt, solange einer läuft. Der TTL-Index löscht das Dokument zu diesem Zeitpunkt. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Wie oft ein hängender Resync geleert und neu gestartet wurde; wird entfernt, wenn ein Resync endet. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Zeitpunkt des letzten solchen Leerens. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Doc-Pfade, die beim letzten Leeren noch ausstanden. | `SyncManager.js:262`, `228` |

#### Wer schreibt

| Code | Funktion |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: Upsert des Zustands. Aufgerufen, wenn ein Resync beginnt (`SyncManager.js:163`), und während project-history die Resync-Updates verarbeitet (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: zählt einen hängenden Resync, der geleert wird. |
| `SyncManager.js:251-255` | `clearResyncState`: löscht das Dokument, zu Beginn eines harten Resyncs (`SyncManager.js:87`), bei project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1363-1396`) und wenn ein Resync nur der Struktur von vorn beginnen muss (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: löscht einen abgeschlossenen Zustand, dessen Verlauf vollständig neuer als ein Datum ist. Nichts in `app/js` ruft es auf. |
| `SyncManager.js:171-181` | `cloneResyncState`: kopiert den Zustand in ein anderes Projekt, für project-history `POST /project/:project_id/clone` (`HttpController.js:57`, `124`), das nichts in Web aufruft. |

Ein Resync wird gestartet durch project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), durch die Retry-Cron-Jobs (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) und durch project-history selbst, wenn die Verarbeitung von Updates einen erfordert (`UpdatesProcessor.js:75`, `224`).

#### Wer liest

| Code | Funktion |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: lädt den Zustand. Wird verwendet, um vor dem Start eines neuen Resyncs zu entscheiden, ob einer läuft (`SyncManager.js:106-149`), um gewöhnliche Updates zu überspringen, solange er läuft (`SyncManager.js:291-300`), und nach einem Flush, um einen laufenden Resync zu melden (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: ob ein Resync läuft oder hängt. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: der Synchronisierungszustand mit dem Fehlereintrag. |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `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` |

#### Hinweise

* Ein Resync läuft, solange `resyncProjectStructure` `true` ist oder `resyncDocContents` nicht leer ist (`SyncManager.js:565-567`). Nach 4 Stunden gilt er als hängend, nach 5 Leerungen als dauerhaft hängend (`SyncManager.js:43-44`, `569-585`).
* Wenn ein Resync endet, setzt project-history außerdem `overleaf.history.lastResyncedAt` am Projekt (`SyncManager.js:239-248`).


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