PanduanBagian 11 dari 12

Masalah Umum & Cara Mengatasinya

Kendala yang paling sering muncul saat memasang DIMETIL, beserta penyebab dan penanganannya.

Isi halaman ini

Sebelum menelusuri satu per satu, buka Dashboard → Diagnostik Sistem. Halaman itu memeriksa seluruh sambungan sekaligus dan menyebutkan mana yang putus — jauh lebih cepat daripada menebak.

Aplikasi tidak mau menyala

GejalaSebab & tindakan
Module not foundDependensi belum terpasang — jalankan npm install
Galat setelah npm run buildHentikan dulu server pengembangan, hapus folder .next, lalu ulangi
Port 3000 sudah dipakaiAda aplikasi lain berjalan; hentikan, atau jalankan pada port lain

Tidak dapat masuk sebagai admin

  1. Sudahkah akun Anda didaftarkan lewat /register?
  2. Sudahkah tautan verifikasi di e-mail diklik?
  3. Sudahkah kolom role diubah menjadi adminInstansi di Supabase?
  4. Sudahkah Anda keluar lalu masuk kembali setelah perannya diubah?

Langkah keempat sering terlewat — peran dibaca saat masuk.

Halaman dasbor kosong atau galat

Hampir selalu karena nama lembar Spreadsheet tidak cocok dengan yang diharapkan aplikasi.

Buka Diagnostik Sistem → bagian Google Sheets. Di sana disebutkan lembar mana yang tidak ditemukan. Perbaiki dengan salah satu cara:

  • Ubah nama lembarnya agar sesuai, atau
  • Sesuaikan variabel GOOGLE_SHEET_NAME_* dengan nama lembar yang Anda pakai

Galat kuota Google Sheets

Google membatasi sekitar 60 pembacaan per menit.

TindakanKeterangan
Tunggu satu menitPembatasannya berjangka pendek
Berhenti menyegarkan berulangSetiap muat ulang memakan kuota
Periksa penyegaran otomatisLayar anjungan yang terlalu sering menyegarkan dapat menghabiskan kuota

Aplikasi sudah memakai penyangga dan pengulangan bertahap, sehingga galat ini jarang sampai ke pengguna.

Data tersimpan tetapi tidak muncul di halaman

Kemungkinan besar penyangga (cache). Sebagian besar pembacaan disangga selama 30–60 detik agar hemat kuota.

Tunggu satu menit lalu muat ulang. Bila setelah beberapa menit tetap tidak muncul, periksa Diagnostik Sistem.

Kolom Spreadsheet tiba-tiba menampilkan #REF!

Bila terlanjur: kembalikan rumusnya lewat riwayat versi Google Spreadsheet (File → Riwayat versi).

Tanggal tampil terbalik

Misalnya 5 Juli padahal seharusnya 7 Mei.

Penyebabnya penulisan tanggal bergaris miring yang ditafsirkan gaya Amerika (bulan/tanggal). Aplikasi selalu membaca garis miring sebagai tanggal/bulan dan menulis dalam bentuk YYYY-MM-DD.

Bila Anda menyunting tanggal langsung di Spreadsheet, tulislah dalam bentuk YYYY-MM-DD agar tidak menimbulkan penafsiran ganda.

Gambar tidak muncul

Unggah gambar lewat fitur bawaan aplikasi, jangan menempelkan tautan Google Drive secara langsung — Drive memblokir penyisipan gambar dari situs lain. Aplikasi menyalurkan gambarnya lewat alamatnya sendiri.

Berkas gagal diunggah

Batasnya 4 MB untuk seluruh unggahan. Berkas yang lebih besar ditolak sebelum sempat sampai ke aplikasi, sehingga pesan galatnya kadang tidak ramah.

Perkecil berkasnya: foto dari ponsel biasanya sudah memadai untuk surat permohonan.

E-mail tidak terkirim

  1. Periksa kata sandi aplikasi Gmail — bukan kata sandi akun biasa
  2. Pastikan verifikasi dua langkah aktif pada akun Google tersebut
  3. Periksa apakah akunnya mencapai batas pengiriman harian

Masih belum teratasi

Sampaikan kepada Unit Metrologi Legal Kabupaten Kotabaru lewat metrologikotabaru@gmail.com atau Tiket Bantuan pada situs kami. Sertakan:

  • Langkah yang Anda lakukan sampai galat muncul
  • Tangkapan layar halaman Diagnostik Sistem
  • Pesan galat yang muncul, disalin apa adanya