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

# Dropbox Entities-samlingen

`dropboxEntities` indeholder ét dokument pr. fil, som Dropbox-synkroniseringen har kopieret mellem et projekt og én brugers Dropbox, plus kortlivede tombstones. Samlingen hører til Dropbox-synkroniseringen: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) skriver og læser den, og webmodulet `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) rydder den. Der er intet Mongoose-skema.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Sættes af driveren ved indsættelse. | `StateManager.mjs:46,97` |
| `overleaf.userId` | ObjectId | Brugeren, hvis Dropbox har filen. Sættes på hvert dokument. | `StateManager.mjs:48,98` |
| `overleaf.projectId` | ObjectId | Projektet for doc'en eller filen. Sættes, når det er kendt; tombstones har intet. | `StateManager.mjs:49-51` |
| `overleaf.id` | ObjectId | `_id` for doc'en eller filen i projektets `rootFolder`. Sættes, når den er kendt. | `StateManager.mjs:52` |
| `overleaf.type` | String | `doc` eller `file`. Den nuværende kode skriver den, men læser den ikke. | `StateManager.mjs:53`; værdier fra `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateSender.mjs:35,96` og `UpdateMerger.mjs:104,119` |
| `dropbox.id` | String | Filens `id` i Dropbox-filens metadata. Sættes ikke på tombstones. | `StateManager.mjs:56` |
| `dropbox.pathLower` | String | Filens sti i Dropbox, med små bogstaver og uden afsluttende skråstreg. Opdateres, når filen eller dens projektmappe flyttes. | `StateManager.mjs:14-16,57,91,99` |
| `dropbox.rev` | String | Dropbox-revisionen ved seneste synkronisering. Næste upload sender den, så en fil, der er ændret i Dropbox, ikke overskrives. | `StateManager.mjs:58`, `JobProcessor.mjs:114-122` |
| `dropbox.contentHash` | String | Dropbox-indholdshashen ved seneste synkronisering. En listet fil med samme hash springes over, da den er vores egen upload eller allerede er anvendt. | `StateManager.mjs:59`, `PullManager.mjs:147-149` |
| `tombstone` | Boolean | `true` markerer en sti, som third-party-datastore selv har slettet eller flyttet væk i Dropbox. Når Dropbox melder sletningen tilbage, anvendes den ikke på projektet. | `StateManager.mjs:100`, `PullManager.mjs:189-192` |
| `createdAt` | Date | Kun tombstones: hvornår den blev oprettet. Et afsluttet pull fjerner de tombstones, der blev oprettet, før det startede. | `StateManager.mjs:101,115-121` |

En tombstone har kun `overleaf.userId`, `dropbox.pathLower`, `tombstone` og `createdAt` (`StateManager.mjs:96-103`).

#### Hvem skriver den

| Kode | Hvad den gør |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:35-62` (`recordEntity`) | Sletter brugerens dokumenter med samme `dropbox.id`, `dropbox.pathLower` eller `overleaf.id` og indsætter derefter den nye tilstand. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:102-134` (`addEntity`) | Registrerer en doc eller fil efter upload fra Overleaf til Dropbox (`:125-133`). |
| `services/third-party-datastore/app/js/PullManager.mjs:142-177` (`applyFile`) | Registrerer en Dropbox-fil, efter at web har anvendt den på projektet (`:168-176`). |
| `StateManager.mjs:80-94` (`moveEntities`) | Omskriver `dropbox.pathLower` under en flyttet sti: omdøbning af projekt (`JobProcessor.mjs:195`) og flytning af fil eller mappe (`JobProcessor.mjs:239`). |
| `StateManager.mjs:96-103` (`addTombstone`) | Efter en sletning (`JobProcessor.mjs:153`), en omdøbning af projekt (`:202`) eller en flytning (`:240`) i Dropbox. |
| `StateManager.mjs:72-78` (`removeEntities`) | Sletter posterne på og under en sti, undtagen tombstones: efter en sletning fra Overleaf (`JobProcessor.mjs:152`) eller i Dropbox (`PullManager.mjs:206`). |
| `StateManager.mjs:115-121` (`clearTombstones`) | Ved afslutningen af et pull (`PullManager.mjs:31,69`). |
| `StateManager.mjs:186-190` (`removeUserState`), kaldt fra `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Sletter alle brugerens dokumenter, når third-party-datastore frakobler en konto, den ikke længere kan bruge. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Sletter alle brugerens dokumenter ved tilknytning (`:125`), ved frakobling (`:183`) og når en slettet bruger udløber (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Sletter projektets dokumenter, når et slettet projekt udløber (`index.mjs:54-56`). |

#### Hvem læser den

| Kode | Hvad den gør |
| - | - |
| `StateManager.mjs:64-70` (`findEntityByPath`) | Henter `dropbox.rev` før en upload (`JobProcessor.mjs:114`) og `dropbox.contentHash` før anvendelse af en Dropbox-fil (`PullManager.mjs:147`). |
| `StateManager.mjs:106-112` (`findTombstone`) | Kontrollerer en rapporteret sletning på stien eller en af dens overordnede stier (`PullManager.mjs:189`). |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Lister de synkroniserede filstier efter en nulstilling af markøren, så en fil, der mangler i listen, regnes som slettet (`PullManager.mjs:74-85`). |

#### Indekser

| Navn | Nøgler | Indstillinger | Migrering |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |
| `overleaf_userId_1_overleaf_projectId_1` | `overleaf.userId: 1, overleaf.projectId: 1` | | `tools/migrations/20250130104049_create_dropboxEntities_userId_projectId_index.mjs` |

`20220811111800_create_dropboxEntities_index.mjs` og `20220825160708_recreate_dropboxEntities.mjs` har kun tagget `saas`, så CE har hverken deres unikke indekser på `(overleaf.userId, dropbox.id)` og `(overleaf.userId, overleaf.id)` eller deres hashede indeks på `dropbox.pathLower`.

#### Bemærkninger

* Unikhed kommer kun fra sletningen før hver indsættelse i `recordEntity` (`StateManager.mjs:38-45`). Kommentaren i `StateManager.mjs:3-11` nævner unikke indekser; CE har dem ikke.
* Forespørgsler på bruger og sti (`findEntityByPath`, `findTombstone`, `removeEntities`) bruger kun indekset for `overleaf.userId`.


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