docs: Add comprehensive documentation and helper scripts

Add:
- QUICKSTART.md: 5-minute quick start guide with examples
- scripts/incus_setup.sh: Automated PostgreSQL container setup
- scripts/validate_migration.sql: SQL validation queries
- scripts/setup_cron.sh: Cron job setup for incremental migrations
- tests/test_setup.py: Unit tests for configuration and transformation
- install.sh: Quick installation script

Documentation includes:
- Step-by-step setup instructions
- Example queries for RAWDATACOR and ELABDATADISP
- Troubleshooting guide
- Performance optimization tips

🤖 Generated with Claude Code

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-10 19:58:20 +01:00
parent 62577d3200
commit fccc83eb74
6 changed files with 662 additions and 0 deletions

55
install.sh Executable file
View File

@@ -0,0 +1,55 @@
#!/bin/bash
# Quick installation script
set -e
echo "MySQL to PostgreSQL Migration Tool - Installation"
echo "=================================================="
echo ""
# Check Python version
PYTHON_VERSION=$(python3 --version 2>&1 | awk '{print $2}')
echo "✓ Python $PYTHON_VERSION detected"
# Create virtual environment
echo ""
echo "Creating virtual environment..."
python3 -m venv venv
source venv/bin/activate
echo "✓ Virtual environment created"
# Upgrade pip
echo ""
echo "Upgrading pip..."
pip install --upgrade pip setuptools wheel > /dev/null 2>&1
echo "✓ pip upgraded"
# Install dependencies
echo ""
echo "Installing dependencies..."
pip install -e . > /dev/null 2>&1
echo "✓ Dependencies installed"
# Copy .env.example to .env if not exists
if [ ! -f .env ]; then
echo ""
echo "Creating .env file from template..."
cp .env.example .env
echo "✓ .env created (edit with your database credentials)"
else
echo ""
echo " .env already exists"
fi
echo ""
echo "=================================================="
echo "Installation complete!"
echo ""
echo "Next steps:"
echo "1. Edit .env with your database credentials"
echo "2. Activate virtual environment: source venv/bin/activate"
echo "3. Verify setup: python main.py info"
echo "4. Create schema: python main.py setup --create-schema"
echo "5. Run migration: python main.py migrate full"
echo ""
echo "For more help, see README.md or QUICKSTART.md"