PGADMIN FIX:
- Changed email from admin@businessanalytics.local to admin@example.com
- pgAdmin rejects .local domains as invalid email addresses
- Updated all documentation with correct email
SETUP VERIFICATION:
- Added 5 SQL verification queries to setup-database.sh
- Query 1: Sample countries (top 5)
- Query 2: Sample merchant categories (top 5)
- Query 3: All transaction types with descriptions
- Query 4: All fraud types ordered by severity
- Query 5: All customer segments with descriptions
BENEFITS:
- Users can immediately see that data was loaded correctly
- Provides visual confirmation of schema setup
- Shows sample data structure before generating full dataset
- Helps troubleshoot setup issues early
DOCKER COMPOSE:
- Replaced ghcr.io/n7olkachev/db-ui with dpage/pgadmin4:latest
- Added pgadmin_data volume for persistent configuration
- Configured pgAdmin with default credentials
- Port mapping: 3000:80 (pgAdmin runs on port 80 internally)
DOCUMENTATION:
- Updated README.md with pgAdmin login instructions and first-time setup
- Updated QUICKSTART.md with detailed pgAdmin configuration steps
- Added server connection details for easy setup
BENEFITS:
- pgAdmin has proper multi-platform support (linux/amd64, linux/arm64, etc.)
- Industry-standard PostgreSQL management tool
- More features: query builder, schema visualization, data import/export
- Better documentation and community support
Explicitly set platform: linux/amd64 for db-ui service
Fixes: no matching manifest for linux/amd64 error
The db-ui image has limited platform support, forcing amd64 ensures compatibility on x86_64 Linux systems
DOCKER COMPOSE:
- Removed obsolete 'version' attribute from docker-compose.yml
- Keeps db-ui image as ghcr.io/n7olkachev/db-ui:latest
SCRIPT PERMISSIONS:
- Updated README.md with recursive chmod command: find . -name '*.sh' -exec chmod +x {} \;
- Updated QUICKSTART.md with Step 0: Make Scripts Executable
- Removed individual chmod commands from each step
- Single command makes all .sh files executable at once
DOCUMENTATION:
- Renumbered steps in QUICKSTART.md for clarity
- Step 0: Make Scripts Executable
- Step 1: Install Dependencies (Optional)
- Step 2: Start Docker Containers
- Step 3: Initialize Database Schema
- Step 4: Generate Test Data
This resolves the Docker Compose warning and simplifies the setup process with a single chmod command.
- Docker setup with PostgreSQL 16 and DB-UI web interface
- Comprehensive 20+ table schema with fraud detection patterns
- Idempotent shell scripts for data generation (no Python dependency)
- Realistic geographic data (100 US cities, 210 world cities)
- 5M+ transactions with embedded fraud patterns (velocity, geographic, structuring, etc.)
- Progressive SQL exercises from beginner to advanced fraud detection
- Complete documentation and quick start guide
- Setup and verification scripts
Alphaeus Mote