Panduan Jurnal Kegiatan

Updated: Jul 2026Oleh: SystemManual Operasional

Menyiapkan Audio...

Daftar Isi

Protected View (Read Only)

Panduan Modul Jurnal Kegiatan (Activity Logs)

Modul Jurnal Kegiatan adalah sistem pelaporan harian terintegrasi yang dirancang untuk mencatat aktivitas operasional di lapangan secara real-time (seperti kunjungan kandang, perbaikan aset, operasional rutin, dll). Modul ini mengedepankan akuntabilitas dengan mewajibkan bukti foto dan penandaan lokasi otentik (GeoTagging), serta terhubung langsung dengan sistem Akuntansi Jurnal Umum.

1. Fitur Utama & Keunggulan#

A. Kamera Terintegrasi dengan GeoTagging (Anti-Manipulasi)

Sistem ini menggunakan komponen <GeoTagCamera /> khusus yang memiliki kemampuan canggih:

Akses Kamera Langsung: Mengambil foto langsung dari perangkat pengguna (HP/Laptop) tanpa mengizinkan unggah dari galeri. Hal ini meminimalisir risiko kecurangan/manipulasi laporan foto.
Ekstraksi GPS Presisi: Sistem menggunakan antarmuka navigator.geolocation bawaan browser untuk menangkap titik Latitude dan Longitude secara akurat saat tombol shutter ditekan.
Watermark Geospasial: Foto yang diambil akan secara otomatis dibubuhi watermark yang berisi nama institusi (BUMDes), tanggal/waktu spesifik, serta koordinat GPS sebelum dikirim.
Auto-Kompresi Pintar: Setiap foto akan dikompresi secara otomatis pada client-side (browser) menggunakan kanvas HTML5 hingga ukuran file-nya berada di bawah 512KB. Ini menghemat biaya storage Supabase dan mempercepat waktu upload.

B. Konteks Unit Kerja Berjenjang (Holding-Level Access)

Sistem ini terhubung langsung dengan Unit Context Switcher ERP BUMDes:

Staf/Karyawan: Otomatis diarahkan untuk membuat laporan pada unit tempat mereka ditugaskan.
Super Admin / Direktur (Level Holding): Diwajibkan memilih Konteks Kerja (Unit Usaha) di menu navigasi atas sebelum dapat mengisi jurnal kegiatan.

C. AI Receipt Scanner (Optical Character Recognition)

Integrasi kecerdasan buatan (AI) untuk membaca nota pengeluaran (receipt). Ketika staf mengunggah foto nota bensin atau material, AI Tesseract.js (berjalan 100% lokal di browser tanpa server eksternal) akan otomatis membaca nominal angka di dalam struk dan mengisinya ke kolom klaim biaya secara presisi. Hal ini menghemat waktu input dan meminimalisir kesalahan pengetikan (human error).

2. Integrasi Keuangan & Persetujuan (Otomatisasi Akuntansi)#

Modul Jurnal Kegiatan tidak hanya berfungsi sebagai catatan aktivitas, tetapi juga terhubung langsung dengan Buku Besar Keuangan (Jurnal Umum) BUMDes. Setiap Jurnal Kegiatan yang mencantumkan "Nominal Klaim Biaya" (Expense Amount) memicu alur klaim pengeluaran otomatis:

Alur Kerja (Workflow):

Pembuatan Log: Staf lapangan mengisi deskripsi kegiatan, mengambil foto geotag (misal: nota bensin), dan memasukkan nominal pengeluaran (misal: Rp50.000).
Antrean Verifikasi: Laporan tersebut masuk ke beranda dengan status PENDING (warna kuning).
Validasi & Komunikasi Manajer: Manajer/Direktur dapat langsung menyetujui, menolak, atau mengklik tombol cerdas "💬 Hubungi via WhatsApp". Tombol ini akan otomatis memanggil nomor WA staf yang bersangkutan lengkap dengan format draft pesan.
Pemilihan Chart of Accounts (CoA): Manajer memilih Sumber Dana (Kredit) (akun Kas/Bank) dan Pos Biaya (Debit) (akun Beban).
Pembukuan Otomatis: Setelah disetujui, status log berubah menjadi APPROVED (hijau), dan sistem mengeksekusi fungsi Double-Entry untuk menyimpan transaksi secara berimbang ke tabel journal_entries dan journal_line_items.

3. Pemetaan Geospasial & Analisis Waktu (Peta Operasional Google Maps)#

Halaman Jurnal Kegiatan memiliki dua mode tampilan untuk memudahkan monitoring operasional jarak jauh:

A. Mode Daftar (List View)

Menampilkan laporan dalam bentuk kartu-kartu visual dengan animasi mulus (staggered fade-in).

B. Mode Peta (Map View)

Kita menggunakan teknologi Google Maps API (@vis.gl/react-google-maps) bertaraf Enterprise untuk merender seluruh pergerakan staf:

Auto-Fit Bounds (MapUpdater): Komponen <MapUpdater /> akan secara cerdas menghitung titik tengah (centroid) dari seluruh titik koordinat, lalu melakukan transisi kamera otomatis.
Validasi In-Map: Manajer dapat mengklik Pin peta kustom untuk memunculkan InfoWindow Google Maps, tempat aksi manajerial (melihat foto, menyetujui) dapat dilakukan.
Analitik Spasial Lanjutan (Heatmap): Terdapat fitur toggle melayang (sakelar UI) untuk memunculkan lapisan visualisasi Heatmap (Peta Panas). Membantu mendeteksi konsentrasi area dengan aktivitas atau pengeluaran tertinggi.

C. Filter Rentang Waktu Historis (Time-Machine)

Panel navigasi kalender berbasis URL Parameters tingkat lanjut yang memungkinkan manajer untuk memfilter data pada bulan atau minggu tertentu, memfasilitasi audit historis pergerakan staf dari bulan ke bulan. Filter ini juga secara otomatis menyinkronkan data di Heatmap.

4. Ekspor Laporan Formal (PDF Siap Cetak)#

Sistem ini dilengkapi dengan generator otomatis yang dapat menyusun puluhan laporan harian menjadi satu dokumen A4 terstruktur dan siap cetak melalui fitur Native Browser Print.

Dokumen ini lengkap dengan Kop Surat Otomatis dari profil instansi BUMDes.
Menggunakan pendekatan Tabel Rekapitulasi Klasik yang dirancang khusus untuk kertas.
Terdapat Penghitungan Rekap Biaya total pengeluaran di rentang tanggal terkait, beserta kolom Tanda Tangan Pengesahan untuk keperluan audit akhir bulan.

5. Struktur Database & Keamanan (RLS)#

Modul ini beroperasi dengan dua tabel utama di skema public Supabase:

activity_categories: Master data untuk klasifikasi kegiatan operasional.
activity_logs: Tabel utama yang menyimpan teks deskripsi, koordinat gps_lat/gps_lng, nilai pengeluaran, status persetujuan, hingga foreign key journal_entry_id.

Aturan Privasi dan Keamanan (Row Level Security / RLS)

Pembuatan Laporan (Insert): Hanya pengguna otentik yang dapat menyimpan laporan.
Akses Baca (Select): Karyawan biasa hanya diberikan izin membaca jurnal di Unit Usaha mereka sendiri. Direktur/Super Admin memiliki akses tak terbatas ke seluruh lini anak usaha holding.
Storage Policy: File gambar hasil kompresi diunggah dan diamankan dalam bucket Supabase Storage bernama activity-photos.

6. Roadmap & Rencana Pengembangan Masa Depan (Fase Lanjutan)#

Berikut adalah peta jalan (roadmap) pengembangan yang dapat dieksplorasi di masa depan:

📴 Mode Luring (Offline First & PWA Sync)

Membekali aplikasi dengan kemampuan penyimpanan lokal (IndexedDB) agar staf di area pelosok tanpa sinyal internet tetap dapat mengambil foto GeoTag dan mengetik laporan, untuk di-sinkronisasi kemudian.

💬 Kolaborasi In-App (Sistem Komentar & Diskusi)

Mengaktifkan alur komunikasi dua arah tepat di dalam kartu jurnal, memberikan alternatif selain "Hubungi via WhatsApp".

🎨 Voice-to-Text & Mode Malam Geospasial

Membekali staf lapangan dengan ikon mikrofon agar mereka bisa mendiktekan laporan. Selain itu, menyajikan opsi bagi Peta untuk beradaptasi dengan Dark Mode sistem agar tak menyilaukan mata saat monitoring malam hari.

Dokumen ini terakhir diperbarui pada: Juli 2026 - ERP BUMDes (Selesainya Fase 4)

Kembali ke Daftar Panduan