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

`projectHistoryFailures` enthält ein Dokument pro Projekt, dessen History-Updates project-history nicht verarbeiten konnte oder für das es einen Resync gestartet hat. Sobald die Verarbeitung funktioniert, wird das Dokument wieder gelöscht. project-history schreibt sie in `services/project-history/app/js/ErrorRecorder.js`; ihr Typ steht in `services/project-history/app/js/mongo-types.ts:3-24`. Web hat dafür ebenfalls ein Mongoose-Schema (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), aber kein Web-Code verwendet dieses Modell.

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Durch das Upsert angelegt. | `ErrorRecorder.js:45-60` |
| `project_id` | String | Die Projekt-ID, als String gespeichert, nicht als ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | Der letzte Fehler, als `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Stack des letzten Fehlers. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Updates, die beim letzten Fehler in der Redis-Queue des Projekts warteten (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1`, wenn der Fehler beim Starten eines Resyncs auftrat (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Zeitpunkt des letzten Fehlers. | `ErrorRecorder.js:39` |
| `attempts` | Number | Anzahl der Fehler seit dem Anlegen des Dokuments. | `ErrorRecorder.js:49` |
| `history` | Array of Object | Die letzten 10 Ereignisse, neueste zuerst: Fehlereinträge `{ queueSize, error, stack, ts }` und Resync-Starts `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Wann der letzte Resync gestartet wurde. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Anzahl der gestarteten Resyncs seit dem Anlegen des Dokuments. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Gesetzt von project-history `POST /project/:project_id/force` (`?clear=true` setzt es auf `false`). Solange `true` gilt, wird ein ops-out-of-order-Fehler im gespeicherten Chunk protokolliert und ignoriert (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | Im Web-Schema (`ProjectHistoryFailure.mjs:16`). Nur `ErrorRecorder.getLastFailure` erhöht es, und nichts ruft diese Funktion auf. | `ErrorRecorder.js:131-138` |

#### Wer schreibt sie

| Code | Was er tut |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: Upsert des Fehlers, `attempts` +1, Eintrag zu `history` hinzugefügt. Aufgerufen, wenn die Verarbeitung der Updates eines Projekts fehlschlägt (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`) und wenn ein Resync nicht starten kann (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: Upsert, `resyncStartedAt`, `resyncAttempts` +1, Eintrag zu `history` hinzugefügt, bei jedem Resync-Start (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: löscht das Dokument nach einem erfolgreichen Flush (`UpdatesProcessor.js:101`, `194`, `259`, `355`), bei project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) und bei einer ungültigen Projekt-ID während eines Retries (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: Upsert von `forceDebug` (`HttpController.js:1016-1035`, Route in `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: kopiert das Dokument in ein anderes Projekt, für project-history `POST /project/:project_id/clone` (`HttpController.js:135`), was nichts in Web aufruft. |

#### Wer liest sie

| Code | Was er tut |
| - | - |
| `RetryManager.js:113-126` | Lädt alle Fehlschläge für die Retry-Cronjobs (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). Der Soft-Job verarbeitet die Queue erneut; der Hard-Job führt einen Resync des Projekts aus, als Hard-Resync, wenn `resyncAttempts` mindestens 1 ist und der Fehler kein laufender Resync ist (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | Der Flush aller Projekte überspringt Projekte mit einem Fehlschlag. |
| `UpdatesProcessor.js:578-592` | Liest `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` und `getFailedProjects`: verwendet von `GET /project/:project_id/debug-info` (`HttpController.js:571`) und `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Hinweise

* Ein Dokument bleibt, bis ein Flush des Projekts gelingt oder das Projekt gelöscht wird (`clearError` oben). Jedes Dokument markiert also ein Projekt, dessen letzter Flush oder Resync noch nicht gelungen ist.
* Fehlerstrings, die mit `OError:` beginnen, werden als `Error:` zurückgegeben (`ErrorRecorder.js:18-26`); der gespeicherte Wert bleibt unverändert.


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