Panduan Pengguna

Panduan Pengunjung Umum (Public)

Bagi masyarakat umum, mahasiswa, peneliti, dan institusi luar yang ingin mengeksplorasi, menganalisis, dan mengunduh data sebaran sampah laut Indonesia.

1. Menjelajahi Peta Interaktif

Halaman beranda utama menyajikan peta spasial interaktif seluruh wilayah Indonesia. Anda dapat berinteraksi langsung menggunakan navigasi berikut:

Zooming & Panning

Gunakan tombol (+) dan (-) di sudut kiri atas peta, atau scroll mouse untuk memperbesar/memperkecil peta. Klik dan geser mouse untuk menggeser cakupan peta ke lokasi yang diinginkan.

Memahami Pin Lokasi (Marker Map)

Setiap pin di peta mewakili stasiun pemantauan sampah laut. Marker ini memiliki perbedaan warna dan simbol berdasarkan domain data dan status akurasi koordinatnya.

2. Menggunakan Panel Filter Data

Di sebelah kiri layar, terdapat menu filter dinamis untuk mengerucutkan data yang ingin dianalisis secara spasial maupun grafis:

Filter Wilayah & Waktu

Saring data berdasarkan Tahun Pemantauan (2017-2025), serta wilayah administratif Provinsi dan Kabupaten / Kota secara bertahap.

Pilih Domain Data (Makro-Meso vs Mikro)

Pilih Makro-Meso Debris untuk menampilkan sampah pantai berukuran besar (>2.5 cm). Pilih Mikroplastik untuk melihat sebaran partikel plastik berukuran mikroskopis (<5 mm).

Filter Tambahan Spesifik Domain

Makro-Meso: Menggunakan matriks Pantai (Beach Litter). Menyediakan filter Kategori Sampah (seperti Plastik, Karet, Logam, Kayu) dan Subkategori spesifik.

Mikroplastik: Menyediakan filter Matriks (Air Permukaan, Air Kolom, Sedimen, Biota) serta filter tipe Polimer (PE, PP, PS, PVC, dll.) dan Bentuk (Fiber, Fragment, Film, Pellet).

3. Menganalisis Estimasi Standing Stock & Grafik Boxplot per Provinsi

IMaDeO menyediakan analisis rentang estimasi beban sampah pantai (*Standing Stock*) dan visualisasi distribusi statistik per provinsi:

Kartu Estimasi Standing Stock Se-Nasional (Rendah - Tinggi)

Pada kotak Ringkasan Data di bagian atas sidebar, sistem secara otomatis menghitung akumulasi total batas rendah (*kepadatan musiman kemarau x koefisien 0.69*) hingga batas tinggi (*kepadatan musiman hujan x koefisien 1.81*) standing stock se-nasional dalam satuan ton.

Grafik Boxplot per Provinsi (Urutan Terbesar - Terkecil)

Tepat di bawah kotak Ringkasan Data, terdapat grafik boxplot per provinsi yang diurutkan secara otomatis dari nilai estimasi terbesar hingga terkecil. Grafik ini menampilkan median, interquartile range (Q1 - Q3), titik rerata (mean), serta sebaran rentang musiman.

Modal Detail & Tabel Distribusi Statistik

Klik tombol Detail pada bagian atas grafik boxplot atau tombol Estimasi Standing Stock & Boxplot di header/sidebar untuk membuka modal interaktif. Modal ini menyediakan tabel 9 kolom terperinci per provinsi/tahun serta opsi alih indikator antara Berat (g/m² & Ton) dan Jumlah (pcs/m²).

Catatan Domain & Ketentuan: Fitur Estimasi Standing Stock dan grafik boxplot ini dirancang khusus untuk domain Makro-Meso Debris (Beach Litter). Apabila Anda beralih ke domain Mikroplastik, seluruh elemen standing stock dan grafik boxplot ini akan disembunyikan secara otomatis untuk menyesuaikan dengan karakteristik data mikroplastik.

4. Menganalisis Grafik Komposisi

Bagian bawah panel filter menampilkan grafik komposisi sampah laut yang ter-update otomatis secara langsung (*real-time*) sesuai filter aktif Anda. Grafik ini memberikan visualisasi persentase sumbangan kategori sampah terbesar terhadap total kelimpahan.

5. Detail Stasiun Pemantauan

Klik Pin & Tampilkan Ringkasan

Saat Anda mengklik pin di peta, pop-up ringkasan akan muncul yang menunjukkan Nama Stasiun, Rata-rata Berat Sampah (g/m²), Kelimpahan Makro (pcs/m²), atau Kelimpahan Mikroplastik (partikel/m³ atau partikel/g) sesuai domain terpilih.

Buka Detail Tabel & Informasi QA

Klik tombol Lihat Detail di pop-up untuk membuka modal berisi tabel terperinci semua item sampah yang ditemukan, metode pengambilan sampel yang digunakan, serta catatan kontrol kualitas (*Quality Assurance*).

Panduan Kontributor Data (Penyedia Data)

Bagi instansi UPT KLH, Balai Pengelolaan Lingkungan, universitas, lembaga swadaya masyarakat, dan tim riset yang ditugaskan untuk memasukkan dataset hasil pemantauan sampah laut.

Alur Kerja Utama Kontributor

Platform IMaDeO mengelola dua domain data utama dengan alur unggahan staging terpisah:

1. Domain Makro-Meso (Beach Litter)

Data pemantauan sampah pantai berukuran besar (>2.5 cm). Dimasukkan melalui menu Staging Submissions (Macro-Meso) dengan data kelimpahan per transek area (luas m²).

2. Domain Mikroplastik (Water/Sediment/Biota)

Data partikel plastik berukuran mikroskopis (<5 mm) pada media Air Permukaan, Air Kolom, Sedimen, dan Biota. Dimasukkan melalui menu Staging Submissions (Mikro).

1. Mengunggah Dataset via Excel (Sangat Direkomendasikan)

Metode tercepat untuk memasukkan data dalam jumlah banyak adalah dengan menggunakan template unggah Excel resmi:

Unduh Template Excel yang Sesuai

Buka menu staging di sidebar kiri sesuai domain data Anda, lalu klik tombol Unduh Template (Excel).

Tautan Unduh Alternatif:
Template Makro-Meso (.xlsx) | Template Mikroplastik (.xlsx)

Pahami Struktur dan Lengkapi Berkas Excel

Pastikan Anda tidak mengubah atau menghapus tajuk (header) kolom bawaan. Isi kolom berkas Excel sesuai aturan berikut:

Aturan Kolom Makro-Meso:

Kolom Excel	Jenis Isi	Catatan & Aturan Validasi
`main_category`	`Plastik`, `Karet`, `Logam`	Kategori utama sampah. Wajib diisi.
`item_code`	`PL01`, `ME03`	Kode item standar (PL/FP/GC/ME/RB/WD/OT/PC). Harus terdaftar di kamus.
`count_per_category`	`15`	Jumlah unit sampah yang ditemukan (harus integer ≥ 0).
`weight_per_category`	`120.5`	Berat sampah dalam gram (angka desimal/bulat ≥ 0).

Aturan Lembar (Sheets) Mikroplastik:

Template Mikroplastik harus memiliki dua sheet wajib yang saling berelasi berdasarkan kombinasi kolom (lokasi + matriks + stasiun + replikasi):

Sheet 1 (sample_info): Berisi informasi sampel. Kolom wajib: lokasi, matriks (harus bernilai Air permukaan, Air kolom, Sedimen, atau Biota), stasiun, replikasi. Ditambah nilai kuantitas media: volume_air_l (untuk matriks air), berat_sedimen_g (untuk sedimen), atau berat_biota_g & jumlah_biota_individu (untuk biota).
Sheet 2 (raw_mp): Berisi detail setiap partikel mikroskopis yang ditemukan pada sampel tersebut. Kolom wajib: lokasi, matriks, stasiun, replikasi, bentuk (harus diisi bentuk partikel, e.g. Fiber, Fragment, Film, Pellet), ukuran_mm, dan polimer_similarity.

Unggah File & Isi Metadata Sumber Data

Di menu staging, klik tombol Upload Dataset (Excel/CSV). Pada formulir yang muncul:

Pilih file Excel yang telah Anda isi.
Pilih Monitoring Site. Jika lokasi tersebut belum terdaftar, klik tombol + New Site di samping dropdown untuk mendaftarkannya langsung menggunakan bantuan peta picker.
Isi detail metadata: Penanggung Jawab, Institusi pengirim, Tanggal Survei/Tahun Data, serta Metode Pemantauan dan Catatan QC.
Klik Submit. Sistem akan langsung memproses pengunggahan dan mengonversinya ke tabel antrean validasi (Staging).

2. Penginputan Manual via Form

Jika Anda hanya ingin memasukkan satu atau dua temuan data baru secara individual tanpa berkas Excel:

Untuk Data Makro-Meso: Buka menu Staging Submissions (Macro-Meso), klik tombol Create di pojok kanan atas, isi formulir lengkap (Stasiun, Panjang/Lebar transek, Kategori Sampah, Jumlah, Berat), lalu simpan.
Untuk Data Mikroplastik: Buka menu Staging Submissions (Mikro), klik tombol Create untuk mengisi form metadata sampel terlebih dahulu. Setelah data sampel tersimpan, buka kembali halaman edit sampel tersebut dan gulir ke bagian paling bawah untuk menambahkan daftar partikel mikroplastik satu per satu melalui panel Raw Mps.

3. Memantau Siklus Status Validasi (Staging Status)

Data yang baru masuk harus melewati peninjauan validator. Anda dapat memantau status validasi data Anda di tabel utama:

Pending Validation

Data berhasil dikirim dan sedang dalam antrean pemeriksaan oleh Validator (Reviewer).

Validation Error

Sistem mendeteksi kesalahan format otomatis (e.g. koordinat di luar NKRI, kode item salah, nilai negatif). Cek kolom "Validation Errors" untuk detail kesalahan.

Needs Revision

Reviewer meminta perbaikan. Klik tombol **Edit** untuk memperbaiki data sesuai instruksi reviewer di catatan.

Published

Data telah disetujui, dipindahkan ke tabel fakta utama, dikunci dari penyuntingan, dan kini resmi tampil di web map utama.

INFORMASI KEAMANAN DATA: Sebagai Kontributor, Anda hanya diperkenankan melihat, mengubah, dan menghapus data staging yang Anda unggah sendiri. Anda tidak memiliki akses untuk melihat antrean kontributor lain demi alasan kerahasiaan data riset masing-masing pihak.

Panduan Reviewer / Validator Data

Bagi tim pengawas data Kementerian Lingkungan Hidup yang memikul tanggung jawab menjamin validitas ilmiah data sebelum dirilis ke publik.

1. Memeriksa Antrean Staging Submissions

Kontributor mengirimkan data mereka ke tabel staging. Terdapat dua antrean terpisah yang harus diperiksa:

Staging Submissions (Macro-Meso): Untuk data sampah pantai makro/meso.
Staging Submissions (Mikro): Untuk data sampel dan partikel mikroplastik.

Saring Data Menunggu Validasi

Gunakan filter status pada tabel masing-masing modul untuk menampilkan rekaman dengan status Pending Validation atau Validation Error.

Evaluasi Logika Data & Koordinat

Klik tombol Edit/View untuk melihat detail data. Periksa kesesuaian nilai pengukuran, volume/luas area, dan posisi stasiun pemantauan. Jika koordinat melenceng, Anda dapat menggunakan map picker di form edit untuk memperbaikinya secara langsung.

2. Menyetujui dan Menerbitkan Data (Approve & Publish)

Setelah data dinyatakan valid dan lengkap, data dapat diterbitkan ke tabel fakta publik agar tampil di peta utama:

Data Makro-Meso (Beach Litter)

Dapat diterbitkan dengan dua cara:

Penerbitan Individual: Klik tombol hijau Publish di kolom aksi baris data.
Penerbitan Massal: Centang beberapa baris data, klik menu dropdown Bulk Actions di bagian bawah tabel, lalu pilih Approve & Publish.

Setelah terbit, status record staging berubah menjadi published (tetap tampil di staging untuk riwayat).

Data Mikroplastik

Diterbitkan dengan cara:

Penerbitan Massal: Centang baris sampel yang sudah valid di tabel Staging Submissions (Mikro), klik menu Bulk Actions, lalu pilih Approve & Publish.

Setelah terbit, data akan dipindahkan ke tabel fakta utama (Fact Observations Mikro) beserta detail partikelnya, dan otomatis disembunyikan dari daftar antrean staging mikroplastik agar daftar tetap bersih.

3. Melakukan Retur Data (Needs Revision / Reject)

Jika ditemukan kejanggalan data (misalnya kelimpahan tidak wajar, kesalahan tipe polimer, atau koordinat melenceng):

Gunakan tombol Edit pada data staging tersebut.
Ubah statusnya menjadi Needs Revision dan isi kolom Notes dengan petunjuk perbaikan agar kontributor yang bersangkutan dapat merevisi datanya.
Jika data tersebut rusak atau duplikat tidak sah, Anda dapat langsung menghapusnya.

4. Mengelola Data Master, Sites, dan Data Dictionary

Reviewer memiliki wewenang untuk menjaga kebersihan data referensi sistem:

Monitoring Sites: Mengelola daftar lokasi stasiun pemantauan resmi di Indonesia, termasuk detail koordinat spasial dan peta picker.
Data Dictionary: Mengelola kamus jenis sampah (misal kode PL01 untuk Kantong Plastik, ME01 untuk Kaleng, dll.).
Fact Observations (Macro-Meso & Mikro): Panel ini digunakan untuk memantau atau mengoreksi data yang sudah resmi dipublikasikan ke database utama publik.

Panduan Super Administrator

Bagi Admin Sistem / Developer yang bertanggung jawab memelihara stabilitas platform, mengatur akun, dan mereset hak akses sistem.

1. Manajemen Pengguna & Pendaftaran Akun

Admin memiliki hak eksklusif untuk mendaftarkan akun baru dan menugaskan peran:

Daftarkan Akun Pengguna

Gunakan menu manajemen pengguna di panel admin untuk mendaftarkan kontributor eksternal baru dengan menginput nama, email, dan password dasar.

Reset Sandi & Penguncian Akun

Admin dapat menyunting informasi pengguna, memaksa reset password jika kontributor lupa kata sandi, atau membekukan akun jika terdapat pelanggaran pengunggahan data.

2. Mengatur Peran & Hak Akses (Filament Shield)

Sistem ini terintegrasi dengan **Filament Shield** (berbasis Spatie Laravel-Permission) untuk mengunci keamanan data:

Akses menu Shield / Roles untuk mendefinisikan permission baru.
Anda dapat membatasi akses pada tingkat model (tabel database) untuk operasi: view, view_any, create, update, delete, delete_any, restore, force_delete, dan replicate.
Secara default, jangan mengubah struktur utama permission role data_contributor dan data_reviewer kecuali ada instruksi kebijakan tata kelola data baru dari kementerian.

3. Audit System & Widgets Dashboard

Gunakan dashboard utama super admin untuk mendiagnosis kesehatan sistem:

Pantau widget Recent Activity di Dashboard untuk melacak secara instan siapa kontributor yang baru saja melakukan pengunggahan data, penyuntingan lokasi, atau proses persetujuan oleh reviewer.
Gunakan widget Domain Breakdown untuk memantau seberapa banyak rasio perbandingan data makro dan mikroplastik yang masuk ke database.

4. Penanganan Darurat Data

PERINGATAN PEMELIHARAAN: Super Admin memiliki wewenang untuk melakukan **Force Delete** (Penghapusan permanen melewati soft-delete) pada data observasi publik. Aksi ini berbahaya karena akan langsung menghapus baris dari peta web GIS secara permanen. Pastikan untuk selalu mencadangkan database (*backup*) sebelum melakukan pembersihan massal.