feat: db migration support

scripts/bash/db-import-conditional.sh

@@ -153,8 +153,33 @@ if [ -f "$RESTORE_SUCCESS_MARKER" ]; then
   if verify_databases_populated; then
     echo "✅ Backup restoration completed successfully"
     cat "$RESTORE_SUCCESS_MARKER" || true
-    echo "🚫 Skipping database import - data already restored from backup"
-    exit 0
+
+    # Check if there are pending module SQL updates to apply
+    echo "🔍 Checking for pending module SQL updates..."
+    local has_pending_updates=0
+
+    # Check if module SQL staging directory has files
+    if [ -d "/azerothcore/data/sql/updates/db_world" ] && [ -n "$(find /azerothcore/data/sql/updates/db_world -name 'MODULE_*.sql' -type f 2>/dev/null)" ]; then
+      echo "   ⚠️  Found staged module SQL updates that may need application"
+      has_pending_updates=1
+    fi
+
+    if [ "$has_pending_updates" -eq 0 ]; then
+      echo "🚫 Skipping database import - data already restored and no pending updates"
+      exit 0
+    fi
+
+    echo "📦 Running dbimport to apply pending module SQL updates..."
+    cd /azerothcore/env/dist/bin
+    seed_dbimport_conf
+
+    if ./dbimport; then
+      echo "✅ Module SQL updates applied successfully!"
+      exit 0
+    else
+      echo "⚠️  dbimport reported issues - check logs for details"
+      exit 1
+    fi
   fi
 
   echo "⚠️  Restoration marker found, but databases are empty - forcing re-import"
@@ -470,6 +495,65 @@ echo "🚀 Running database import..."
 cd /azerothcore/env/dist/bin
 seed_dbimport_conf
 
+validate_sql_source(){
+  local sql_base_dir="/azerothcore/data/sql/base"
+  local required_dirs=("db_auth" "db_world" "db_characters")
+  local missing_dirs=()
+
+  echo "🔍 Validating SQL source availability..."
+
+  if [ ! -d "$sql_base_dir" ]; then
+    cat <<EOF
+
+❌ FATAL: SQL source directory not found at $sql_base_dir
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+The AzerothCore source repository is not mounted or doesn't exist.
+This directory should contain SQL schemas for database initialization.
+
+📋 REMEDIATION STEPS:
+
+  1. SSH to this host:
+     ssh $(whoami)@$(hostname)
+
+  2. Navigate to project directory and run source setup:
+     cd $PROJECT_ROOT && ./scripts/bash/setup-source.sh
+
+  3. Restart database import:
+     docker compose run --rm ac-db-import
+
+📦 ALTERNATIVE (Prebuilt Images):
+
+  If using Docker images with bundled SQL schemas:
+  - Set AC_SQL_SOURCE_PATH in .env to point to bundled location
+  - Example: AC_SQL_SOURCE_PATH=/bundled/sql
+
+📚 Documentation: docs/GETTING_STARTED.md#database-setup
+
+EOF
+    exit 1
+  fi
+
+  for dir in "${required_dirs[@]}"; do
+    local full_path="$sql_base_dir/$dir"
+    if [ ! -d "$full_path" ] || [ -z "$(ls -A "$full_path" 2>/dev/null)" ]; then
+      missing_dirs+=("$dir")
+    fi
+  done
+
+  if [ ${#missing_dirs[@]} -gt 0 ]; then
+    echo ""
+    echo "❌ FATAL: SQL source directories are empty or missing:"
+    printf '   - %s\n' "${missing_dirs[@]}"
+    echo ""
+    echo "The AzerothCore source directory exists but hasn't been populated with SQL files."
+    echo "Run './scripts/bash/setup-source.sh' on the host to clone and populate the repository."
+    echo ""
+    exit 1
+  fi
+
+  echo "✅ SQL source validation passed - all required schemas present"
+}
+
 maybe_run_base_import(){
   local mysql_host="${CONTAINER_MYSQL:-ac-mysql}"
   local mysql_port="${MYSQL_PORT:-3306}"
@@ -506,6 +590,8 @@ maybe_run_base_import(){
   fi
 }
 
+# Validate SQL source is available before attempting import
+validate_sql_source
 maybe_run_base_import
 if ./dbimport; then
   echo "✅ Database import completed successfully!"

scripts/bash/migrate-stack.sh

@@ -144,6 +144,7 @@ Options:
   --port PORT           SSH port (default: 22)
   --identity PATH       SSH private key (passed to scp/ssh)
   --project-dir DIR     Remote project directory (default: ~/<project-name>)
+  --setup-source 0|1    Auto-setup AzerothCore source on remote (0=skip, 1=setup, unset=prompt)
   --env-file PATH       Use this env file for image lookup and upload (default: ./.env)
   --tarball PATH        Output path for the image tar (default: ./local-storage/images/acore-modules-images.tar)
   --storage PATH        Remote storage directory (default: <project-dir>/storage)
@@ -168,6 +169,7 @@ SKIP_STORAGE=0
 ASSUME_YES=0
 COPY_SOURCE=0
 SKIP_ENV=0
+REMOTE_SETUP_SOURCE=""
 PRESERVE_CONTAINERS=0
 CLEAN_CONTAINERS=0
 
@@ -181,6 +183,7 @@ while [[ $# -gt 0 ]]; do
     --env-file) ENV_FILE="$2"; shift 2;;
     --tarball) TARBALL="$2"; shift 2;;
     --storage) REMOTE_STORAGE="$2"; shift 2;;
+    --setup-source) REMOTE_SETUP_SOURCE="$2"; shift 2;;
     --skip-storage) SKIP_STORAGE=1; shift;;
     --skip-env) SKIP_ENV=1; shift;;
     --preserve-containers) PRESERVE_CONTAINERS=1; shift;;
@@ -446,6 +449,76 @@ setup_remote_repository(){
   echo "   • Repository synchronized ✓"
 }
 
+setup_source_if_needed(){
+  local should_setup="${REMOTE_SETUP_SOURCE:-}"
+
+  # Check if source already exists and is populated
+  echo "   • Checking for existing AzerothCore source repository..."
+  if run_ssh "[ -d '$PROJECT_DIR/local-storage/source/azerothcore-playerbots/data/sql/base/db_world' ] && [ -n \"\$(ls -A '$PROJECT_DIR/local-storage/source/azerothcore-playerbots/data/sql/base/db_world' 2>/dev/null)\" ]" 2>/dev/null; then
+    echo "   ✅ Source repository already populated on remote"
+    return 0
+  elif run_ssh "[ -d '$PROJECT_DIR/local-storage/source/azerothcore/data/sql/base/db_world' ] && [ -n \"\$(ls -A '$PROJECT_DIR/local-storage/source/azerothcore/data/sql/base/db_world' 2>/dev/null)\" ]" 2>/dev/null; then
+    echo "   ✅ Source repository already populated on remote"
+    return 0
+  fi
+
+  echo "   ⚠️  Source repository not found or empty on remote"
+
+  # If not set, ask user (unless --yes)
+  if [ -z "$should_setup" ]; then
+    if [ "$ASSUME_YES" = "1" ]; then
+      # Auto-yes in non-interactive: default to YES for safety
+      echo "   ℹ️  Auto-confirming source setup (--yes flag)"
+      should_setup=1
+    else
+      echo ""
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      echo "📦 AzerothCore Source Repository Setup"
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      echo ""
+      echo "The remote server needs AzerothCore source code for database schemas."
+      echo "This will clone ~2GB repository (one-time operation, takes 2-5 minutes)."
+      echo ""
+      echo "Without this, database initialization will FAIL."
+      echo ""
+      read -rp "Set up source repository now? [Y/n]: " answer
+      answer="${answer:-Y}"
+      case "${answer,,}" in
+        y|yes) should_setup=1 ;;
+        *) should_setup=0 ;;
+      esac
+    fi
+  fi
+
+  if [ "$should_setup" != "1" ]; then
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "⚠️  WARNING: Source setup skipped"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "You MUST run this manually on the remote host BEFORE starting services:"
+    echo ""
+    echo "  ssh $USER@$HOST"
+    echo "  cd $PROJECT_DIR"
+    echo "  ./scripts/bash/setup-source.sh"
+    echo ""
+    return 0
+  fi
+
+  echo "   🔧 Setting up AzerothCore source repository on remote..."
+  echo "   ⏳ Cloning AzerothCore (this may take 2-5 minutes)..."
+
+  # Run setup-source.sh on remote, capturing output
+  if run_ssh "cd '$PROJECT_DIR' && ./scripts/bash/setup-source.sh" 2>&1 | sed 's/^/      /'; then
+    echo "   ✅ Source repository setup complete"
+    return 0
+  else
+    echo "   ❌ Source setup failed (check output above for details)"
+    echo "   ⚠️  Run manually: ssh $USER@$HOST 'cd $PROJECT_DIR && ./scripts/bash/setup-source.sh'"
+    return 1
+  fi
+}
+
 cleanup_stale_docker_resources(){
   if [ "$PRESERVE_CONTAINERS" -eq 1 ]; then
     echo "⋅ Skipping remote container/image cleanup (--preserve-containers)"
@@ -477,6 +550,9 @@ cleanup_stale_docker_resources(){
 
 validate_remote_environment
 
+# Set up source repository if needed (after project files are synced)
+setup_source_if_needed || true  # Don't fail entire deployment if source setup fails
+
 collect_deploy_image_refs
 
 echo "⋅ Exporting deployment images to $TARBALL"