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

# Kolekcja Project History Failures

`projectHistoryFailures` przechowuje jeden dokument na projekt, którego aktualizacji historii project-history nie mógł przetworzyć albo dla którego uruchomił ponowną synchronizację. Dokument jest znowu usuwany, gdy tylko przetwarzanie się powiedzie. project-history zapisuje ją w `services/project-history/app/js/ErrorRecorder.js`; jej typ jest w `services/project-history/app/js/mongo-types.ts:3-24`. Web też ma dla niej schemat Mongoose (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), ale żaden kod web nie używa tego modelu.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Tworzone przez upsert. | `ErrorRecorder.js:45-60` |
| `project_id` | String | Identyfikator projektu, zapisany jako string, a nie ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | Ostatni błąd, jako `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Stos ostatniego błędu. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Aktualizacje czekające w kolejce Redis projektu przy ostatnim błędzie (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1`, gdy błąd pochodził z uruchamiania ponownej synchronizacji (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Czas ostatniego błędu. | `ErrorRecorder.js:39` |
| `attempts` | Number | Liczba błędów zapisanych od utworzenia dokumentu. | `ErrorRecorder.js:49` |
| `history` | Array of Object | Ostatnie 10 zdarzeń, od najnowszych: rekordy błędów `{ queueSize, error, stack, ts }` i starty ponownej synchronizacji `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Kiedy uruchomiono ostatnią ponowną synchronizację. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Liczba ponownych synchronizacji uruchomionych od utworzenia dokumentu. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Ustawiane przez project-history `POST /project/:project_id/force` (`?clear=true` ustawia je na `false`). Dopóki `true`, błąd ops-out-of-order w zapisanym chunku jest logowany i ignorowany (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | W schemacie web (`ProjectHistoryFailure.mjs:16`). Zwiększa je tylko `ErrorRecorder.getLastFailure`, a nic nie wywołuje tej funkcji. | `ErrorRecorder.js:131-138` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: upsert błędu, `attempts` +1, wpis dodany do `history`. Wywoływane, gdy przetwarzanie aktualizacji projektu się nie powiedzie (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`) oraz gdy nie można uruchomić ponownej synchronizacji (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert, `resyncStartedAt`, `resyncAttempts` +1, wpis dodany do `history`, przy każdym starcie ponownej synchronizacji (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: usuwa dokument po udanym flushu (`UpdatesProcessor.js:101`, `194`, `259`, `355`), przy project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) oraz dla błędnego identyfikatora projektu podczas ponownej próby (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: upsert `forceDebug` (`HttpController.js:1016-1035`, trasa w `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: kopiuje dokument do innego projektu, dla project-history `POST /project/:project_id/clone` (`HttpController.js:135`), której nic w web nie wywołuje. |

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `RetryManager.js:113-126` | Wczytuje wszystkie błędy dla zadań cron ponawiania (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). Zadanie soft ponownie przetwarza kolejkę; zadanie hard ponownie synchronizuje projekt, jako synchronizację hard, gdy `resyncAttempts` wynosi co najmniej 1, a błąd nie jest trwającą synchronizacją (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | Flush wszystkich projektów pomija projekty z błędem. |
| `UpdatesProcessor.js:578-592` | Odczytuje `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` i `getFailedProjects`: używane przez `GET /project/:project_id/debug-info` (`HttpController.js:571`) oraz `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Uwagi

* Dokument pozostaje, dopóki flush projektu się nie powiedzie albo projekt nie zostanie usunięty (`clearError` powyżej), więc każdy dokument oznacza projekt, którego ostatni flush lub ponowna synchronizacja jeszcze się nie powiodły.
* Ciągi błędów zaczynające się od `OError:` są zwracane jako `Error:` (`ErrorRecorder.js:18-26`); zapisana wartość się nie zmienia.


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