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