╔════════════════════════════════════════════════════════════════╗
║                                                                ║
║          CARGOFLOW - SETUP CHECKLIST                          ║
║          Cargo Management System                               ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

STEP 1: CREATE DATABASE
═══════════════════════════════════════════════════════════════

Choose ONE method:

□ Method A: Double-click "create_database.bat"
           Enter MySQL password when prompted

□ Method B: Open MySQL Command Line
           mysql -u root -p
           CREATE DATABASE cargo_management;
           exit;

□ Method C: Open phpMyAdmin (http://localhost/phpmyadmin)
           Click "New"
           Database name: cargo_management
           Click "Create"

STEP 2: CONFIGURE ENVIRONMENT
═══════════════════════════════════════════════════════════════

□ Open .env file
□ Check these settings:
  
  DB_CONNECTION=mysql
  DB_HOST=127.0.0.1
  DB_PORT=3306
  DB_DATABASE=cargo_management
  DB_USERNAME=root
  DB_PASSWORD=your_password_here  ← UPDATE THIS!

STEP 3: INSTALL DEPENDENCIES
═══════════════════════════════════════════════════════════════

□ Open Command Prompt in project folder
□ Run: composer install
□ Run: composer require barryvdh/laravel-dompdf

STEP 4: RUN MIGRATIONS
═══════════════════════════════════════════════════════════════

□ Run: php artisan migrate

  This creates these tables:
  ✓ customers
  ✓ rates
  ✓ bookings
  ✓ shipment_tracking
  ✓ sessions
  ✓ cache
  ✓ jobs

STEP 5: START THE SERVER
═══════════════════════════════════════════════════════════════

□ Run: php artisan serve
□ Open browser
□ Visit: http://localhost:8000

STEP 6: FIRST USE
═══════════════════════════════════════════════════════════════

□ Create your first customer
  Dashboard → Customers → New Customer

□ Set up rates
  Dashboard → Rates → New Rate

□ Create a booking
  Dashboard → Bookings → New Booking

□ Track shipment
  Dashboard → Track Shipment

TROUBLESHOOTING
═══════════════════════════════════════════════════════════════

Problem: Database connection error
Solution: 
  □ Check MySQL is running (XAMPP/WAMP)
  □ Verify password in .env
  □ Ensure database exists

Problem: Migration errors
Solution:
  □ Run: php artisan migrate:fresh
  □ Check database credentials

Problem: Composer errors
Solution:
  □ Run: composer update
  □ Check PHP version (need 8.2+)

Problem: PDF not working
Solution:
  □ Run: composer require barryvdh/laravel-dompdf
  □ Run: php artisan config:clear

QUICK REFERENCE
═══════════════════════════════════════════════════════════════

URLs:
  Dashboard:  http://localhost:8000
  Customers:  http://localhost:8000/customers
  Rates:      http://localhost:8000/rates
  Bookings:   http://localhost:8000/bookings
  Tracking:   http://localhost:8000/track

Commands:
  Start server:     php artisan serve
  Run migrations:   php artisan migrate
  Clear cache:      php artisan config:clear
  Reset database:   php artisan migrate:fresh

Files to Check:
  .env              - Database configuration
  DATABASE_SETUP.md - Detailed database guide
  QUICK_START.md    - Getting started guide
  START_HERE.md     - Project overview

SYSTEM REQUIREMENTS
═══════════════════════════════════════════════════════════════

✓ PHP 8.2 or higher
✓ Composer
✓ MySQL 5.7+ or MariaDB 10.3+
✓ Web browser (Chrome, Firefox, Edge)

FEATURES INCLUDED
═══════════════════════════════════════════════════════════════

✓ Customer Management
✓ Rate Management (KG/CBM/Per Carton)
✓ Booking Entry with CNTR numbers
✓ Shipment Status Tracking
✓ PDF Invoice Generation
✓ Analytics Dashboard
✓ Beautiful Responsive UI

SUPPORT
═══════════════════════════════════════════════════════════════

Documentation:
  □ START_HERE.md - Quick overview
  □ QUICK_START.md - Fast setup
  □ DATABASE_SETUP.md - Database help
  □ INSTALLATION_GUIDE.md - Detailed guide
  □ PROJECT_OVERVIEW.md - All features

═══════════════════════════════════════════════════════════════

Ready to start? Follow the steps above! 🚀

═══════════════════════════════════════════════════════════════
