Documentație · 04

Backup și restaurare, responsabilitatea ta totală.

Pentru că datele tale stau local (NU pe cloud-ul nostru), responsabilitatea pentru backup e a ta. Pagina explică unde se află baza de date, cum faci backup manual sau automat, cum restaurezi după reinstalare OS sau pe alt calculator, ce se întâmplă când upgradezi între versiuni majore.

Conținut în extindere: ghidul cu screenshots, scripts auto-backup și recovery walkthrough se publică la lansarea publică v1.0. Pagina actuală oferă cadrul conceptual + locațiile bazei de date + workflow-uri esențiale.

Unde stă baza de date

Aplicația folosește SQLite cu WAL mode. Locațiile implicite per OS:

  • Windows: %APPDATA%\SEO Master PRO MAX\database.db (de obicei C:\Users\NumeUtilizator\AppData\Roaming\SEO Master PRO MAX\)
  • macOS: ~/Library/Application Support/SEO Master PRO MAX/database.db
  • Linux: ~/.config/SEO Master PRO MAX/database.db

Lângă database.db găsești și fișierele auxiliare WAL (database.db-wal și database.db-shm) care pot exista temporar — pentru backup complet, copiezi toate trei (sau închizi aplicația întâi pentru a permite check-pointing automatic).

Poți schimba locația implicită din Settings → Storage → Database location (util pentru SSD extern, NAS, sau folder cu backup automat tip Dropbox / OneDrive).

Backup manual

Trei metode, în ordinea preferinței:

  1. Export .smp: File → Export → Full project. Generează un fișier .smp (SEO Master Project) compresat care conține întreaga bază + setări (fără chei API). Util pentru transfer pe alt device sau backup periodic.
  2. Copy fișier .db: închide aplicația, copiezi manual database.db + database.db-wal + database.db-shm într-un folder backup. Alternativă pentru cei care vor control total.
  3. Sync automat opt-in: dacă ai mutat baza de date într-un folder Dropbox / Google Drive / OneDrive / iCloud, sync-ul se face automat la fiecare modificare. Avantaj: zero efort manual. Dezavantaj: dacă închizi aplicația mid-sync, pot apărea conflicts (aplicația detectează și anunță la următoarea pornire).

Restaurare pe același calculator

Scenariu tipic: ai stricat ceva accidental (ștergere audit important, configurare greșită, etc.) și vrei să te întorci la backup recent.

  1. Închide aplicația complet.
  2. Renumeste actualul database.db în database.db.broken (păstrează ca evidență).
  3. Copiază backup-ul (.db sau extras din .smp) la locația standard.
  4. Deschide aplicația — se conectează automat la baza nou plasată.

Pentru restaurare din .smp: File → Import → Full project. Aplicația te avertizează că va înlocui baza curentă; confirmi și restaurarea durează 10-30 secunde.

Restaurare pe alt calculator

Scenariu: vrei să muți tot setup-ul pe laptop nou sau alt OS.

  1. Pe calculatorul vechi: File → Export → Full project. Salvezi .smp.
  2. Transferi .smp pe noul calculator (USB, cloud sync, email).
  3. Pe calculatorul nou: instalezi aplicația, treci wizard-ul minim (poți sări configurarea AI providers, vine din import).
  4. File → Import → Full project. Selectezi .smp. Restaurare completă: audit-uri, history, queries tracking, schema templates, totul.
  5. Cheile AI NU sunt în .smp (din motive de securitate). Le re-adaugi manual pe noul device prin Settings → AI Providers.

Backup automat săptămânal (recomandat)

Pentru consultanți cu 5+ clienți activi, backup zilnic / săptămânal automat e esențial. Două abordări:

  • Sync folder cloud: muți baza de date într-un folder Dropbox / Google Drive / iCloud. Sync continuu, zero efort. Recomandare: Dropbox (cel mai matur pe sync conflicts) sau iCloud Drive (pentru macOS, integrare native).
  • Script automat: cron job (macOS / Linux) sau Task Scheduler (Windows) care rulează săptămânal export .smp către un folder backup local + cloud. Tutorial concret cu script-uri se publică la v1.0.

Migrare între versiuni majore

La upgrade între versiuni majore (ex: v1.0 → v2.0), aplicația poate cere migrare schema baza de date. Workflow:

  1. Aplicația detectează versiune nouă la prima rulare post-update.
  2. Recomandă backup automat al bazei actuale (genereazi database-backup-pre-v2.db).
  3. Rulează migrare schema (1-30 secunde tipic, depinde de volumul de date).
  4. Validează integritatea post-migrare.
  5. Dacă ceva merge prost, rollback la backup automat (instrucțiuni clare în UI).

Pentru orice problemă de migrare, scrie la [email protected] cu fișierele database-backup-pre-vX.db + log-ul migrării (Settings → Logs → Export).

Troubleshooting comun

  • „Database is locked”: altă instanță aplicației rulează. Închide toate, retry. Dacă persistă, verifică Task Manager / Activity Monitor pentru proces zombie.
  • „Corrupt database file”: baza de date stricată (rar — poate apărea după crash mid-write). Restaurare din ultimul backup. Dacă nu ai backup, contact pentru recovery scripts (uneori SQLite poate fi reparat cu PRAGMA integrity_check).
  • „Sync conflicts în Dropbox”: ai modificat baza pe două device-uri simultan. Dropbox păstrează ambele versiuni ((conflict) suffix). Compară manual + alegi versiunea bună.

Backup-ul tău, control total.

Datele tale stau în fișiere SQLite simple pe disk-ul tău. Nu există vendor lock-in, nu există dependență de cloud-ul nostru. Migrare la alt tool (dacă vrei) = export CSV / JSON din Settings → Export.