alexei.dolgolyov
a9c7775bb7
Add backup/restore functionality for the SQLite database. Users can trigger manual backups, configure automatic backups on an interval with retention policies, list/download/delete backups, and restore from any backup. - Backup engine using VACUUM INTO (safe with WAL mode) - Backup metadata tracked in DB, files stored in DATA_DIR/backups/ - Settings: backup_enabled, backup_interval_hours, backup_retention_count - API: POST/GET/DELETE /api/backups, download, restore endpoints - Autobackup via cron scheduler with configurable interval - Retention: prune on startup, after each backup (manual and auto) - Orphan cleanup: removes backup files without metadata on startup - Restore: replaces DB and triggers graceful server shutdown - Settings UI: /settings/backup with toggle, interval, retention config - Backup list with download, delete, restore actions - i18n: English and Russian translations
1.6 KiB
1.6 KiB
Phase 2: Backup API Endpoints
Status: ⬜ Not Started Parent plan: PLAN.md Domain: backend
Objective
Expose backup operations via REST API and wire autobackup scheduling.
Tasks
- Task 1: Create
internal/api/backups.gowith handlersPOST /api/backups— trigger manual backupGET /api/backups— list all backupsGET /api/backups/{id}/download— download backup fileDELETE /api/backups/{id}— delete backupPOST /api/backups/{id}/restore— restore from backup
- Task 2: Register routes in router.go (admin-only)
- Task 3: Add backup engine to Server struct
- SetBackupEngine method (same pattern as SetProxyManager)
- Task 4: Wire autobackup cron in main.go
- Create backup engine on startup
- If backup_enabled, schedule cron job
- Graceful shutdown: stop cron
- Task 5: Update settings handler to restart autobackup cron on settings change
- Task 6: Add GET /api/settings response fields for backup settings
Files to Modify/Create
internal/api/backups.go— new handler fileinternal/api/router.go— register routes, add engine fieldcmd/server/main.go— wire engine, schedule croninternal/api/settings.go— include backup fields in GET/PUT
Acceptance Criteria
- All CRUD endpoints work for backups
- Manual backup creates file and returns metadata
- Download streams the backup file
- Restore replaces DB (may require restart)
- Autobackup runs on configured interval
- Settings change updates cron schedule