DEPLOY SCRIPT IMPROVEMENTS:
- Start PostgreSQL first with --no-deps flag
- Wait for PostgreSQL to be healthy (increased to 120 seconds)
- Start pgAdmin separately after PostgreSQL is ready
- Added note that pgAdmin takes 30-60 seconds to initialize
- pgAdmin startup no longer blocks database operations
DOCKER COMPOSE FIX:
- Removed health check condition from pgAdmin depends_on
- Changed from 'condition: service_healthy' to simple dependency
- pgAdmin can start independently without waiting for PostgreSQL health
- Prevents 'Container is unhealthy' errors during startup
TROUBLESHOOTING SECTION:
- Added troubleshooting tips to deploy.sh output
- Command to check pgAdmin status: docker logs business_analytics_ui
- Instructions to wait for pgAdmin initialization
- Look for 'Listening at: http://[::]:80' in logs
BENEFITS:
- No more 'Container is unhealthy' errors
- Database operations can proceed while pgAdmin initializes
- Clear user expectations about pgAdmin startup time
- Better error handling and troubleshooting guidance
NEW SCRIPT: deploy.sh - Master deployment automation
- Tears down existing containers and volumes
- Fixes file permissions automatically
- Starts fresh containers
- Initializes database schema
- Generates test data
- Verifies deployment
- IDEMPOTENT: Safe to run multiple times
FEATURES:
- Beautiful colored output with progress indicators
- Confirmation prompt before destructive operations
- Waits for PostgreSQL to be healthy before proceeding
- Comprehensive access information at completion
- Useful commands reference
DOCUMENTATION:
- Updated README.md with Option A (one-command) and Option B (manual)
- Updated QUICKSTART.md with super quick start section
- Manual steps now in collapsible section
USER EXPERIENCE:
- Clone repo + run deploy.sh = DONE
- No more complex multi-step setup
- Perfect for demos and quick testing
- Rebuilds from scratch every time (no stale data)
Alphaeus Mote