==============================================================================
        PANDUAN LENGKAP UPLOAD & DEPLOY WEBSITE DN SPORT KE HOSTING
==============================================================================

File ZIP ini sudah disiapkan khusus agar SIAP PAKAI untuk diunggah ke:
- cPanel Hosting (Menu 'Setup Python App')
- VPS (Ubuntu/Debian via Gunicorn + Nginx)
- Cloud Platform (Railway / Render / dsb.)

------------------------------------------------------------------------------
ISI DALAM PAKET HOSTING INI:
------------------------------------------------------------------------------
1. web_app.py            : Program utama website toko online & portal kasir web
2. passenger_wsgi.py     : Startup file standar cPanel / Passenger WSGI
3. wsgi.py               : Startup file alternatif (untuk Gunicorn / VPS)
4. db_config.py          : File pengaturan username, password, & nama database
5. db_config.example.py  : Contoh template cadangan konfigurasi database
6. requirements.txt      : Daftar modul library Python (Flask, MySQL, Pillow, dll)
7. dnsport2_database.sql : File database MySQL lengkap (produk, promo, kategori, transaksi)
8. templates/            : Semua halaman tampilan HTML (Home, Katalog, Detail, Login, POS)
9. static/               : Folder aset gambar logo, CSS style, JS, dan foto produk


==============================================================================
PANDUAN DEPLOY DI CPANEL (CARA PALING UMUM):
==============================================================================

LANGKAH 1: UPLOAD & EKSTRAK FILE KE CPANEL
1. Buka cPanel hosting Anda, lalu pilih menu 'File Manager'.
2. Buka folder tujuan website:
   - Jika untuk domain utama : buka folder 'public_html'
   - Jika untuk subdomain    : buka folder subdomain Anda (misal 'katalog' / 'pos')
3. Klik tombol 'Upload' di bagian atas.
4. Upload file 'DNSport_Website_Hosting.zip'.
5. Setelah upload selesai 100%, klik kanan file ZIP tersebut -> pilih 'Extract' (Ekstrak di sini).


LANGKAH 2: BUAT DATABASE & IMPORT DATA DI CPANEL
1. Di cPanel, buka menu 'MySQL Databases'.
2. Buat database baru (misalnya: u1234567_dnsport).
3. Di bagian 'Add New User', buat user database baru (misalnya: u1234567_admin) dan buat password yang aman. CATAT password ini!
4. Di bagian 'Add User To Database', hubungkan user tersebut ke database yang tadi dibuat.
   Centang pilihan 'ALL PRIVILEGES' lalu klik 'Make Changes'.
5. Kembali ke menu utama cPanel -> buka 'phpMyAdmin'.
6. Klik nama database yang baru Anda buat di panel sebelah kiri.
7. Klik tab 'Import' di menu atas.
8. Klik 'Choose File' / 'Pilih File', lalu pilih file 'dnsport2_database.sql'.
9. Gulir ke bawah dan klik tombol 'Import' / 'Kirim'.
   Tunggu hingga muncul pesan hijau sukses (semua tabel dan data produk otomatis terisi).


LANGKAH 3: SAMBUNGKAN DATABASE DI FILE db_config.py
1. Kembali ke 'File Manager' cPanel pada folder website Anda.
2. Cari file 'db_config.py', klik kanan -> pilih 'Edit'.
3. Sesuaikan informasinya:
   DB_HOST = "localhost"
   DB_USER = "username_mysql_anda"     (contoh: u1234567_admin)
   DB_PASS = "password_mysql_anda"     (password yang dibuat di Langkah 2)
   DB_NAME = "nama_database_anda"      (contoh: u1234567_dnsport)
   DB_PORT = 3306
4. Klik 'Save Changes' (Simpan).


LANGKAH 4: JALANKAN APLIKASI PYTHON DI CPANEL
1. Di cPanel, cari dan buka menu 'Setup Python App'.
2. Klik tombol 'Create Application':
   - Python Version          : Pilih versi 3.10, 3.11, atau 3.12
   - Application root        : Masukkan nama folder Anda (misal: public_html)
   - Application URL         : Pilih domain atau subdomain Anda
   - Application startup file: Ketik: passenger_wsgi.py
   - Application Entry point : Ketik: application
3. Klik tombol 'Create' di pojok kanan atas.
4. Setelah aplikasi terbuat, gulir ke bawah ke bagian 'Configuration files':
   - Masukkan: requirements.txt
   - Klik tombol 'Add'
   - Klik tombol 'Run Pip Install'
   (Tunggu proses instalasi modul Flask, Pillow, dll selesai beberapa detik).
5. Klik tombol 'Restart' di bagian atas aplikasi Python Anda.


LANGKAH 5: SELESAI & UJI COBA
1. Buka domain/subdomain toko Anda di browser (misal: https://domainanda.com).
2. Website Katalog Toko Online DN Sport langsung tampil aktif!
3. Login Admin Website & POS:
   - Akses: https://domainanda.com/login
   - Username : admin
   - Password : admin  (atau 171225)


==============================================================================
PANDUAN DEPLOY DI VPS (UBUNTU / DEBIAN DENGAN GUNICORN):
==============================================================================
1. Ekstrak folder ke direktori server: /var/www/dnsport
2. Buat virtual environment & install requirements:
   cd /var/www/dnsport
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
3. Import database MySQL:
   mysql -u root -p nama_db < dnsport2_database.sql
4. Jalankan via Gunicorn:
   gunicorn -w 4 -b 127.0.0.1:8000 wsgi:app
5. Konfigurasikan reverse proxy Nginx mengarah ke http://127.0.0.1:8000.


==============================================================================
CATATAN PENTING & TROUBLESHOOTING:
==============================================================================
- Pastikan folder 'static/uploads' memiliki permission write (755 atau 775) agar admin bisa upload foto produk baru.
- Jika mengalami Error 500 saat pertama kali membuka website:
  Periksa kembali nama database, user, dan password di 'db_config.py' apakah sudah sama persis dengan yang dibuat di cPanel MySQL.
- Pesanan online yang masuk dari website akan langsung tersimpan di database MySQL hosting dan bisa dipantau dari menu Kasir POS / menu 'Pesanan Online'.
==============================================================================