================================================================================
                    BUKU MANUAL PENGOPERASIAN WEBSITE
                         HUEMAN THEME MANAGEMENT
================================================================================

DAFTAR ISI
----------
1. Pendahuluan
2. Login Admin
3. Maintenance Mode
4. Pengaturan Situs
5. Manajemen User
6. Sistem Backup
7. Upload File
8. Troubleshooting
9. Keamanan
10. Kontak Dukungan

================================================================================
1. PENDAHULUAN
================================================================================

Website Hueman Theme adalah sistem manajemen konten berbasis HTML/JavaScript 
dengan fitur admin dashboard untuk pengelolaan konten, pengaturan situs, dan 
maintenance.

FITUR UTAMA:
- Admin Dashboard untuk pengelolaan
- Maintenance Mode untuk perbaikan
- Pengaturan Logo dan Profile Photo
- Manajemen User
- Sistem Backup Otomatis dan Manual
- Upload File (Gambar, Video, Dokumen)

REQUIREMENTS:
- Browser modern (Chrome, Firefox, Safari, Edge)
- XAMPP atau server web lainnya
- Akses ke file system untuk backup

================================================================================
2. LOGIN ADMIN
================================================================================

URL LOGIN:
- File: admin-login.html
- Default Username: admin
- Default Password: admin123

LANGKAH LOGIN:
1. Buka admin-login.html di browser
2. Masukkan username: admin
3. Masukkan password: admin123 (atau password yang sudah diubah)
4. Klik tombol "Login"
5. Anda akan diarahkan ke admin-dashboard.html

UBAH PASSWORD:
1. Login ke admin dashboard
2. Buka tab "User Management"
3. Klik tombol "Ubah Password"
4. Masukkan password saat ini
5. Masukkan password baru
6. Konfirmasi password baru
7. Klik "Simpan"

LOGOUT:
1. Klik tombol profile di pojok kanan atas
2. Konfirmasi logout
3. Anda akan diarahkan ke halaman login

================================================================================
3. MAINTENANCE MODE
================================================================================

AKTIFKAN MAINTENANCE MODE:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Scroll ke bagian "Mode Maintenance"
4. Pilih "Aktif" dari dropdown
5. Klik "Simpan Pengaturan"

EFEK MAINTENANCE MODE:
- Semua halaman publik akan redirect ke maintenance.html
- Hanya admin yang dapat mengakses website
- User akan melihat halaman maintenance dengan form login admin

BYPASS MAINTENANCE MODE:
1. Buka maintenance.html
2. Masukkan password admin
3. Login untuk bypass maintenance
4. Anda akan diarahkan ke admin dashboard

NONAKTIFKAN MAINTENANCE MODE:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Scroll ke bagian "Mode Maintenance"
4. Pilih "Nonaktif" dari dropdown
5. Klik "Simpan Pengaturan"

================================================================================
4. PENGATURAN SITUS
================================================================================

UBAH LOGO:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Di bagian "Logo Header":
   - Upload file gambar: Klik "Choose File" dan pilih gambar
   - Atau masukkan URL gambar di field "Logo URL"
4. Klik "Simpan Pengaturan"
5. Logo akan muncul di preview dan di semua halaman

UBAH PROFILE PHOTO:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Di bagian "Foto Profil":
   - Upload file gambar: Klik "Choose File" dan pilih gambar
   - Atau masukkan URL gambar di field "Profile URL"
4. Klik "Simpan Pengaturan"
5. Profile photo akan muncul di preview dan di header

UBAH NAMA SITUS:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Di bagian "Informasi Situs":
   - Masukkan nama situs di field "Nama Situs"
4. Klik "Simpan Pengaturan"

UBAH DESKRIPSI SITUS:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Di bagian "Informasi Situs":
   - Masukkan deskripsi di field "Deskripsi Situs"
4. Klik "Simpan Pengaturan"

UBAH BACKGROUND HEADER:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Di bagian "Background Header":
   - Masukkan URL gambar background
   - Atau upload file gambar
4. Klik "Simpan Pengaturan"
5. Background akan muncul di preview area

HAPUS BACKGROUND HEADER:
1. Login ke admin dashboard
2. Buka tab "Pengaturan"
3. Di bagian "Background Header"
4. Klik tombol "Hapus Background"
5. Konfirmasi penghapusan

================================================================================
5. MANAJEMEN USER
================================================================================

TAMBAH USER BARU:
1. Login ke admin dashboard
2. Buka tab "User Management"
3. Klik tombol "+ Tambah User"
4. Isi form:
   - Username
   - Email
   - Role (Admin/Editor/Viewer)
   - Password
   - Konfirmasi Password
5. Klik "Simpan"

EDIT USER:
1. Login ke admin dashboard
2. Buka tab "User Management"
3. Di tabel user, klik tombol "Edit" pada user yang ingin diedit
4. Modifikasi informasi user
5. Klik "Simpan"

HAPUS USER:
1. Login ke admin dashboard
2. Buka tab "User Management"
3. Di tabel user, klik tombol "Hapus" pada user yang ingin dihapus
4. Konfirmasi penghapusan

CATATAN:
- User "admin" tidak dapat dihapus
- Password harus minimal 6 karakter
- Email harus valid

================================================================================
6. SISTEM BACKUP
================================================================================

TIPE BACKUP:
- Manual: Backup sesuai kebutuhan
- Harian: Otomatis backup setiap hari (disimpan 7 hari)
- Mingguan: Otomatis backup setiap minggu (disimpan 4 minggu)
- Bulanan: Otomatis backup setiap bulan (disimpan 12 bulan)

BACKUP MANUAL VIA UI:
1. Login ke admin dashboard
2. Buka tab "Backup"
3. Klik tombol "📦 Buat Backup Sekarang"
4. Tunggu proses backup selesai
5. Backup akan muncul di riwayat backup

BACKUP MANUAL VIA COMMAND LINE:
1. Buka terminal
2. Navigate ke direktori website:
   cd /Applications/XAMPP/xamppfiles/htdocs/hueman
3. Jalankan perintah:
   ./backup.sh manual
4. Backup akan dibuat di backups/manual/

ATUR JADWAL BACKUP OTOMATIS:
1. Login ke admin dashboard
2. Buka tab "Backup"
3. Di bagian "Jadwal Backup Otomatis":
   - Pilih waktu untuk backup harian (00:00, 06:00, 12:00, 18:00)
   - Pilih hari untuk backup mingguan (Senin, Rabu, Jumat)
   - Pilih tanggal untuk backup bulanan (1, 15)
4. Klik "💾 Simpan Jadwal"

SETUP CRON JOBS (UNTUK OTOMATISASI SERVER):
1. Buka terminal
2. Navigate ke direktori website:
   cd /Applications/XAMPP/xamppfiles/htdocs/hueman
3. Jalankan setup script:
   ./setup-cron.sh
4. Cron jobs akan terinstall dengan jadwal default:
   - Harian: 12:00 PM
   - Mingguan: Rabu 12:00 PM
   - Bulanan: Tanggal 1, 12:00 PM

RESTORE BACKUP:
1. Login ke admin dashboard
2. Buka tab "Backup"
3. Di riwayat backup, klik tombol "Restore"
4. Konfirmasi restore (peringatan: akan menimpa data saat ini)
5. Tunggu proses restore selesai

DOWNLOAD BACKUP:
1. Login ke admin dashboard
2. Buka tab "Backup"
3. Di riwayat backup, klik tombol "Download"
4. File backup akan terunduh

HAPUS BACKUP:
1. Login ke admin dashboard
2. Buka tab "Backup"
3. Di riwayat backup, klik tombol "Hapus"
4. Konfirmasi penghapusan

LIHAT STATISTIK BACKUP:
1. Login ke admin dashboard
2. Buka tab "Backup"
3. Statistik akan ditampilkan:
   - Jumlah backup harian
   - Jumlah backup mingguan
   - Jumlah backup bulanan
   - Total ukuran backup

================================================================================
7. UPLOAD FILE
================================================================================

STRUKTUR PENYIMPANAN:
- uploads/images/ - File gambar
- uploads/videos/ - File video
- uploads/documents/ - File dokumen
- uploads/metadata/ - Metadata file

UPLOAD VIA ADMIN DASHBOARD:
1. Login ke admin dashboard
2. Buka tab "Media"
3. Klik tombol "+ Upload"
4. Pilih file yang ingin diupload
5. File akan disimpan sesuai tipe:
   - Gambar → uploads/images/
   - Video → uploads/videos/
   - Dokumen → uploads/documents/

CATATAN:
- File disimpan sebagai base64 di localStorage (untuk demo)
- Dalam implementasi production, gunakan server-side upload
- Metadata file disimpan di uploads/metadata/

================================================================================
8. TROUBLESHOOTING
================================================================================

MASALAH: Tidak bisa login
SOLUSI:
- Pastikan username dan password benar
- Cek localStorage di browser (F12 → Application → Local Storage)
- Reset password via User Management jika lupa password

MASALAH: Logo tidak berubah
SOLUSI:
- Pastikan file gambar valid (JPG, PNG, GIF)
- Cek apakah URL gambar valid
- Refresh halaman setelah simpan pengaturan
- Cek console browser untuk error

MASALAH: Maintenance mode tidak aktif
SOLUSI:
- Pastikan mode maintenance diset ke "Aktif"
- Cek localStorage untuk key "maintenanceMode"
- Refresh halaman

MASALAH: Backup gagal dibuat
SOLUSI:
- Pastikan script backup.sh memiliki permission execute
- Cek apakah direktori backups memiliki permission write
- Pastikan ada cukup disk space
- Cek log di backups/cron.log

MASALAH: Teks tidak terbaca
SOLUSI:
- Pastikan CSS variables untuk teks sudah diset ke warna cerah
- Cek contrast antara teks dan background
- Refresh halaman

MASALAH: Auto-refresh mengganggu
SOLUSI:
- Hapus meta tag refresh dari HTML
- Atau ubah interval refresh (content="30")

MASALAH: localStorage penuh
SOLUSI:
- Hapus data yang tidak perlu dari localStorage
- Bersihkan cache browser
- Gunakan storage yang lebih besar (server-side)

================================================================================
9. KEAMANAN
================================================================================

PERINGATAN KEAMANAN:
- Password disimpan di localStorage (TIDAK SECURE untuk production)
- Tidak ada server-side authentication
- Tidak ada proteksi CSRF
- Tidak ada proteksi XSS
- Tidak ada input validation

REKOMENDASI KEAMANAN:
1. Implement server-side authentication dengan database
2. Gunakan HTTPS untuk semua komunikasi
3. Implement CSRF protection
4. Sanitize semua input user
5. Gunakan HTTP-only cookies untuk session
6. Implement rate limiting
7. Gunakan password hashing (bcrypt, argon2)
8. Regular security audit

PASSWORD SECURITY:
- Gunakan password minimal 12 karakter
- Gunakan kombinasi huruf, angka, dan simbol
- Jangan gunakan password default
- Ganti password secara berkala

DATA BACKUP:
- Backup secara teratur
- Simpan backup di lokasi terpisah
- Encrypt backup jika mengandung data sensitif
- Test restore backup secara berkala

================================================================================
10. KONTAK DUKUNGAN
================================================================================

INFORMASI SISTEM:
- Versi: 1.0
- Framework: HTML5, CSS3, JavaScript (Vanilla)
- Server: XAMPP (Apache)
- Browser Support: Chrome, Firefox, Safari, Edge

FILE PENTING:
- admin-login.html - Halaman login admin
- admin-dashboard.html - Dashboard admin
- maintenance.html - Halaman maintenance
- backup.sh - Script backup
- setup-cron.sh - Script setup cron jobs

LOKASI BACKUP:
- /Applications/XAMPP/xamppfiles/htdocs/hueman/backups/

LOKASI UPLOAD:
- /Applications/XAMPP/xamppfiles/htdocs/hueman/uploads/

CATATAN PENTING:
- Sistem ini adalah demo/prototype
- Tidak direkomendasikan untuk production tanpa perbaikan keamanan
- Pastikan backup sebelum melakukan perubahan besar
- Test semua fitur sebelum deployment

================================================================================
                        AKHIR DARI BUKU MANUAL
================================================================================

Dokumen ini dibuat pada: 17 Juni 2026
Versi: 1.0
Untuk informasi lebih lanjut, hubungi administrator sistem.
