Files
persegi/docs/USER_GUIDE.md
T

231 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.000Rp2.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 |