> ## 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`)، وبعد flush للإبلاغ عن إعادة مزامنة جارية (`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.