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

`projectHistorySyncState` sisältää yhden dokumentin jokaista uudelleensynkronoitua projektia kohden: käynnissä olevan tai viimeisimmän uudelleensynkronoinnin tilan, kun project-history rakentaa projektin historian uudelleen siitä, mitä webissä ja docstoressa on. Kokoelman omistaa project-history, eikä sillä ole Mongoose-skeemaa; koodi on luokka `SyncState` apufunktioineen tiedostossa `services/project-history/app/js/SyncManager.js`.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Upsert luo sen. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Projekti. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true`, kun project-history odottaa projektin rakennetta (tiedostopuuta) webiltä. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Niiden docsien polut, joiden sisältöä se vielä odottaa. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Kuka pyysi uudelleensynkronointia, esimerkiksi oletusarvo `{ kind: 'history-resync' }`. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` kovassa uudelleensynkronoinnissa, joka ensin hylkää jonossa olevat päivitykset ja vanhan synkronointitilan. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Uudelleensynkronointipyynnön asetus (`HttpController.js:963-964`). Kovassa uudelleensynkronoinnissa doc, jonka historiasisältö on vioittunut, poistetaan ja lisätään uudelleen docstoresta (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | Viimeiset 100 tilaa, uusin ensin, kukin `{ syncState, timestamp }`; `syncState` sisältää yllä olevat viisi kenttää. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Viimeisimmän kirjoituksen aika. | `SyncManager.js:209` |
| `resyncCount` | Number | Aloitettujen uudelleensynkronointien määrä. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Milloin käynnissä oleva uudelleensynkronointi alkoi; poistetaan sen päättyessä. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Asetetaan 90 päivän päähän uudelleensynkronoinnin päättymisestä ja poistetaan, kun sellainen on käynnissä. TTL-indeksi poistaa dokumentin tuolloin. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Kuinka monta kertaa jumittunut uudelleensynkronointi on tyhjennetty ja käynnistetty uudelleen; poistetaan, kun uudelleensynkronointi päättyy. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Viimeisimmän tällaisen tyhjennyksen aika. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Doc-polut, jotka olivat vielä kesken viimeisimmässä tyhjennyksessä. | `SyncManager.js:262`, `228` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: tilan upsert. Kutsutaan, kun uudelleensynkronointi alkaa (`SyncManager.js:163`), ja kun project-history käsittelee uudelleensynkronoinnin päivityksiä (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: laskee tyhjennetyn jumittuneen uudelleensynkronoinnin. |
| `SyncManager.js:251-255` | `clearResyncState`: poistaa dokumentin kovan uudelleensynkronoinnin alussa (`SyncManager.js:87`), project-historyn reitissä `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1363-1396`) ja kun pelkän rakenteen uudelleensynkronointi täytyy aloittaa alusta (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: poistaa päättyneen tilan, jonka koko historia on tiettyä päivämäärää uudempi. Mikään hakemistossa `app/js` ei kutsu sitä. |
| `SyncManager.js:171-181` | `cloneResyncState`: kopioi tilan toiseen projektiin project-historyn reittiä `POST /project/:project_id/clone` varten (`HttpController.js:57`, `124`), jota mikään webissä ei kutsu. |

Uudelleensynkronoinnin käynnistää project-historyn `POST /project/:project_id/resync` (`HttpController.js:950-994`), uudelleenyritysten cron-työt (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) ja project-history itse, kun päivitysten käsittely tarvitsee sitä (`UpdatesProcessor.js:75`, `224`).

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: lataa tilan. Käytetään päättämään, onko uudelleensynkronointi jo käynnissä ennen uuden aloittamista (`SyncManager.js:106-149`), ohittamaan tavalliset päivitykset sen ollessa käynnissä (`SyncManager.js:291-300`) ja flushin jälkeen raportoimaan käynnissä olevasta uudelleensynkronoinnista (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: onko uudelleensynkronointi käynnissä tai jumissa. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: synkronointitila virhetietueen kanssa. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `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` |

#### Huomautukset

* Uudelleensynkronointi on käynnissä niin kauan kuin `resyncProjectStructure` on `true` tai `resyncDocContents` ei ole tyhjä (`SyncManager.js:565-567`). Sitä pidetään jumittuneena 4 tunnin jälkeen ja pysyvästi jumittuneena 5 tyhjennyksen jälkeen (`SyncManager.js:43-44`, `569-585`).
* Kun uudelleensynkronointi päättyy, project-history asettaa projektiin myös kentän `overleaf.history.lastResyncedAt` (`SyncManager.js:239-248`).


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