README — Laravel Project (PHP 8.3 + MySQL) — (Tanpa Docker)

Versi singkat: README ini fokus ke setup lokal (tanpa Docker). Langkahnya mencakup instalasi dependensi, konfigurasi MySQL, migrasi, dan menjalankan UserSeeder + LOVSeeder.

---

Daftar isi

1. Prasyarat
2. Persiapan environment per OS (ringkas)
3. Setup project (perintah langkah demi langkah)
4. Contoh .env
5. Menjalankan migrasi & seeder
6. Menjalankan aplikasi (dev)
7. Troubleshooting & tips
8. Jalan pintas (opsional)

---

1) Prasyarat

• PHP 8.3 (wajib)
• Composer
• Node.js & npm/yarn (untuk assets/Vite)
• MySQL (atau MariaDB) berjalan
• Git (opsional)

Kalau kamu nggak bisa install PHP 8.3 di mesin kamu, cara paling gampang di Windows: pake Laragon; di macOS: pake Homebrew atau pakai paket prebuilt; di Linux: gunakan package manager atau tool seperti phpenv/asdf.

---

2) Persiapan environment per OS (ringkas)

• Windows: rekomendasi Laragon (udah termasuk PHP, MySQL, Composer) atau XAMPP (tapi XAMPP kadang versi PHP-nya nggak terbaru).
• macOS: pakai Homebrew (misal install php@8.3 jika tersedia) atau gunakan asdf/php jika mau versi multiple.
• Linux (Ubuntu/Debian): gunakan paket distro atau PPA (mis. ondrej/php) atau asdf/php.

Aku nggak tulis perintah instalasi yang detil karena tiap mesin beda. Bilang OS kamu, nanti aku kasih perintah step-by-step.

---

3) Setup project — langkah lengkap

1. Clone repo dan masuk folder project:

git clone <repo-url>
cd <repo-folder>

2. Install dependensi PHP (composer):

composer install

Kalau composer error karena memory: jalankan COMPOSER_MEMORY_LIMIT=-1 composer install.

3. Salin file environment dan generate app key:

cp .env.example .env
php artisan key:generate

4. Buat database MySQL (contoh nama laravel_app). Kamu bisa buat lewat MySQL CLI atau GUI (phpMyAdmin/MySQL Workbench).

5. Sesuaikan konfigurasi database di .env (contoh ada di bawah).

6. (Opsional) jika ada dependency Node/Vite:

npm install
# atau
yarn

---

4) Contoh .env (bagian penting saja)

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:...
APP_DEBUG=true
APP_URL=http://localhost:8000

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_app
DB_USERNAME=root
DB_PASSWORD=secret

# Vite dev server (jika perlu)
VITE_DEV_SERVER=true

Jika MySQL berjalan di port lain atau kamu pakai socket, sesuaikan DB_HOST/DB_PORT.

---

5) Menjalankan migrasi & seeder

Setelah .env terkonfigurasi dan database dibuat:

# migrasi + semua seeder yang terdaftar di DatabaseSeeder
php artisan migrate --seed

# atau jika mau bersih dan migrate ulang
php artisan migrate:fresh --seed

# menjalankan seeder spesifik jika perlu
php artisan db:seed --class=UserSeeder
php artisan db:seed --class=LOVSeeder

Catatan:

• Pastikan class seeder ada di database/seeders dan namespace-nya benar.
• Jika artisan nggak nemuin class seeder, jalankan composer dump-autoload dulu.

---

6) Menjalankan aplikasi (development)

Simple dev server Laravel:

php artisan serve --host=127.0.0.1 --port=8000

Jika kamu juga pakai Vite (assets JS/CSS):

npm run dev
# atau
npm run build (untuk produksi)

Akses di http://127.0.0.1:8000 atau http://localhost:8000.

---

7) Troubleshooting & tips cepat

• Class seeder tidak ditemukan: composer dump-autoload lalu php artisan db:seed --class=NamaSeeder.
• Permission storage (Linux/macOS):

sudo chown -R $USER:www-data storage bootstrap/cache
chmod -R 775 storage bootstrap/cache

• Composer gagal karena memory: COMPOSER_MEMORY_LIMIT=-1 composer install.
• Versi PHP tidak cocok: Pastikan CLI PHP yang aktif versi 8.3: php -v.
• MySQL connection refused: pastikan MySQL jalan dan kredensial di .env benar.
• Vite HMR gagal: pastikan APP_URL di .env cocok alamat yang dipakai di browser.

---

8) Jalan pintas / tambahan yang bisa aku bantu

• Buat skrip bash/PowerShell untuk otomatis composer install, php artisan migrate --seed, dsb.
• Beri panduan instalasi PHP 8.3 per OS (langkah step-by-step).
• Debug error yang muncul (paste log atau screenshot).

---

Kalau mau, kasih tahu OS kamu (Windows / macOS / Ubuntu / WSL) — nanti aku tambahin langkah instalasi PHP