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

`projectHistoryFailures` sisältää yhden dokumentin jokaista projektia kohden, jonka historiapäivityksiä project-history ei pystynyt käsittelemään tai jolle se käynnisti uudelleensynkronoinnin. Dokumentti poistetaan taas heti, kun käsittely onnistuu. project-history kirjoittaa sen tiedostossa `services/project-history/app/js/ErrorRecorder.js`; sen tyyppi on tiedostossa `services/project-history/app/js/mongo-types.ts:3-24`. Webillä on sille myös Mongoose-skeema (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), mutta mikään webin koodi ei käytä sitä mallia.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Luodaan upsertilla. | `ErrorRecorder.js:45-60` |
| `project_id` | String | Projektin tunniste merkkijonona, ei ObjectId-arvona. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | Viimeisin virhe muodossa `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Viimeisimmän virheen pino. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Projektin Redis-jonossa viimeisimmän virheen hetkellä odottaneet päivitykset (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1`, kun virhe tuli uudelleensynkronoinnin käynnistyksestä (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Viimeisimmän virheen aika. | `ErrorRecorder.js:39` |
| `attempts` | Number | Dokumentin luomisen jälkeen kirjattujen virheiden määrä. | `ErrorRecorder.js:49` |
| `history` | Array of Object | Viimeiset 10 tapahtumaa uusimmasta alkaen: virhetietueet `{ queueSize, error, stack, ts }` ja uudelleensynkronointien käynnistykset `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Milloin viimeisin uudelleensynkronointi käynnistyi. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Dokumentin luomisen jälkeen käynnistettyjen uudelleensynkronointien määrä. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Asettaa project-history `POST /project/:project_id/force` (`?clear=true` asettaa arvoksi `false`). Kun `true`, tallennetun chunkin ops-out-of-order-virhe kirjataan lokiin ja ohitetaan (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | Web-skeemassa (`ProjectHistoryFailure.mjs:16`). Vain `ErrorRecorder.getLastFailure` kasvattaa sitä, eikä mikään kutsu sitä funktiota. | `ErrorRecorder.js:131-138` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: virheen upsert, `attempts` +1, merkintä lisätään kenttään `history`. Kutsutaan, kun projektin päivitysten käsittely epäonnistuu (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`) ja kun uudelleensynkronointia ei voi käynnistää (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert, `resyncStartedAt`, `resyncAttempts` +1, merkintä lisätään kenttään `history` aina, kun uudelleensynkronointi käynnistyy (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: poistaa dokumentin onnistuneen flushin jälkeen (`UpdatesProcessor.js:101`, `194`, `259`, `355`), project-historyn reitillä `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) ja virheellisen projektitunnisteen kohdalla uudelleenyrityksen aikana (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: `forceDebug`:n upsert (`HttpController.js:1016-1035`, reitti kohdassa `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: kopioi dokumentin toiseen projektiin, project-historyn reitille `POST /project/:project_id/clone` (`HttpController.js:135`), jota mikään webissä ei kutsu. |

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `RetryManager.js:113-126` | Lataa kaikki epäonnistumiset uudelleenyritysten cron-töitä varten (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). Soft-työ käsittelee jonon uudelleen; hard-työ synkronoi projektin uudelleen, hard-uudelleensynkronointina, kun `resyncAttempts` on vähintään 1 eikä virhe ole käynnissä oleva uudelleensynkronointi (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | Kaikkien projektien flush ohittaa projektit, joilla on epäonnistuminen. |
| `UpdatesProcessor.js:578-592` | Lukee kentän `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` ja `getFailedProjects`: käyttävät `GET /project/:project_id/debug-info` (`HttpController.js:571`) sekä `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Huomautuksia

* Dokumentti säilyy, kunnes projektin flush onnistuu tai projekti poistetaan (`clearError` yllä), joten jokainen dokumentti merkitsee projektia, jonka viimeisin flush tai uudelleensynkronointi ei ole vielä onnistunut.
* Merkkijonolla `OError:` alkavat virhemerkkijonot palautetaan muodossa `Error:` (`ErrorRecorder.js:18-26`); tallennettu arvo ei muutu.


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