🎓 Sistem PMB Kampus (Laravel 12)

Sistem Penerimaan Mahasiswa Baru (PMB) berbasis web yang dibangun menggunakan Laravel 12. Aplikasi ini dirancang untuk mengelola seluruh proses PMB secara terstruktur, transparan, dan efisien mulai dari pendaftaran hingga proses penilaian.

---

🚀 Highlight Sistem

✨ End-to-end proses PMB (pendaftaran → verifikasi → pembayaran → penilaian) ✨ Multi-role system dengan kontrol akses terpisah ✨ Siap dikembangkan untuk integrasi pembayaran digital ✨ Struktur clean dan scalable (cocok untuk pengembangan lanjutan)

---

✨ Fitur Utama

• Pendaftaran calon mahasiswa
• Verifikasi data pendaftar
• Manajemen pembayaran
• Proses penilaian
• Dashboard berdasarkan role
• Notifikasi email

---

👥 Role Pengguna

Role	Deskripsi
Admin	Mengelola seluruh sistem
Humas	Mengelola informasi dan komunikasi
Verifikator	Memverifikasi data pendaftar
Bendahara	Mengelola pembayaran
Pendaftar	Calon mahasiswa (default)

---

🔐 Akun Default

Role	Email	Password
Admin	admin@kampusabc.ac.id	password123
Humas	humas@kampusabc.ac.id	password123
Verifikator	verval@kampusabc.ac.id	password123
Bendahara	bendahara@kampusabc.ac.id	password123
Pendaftar 1	pendaftar1@example.com	password123
Pendaftar 2	pendaftar2@example.com	password123

---

⚙️ System Requirements

Pastikan sistem Anda memenuhi kebutuhan berikut:

• PHP >= 8.2
• Composer
• Node.js >= 18
• NPM / Yarn
• MySQL >= 5.7 / MariaDB
• Web Server (Apache / Nginx)

---

🚀 Instalasi

Ikuti langkah berikut untuk menjalankan project:

1. Clone Repository

git clone https://github.com/username/pmb-kampus.git
cd pmb-kampus

2. Install Dependency PHP

composer install

3. Install Dependency Frontend

npm install

4. Build Asset

npm run build

5. Copy File Environment

cp .env.example .env

6. Generate App Key

php artisan key:generate

7. Konfigurasi Database (.env)

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=pmb_kampus
DB_USERNAME=root
DB_PASSWORD=

8. Migrasi dan Seeder

php artisan migrate --seed

9. Menjalankan Server

php artisan serve

Akses aplikasi di:

👉 http://127.0.0.1:8000

---

📧 Konfigurasi Email (Gmail SMTP)

Untuk mengaktifkan fitur pengiriman email, gunakan konfigurasi berikut pada file .env:

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your_email@gmail.com
MAIL_PASSWORD=your_app_password     #gunakan 16 karakter dari sandi aplikasi (bukan password akun gmail)
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_email@gmail.com
MAIL_FROM_NAME="PMB Kampus"

⚠️ Gunakan App Password Gmail, bukan password utama.

---

🧭 Alur Sistem

1. Pendaftar membuat akun dan mengisi data
2. Verifikator melakukan pengecekan data
3. Pendaftar melakukan pembayaran
4. Bendahara memverifikasi pembayaran
5. Proses penilaian dilakukan
6. Admin mengelola keseluruhan sistem

---

🔮 Pengembangan Lanjutan (On Progress)

Sistem ini masih terus dikembangkan untuk meningkatkan kualitas dan skalabilitas. Beberapa fitur yang sedang dan akan dikembangkan:

💳 Integrasi Pembayaran Digital

• QRIS (scan & pay)
• Transfer Bank (VA / manual verification enhancement)
• E-Wallet (OVO, GoPay, DANA, dll)
• Auto-verification payment (callback / webhook)

📜 Audit Log System

• Pencatatan seluruh aktivitas user
• Tracking perubahan data (before-after)
• Monitoring aksi penting (verifikasi, pembayaran, penilaian)
• Support untuk kebutuhan audit & keamanan sistem

---

🛠️ Teknologi yang Digunakan

• Laravel 12
• Blade / Livewire
• MySQL
• Tailwind CSS
• Vite

---

🧱 Arsitektur Singkat

Sistem dibangun dengan pendekatan modular berbasis role, sehingga setiap user hanya dapat mengakses fitur sesuai kewenangannya. Struktur ini memudahkan scaling dan maintenance.

---

🤝 Kontribusi

Kontribusi terbuka untuk pengembangan sistem ini. Silakan fork dan pull request.

---

📄 Lisensi

Project ini menggunakan lisensi Apache License 2.0.

---

✨ Sistem silahkan dipergunakan sebagaimana mestinya dengan penyesuaian kebijakan penerimaan mahasiswa baru pada perguruan tinggi yang bersangkutan.