```txt
==========================================================
PANDUAN AKTIVASI APLIKASI INPUT NILAI BUSTANUL ULUM
Created by Abibaniazam
==========================================================

1. PERSIAPAN AWAL
----------------------------------------------------------

Sebelum memulai instalasi aplikasi, pastikan Anda sudah:

✓ Memiliki hosting dan domain yang aktif.
✓ Mengetahui cara membuat Database melalui hosting/cPanel.
✓ Menyiapkan Spreadsheet yang akan digunakan.
✓ Menyiapkan kode Apps Script yang telah disediakan.

----------------------------------------------------------
2. MEMBUAT DATABASE
----------------------------------------------------------

Buat Database baru melalui hosting/cPanel.

Rekomendasi nama database:

- 1_nilai_rapot_ganjil_25_26
- 2_nilai_rapot_genap_25_26
- 3_nilai_rapot_ganjil_26_27
- dst.

Disarankan menggunakan database yang berbeda untuk setiap
semester dan tahun ajaran.

----------------------------------------------------------
3. MENGATUR KONEKSI DATABASE
----------------------------------------------------------

Buka file konfigurasi database, kemudian sesuaikan bagian
berikut:

// Konfigurasi Database
define('DB_HOST', 'localhost');
define('DB_NAME', 'nama_Database_Anda');
define('DB_USER', 'nama_Database_Anda');
define('DB_PASS', 'password_Database_Anda');

Keterangan:

- Ganti nama_Database_Anda dengan nama database yang telah dibuat.
- Ganti password_Database_Anda dengan password database Anda.

Simpan perubahan setelah selesai.

----------------------------------------------------------
4. MENGATUR GOOGLE SPREADSHEET DAN APPS SCRIPT
----------------------------------------------------------

A. Membuat Apps Script

1. Buka Spreadsheet.
2. Klik menu "Ekstensi".
3. Pilih "Apps Script".
4. Hapus kode bawaan (jika ada).
5. Paste seluruh kode Apps Script yang telah disediakan.
6. Klik Simpan (Save).

B. Deploy Apps Script

1. Klik tombol "Deploy".
2. Pilih "New Deployment".
3. Pilih tipe "Web App".
4. Atur hak akses sesuai petunjuk.
5. Klik "Deploy".
6. Tunggu hingga proses selesai.
7. Copy URL hasil deployment.

C. Memasukkan URL Deploy

Buka folder Config, kemudian tempelkan URL hasil deploy
pada bagian konfigurasi yang telah disediakan.

----------------------------------------------------------
5. PENTING! JANGAN SAMPAI TERTUKAR SPREADSHEET
----------------------------------------------------------

Aplikasi menggunakan 2 Spreadsheet yang berbeda.

A. Spreadsheet Nilai

Digunakan untuk:

- Nilai Harian
- Nilai Tengah Semester
- Nilai Akhir Semester
- Nilai Rapor

Gunakan kode Apps Script khusus nilai pada Spreadsheet ini.

B. Spreadsheet Gabungan

Digunakan untuk:

- Nilai Ekstrakurikuler
- Absensi
- Catatan Wali Kelas
- Prestasi
- Data Pendukung Lainnya

Gunakan kode Apps Script khusus spreadsheet gabungan
pada Spreadsheet ini.

PASTIKAN URL DEPLOY KEDUANYA TIDAK TERTUKAR.

----------------------------------------------------------
6. LOGIN ADMIN
----------------------------------------------------------

Alamat Login:

https://linkdomainanda.com/admin/login.php

Akun Default Admin:

Username : a
Password : a

Disarankan segera mengganti password setelah login pertama.

----------------------------------------------------------
7. LOGIN GURU
----------------------------------------------------------

Alamat Login:

https://linkdomainanda.com/guru/

Akun Guru:

Username : NUPTK

Password dapat diatur melalui akun Admin.

----------------------------------------------------------
8. LOGIN WALI KELAS
----------------------------------------------------------

Password awal wali kelas mengikuti nama kelas.

Contoh:

Kelas 1A  = 1A
Kelas 1B  = 1B
Kelas 1C  = 1C
dan seterusnya.

Kelas 2A  = 2A
Kelas 2B  = 2B
dan seterusnya.

Kelas 3A  = 3A
dan seterusnya.

Kelas 4 MA = 4A
Kelas 5 MA = 5A
Kelas 6 MA = 6A

Kelas 4 SMA = 4S
Kelas 5 SMA = 5S
Kelas 6 SMA = 6S

Kelas 5 MA/SMA Tahfidz = 5T
Kelas 6 MA/SMA Tahfidz = 6T

----------------------------------------------------------
9. LOGIN SISWA
----------------------------------------------------------

Alamat Login:

https://linkdomainanda.com/siswa/login.php

Login siswa hanya menggunakan:

NISN

Tidak memerlukan username tambahan.

----------------------------------------------------------
10. PERGANTIAN SEMESTER DAN TAHUN AJARAN
----------------------------------------------------------

Aplikasi ini dirancang untuk digunakan pada SATU SEMESTER.

Apabila memasuki semester atau tahun ajaran baru:

1. Buat Database baru.
2. Lakukan instalasi ulang menggunakan database baru.
3. Jangan mencampurkan data semester lama dengan semester
   baru dalam satu database.

Hal ini bertujuan agar data tetap rapi, aman, dan mudah
dikelola.

----------------------------------------------------------
11. MENGGABUNGKAN AKSES BANYAK SEMESTER
----------------------------------------------------------

Jika ingin menggabungkan akses beberapa semester dalam satu
halaman, disarankan membuat subdomain baru.

Contoh:

inputnilai.bustanululumjayasakti.com

Kemudian tampilkan seluruh link semester pada satu halaman.

Contoh:

- Semester Ganjil 2025/2026
- Semester Genap 2025/2026
- Semester Ganjil 2026/2027
- dan seterusnya.

Kode halaman penggabung sudah disediakan pada folder:

Buat_Domain_Baru

Gunakan file:

index.html

untuk membuat halaman utama yang berisi seluruh link
semester dan tahun ajaran.

==========================================================
SELESAI
==========================================================

Jika seluruh langkah di atas telah dilakukan dengan benar,
aplikasi siap digunakan.
```
