ProTrack - Dokumentasi & Instalasi

Persyaratan Sistem

Pastikan perangkat Anda memenuhi spesifikasi software berikut untuk menjalankan aplikasi tanpa kendala.

PHP Runtime

Versi ≥ 8.1 (Rek: 8.2)

Dibutuhkan ekstensi: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, dan BCMath.

Unduh PHP

Composer

Versi ≥ 2.2 (Rek: 2.x)

Package manager untuk PHP yang digunakan untuk memanajemen dependensi framework Laravel.

Unduh Composer

Node.js & NPM

Versi ≥ 18.x (Rek: 20.x LTS)

Diperlukan oleh bundler Vite untuk mengompilasi aset CSS dan Javascript modern (NPM ≥ 9.x).

Unduh Node.js

MySQL / MariaDB

MySQL ≥ 8.0 / MariaDB ≥ 10.4

Sistem database relasional untuk menyimpan seluruh data operasional, tugas, dan log sistem ProTrack.

Unduh MySQL

Laragon (Alternatif Stack)

Sangat Direkomendasikan

Untuk Windows, Laragon menyediakan PHP, MySQL, Apache, Nginx, Git, Composer secara bundle instan & cepat.

Unduh Laragon

Panduan Instalasi Proyek

Ikuti langkah-langkah di bawah untuk memasang dan menjalankan aplikasi di server lokal Anda.

Ekstrak Berkas ZIP Project

Ekstrak berkas `ProTrack.v2.zip` yang telah Anda terima ke direktori lokal Anda (misalnya `C:/laragon/www/` atau `C:/xampp/htdocs/`).

Terminal / Command Prompt

# Masuk ke direktori folder kerja proyek yang telah diekstrak
cd ProTrack.v2

Konfigurasi Environment (.env)

Salin berkas template `.env.example` menjadi `.env`, lalu buat database kosong dengan nama `protrack_db` di server MySQL Anda. Buka file `.env` baru tersebut lalu ubah informasi kredensial database.

Terminal / Command Prompt

# Linux / macOS / Bash
cp .env.example .env

# Windows Command Prompt
copy .env.example .env

# Windows PowerShell
Copy-Item .env.example .env

Konfigurasi .env (Database Setup)

# Sesuaikan dengan pengaturan database Anda
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=protrack_db
DB_USERNAME=root
DB_PASSWORD=

Instalasi Dependensi PHP (Composer)

Jalankan instalasi paket PHP yang dideklarasikan di `composer.json` untuk memasang framework Laravel beserta dependensi library pendukung.

Terminal / Command Prompt

# Unduh seluruh modul dependensi Laravel
composer install

Generate Application Key

Generate kunci enkripsi unik (`APP_KEY`) untuk mengamankan data enkripsi sesi pengguna dan cookie sistem Laravel.

Terminal / Command Prompt

# Membuat key baru di file .env
php artisan key:generate

Migrasi & Seeding Database

Bangun seluruh tabel database dan masukkan data uji coba awal (Admin default) ke dalam database menggunakan perintah berikut.

Terminal / Command Prompt

# Membuat skema tabel dan memasukkan data default
php artisan migrate:fresh --seed

Instalasi NPM & Kompilasi Aset

Pasang dependensi Node.js untuk bundler aset Vite lalu kompilasi atau jalankan server aset secara lokal agar tampilan front-end dapat dimuat sempurna.

Terminal / Command Prompt

# 1. Pasang dependensi JavaScript
npm install

# 2a. Jalankan server dev lokal (opsi pengembangan)
npm run dev

# ATAU 2b. Kompilasi build final untuk rilis (opsi produksi)
npm run build

Menjalankan Server Web

Jalankan web server bawaan Laravel untuk mengakses sistem ProTrack langsung dari browser Anda.

Terminal / Command Prompt

# Jalankan local development server
php artisan serve

Aplikasi dapat diakses melalui peramban web pada alamat default: http://127.0.0.1:8000