4 Commits

Author	SHA1	Message	Date
Alphaeus Mote	a7e2fea1ba	Add Python installation detection and Windows-specific instructions ... DEPLOY SCRIPT IMPROVEMENTS: - Added explicit Python availability check before CSV generation - Supports both python3 and python commands (Windows uses 'python') - Clear error message if Python is not installed - Windows-specific installation instructions with Microsoft Store option - Linux/macOS instructions to run dependency installer - Prevents silent failures when Python is missing DEPENDENCY INSTALLER ENHANCEMENTS: - Enhanced Windows section with detailed installation steps - Added Microsoft Store option (easiest for Windows users) - Added official Python installer option with PATH checkbox reminder - Clear verification command: python --version - Instructions to close/reopen PowerShell after installation PROBLEM SOLVED: - CSV import was showing 0 rows because Python script never ran - Python not installed on Windows by default - Script failed silently without clear error message - Users now get clear instructions on how to install Python NEXT STEPS FOR USERS: 1. Install Python 3 from Microsoft Store or python.org 2. Close and reopen PowerShell 3. Run ./deploy.sh again 4. CSV generation will work and data will persist	2025-10-24 12:55:28 -04:00
Alphaeus Mote	e2090cc6ad	Add Python dependency and start CSV-based data generation ... DEPENDENCY INSTALLER UPDATES: - Added Python 3 installation check and installer - Python is required for fast CSV data generation - Updated step numbers from [1/4] to [1/5] - Python installed before PostgreSQL client - Supports Ubuntu, Debian, CentOS, RHEL, Fedora, Arch, macOS DEPLOY SCRIPT UPDATES: - Added automatic dependency checking (Step 3/8) - Checks for python3, psql, and docker - Automatically runs install-dependencies.sh if missing - Updated all step numbers to reflect 8 total steps - Step 3: Check dependencies (NEW) - Step 4: Fix permissions (was Step 3) - Step 5: Start containers (was Step 4) - Step 6: Initialize schema (was Step 5) - Step 7: Generate data (was Step 6) - Step 8: Verify deployment (was Step 7) CSV DATA GENERATION (IN PROGRESS): - Created scripts/generate_csv_data.py - Python-based CSV generator for bulk import - Much faster than SQL INSERT statements - Generates realistic data with proper relationships - Partial implementation (customers, accounts, merchants, cards) - Next: Complete transactions and analytics data RATIONALE: - Current bash-based data generation has transaction commit issues - Data shows as generated but doesn't persist (0 rows after completion) - CSV + COPY command is PostgreSQL best practice for bulk loading - 10-100x faster than INSERT statements - More reliable - atomic COPY operations - Easier to debug - can inspect CSV files	2025-10-24 12:43:39 -04:00
Alphaeus Mote	7058a96519	Add comprehensive permissions management for Docker bind mounts ... NEW SCRIPT: Created scripts/fix-permissions.sh - automated permission fixer Takes ownership of repository files, makes scripts executable, sets proper permissions Verifies permissions are correct before proceeding DOCKER COMPOSE: Added header comments explaining permission requirements DOCUMENTATION: Updated README.md and QUICKSTART.md with permission setup steps WHY CRITICAL: Docker bind mounts require proper file ownership to work correctly USER EXPERIENCE: Single command ./scripts/fix-permissions.sh handles everything	2025-10-23 16:45:19 -04:00
Alphaeus Mote	3dde2997f6	Add automatic dependency installer and package checks ... DEPENDENCY MANAGEMENT: - Created scripts/install-dependencies.sh - automatic installer for all required packages - Detects OS (Ubuntu, Debian, CentOS, RHEL, Fedora, Arch, macOS) - Installs PostgreSQL client (psql) automatically - Installs Docker & Docker Compose if missing - Installs utility packages (curl, wget, git) SCRIPT ENHANCEMENTS: - Updated setup-database.sh with dependency checking - Updated generate_data.sh with dependency checking - Updated verify-setup.sh with dependency checking - All scripts now prompt to run installer if dependencies are missing - Interactive prompts guide users through installation DOCUMENTATION: - Updated README.md with dependency installation instructions - Updated QUICKSTART.md with Step 0: Install Dependencies - Added supported OS list - Added automatic dependency check notes USER EXPERIENCE: - No more manual package installation required - Scripts fail gracefully with helpful error messages - One-command installation: ./scripts/install-dependencies.sh - Automatic detection and installation on Linux/macOS - Clear instructions for Windows users This ensures users can get started immediately without hunting for package installation commands.	2025-10-23 14:34:11 -04:00