PAKET WEB STATIS — STUDI ILUMINASI 3D WAILAWI / MESA
=====================================================
Sumber: D:\BTW\horizon_slide\Mesa_Help\_illum\
Dibangun: 13 November 2026


1. CARA UPLOAD KE HOSTINGER
---------------------------
a. Masuk ke hPanel > Files > File Manager, buka folder public_html/
   (atau folder root domain yang Anda tentukan di hPanel).
b. Kosongkan / pindahkan isi lama public_html bila perlu.
c. Upload file ZIP utama, lalu klik kanan > Extract.
   PENTING: ekstrak ISINYA langsung di dalam public_html, jangan sampai
   terbentuk folder tambahan. Hasil akhir yang benar:

       public_html/index.html          <-- landing / daftar isi
       public_html/site/
       public_html/site_k1k4/
       public_html/bentang/
       public_html/gallery3d/
       public_html/unduhan/
       ... dst

d. Buka https://domain-anda/ — harus muncul halaman indeks bertema terang
   berisi daftar seluruh topik. Klik salah satu kartu untuk menguji.

e. Bila File Manager menolak ukuran arsip, dua alternatif:
   - Pakai FTP (FileZilla): upload folder hasil ekstraksi lokal, atau upload
     ZIP lalu Extract dari File Manager; FTP tidak memakai batas unggah
     halaman web.
   - Atau upload per folder secara bertahap lewat File Manager.


2. ISI PAKET (topik dikelompokkan di landing page)
--------------------------------------------------
site/                     Studi Iluminasi Target & Sensitivitas Permukaan (ID/EN)
site_k1k4/                Bentang 3D Survey, 16 tab hasil K1-K4
site_configs/             Viewer iluminasi 3 konfigurasi akuisisi (XY/3D/before-after)
site_zones/               Iluminasi dengan kendala zona (kilang, pemukiman, sungai, ROW)
out_stride_study/         Studi validasi stride 1 vs stride 2
out_topo_study/           Studi sensitivitas elevasi permukaan (SRTM 30 m)
bentang/                  Platform + 4 sub-halaman (modul, Data Cloud, FWI 2D, Interpolasi 5D)
gallery3d/                Galeri 144 render kubus 3D + peta kepercayaan sel (kisi 100 m)
laporan/                  Laporan progres sintetik & 5D, versi HTML mandiri
unduhan/                  8 berkas PPTX / PDF / DOCX
overlay/                  Peta overlay & horizon 3D (dari viewer root workspace)
index.html                Landing page berisi daftar seluruh topik + pencarian/filter
mobile.css                Lapisan CSS responsif untuk ponsel (dimuat semua halaman)
README-UPLOAD.txt         Berkas ini

Yang SENGAJA tidak disertakan: skrip Python, skrip QA, log, cache, folder _qa,
serta set gambar 40 m (lihat butir 5). Semua folder di atas bersifat statis.


3. HAL YANG PERLU DIPERHATIKAN
------------------------------
* Murni HTML/CSS/JS: tidak ada PHP, database, build step, atau proses server.
* Semua tautan bersifat relatif. JANGAN mengganti nama folder bentang/ dan
  site_k1k4/ — keduanya saling memuat berkas (../bentang/js/store.js,
  ../site_k1k4/js/i18n-*.js).
* Empat viewer memuat pustaka dari CDN (Leaflet, Plotly, ubin peta):
  site/, site_zones/, site_configs/, overlay/. Tanpa koneksi internet,
  peta/plot 3D pada viewer tersebut tidak tampil; halaman lain tetap jalan.
* Nama berkas di unduhan/ sudah diubah menjadi ASCII agar aman di server Linux.
* Angka yang tampil berasal dari JSON hasil perhitungan, bukan tabel ketikan.


4. TAMPILAN PONSEL / MOBILE
---------------------------
* Semua 15 halaman punya <meta name="viewport"> dan memuat mobile.css,
  yakni lapisan aturan @media (max-width:720px) yang disuntikkan sebagai
  <link> terakhir. Tampilan desktop TIDAK berubah.
* Sudah diuji pada 390 x 844 (ponsel), 320 x 700 (ponsel kecil), dan
  768 x 1024 (tablet): tidak ada scroll horizontal halaman, dan konten
  yang lebih lebar dari layar dapat DIGESER MENYAMPING di dalam area itu.
* Landing page, studi stride/topo, platform bentang/, dan laporan HTML
  paling nyaman di ponsel. Baris tab 16 halaman, tabel panjang, dan peta
  Leaflet/Plotly dirancang untuk layar lebar; kartunya ditandai
  "layar lebar" / "tabel lebar" / "geser tab". Untuk analisis numerik,
  peta kepercayaan sel, dan before/after, disarankan layar >= 900 px.
* Yang sudah diperbaiki khusus untuk mobile: header bentang/ yang semula
  terpotong, baris tab site_configs/ yang semula terpotong, badge galeri
  yang semula satu kolom memanjang, target sentuh minimum, dan lebar
  minimum kartu pada layar 320 px.
* Pada site_configs/, site_zones/, dan overlay/, tombol +/− Leaflet
  disembunyikan di ponsel karena menimpa panel kontrol yang melayang.
  Perbesar peta dengan pinch / double-tap. Tombol +/− tetap ada di
  viewer site/ dan di layar > 720 px.
* Ubin peta yang "melampaui layar" pada laporan QA adalah perilaku wajar
  Leaflet: ubin sengaja dipangkas oleh jendela peta dan muncul saat peta
  digeser. Tidak ada menu, tombol, atau tab yang terpotong.
* PERHATIAN: jangan menghapus mobile.css atau mengganti nama folder —
  setiap halaman memanggilnya lewat path relatif ../mobile.css.


5. ADD-ON OPSIONAL: GAMBAR 40 M (gallery3d)
-------------------------------------------
Paket utama hanya membawa 144 PNG kisi 100 m, yaitu kisi yang dipakai untuk
semua angka pemulihan, korelasi, dan peta kepercayaan. Set 40 m (192 MB,
2496 x 1672 px) tersedia di arsip terpisah:

    wailawi-gallery40m-addon.zip

Ekstrak arsip itu ke root yang SAMA (public_html/). Ia menambah 144 PNG di
gallery3d/img40/ dan mengganti isi gallery3d/data/res40.txt dari "0" menjadi
"1" (izinkan ekstraksi menimpa berkas kecil itu). Halaman galeri membaca
flag tersebut dan memunculkan kembali tombol "Tajam 40 m" dengan sendirinya.
Tanpa add-on, galeri otomatis memakai 100 m dan tombol 40 m disembunyikan.

Bila tombol belum juga muncul (ekstraktor tidak menimpa berkas), buka
gallery3d/data/res40.txt lewat File Manager lalu ubah isinya menjadi 1.
Mekanisme ini sengaja memakai berkas yang SELALU ada supaya tidak ada
permintaan 404 di console browser.

PERINGATAN: gambar 40 m HANYA untuk inspeksi visual struktur. Rekonstruksi
5D pada kisi 40 m belum tervalidasi (pemulihan 4,4 / 0,0 / 5,4 % vs
35,4 / 16,9 / 33,6 % pada 100 m). Jangan dipakai untuk kesimpulan kinerja 5D.


6. CARA MEMBANGUN ULANG & QA (lokal)
------------------------------------
    python _illum/_webhost/build.py
    python _illum/_webhost/qa.py
    python _illum/_webhost/serve_stage.py 8791
    NODE_PATH=<node workspace>/node_modules node _illum/_webhost/qa_browser.js
    NODE_PATH=<node workspace>/node_modules node _illum/_webhost/qa_mobile.js

Skrip menyusun ulang folder output/hostinger/site/ dan kedua ZIP dari sumber
di _illum/. Sumber landing page ada di _illum/_webhost/landing.html,
lapisan responsif di mobile.css. QA mobile menulis qa-mobile.json.