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

# Coleção Project History Failures

`projectHistoryFailures` guarda um documento por projeto cujas atualizações de histórico o project-history não conseguiu processar, ou para o qual iniciou uma ressincronização. O documento é excluído de novo assim que o processamento funciona. O project-history a escreve em `services/project-history/app/js/ErrorRecorder.js`; seu tipo está em `services/project-history/app/js/mongo-types.ts:3-24`. O web também tem um schema Mongoose para ela (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), mas nenhum código do web usa esse modelo.

#### Campos

| Campo | Tipo | Significado | Origem |
| - | - | - | - |
| `_id` | ObjectId | Criado pelo upsert. | `ErrorRecorder.js:45-60` |
| `project_id` | String | O id do projeto, guardado como string, não como ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | O último erro, como `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Pilha do último erro. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Atualizações aguardando na fila Redis do projeto no último erro (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1` quando o erro veio do início de uma ressincronização (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Hora do último erro. | `ErrorRecorder.js:39` |
| `attempts` | Number | Número de erros registrados desde a criação do documento. | `ErrorRecorder.js:49` |
| `history` | Array of Object | Os últimos 10 eventos, mais recentes primeiro: registros de erro `{ queueSize, error, stack, ts }` e inícios de ressincronização `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | Quando a última ressincronização começou. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Número de ressincronizações iniciadas desde a criação do documento. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Definido pelo project-history `POST /project/:project_id/force` (`?clear=true` o define como `false`). Enquanto `true`, um erro ops-out-of-order no chunk armazenado é registrado em log e ignorado (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | No schema do web (`ProjectHistoryFailure.mjs:16`). Só `ErrorRecorder.getLastFailure` o incrementa, e nada chama essa função. | `ErrorRecorder.js:131-138` |

#### Quem a escreve

| Código | O que faz |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: upsert do erro, `attempts` +1, entrada adicionada a `history`. Chamado quando o processamento das atualizações de um projeto falha (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`) e quando uma ressincronização não consegue começar (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert, `resyncStartedAt`, `resyncAttempts` +1, entrada adicionada a `history`, cada vez que uma ressincronização começa (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: exclui o documento após um flush bem-sucedido (`UpdatesProcessor.js:101`, `194`, `259`, `355`), no project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) e para um id de projeto inválido durante uma nova tentativa (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: upsert de `forceDebug` (`HttpController.js:1016-1035`, rota em `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: copia o documento para outro projeto, para o project-history `POST /project/:project_id/clone` (`HttpController.js:135`), que nada no web chama. |

#### Quem a lê

| Código | O que faz |
| - | - |
| `RetryManager.js:113-126` | Carrega todas as falhas para os jobs cron de nova tentativa (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). O job soft processa a fila de novo; o job hard ressincroniza o projeto, como ressincronização hard quando `resyncAttempts` é pelo menos 1 e o erro não é uma ressincronização em andamento (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | O flush de todos os projetos pula os projetos que têm uma falha. |
| `UpdatesProcessor.js:578-592` | Lê `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` e `getFailedProjects`: usados por `GET /project/:project_id/debug-info` (`HttpController.js:571`) e `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Índices

| Nome | Chaves | Opções | Migração |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Notas

* Um documento permanece até que um flush do projeto tenha sucesso ou o projeto seja excluído (`clearError` acima), então cada documento marca um projeto cujo último flush ou ressincronização ainda não teve sucesso.
* Strings de erro que começam com `OError:` são retornadas como `Error:` (`ErrorRecorder.js:18-26`); o valor armazenado não muda.


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