📖 Panduan Penggunaan — Tananua Flores

Panduan lengkap untuk Admin, Petugas Penginput, dan Pengunjung: mulai dari login, mengelola data, peta desa, import/export, hingga pengaturan.

Daftar Isi:

1. Tentang aplikasi 2. Login & akun 3. Halaman utama (dashboard)4. Peta desa & koordinat 5. Mengelola data modul 6. Import dari Excel/CSV 7. Menambah kolom tabel 8. Unduh/Ekspor data 9. Kelola pengguna (Admin)10. Pengaturan tampilan 11. Data kependudukan desa 12. Sinkronisasi Google Spreadsheet 13. Tips & tanya-jawab

1. Tentang Aplikasi

Tananua Flores adalah sistem visualisasi data program pemberdayaan di Pulau Flores. Aplikasi mengelola 19 bidang data (program, peserta, konservasi, pangan lokal, perikanan, perhutanan sosial, hutan adat, hutan keluarga, desa, gizi, dan lainnya) dalam satu tempat, menampilkannya sebagai grafik & peta, serta menyediakan unduhan laporan.

Pengunjung (tanpa login) — hanya bisa melihat dashboard, peta, tabel data, dan mengunduh laporan.
Petugas — seperti pengunjung, tetapi juga boleh menginput data pada bidang yang ditugaskan.
Admin Utama — mengelola seluruh data, akun pengguna, peta desa, dan pengaturan tampilan.

2. Login & Akun

Buka halaman Login Admin (tombol di pojok kanan atas).
Isi Username dan Password, lalu klik Masuk.

Akun yang tersedia saat pertama kali dipasang:

Peran	Username	Password awal	Hak
👑 Admin Utama	`admin`	`admin123`	Semua (data, pengguna, peta, pengaturan)
👤 Petugas (19 akun)	`petugas_<bidang>`	`flores123`	Input data sesuai bidangnya saja

⚠️ Segera ganti password setelah pertama masuk melalui menu Ubah Password (kanan atas). Petugas yang lupa password dapat di-reset oleh Admin di Kelola Pengguna.

Daftar akun petugas bawaan

Username	Bidang / Sumber Data
`petugas_program`	📋 Data Program
`petugas_peserta_program`	👥 Data Peserta Program
`petugas_lahan_konservasi`	🌱 Luas Lahan Konservasi Tanah & Air
`petugas_pangan_lokal`	🌾 Data Pangan Lokal
`petugas_kelompok_pengelola`	🤝 Data Kelompok Pengelola
`petugas_simpan_pinjam`	💰 Data Kelompok Simpan Pinjam
`petugas_penerima_manfaat`	🏡 Penerima Manfaat Perhutanan Sosial & Hutan Adat
`petugas_hutan_adat`	🌳 Data Hutan Adat
`petugas_desa_dampingan`	🏘️ Data Desa Dampingan
`petugas_perikanan`	🐟 Data Perikanan
`petugas_ekosistem`	🦩 Data Ekosistem
`petugas_staf`	🧑‍💼 Data Staf
`petugas_gizi`	🍎 Data Gizi
`petugas_lahan_kritis`	🏜️ Data Lahan Kritis
`petugas_kebun_konservasi`	🪴 Data Kebun Konservasi Tanah & Air
`petugas_pupuk_organik`	🌿 Data Produksi Pupuk Organik
`petugas_pestisida_organik`	🐞 Data Pestisida Organik
`petugas_das`	🏞️ Data Daerah Aliran Sungai (DAS)
`petugas_hutan_keluarga`	🌲 Data Hutan Keluarga

3. Halaman Utama (Dashboard)

Peta Wilayah Kerja — peta interaktif Pulau Flores. Titik pin berisi jumlah data desa tersebut; klik pin untuk melihat rincian per bidang. Angka ringkas di samping peta memperbarui otomatis.
Kartu KPI — ringkasan angka utama (program, peserta, luas konservasi, dsb.).
Visualisasi per Bidang Data — 19 kartu grafik (satu per modul). Klik Lihat Detail → untuk membuka halaman datanya.

4. Peta Desa & Koordinat (Admin)

Menu Modul Data → Wilayah → Peta Desa & Koordinat. Daftar desa terisi otomatis dari Data Desa Dampingan (dan nama desa pada seluruh data; tombol 🔄 Sinkron dari Data untuk menarik desa baru).

Tambah desa baru: klik ＋ Tambah Desa → isi nama/kecamatan/kabupaten → klik 📍 Pilih di Peta → klik posisi desa pada peta (lat/lng terisi otomatis) → Simpan Desa.
Menggeser posisi / melengkapi koordinat: pada baris desa klik Ubah → ubah data bila perlu → 📍 Pilih di Peta → klik titik baru pada peta → Simpan Perubahan.
Tambah desa serupa: tombol Tambah pada baris menyalin isian baris tersebut ke form tambah.
Hapus desa: tombol Hapus pada baris.

💡 Desa yang sudah berkoordinat langsung tampil sebagai titik di peta halaman depan. Koordinat dapat pula diketik manual (format desimal, mis. -8.583, 120.450).

5. Mengelola Data Modul

🏁 Alur input yang disarankan: mulailah dari Data Desa Dampingan — setiap desa yang diinput di sana otomatis menjadi Data Dasar Desa, sehingga modul lain (Gizi, Perikanan, Konservasi, Kelompok, dll.) tinggal memilih desa dari daftar — data langsung terintegrasi tanpa mengetik ulang. Setelah itu lengkapi koordinat desa di Peta Desa & Koordinat agar muncul di peta.

Pilih modul lewat menu Modul Data atau kartu di dashboard. Setiap halaman modul menampilkan statistik, 2 grafik, dan tabel data (pencarian + halaman).

Menambah data

Klik ＋ Tambah Data → isi form (kolom bertanda * wajib) → Simpan Data.
Tombol Tambah pada setiap baris tabel: menyalin isian baris itu menjadi data baru (praktis untuk data serupa).

Mengubah & menghapus

Ubah pada baris → perbaiki → Simpan Perubahan.
Hapus pada baris → konfirmasi. Tombol 🗑 Hapus Semua menghapus seluruh isi modul (hati-hati!).

Mencari data

Ketik kata kunci pada kotak Cari data… lalu Enter — mencari di seluruh kolom teks (nama desa, nama kelompok, dll.).

🔒 Petugas hanya melihat tombol kelola pada bidang yang ditugaskan; bidang lain tampil read-only.

6. Import Data dari Excel / CSV

Klik Template (pada tombol unduh) untuk mengunduh contoh format CSV modul tersebut — isi mengikuti baris contoh.
Di Excel: susun data mengikuti urutan kolom template, lalu Simpan Sebagai → CSV (Comma Delimited).
Di halaman modul klik ⬆ Import CSV → pilih file → klik Import Sekarang.
Hasilnya langsung muncul; baris yang tidak valid dilewati dan dilaporkan (mis. angka tidak sah / wajib kosong).

☑️ Centang "Hapus data lama dulu" bila ingin mengganti seluruh isi modul dengan file baru. Tanpa centang, data ditambahkan di belakang data lama.

💡 Angka boleh memakai format Indonesia 1.234,56 maupun titik desimal 1234.56 — keduanya terbaca otomatis.

7. Menambah Kolom Tabel (Admin)

Buka halaman modul yang diinginkan → klik ＋ Tambah Kolom.
Isi Nama Kolom (mis. "Jumlah Lansia", "No. HP") dan pilih Jenis Data (Teks / Angka bulat / Desimal).
Klik Simpan Kolom. Kolom baru langsung tersedia di form input, tabel, dan semua file unduhan modul itu.

Nama kolom tidak boleh sama dengan kolom yang sudah ada di modul tersebut.

8. Unduh / Ekspor Data

Setiap halaman modul memiliki tombol unduh (dapat dipakai semua pengguna, tanpa login):

Excel — file .xlsx seluruh data, siap diolah / direkap.
Word — dokumen .docx berjudul + tabel rapi, siap diedit untuk laporan.
JPG — gambar laporan dengan kop gradasi (judul, tanggal, jumlah data) untuk disisipkan ke presentasi/foto dokumentasi.
CSV — data mentah; Template CSV — format kosong untuk pengisian & import.

9. Kelola Pengguna (Admin Utama)

Menu Kelola Pengguna (navbar, hanya tampil untuk Admin). Di sini Admin membagi tugas input sesuai bidang program.

＋ Tambah Pengguna — isi nama, username, password, pilih peran (Petugas atau Admin), lalu centang satu/beberapa Bidang/Sumber Data yang boleh diinput.
Ubah — mengganti nama, peran, bidang tugas, status Aktif/Nonaktif, atau mereset password (isi kolom Password Baru).
Hapus — menghapus akun (akun sendiri tidak bisa dihapus; admin terakhir dilindungi).

💡 Pembagian kerja: beri tiap petugas 1–2 bidang sesuai tugas lapangannya — petugas hanya dapat mengubah data bidangnya.

10. Pengaturan Tampilan (Admin)

Menu ⚙ Pengaturan:

Logo — unggah file gambar (JPG/PNG/GIF/WEBP/SVG) atau tempel URL gambar; centang Hapus logo untuk kembali ke ikon bawaan. Logo tampil di pojok atas semua halaman.
Teks Sambutan — judul & deskripsi halaman depan (kosongkan untuk kembali ke teks bawaan).
Warna Template — pilih salah satu tema (klik kartunya), lalu Simpan Pengaturan. Tema berlaku ke seluruh aplikasi.

11. Data Kependudukan Desa (Modul Desa Dampingan)

Pada modul Data Desa Dampingan, tiap desa dapat diisi Data Kependudukan (Jumlah KK, Jumlah Penduduk, Laki-laki, Perempuan, Jumlah Pemuda) dan Status Pekerjaan per jiwa (Petani, Nelayan, Buruh/Karyawan, Wiraswasta, PNS/TNI/Polri, Pelajar/Mahasiswa, Lainnya). Kolom-kolom ini ikut dihitung ke statistik, digambar ke grafik, dan tercakup dalam semua unduhan.

12. Sinkronisasi Google Spreadsheet (Admin)

Menu ☁️ Google Sheets menghubungkan aplikasi dengan file Google Spreadsheet di Google Drive sehingga penginputan & perbaikan data otomatis tercermin di spreadsheet (dan sebaliknya).

Persiapan sekali saja: di Google Cloud Console buat Project, aktifkan Google Sheets API & Google Drive API, buat Service Account lalu unduh file JSON-nya. Bagikan spreadsheet Anda ke client_email tersebut (akses Editor).
Di menu ☁️ Google Sheets: tempel URL/ID spreadsheet + isi JSON → Simpan Pengaturan → Uji Koneksi.
Atur nama tab untuk tiap modul, centang Otomatis bila setiap simpan/perbaikan/hapus/import langsung memperbarui spreadsheet.
Gunakan ⬆ Kirim Semua (tulis data ke spreadsheet) atau ⬇ Tarik Semua (impor spreadsheet ke aplikasi, mode ganti/tambah).

💡 Kolom pada spreadsheet mengikuti header modul (hasil Kirim dari aplikasi). Data desa yang belum ada di Data Dasar Desa akan ditolak saat ditarik kembali — tambahkan desa master dahulu.

13. Tips & Tanya-Jawab

Lupa password? Admin membuka Kelola Pengguna → Ubah akun tsb → isi Password Baru.
Peta tidak menampilkan gambar dasar? Peta butuh internet untuk peta dasar (tiles); titik desa & angka tetap tampil. Di lingkungan tanpa internet, koordinat tetap bisa dikelola.
Ingin memulai data bersih? Hapus file data.sqlite di server (struktur & akun dibuat ulang otomatis), atau gunakan tombol 🗑 Hapus Semua per modul lalu import data asli.
Cadangkan data? Unduh Excel/CSV tiap modul secara berkala sebagai cadangan.
Rumus statistik semua dihitung otomatis dari tabel (total, luas hektare, jumlah jiwa, rupiah, dll).