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

`projectHistorySyncState` містить один документ на кожен проєкт, який проходив ресинхронізацію: стан поточної або останньої ресинхронізації, під час якої project-history заново будує історію проєкту з того, що зберігають web і docstore. Колекція належить project-history і не має схеми Mongoose; код міститься в класі `SyncState` та його допоміжних функціях у `services/project-history/app/js/SyncManager.js`.

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Створюється під час upsert. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Проєкт. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true`, поки project-history чекає від web структуру проєкту (дерево файлів). | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Шляхи docs, вміст яких він ще чекає. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Хто запросив ресинхронізацію, наприклад типове `{ kind: 'history-resync' }`. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` для жорсткої ресинхронізації, яка спершу відкидає оновлення в черзі й старий стан синхронізації. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Параметр запиту ресинхронізації (`HttpController.js:963-964`). Під час жорсткої ресинхронізації doc із пошкодженим вмістом історії видаляється й знову додається з docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | Останні 100 станів, новіші першими, кожен `{ syncState, timestamp }`; `syncState` містить п'ять полів вище. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Час останнього запису. | `SyncManager.js:209` |
| `resyncCount` | Number | Кількість запущених ресинхронізацій. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Коли почалася поточна ресинхронізація; прибирається після її завершення. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Встановлюється на 90 днів після завершення ресинхронізації й прибирається, поки вона виконується. TTL-індекс видаляє документ у цей час. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Скільки разів завислу ресинхронізацію скидали й перезапускали; прибирається, коли ресинхронізація завершується. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Час останнього такого скидання. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Шляхи docs, які ще очікували обробки під час останнього скидання. | `SyncManager.js:262`, `228` |

#### Хто записує

| Код | Що робить |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert стану. Викликається під час запуску ресинхронізації (`SyncManager.js:163`) і поки project-history обробляє оновлення ресинхронізації (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: враховує скинуту завислу ресинхронізацію. |
| `SyncManager.js:251-255` | `clearResyncState`: видаляє документ на початку жорсткої ресинхронізації (`SyncManager.js:87`), під час `DELETE /project/:project_id` у project-history (`services/project-history/app/js/HttpController.js:1363-1396`) і коли ресинхронізацію лише структури треба почати заново (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: видаляє завершений стан, уся історія якого новіша за певну дату. Ніщо в `app/js` її не викликає. |
| `SyncManager.js:171-181` | `cloneResyncState`: копіює стан в інший проєкт для `POST /project/:project_id/clone` у project-history (`HttpController.js:57`, `124`), який ніщо в web не викликає. |

Ресинхронізацію запускають `POST /project/:project_id/resync` у project-history (`HttpController.js:950-994`), завдання cron для повторних спроб (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) і сам project-history, коли вона потрібна для обробки оновлень (`UpdatesProcessor.js:75`, `224`).

#### Хто читає

| Код | Що робить |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: завантажує стан. Використовується, щоб перед запуском нової ресинхронізації вирішити, чи не виконується вже інша (`SyncManager.js:106-149`), щоб пропускати звичайні оновлення під час її виконання (`SyncManager.js:291-300`) і щоб після скидання на диск повідомити про поточну ресинхронізацію (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: чи виконується ресинхронізація або чи зависла вона. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: стан синхронізації разом із записом про збій. |

#### Індекси

| Назва | Ключі | Параметри | Міграція |
| - | - | - | - |
| `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` |

#### Примітки

* Ресинхронізація виконується, поки `resyncProjectStructure` дорівнює `true` або `resyncDocContents` не порожній (`SyncManager.js:565-567`). Через 4 години вона вважається завислою, а після 5 скидань завислою назавжди (`SyncManager.js:43-44`, `569-585`).
* Коли ресинхронізація завершується, project-history також встановлює в проєкті `overleaf.history.lastResyncedAt` (`SyncManager.js:239-248`).


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