HADIRMU SUPERAPP v4.0 CLEAN — READY INSTALL
===========================================

Paket ini dibuat berdasarkan inspeksi source aplikasi HadirMu dan dump
database yang dilampirkan. Tujuan utamanya:

1. Membersihkan HadirMu dari koneksi dan residu integrasi AI/Nalarzk lama.
2. Mempertahankan fitur HadirMu yang sudah ada.
3. Meng-upgrade HadirMu menjadi SuperApp manajemen sekolah.
4. Menambahkan SDM, kehadiran guru/karyawan, penggajian, kalender sekolah,
   jurnal piket, portal pegawai, dan slip gaji pribadi.

INSTALL KEY
-----------
6A5B152E8E1DCD58

KEBUTUHAN
---------
- PHP 8.0 atau lebih baru
- ekstensi mysqli
- MySQL/MariaDB
- akses Administrator HadirMu
- disarankan backup folder + database melalui cPanel sebelum instalasi

CARA INSTAL PALING AMAN
=======================

1. BACKUP MANUAL DULU
---------------------
Dari cPanel:
- backup folder HadirMu
- export database HadirMu lewat phpMyAdmin

Installer juga membuat backup file yang ditimpa di:
  database/backup_before_superapp_v4_YYYYMMDD_HHMMSS/

Folder backup dilindungi .htaccess.

2. UPLOAD
---------
Ekstrak SEMUA isi ZIP ini ke ROOT HadirMu.

Root HadirMu adalah folder yang berisi kira-kira:
  login.php
  config/
  admin/
  guru/
  assets/

Jangan menghapus config/koneksi.php.

Paket ini memang TIDAK membawa config/koneksi.php dan tidak membawa
kredensial database.

3. JALANKAN INSTALLER
---------------------
Buka:
  https://DOMAIN-HADIRMU/00_INSTALL_HADIRMU_SUPERAPP_V4.php

Masukkan Install Key:
  6A5B152E8E1DCD58

Kemudian klik instalasi.

Urutan internal installer:
- backup file yang akan berubah
- migrasi struktur SuperApp
- pasang source clean
- patch config/koneksi.php secara surgical
- sinkron Data Guru -> Data Pegawai
- verifikasi struktur baru
- baru setelah itu membersihkan residu integrasi lama

Cleanup destructive ditempatkan PALING AKHIR agar kegagalan pada tahap awal
tidak langsung merusak source/data lama.

4. VERIFIKASI
-------------
Setelah installer menyatakan berhasil, buka:
  https://DOMAIN-HADIRMU/00_VERIFY_HADIRMU_SUPERAPP_V4.php

Masukkan Install Key yang sama.

Semua pemeriksaan utama idealnya berstatus OK.

5. LOGIN DAN KONFIGURASI PERTAMA
--------------------------------
Masuk sebagai Administrator.

Lakukan urutan ini:
A. Pengaturan SDM
   Atur hari kerja default, jam masuk, dan jam pulang.

B. Kalender Sekolah
   Masukkan libur, rapat wajib, ujian, workshop, dan kegiatan lain.
   "Hari Kerja = Ya" memaksa tanggal menjadi hari kerja untuk semua SDM.
   "Hari Kerja = Tidak" mengecualikan tanggal dari ekspektasi kehadiran.

C. Data Pegawai
   Data Guru lama otomatis disinkronkan.
   Periksa status kepegawaian, jabatan, skema kehadiran, WA, dan akun login.

D. Pengaturan Gaji
   Atur per pegawai:
   - gaji pokok
   - tunjangan tetap
   - tunjangan jabatan
   - uang hadir
   - uang makan
   - transport
   - lembur
   - potongan Alfa
   - potongan terlambat
   - potongan pulang awal
   - potongan tetap
   - komponen tambahan

E. Kehadiran Guru/Karyawan
   Guru Piket atau Administrator menginput setiap hari.

F. Penggajian
   Di akhir periode:
   - Hitung Draft
   - periksa kehadiran/komponen
   - Finalkan
   - setelah pembayaran, tandai Dibayar

Draft TIDAK ditampilkan pada portal pribadi guru/karyawan. Slip baru terlihat
setelah status Final atau Dibayar.

6. SETELAH STABIL
-----------------
Setelah semua pengujian selesai, hapus dari hosting:
- 00_INSTALL_HADIRMU_SUPERAPP_V4.php
- 00_VERIFY_HADIRMU_SUPERAPP_V4.php
- INSTALL_KEY.txt
- database_patch_superapp_v4.sql
- folder _hadirmu_superapp_v4_payload/

Simpan ZIP ini secara offline sebagai arsip versi.

CATATAN PENTING
---------------
- no_whatsapp tetap dipertahankan sebagai data kontak sekolah.
- email dan data akun inti tetap dipertahankan.
- data siswa/presensi siswa/penilaian/BK/surat izin/jadwal lama tidak dihapus.
- installer membersihkan field/tabel/setting yang memang terkait integrasi lama.
- paket tidak berisi password database, API key, atau konfigurasi koneksi user.
