Panduan Operasional: Laporan Bukti Foto Transaksi

Panduan ini menjelaskan cara menggunakan fitur Laporan Bukti Foto Transaksi untuk meninjau, mencetak, dan mengarsipkan seluruh bukti foto (Nota, Fisik Barang, Bukti Pemakaian) yang melekat pada transaksi keuangan BUMDes.

---

1. Untuk Siapa Fitur Ini?#

---

2. Cara Mengakses#

1. Buka menu Sidebar di sebelah kiri.
2. Klik Laporan Keuangan (ikon grafik batang).
3. Pilih Bukti Foto Transaksi (ikon kamera).
4. Atau langsung ketik di peramban: /dashboard/keuangan/bukti-foto

---

3. Cara Menggunakan#

Langkah 1: Pilih Filter Periode

Di bagian atas halaman, Anda akan melihat panel filter:

• Unit Usaha: Pilih unit yang ingin ditampilkan. Jika Anda adalah Manajer Unit, pilihan ini otomatis terkunci ke unit Anda (Isolasi Unit RBAC).
• Bulan: Pilih bulan transaksi.
• Tahun: Pilih tahun transaksi.

Halaman akan otomatis memuat data setelah filter diubah.

Langkah 2: Tinjau Statistik Ringkas

Empat kartu statistik di bagian atas menampilkan:

Langkah 3: Tinjau Detail Per Transaksi

Setiap transaksi ditampilkan dalam kartu terpisah berisi:

• Header: Nomor urut, tanggal, referensi, keterangan, pembuat, dan nominal.
• Lencana Status: Di pojok kanan atas terdapat tanda Lengkap (hijau) atau Kurang (merah).
• Tombol Pintasan: Jika transaksi Kurang, akan muncul tombol Lengkapi. Klik tombol ini untuk langsung menuju formulir Transaksi Jurnal dan melengkapi foto yang kurang.
• Akun Jurnal: Daftar akun debit (hijau) dan kredit (merah).
• 3 Slot Foto Interaktif:
• Nota / Kwitansi — Bukti pembayaran resmi.
• Fisik Barang / Uang — Foto fisik barang atau penyerahan kas.
• Bukti Pemakaian — Foto barang saat digunakan di lapangan.
• (Tips: Arahkan kursor ke foto untuk melihat ikon kaca pembesar, lalu klik foto untuk memperbesarnya ke layar penuh / Lightbox).
• Metadata GPS: Koordinat, alamat, waktu pengambilan foto, dan indikator deteksi anomali jarak (>25 km antar foto).

Jika slot foto kosong, akan muncul ikon abu-abu bertuliskan "Tidak ada foto".

Langkah 4: Fitur Output & Ekspor Dokumen Resmi

Modul ini menyediakan tiga kanal output terpadu di pojok kanan atas panel filter:

1. Cetak Browser Langsung (Printer)

Gunakan tombol "Cetak" untuk mencetak langsung ke printer fisik atau menyimpan via dialog peramban:

• Proteksi Anti-Blank (Preload): Sistem otomatis memuat dan melakukan decoding ke seluruh gambar di dokumen terlebih dahulu via Promise.allSettled() sebelum dialog printer dibuka. Ini memastikan foto tidak blank/kosong di browser Safari maupun Firefox.
• Pengaturan Optimal Printer:

• Ukuran kertas: A4
• Orientasi: Potret (Portrait)
• Margin: Default / Minimum
• Grafik Latar Belakang (Background Graphics): Wajib dicentang agar warna kop surat dan aksen garis hijau tercetak sempurna.

2. Ekspor Berkas PDF A4 Resmi (FileText)

Gunakan tombol "PDF" untuk mengunduh dokumen digital A4 siap kirim ke BPD dan Inspektorat:

• Ketahanan Kop Surat: Menggunakan mekanisme polling logo (waitForLogoImage) agar logo BUMDes dan data instansi terjamin muncul 100% meskipun jaringan Supabase sedang lambat.
• Paginasi & Footer Resmi SAK EP: Setiap lembar A4 secara otomatis disematkan:

• Garis pembatas hijau BUMDes (#047857) setebal 0.5pt.
• Teks resmi instansi di kiri bawah (www.bumdesbolulango.site | bolulangobumdes@gmail.com).
• Nomor halaman dinamis di kanan bawah (Halaman i / N).

• Tata Letak Konsisten: Dibatasi maksimal 2 transaksi per lembar A4 dengan pelindung break-inside-avoid agar foto nota tidak terpotong terpisah di batas lembaran.
• Tanda Tangan Tiga Pilar: Di halaman penutup, blok tanda tangan formal (Ketua BUMDes, Bendahara, Auditor) otomatis tercantum.

3. Unduh Arsip ZIP Terpadu (Package)

Gunakan tombol "Unduh ZIP" untuk mengunduh seluruh berkas foto beresolusi penuh untuk arsip digital permanen:

• Struktur Folder Rapi: Setiap transaksi memiliki foldernya masing-masing dengan format [NomorUrut]_[NomorReferensi] (contoh: 001_KTPG_20260902_003/).
• Rekapitulasi CSV: Disertakan berkas metadata.csv di dalam ZIP yang berisi tabel rekap No, Tanggal, Referensi, Keterangan, Pembuat, Total Nominal, dan Nama Folder.
• Resiliensi CDN & Signed URL: Setiap unduhan foto diproses paralel secara independen. Apabila terdapat tautan CDN/Signed URL yang telah kedaluwarsa, sistem otomatis menyisipkan berkas catatan .GAGAL_DIUNDUH.txt pada folder terkait dan memunculkan notifikasi peringatan (toast.warning) berisi jumlah foto yang perlu diperbarui.

---

4. Contoh Skenario Penggunaan#

Skenario A: Persiapan Audit Tahunan

Bendahara perlu menyiapkan lampiran bukti foto untuk diserahkan kepada tim audit.

1. Buka halaman Bukti Foto Transaksi.
2. Pilih unit dan set bulan Januari → Desember satu per satu.
3. Cetak setiap bulan, satukan menjadi satu bundel.
4. Serahkan bersama Laporan Laba Rugi, Neraca, dan BKU.

Skenario B: Pemeriksaan Mendadak Pengawas

Pengawas ingin memverifikasi apakah pengeluaran bulan ini sudah dilengkapi foto.

1. Buka halaman, filter ke bulan berjalan.
2. Periksa kartu "Tidak Lengkap" — jika angkanya > 0, ada transaksi yang perlu ditindaklanjuti.
3. Scroll ke bawah, identifikasi transaksi mana yang slot fotonya kosong.
4. Hubungi bendahara/kasir untuk melengkapi foto yang kurang.

Skenario C: Deteksi Nota Palsu / Foto Mencurigakan

Direktur melihat laporan foto dan menemukan nota yang terlihat tidak wajar.

1. Periksa metadata GPS pada foto nota — apakah lokasi sesuai dengan alamat toko?
2. Periksa timestamp — apakah waktu pengambilan foto masuk akal?
3. Bandingkan foto Nota vs Fisik Barang — apakah barang sesuai dengan nota?
4. Jika mencurigakan, tandai di modul Pusat Kontrol untuk investigasi lanjutan.

---

5. FAQ (Pertanyaan Umum)#

Q: Apakah setelah tutup buku, kita masih bisa melengkapi bukti foto di modul "Bukti Foto Transaksi"?

A: Tidak bisa secara langsung. Ketika suatu periode bulan telah resmi ditutup buku (Closed), seluruh transaksi pada periode tersebut dikunci secara permanen (Locked) oleh database trigger PostgreSQL (check_period_lock_on_journal) dan server-side guard (isPeriodLocked).

• Jika Anda mengklik tombol "✏️ Lengkapi" dan mencoba menyimpan foto, sistem akan menolak dengan pesan error: "Periode ini sudah ditutup (Locked). Jurnal tidak bisa diubah."
• Hal ini dirancang untuk menjaga integritas audit dan mencegah manipulasi bukti fisik setelah laporan keuangan disahkan.
• Solusi Prosedural:

1. Jalur A (Periode Baru Ditutup): Super Admin / Direktur / Bendahara Utama dapat membatalkan tutup buku sementara via menu Tutup Buku ➔ Batalkan Tutup Buku, lalu staf melengkapi foto, diverifikasi oleh pengawas, dan dilakukan tutup buku ulang.
2. Jalur B (Periode Telah Lampau): Database ERP dibiarkan terkunci demi menjaga angka neraca. Foto fisik dicetak dan dilampirkan pada Berita Acara Lampiran Bukti Transaksi Susulan yang ditandatangani oleh pemegang kas, direktur, dan dewan pengawas serta dicatat pada Catatan Atas Laporan Keuangan (CALK). (Panduan lengkap: Lihat SOP Pelengkapan Bukti Foto Pasca-Tutup Buku).

Q: Apakah transaksi tanpa foto juga muncul di laporan ini?

A: Ya! Semua transaksi jurnal pada periode yang dipilih akan ditampilkan, meskipun transaksi tersebut sama sekali belum memiliki foto. Ini sengaja dirancang agar auditor dapat dengan mudah menemukan transaksi mana yang fotonya masih bolong.

Q: Apakah foto dari Kas Kecil dan Pembelian juga muncul di sini?

A: Ya, terintegrasi penuh. Laporan ini mengagregasi bukti foto dari seluruh sub-modul operasional BUMDes:

1. Modul Jurnal Umum (journal_entries).
2. Modul Perbendaharaan BKK/BKM (treasury_transactions).
3. Modul Pembelian Barang / PO (purchase_transactions).
4. Modul Kas Kecil (petty_cash_vouchers).

Q: Bagaimana jika saya ingin mengunduh semua foto sekaligus?

A: Tombol Unduh ZIP di panel atas dapat digunakan untuk mengunduh seluruh berkas foto yang terkelompok per transaksi beserta berkas metadata.csv. Apabila ada tautan foto Supabase CDN yang telah kedaluwarsa (expired), sistem tidak akan membatalkan proses unduh, melainkan menyertakan file placeholder .GAGAL_DIUNDUH.txt pada folder terkait dan memunculkan notifikasi ringkasan di layar.

Q: Bagaimana cara mengekspor PDF yang sah secara administratif?

A: Klik tombol merah muda "PDF". Engine html2pdf.js akan menunggu logo kop surat instansi termuat penuh (waitForLogoImage), lalu menghasilkan berkas PDF standar A4 portrait lengkap dengan:

1. Kop Surat Resmi BUMDes (FormalReportHeader) dari identitas CMS Desa.
2. Garis Pembatas Hijau (#047857) dan identitas web resmi di setiap footer lembaran.
3. Nomor Halaman Dinamis (Halaman i / totalPages) di pojok kanan bawah.
4. Pembagian Lembaran Rapi: Maksimal 2 transaksi per lembar dengan pelindung anti-terpotong (break-inside-avoid).
5. Lembar Tanda Tangan Audit Tiga Pilar di halaman terakhir.

Q: Mengapa foto terkadang tidak muncul saat mencetak langsung via browser?

A: Pada browser Safari dan Firefox versi lawas, foto di luar viewport terkadang belum sempat didecode oleh browser saat dialog printer dipanggil. Di versi terbaru ini, tombol "Cetak" telah dipersenjatai dengan handler asinkron yang melakukan force pre-decode seluruh gambar (Promise.allSettled) sebelum membuka dialog printer sehingga foto terjamin tercetak utuh.

Q: Siapa saja yang bisa mengakses halaman ini?

A: Semua peran yang memiliki akses ke Laporan Keuangan (Super Admin, Direktur, Bendahara, Admin Keuangan, Manajer Unit, Kepala Unit, Pengawas, Pendamping Desa, Bendahara Desa). Khusus Manajer/Staf Unit, tampilan otomatis terkunci ke unit masing-masing (Isolasi Unit RBAC).

---

6. Hubungan dengan SOP Wajib 3 Foto & Dokumen Audit#

Fitur ini merupakan bagian integral dari tata kelola akuntansi dan audit BUMDes:

---

Dokumen ini menjadi pedoman bagi seluruh pengelola, pengawas, dan auditor BUMDes dalam menggunakan fitur Laporan Bukti Foto Transaksi.