☕ Warkop Bejo - Website Pemesanan Kopi Sederhana

Selamat datang di markas besar proyek Website Warkop Bejo! Ini adalah sebuah proyek untuk membangun aplikasi pemesanan kopi online yang fungsional dan modern dari awal menggunakan PHP, MySQL, dan JavaScript.

---

✨ Fitur Utama

• Otentikasi Pengguna: Sistem pendaftaran dan login yang aman.
• Katalog Produk: Tampilan menu produk yang dinamis langsung dari database.
• Keranjang Belanja: Fungsi untuk menambah, mengubah, dan menghapus pesanan.
• Dashboard Pengguna: Halaman profil untuk melihat data diri dan riwayat pembelian.

---

🛠️ Teknologi yang Digunakan

• Frontend: HTML, CSS, JavaScript
• Backend: PHP
• Database: MySQL
• Server Lokal: XAMPP

---

🚀 Panduan Instalasi & Menjalankan Proyek

Untuk menjalankan proyek ini di komputermu, ikuti 5 langkah mudah berikut.

Langkah 1: Clone Repository ke Folder htdocs

Buka terminal, masuk ke folder htdocs di dalam direktori instalasi XAMPP kamu, lalu jalankan perintah ini:

# Contoh path di Windows: cd C:/xampp/htdocs
# Contoh path di Mac: cd /Applications/XAMPP/htdocs

git clone [https://github.com/NasiGakPakeNasi/Pemrograman_Web.git](https://github.com/NasiGakPakeNasi/Pemrograman_Web.git)

Penting: Proyek ini harus berada di dalam folder htdocs agar bisa dijalankan oleh server Apache.

Langkah 2: Setup Database

1. Nyalakan Apache dan MySQL dari XAMPP Control Panel.
2. Buka browser dan akses http://localhost/phpmyadmin.
3. Buat database baru dengan nama warkop_bejo_db.
4. Pilih database tersebut, lalu klik tab "Import".
5. Klik "Choose File" dan pilih file warkop_bejo.sql yang ada di folder utama proyek ini.
6. Klik "Go" atau "Import". Semua tabel akan otomatis dibuat.

Langkah 2.1: Setup Database dengan Benar

1. Nyalakan Apache dan MySQL dari XAMPP Control Panel.
2. Buka browser dan akses http://localhost/phpmyadmin.
3. Buat database baru dengan nama warkop_bejo_db.
4. Pilih database warkop_bejo_db yang baru dibuat, lalu klik tab "Import".
5. Klik "Choose File" dan pilih file warkop_bejo.sql yang ada di folder utama proyek ini.
6. Klik "Go" atau "Import". Semua tabel akan otomatis dibuat.

Langkah 3: Konfigurasi Koneksi (Jika Perlu)

Secara default, koneksi sudah diatur untuk XAMPP standar. Jika berbeda, sesuaikan file app/config/database.php.

Langkah 4: Jalankan Proyek

Buka browser dan akses URL: http://localhost/Pemrograman_Web/public/

Langkah 5: Selalu Update Proyekmu

Jika ada fitur baru yang digabung ke main, dapatkan versi terbarunya dengan:

git checkout main
git pull origin main

---

🤝 Panduan Kontribusi

Kami sangat terbuka untuk kontribusi, baik dari anggota tim maupun dari komunitas luar. Berikut adalah alur kerja yang perlu diikuti.

Alur Kerja untuk Anggota Tim (Kolaborator)

Sebagai anggota tim, kamu memiliki akses langsung untuk membuat branch. Ikuti alur ini:

1. Sinkronisasi: Pastikan kamu memulai dari versi main yang terbaru (git pull origin main).
2. Buat Branch Baru: Buat branch baru untuk setiap fitur yang kamu kerjakan.

   # Contoh: git checkout -b fitur-pembayaran-rafli
   git checkout -b nama-fitur-kamu

3. Bekerja & Commit: Lakukan perubahan, dan simpan pekerjaanmu secara berkala.

   git add .
   git commit -m "feat: Selesai membuat halaman pembayaran"

4. Push Branch: Kirim branch spesifik milikmu ke repositori utama.

   git push origin nama-fitur-kamu

5. Buat Pull Request: Buka GitHub dan buat Pull Request dari branch-mu ke main. Minta 1-2 teman untuk me-review kodemu.
6. Merge: Setelah disetujui, gabungkan (merge) Pull Request tersebut.

Alur Kerja untuk Kontributor Eksternal

Jika kamu bukan anggota tim, kamu tidak bisa melakukan push langsung. Ikuti langkah-langkah standar open-source berikut:

1. Fork Repositori: Klik tombol "Fork" di pojok kanan atas halaman ini untuk membuat salinan repositori ini ke akun GitHub-mu.
2. Clone Fork Milikmu: Lakukan git clone pada repositori hasil fork yang ada di akunmu (bukan dari repositori asli).
3. Buat Branch Baru: Sama seperti alur kerja tim, buatlah branch baru untuk perubahanmu.
4. Bekerja & Commit: Lakukan perubahan yang kamu inginkan.
5. Push ke Fork Milikmu: Lakukan push ke repositori hasil fork milikmu.

   git push origin nama-branch-kamu

6. Buat Pull Request: Buka repositori hasil fork di akunmu, dan klik tombol "Contribute" lalu "Open pull request". Ini akan mengajukan perubahan dari fork milikmu ke proyek asli kami.
7. Diskusi & Review: Tim kami akan me-review kodemu. Jika disetujui, kami yang akan melakukan merge. Terima kasih atas kontribusimu!

---

🧑‍💻 Tim Pengembang

• Menu Utama: W***n
• Produk/Menu: B***s
• Keranjang: R***y
• Pembayaran: R***i
• Struk: D***a
• Profil/Dashboard & Auth: V**o

✨ Tips Pesan Commit

Gunakan format tipe: deskripsi agar riwayat kita rapi. Ini contekannya:

• feat: Menambah fitur baru.
• fix: Memperbaiki bug/error.
• docs: Mengubah dokumentasi (misal: README.md).
• style: Merapikan kode (spasi, titik koma, dll).
• refactor: Menyusun ulang kode tanpa mengubah fungsi.
• chore: Tugas lain (misal: menghapus file, update .gitignore).

Rancangan Database (ERD)

Berikut adalah visualisasi hubungan antar tabel di database kita:

erDiagram
    users {
        int id PK
        varchar username
        varchar password
        datetime created_at
        tinyint is_admin
    }

    orders {
        int order_id PK
        int user_id FK
        datetime order_date
        decimal total_amount
        varchar status
    }

    order_items {
        int item_id PK
        int order_id FK
        int menu_id FK
        int quantity
        decimal price_per_item
    }

    menu {
        int menu_id PK
        varchar menu_name
        decimal price
        text description
        varchar image_path
    }

    users ||--o{ orders : "places"
    orders ||--|{ order_items : "contains"
    menu ||--o{ order_items : "is"

Loading