Skip to content

Commit 4f7a3bc

Browse files
committed
docs(rfc): clarify risks of app termination during global database migration
(cherry picked from commit 81b5adb121a8bfe4961215b0738fa80698517231)
1 parent 9b3e0ac commit 4f7a3bc

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

docs/engineering/rfcs/0007-global-database.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,8 @@ Validation before cutover and the archive from step 1 cover that risk instead.
146146
## Risks & Drawbacks
147147

148148
- Migration requires time and storage, especially for downloaded attachments.
149+
- The user or operating system can terminate the app during migration, leaving an incomplete global database that must
150+
never become authoritative. The migration requires interruption-safe state tracking and restart recovery.
149151
- Rebuilding the search index during migration adds time proportional to locally stored mail.
150152
- A device without enough free space cannot migrate until space is freed.
151153
- After cutover, locally stored mail exists only in the global database and in any archive the user created.

0 commit comments

Comments
 (0)