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

`projectHistorySyncState` contém um documento por projeto que foi ressincronizado: o estado da ressincronização atual ou da última, quando o project-history reconstrói o histórico de um projeto a partir do que o web e o docstore guardam. Pertence ao project-history e não tem esquema Mongoose; o código é a classe `SyncState` e suas funções auxiliares em `services/project-history/app/js/SyncManager.js`.

#### Campos

| Campo | Tipo | Significado | Origem |
| - | - | - | - |
| `_id` | ObjectId | Criado pelo upsert. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | O projeto. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true` enquanto o project-history aguarda do web a estrutura do projeto (árvore de arquivos). | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Caminhos dos docs cujo conteúdo ele ainda aguarda. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Quem pediu a ressincronização, por exemplo `{ kind: 'history-resync' }`, o padrão. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` para uma ressincronização completa, que primeiro descarta as atualizações enfileiradas e o estado de sincronização antigo. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Opção da requisição de ressincronização (`HttpController.js:963-964`). Em uma ressincronização completa, um doc cujo conteúdo de histórico está corrompido é removido e adicionado novamente a partir do docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | Os últimos 100 estados, do mais recente ao mais antigo, cada um `{ syncState, timestamp }`; `syncState` contém os cinco campos acima. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Horário da última escrita. | `SyncManager.js:209` |
| `resyncCount` | Number | Número de ressincronizações iniciadas. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Quando a ressincronização em andamento começou; removido quando ela termina. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Definido para 90 dias após o fim de uma ressincronização e removido enquanto uma está em andamento. O índice TTL exclui o documento nesse momento. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Quantas vezes uma ressincronização travada foi limpa e reiniciada; removido quando uma ressincronização termina. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Horário da última limpeza desse tipo. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Caminhos de docs ainda pendentes na última limpeza. | `SyncManager.js:262`, `228` |

#### Quem escreve

| Código | O que faz |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert do estado. Chamado quando uma ressincronização começa (`SyncManager.js:163`) e enquanto o project-history processa as atualizações de ressincronização (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: conta uma ressincronização travada que é limpa. |
| `SyncManager.js:251-255` | `clearResyncState`: exclui o documento no início de uma ressincronização completa (`SyncManager.js:87`), em `DELETE /project/:project_id` do project-history (`services/project-history/app/js/HttpController.js:1363-1396`) e quando uma ressincronização só da estrutura precisa recomeçar (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: exclui um estado concluído cujo histórico é todo posterior a uma data. Nada em `app/js` o chama. |
| `SyncManager.js:171-181` | `cloneResyncState`: copia o estado para outro projeto, para `POST /project/:project_id/clone` do project-history (`HttpController.js:57`, `124`), que nada no web chama. |

Uma ressincronização é iniciada por `POST /project/:project_id/resync` do project-history (`HttpController.js:950-994`), pelos cron jobs de nova tentativa (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`) e pelo próprio project-history quando o processamento de atualizações precisa de uma (`UpdatesProcessor.js:75`, `224`).

#### Quem lê

| Código | O que faz |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: carrega o estado. Usado para decidir se uma ressincronização está em andamento antes de iniciar outra (`SyncManager.js:106-149`), para ignorar atualizações comuns enquanto ela executa (`SyncManager.js:291-300`) e, após um flush, para informar uma ressincronização em andamento (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: se uma ressincronização está em andamento ou travada. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: o estado de sincronização com o registro de falha. |

#### Índices

| Nome | Chaves | Opções | Migração |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145021_create_projectHistorySyncState_indexes.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0` | `tools/migrations/20190912145021_create_projectHistorySyncState_indexes.mjs` |

#### Notas

* Uma ressincronização está em andamento enquanto `resyncProjectStructure` é `true` ou `resyncDocContents` não está vazio (`SyncManager.js:565-567`). Ela é considerada travada após 4 horas, e travada permanentemente após 5 limpezas (`SyncManager.js:43-44`, `569-585`).
* Quando uma ressincronização termina, o project-history também define `overleaf.history.lastResyncedAt` no projeto (`SyncManager.js:239-248`).


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