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

`projectHistoryChunks` inneholder ett dokument per historikkchunk, en rekke versjoner i historikken til ett prosjekt. Mongo inneholder bare chunkens metadata; selve chunken (et øyeblikksbilde pluss endringene etter det) er et gzip-komprimert JSON-objekt i chunks-bucketen. Det finnes ikke noe Mongoose-skjema: history-v1 skriver samlingen i `services/history-v1/storage/lib/chunk_store/mongo.js`, som den bruker for hver historikk-id på 24 heksadesimale tegn, som i CE (`services/history-v1/storage/lib/chunk_store/index.js:644-652`).

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Chunk-id. Den navngir også chunkobjektet i bucketen (se Merknader). | `mongo.js:183-185` |
| `projectId` | ObjectId | Prosjektets historikk-id, verdien i `projects.overleaf.history.id`. I CE oppretter web historikken med prosjektets egen `_id` (`services/web/app/src/Features/History/HistoryManager.mjs:51-55`). | `mongo.js:186` |
| `startVersion` | Number | Prosjektversjon før den første endringen i chunken. | `mongo.js:187` |
| `endVersion` | Number | Prosjektversjon etter den siste endringen i chunken. | `mongo.js:188` |
| `endTimestamp` | Date | Tidspunktet for den siste endringen i chunken; `null` når chunken ikke har endringer, som den første chunken i et nytt prosjekt (`libraries/overleaf-editor-core/lib/chunk.js:146-149`). | `mongo.js:189` |
| `state` | String | `pending`, `active`, `closed` eller `deleted`, se Merknader. | `mongo.js:190`, `343`, `378`, `409` |
| `updatedAt` | Date | Settes ved innsetting, aktivering og sletting. Å lukke en chunk endrer den ikke. | `mongo.js:191`, `343`, `409`, `434`, `450` |

#### Hvem skriver

| Kode | Hva den gjør |
| - | - |
| `services/history-v1/storage/lib/chunk_store/mongo.js:179-194` | `insertPendingChunk`: setter inn en `pending`-post før chunkobjektet lastes opp (`chunk_store/index.js:394-410`). |
| `mongo.js:331-359` | `activateChunk`: `pending` til `active` når opplastingen er ferdig. En duplikatnøkkel her betyr at en annen chunk allerede begynner ved den versjonen. |
| `mongo.js:371-388` | `closeChunk`: `active` til `closed` når en ny chunk følger (`confirmCreate`, `mongo.js:206-227`). |
| `mongo.js:402-419` | `deleteActiveChunk`: `active` til `deleted` når en lengre chunk med samme startversjon erstatter den (`confirmUpdate`, `mongo.js:295-321`). |
| `mongo.js:428-452` | `deleteChunk` og `deleteProjectChunks`: markerer chunker som `deleted`. Den andre kjører ved history-v1 `DELETE /projects/:project_id` (`services/history-v1/api/controllers/projects.js:361-373`). |
| `mongo.js:144-174` | `clone`: kopierer et prosjekts poster under en ny historikk-id, for history-v1 `POST /projects/:project_id/clone`. Web har en klient for denne ruten (`HistoryManager.mjs:63-72`), men ingenting i web kaller den. |
| `mongo.js:497-502` | `deleteOldChunks`: fjerner gamle `deleted`- og `pending`-poster. Kjøres bare av `services/history-v1/storage/tasks/delete_old_chunks.js`. |

Nye chunker kommer fra project-history, som sender de køede redigeringene til history-v1 `POST /projects/:project_id/legacy_changes` (`services/history-v1/api/routes/project_import.js:29-31`); history-v1 kaller deretter `chunkStore.update` eller `chunkStore.create` (`services/history-v1/storage/lib/persist_changes.js:215`, `229`). Et nytt prosjekt får sin første chunk fra `chunkStore.initializeProject` (`chunk_store/index.js:54-80`).

#### Hvem leser

| Kode | Hva den gjør |
| - | - |
| `mongo.js:23-43` | `getLatestChunk`: den nyeste `active`- eller `closed`-chunken i et prosjekt. |
| `mongo.js:54-71` | `getChunkForVersion`: chunken som inneholder en versjon. |
| `mongo.js:77-103` | `getChunkForTimestamp`: chunken som var gjeldende på et tidspunkt. |
| `mongo.js:108-137` | `getProjectChunkIds` og `getProjectChunks`: alle levende chunker i et prosjekt. |
| `mongo.js:457-492` | `getOldChunksBatch`: gamle `deleted`- og `pending`-poster for oppryddingsoppgaven. |
| `services/history-v1/api/controllers/projects.js:115-265` | Leserutene i history-v1 (nyeste innhold, innhold ved en versjon, historikk, endringer), som laster inn chunker via `chunk_store/index.js`. |

#### Indekser

| Navn | Nøkler | Alternativer | Migrering |
| - | - | - | - |
| `projectId_1_startVersion_1_v2` | `{ projectId: 1, startVersion: 1 }` | unique, delvis: `state` i `active`, `closed` | `tools/migrations/20250411200550_active_chunk_index_update.mjs` (erstatter `projectId_1_startVersion_1` fra `20221122191857_project_history_chunks_indexes.mjs`) |
| `deleted_updated_at` | `{ updatedAt: 1 }` | delvis: `state: 'deleted'` | `tools/migrations/20230428154643_history_chunks_garbage_collection_index.mjs` (erstatter `state_1`) |
| `pending_updated_at` | `{ updatedAt: -1 }` | delvis: `state: 'pending'` | `tools/migrations/20230428154643_history_chunks_garbage_collection_index.mjs` (erstatter `state_pending` fra `20230217205311_fix_deleted_history_chunks_index.mjs`) |

#### Merknader

* Tilstandsflyt: `pending` (post skrevet, opplasting pågår) → `active` (den nyeste chunken, kan fortsatt utvides) → `closed` (en nyere chunk følger) eller `deleted` (erstattet, eller prosjektet ble slettet). Lesinger ser bare på `active` og `closed`.
* Chunkobjektet er gzip-komprimert JSON (`services/history-v1/storage/lib/history_store.js:151-170`) under nøkkelen `<project key>/<chunk id>` (`history_store.js:65-67`). Prosjektnøkkelen er historikk-id-en fylt ut med nuller, snudd og delt opp i 3/3/resten av tegnene (`libraries/object-persistor/src/ProjectKey.js:8-15`). Bucketen er `OVERLEAF_EDITOR_CHUNKS_BUCKET` (`services/history-v1/config/custom-environment-variables.json:53-56`): `/buckets/chunks` i utviklingsmiljøet (`develop/docker-compose.yml:90`), eller `overleaf-chunks` med `S3_ENABLED=true` (`develop/s3/docker-compose.yml:51`).
* Poster i tilstanden `deleted` eller `pending`, og bucketobjektene deres, fjernes bare av `delete_old_chunks.js` (`yarn delete_old_chunks`, `services/history-v1/package.json:79`). CE-imaget har ingen cronjobb for dette (`server-ce/config/crontab-history`, `server-ce/config/crontab-deletion`), så i CE blir de liggende.
* Når web lar et slettet prosjekt utløpe, kaller den history-v1 `DELETE /projects/:history_id` (`services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391`, `HistoryManager.mjs:127-135`, `152-162`), som markerer alle prosjektets chunker som `deleted`.
* Med en konfigurert `backupStore` skriver bekreftelsen av en chunk også `overleaf.history.currentEndVersion`, `currentEndTimestamp`, `updatedAt` og `overleaf.backup.pendingChangeAt` til prosjektet (`mongo.js:232-262`). CE konfigurerer ikke `backupStore`, så `mongo.js:238-240` returnerer tidlig.


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