feat: major API restructure and Vue.js frontend integration

- Centralize API endpoints in dedicated api app with v1 versioning
- Remove individual API modules from parks and rides apps
- Add event tracking system with analytics functionality
- Integrate Vue.js frontend with Tailwind CSS v4 and TypeScript
- Add comprehensive database migrations for event tracking
- Implement user authentication and social provider setup
- Add API schema documentation and serializers
- Configure development environment with shared scripts
- Update project structure for monorepo with frontend/backend separation
This commit is contained in:
pacnpal
2025-08-24 16:42:20 -04:00
parent 92f4104d7a
commit e62646bcf9
127 changed files with 27734 additions and 1867 deletions

494
shared/scripts/deploy/deploy.sh Executable file
View File

@@ -0,0 +1,494 @@
#!/bin/bash
# ThrillWiki Deployment Script
# Deploys the application to various environments
set -e
# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# Script directory and project root
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
# Configuration
DEPLOY_ENV="production"
DEPLOY_DIR="$PROJECT_ROOT/deploy"
BACKUP_DIR="$PROJECT_ROOT/backups"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
# Function to print colored output
print_status() {
echo -e "${BLUE}[INFO]${NC} $1"
}
print_success() {
echo -e "${GREEN}[SUCCESS]${NC} $1"
}
print_warning() {
echo -e "${YELLOW}[WARNING]${NC} $1"
}
print_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
# Function to check if a command exists
command_exists() {
command -v "$1" >/dev/null 2>&1
}
# Function to check deployment requirements
check_deployment_requirements() {
print_status "Checking deployment requirements..."
local missing_deps=()
# Check if deployment artifacts exist
if [ ! -d "$DEPLOY_DIR" ]; then
missing_deps+=("deployment_artifacts")
fi
if [ ! -f "$DEPLOY_DIR/manifest.json" ]; then
missing_deps+=("deployment_manifest")
fi
# Check for deployment tools
if [ "$DEPLOY_METHOD" = "docker" ]; then
if ! command_exists docker; then
missing_deps+=("docker")
fi
fi
if [ "$DEPLOY_METHOD" = "rsync" ]; then
if ! command_exists rsync; then
missing_deps+=("rsync")
fi
fi
if [ ${#missing_deps[@]} -ne 0 ]; then
print_error "Missing deployment requirements: ${missing_deps[*]}"
exit 1
fi
print_success "Deployment requirements met!"
}
# Function to create backup
create_backup() {
print_status "Creating backup before deployment..."
mkdir -p "$BACKUP_DIR"
local backup_path="$BACKUP_DIR/backup_$TIMESTAMP"
# Create backup directory
mkdir -p "$backup_path"
# Backup current deployment if it exists
if [ -d "$DEPLOY_TARGET" ]; then
print_status "Backing up current deployment..."
cp -r "$DEPLOY_TARGET" "$backup_path/current"
fi
# Backup database if requested
if [ "$BACKUP_DATABASE" = true ]; then
print_status "Backing up database..."
# This would depend on your database setup
# For SQLite:
if [ -f "$PROJECT_ROOT/backend/db.sqlite3" ]; then
cp "$PROJECT_ROOT/backend/db.sqlite3" "$backup_path/database.sqlite3"
fi
fi
# Backup environment files
if [ -f "$PROJECT_ROOT/.env" ]; then
cp "$PROJECT_ROOT/.env" "$backup_path/.env.backup"
fi
print_success "Backup created: $backup_path"
}
# Function to prepare deployment artifacts
prepare_artifacts() {
print_status "Preparing deployment artifacts..."
# Check if build artifacts exist
if [ ! -d "$DEPLOY_DIR" ]; then
print_error "No deployment artifacts found. Please run build-all.sh first."
exit 1
fi
# Validate manifest
if [ -f "$DEPLOY_DIR/manifest.json" ]; then
print_status "Validating deployment manifest..."
# You could add more validation here
cat "$DEPLOY_DIR/manifest.json" | grep -q "build_timestamp" || {
print_error "Invalid deployment manifest"
exit 1
}
fi
print_success "Deployment artifacts ready!"
}
# Function to deploy to local development
deploy_local() {
print_status "Deploying to local development environment..."
local target_dir="$PROJECT_ROOT/deployment"
# Create target directory
mkdir -p "$target_dir"
# Copy artifacts
print_status "Copying frontend artifacts..."
cp -r "$DEPLOY_DIR/frontend" "$target_dir/"
print_status "Copying backend artifacts..."
mkdir -p "$target_dir/backend"
cp -r "$DEPLOY_DIR/backend/staticfiles" "$target_dir/backend/"
# Copy deployment configuration
cp "$DEPLOY_DIR/manifest.json" "$target_dir/"
print_success "Local deployment completed!"
print_status "Deployment available at: $target_dir"
}
# Function to deploy via rsync
deploy_rsync() {
print_status "Deploying via rsync..."
if [ -z "$DEPLOY_HOST" ]; then
print_error "DEPLOY_HOST not set for rsync deployment"
exit 1
fi
local target=""
if [ -n "$DEPLOY_USER" ]; then
target="$DEPLOY_USER@$DEPLOY_HOST:$DEPLOY_PATH"
else
target="$DEPLOY_HOST:$DEPLOY_PATH"
fi
print_status "Syncing files to $target..."
# Rsync options:
# -a: archive mode (recursive, preserves attributes)
# -v: verbose
# -z: compress during transfer
# --delete: delete files not in source
# --exclude: exclude certain files
rsync -avz --delete \
--exclude='.git' \
--exclude='node_modules' \
--exclude='__pycache__' \
--exclude='*.log' \
"$DEPLOY_DIR/" "$target"
print_success "Rsync deployment completed!"
}
# Function to deploy via Docker
deploy_docker() {
print_status "Deploying via Docker..."
local image_name="thrillwiki-$DEPLOY_ENV"
local container_name="thrillwiki-$DEPLOY_ENV"
# Build Docker image
print_status "Building Docker image: $image_name"
docker build -t "$image_name" \
--build-arg DEPLOY_ENV="$DEPLOY_ENV" \
-f "$PROJECT_ROOT/Dockerfile" \
"$PROJECT_ROOT"
# Stop existing container
if docker ps -q -f name="$container_name" | grep -q .; then
print_status "Stopping existing container..."
docker stop "$container_name"
fi
# Remove existing container
if docker ps -a -q -f name="$container_name" | grep -q .; then
print_status "Removing existing container..."
docker rm "$container_name"
fi
# Run new container
print_status "Starting new container..."
docker run -d \
--name "$container_name" \
-p 8080:80 \
-e DEPLOY_ENV="$DEPLOY_ENV" \
"$image_name"
print_success "Docker deployment completed!"
print_status "Container: $container_name"
print_status "URL: http://localhost:8080"
}
# Function to run post-deployment checks
run_post_deploy_checks() {
print_status "Running post-deployment checks..."
local health_url=""
case $DEPLOY_METHOD in
"local")
health_url="http://localhost:8080/health"
;;
"docker")
health_url="http://localhost:8080/health"
;;
"rsync")
if [ -n "$DEPLOY_HOST" ]; then
health_url="http://$DEPLOY_HOST/health"
fi
;;
esac
if [ -n "$health_url" ]; then
print_status "Checking health endpoint: $health_url"
if curl -s -f "$health_url" > /dev/null 2>&1; then
print_success "Health check passed!"
else
print_warning "Health check failed. Please verify deployment."
fi
fi
print_success "Post-deployment checks completed!"
}
# Function to generate deployment report
generate_deployment_report() {
print_status "Generating deployment report..."
local report_file="$PROJECT_ROOT/deployment-report-$DEPLOY_ENV-$TIMESTAMP.txt"
cat > "$report_file" << EOF
ThrillWiki Deployment Report
============================
Deployment Information:
- Deployment Date: $(date)
- Environment: $DEPLOY_ENV
- Method: $DEPLOY_METHOD
- Project Root: $PROJECT_ROOT
Deployment Details:
- Source Directory: $DEPLOY_DIR
- Target: $DEPLOY_TARGET
- Backup Created: $([ "$CREATE_BACKUP" = true ] && echo "Yes" || echo "No")
Build Information:
$(if [ -f "$DEPLOY_DIR/manifest.json" ]; then
cat "$DEPLOY_DIR/manifest.json"
else
echo "No manifest found"
fi)
System Information:
- Hostname: $(hostname)
- User: $(whoami)
- OS: $(uname -s) $(uname -r)
Deployment Status: SUCCESS
Post-Deployment:
- Health Check: $([ "$RUN_CHECKS" = true ] && echo "Run" || echo "Skipped")
- Backup Location: $([ "$CREATE_BACKUP" = true ] && echo "$BACKUP_DIR/backup_$TIMESTAMP" || echo "None")
EOF
print_success "Deployment report generated: $report_file"
}
# Function to show usage
show_usage() {
cat << EOF
Usage: $0 [ENVIRONMENT] [OPTIONS]
Deploy ThrillWiki to the specified environment.
Environments:
dev Development environment
staging Staging environment
production Production environment
Options:
-h, --help Show this help message
-m, --method METHOD Deployment method (local, rsync, docker)
--no-backup Skip backup creation
--no-checks Skip post-deployment checks
--no-report Skip deployment report generation
Examples:
$0 production # Deploy to production using default method
$0 staging --method docker # Deploy to staging using Docker
$0 dev --no-backup # Deploy to dev without backup
Environment Variables:
DEPLOY_METHOD Deployment method (default: local)
DEPLOY_HOST Target host for rsync deployment
DEPLOY_USER SSH user for rsync deployment
DEPLOY_PATH Target path for rsync deployment
CREATE_BACKUP Create backup before deployment (default: true)
BACKUP_DATABASE Backup database (default: false)
EOF
}
# Parse command line arguments
DEPLOY_METHOD="local"
CREATE_BACKUP=true
RUN_CHECKS=true
SKIP_REPORT=false
# Get environment from first argument
if [ $# -gt 0 ]; then
case $1 in
dev|staging|production)
DEPLOY_ENV="$1"
shift
;;
-h|--help)
show_usage
exit 0
;;
*)
print_error "Invalid environment: $1"
show_usage
exit 1
;;
esac
fi
# Parse remaining arguments
while [[ $# -gt 0 ]]; do
case $1 in
-h|--help)
show_usage
exit 0
;;
-m|--method)
DEPLOY_METHOD="$2"
shift 2
;;
--no-backup)
CREATE_BACKUP=false
shift
;;
--no-checks)
RUN_CHECKS=false
shift
;;
--no-report)
SKIP_REPORT=true
shift
;;
*)
print_error "Unknown option: $1"
show_usage
exit 1
;;
esac
done
# Override from environment variables
if [ ! -z "$DEPLOY_METHOD_ENV" ]; then
DEPLOY_METHOD=$DEPLOY_METHOD_ENV
fi
if [ "$CREATE_BACKUP_ENV" = "false" ]; then
CREATE_BACKUP=false
fi
# Set deployment target based on method
case $DEPLOY_METHOD in
"local")
DEPLOY_TARGET="$PROJECT_ROOT/deployment"
;;
"rsync")
DEPLOY_TARGET="${DEPLOY_USER:-}$(if [ -n "$DEPLOY_USER" ]; then echo "@"; fi)${DEPLOY_HOST:-localhost}:${DEPLOY_PATH:-/var/www/thrillwiki}"
;;
"docker")
DEPLOY_TARGET="docker_container"
;;
*)
print_error "Unsupported deployment method: $DEPLOY_METHOD"
exit 1
;;
esac
# Print banner
echo -e "${GREEN}"
echo "=========================================="
echo " ThrillWiki Deployment"
echo "=========================================="
echo -e "${NC}"
print_status "Environment: $DEPLOY_ENV"
print_status "Method: $DEPLOY_METHOD"
print_status "Target: $DEPLOY_TARGET"
print_status "Create backup: $CREATE_BACKUP"
# Check deployment requirements
check_deployment_requirements
# Prepare deployment artifacts
prepare_artifacts
# Create backup if requested
if [ "$CREATE_BACKUP" = true ]; then
create_backup
else
print_warning "Skipping backup creation as requested"
fi
# Deploy based on method
case $DEPLOY_METHOD in
"local")
deploy_local
;;
"rsync")
deploy_rsync
;;
"docker")
deploy_docker
;;
*)
print_error "Unsupported deployment method: $DEPLOY_METHOD"
exit 1
;;
esac
# Run post-deployment checks
if [ "$RUN_CHECKS" = true ]; then
run_post_deploy_checks
else
print_warning "Skipping post-deployment checks as requested"
fi
# Generate deployment report
if [ "$SKIP_REPORT" = false ]; then
generate_deployment_report
else
print_warning "Skipping deployment report generation as requested"
fi
print_success "Deployment completed successfully!"
echo ""
print_status "Environment: $DEPLOY_ENV"
print_status "Method: $DEPLOY_METHOD"
print_status "Target: $DEPLOY_TARGET"
echo ""
print_status "Deployment report: $PROJECT_ROOT/deployment-report-$DEPLOY_ENV-$TIMESTAMP.txt"

368
shared/scripts/dev/setup-dev.sh Executable file
View File

@@ -0,0 +1,368 @@
#!/bin/bash
# ThrillWiki Development Environment Setup
# Sets up the complete development environment for both backend and frontend
set -e
# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# Script directory and project root
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
# Configuration
BACKEND_DIR="$PROJECT_ROOT/backend"
FRONTEND_DIR="$PROJECT_ROOT/frontend"
# Function to print colored output
print_status() {
echo -e "${BLUE}[INFO]${NC} $1"
}
print_success() {
echo -e "${GREEN}[SUCCESS]${NC} $1"
}
print_warning() {
echo -e "${YELLOW}[WARNING]${NC} $1"
}
print_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
# Function to check if a command exists
command_exists() {
command -v "$1" >/dev/null 2>&1
}
# Function to check system requirements
check_requirements() {
print_status "Checking system requirements..."
local missing_deps=()
# Check Python
if ! command_exists python3; then
missing_deps+=("python3")
else
local python_version=$(python3 --version | cut -d' ' -f2 | cut -d'.' -f1,2)
if (( $(echo "$python_version < 3.11" | bc -l) )); then
print_warning "Python version $python_version detected. Python 3.11+ recommended."
fi
fi
# Check uv
if ! command_exists uv; then
missing_deps+=("uv")
fi
# Check Node.js
if ! command_exists node; then
missing_deps+=("node")
else
local node_version=$(node --version | cut -d'v' -f2 | cut -d'.' -f1)
if (( node_version < 18 )); then
print_warning "Node.js version $node_version detected. Node.js 18+ recommended."
fi
fi
# Check pnpm
if ! command_exists pnpm; then
missing_deps+=("pnpm")
fi
# Check PostgreSQL (optional)
if ! command_exists psql; then
print_warning "PostgreSQL not found. SQLite will be used for development."
fi
# Check Redis (optional)
if ! command_exists redis-server; then
print_warning "Redis not found. Some features may not work."
fi
if [ ${#missing_deps[@]} -ne 0 ]; then
print_error "Missing required dependencies: ${missing_deps[*]}"
print_status "Please install the missing dependencies and run this script again."
print_status "Installation instructions:"
print_status " - Python 3.11+: https://www.python.org/downloads/"
print_status " - uv: pip install uv"
print_status " - Node.js 18+: https://nodejs.org/"
print_status " - pnpm: npm install -g pnpm"
exit 1
fi
print_success "All system requirements met!"
}
# Function to setup backend
setup_backend() {
print_status "Setting up Django backend..."
cd "$BACKEND_DIR"
# Install Python dependencies with uv
print_status "Installing Python dependencies..."
if [ ! -d ".venv" ]; then
uv sync
else
print_warning "Virtual environment already exists. Updating dependencies..."
uv sync
fi
# Create .env file if it doesn't exist
if [ ! -f ".env" ]; then
print_status "Creating backend .env file..."
cp .env.example .env
print_warning "Please edit backend/.env with your settings"
else
print_warning "Backend .env file already exists"
fi
# Run database migrations
print_status "Running database migrations..."
uv run manage.py migrate
# Create superuser (optional)
print_status "Creating Django superuser..."
echo "from django.contrib.auth import get_user_model; User = get_user_model(); User.objects.filter(username='admin').exists() or User.objects.create_superuser('admin', 'admin@example.com', 'admin')" | uv run manage.py shell
print_success "Backend setup completed!"
cd "$PROJECT_ROOT"
}
# Function to setup frontend
setup_frontend() {
print_status "Setting up Vue.js frontend..."
cd "$FRONTEND_DIR"
# Install Node.js dependencies
print_status "Installing Node.js dependencies..."
if [ ! -d "node_modules" ]; then
pnpm install
else
print_warning "node_modules already exists. Updating dependencies..."
pnpm install
fi
# Create environment files if they don't exist
if [ ! -f ".env.local" ]; then
print_status "Creating frontend .env.local file..."
cp .env.development .env.local
print_warning "Please edit frontend/.env.local with your settings"
else
print_warning "Frontend .env.local file already exists"
fi
print_success "Frontend setup completed!"
cd "$PROJECT_ROOT"
}
# Function to setup root environment
setup_root_env() {
print_status "Setting up root environment..."
cd "$PROJECT_ROOT"
# Create root .env file if it doesn't exist
if [ ! -f ".env" ]; then
print_status "Creating root .env file..."
cp .env.example .env
print_warning "Please edit .env with your settings"
else
print_warning "Root .env file already exists"
fi
print_success "Root environment setup completed!"
}
# Function to verify setup
verify_setup() {
print_status "Verifying setup..."
local issues=()
# Check backend
cd "$BACKEND_DIR"
if [ ! -d ".venv" ]; then
issues+=("Backend virtual environment not found")
fi
if [ ! -f ".env" ]; then
issues+=("Backend .env file not found")
fi
# Check if Django can start
if ! uv run manage.py check --settings=config.django.local >/dev/null 2>&1; then
issues+=("Django configuration check failed")
fi
cd "$FRONTEND_DIR"
# Check frontend
if [ ! -d "node_modules" ]; then
issues+=("Frontend node_modules not found")
fi
if [ ! -f ".env.local" ]; then
issues+=("Frontend .env.local file not found")
fi
# Check if Vue can build
if ! pnpm run type-check >/dev/null 2>&1; then
issues+=("Vue.js type check failed")
fi
cd "$PROJECT_ROOT"
if [ ${#issues[@]} -ne 0 ]; then
print_warning "Setup verification found issues:"
for issue in "${issues[@]}"; do
echo -e " - ${YELLOW}$issue${NC}"
done
return 1
else
print_success "Setup verification passed!"
return 0
fi
}
# Function to show usage
show_usage() {
cat << EOF
Usage: $0 [OPTIONS]
Set up the complete ThrillWiki development environment.
Options:
-h, --help Show this help message
-b, --backend-only Setup only the backend
-f, --frontend-only Setup only the frontend
-y, --yes Skip confirmation prompts
--no-verify Skip setup verification
Examples:
$0 # Setup both backend and frontend
$0 --backend-only # Setup only backend
$0 --frontend-only # Setup only frontend
Environment Variables:
SKIP_CONFIRMATION Set to 'true' to skip confirmation prompts
SKIP_VERIFICATION Set to 'true' to skip verification
EOF
}
# Parse command line arguments
BACKEND_ONLY=false
FRONTEND_ONLY=false
SKIP_CONFIRMATION=false
SKIP_VERIFICATION=false
while [[ $# -gt 0 ]]; do
case $1 in
-h|--help)
show_usage
exit 0
;;
-b|--backend-only)
BACKEND_ONLY=true
shift
;;
-f|--frontend-only)
FRONTEND_ONLY=true
shift
;;
-y|--yes)
SKIP_CONFIRMATION=true
shift
;;
--no-verify)
SKIP_VERIFICATION=true
shift
;;
*)
print_error "Unknown option: $1"
show_usage
exit 1
;;
esac
done
# Override from environment variables
if [ "$SKIP_CONFIRMATION" = "true" ] || [ "$SKIP_CONFIRMATION_ENV" = "true" ]; then
SKIP_CONFIRMATION=true
fi
if [ "$SKIP_VERIFICATION" = "true" ] || [ "$SKIP_VERIFICATION_ENV" = "true" ]; then
SKIP_VERIFICATION=true
fi
# Print banner
echo -e "${GREEN}"
echo "=========================================="
echo " ThrillWiki Development Setup"
echo "=========================================="
echo -e "${NC}"
print_status "Project root: $PROJECT_ROOT"
# Confirmation prompt
if [ "$SKIP_CONFIRMATION" = false ]; then
echo ""
read -p "This will set up the development environment. Continue? (y/N): " -n 1 -r
echo ""
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
print_status "Setup cancelled."
exit 0
fi
fi
# Check requirements
check_requirements
# Setup components based on options
if [ "$BACKEND_ONLY" = true ]; then
print_status "Setting up backend only..."
setup_backend
setup_root_env
elif [ "$FRONTEND_ONLY" = true ]; then
print_status "Setting up frontend only..."
setup_frontend
setup_root_env
else
print_status "Setting up both backend and frontend..."
setup_backend
setup_frontend
setup_root_env
fi
# Verify setup
if [ "$SKIP_VERIFICATION" = false ]; then
echo ""
if verify_setup; then
print_success "Development environment setup completed successfully!"
echo ""
print_status "Next steps:"
echo " 1. Edit .env files with your configuration"
echo " 2. Start development servers: ./shared/scripts/dev/start-all.sh"
echo " 3. Visit http://localhost:5174 for the frontend"
echo " 4. Visit http://localhost:8000 for the backend API"
echo ""
print_status "Happy coding! 🚀"
else
print_warning "Setup completed with issues. Please review the warnings above."
exit 1
fi
else
print_success "Development environment setup completed!"
print_status "Skipped verification as requested."
fi

279
shared/scripts/dev/start-all.sh Executable file
View File

@@ -0,0 +1,279 @@
#!/bin/bash
# ThrillWiki Development Server Starter
# Starts both Django backend and Vue.js frontend servers concurrently
set -e
# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# Script directory and project root
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
# Configuration
BACKEND_PORT=8000
FRONTEND_PORT=5174
BACKEND_DIR="$PROJECT_ROOT/backend"
FRONTEND_DIR="$PROJECT_ROOT/frontend"
# Function to print colored output
print_status() {
echo -e "${BLUE}[INFO]${NC} $1"
}
print_success() {
echo -e "${GREEN}[SUCCESS]${NC} $1"
}
print_warning() {
echo -e "${YELLOW}[WARNING]${NC} $1"
}
print_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
# Function to check if a port is available
check_port() {
local port=$1
if lsof -Pi :$port -sTCP:LISTEN -t >/dev/null ; then
return 1
else
return 0
fi
}
# Function to kill process on port
kill_port() {
local port=$1
local pid=$(lsof -ti:$port)
if [ ! -z "$pid" ]; then
print_warning "Killing process $pid on port $port"
kill -9 $pid
fi
}
# Function to wait for service to be ready
wait_for_service() {
local url=$1
local service_name=$2
local max_attempts=30
local attempt=1
print_status "Waiting for $service_name to be ready at $url"
while [ $attempt -le $max_attempts ]; do
if curl -s -f "$url" > /dev/null 2>&1; then
print_success "$service_name is ready!"
return 0
fi
echo -n "."
sleep 2
((attempt++))
done
print_error "$service_name failed to start after $max_attempts attempts"
return 1
}
# Function to start backend server
start_backend() {
print_status "Starting Django backend server..."
# Kill any existing process on backend port
kill_port $BACKEND_PORT
# Clean up Python cache files
find "$BACKEND_DIR" -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
cd "$BACKEND_DIR"
# Check if virtual environment exists
if [ ! -d ".venv" ]; then
print_error "Backend virtual environment not found. Please run setup-dev.sh first."
exit 1
fi
# Start Django server in background
print_status "Starting Django development server on port $BACKEND_PORT"
uv run manage.py runserver 0.0.0.0:$BACKEND_PORT &
BACKEND_PID=$!
# Wait for backend to be ready
wait_for_service "http://localhost:$BACKEND_PORT/api/" "Django backend"
cd "$PROJECT_ROOT"
}
# Function to start frontend server
start_frontend() {
print_status "Starting Vue.js frontend server..."
cd "$FRONTEND_DIR"
# Check if node_modules exists
if [ ! -d "node_modules" ]; then
print_error "Frontend dependencies not installed. Please run setup-dev.sh first."
exit 1
fi
# Start Vue.js dev server in background
print_status "Starting Vue.js development server on port $FRONTEND_PORT"
pnpm run dev &
FRONTEND_PID=$!
# Wait for frontend to be ready
wait_for_service "http://localhost:$FRONTEND_PORT" "Vue.js frontend"
cd "$PROJECT_ROOT"
}
# Function to cleanup on script exit
cleanup() {
print_warning "Shutting down development servers..."
if [ ! -z "$BACKEND_PID" ]; then
kill $BACKEND_PID 2>/dev/null || true
fi
if [ ! -z "$FRONTEND_PID" ]; then
kill $FRONTEND_PID 2>/dev/null || true
fi
# Kill any remaining processes on our ports
kill_port $BACKEND_PORT
kill_port $FRONTEND_PORT
print_success "Development servers stopped."
exit 0
}
# Function to show usage
show_usage() {
cat << EOF
Usage: $0 [OPTIONS]
Start both Django backend and Vue.js frontend development servers.
Options:
-h, --help Show this help message
-b, --backend-only Start only the backend server
-f, --frontend-only Start only the frontend server
-p, --production Start in production mode (if applicable)
--no-wait Don't wait for services to be ready
Examples:
$0 # Start both servers
$0 --backend-only # Start only backend
$0 --frontend-only # Start only frontend
Environment Variables:
BACKEND_PORT Backend server port (default: 8000)
FRONTEND_PORT Frontend server port (default: 5174)
EOF
}
# Parse command line arguments
BACKEND_ONLY=false
FRONTEND_ONLY=false
PRODUCTION=false
WAIT_FOR_SERVICES=true
while [[ $# -gt 0 ]]; do
case $1 in
-h|--help)
show_usage
exit 0
;;
-b|--backend-only)
BACKEND_ONLY=true
shift
;;
-f|--frontend-only)
FRONTEND_ONLY=true
shift
;;
-p|--production)
PRODUCTION=true
shift
;;
--no-wait)
WAIT_FOR_SERVICES=false
shift
;;
*)
print_error "Unknown option: $1"
show_usage
exit 1
;;
esac
done
# Override ports from environment if set
if [ ! -z "$BACKEND_PORT_ENV" ]; then
BACKEND_PORT=$BACKEND_PORT_ENV
fi
if [ ! -z "$FRONTEND_PORT_ENV" ]; then
FRONTEND_PORT=$FRONTEND_PORT_ENV
fi
# Set up signal handlers for graceful shutdown
trap cleanup SIGINT SIGTERM
# Print banner
echo -e "${GREEN}"
echo "=========================================="
echo " ThrillWiki Development Environment"
echo "=========================================="
echo -e "${NC}"
print_status "Project root: $PROJECT_ROOT"
print_status "Backend port: $BACKEND_PORT"
print_status "Frontend port: $FRONTEND_PORT"
# Check if required tools are available
command -v uv >/dev/null 2>&1 || { print_error "uv is required but not installed. Please install uv first."; exit 1; }
command -v pnpm >/dev/null 2>&1 || { print_error "pnpm is required but not installed. Please install pnpm first."; exit 1; }
command -v curl >/dev/null 2>&1 || { print_error "curl is required but not installed."; exit 1; }
# Start services based on options
if [ "$BACKEND_ONLY" = true ]; then
print_status "Starting backend only..."
start_backend
print_success "Backend server started successfully!"
print_status "Backend URL: http://localhost:$BACKEND_PORT"
print_status "API URL: http://localhost:$BACKEND_PORT/api/"
wait
elif [ "$FRONTEND_ONLY" = true ]; then
print_status "Starting frontend only..."
start_frontend
print_success "Frontend server started successfully!"
print_status "Frontend URL: http://localhost:$FRONTEND_PORT"
wait
else
print_status "Starting both backend and frontend servers..."
start_backend &
BACKEND_PID=$!
start_frontend &
FRONTEND_PID=$!
print_success "Development servers started successfully!"
echo ""
print_status "Backend URL: http://localhost:$BACKEND_PORT"
print_status "API URL: http://localhost:$BACKEND_PORT/api/"
print_status "Frontend URL: http://localhost:$FRONTEND_PORT"
echo ""
print_status "Press Ctrl+C to stop all servers"
# Wait for both processes
wait
fi