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

`projectHistoryFailures`, project-history’nin geçmiş güncellemelerini işleyemediği ya da yeniden eşitleme başlattığı her proje için bir belge tutar. İşleme başarılı olur olmaz belge yeniden silinir. project-history onu `services/project-history/app/js/ErrorRecorder.js` içinde yazar; türü `services/project-history/app/js/mongo-types.ts:3-24` içindedir. Web’in de bunun için bir Mongoose şeması vardır (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), ancak hiçbir Web kodu o modeli kullanmaz.

#### Alanlar

| Alan | Tür | Anlamı | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Upsert ile oluşturulur. | `ErrorRecorder.js:45-60` |
| `project_id` | String | Proje kimliği; ObjectId olarak değil, string olarak saklanır. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | Son hata, `error.toString()` biçiminde. | `ErrorRecorder.js:37` |
| `stack` | String | Son hatanın yığını. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Son hata sırasında projenin Redis kuyruğunda bekleyen güncellemeler (`services/project-history/app/js/UpdatesProcessor.js:375`); hata bir yeniden eşitlemenin başlatılmasından geldiyse `-1` (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Son hatanın zamanı. | `ErrorRecorder.js:39` |
| `attempts` | Number | Belge oluşturulduğundan beri kaydedilen hata sayısı. | `ErrorRecorder.js:49` |
| `history` | Array of Object | Son 10 olay, en yeniler önce: hata kayıtları `{ queueSize, error, stack, ts }` ve yeniden eşitleme başlangıçları `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Son yeniden eşitlemenin başladığı zaman. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Belge oluşturulduğundan beri başlatılan yeniden eşitleme sayısı. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | project-history `POST /project/:project_id/force` tarafından ayarlanır (`?clear=true` onu `false` yapar). `true` olduğu sürece, saklanan chunk’taki ops-out-of-order hatası günlüğe yazılır ve yok sayılır (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | Web şemasında bulunur (`ProjectHistoryFailure.mjs:16`). Onu yalnızca `ErrorRecorder.getLastFailure` artırır ve o işlevi hiçbir şey çağırmaz. | `ErrorRecorder.js:131-138` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: hatanın upsert’i, `attempts` +1, `history` içine bir kayıt eklenir. Bir projenin güncellemelerinin işlenmesi başarısız olduğunda (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`) ve bir yeniden eşitleme başlatılamadığında (`SyncManager.js:75`, `96`) çağrılır. |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: her yeniden eşitleme başladığında upsert, `resyncStartedAt`, `resyncAttempts` +1 ve `history` içine bir kayıt (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: başarılı bir flush’tan sonra (`UpdatesProcessor.js:101`, `194`, `259`, `355`), project-history `DELETE /project/:project_id` sırasında (`services/project-history/app/js/HttpController.js:1386`) ve bir yeniden denemede geçersiz bir proje kimliği için (`services/project-history/app/js/RetryManager.js:161`) belgeyi siler. |
| `ErrorRecorder.js:72-82` | `setForceDebug`: `forceDebug` upsert’i (`HttpController.js:1016-1035`, rota `services/project-history/app/js/Router.js:82` konumunda). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: belgeyi başka bir projeye kopyalar, project-history `POST /project/:project_id/clone` için (`HttpController.js:135`); Web’de onu çağıran hiçbir şey yoktur. |

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `RetryManager.js:113-126` | Yeniden deneme cron işleri için tüm hataları yükler (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). Soft iş kuyruğu yeniden işler; hard iş projeyi yeniden eşitler, `resyncAttempts` en az 1 olduğunda ve hata çalışan bir yeniden eşitleme değilse hard yeniden eşitleme olarak (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | Tüm projelerin flush’ı, hatası olan projeleri atlar. |
| `UpdatesProcessor.js:578-592` | `forceDebug` değerini okur. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` ve `getFailedProjects`: `GET /project/:project_id/debug-info` (`HttpController.js:571`) ve `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`) tarafından kullanılır. |

#### İndeksler

| Ad | Anahtarlar | Seçenekler | Migration |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Notlar

* Bir belge, projenin bir flush’ı başarılı olana veya proje silinene kadar kalır (yukarıdaki `clearError`); bu yüzden her belge, son flush’ı veya yeniden eşitlemesi henüz başarılı olmamış bir projeyi işaret eder.
* `OError:` ile başlayan hata dizeleri `Error:` olarak döndürülür (`ErrorRecorder.js:18-26`); saklanan değer değişmez.


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