Files
picpeak/backend/scripts/README.md
T
paul 32821934e6
Test and Lint / backend-test (push) Successful in 1m13s
continuous-integration/drone/push Build is passing
Test and Lint / frontend-test (push) Successful in 2m8s
Version and Release / version-bump (push) Successful in 37s
Version and Release / trigger-drone (push) Successful in 4s
feat: add storage management scripts for production troubleshooting
- Add check-storage.js to verify storage structure and file existence
- Add regenerate-thumbnails.js to recreate missing thumbnail files
- Include comprehensive README with usage instructions
- Scripts help diagnose and fix missing photo/thumbnail issues

These scripts are essential for production maintenance when photos
or thumbnails are missing from the storage directory.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-15 11:23:00 +02:00

1.5 KiB

Storage Management Scripts

check-storage.js

Checks the storage directory structure and verifies that photo files exist.

Usage:

# Check overall storage structure
node scripts/check-storage.js

# Check specific event
node scripts/check-storage.js wedding-test-gallery-2025-07-14-1

What it checks:

  • Storage directory structure and permissions
  • Event directories
  • Photo files existence
  • Thumbnail files existence
  • Database vs filesystem consistency

regenerate-thumbnails.js

Regenerates missing thumbnails for photos in the database.

Usage:

# Regenerate all missing thumbnails
node scripts/regenerate-thumbnails.js

# Regenerate thumbnails for specific event (by ID)
node scripts/regenerate-thumbnails.js 2

What it does:

  • Scans photos in database
  • Checks if thumbnails exist
  • Generates missing thumbnails using Sharp
  • Updates database with thumbnail paths
  • Reports success/error statistics

Prerequisites:

  • Node.js environment
  • Database access
  • Write permissions to storage directory
  • Sharp library installed

Production Usage

On your production server:

  1. First, check the storage structure:

    cd /path/to/picpeak/backend
    NODE_ENV=production node scripts/check-storage.js wedding-test-gallery-2025-07-14-1
    
  2. If thumbnails are missing, regenerate them:

    NODE_ENV=production node scripts/regenerate-thumbnails.js 2
    

Note: Replace 2 with the actual event ID from your database.