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](#1-login--akses-panel)
2. [Dashboard](#2-dashboard)
3. [Manajemen Anggota](#3-manajemen-anggota)
4. [Divisi](#4-divisi)
5. [Kegiatan](#5-kegiatan)
6. [Keuangan (Kas)](#6-keuangan-kas)
7. [Iuran Anggota](#7-iuran-anggota)
8. [Voting](#8-voting)
9. [Approval](#9-approval)
10. [Audit Internal](#10-audit-internal)
11. [Konten & Blog](#11-konten--blog)
12. [Poin Anggota](#12-poin-anggota)
13. [Notifikasi](#13-notifikasi)
14. [Hak Akses per Role](#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 |