add module functionality, untested

scripts/README.md

@@ -1,35 +1,76 @@
 # Scripts Directory
 
-This directory contains deployment and validation scripts for the AzerothCore Docker deployment.
+This directory contains deployment, configuration, and management scripts for the AzerothCore Docker deployment.
 
-## Contents
+## Core Scripts
 
+### 🚀 Setup & Deployment
+- **`setup-server.sh`** - Interactive server setup wizard (recommended for new users)
 - **`deploy-and-check.sh`** - Automated deployment and comprehensive health check script
+- **`auto-post-install.sh`** - Automated post-installation configuration
+
+### 🔧 Configuration & Management
+- **`configure-modules.sh`** - Module configuration analysis and guidance tool
+- **`setup-eluna.sh`** - Lua scripting environment setup
+- **`update-realmlist.sh`** - Update server address in realmlist configuration
+- **`update-config.sh`** - Configuration file updates and management
+
+### 💾 Backup & Restore
+- **`backup.sh`** - Manual database backup
+- **`backup-hourly.sh`** - Hourly automated backup script
+- **`backup-daily.sh`** - Daily automated backup script
+- **`restore.sh`** - Database restoration from backup
+
+### 🧹 Maintenance
 - **`cleanup.sh`** - Resource cleanup script with multiple cleanup levels
-- **`DEPLOYMENT.md`** - Complete documentation for the deployment script
-- **`CLEANUP.md`** - Complete documentation for the cleanup script
+- **`rebuild-with-modules.sh`** - Rebuild containers with module compilation
+- **`test-local-worldserver.sh`** - Local worldserver testing
+
+### 📚 Documentation
+- **`DEPLOYMENT.md`** - Complete documentation for deployment scripts
+- **`CLEANUP.md`** - Complete documentation for cleanup scripts
 
 ## Quick Usage
 
-### Run Health Check on Current Deployment
+### 🆕 First-Time Setup (Recommended)
+```bash
+# Interactive setup wizard
+./scripts/setup-server.sh
+```
+
+### 🔧 Module Configuration Analysis
+```bash
+# Check module configuration requirements
+./scripts/configure-modules.sh
+```
+
+### 🎮 Lua Scripting Setup
+```bash
+# Setup Eluna scripting environment
+./scripts/setup-eluna.sh
+```
+
+### 🩺 Health Checks & Deployment
+
+**Run Health Check on Current Deployment**
 ```bash
 cd scripts
 ./deploy-and-check.sh --skip-deploy
 ```
 
-### Full Deployment with Health Checks
+**Full Deployment with Health Checks**
 ```bash
 cd scripts
 ./deploy-and-check.sh
 ```
 
-### Quick Health Check (Basic Tests Only)
+**Quick Health Check (Basic Tests Only)**
 ```bash
 cd scripts
 ./deploy-and-check.sh --skip-deploy --quick-check
 ```
 
-### Cleanup Resources
+### 🧹 Cleanup Resources
 ```bash
 cd scripts
 
@@ -46,22 +87,94 @@ cd scripts
 ./cleanup.sh --hard --dry-run
 ```
 
+### 💾 Backup & Restore Operations
+```bash
+# Manual backup
+./scripts/backup.sh
+
+# Restore from backup
+./scripts/restore.sh backup_filename.sql
+
+# Setup automated backups (already configured in containers)
+# Hourly: ./scripts/backup-hourly.sh
+# Daily: ./scripts/backup-daily.sh
+```
+
 ## Features
 
-✅ **Container Health Validation**: Checks all 8 core containers
+### 🚀 Setup & Deployment Features
+✅ **Interactive Setup Wizard**: Guided configuration for new users
+✅ **Automated Server Deployment**: Complete three-layer deployment system
+✅ **Module Management**: Automated installation and configuration of 13 enhanced modules
+✅ **Post-Install Automation**: Automatic database setup, realmlist configuration, and service restart
+
+### 🔧 Configuration Features
+✅ **Module Analysis**: Identifies missing configurations and requirements
+✅ **Lua Scripting Setup**: Automated Eluna environment with example scripts
+✅ **Realmlist Management**: Dynamic server address configuration
+✅ **Config File Management**: Automated .conf file generation from .conf.dist templates
+
+### 🩺 Health & Monitoring Features
+✅ **Container Health Validation**: Checks all core containers
 ✅ **Port Connectivity Tests**: Validates all external ports
 ✅ **Web Service Verification**: HTTP response and content validation
 ✅ **Database Validation**: Schema and realm configuration checks
-✅ **Automated Deployment**: Three-layer deployment (database → services → tools)
 ✅ **Comprehensive Reporting**: Color-coded status with detailed results
 
-## Variable Names Verified
+### 💾 Backup & Maintenance Features
+✅ **Automated Backups**: Scheduled hourly and daily database backups
+✅ **Manual Backup/Restore**: On-demand backup and restoration tools
+✅ **Multi-Level Cleanup**: Safe, hard, and nuclear cleanup options
+✅ **Container Rebuilding**: Module compilation and container rebuilding support
 
-The scripts validate the updated variable names:
-- `MYSQL_EXTERNAL_PORT` (was `DOCKER_DB_EXTERNAL_PORT`)
-- `AUTH_EXTERNAL_PORT` (was `DOCKER_AUTH_EXTERNAL_PORT`)
-- `WORLD_EXTERNAL_PORT` (was `DOCKER_WORLD_EXTERNAL_PORT`)
-- `SOAP_EXTERNAL_PORT` (was `DOCKER_SOAP_EXTERNAL_PORT`)
-- `MYSQL_ROOT_PASSWORD` (was `DOCKER_DB_ROOT_PASSWORD`)
+## Script Usage Examples
 
-For complete documentation, see `DEPLOYMENT.md`.
+### First-Time Server Setup
+```bash
+# Complete guided setup (recommended)
+./scripts/setup-server.sh
+
+# Follow the interactive prompts to configure:
+# - Server network settings
+# - Storage locations
+# - Database passwords
+# - Module selections
+```
+
+### Post-Installation Configuration
+```bash
+# Analyze and configure modules
+./scripts/configure-modules.sh
+
+# Setup Lua scripting environment
+./scripts/setup-eluna.sh
+
+# Update server address after IP changes
+./scripts/update-realmlist.sh new.server.address
+```
+
+### Maintenance Operations
+```bash
+# Health check existing deployment
+./scripts/deploy-and-check.sh --skip-deploy
+
+# Clean restart (preserves data)
+./scripts/cleanup.sh --hard
+./scripts/deploy-and-check.sh
+
+# Backup before major changes
+./scripts/backup.sh
+```
+
+## Configuration Variables
+
+The scripts work with the updated environment variable names:
+- `MYSQL_EXTERNAL_PORT` (database port)
+- `AUTH_EXTERNAL_PORT` (authentication server port)
+- `WORLD_EXTERNAL_PORT` (world server port)
+- `SOAP_EXTERNAL_PORT` (SOAP API port)
+- `MYSQL_ROOT_PASSWORD` (database root password)
+- `SERVER_ADDRESS` (external server address)
+- `STORAGE_ROOT` (data storage location)
+
+For complete documentation, see `DEPLOYMENT.md` and `CLEANUP.md`.