# Panduan admin Al-Habibah

## Akses dan peran

Pemilik dapat mengelola seluruh fitur. Keuangan dapat memeriksa donasi, mencatat keuangan, menerbitkan laporan, dan melakukan rekonsiliasi. Editor dapat mengubah konten, program, galeri publik, dan progres. Editor tidak dapat membuka bukti transfer, memverifikasi dana, atau mengganti rekening, termasuk melalui API.

Masuk melalui akun ChatGPT yang diizinkan. Pemilik dan keuangan wajib menyelesaikan authenticator. Kode yang sama tidak bisa dipakai kembali. Jika tindakan meminta autentikasi ulang, buka **Keamanan akun**, masukkan kode baru, lalu kembali dalam lima menit.

Saat authenticator hilang, gunakan kode pemulihan yang belum dipakai untuk login. Login pemulihan tidak otomatis mengizinkan tindakan sensitif. Gunakan kode pemulihan berbeda pada verifikasi ulang untuk mengganti authenticator. Kode baru menggantikan seluruh kode pemulihan lama. Jika seluruh faktor hilang, hubungi operator yang dapat memverifikasi identitas pemilik; tidak ada formulir publik untuk mengambil alih akun. Setiap pemulihan operator harus mencatat alasan dan membatalkan sesi lama.

## Mengubah beranda dan profil

Buka **Konten → Ubah konten situs**. Isi judul/deskripsi hero, label, kartu kampanye, judul bagian/halaman, ajakan penutup, tombol, cerita, profil, visi, pengurus yang sudah dikonfirmasi, alamat, WhatsApp dengan kode negara, dokumen, footer, dan SEO. Foto hero, logo, dan proposal dipilih dari Galeri publik.

Gunakan tombol atas/bawah untuk mengatur urutan bagian beranda. Isi ringkasan perubahan. Pilih **Preview**, kemudian **Simpan draft** atau **Terbitkan**. Draft baru tidak muncul di publik. Jika konten sebelumnya sudah terbit, versi publik sebelumnya tetap tampil sampai penerbitan berikutnya.

Jangan mengisi akreditasi, jumlah siswa, legalitas, nama pengurus, atau lokasi peta tanpa konfirmasi. Tidak ada klaim tersebut dalam konten awal.

FAQ dikelola dari daftar **Pertanyaan & jawaban**. Periksa jawaban FAQ ketika kebijakan atau waktu verifikasi berubah.

## Program dan anggaran

Buka **Program**, pilih **Ubah** atau **Tambah**. Target memakai angka rupiah tanpa desimal. Jumlah rincian anggaran harus tepat sama dengan target. Untuk penyelesaian bangunan, rincian Rp45.030.000 dan Rp25.200.000 sudah membentuk subtotal Rp70.230.000; jangan menambahkan subtotal sebagai rincian ketiga.

Isi manfaat, deskripsi, ilustrasi kontribusi, kebijakan penyaluran, sampul, galeri, urutan, dan status menerima donasi. Program yang pernah menerima donasi diarsipkan, bukan dihapus. Riwayat transaksi tetap tersimpan. Program yang diarsipkan tidak menerima donasi baru.

## Mengunggah gambar dan dokumen

Buka **Galeri**. Pilih beberapa file, akses publik/privat, keterangan, dan alt text. JPG/PNG/PDF maksimal 5 MB; MP4 maksimal 25 MB. Jenis dan tanda tangan file diperiksa oleh server. Unggah gambar berukuran wajar untuk pemuatan cepat.

Gunakan foto dokumentasi asli. Jangan memakai stok atau gambar AI sebagai bukti pembangunan. Pilih **Privat** untuk nota internal dan dokumen bank. Bukti yang diunggah donatur selalu privat.

Sesudah upload, pilih foto dari editor program/progres/hero. Atur urutan dengan tombol naik/turun. Melepaskan foto dari galeri konten tidak menghapus berkas yang masih dirujuk oleh versi sebelumnya. Ganti foto dengan unggahan baru agar versi lama tetap utuh. Preview file tersedia dari kartu Galeri.

## Menerbitkan progres

Buka **Progres → Tambah**. Isi tanggal kegiatan, program, judul, uraian, dan galeri. Persentase fisik boleh kosong. Jika diisi, wajib 0–100 serta memiliki dasar penilaian pengelola. Persentase fisik terpisah dari pencapaian dana.

Pilih foto sebelum/sesudah jika memang tersedia. Simpan draft, gunakan Preview, lalu Terbitkan. Tanggal publikasi dicatat server, berbeda dari tanggal kegiatan.

## Memeriksa dan memverifikasi donasi

1. Buka **Donasi**, cari nama/nomor/nominal atau filter status.
2. Tekan **Periksa**. Bukti dan kontak pada dialog hanya terlihat bagi keuangan/pemilik.
3. Impor mutasi melalui **Rekonsiliasi bank** terlebih dahulu, atau masukkan mutasi manual.
4. Cocokkan bank berdasarkan sumber dana, waktu, referensi, bukti, dan peruntukan. Nominal sama saja tidak cukup.
5. Isi alasan, centang hasil pemeriksaan, lalu **Cocokkan penerimaan**. Penerimaan parsial dapat dicocokkan melalui dialog rekonsiliasi; verifikasi menunggu total alokasi lengkap.
6. Setelah alokasi sesuai nominal, pilih **Verifikasi donasi**. Hanya saat ini penerimaan bertambah dan bukti penerimaan diterbitkan.
7. Jika belum sesuai, pilih **Tolak dengan alasan**. Donatur dapat mengirim bukti yang diperbaiki.

Permintaan kedaluwarsa yang ternyata dibayar tetap memerlukan pemeriksaan bank. File bukti, tombol “Saya Sudah Transfer”, dan halaman instruksi tidak menandakan sukses.

Verifikasi berulang tidak menggandakan penerimaan. Transaksi terverifikasi terkunci. Jangan mengubah nominal atau tujuan secara diam-diam. Koreksi melalui buku keuangan dengan rujukan catatan dan alasan.

Penerimaan offline dibuat melalui **Penerimaan offline**. Ini menghasilkan status menunggu verifikasi. Hubungkan ke bank yang benar sebelum verifikasi. Jangan membuat donasi offline kedua untuk penerimaan yang sudah memiliki permintaan website.

## Pengeluaran, biaya, refund, dan alokasi

Buka **Laporan & keuangan → Catat penggunaan / koreksi**. Pilih jenis, nominal, tanggal, program/kelompok dana, kategori, uraian, dan dokumen privat bila tersedia.

Penerimaan, pengeluaran, biaya, refund, dan pembalikan adalah jenis terpisah. Koreksi biaya/pengeluaran memilih catatan awal. Refund/pembalikan memilih donasi awal. Nilainya tidak boleh melampaui catatan yang dikoreksi. Server menolak penggunaan dana di atas saldo kelompok dana.

Alokasi dana hanya dapat berasal dari **Dana prioritas** ke program. Alokasi tidak menghasilkan penerimaan baru. Dana terikat program tidak dapat dipindahkan ke program lain melalui alokasi ini. Penanganan perubahan peruntukan memerlukan dasar dan persetujuan yang dijelaskan pengelola.

## Menerbitkan laporan

Buka **Laporan & keuangan → Laporan publik → Tambah**. Isi judul, periode, cakupan, ringkasan penggunaan, dan PDF publik yang telah disetujui. Angka laporan diambil dari buku keuangan saat diterbitkan dan disimpan sebagai snapshot persetujuan.

Unggah PDF yang telah menghapus kontak donatur, rekening pengirim, bukti transfer mentah, dan nota internal. Preview sebelum Terbitkan. PDF belum tersedia bila belum diunggah; situs tidak menghasilkan dokumen palsu.

Halaman publik menjelaskan bahwa penerimaan bruto. Saldo = saldo awal + penerimaan − pengeluaran − biaya − refund + alokasi masuk − alokasi keluar. Cakupan seluruh kampanye meniadakan dampak bersih alokasi antar kelompok dana.

## Memulihkan versi konten

Buka **Riwayat versi**, pilih konten, lalu **Bandingkan**. Periksa waktu, pelaku, ringkasan, dan status. Gunakan Preview versi lama. **Pulihkan sebagai draft baru** memerlukan alasan dan menghasilkan versi baru. Buka editor, periksa, lalu terbitkan jika disetujui.

Pemulihan konten tidak mengubah pembayaran, saldo, atau rekening. Jika dua admin menyimpan dari revisi yang sama, penyimpanan kedua ditolak sebagai konflik. Muat ulang, periksa versi terbaru, dan gabungkan perubahan yang masih diperlukan.

## Rekonsiliasi rekening

Pilih CSV berheader. Petakan tanggal, kredit, debit, uraian, dan referensi. Tanggal memakai YYYY-MM-DD dan uang berupa integer tanpa tanda pemisah. Isi rentang tanggal, tekan Preview, periksa baris, lalu konfirmasi impor.

Referensi bank yang andal dan sudah diimpor tidak ditambahkan ulang. Tanpa referensi, baris yang serupa ditandai sebagai kandidat duplikat. Periksa kandidat, jangan membuang transaksi sah hanya karena nominal dan tanggalnya sama. Baris duplikat yang benar dapat dikeluarkan dari cakupan dengan alasan; transaksi beralokasi tidak dapat dikeluarkan dari cakupan diam-diam.

Gunakan antrean **Belum teridentifikasi**, **Parsial / berlebih**, dan **Dugaan duplikat**. Pilih kredit, donasi, jumlah, alasan, dan konfirmasi sumber. Jumlah alokasi tidak boleh melampaui kredit yang tersedia atau nominal donasi. Pencocokan ulang tidak menggandakan penerimaan.

Saran urutan donasi berdasarkan kedekatan nominal hanya membantu pencarian. Sistem tidak memverifikasi otomatis. Transaksi bank yang tersisa perlu diperiksa. Dana berlebih tidak dialihkan otomatis.

Tekan **Bandingkan periode** untuk membandingkan penerimaan situs dengan kredit yang dialokasikan. Situs memakai tanggal verifikasi, bank memakai tanggal mutasi; perbedaan waktu dapat menjelaskan selisih. Ini bukan perbandingan saldo kampanye dengan seluruh saldo rekening yayasan. Kredit non-donasi ditandai di luar cakupan.

## Backup dan pemulihan

Menu ini khusus pemilik. Periksa indikator aktif, waktu harian WIB, masa simpan, riwayat, dan backup terakhir berhasil. Mengubah jadwal di dashboard tidak mengaktifkan layanan yang belum dipasang. Kegagalan terlihat pada riwayat. Notifikasi eksternal baru aktif setelah dikonfigurasi operator.

Autentikasi ulang diperlukan sebelum backup manual atau pemulihan. **Periksa pemulihan** menampilkan cakupan, jumlah file/baris, dan transaksi setelah backup. Pemulihan dashboard menambahkan data/file yang hilang dan mempertahankan data aktif. Tulis alasan, ketik PULIHKAN DATA, lalu lakukan pemulihan. Kondisi saat ini dicadangkan terlebih dahulu; jika file sudah hilang, checkpoint mencatat ketidaklengkapannya secara jelas.

Pemulihan penuh database dilakukan di lingkungan terpisah sesuai panduan teknis. Rekonsiliasi transaksi setelah waktu backup wajib dilakukan sebelum rilis produksi. Kunci, backup, bukti transfer, dan data donor tidak boleh dibagikan sebagai file publik.

### Riwayat rekening
Instruksi transfer tersimpan pada setiap transaksi ketika dibuat. Pergantian rekening aktif hanya berlaku untuk donasi baru. Dalam rekonsiliasi, pilih rekening asal mutasi. Referensi bank yang sama pada dua rekening berbeda tetap merupakan dua data terpisah. Untuk mengonfirmasi rekening lama setelah pemulihan, isi rekening tersebut dan nonaktifkan pilihan “Gunakan sebagai rekening aktif”; pemeriksaan dokumen dan autentikasi ulang tetap wajib.
