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

# Kolekce Project History Failures

`projectHistoryFailures` uchovává jeden dokument na projekt, jehož aktualizace historie project-history nedokázala zpracovat nebo pro který spustila resynchronizaci. Jakmile zpracování projde, dokument se znovu smaže. project-history ji zapisuje v `services/project-history/app/js/ErrorRecorder.js`; její typ je v `services/project-history/app/js/mongo-types.ts:3-24`. Web pro ni má také schéma Mongoose (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), ale žádný kód ve web tento model nepoužívá.

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Vytvořeno upsertem. | `ErrorRecorder.js:45-60` |
| `project_id` | String | ID projektu, uložené jako řetězec, ne jako ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | Poslední chyba ve tvaru `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Zásobník poslední chyby. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Aktualizace čekající ve frontě Redis projektu při poslední chybě (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1`, když chyba vznikla při spuštění resynchronizace (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Čas poslední chyby. | `ErrorRecorder.js:39` |
| `attempts` | Number | Počet chyb zaznamenaných od vytvoření dokumentu. | `ErrorRecorder.js:49` |
| `history` | Array of Object | Posledních 10 událostí, nejnovější první: záznamy chyb `{ queueSize, error, stack, ts }` a spuštění resynchronizace `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Kdy byla spuštěna poslední resynchronizace. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Počet resynchronizací spuštěných od vytvoření dokumentu. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Nastavuje project-history `POST /project/:project_id/force` (`?clear=true` ho nastaví na `false`). Dokud platí `true`, chyba ops-out-of-order v uloženém chunku se zaloguje a ignoruje (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | Ve schématu web (`ProjectHistoryFailure.mjs:16`). Zvyšuje ho jen `ErrorRecorder.getLastFailure` a tuto funkci nic nevolá. | `ErrorRecorder.js:131-138` |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: upsert chyby, `attempts` +1, záznam přidán do `history`. Volá se, když selže zpracování aktualizací projektu (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`), a když nelze spustit resynchronizaci (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert, `resyncStartedAt`, `resyncAttempts` +1, záznam přidán do `history`, při každém spuštění resynchronizace (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: smaže dokument po úspěšném flushi (`UpdatesProcessor.js:101`, `194`, `259`, `355`), při project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) a při neplatném ID projektu během opakování (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: upsert `forceDebug` (`HttpController.js:1016-1035`, routa v `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: zkopíruje dokument do jiného projektu, pro project-history `POST /project/:project_id/clone` (`HttpController.js:135`), kterou nic ve web nevolá. |

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `RetryManager.js:113-126` | Načte všechna selhání pro cron úlohy opakování (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). Úloha soft znovu zpracuje frontu; úloha hard resynchronizuje projekt, a to jako hard resynchronizaci, když je `resyncAttempts` alespoň 1 a chyba není běžící resynchronizace (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | Flush všech projektů přeskakuje projekty se selháním. |
| `UpdatesProcessor.js:578-592` | Čte `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` a `getFailedProjects`: používají je `GET /project/:project_id/debug-info` (`HttpController.js:571`) a `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Poznámky

* Dokument zůstává, dokud flush projektu neuspěje nebo projekt není smazán (`clearError` výše), takže každý dokument označuje projekt, jehož poslední flush nebo resynchronizace zatím neuspěly.
* Chybové řetězce začínající `OError:` se vracejí jako `Error:` (`ErrorRecorder.js:18-26`); uložená hodnota se nemění.


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