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

# Samlingen Dropbox Entities

`dropboxEntities` innehåller ett dokument per fil som Dropbox-synkroniseringen har kopierat mellan ett projekt och en användares Dropbox, samt kortlivade tombstones. Samlingen hör till Dropbox-synkroniseringen: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) skriver och läser den, och webbmodulen `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) rensar den. Det finns inget Mongoose-schema.

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Sätts av drivrutinen vid infogning. | `StateManager.mjs:46,97` |
| `overleaf.userId` | ObjectId | Användaren vars Dropbox har filen. Sätts på varje dokument. | `StateManager.mjs:48,98` |
| `overleaf.projectId` | ObjectId | Projektet för docen eller filen. Sätts när det är känt; tombstones har inget. | `StateManager.mjs:49-51` |
| `overleaf.id` | ObjectId | `_id` för docen eller filen i projektets `rootFolder`. Sätts när den är känd. | `StateManager.mjs:52` |
| `overleaf.type` | String | `doc` eller `file`. Den nuvarande koden skriver det men läser det inte. | `StateManager.mjs:53`; värden från `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateSender.mjs:35,96` och `UpdateMerger.mjs:104,119` |
| `dropbox.id` | String | Filens `id` i Dropbox-filens metadata. Sätts inte på tombstones. | `StateManager.mjs:56` |
| `dropbox.pathLower` | String | Filens sökväg i Dropbox, i gemener och utan avslutande snedstreck. Uppdateras när filen eller dess projektmapp flyttas. | `StateManager.mjs:14-16,57,91,99` |
| `dropbox.rev` | String | Dropbox-revisionen vid den senaste synkningen. Nästa uppladdning skickar den, så att en fil som ändrats i Dropbox inte skrivs över. | `StateManager.mjs:58`, `JobProcessor.mjs:114-122` |
| `dropbox.contentHash` | String | Dropbox-innehållshashen vid den senaste synkningen. En listad fil med samma hash hoppas över, eftersom den är vår egen uppladdning eller redan tillämpad. | `StateManager.mjs:59`, `PullManager.mjs:147-149` |
| `tombstone` | Boolean | `true` markerar en sökväg som third-party-datastore själv har tagit bort eller flyttat bort i Dropbox. När Dropbox rapporterar tillbaka borttagningen tillämpas den inte på projektet. | `StateManager.mjs:100`, `PullManager.mjs:189-192` |
| `createdAt` | Date | Endast tombstones: när den skapades. En avslutad pull tar bort de tombstones som skapades innan den startade. | `StateManager.mjs:101,115-121` |

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

#### Vem som skriver den

| Kod | Vad den gör |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:35-62` (`recordEntity`) | Tar bort användarens dokument med samma `dropbox.id`, `dropbox.pathLower` eller `overleaf.id` och infogar sedan det nya tillståndet. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:102-134` (`addEntity`) | Registrerar en doc eller fil efter uppladdning från Overleaf till Dropbox (`:125-133`). |
| `services/third-party-datastore/app/js/PullManager.mjs:142-177` (`applyFile`) | Registrerar en Dropbox-fil efter att web har tillämpat den på projektet (`:168-176`). |
| `StateManager.mjs:80-94` (`moveEntities`) | Skriver om `dropbox.pathLower` under en flyttad sökväg: namnbyte av projekt (`JobProcessor.mjs:195`) och flytt av fil eller mapp (`JobProcessor.mjs:239`). |
| `StateManager.mjs:96-103` (`addTombstone`) | Efter en borttagning (`JobProcessor.mjs:153`), ett namnbyte av projekt (`:202`) eller en flytt (`:240`) i Dropbox. |
| `StateManager.mjs:72-78` (`removeEntities`) | Tar bort posterna på och under en sökväg, utom tombstones: efter en borttagning från Overleaf (`JobProcessor.mjs:152`) eller i Dropbox (`PullManager.mjs:206`). |
| `StateManager.mjs:115-121` (`clearTombstones`) | I slutet av en pull (`PullManager.mjs:31,69`). |
| `StateManager.mjs:186-190` (`removeUserState`), anropad från `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Tar bort alla användarens dokument när third-party-datastore kopplar bort ett konto som den inte längre kan använda. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Tar bort alla användarens dokument vid länkning (`:125`), vid avlänkning (`:183`) och när en borttagen användare löper ut (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Tar bort projektets dokument när ett borttaget projekt löper ut (`index.mjs:54-56`). |

#### Vem som läser den

| Kod | Vad den gör |
| - | - |
| `StateManager.mjs:64-70` (`findEntityByPath`) | Hämtar `dropbox.rev` före en uppladdning (`JobProcessor.mjs:114`) och `dropbox.contentHash` innan en Dropbox-fil tillämpas (`PullManager.mjs:147`). |
| `StateManager.mjs:106-112` (`findTombstone`) | Kontrollerar en rapporterad borttagning på sökvägen eller någon av dess överordnade sökvägar (`PullManager.mjs:189`). |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Listar de synkade filsökvägarna efter en återställning av markören, så att en fil som saknas i listningen räknas som borttagen (`PullManager.mjs:74-85`). |

#### Index

| Namn | Nycklar | Alternativ | 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` och `20220825160708_recreate_dropboxEntities.mjs` har bara taggen `saas`, så CE har varken deras unika index på `(overleaf.userId, dropbox.id)` och `(overleaf.userId, overleaf.id)` eller deras hashade index på `dropbox.pathLower`.

#### Anteckningar

* Unikheten kommer enbart från borttagningen före varje infogning i `recordEntity` (`StateManager.mjs:38-45`). Kommentaren i `StateManager.mjs:3-11` nämner unika index; CE har dem inte.
* Frågor på användare och sökväg (`findEntityByPath`, `findTombstone`, `removeEntities`) använder indexet bara för `overleaf.userId`.


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