persegi/docs/USER_GUIDE.md

Panduan Penggunaan Sistem Persegi

Sistem manajemen internal Organisasi Pemuda Desa Karangdadap. Akses panel: https://persegi.nyawiji.net/admin

---

Daftar Isi

1. Login & Akses Panel
2. Dashboard
3. Manajemen Anggota
4. Divisi
5. Kegiatan
6. Keuangan (Kas)
7. Iuran Anggota
8. Voting
9. Approval
10. Audit Internal
11. Konten & Blog
12. Poin Anggota
13. Notifikasi
14. Hak Akses per Role

---

1. Login & Akses Panel

1. Buka https://persegi.nyawiji.net/admin
2. Masukkan email dan password yang diberikan pengurus
3. Klik Masuk

Hanya anggota dengan status aktif yang bisa login. Jika tidak bisa masuk, hubungi pengurus.

---

2. Dashboard

Setelah login, halaman utama menampilkan:

• Statistik — jumlah anggota aktif, kegiatan, kas masuk/keluar
• Log Aktivitas — perubahan terbaru di sistem
• Leaderboard Poin — 10 anggota dengan poin tertinggi

---

3. Manajemen Anggota

Menu: Organisasi → Anggota

Tambah Anggota Baru

1. Klik tombol Tambah Anggota
2. Isi nama, email, nomor telepon, alamat, dan divisi
3. Atur status: Aktif atau Nonaktif
4. Klik Simpan

Anggota baru otomatis mendapat role anggota dan bisa login ke panel.

Nonaktifkan Anggota

1. Buka halaman edit anggota
2. Ubah status ke Nonaktif
3. Isi alasan nonaktif
4. Klik Simpan

Anggota nonaktif tidak bisa login ke panel.

Assign Role Tambahan

Role bisa ditambahkan di field Role saat edit anggota.

• koordinator — hanya bisa di-assign oleh ketua
• Role lain (pengurus, bendahara, dll) — bisa di-assign oleh yang punya akses

---

4. Divisi

Menu: Organisasi → Divisi

• Tambah, edit, atau hapus divisi
• Setiap divisi bisa memiliki Penanggung Jawab — dipilih dari anggota dengan role pengurus

---

5. Kegiatan

Menu: Kegiatan → Kegiatan

Alur Status Kegiatan

Draft → Pending (diajukan) → Approved / Rejected

Buat Kegiatan Baru (Pengurus / Koordinator)

1. Klik Tambah Kegiatan
2. Isi judul, deskripsi, tanggal mulai & selesai
3. Isi Estimasi Budget jika ada (opsional)
4. Klik Simpan — kegiatan tersimpan sebagai Draft

Ajukan Kegiatan

1. Buka kegiatan yang sudah dibuat
2. Ubah status ke Pending
3. Klik Simpan

Ketua akan mendapat notifikasi untuk menyetujui. Jika budget ≥ Rp500.000, akan dibuat Approval otomatis. Jika budget > Rp2.000.000, akan dibuat Voting otomatis.

Setujui / Tolak Kegiatan (Ketua)

1. Buka kegiatan dengan status Pending
2. Ubah status ke Approved atau Rejected
3. Klik Simpan

Catat Kehadiran Peserta

1. Buka kegiatan yang sudah Approved
2. Buka tab Kehadiran Peserta
3. Klik Tambah Peserta → pilih anggota → atur status kehadiran
4. Anggota yang hadir otomatis mendapat +10 poin

---

6. Keuangan (Kas)

Menu: Keuangan → Transaksi

Catat Transaksi Baru (Bendahara)

1. Klik Tambah Transaksi
2. Pilih kategori, isi jumlah, keterangan, dan tanggal
3. Pilih Kegiatan Terkait jika transaksi untuk kegiatan tertentu (opsional)
4. Klik Simpan

Alur Verifikasi Otomatis

Jumlah	Alur
< Rp500.000	Bisa langsung diverifikasi
Rp500.000 – Rp2.000.000	Approval ketua diperlukan
> Rp2.000.000	Voting anggota diperlukan

Verifikasi Transaksi (Ketua)

1. Buka transaksi yang menunggu verifikasi
2. Klik tombol Verifikasi

Transaksi yang sudah diverifikasi tidak bisa diubah atau dihapus.

---

7. Iuran Anggota

Menu: Organisasi → Iuran Anggota

• Catat iuran per anggota per periode (format: YYYY-MM, contoh: 2026-04)
• Status iuran: Lunas atau Belum Lunas

---

8. Voting

Menu: Keputusan → Voting

• Voting dibuat otomatis oleh sistem saat ada transaksi atau budget kegiatan > Rp2.000.000
• Anggota bisa melihat dan memilih suara di halaman detail voting
• Voting otomatis tertutup setelah deadline

---

9. Approval

Menu: Keputusan → Approval

• Approval dibuat otomatis untuk transaksi atau budget kegiatan Rp500.000–Rp2.000.000
• Ketua bisa menyetujui atau menolak di halaman detail approval

---

10. Audit Internal

Menu: Audit → Temuan Audit

• Auditor bisa membuat temuan audit
• Pengurus terkait bisa memberikan respons terhadap temuan

---

11. Konten & Blog

Menu: Konten → Post

Buat Artikel

1. Klik Tambah Post
2. Isi judul, konten, dan slug
3. Simpan sebagai Draft atau langsung Publish

Artikel yang dipublish otomatis memberikan +5 poin ke penulis. Editor bisa me-review dan publish/unpublish artikel.

---

12. Poin Anggota

Menu: Organisasi → Poin Anggota

Poin diberikan otomatis:

Aktivitas	Poin
Hadir di kegiatan	+10
Artikel dipublish	+5

---

13. Notifikasi

Ikon lonceng di pojok kanan atas menampilkan notifikasi masuk, seperti:

• Kegiatan menunggu persetujuan
• Status kegiatan diubah
• Transaksi butuh approval/voting
• Status keanggotaan diubah

---

14. Hak Akses per Role

Role	Yang Bisa Dilakukan
super_admin	Semua akses
ketua	Approve kegiatan, verifikasi kas, lihat semua data
bendahara	Input kas & iuran
pengurus	Buat & ajukan kegiatan, lihat anggota & divisi
koordinator	Buat & kelola kegiatan milik sendiri (sebelum disetujui)
anggota	Lihat kegiatan, voting, poin, buat artikel
auditor	Lihat semua data + buat temuan audit
editor	Review & publish artikel