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

`projectHistoryFailures` bevat één document per project waarvan project-history de geschiedenisupdates niet kon verwerken, of waarvoor het een resync heeft gestart. Het document wordt weer verwijderd zodra de verwerking lukt. project-history schrijft het in `services/project-history/app/js/ErrorRecorder.js`; het type staat in `services/project-history/app/js/mongo-types.ts:3-24`. Web heeft er ook een Mongoose-schema voor (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), maar geen enkele web-code gebruikt dat model.

#### Velden

| Veld | Type | Betekenis | Bron |
| - | - | - | - |
| `_id` | ObjectId | Aangemaakt door de upsert. | `ErrorRecorder.js:45-60` |
| `project_id` | String | De project-id, opgeslagen als string, niet als ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | De laatste fout, als `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Stack van de laatste fout. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Updates die bij de laatste fout in de Redis-wachtrij van het project wachtten (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1` als de fout kwam van het starten van een resync (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Tijdstip van de laatste fout. | `ErrorRecorder.js:39` |
| `attempts` | Number | Aantal fouten sinds het document is aangemaakt. | `ErrorRecorder.js:49` |
| `history` | Array of Object | De laatste 10 gebeurtenissen, nieuwste eerst: foutrecords `{ queueSize, error, stack, ts }` en resync-starts `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Wanneer de laatste resync is gestart. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Aantal gestarte resyncs sinds het document is aangemaakt. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Gezet door project-history `POST /project/:project_id/force` (`?clear=true` zet het op `false`). Zolang `true`, wordt een ops-out-of-order-fout in de opgeslagen chunk gelogd en genegeerd (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | In het web-schema (`ProjectHistoryFailure.mjs:16`). Alleen `ErrorRecorder.getLastFailure` verhoogt het, en niets roept die functie aan. | `ErrorRecorder.js:131-138` |

#### Wie schrijft het

| Code | Wat het doet |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: upsert van de fout, `attempts` +1, item toegevoegd aan `history`. Aangeroepen wanneer het verwerken van de updates van een project mislukt (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`) en wanneer een resync niet kan starten (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert, `resyncStartedAt`, `resyncAttempts` +1, item toegevoegd aan `history`, telkens wanneer een resync start (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: verwijdert het document na een geslaagde flush (`UpdatesProcessor.js:101`, `194`, `259`, `355`), bij project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) en bij een ongeldige project-id tijdens een nieuwe poging (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: upsert van `forceDebug` (`HttpController.js:1016-1035`, route bij `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: kopieert het document naar een ander project, voor project-history `POST /project/:project_id/clone` (`HttpController.js:135`), dat niets in web aanroept. |

#### Wie leest het

| Code | Wat het doet |
| - | - |
| `RetryManager.js:113-126` | Laadt alle fouten voor de retry-cronjobs (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). De soft-job verwerkt de wachtrij opnieuw; de hard-job resynct het project, als hard resync wanneer `resyncAttempts` minstens 1 is en de fout geen lopende resync is (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | De flush van alle projecten slaat projecten met een fout over. |
| `UpdatesProcessor.js:578-592` | Leest `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` en `getFailedProjects`: gebruikt door `GET /project/:project_id/debug-info` (`HttpController.js:571`) en `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Indexen

| Naam | Sleutels | Opties | Migratie |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Opmerkingen

* Een document blijft bestaan totdat een flush van het project slaagt of het project wordt verwijderd (`clearError` hierboven), dus elk document markeert een project waarvan de laatste flush of resync nog niet is geslaagd.
* Foutstrings die beginnen met `OError:` worden teruggegeven als `Error:` (`ErrorRecorder.js:18-26`); de opgeslagen waarde verandert niet.


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