# VMP e-Voting Online — PHP/MySQL + APK Android

Paket siap unggah untuk cPanel. Konfigurasi database dan domain tetap perlu diisi.
Tidak membutuhkan Python, Node.js, Composer, atau VPS pada hosting.
Versi online membutuhkan internet pada laptop operator dan tablet. Tidak ada
antrean suara offline. Database utama berada di MySQL hosting, bukan di laptop.

## Persyaratan

- PHP 8.2 atau lebih baru, ekstensi PDO dan pdo_mysql, sesi PHP dapat ditulis.
- MySQL 8.0+ atau MariaDB 10.6+ dengan tabel InnoDB.
- Domain/subdomain khusus dengan HTTPS valid. Aktifkan SSL/AutoSSL sebelum instalasi.
- Apache/LiteSpeed yang mendukung `.htaccess` untuk proteksi tambahan.
- Android 8+ untuk APK; Android System WebView diperbarui.

## Isi ZIP

| Folder/file | Fungsi |
|---|---|
| `public_html/` | Berkas website yang ditempatkan pada document root domain |
| `vmp-private/` | Konfigurasi dan schema database; simpan di luar document root |
| `APK/VMP-Bilik-Online.apk` | Aplikasi tablet khusus domain HTTPS, build debug untuk uji coba |
| `android-bilik/` | Kode sumber lengkap APK; tidak perlu diunggah ke hosting |
| `PANDUAN-HOSTING.md` | Petunjuk pemasangan ini |
| `HASIL-UJI.txt` | Ruang lingkup pengujian dan batasnya |

## 1. Buat database di cPanel

1. Buka Database Wizard / MySQL Database Wizard.
2. Buat database, misalnya `akun_vmp`, serta pengguna database, misalnya `akun_vmpuser`.
3. Buat password database yang kuat dan beri pengguna tersebut ALL PRIVILEGES
   **hanya untuk database VMP**. Catat nama lengkap termasuk awalan akun cPanel.
4. Gunakan database kosong khusus aplikasi ini. Jangan gabungkan dengan database
   WordPress, aplikasi lain, atau sistem yang sedang digunakan.

## 2. Unggah berkas

Contoh bila website ada pada domain utama:

- Isi folder `public_html` dalam ZIP → `/home/AKUNCPANEL/public_html/`.
- Folder `vmp-private` → `/home/AKUNCPANEL/vmp-private/`.

Gunakan File Manager cPanel atau FTP. Aktifkan tampilan hidden files agar
`.htaccess` ikut tersalin. Tidak perlu mengunggah APK, kode Android, atau ZIP
keseluruhan ke area yang bisa diunduh pengunjung.

**Jika menggunakan subdomain:** pilih document root tersendiri, misalnya
`/home/AKUNCPANEL/public_html/pilkades`, lalu unggah isi `public_html` ke sana.
Tetap simpan `vmp-private` di `/home/AKUNCPANEL/vmp-private` (di luar area publik).
Salin `config-path.example.php` menjadi `config-path.php` di document root,
lalu isi path absolut konfigurasi tersebut. Gunakan domain subdomain langsung,
contoh `https://pilkades.domainanda.id`, bukan URL folder `/pilkades` untuk APK.

File server boleh 0644 dan folder 0755 sesuai kebijakan hosting; konfigurasi
pribadi gunakan 0600/0640 bila didukung. Jangan gunakan izin 0777.

## 3. Isi konfigurasi

Salin `vmp-private/config.example.php` menjadi `vmp-private/config.php`.
Isi:

- `app_url`: domain HTTPS persis, contoh `https://pilkades.domainanda.id`, tanpa
  garis miring akhir, tanpa `/index.php` atau parameter.
- `db_host`: biasanya `localhost`, konfirmasi ke penyedia hosting.
- `db_port`: biasanya 3306.
- `db_name`, `db_user`, `db_password`: data database dari langkah pertama.
- `setup_key`: buat kode acak unik minimal 32 karakter dengan password generator.
  Jangan gunakan contoh bawaan. Kode ini diperlukan hanya saat instalasi.
- Pertahankan `require_https => true`.
- `trusted_proxies`: kosong untuk konfigurasi standar. Jangan mempercayai semua
  IP atau header X-Forwarded-Proto sembarangan. Bila memakai reverse proxy,
  minta penyedia hosting memberikan daftar IP proxy yang benar.

Aktifkan **Force HTTPS Redirect** pada menu Domains di cPanel setelah sertifikat
SSL aktif. Jika memakai Cloudflare, gunakan koneksi TLS sampai origin hosting
(Full strict), bukan Flexible. Aplikasi tidak melewati kesalahan sertifikat.

## 4. Jalankan installer sekali

1. Buka `https://pilkades.domainanda.id/install.php`.
2. Masukkan `setup_key`, buat username operator dan password 12–72 karakter.
   Tidak ada akun/password operator bawaan.
3. Centang **Sertakan 10 DPT fiktif** bila ingin uji coba. Jika tidak dicentang,
   daftar DPT mulai kosong. QR dibuat unik pada saat instalasi.
4. Klik Pasang aplikasi. Schema dan akun dibuat otomatis; tidak perlu impor SQL
   manual. File schema.sql disertakan untuk peninjauan/diagnostik.
5. Setelah berhasil, installer terkunci otomatis. **Hapus `install.php` dari
   document root**, lalu hapus/ubah `setup_key` pada konfigurasi.

## 5. Gunakan dashboard operator dari laptop

Buka `https://pilkades.domainanda.id/?mode=operator` dan login dengan akun baru.

- Status awal **Persiapan**: tambah DPT, cetak undangan, dan ubah tiga calon contoh.
- Nama/slogan ketiga calon dapat diubah pada panel Pengaturan hosting & bilik.
  Ilustrasi calon masih ilustrasi bawaan; unggahan foto dan jumlah calon dinamis
  belum tersedia pada versi ini.
- Buat kode penghubung untuk TPS 01 atau TPS 02. Kode berlaku 5 menit dan sekali pakai.
- Klik **Buka pemungutan** setelah pengujian/persiapan selesai.
- Rekap operator diperbarui sekitar setiap 5 detik saat tab terlihat.
- Klik **Tutup pemungutan** untuk menghentikan suara baru. Pemungutan bisa dibuka
  lagi tanpa mereset suara. Kembali ke persiapan hanya boleh sebelum ada suara.
- Tambah DPT dan perubahan calon hanya diizinkan pada tahap persiapan.

Login operator menggunakan cookie HttpOnly/SameSite, CSRF dan password hash.
Sesi berakhir setelah 30 menit tanpa aktivitas API. Percobaan login/pairing
berlebihan dibatasi per IP selama 15 menit. Tidak tersedia fitur lupa password
melalui email; simpan kredensial operator di tempat aman.

## 6. Pasang dan hubungkan tablet

1. Salin `APK/VMP-Bilik-Online.apk` ke tablet dan instal. Izinkan pemasangan dari
   sumber tersebut bila diminta. Versi ini terpisah dari APK LAN sebelumnya.
2. Buka **VMP Bilik Online**, isi domain HTTPS hosting, pilih TPS dan buat PIN
   lokal operator 6–12 digit. PIN ini berbeda dengan password dashboard laptop.
3. Tekan Simpan & hubungkan. Pada halaman bilik, masukkan kode 8 karakter yang
   baru dibuat dari dashboard operator laptop.
4. Tablet kini memiliki akses khusus TPS tersebut. Satu tablet aktif per TPS;
   menghubungkan tablet pengganti mencabut token tablet sebelumnya.
5. Izinkan kamera Android ketika menggunakan **Scan QR dengan kamera tablet**.
   Pemindai memproses gambar lokal. Internet dipakai untuk verifikasi ke hosting.

Tanpa APK, gunakan browser tablet pada
`https://pilkades.domainanda.id/?mode=bilik&tps=1` (atau `tps=2`), lalu masukkan
kode penghubung. Kamera browser memerlukan izin kamera dan HTTPS valid.

**APK localhost lama tidak cocok untuk domain publik. Gunakan APK Online ini.**
Tidak perlu menjalankan MULAI-OPERATOR.bat atau server Python pada laptop.

Tahan bar atas APK atau tekan Back lalu masukkan PIN untuk pengaturan. Menu
penyematan layar Android tetap tersedia, tetapi bukan penguncian device-owner/MDM.
Operator perlu mengatur keamanan tablet dan mengawasinya selama pemungutan.

## 7. Alur pemilihan dan pemulihan koneksi

Petugas memverifikasi identitas dan undangan. Scan QR pada operator atau tablet
terpasang membuka sesi TPS. Pemilih menyentuh calon, memeriksa pilihan, kemudian
menekan Konfirmasi. Sukses hanya muncul setelah hosting memastikan penyimpanan.
Bukti tidak mencantumkan calon pilihan; mencetak ulang tidak menambah suara.

Jika respons konfirmasi hilang, aplikasi menyimpan **token sesi saja**, bukan
calon pilihan, lalu memeriksa status server. Jika suara sudah tercatat, bukti
akan dipulihkan. Jika belum, sesi lama dibatalkan sebelum pemilih diminta scan
ulang agar request terlambat tidak menambah suara. Jika sesi sudah berubah,
operator wajib memeriksa DPT sebelum menghapus penanda pemulihan melalui menu APK.

Cabut akses tablet dari dashboard jika perangkat hilang/tidak lagi dipakai.
Pencabutan juga membatalkan sesi aktif TPS. Jangan mencabut akses ketika ada
konfirmasi yang belum terselesaikan sebelum memeriksa status pemilih.

## 8. Asisten dan cetak

Empat pertanyaan cepat, panduan netral, Garuda, logo VMP, animasi pilihan, undangan
QR dan bukti HVS tetap disertakan. Asisten memakai jawaban prosedur yang sudah
disiapkan, bukan layanan AI yang membaca pilihan pemilih.

APK memakai TTS Android; pilih/unduh suara perempuan Indonesia pada perangkat.
Suara Gendhis persis tidak disertakan. Ketersediaan dan kualitas suara bergantung
pada mesin TTS tablet. Suara lokal dapat dipakai offline setelah terpasang,
namun **pemilihan online tetap membutuhkan internet**.

Cetak APK memakai layanan printer Android atau Simpan PDF. Printer USB laptop
bukan otomatis printer tablet. Alternatif: operator klik **Bukti** pada DPT yang
sudah memilih dan cetak dari laptop ke kertas A4/HVS. Tidak ada pencetakan senyap
langsung dari hosting ke printer laptop.

## 9. Data lama dan pencadangan

Paket hosting adalah instalasi terpisah. SQLite dari versi localhost **tidak
otomatis dipindahkan** ke MySQL. Jangan menyalin sqlite ke public_html. Jika
memerlukan migrasi DPT/hasil lama, siapkan migrasi terverifikasi terpisah sebelum
membuka pemungutan. QR demo lama tidak otomatis berlaku pada instalasi baru.

Cadangkan MySQL melalui cPanel/phpMyAdmin serta berkas aplikasi dan konfigurasi
pribadi. Simpan backup di luar document root. Uji pemulihan sebelum acara.
Untuk mengulang simulasi, gunakan database baru khusus uji coba; jangan menghapus
atau mereset database yang berisi hasil pemungutan yang perlu dipertahankan.

## 10. Pemeriksaan sebelum digunakan

- Domain HTTPS dan cookie sesi bekerja; install.php sudah dihapus.
- Tanpa login, endpoint DPT/rekap ditolak; tanpa pairing, bilik ditolak.
- Uji TPS 01 dan TPS 02 dengan perangkat terpisah.
- Uji scan, pilihan, konfirmasi, rekap, serta cetak bukti.
- Uji putus internet setelah konfirmasi dan cek tidak ada suara ganda.
- Uji mikrofon tidak diminta (asisten cukup TTS), suara, dan kamera perangkat.
- Siapkan cadangan koneksi internet; periksa batas resource hosting.

Pengujian otomatis menggunakan PHP 8.4 dan MariaDB 11.8 pada lingkungan uji.
Tidak ada uji beban ribuan pemilih, audit independen, sertifikasi pemilu, atau
pengujian pada akun cPanel/tablet fisik Anda. Paket ini siap **dipasang dan diuji
online**, bukan jaminan kelayakan pemilihan resmi. Label simulasi tetap dipertahankan.
Rekap masih dapat dilihat operator selama pemungutan. Tiga calon dan dua TPS
masih mengikuti rancangan awal. Backup, kontrol akses hosting, dan prosedur
pemungutan harus disesuaikan sebelum penggunaan resmi.

Referensi pemasangan:
https://docs.cpanel.net/cpanel/databases/database-wizard/
https://support.cpanel.net/hc/en-us/articles/360048481414-How-to-automatically-redirect-a-domain-s-visitors-to-HTTPS
https://www.php.net/manual/en/ref.pdo-mysql.php
https://www.php.net/manual/en/function.password-hash.php
