ai_qc/backend/scripts/run-local.sh
nickviljoen 3fec052c12 Create frontend and backend folder structure for deployment
Organized the application into separate frontend and backend directories for cleaner deployment and better separation of concerns.

Frontend Directory (frontend/):
- index.html: Single-page web interface (renamed from web_ui.html)
- README.md: Frontend deployment guide
- Total size: ~113 KB (self-contained)
- Smart base path detection (works at / or /ai_qc/)
- No configuration changes required

Backend Directory (backend/):
- All Python files (api_server.py, llm_config.py, etc.)
- visual_qc_apps/: 33 QC check modules
- profiles/: 6 QC profile configurations
- brand_guidelines/: Reference asset storage
- config/: Environment configurations
- scripts/: Deployment automation
- uploads/, output/: Data directories
- requirements.txt, ai_qc.service, apache_config.conf
- Complete documentation

New Documentation:
- FOLDER_STRUCTURE.md: Comprehensive guide to new structure
- frontend/README.md: Frontend deployment instructions
- backend/BACKEND_README.md: Backend deployment guide

Deployment Mapping:
- frontend/ → /var/www/html/ai_qc/ (web root)
- backend/ → /opt/ai_qc/ (application directory)

Benefits:
- Clear separation of concerns
- Backend code not in web-accessible directory
- Independent frontend/backend updates
- Matches server's existing patterns (/opt/veo3, /opt/voice2text)
- Industry-standard architecture
- Easy to deploy and maintain

Original files preserved in root directory for reference.
Ready for production deployment following MIGRATION_GUIDE.md.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-06 11:55:53 +02:00

69 lines
No EOL
1.7 KiB
Bash
Executable file

#!/bin/bash
# Script to run the Visual AI QC application in local development mode
set -e # Exit on any error
echo "==========================================="
echo " Visual AI QC - Local Development Mode"
echo "==========================================="
# Get the script directory and app root
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
APP_DIR="$(dirname "$SCRIPT_DIR")"
echo "App directory: $APP_DIR"
# Set environment to development
export ENVIRONMENT=development
echo "Environment: $ENVIRONMENT"
# Change to app directory
cd "$APP_DIR"
# Check if config exists
if [ ! -f "config/development.env" ]; then
echo "ERROR: config/development.env not found!"
echo "Please create the development config file first."
exit 1
fi
# Check if development folders exist
if [ ! -d "uploads-dev" ] || [ ! -d "output-dev" ]; then
echo "Creating development folders..."
mkdir -p uploads-dev output-dev
fi
# Check Python environment
echo "Checking Python environment..."
if command -v python3 &> /dev/null; then
PYTHON_CMD=python3
elif command -v python &> /dev/null; then
PYTHON_CMD=python
else
echo "ERROR: Python not found!"
exit 1
fi
echo "Using Python: $PYTHON_CMD"
# Check if virtual environment exists
if [ -d "venv" ]; then
echo "Activating virtual environment..."
source venv/bin/activate
fi
# Install requirements if needed
if [ -f "requirements.txt" ]; then
echo "Installing/updating requirements..."
pip install -r requirements.txt > /dev/null 2>&1 || echo "Warning: Could not install requirements"
fi
echo ""
echo "Starting development server..."
echo "Access the application at: http://localhost:7183"
echo "Press Ctrl+C to stop the server"
echo ""
# Run the application
$PYTHON_CMD api_server.py