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

تحتفظ `projectHistoryFailures` بمستند واحد لكل مشروع لم تتمكن project-history من معالجة تحديثات سجله، أو بدأت له إعادة مزامنة. يُحذف المستند مجددًا بمجرد نجاح المعالجة. تكتبها project-history في `services/project-history/app/js/ErrorRecorder.js`؛ ونوعها في `services/project-history/app/js/mongo-types.ts:3-24`. لدى web أيضًا مخطط Mongoose لها (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`)، لكن لا يستخدم أي كود في web هذا النموذج.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | يُنشأ بواسطة upsert. | `ErrorRecorder.js:45-60` |
| `project_id` | String | معرّف المشروع، مخزَّن كسلسلة نصية لا كـ ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | آخر خطأ، بالشكل `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | مكدس آخر خطأ. | `ErrorRecorder.js:38` |
| `queueSize` | Number | التحديثات التي كانت تنتظر في طابور Redis الخاص بالمشروع عند آخر خطأ (`services/project-history/app/js/UpdatesProcessor.js:375`)؛ `-1` عندما يكون الخطأ ناتجًا عن بدء إعادة مزامنة (`services/project-history/app/js/SyncManager.js:75`، `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | وقت آخر خطأ. | `ErrorRecorder.js:39` |
| `attempts` | Number | عدد الأخطاء المسجلة منذ إنشاء المستند. | `ErrorRecorder.js:49` |
| `history` | Array of Object | آخر 10 أحداث، الأحدث أولًا: سجلات الأخطاء `{ queueSize, error, stack, ts }` وبدايات إعادة المزامنة `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | وقت بدء آخر إعادة مزامنة. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | عدد عمليات إعادة المزامنة التي بدأت منذ إنشاء المستند. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | يضبطه project-history `POST /project/:project_id/force` (يضبطه `?clear=true` على `false`). طالما `true`، يُسجَّل خطأ ops-out-of-order في الـ chunk المخزّن ويُتجاهل (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | موجود في مخطط web (`ProjectHistoryFailure.mjs:16`). لا يزيده إلا `ErrorRecorder.getLastFailure`، ولا شيء يستدعي تلك الدالة. | `ErrorRecorder.js:131-138` |

#### من يكتبها

| الكود | ماذا يفعل |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: upsert للخطأ، `attempts` +1، وإضافة إدخال إلى `history`. يُستدعى عند فشل معالجة تحديثات مشروع (`UpdatesProcessor.js:91`، `169`، `242`، `293`، `345`) وعندما يتعذر بدء إعادة مزامنة (`SyncManager.js:75`، `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert، `resyncStartedAt`، `resyncAttempts` +1، وإضافة إدخال إلى `history`، في كل مرة تبدأ فيها إعادة مزامنة (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: يحذف المستند بعد flush ناجح (`UpdatesProcessor.js:101`، `194`، `259`، `355`)، وعند project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`)، ولمعرّف مشروع غير صالح أثناء إعادة محاولة (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: upsert لـ `forceDebug` (`HttpController.js:1016-1035`، والمسار في `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: ينسخ المستند إلى مشروع آخر، لمسار project-history `POST /project/:project_id/clone` (`HttpController.js:135`)، الذي لا يستدعيه شيء في web. |

#### من يقرؤها

| الكود | ماذا يفعل |
| - | - |
| `RetryManager.js:113-126` | يحمّل كل الإخفاقات لمهام cron الخاصة بإعادة المحاولة (`server-ce/config/crontab-history`، project-history `POST /retry/failures`). تعيد مهمة soft معالجة الطابور؛ وتعيد مهمة hard مزامنة المشروع، كإعادة مزامنة hard عندما يكون `resyncAttempts` 1 على الأقل ولا يكون الخطأ إعادة مزامنة جارية (`RetryManager.js:30-31`، `35-56`، `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | يتخطى flush جميع المشاريع المشاريعَ التي لديها إخفاق. |
| `UpdatesProcessor.js:578-592` | يقرأ `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` و`getFailedProjects`: يستخدمهما `GET /project/:project_id/debug-info` (`HttpController.js:571`) و`GET /status/failures`، `GET /status/failures-full` (`Router.js:88-90`). |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### ملاحظات

* يبقى المستند حتى ينجح flush للمشروع أو يُحذف المشروع (`clearError` أعلاه)، لذا يشير كل مستند إلى مشروع لم ينجح آخر flush أو إعادة مزامنة له بعد.
* سلاسل الأخطاء التي تبدأ بـ `OError:` تُعاد بالشكل `Error:` (`ErrorRecorder.js:18-26`)؛ ولا تتغير القيمة المخزّنة.


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