CompanySite/.agents/devops-engineer/BACKUP_VISUAL_GUIDE.txt

================================================================================
                  WORKROOT BACKUP SYSTEM - VISUAL GUIDE
================================================================================

--------------------------------------------------------------------------------
                         QUICK COMMAND REFERENCE
--------------------------------------------------------------------------------

  Setup (First Time)
     > bash scripts/backup/setup.sh

  Daily Operations
     > npm run backup:full       - Full backup
     > npm run backup:content    - Content only (quick)
     > npm run backup:config     - Config files only
     > npm run backup:verify     - Health check

  Recovery
     > npm run backup:list       - Show all backups
     > npm run backup:restore    - Restore (interactive)

  Maintenance
     > npm run backup:cleanup    - Remove old backups


--------------------------------------------------------------------------------
                          DIRECTORY STRUCTURE
--------------------------------------------------------------------------------

  backups/
  ├── daily/           [7 days]    <- Full backups (2:00 AM)
  ├── weekly/          [4 weeks]   <- Weekly snapshots (Sunday)
  ├── monthly/         [3 months]  <- Monthly archives (1st)
  ├── pre-deploy/      [Last 10]   <- Config before deploy
  ├── incremental/     [72 hours]  <- Content (every 6h)
  └── safety/          [30 days]   <- Pre-restore backups


--------------------------------------------------------------------------------
                        AUTOMATED SCHEDULE
--------------------------------------------------------------------------------

  TIME       TASK                 SCRIPT           FREQUENCY
  -------------------------------------------------------------------------
  2:00 AM    Full Backup          backup-full      Daily
  Every 6h   Content Backup       backup-content   4x Daily
  3:00 AM    Cleanup Old          cleanup-old      Sunday
  9:00 AM    Verify Health        verify           Daily
  On Deploy  Config Backup        backup-config    As Needed


--------------------------------------------------------------------------------
                     BACKUP LIFECYCLE FLOW
--------------------------------------------------------------------------------

  Trigger Event (Cron, Manual, Pre-deploy)
           |
           v
  Run Backup (Full, Incremental, Config)
           |
           v
  Compress & Archive (tar.gz format)
           |
           v
  Store Locally (backups/{type}/)
           |
           v
  Verify Backup (Integrity check)
           |
           v
  Cleanup Old (Per retention policy)


--------------------------------------------------------------------------------
                   EMERGENCY RESTORE PROCEDURE
--------------------------------------------------------------------------------

  Step 1: List Backups
    > npm run backup:list

  Step 2: Restore from Backup
    > npm run backup:restore backups/daily/latest-full.tar.gz

  Step 3: Reinstall Dependencies
    > npm install

  Step 4: Rebuild
    > npm run build

  Step 5: Test
    > npm run test

  Step 6: Verify
    > npm run dev


--------------------------------------------------------------------------------
                      WHAT GETS BACKED UP
--------------------------------------------------------------------------------

  INCLUDED:                      EXCLUDED:
  - src/                         - node_modules/
  - public/                      - dist/
  - src/content/                 - .astro/
  - *.config.{js,ts,mjs}         - test-results/
  - package.json                 - .git/
  - .env                         - backups/
  - src/middleware.ts


--------------------------------------------------------------------------------
                     ALERT THRESHOLDS
--------------------------------------------------------------------------------

  CONDITION              SEVERITY    ACTION
  -------------------------------------------------------------------------
  Backup > 24h old       WARNING     Check automation
  Backup > 48h old       CRITICAL    Manual backup NOW
  Corrupted backup       CRITICAL    Re-run backup
  Storage > 80% disk     WARNING     Run cleanup
  Storage > 5GB total    WARNING     Review retention


--------------------------------------------------------------------------------
                  SETUP AUTOMATION (CHOOSE YOUR PLATFORM)
--------------------------------------------------------------------------------

  LINUX / MACOS:
    1. Edit crontab:
       crontab -e

    2. Add lines from:
       scripts/backup/cron.example

    3. Verify:
       crontab -l

  WINDOWS:
    1. Open PowerShell as Administrator

    2. Run:
       .\scripts\backup\windows-tasks.ps1

    3. Verify:
       Get-ScheduledTask | Where-Object {$_.TaskName -like 'WorkRoot-*'}


--------------------------------------------------------------------------------
                        DOCUMENTATION
--------------------------------------------------------------------------------

  BACKUP_STRATEGY.md           - Complete strategy & principles
  BACKUP_QUICK_REFERENCE.md    - Quick commands & procedures
  scripts/backup/README.md     - Scripts usage guide
  IMPLEMENTATION_SUMMARY.md    - What was built & how to use
  BACKUP_VISUAL_GUIDE.txt      - This file


--------------------------------------------------------------------------------
                      BEST PRACTICES
--------------------------------------------------------------------------------

  1. Test restores monthly
  2. Always backup before deployment
  3. Monitor backup health daily
  4. Keep multiple backup types
  5. Encrypt backups for off-site storage
  6. Review logs weekly
  7. Document changes to backup strategy


================================================================================
                   IMPLEMENTATION STATUS: COMPLETE
================================================================================