Prepare for migration

scripts/SCRIPTS.md

@@ -0,0 +1,130 @@
+# Database Debug Scripts
+
+## Overview
+
+Collection of SQLite scripts to analyze the Audiobookshelf database and identify hardcoded Docker paths that need migration.
+
+## Scripts
+
+### dump_library_folders.sh
+Dumps the `libraryFolders` table showing:
+- Full paths to library root folders
+- Library IDs for reference
+
+**Usage:** `bash dump_library_folders.sh`
+
+**Key for migration:** Maps Docker paths like `/audiobooks` to local equivalents.
+
+---
+
+### dump_library_items.sh
+Dumps `libraryItems` table focusing on:
+- Full absolute paths (`path`)
+- Relative paths (`relPath`)
+- Unique path prefixes used across all items
+
+**Usage:** `bash dump_library_items.sh`
+
+**Key for migration:** Identifies which library folder each item belongs to based on path prefix.
+
+---
+
+### dump_books.sh
+Dumps `books` table focusing on:
+- Cover image paths (`coverPath`)
+- Unique cover path prefixes
+
+**Usage:** `bash dump_books.sh`
+
+**Key for migration:** Identifies metadata paths like `/metadata/items/{id}/cover.jpg`.
+
+---
+
+### dump_feeds.sh
+Dumps `feeds` table showing:
+- Server addresses (Docker hostnames)
+- Feed URLs
+- Cover paths for RSS feeds
+
+**Usage:** `bash dump_feeds.sh`
+
+**Key for migration:** Finds Docker hostnames like `http://audiobookshelf:8080` that need local URLs.
+
+---
+
+### dump_settings.sh
+Dumps `settings` table extracting:
+- Path-related values from JSON
+- URLs and server addresses
+- Configuration paths
+
+**Usage:** `bash dump_settings.sh`
+
+**Key for migration:** Finds settings like `backupPath`, server URLs in JSON config.
+
+---
+
+### dump_all.sh (Master Summary)
+Runs all dumps and provides a consolidated view:
+- Library folder paths
+- Path prefixes across items
+- Cover path prefixes
+- Server addresses
+- Settings with paths/URLs
+- Quick scan of all Docker-like paths
+
+**Usage:** `bash dump_all.sh`
+
+---
+
+## Makefile Targets
+
+Run from the `scripts/` directory:
+
+```bash
+cd scripts
+make all           # Run all dumps
+make summary       # Run master summary
+make help          # Show available targets
+```
+
+### Individual Targets
+
+```bash
+make library_folders  # libraryFolders paths
+make library_items    # libraryItems paths
+make books            # books coverPaths
+make feeds            # feeds URLs
+make settings         # settings JSON paths
+```
+
+## Example Output
+
+```
+=== libraryFolders ===
+ID | PATH | LIBRARY_ID
+---|------|-----------
+9f980819-... | /audiobooks | a04cbf28-...
+43bf8c8d-... | /libraries/romance | dad4448d-...
+
+=== Unique Path Prefixes ===
+/audiobooks
+/libraries/romance
+```
+
+## Common Docker Paths Found
+
+| Path Pattern | Description |
+|--------------|-------------|
+| `/audiobooks` | Library root |
+| `/libraries/...` | Additional libraries |
+| `/metadata/items/...` | Item metadata/covers |
+| `/metadata/backups` | Backup directory |
+| `http://audiobookshelf:8080` | Docker service URL |
+
+## Next Steps
+
+1. Run `make summary` to get complete overview
+2. Identify Docker paths specific to your deployment
+3. Create path mapping configuration
+4. Run migration script to update paths