From a0e7160c84cf4656e51900ee18de8d9e7cb8548b Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Thu, 20 Jan 2022 21:23:15 -0500
Subject: [PATCH] propose a path

---
 docs/source/designs/backup-recovery.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/source/designs/backup-recovery.rst b/docs/source/designs/backup-recovery.rst
index ff9cd60..15bef98 100644
--- a/docs/source/designs/backup-recovery.rst
+++ b/docs/source/designs/backup-recovery.rst
@@ -184,7 +184,23 @@ Detailed Implementation Design
 Summary
 ~~~~~~~
 
+Backup
+``````
 
+Significant state-changing operations will be recorded in the SQLite3 database.
+As quickly as possible entries from the in-database recording will be serialized to an application-specific format and appended to the on-grid recording,
+represented as a mutable object.
+As an optimization,
+when the recording grows large enough,
+a snapshot of the SQLite3 database will be uploaded to the grid and the on-grid recording will be cleared.
+
+Recovery
+````````
+
+The SQLite3 database snapshot is downloaded from the grid.
+The on-grid recording is downloaded and state changes are executed against that database.
+After the recording has been fully executed the database state has been recovered.
+Backup operations resume as usual from this point using the existing on-grid state.
 
 External Interfaces
 ~~~~~~~~~~~~~~~~~~~
-- 
GitLab