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

# Doc-Snapshots-kokoelma

`docSnapshots` sisältää kopioita dokumentista, jotka document-updater ottaa juuri ennen muokkausta, joka tiivistää kommentteja tai seurattuja muutoksia. Vain document-updater kirjoittaa siihen, tiedostossa `services/document-updater/app/js/SnapshotManager.js`. Webillä on Mongoose-malli tiedostossa `services/web/app/src/models/DocSnapshot.mjs`, mutta mikään koodi ei käytä sitä.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Tilannevedoksen tunniste. | `SnapshotManager.js:24` |
| `project_id` | ObjectId | Projekti. | `SnapshotManager.js:19,26`, `DocSnapshot.mjs:7` |
| `doc_id` | ObjectId | Dokumentti (`docs._id`). | `SnapshotManager.js:20,27`, `DocSnapshot.mjs:8` |
| `version` | Number | Dokumentin OT-versio ennen muokkausta. | `SnapshotManager.js:28`, `services/document-updater/app/js/UpdateManager.js:132,264-271`, `DocSnapshot.mjs:9` |
| `lines` | Array of String | Dokumentin sisältö ennen muokkausta. | `SnapshotManager.js:29`, `DocSnapshot.mjs:10` |
| `pathname` | String | Dokumentin polku projektissa sillä hetkellä. | `SnapshotManager.js:30`, `DocSnapshot.mjs:11` |
| `ranges` | Mixed | `comments` ja `changes` ennen muokkausta, samassa muodossa kuin `docs.ranges` (katso [docs](https://ayakaleaf-pro.mintlify.site/fi/dev/data-model/docs-collection.md)). `id`, `op.t` ja `metadata.user_id` muunnetaan ObjectId-arvoiksi ja `metadata.ts` Date-arvoksi. | `SnapshotManager.js:31,41-68`, `DocSnapshot.mjs:12` |
| `ts` | Date | Milloin tilannevedos otettiin. TTL-indeksi poistaa sen 30 päivän kuluttua. | `SnapshotManager.js:32`, `DocSnapshot.mjs:13` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `UpdateManager.js:248-271` | Sovellettuaan muokkauksen document-updater tallentaa dokumentin muokkausta edeltävässä tilassa, jos muokkaus tiivisti alueita: tyhjiä alueita tuli lisää tai useampi kuin yksi alue poistettiin (`services/document-updater/app/js/RangesManager.js:104-106`). |
| `SnapshotManager.js:17-36` `recordSnapshot` | Lisää tilannevedoksen. |

#### Kuka lukee

Mikään koodi ei lue sitä. Web-malli on määritelty, mutta sitä ei käytetä missään.

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `ts_1` | `{ ts: 1 }` | TTL, `expireAfterSeconds: 2592000` (30 päivää) | `tools/migrations/20190912145007_create_docSnapshots_indexes.mjs` |
| `project_id_1_ts_1` | `{ project_id: 1, ts: 1 }` | | `tools/migrations/20200120163346_atlas_recommended_indexes.mjs` |

Tiedoston `20190912145007_create_docSnapshots_indexes.mjs` indeksi `project_id_1` poistettiin migraatiolla `20231101191643_drop_unused_indexes.mjs`.

#### Huomautuksia

* Vain `UpdateManager.applyUpdate`:n kautta kulkevat muokkaukset ottavat tilannevedoksia. `HistoryOTUpdateManager`:n käsittelemät muokkaukset eivät ota (`UpdateManager.js:74-77`).
* Kentällä `doc_id` ei ole indeksiä. Hae dokumentin tilannevedokset kentillä `project_id` ja `ts` ja suodata sitten kentällä `doc_id`.


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