EVENTPASS MVP - SISTEM REGISTRASI EVENT QR + SMTP EMAIL
========================================================

Fitur utama:
- Landing page event responsive
- Form registrasi peserta
- Invoice/tagihan otomatis
- Pembayaran transfer manual
- Opsi tombol payment gateway/payment link dari admin
- Upload bukti pembayaran
- Admin approve/reject pembayaran
- QR ticket aktif setelah status paid
- Scan QR untuk check-in peserta di lokasi event
- Export CSV data peserta
- Setting SMTP untuk kirim email otomatis ke peserta

Email otomatis yang tersedia:
1. Setelah peserta daftar: invoice dan link pembayaran dikirim ke email peserta.
2. Setelah peserta upload bukti: notifikasi menunggu verifikasi dikirim ke email peserta.
3. Setelah admin set paid: QR ticket aktif dikirim ke email peserta.
4. Jika admin reject: notifikasi upload ulang bukti dikirim ke email peserta.

--------------------------------------------------------
PANDUAN INSTALL DI CPANEL
--------------------------------------------------------

1. Upload file ZIP ke cPanel
   - Masuk File Manager cPanel.
   - Upload ZIP ke public_html.
   - Extract ZIP.
   - Pastikan struktur folder menjadi:
     public_html/eventpass/

2. Buat database MySQL
   - Masuk cPanel > MySQL Database Wizard.
   - Buat database baru, contoh: user_eventpass
   - Buat user database, contoh: user_eventpass_user
   - Buat password database.
   - Assign user ke database dengan All Privileges.

3. Jalankan installer
   Buka browser:
   https://domainanda.com/eventpass/install.php

   Isi:
   - DB Host: localhost
   - DB Name: nama database dari cPanel
   - DB User: username database dari cPanel
   - DB Password: password database
   - Base URL: https://domainanda.com/eventpass
   - Akun admin
   - Data event pertama
   - Rekening pembayaran

4. Setelah install berhasil
   - Login admin:
     https://domainanda.com/eventpass/admin/login.php
   - Hapus file install.php dari File Manager demi keamanan.

--------------------------------------------------------
SETTING EMAIL SMTP AGAR ORDER MASUK KE EMAIL PESERTA
--------------------------------------------------------

1. Buat email domain dari cPanel
   Masuk cPanel > Email Accounts > Create.

   Contoh email:
   event@domainanda.com
   noreply@domainanda.com

2. Masuk admin EventPass
   Menu:
   Admin > Setting Email SMTP

3. Isi SMTP dengan data email cPanel
   Contoh umum:
   SMTP Host       : mail.domainanda.com
   SMTP Port       : 465
   Encryption      : SSL
   SMTP Username   : event@domainanda.com
   SMTP Password   : password email cPanel
   From Name       : Nama Event / Nama Brand
   From Email      : event@domainanda.com
   Reply-To Email  : admin@domainanda.com atau event@domainanda.com

   Alternatif jika hosting memakai TLS:
   SMTP Port       : 587
   Encryption      : TLS / STARTTLS

4. Centang:
   Aktifkan kirim email otomatis

5. Klik Simpan Setting SMTP.

6. Test kirim email
   Di halaman yang sama, isi Email Tujuan Test, lalu klik Kirim Test Email.

   Jika email masuk, sistem sudah siap mengirim:
   - Invoice setelah peserta daftar
   - Notifikasi bukti pembayaran diterima
   - QR ticket setelah admin approve paid
   - Notifikasi pembayaran ditolak

--------------------------------------------------------
ALUR PESERTA
--------------------------------------------------------

1. Peserta membuka halaman event:
   https://domainanda.com/eventpass/

2. Peserta klik daftar dan isi data diri.

3. Setelah submit, peserta diarahkan ke halaman invoice/pembayaran.
   Jika email diisi dan SMTP aktif, invoice juga dikirim ke email peserta.

4. Peserta transfer dan upload bukti pembayaran.

5. Status menjadi Menunggu Verifikasi.
   Email notifikasi juga dikirim ke peserta.

6. Admin buka menu Data Peserta.

7. Admin klik Set Paid.

8. Sistem mengaktifkan QR ticket dan mengirim QR ke email peserta.

9. Saat event, panitia buka:
   Admin > Scan Check-in

10. Scan QR peserta. Status berubah menjadi Sudah Check-in.

--------------------------------------------------------
MENU ADMIN
--------------------------------------------------------

- Dashboard
  Melihat ringkasan peserta, paid, pending, check-in, dan revenue.

- Data Peserta
  Melihat peserta, status pembayaran, bukti transfer, approve/reject, dan QR ticket.

- Scan Check-in
  Scan QR peserta saat event.

- Setting Event & Pembayaran
  Mengubah nama event, harga, lokasi, rekening, dan payment gateway/payment link.

- Setting Email SMTP
  Mengatur email otomatis ke peserta.

- Export CSV
  Download data peserta.

--------------------------------------------------------
CATATAN PAYMENT GATEWAY
--------------------------------------------------------

MVP ini menyediakan setting tombol/link payment gateway.
Contoh bisa diisi link pembayaran dari Midtrans, Xendit, Duitku, QRIS, atau payment link lain.

Callback otomatis payment gateway belum termasuk dalam MVP ini karena setiap provider membutuhkan API key dan konfigurasi berbeda. Struktur sistem sudah siap dikembangkan untuk callback otomatis di tahap berikutnya.

--------------------------------------------------------
TROUBLESHOOTING EMAIL
--------------------------------------------------------

Jika email tidak masuk:
1. Cek folder Spam/Promotions.
2. Pastikan SMTP aktif di admin.
3. Pastikan From Email sama dengan SMTP Username.
4. Coba port 465 SSL.
5. Jika gagal, coba port 587 TLS.
6. Pastikan password email cPanel benar.
7. Pastikan hosting tidak memblokir koneksi SMTP keluar.
8. Pastikan domain memiliki SPF/DKIM aktif di cPanel > Email Deliverability.

Jika muncul error STARTTLS:
- Ganti Encryption ke SSL dan Port ke 465.

Jika login SMTP gagal:
- Reset password email di cPanel.
- Masukkan ulang password di Setting Email SMTP.

--------------------------------------------------------
KEAMANAN
--------------------------------------------------------

- Hapus install.php setelah instalasi berhasil.
- Jangan bagikan password admin dan SMTP.
- Folder uploads/proofs sudah diberi .htaccess agar file bukti tidak dieksekusi sebagai script.
- Gunakan SSL/HTTPS di domain.

--------------------------------------------------------
REKOMENDASI LANJUTAN
--------------------------------------------------------

Pengembangan berikutnya yang bisa ditambahkan:
- E-ticket PDF otomatis
- Multi event
- Kupon/diskon
- Nomor kursi
- Sertifikat digital
- Callback otomatis Midtrans/Xendit
- Reminder email H-1 sebelum event
- Member area peserta jika event sudah sering berjalan


UPDATE MODE DISPLAY CHECK-IN
----------------------------
Versi ini sudah menambahkan tampilan gate/kiosk pada menu Admin > Scan Check-in. Setelah QR berhasil discan, layar kanan akan menampilkan status besar seperti:
- CHECK-IN BERHASIL dengan ikon centang hijau
- Nama peserta
- Invoice, event, dan waktu check-in
- Peringatan jika tiket belum paid, tidak ditemukan, atau sudah pernah digunakan

Tidak membutuhkan update database tambahan. Cukup timpa file scan.php, api-checkin.php, dan assets/style.css jika upgrade dari versi SMTP sebelumnya.

UPDATE 15 JULI 2026 - DISPLAY SPLIT MONITOR
Lihat README_UPDATE_SPLIT_MONITOR_2026.txt untuk fitur Display Per Gate dan Split Monitor 2/3/4 gate.
