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

`projectHistoryFailures` зберігає по одному документу на проєкт, оновлення історії якого project-history не зміг обробити або для якого він запустив ресинхронізацію. Документ знову видаляється, щойно обробка проходить успішно. project-history записує її в `services/project-history/app/js/ErrorRecorder.js`; її тип описано в `services/project-history/app/js/mongo-types.ts:3-24`. У web теж є схема Mongoose для неї (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), але жоден код web цю модель не використовує.

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Створюється upsert-ом. | `ErrorRecorder.js:45-60` |
| `project_id` | String | Ідентифікатор проєкту, зберігається як рядок, а не ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | Остання помилка у вигляді `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Стек останньої помилки. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Оновлення, що чекали в черзі Redis проєкту під час останньої помилки (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1`, якщо помилка виникла під час запуску ресинхронізації (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Час останньої помилки. | `ErrorRecorder.js:39` |
| `attempts` | Number | Кількість помилок, записаних від створення документа. | `ErrorRecorder.js:49` |
| `history` | Array of Object | Останні 10 подій, спочатку нові: записи про помилки `{ queueSize, error, stack, ts }` і запуски ресинхронізації `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Коли було запущено останню ресинхронізацію. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Кількість ресинхронізацій, запущених від створення документа. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Встановлюється project-history `POST /project/:project_id/force` (`?clear=true` задає значення `false`). Поки `true`, помилка ops-out-of-order у збереженому chunk записується в журнал і ігнорується (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | Є у схемі web (`ProjectHistoryFailure.mjs:16`). Збільшує його лише `ErrorRecorder.getLastFailure`, а цю функцію ніхто не викликає. | `ErrorRecorder.js:131-138` |

#### Хто записує

| Код | Що робить |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: upsert помилки, `attempts` +1, запис додається до `history`. Викликається, коли обробка оновлень проєкту завершується збоєм (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`), і коли ресинхронізацію не вдається запустити (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert, `resyncStartedAt`, `resyncAttempts` +1, запис додається до `history` під час кожного запуску ресинхронізації (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: видаляє документ після успішного flush (`UpdatesProcessor.js:101`, `194`, `259`, `355`), під час project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) і за некоректного ідентифікатора проєкту під час повторної спроби (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: upsert `forceDebug` (`HttpController.js:1016-1035`, маршрут у `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: копіює документ в інший проєкт, для project-history `POST /project/:project_id/clone` (`HttpController.js:135`), який ніщо у web не викликає. |

#### Хто читає

| Код | Що робить |
| - | - |
| `RetryManager.js:113-126` | Завантажує всі збої для cron-завдань повторних спроб (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). Soft-завдання знову обробляє чергу; hard-завдання ресинхронізує проєкт, причому як hard-ресинхронізацію, коли `resyncAttempts` не менше 1 і помилка не є запущеною ресинхронізацією (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | Flush усіх проєктів пропускає проєкти зі збоєм. |
| `UpdatesProcessor.js:578-592` | Читає `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` і `getFailedProjects`: використовуються `GET /project/:project_id/debug-info` (`HttpController.js:571`) та `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Індекси

| Назва | Ключі | Параметри | Міграція |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Примітки

* Документ залишається, доки flush проєкту не пройде успішно або проєкт не буде видалено (`clearError` вище), тож кожен документ позначає проєкт, останній flush або ресинхронізація якого ще не вдалися.
* Рядки помилок, що починаються з `OError:`, повертаються як `Error:` (`ErrorRecorder.js:18-26`); збережене значення не змінюється.


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