added backup/restore feature
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
# Phase 008: Backup And Restore
|
||||
|
||||
## Goal
|
||||
Add backup and restore support for portable application data using compressed YAML files without adding new gem dependencies.
|
||||
|
||||
## Work
|
||||
- Add a backup/restore page linked from the main vehicle dashboard.
|
||||
- Export app data as a versioned YAML document compressed with gzip (`.yml.gz`).
|
||||
- Include users, vehicles, maintenance schedules, fuel entries, and maintenance entries.
|
||||
- Exclude authentication and runtime data, including access keys and user sessions.
|
||||
- Restore uploaded backups in either merge mode or replace mode.
|
||||
- Use portable references instead of raw database IDs so backups can be moved between installations.
|
||||
- Support older backup versions only when an explicit migration path exists.
|
||||
- Add request specs for export, merge restore, replace restore, invalid upload handling, and authentication.
|
||||
|
||||
## Decisions
|
||||
- Backups use gzip-compressed YAML instead of zip archives because no extra gem dependency should be added.
|
||||
- Any identified user may export or restore backups.
|
||||
- Merge mode updates matched users, vehicles, and maintenance schedules, and creates unmatched records.
|
||||
- Users are matched by normalized email.
|
||||
- Vehicles are matched by VIN.
|
||||
- Maintenance schedules are matched by vehicle and maintenance type.
|
||||
- Fuel and maintenance entries use natural keys to avoid duplicate imports.
|
||||
- Replace mode removes existing app data and imports the uploaded data inside one transaction.
|
||||
- Restore recalculates vehicle odometers from imported/stored vehicle odometers and event histories.
|
||||
|
||||
## Deliverables
|
||||
- Backup export/import services.
|
||||
- Backup controller and routes.
|
||||
- Backup/restore page and dashboard link.
|
||||
- Request specs for backup and restore behavior.
|
||||
- Phase execution notes.
|
||||
|
||||
## Acceptance Criteria
|
||||
- Authenticated users can download a `.yml.gz` backup from the app.
|
||||
- The backup contains app data only and excludes auth/session data.
|
||||
- Authenticated users can restore by replacing all app data.
|
||||
- Authenticated users can restore by merging portable records into existing app data.
|
||||
- Invalid or unsupported uploads fail with a clear user-facing error.
|
||||
- Backup and restore behavior is covered by request specs.
|
||||
Reference in New Issue
Block a user