Installation Guide - luckydeva03/barbershop_app GitHub Wiki

📦 Installation Guide

Panduan lengkap instalasi sistem manajemen barbershop.

📋 System Requirements

Minimum Requirements

PHP: 8.2 atau lebih tinggi
Composer: 2.0+
Node.js: 16+ dan npm
Database: MySQL 8.0+ atau SQLite
Web Server: Apache/Nginx
Memory: 512MB RAM minimum

Recommended Requirements

PHP: 8.3+
Memory: 1GB+ RAM
Storage: 2GB+ free space
SSL Certificate: Untuk production

🔧 Step-by-Step Installation

1. Clone Repository

# Clone dari GitHub
git clone https://github.com/luckydeva03/barbershop_app.git
cd barbershop_app

# Atau download ZIP dan extract

2. Install PHP Dependencies

# Install dependencies dengan Composer
composer install

# Untuk production
composer install --no-dev --optimize-autoloader

3. Install Node.js Dependencies

# Install frontend dependencies
npm install

# Atau menggunakan Yarn
yarn install

4. Environment Configuration

# Copy file environment
cp .env.example .env

# Generate application key
php artisan key:generate

Environment Variables yang Perlu Diatur:

# Database Configuration
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=barbershop_app
DB_USERNAME=root
DB_PASSWORD=

# Google OAuth (Optional)
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URL=http://localhost:8000/auth/google/callback

# WhatsApp Integration (Optional)
WHATSAPP_API_TOKEN=your_whatsapp_token
WHATSAPP_PHONE_NUMBER=your_whatsapp_number

5. Database Setup

# Buat database terlebih dahulu
mysql -u root -p
CREATE DATABASE barbershop_app;
EXIT;

# Jalankan migrasi
php artisan migrate

# Seed data sample (opsional)
php artisan db:seed

6. Build Frontend Assets

# Development build
npm run dev

# Production build
npm run build

# Watch mode untuk development
npm run dev -- --watch

7. Storage Link

# Buat symbolic link untuk storage
php artisan storage:link

8. Set Permissions (Linux/Mac)

# Set permission untuk storage dan cache
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

9. Start Development Server

# Start Laravel development server
php artisan serve

# Akses di: http://localhost:8000

🔐 Default Login Credentials

Admin Account

Email: [email protected]
Password: password123
Dashboard: http://localhost:8000/admin

Customer Account

Email: [email protected]
Password: password123
Portal: http://localhost:8000/login

✅ Post-Installation Verification

Setelah instalasi, verifikasi bahwa:

Frontend Tests

Halaman utama dapat diakses tanpa error
CSS dan JavaScript ter-load dengan benar
Responsive design berfungsi di mobile

Authentication Tests

Login admin berhasil
Login customer berhasil
Google OAuth berfungsi (jika dikonfigurasi)
Logout berfungsi dengan benar

Database Tests

Database terkoneksi tanpa error
Migrasi berjalan successfully
Seeder data ter-load dengan benar

Feature Tests

Dashboard admin dapat diakses
Customer portal berfungsi
Point system berjalan
Store listing tampil

🚨 Common Installation Issues

1. Permission Issues

# Error: Permission denied
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R $USER:www-data storage bootstrap/cache

2. Database Connection Error

# Periksa service MySQL
sudo systemctl status mysql

# Restart MySQL service
sudo systemctl restart mysql

# Test koneksi database
php artisan tinker
DB::connection()->getPdo();

3. Composer Dependencies Error

# Clear composer cache
composer clear-cache

# Install dengan verbose output
composer install -v

# Update dependencies jika ada konflik
composer update

4. Node.js Build Errors

# Clear npm cache
npm cache clean --force

# Reinstall dependencies
rm -rf node_modules package-lock.json
npm install

# Alternative: gunakan yarn
yarn install

5. Storage Link Error

# Hapus link yang ada
rm public/storage

# Buat ulang storage link
php artisan storage:link

# Manual link (jika artisan gagal)
ln -s ../storage/app/public public/storage

6. Vite Build Issues

# Install vite dependencies
npm install vite @vitejs/plugin-laravel --save-dev

# Build ulang assets
npm run build

🔧 Development Environment Setup

Laravel Sail (Docker)

# Install Sail
composer require laravel/sail --dev

# Publish sail configuration
php artisan sail:install

# Start dengan Sail
./vendor/bin/sail up -d

VS Code Extensions (Recommended)

Laravel Extension Pack
PHP Intelephense
Laravel Blade Snippets
Laravel Artisan
Tailwind CSS IntelliSense

Browser Extensions untuk Development

Laravel Debugbar
Vue.js devtools (jika menggunakan Vue)
React DevTools (jika menggunakan React)

📊 Performance Optimization

After Installation Optimizations

# Optimize autoloader
composer dump-autoload --optimize

# Cache configuration
php artisan config:cache

# Cache routes
php artisan route:cache

# Cache views
php artisan view:cache

Database Optimization

# Create indexes untuk performa
php artisan migrate:status

# Optimize database tables
php artisan db:optimize

📞 Need Help?

Jika mengalami kesulitan instalasi:

Check Requirements: Pastikan semua requirement terpenuhi
Read Error Messages: Baca pesan error dengan teliti
Check Logs: Lihat storage/logs/laravel.log untuk detail error
Troubleshooting Guide: Baca Troubleshooting untuk solusi umum
Create Issue: Report Bug jika masih bermasalah

Next Step: Quick Start Guide untuk mulai menggunakan aplikasi.