feat(backup): 实例备份第1轮——独立备份库迁移、settings 仓库路径字段、备份进度事件

packages/app-lib/backup_migrations/20260920131000_initial.sql

@@ -0,0 +1,76 @@
+CREATE TABLE repository_meta (
+	id INTEGER PRIMARY KEY CHECK (id = 0),
+	schema_name TEXT NOT NULL,
+	created_at INTEGER NOT NULL
+);
+
+INSERT INTO repository_meta (id, schema_name, created_at)
+VALUES (0, 'axolotl-instance-backups', unixepoch('subsec') * 1000);
+
+CREATE TABLE instance_backup_configs (
+	instance_id TEXT PRIMARY KEY,
+	instance_name TEXT NOT NULL,
+	created_at INTEGER NOT NULL,
+	modified_at INTEGER NOT NULL
+);
+
+CREATE TABLE backup_selections (
+	instance_id TEXT NOT NULL REFERENCES instance_backup_configs(instance_id) ON DELETE CASCADE,
+	path TEXT NOT NULL,
+	PRIMARY KEY (instance_id, path)
+);
+
+CREATE TABLE backup_snapshots (
+	id TEXT PRIMARY KEY,
+	instance_id TEXT NOT NULL REFERENCES instance_backup_configs(instance_id) ON DELETE CASCADE,
+	instance_name TEXT NOT NULL,
+	created_at INTEGER NOT NULL,
+	file_count INTEGER NOT NULL,
+	symlink_count INTEGER NOT NULL,
+	logical_size INTEGER NOT NULL,
+	added_size INTEGER NOT NULL
+);
+
+CREATE INDEX backup_snapshots_instance_created
+	ON backup_snapshots(instance_id, created_at DESC);
+
+CREATE TABLE snapshot_roots (
+	snapshot_id TEXT NOT NULL REFERENCES backup_snapshots(id) ON DELETE CASCADE,
+	path TEXT NOT NULL,
+	existed INTEGER NOT NULL,
+	PRIMARY KEY (snapshot_id, path)
+);
+
+CREATE TABLE backup_objects (
+	hash TEXT PRIMARY KEY,
+	size INTEGER NOT NULL,
+	ref_count INTEGER NOT NULL CHECK (ref_count >= 0)
+);
+
+CREATE TABLE snapshot_entries (
+	snapshot_id TEXT NOT NULL REFERENCES backup_snapshots(id) ON DELETE CASCADE,
+	path TEXT NOT NULL,
+	kind TEXT NOT NULL CHECK (kind IN ('file', 'directory', 'symlink')),
+	object_hash TEXT REFERENCES backup_objects(hash),
+	size INTEGER NOT NULL DEFAULT 0,
+	modified_at INTEGER,
+	unix_mode INTEGER,
+	link_target TEXT,
+	link_is_directory INTEGER,
+	PRIMARY KEY (snapshot_id, path),
+	CHECK ((kind = 'file' AND object_hash IS NOT NULL) OR (kind != 'file' AND object_hash IS NULL)),
+	CHECK ((kind = 'symlink' AND link_target IS NOT NULL) OR (kind != 'symlink' AND link_target IS NULL))
+);
+
+CREATE INDEX snapshot_entries_object_hash
+	ON snapshot_entries(object_hash) WHERE object_hash IS NOT NULL;
+
+CREATE TABLE object_gc_queue (
+	hash TEXT PRIMARY KEY,
+	queued_at INTEGER NOT NULL
+);
+
+CREATE TABLE pending_instance_deletions (
+	instance_id TEXT PRIMARY KEY,
+	marked_at INTEGER NOT NULL
+);

packages/app-lib/backup_migrations/20260920150000_exclusion_rules.sql

@@ -0,0 +1,19 @@
+ALTER TABLE backup_snapshots
+	ADD COLUMN scope_mode TEXT NOT NULL DEFAULT 'included_roots'
+	CHECK (scope_mode IN ('included_roots', 'excluded_paths'));
+
+DROP TABLE backup_selections;
+
+CREATE TABLE backup_exclusions (
+	instance_id TEXT NOT NULL REFERENCES instance_backup_configs(instance_id) ON DELETE CASCADE,
+	path TEXT NOT NULL,
+	kind TEXT NOT NULL CHECK (kind IN ('file', 'directory')),
+	PRIMARY KEY (instance_id, path)
+);
+
+CREATE TABLE snapshot_exclusions (
+	snapshot_id TEXT NOT NULL REFERENCES backup_snapshots(id) ON DELETE CASCADE,
+	path TEXT NOT NULL,
+	kind TEXT NOT NULL CHECK (kind IN ('file', 'directory')),
+	PRIMARY KEY (snapshot_id, path)
+);

packages/app-lib/backup_migrations/20260920200000_operations.sql

@@ -0,0 +1,26 @@
+CREATE TABLE backup_operations (
+	id TEXT PRIMARY KEY,
+	operation_type TEXT NOT NULL
+		CHECK (operation_type IN ('create', 'restore')),
+	instance_id TEXT NOT NULL,
+	snapshot_id TEXT,
+	state TEXT NOT NULL
+		CHECK (state IN (
+			'queued', 'scanning', 'hashing', 'saving', 'validating',
+			'materializing', 'applying', 'completed', 'cancelled', 'failed', 'interrupted'
+		)),
+	processed_bytes INTEGER NOT NULL DEFAULT 0,
+	total_bytes INTEGER NOT NULL DEFAULT 0,
+	cancellable INTEGER NOT NULL DEFAULT 1,
+	error TEXT,
+	created_at INTEGER NOT NULL,
+	updated_at INTEGER NOT NULL,
+	finished_at INTEGER
+);
+
+CREATE INDEX backup_operations_instance_created
+	ON backup_operations(instance_id, created_at DESC);
+
+CREATE INDEX backup_operations_active
+	ON backup_operations(state, updated_at DESC)
+	WHERE state NOT IN ('completed', 'cancelled', 'failed', 'interrupted');

packages/app-lib/backup_migrations/20260920210000_operation_cancellation.sql

@@ -0,0 +1,2 @@
+ALTER TABLE backup_operations
+	ADD COLUMN cancel_requested INTEGER NOT NULL DEFAULT 0;

packages/app-lib/backup_migrations/20260920223000_repository_move_operations.sql

@@ -0,0 +1,45 @@
+PRAGMA foreign_keys = OFF;
+
+CREATE TABLE backup_operations_new (
+	id TEXT PRIMARY KEY,
+	operation_type TEXT NOT NULL
+		CHECK (operation_type IN ('create', 'restore', 'repository_move')),
+	instance_id TEXT NOT NULL,
+	snapshot_id TEXT,
+	state TEXT NOT NULL
+		CHECK (state IN (
+			'queued', 'scanning', 'hashing', 'saving', 'validating',
+			'materializing', 'applying', 'completed', 'cancelled', 'failed', 'interrupted'
+		)),
+	processed_bytes INTEGER NOT NULL DEFAULT 0,
+	total_bytes INTEGER NOT NULL DEFAULT 0,
+	cancellable INTEGER NOT NULL DEFAULT 1,
+	error TEXT,
+	created_at INTEGER NOT NULL,
+	updated_at INTEGER NOT NULL,
+	finished_at INTEGER,
+	cancel_requested INTEGER NOT NULL DEFAULT 0
+);
+
+INSERT INTO backup_operations_new (
+	id, operation_type, instance_id, snapshot_id, state,
+	processed_bytes, total_bytes, cancellable, error,
+	created_at, updated_at, finished_at, cancel_requested
+)
+SELECT
+	id, operation_type, instance_id, snapshot_id, state,
+	processed_bytes, total_bytes, cancellable, error,
+	created_at, updated_at, finished_at, cancel_requested
+FROM backup_operations;
+
+DROP TABLE backup_operations;
+ALTER TABLE backup_operations_new RENAME TO backup_operations;
+
+CREATE INDEX backup_operations_instance_created
+	ON backup_operations(instance_id, created_at DESC);
+
+CREATE INDEX backup_operations_active
+	ON backup_operations(state, updated_at DESC)
+	WHERE state NOT IN ('completed', 'cancelled', 'failed', 'interrupted');
+
+PRAGMA foreign_keys = ON;

packages/app-lib/backup_migrations/20260920230000_restore_preview_operations.sql

@@ -0,0 +1,49 @@
+PRAGMA foreign_keys = OFF;
+
+CREATE TABLE backup_operations_new (
+	id TEXT PRIMARY KEY,
+	operation_type TEXT NOT NULL
+		CHECK (operation_type IN ('create', 'restore', 'repository_move', 'restore_preview')),
+	instance_id TEXT NOT NULL,
+	snapshot_id TEXT,
+	state TEXT NOT NULL
+		CHECK (state IN (
+			'queued', 'scanning', 'hashing', 'saving', 'validating',
+			'materializing', 'applying', 'completed', 'cancelled', 'failed', 'interrupted'
+		)),
+	processed_bytes INTEGER NOT NULL DEFAULT 0,
+	total_bytes INTEGER NOT NULL DEFAULT 0,
+	cancellable INTEGER NOT NULL DEFAULT 1,
+	error TEXT,
+	created_at INTEGER NOT NULL,
+	updated_at INTEGER NOT NULL,
+	finished_at INTEGER,
+	cancel_requested INTEGER NOT NULL DEFAULT 0,
+	preview_added_files INTEGER,
+	preview_modified_files INTEGER,
+	preview_deleted_files INTEGER,
+	preview_plan_token TEXT
+);
+
+INSERT INTO backup_operations_new (
+	id, operation_type, instance_id, snapshot_id, state,
+	processed_bytes, total_bytes, cancellable, error,
+	created_at, updated_at, finished_at, cancel_requested
+)
+SELECT
+	id, operation_type, instance_id, snapshot_id, state,
+	processed_bytes, total_bytes, cancellable, error,
+	created_at, updated_at, finished_at, cancel_requested
+FROM backup_operations;
+
+DROP TABLE backup_operations;
+ALTER TABLE backup_operations_new RENAME TO backup_operations;
+
+CREATE INDEX backup_operations_instance_created
+	ON backup_operations(instance_id, created_at DESC);
+
+CREATE INDEX backup_operations_active
+	ON backup_operations(state, updated_at DESC)
+	WHERE state NOT IN ('completed', 'cancelled', 'failed', 'interrupted');
+
+PRAGMA foreign_keys = ON;