BEM FIKTI Gunadarma

Sistem Informasi untuk BEM FIKTI Universitas Gunadarma, dibangun menggunakan framework Laravel.

Persyaratan Sistem

Sebelum menjalankan proyek ini, pastikan Anda telah menginstal:

• Docker
• Docker Compose

Panduan Instalasi dan Menjalankan Proyek

Proyek ini telah dikonfigurasi menggunakan Docker Compose agar mudah dijalankan tanpa perlu menginstal PHP atau MySQL secara manual di komputer Anda.

1. Clone repositori

   git clone https://github.com/Imamabdulfatah/bemfiktigunadarma.git
   cd bemfiktigunadarma

2. Jalankan Docker Compose Gunakan perintah berikut untuk menjalankan container aplikasi dan database:

   docker-compose up -d

   Catatan: Saat pertama kali dijalankan, proses ini akan memakan waktu beberapa saat karena Docker akan mengunduh image PHP dan MySQL, menginstal dependensi PHP via Composer, generate APP_KEY, dan mengimpor struktur database.

3. Akses Aplikasi Setelah proses selesai dan container berjalan stabil, aplikasi dapat diakses melalui browser pada alamat: http://localhost:8000

Konfigurasi Environment & Keamanan Token

File konfigurasi .env telah disiapkan untuk menyesuaikan kredensial koneksi database Docker. Key, token, dan kredensial sensitif diamankan di dalam file .env. File .env ini secara otomatis diabaikan oleh Git (melalui konfigurasi .gitignore), sehingga kunci rahasia tidak akan bocor ke public repository.

Jika Anda perlu mengubah kredensial atau menambahkan token API baru, Anda dapat menambahkan dan mengeditnya langsung di file .env.

Teknologi Website

• Framework: Laravel 9 (PHP 8.1)
• Containerization: Docker & Docker Compose
• Database: MySQL 8.0
• Web Server: PHP built‑in development server (exposed on port 8000)
• Package Manager: Composer
• Version Control: Git
• CI/CD (optional): dapat di‑integrasikan dengan GitHub Actions atau GitLab CI untuk otomatisasi build & deploy.

Fitur yang Tersedia

• Manajemen Anggota BEM: CRUD anggota dengan autentikasi Laravel Sanctum.
• Pengumuman & Berita: Modul posting berita yang dapat di‑schedule.
• Agenda Kegiatan: Kalender interaktif dengan filter kategori.
• Sistem Vote: Voting online untuk keputusan internal BEM.
• Laporan Keuangan: Dashboard ringkas menampilkan statistik pemasukan & pengeluaran.
• Notifikasi Email: Menggunakan Mailhog di development untuk preview email.
• API Publik: Endpoint RESTful yang dapat di‑konsumsi aplikasi mobile atau front‑end lain.

Database

Proyek ini terintegrasi dengan file laravel_final.sql yang berisi skema dan data default database. File ini akan otomatis diimpor saat container MySQL pertama kali dijalankan. Kredensial database di dalam container adalah:

• Host: db
• Port: 3306
• Database: laravel
• Username: laraveluser
• Password: laravelpassword

Perintah Bermanfaat

• Menghentikan aplikasi:

  docker-compose down

• Melihat log aplikasi:

  docker-compose logs -f app

• Masuk ke dalam container aplikasi (untuk menjalankan perintah artisan dll):

  docker-compose exec app bash