Panduan Replikasi & Deployment Sistem
Aplikasi Konversi Format RKA

Petunjuk teknis komprehensif untuk menduplikasi, memindahkan, atau menginstal ulang seluruh sistem Konversi Format RKA (SIPD ke RKA Perubahan & Murni) pada lingkungan lokal (XAMPP / Apache), server intranet OPD, maupun cloud hosting.

Arsitektur: Client-Side JS + SQLite Persisten

Web Server: Apache (XAMPP) / Nginx

Engine: SQLite3 + PHP 8.x PDO

Status: Dokumen Khusus Administrator / Developer

Konfidensialitas Navigasi Halaman

Sesuai instruksi konfigurasi, halaman panduan_replikasi.html ini tidak dicantumkan pada navbar, sidebar, footer, maupun menu umum aplikasi web. Akses hanya dapat dilakukan melalui URL langsung secara mandiri oleh tim pengembang atau administrator teknis.

Daftar Isi & Navigasi Cepat

1 Arsitektur & Kebutuhan Sistem 2 Struktur Folder & Komponen File 3 Langkah Replikasi (Step-by-Step) 4 Konfigurasi Database SQLite 5 Pengaturan PWA & Service Worker 6 Troubleshooting & Solusi Masalah 7 Checklist Pengujian Siap Pakai

1 Arsitektur & Kebutuhan Sistem

Aplikasi Konversi Format RKA dibangun dengan pendekatan Modern Client-Side Processing dipadukan dengan Micro-Backend SQLite untuk persistensi arsip. Seluruh konversi Excel dan PDF berjalan langsung di memori browser pengguna (client-side engine), sehingga beban komputasi server sangat ringan.

Kebutuhan Minimal Server:

Komponen	Kebutuhan Minimal	Rekomendasi
Operating System	Windows 10 / 11, Windows Server, atau Linux (Ubuntu 20.04+)	Windows dengan XAMPP 8.1+ atau Linux Nginx/Apache
Web Server	Apache 2.4+ atau Nginx 1.18+	Apache (sudah termasuk modul .htaccess dan MIME type)
PHP Runtime	PHP 8.0+	PHP 8.2+ dengan ekstensi pdo_sqlite dan sqlite3 diaktifkan
Database Engine	SQLite3 (file-based embedded)	SQLite3 bawaan PHP (tanpa install MySQL/MariaDB server terpisah)
Browser Klien	Google Chrome 90+, MS Edge 90+, Firefox 95+	Google Chrome / Edge versi terbaru (mendukung ES6+ & IndexedDB)

Keunggulan Desain Server-Agnostic: Karena pemrosesan lembar kerja Excel (format RKA 2026 P dan Murni 2027) dioperasikan oleh pustaka ExcelJS dan JSZip di browser, server hanya berperan menyajikan berkas statis dan melayani transaksi basis data SQLite lokal.

2 Struktur Folder & Komponen File

Berikut adalah bagan struktur direktori proyek yang harus disalin secara utuh saat melakukan replikasi ke komputer/server lain:

convertrka_dbase/ ├── index.html <-- Halaman utama converter & dashboard ├── analisis.html <-- Halaman visualisasi analisis sub kegiatan ├── laporan_halaman.html <-- Modul cetak format laporan RKA per halaman ├── fitur_utama.html <-- Halaman perkenalan fitur inovasi ├── rangkuman_strategi.html <-- Strategi IGA dan kebijakan inovasi ├── panduan_replikasi.html <-- Dokumen panduan ini (internal saja) ├── manifest.json <-- Manifest PWA (instalasi aplikasi desktop) ├── sw.js <-- Service worker offline cache ├── FORMAT RKA 2026 P dan MURNI 2027.xlsx <-- Master template acuan wajib ├── FORMAT RKA MURNI 2027.xlsx <-- Master template format murni ├── api/ │ ├── save_rka.php <-- Endpoint simpan data konversi ke SQLite │ ├── get_rka.php <-- Endpoint muat arsip RKA tersimpan │ ├── list_rka.php <-- Endpoint daftar arsip per OPD & tahun │ └── db_connect.php <-- Koneksi PDO ke rka.sqlite ├── database/ │ ├── .htaccess <-- Proteksi blokir akses langsung via URL (Deny from all) │ ├── rka.sqlite <-- Database SQLite data transaksi RKA │ └── convertrka.sqlite <-- Database SQLite konfigurasi OPD & riwayat ├── css/ │ └── style.css <-- Modular stylesheet utama ├── js/ │ ├── app.js <-- Inisialisasi & pengendali UI terpusat │ ├── converter.js <-- Core parsing SIPD & formatting Excel │ ├── sqliteService.js <-- Client service sinkronisasi ke SQLite │ ├── analisis.js <-- Engine halaman analisis.html │ ├── aiAnalyzer.js <-- Integrasi AI Gemini untuk telaah belanja │ ├── anomalyDetector.js <-- Deteksi Red Flag belanja janggal │ ├── whatIfSimulator.js <-- Simulasi efisiensi anggaran / refocusing │ ├── diffComparator.js <-- Perbandingan pergeseran Murni vs Perubahan │ ├── opdConfig.js <-- Pengaturan profil SKPD & pejabat penandatangan │ ├── pdfParser.js <-- Ekstraksi teks dari dokumen PDF RKA │ └── ... (library pendukung lain) └── images/ <-- Logo, favicon, dan ikon PWA

3 Langkah Replikasi (Step-by-Step)

Ikuti urutan langkah berikut saat melakukan kloning atau pemasangan di komputer target baru:

Langkah 1: Siapkan Lingkungan Web Server (XAMPP)

Pastikan XAMPP telah terpasang (disarankan di direktori default C:\xampp). Jalankan XAMPP Control Panel.

# Pastikan modul Apache aktif pada port 80 / 443 # Buka php.ini melalui tombol Config di baris Apache pada XAMPP Control Panel

Langkah 2: Aktifkan Ekstensi SQLite di PHP

Cari baris berikut di dalam php.ini dan pastikan tanda titik koma (;) telah dihilangkan (uncommented):

extension=pdo_sqlite extension=sqlite3

Simpan file php.ini, lalu tekan tombol Restart pada modul Apache.

Langkah 3: Salin Seluruh Folder Proyek ke htdocs

Salin direktori convertrka_dbase ke dalam folder htdocs:

Tujuan: C:\xampp\htdocs\convertrka_dbase\

Jika menggunakan Linux server, pastikan permission folder database/ memiliki hak akses baca & tulis oleh user www-data:

sudo chown -R www-data:www-data /var/www/html/convertrka_dbase/ sudo chmod -R 775 /var/www/html/convertrka_dbase/database/

Langkah 4: Pengujian Akses URL

Buka web browser dan arahkan ke alamat lokal:

http://localhost/convertrka_dbase/

Untuk membuka dokumen panduan replikasi ini secara terpisah:

http://localhost/convertrka_dbase/panduan_replikasi.html

4 Konfigurasi Database SQLite

Data RKA yang dikonversi dapat disimpan secara persisten ke dalam SQLite melalui tombol Database SQLite di navbar aplikasi.

Skema Pengamanan Database:

Keamanan File Database: File database/rka.sqlite mengandung data rincian anggaran daerah. File database/.htaccess telah dipasang dengan aturan:

<FilesMatch "\.(sqlite|db|sqlite3)$"> Order allow,deny Deny from all </FilesMatch>

Aturan ini mutlak diperlukan agar pengguna internet umum tidak dapat mengunduh berkas SQLite mentah secara langsung via peramban.

Backup & Restore Arsip:

Backup: Cukup salin file database/rka.sqlite ke media penyimpanan eksternal atau Google Drive saat Apache sedang tidak sibuk.
Restore: Letakkan kembali file salinan ke direktori database/rka.sqlite. Sistem akan langsung mengenali seluruh riwayat OPD dan pagu anggaran yang pernah tersimpan.

5 Pengaturan PWA & Service Worker

Aplikasi telah dilengkapi fitur Progressive Web App (PWA) sehingga dapat diinstal seperti aplikasi desktop di Windows / Mac / Chromebook tanpa membutuhkan koneksi internet aktif setiap saat.

Mekanisme Cache Service Worker:

File sw.js mencatat versi cache aset penting (CSS, JS, ikon, dan template).
Jika Anda melakukan modifikasi kode JavaScript (misal pada converter.js atau app.js), naikkan nomor versi cache pada file sw.js agar browser klien memuat file terbaru:

const CACHE_NAME = 'rka-converter-v3.2'; // Tingkatkan versi ini setiap update

Pengguna juga dapat menekan kombinasi Ctrl + F5 (Hard Refresh) untuk memaksa pembaruan cache pada browser mereka.

6 Troubleshooting & Solusi Masalah

Gejala / Masalah	Penyebab Umum	Langkah Penanganan
Database SQLite gagal menyimpan / muncul pesan error API	Ekstensi pdo_sqlite pada PHP belum diaktifkan atau izin tulis folder ditolak.	Buka php.ini, hapus tanda titik koma pada extension=pdo_sqlite, simpan, lalu restart Apache. Pastikan folder database/ tidak berstatus Read-Only.
Template Master tidak ditemukan saat konversi	File FORMAT RKA 2026 P dan MURNI 2027.xlsx terhapus atau berubah nama.	Pastikan file template master acuan berada tepat di root folder convertrka_dbase/ dengan nama file yang sama persis.
Browser menampilkan tampilan lama setelah kode diperbarui	Service Worker atau cache browser menahan file versi terdahulu.	Lakukan Ctrl + Shift + R atau buka DevTools (F12) > Application > Service Workers > klik Unregister / Update.
Fitur AI Analisis tidak menampilkan respons	Koneksi internet terputus atau batas kuota API Key Google Gemini tercapai.	Pastikan perangkat terhubung internet dan API Key Google Gemini 2.5 yang valid telah dimasukkan pada modal pengaturan AI.
File Excel hasil konversi tidak terunduh otomatis	Popup atau multiple downloads diblokir oleh browser.	Periksa ikon izin unduhan pada address bar browser sebelah kanan atas dan pilih "Always allow downloads from this site".

7 Checklist Pengujian Siap Pakai (Quality Assurance)

Sebelum sistem diserahterimakan kepada staf perencana atau tim anggaran OPD di server baru, lakukan verifikasi mandiri berikut:

Halaman beranda index.html dapat diakses dengan respons cepat tanpa error console di DevTools.

Template Master FORMAT RKA 2026 P dan MURNI 2027.xlsx terdeteksi dan tersimpan ke IndexedDB di Step 1.

Uji konversi data SIPD uji coba (Excel / PDF) menghasilkan file RKA Perubahan dan Murni secara akurat.

Modal Database SQLite dapat dibuka, memuat daftar arsip, dan dapat menyimpan hasil konversi baru.

Halaman analisis.html menampilkan grafik visualisasi belanja dengan interaksi filter yang responsif.

URL direct database/rka.sqlite menghasilkan halaman 403 Forbidden (proteksi .htaccess berjalan).

Dokumen panduan ini (panduan_replikasi.html) tidak tampil di menu navbar situs utama.

Akses Mandiri: panduan_replikasi.html • Server Lokal XAMPP / Intranet

Panduan Replikasi & Deployment SistemAplikasi Konversi Format RKA

Konfidensialitas Navigasi Halaman

Daftar Isi & Navigasi Cepat

1 Arsitektur & Kebutuhan Sistem

Kebutuhan Minimal Server:

2 Struktur Folder & Komponen File

3 Langkah Replikasi (Step-by-Step)

Langkah 1: Siapkan Lingkungan Web Server (XAMPP)

Langkah 2: Aktifkan Ekstensi SQLite di PHP

Langkah 3: Salin Seluruh Folder Proyek ke htdocs

Langkah 4: Pengujian Akses URL

4 Konfigurasi Database SQLite

Skema Pengamanan Database:

Backup & Restore Arsip:

5 Pengaturan PWA & Service Worker

Mekanisme Cache Service Worker:

6 Troubleshooting & Solusi Masalah

7 Checklist Pengujian Siap Pakai (Quality Assurance)

Panduan Replikasi & Deployment Sistem
Aplikasi Konversi Format RKA