# PANDUAN PASANG — RILIS 2 OKTOBER 2026 (versi 3.0)

Waktu pasang ±5 menit. Database Supabase **sudah diperbarui dan aktif** (tidak perlu disentuh).
Yang perlu dipasang hanya dua hal: **file web ke GitHub** dan **kode Mesin Drive ke Apps Script**.

## A. Unggah file web ke GitHub (Cloudflare tayang otomatis ±1 menit)

1. Buka https://github.com/grupantok/antok-group → tombol **Add file → Upload files**.
2. Tarik (drag) SEMUA file di folder rilis ini ke kotak unggah, **kecuali** folder `mesin-drive`, folder `LAMA`, dan file `.md`:
   `index.html`, `app3.js`, `app3.css`, `hal-beranda.js`, `hal-profil.js`, `hal-penawaran.js`, `hal-draft.js`,
   `hal-proyek.js`, `hal-keuangan.js`, `hal-rup.js`, `hal-template.js`, `hal-analisa.js`, `hal-admin.js`,
   `logo.svg`, `favicon.png`, `apple-touch-icon.png`, `bg-latar.svg`, `logo-lebar.webp`, `_headers`.
   (File `config.js`, `app.js`, `app.css` lama dibiarkan — tidak dipakai lagi tapi aman.)
3. Tulis pesan commit: `Rilis 3.0 — 2 Okt 2026` → **Commit changes**.
4. Unggah kode Mesin Drive ke folder repo `mesin-drive` juga (supaya tersimpan): buka folder `mesin-drive` di GitHub → Add file → Upload files → `MesinDrive.gs` → Commit.
5. Tunggu ±1 menit, buka https://antok.bangunan.co.id (tekan Ctrl+F5 sekali untuk membuang cache). Halaman login baru tampil (tulisan SIGN UP, excavator diam dengan lengan bergerak).

## B. Pasang Mesin Drive (Apps Script) — WAJIB, karena upload/generate memakai protokol baru

1. Buka https://script.google.com → proyek **Mesin Drive ANTOK** (yang URL-nya dipakai di Admin → Mesin Drive).
2. Hapus semua isi file kode (Ctrl+A, Delete), tempel seluruh isi `mesin-drive/MesinDrive.gs`, simpan (Ctrl+S).
3. Klik **Deploy → Manage deployments → ✎ (Edit) → Version: New version → Deploy**. URL tetap sama, jadi tidak perlu diubah di web.
4. Bila muncul permintaan izin (Drive, Docs, Sheets, UrlFetch), setujui dengan akun grupantok@gmail.com.
5. Di web: Admin → Mesin Drive → **Uji Sambungan** harus menampilkan "Versi mesin: 3.0".

## C. Cek 5 menit setelah pasang

- Beranda ANTOK: ada kotak **KEUANGAN** dan **LAPORAN HARIAN** di atas, ikon ⚠ pemberitahuan di kanan atas.
- Admin → **Hak Akses**: pilih user TES, centang/lepas satu kotak, muat ulang → tersimpan.
- Admin → **Link Folder** → **Cek Sinkron Folder** → semua rekanan OK (yang belum punya folder bisa ditekan "Buat").
- Admin → Mesin Drive → **Uji Penamaan** → hasil hanya huruf, angka, spasi.
- Data Profil → **Periksa Data Kosong** → daftar isian kosong per grup.
- Proyek Berjalan → paket TES → **Laporan Harian → Tambah** → muncul progres kemarin, penambahan, status target.
- Penawaran → **Tambah Masal (.xlsx)** → unduh template, isi 1 baris, unggah → pratinjau → simpan.

## D. Kalau ada masalah

- Web tidak tampil / layar putih: unggah ulang `LAMA/index.html` sebagai `index.html` (kembali ke versi lama; file lama `app.js` masih ada di repo). Lalu kabari Claude dengan isi pesan merah di Console (F12).
- Upload/generate gagal "Mesin Drive tidak bisa dihubungi": ulangi langkah B (deploy New version) dan pastikan akses "Anyone".
- Pesan "USER NAME ANDA TIDAK PUNYA KEWENANGAN INI": atur di Admin → Hak Akses.

## E. Yang sudah aktif di database (tidak perlu tindakan)

Tabel baru: hak_akses, pengaturan_sistem, notifikasi, addendum, cco, kontrak_tambahan, kelengkapan_aturan, aturan_administrasi.
Kolom baru paket: tanggal_selesai_fisik, tanggal_selesai_administrasi, nilai_kontrak_awal, masa_kontrak_awal, volume_utama_angka, status_verifikasi_adm (+tanggal, catatan).
View/fungsi: v_rekap_paket (+keuangan), v_analisa_paket, v_laporan_harian, kelengkapan_rekanan(), kelengkapan_semua(), adm_kurang(), tambah_paket_masal(), tolak_pendaftaran(), setujui_pendaftaran (peran ADMIN/REKANAN).
Trigger: notifikasi otomatis (status paket, perubahan data), laporan harian → progres paket, addendum/kontrak tambahan → nilai & masa kontrak.
Kinerja & keamanan: 36 index baru, search_path fungsi, policy auth.uid() dibungkus select, realtime untuk notifikasi & antrian generate.