# PANDUAN PENGGUNAAN & DEPLOYMENT cPANEL
## Auto-Rapor PBD Analytics Engine - SMP Negeri 2 Bojonegoro (NPSN: 20504414)

---

### A. Menjalankan di Komputer Lokal (Laragon / Terminal)

1. **Buka Terminal / PowerShell di folder proyek:**
   ```powershell
   cd d:\laragon\www\simantap-lokal
   ```

2. **Aktifkan Virtual Environment:**
   ```powershell
   .\venv\Scripts\Activate.ps1
   ```

3. **Jalankan Aplikasi Flask:**
   ```powershell
   python app.py
   ```

4. **Buka Browser:**
   Akses `http://127.0.0.1:5000`

---

### B. Deployment ke Shared Hosting cPanel (Setup Python App)

Fitur **"Setup Python App"** di cPanel menggunakan CloudLinux Phusion Passenger yang berjalan di atas interface **WSGI**. Aplikasi ini dirancang menggunakan **Flask native WSGI** sehingga berjalan ringan, stabil, dan tanpa kendala adaptor.

#### Langkah 1: Buat Subdomain di cPanel
1. Masuk ke cPanel akun Anda.
2. Masuk ke menu **Domains** / **Subdomains**.
3. Buat subdomain, misalnya: `rapor.smpn2bojonegoro.sch.id` (atau nama domain lain yang diinginkan).
4. Catat direktori Document Root (misal: `/home/username/rapor.smpn2bojonegoro.sch.id` atau `/home/username/rapor-app`).

#### Langkah 2: Setup Python App di cPanel
1. Pada menu Software cPanel, klik **Setup Python App**.
2. Klik tombol **Create Application**.
3. Isi form konfigurasi:
   * **Python version**: Pilih `3.10` atau `3.11`.
   * **Application root**: `rapor-app` (folder tempat source code).
   * **Application URL**: Pilih subdomain yang sudah dibuat (`rapor.smpn2bojonegoro.sch.id`).
   * **Application startup file**: `passenger_wsgi.py`
   * **Application Entry point**: `application`
4. Klik **Create**. cPanel akan membuatkan virtual environment otomatis.

#### Langkah 3: Upload File Aplikasi
1. Upload file proyek ini ke dalam folder Application root (`/home/username/rapor-app`) via File Manager atau FTP:
   * `app.py`
   * `passenger_wsgi.py`
   * `config.py`
   * `requirements.txt`
   * Folder `core/` (seluruh isinya)
   * Folder `templates/` (seluruh isinya)
   * Folder `data/` (termasuk file database `simantap.db` yang sudah terisi data)
2. *Catatan*: Folder `venv/` di komputer lokal **tidak perlu di-upload**, karena cPanel akan membuat virtualenv sendiri.

#### Langkah 4: Install Dependencies di cPanel
1. Kembali ke menu **Setup Python App** di cPanel.
2. Di bagian atas aplikasi Anda, terdapat perintah untuk mengaktifkan virtualenv cPanel, contohnya:
   ```bash
   source /home/username/nodevenv/rapor-app/3.11/bin/activate && cd /home/username/rapor-app
   ```
3. Buka menu **Terminal** di cPanel (atau melalui SSH), lalu paste perintah di atas.
4. Jalankan perintah instalasi paket:
   ```bash
   pip install -r requirements.txt
   ```
5. Atau masukkan teks `requirements.txt` pada form "Configuration files" di UI Setup Python App cPanel, lalu klik tombol **Run Pip Install**.

#### Langkah 5: Set Environment Variables (Opsional)
Jika ingin mengaktifkan generator narasi AI Google Gemini:
1. Pada menu **Setup Python App** cPanel, scroll ke bagian **Environment variables**.
2. Klik **Add Variable**:
   * **Name**: `GEMINI_API_KEY`
   * **Value**: Masukkan API key Gemini Anda (`AIzaSy...`)
3. Klik **Save**.
4. Klik tombol **Restart Application** di bagian atas menu Python App.

---

### C. Alur Penggunaan Aplikasi Tiap Tahun Ajaran

1. **Dashboard KPI**: Menampilkan 7 indikator prioritas (A.1, A.2, A.3, D.1, D.4, D.8, E.2) beserta delta YoY dan kotak peringatan Red Flag.
2. **Daftar Seluruh Indikator**: Tabel interaktif untuk mengecek skor dan posisi peringkat kab/kota dan nasional.
3. **Rekomendasi ARKAS**: Pemetaan 100% deterministik dari akar masalah prioritas ke kode dan nama kegiatan resmi di ARKAS. Tersedia tombol unduh **Excel (.xlsx)**.
4. **Narasi Eksekutif AI**: Ringkasan PBD berbasis batasan fakta (*grounded facts*) siap cetak / PDF.
5. **Unggah Rapor Baru (Tiap Tahun)**:
   * Ketika Rapor Pendidikan tahun 2026 atau tahun selanjutnya dirilis Kemendikdasmen, cukup unduh file Excel dari platform resmi.
   * Masuk ke menu **Ingesti Rapor Baru** di aplikasi, lalu unggah file `.xlsx` tersebut.
   * Sistem otomatis memvalidasi NPSN `20504414`, mengekstrak data, menghitung pertumbuhan tren YoY, dan memperbarui riwayat secara permanen.
