📘 Dibuat otomatis dari USER_GUIDE.md pada 27 September 2026 — jalankan node scripts/build_userguide.js untuk memperbarui.

📘 USER GUIDE — Aplikasi Advokat (Multi Firma Advokat)

Panduan pengguna lengkap seluruh modul aplikasi: dari pendaftaran, pembuatan surat kuasa, surat lanjutan (somasi/litigasi/replik/duplik), arsip dokumen, keuangan & pajak, invoice, portal klien, hingga panel superadmin dan aplikasi mobile.

Panduan ini menjelaskan cara memakai aplikasi. Untuk instalasi & konfigurasi teknis (Docker, Google OAuth, Midtrans), lihat README.md.

📷 Screenshot tiap modul tersedia di docs/screenshots/ dan disematkan pada tiap bab di bawah.

Daftar Isi

1. Peran Pengguna & Hak Akses
2. Memulai: Pendaftaran, Login & Onboarding Firma
3. Dashboard
4. Surat Kuasa — Membuat (4 Langkah)
5. Jenis Surat — Kelola & Workflow Status
6. Edit Surat, Timeline & Tanda Tangan Basah
7. Template Poin & Generate AI
8. Data Klien
9. Arsip Dokumen (Berversi + Kerahasiaan)
10. Jadwal Sidang & Pengingat
11. Keuangan & Pajak
12. Invoice (Dua Arah)
13. Laporan
14. E-Materai (Opsional)
15. Firma & Pengaturan
16. Langganan & Tagihan (Midtrans)
17. Panel Superadmin
18. Portal Klien
19. Aplikasi Mobile (Flutter)
20. Alur Kerja Harian (Contoh Skenario)
21. Troubleshooting & FAQ

1. Peran Pengguna & Hak Akses

Aplikasi mendeteksi peran otomatis dari email yang terdaftar. Satu tombol login Google untuk semua peran.

Aturan penting:

• Data setiap firma ter-scope: klien, surat, dokumen, keuangan, dan pengaturan firma lain tidak dapat dilihat.
• Halaman inti (dashboard, surat, buat, edit, dokumen, sidang, invoice, dll.) terbuka untuk semua peran internal. Halaman manajemen dibatasi sesuai tabel di atas.
• Firma dengan langganan kedaluwarsa tetap bisa login, tetapi halaman inti diblokir ke halaman Langganan & Tagihan (kecuali superadmin).

2. Memulai: Pendaftaran, Login & Onboarding Firma

2.1 Pendaftaran baru (trial otomatis)

1. Buka landing page (mis. https://advokat.sapulidi.co.id atau domain firma Anda).
2. Klik “Coba Gratis 1 Bulan” atau pilih salah satu kartu paket.
3. Klik Masuk dengan Google dan pilih akun Google Anda.
4. Bila email Anda belum terdaftar, akun tercatat otomatis dan Anda dibawa ke langkah 2.3.

✅ Trial 30 hari langsung aktif tanpa menunggu persetujuan — dibuat otomatis saat firma dibuat. Trial hanya berlaku sekali per firma.

2.2 Login untuk pengguna lama

• Buka login.php → Masuk dengan Google.
• Peran (leader/advokat/paralegal/staff/superadmin) terdeteksi otomatis dari email.
• Email yang sudah didaftarkan tetapi menunggu persetujuan leader akan melihat pesan “menunggu persetujuan” — hubungi leader firma Anda.

2.3 Onboarding: Buat Firma (pengguna tanpa firma)

Bila Anda belum tergabung di firma mana pun, sistem membawa Anda ke halaman Buat Firma Hukum Baru dengan pesan:

🏢 “Anda belum tergabung di firma mana pun — lengkapi profil firma Anda di bawah.”

Isi form:

Klik Buat Firma → Anda otomatis menjadi leader firma + trial 30 hari aktif, lalu diarahkan ke Dashboard dengan konfirmasi:

🎉 “Firma berhasil dibuat — trial 30 hari aktif.”

2.4 Langkah pertama setelah firma jadi (checklist)

1. Firma & Pengaturan → upload logo, lengkapi profil & gaya surat (bab 15).
2. Firma & Pengaturan → tambahkan anggota (advokat/paralegal/staff) + upload scan tanda tangan advokat (bab 15.2).
3. Klien → tambahkan data klien (bab 8).
4. + Surat Kuasa (Form Lengkap) → buat surat pertama (bab 4).

3. Dashboard

Halaman pertama setelah login. Ringkasan seluruh aktivitas firma.

Isi halaman:

• Banner status langganan — sisa hari trial / peringatan kedaluwarsa + tombol perpanjang.
• 📅 Sidang Terdekat — maksimal 5 agenda terjadwal, dengan badge HARI INI / BESOK.
• ⏳ Batas Waktu Replik/Duplik — surat lanjutan yang batas waktunya mendekat.
• Kartu statistik — jumlah Surat Kuasa, Jenis Surat Lain, Klien Aktif, Arsip Dokumen, dan Pendapatan Bulan Ini.
• Grafik 30 hari terakhir — jumlah surat diterbitkan per hari (Surat Kuasa vs jenis lain).
• Perlu Tindak Lanjut — surat berstatus draf/review/proses/final yang masih menunggu.
• Komposisi Surat — proporsi per jenis surat.
• Keuangan Bulan Ini — pendapatan, biaya, akomodasi, pajak, pendapatan neto.
• Aktivitas Terbaru — 7 surat terakhir yang dibuat.
• Tombol aksi cepat: ＋ Buat Surat Kuasa (form cepat), + Surat Kuasa (Form Lengkap) (form 4 langkah), 🖨 PDF Keuangan (laporan bulan berjalan berkop firma).

Mode tampilan (diatur di Firma & Pengaturan): menu navigasi di sidebar kiri (default), topbar atas, atau keduanya. Tema terang/gelap via tombol 🌙 di kanan atas.

4. Surat Kuasa — Membuat (4 Langkah)

Buka dari menu Surat → Jenis Surat → + Surat Kuasa (Form Lengkap), atau tombol + Surat Kuasa (Form Lengkap) di Dashboard. Form dibagi 4 langkah (stepper di atas — klik untuk lompat antar langkah):

Langkah 1 — Upload KTP Pemberi Kuasa

• Klik / drag & drop foto atau scan KTP (JPG/PNG, maks 5 MB).
• Data KTP dibaca otomatis (OCR) bila server mendukung (tesseract-ind), lalu ditempelkan otomatis ke form identitas di Langkah 2.
• Bila OCR tidak tersedia, isi manual di Langkah 2 — tidak menghalangi proses.

Langkah 2 — Identitas Pemberi Kuasa

• Pilih Klien Tersimpan (opsional) — memilih klien otomatis mengisi Nama Lengkap, NIK, Tempat Lahir, Tanggal Lahir, Jenis Kelamin, Agama, dan Pekerjaan.
• Koreksi hasil OCR bila perlu. Field: Nama Lengkap *, NIK, Tempat/Tanggal Lahir, Jenis Kelamin, Agama (dropdown + “Lainnya”), Pekerjaan (dropdown + “Lainnya”), Alamat KTP.

Langkah 3 — Jenis Surat & Poin Isi (template editable)

• Kelompok 1 — 📜 Surat Kuasa (UMUM / KHUSUS / ISTIMEWA):
  • UMUM — pengurusan & administrasi luas.
  • KHUSUS — untuk 1 tugas spesifik / urusan hukum.
  • ISTIMEWA — jual beli aset / tindakan hukum berat.
• Kelompok 2–4 — 20 jenis surat lain dari master (LIHAT BAB 5): Litigasi (SKK, GGT, JWB, RPL, DPL, MB, KMB), Non-Litigasi (LO, LDD, SOM, MoU, PKS, NDA), Korespondensi (SPw, SPm, SKet, SPb, SP, SM, MEM).
• Poin Isi Surat terisi otomatis dari template sesuai jenis yang dipilih — setiap poin tetap bisa diedit, ditambah (+ Tambah Poin), atau dihapus.
• Tombol 🤖 Generate AI — membuat draf poin isi dengan Gemini (butuh API key, lihat bab 7).
• Bila poin sudah terisi lalu jenis diganti, popup konfirmasi muncul di tengah halaman: “Ganti template poin sesuai jenis ?**” — klik Ya, Ganti Template untuk memuat template baru, atau Batal untuk mempertahankan poin lama (pilihan jenis juga dikembalikan). Bila poin masih kosong, template langsung dimuat tanpa konfirmasi.
• Bila belum ada jenis yang dipilih saat menyimpan, muncul peringatan untuk memilih jenis terlebih dahulu (scroll otomatis ke Langkah 3).
• Label tombol simpan menyesuaikan pilihan: 💾 Simpan Surat Kuasa (jenis SK) atau 💾 Simpan Surat (jenis lain) — surat jenis lain tersimpan dengan nomor berkode jenisnya (mis. SOM/ASH/09/2026) dan membuka form edit surat lanjutan.

Langkah 4 — Penandatangan (Penerima Kuasa) & Format Surat

• Advokat Penanda Tangan * — centang satu atau lebih advokat (leader tercentang default). Urutan centang = urutan tanda tangan di PDF (mendukung multi-advokat: Advokat 1, Advokat 2, dst.).
• Kota Titimangsa (default: kota firma), Tanggal Surat (default: hari ini).
• Kode jenis surat otomatis (readonly), mis. UMUM, KHUSUS, SOM.
• Untuk jenis surat lain: muncul field Tujuan — Nama Pihak, Tujuan — Alamat, dan Perihal.
• Paragraf Pembuka (opsional — kosongkan untuk format baku) dan Penutup (default baku firma, dapat diubah per surat).

Klik 💾 Simpan Surat Kuasa → nomor surat dibuat otomatis dari format firma ({NO}/{KODE}/{ROMAWI_BULAN}/{TAHUN}) dan status awal draf (Drafting).

5. Jenis Surat — Kelola & Workflow Status

Menu Surat → Jenis Surat berisi dua tabel terpadu.

5.1 Tabel 1 — 📜 Surat Kuasa (UMUM / KHUSUS / ISTIMEWA)

Kolom: Nomor, Jenis, Pemberi Kuasa, Penandatangan, Tanggal, Status, Aksi. Tombol aksi per baris:

• ✏️ Edit — form edit lengkap (edit.php?id=).
• 👁 View — pratinjau HTML (preview.php?id=).
• 📄 Unduh PDF — PDF berkop siap cetak (cetak.php?id=&download=1).
• 🗑 Hapus — dengan konfirmasi.

5.2 Tabel 2 — 🗂️ Jenis Surat Lain (Litigasi · Non-Litigasi · Korespondensi)

• Filter berdasarkan jenis (dikelompokkan per klasifikasi), status, dan pencarian bebas (nomor / perihal / klien).
• Kolom: Nomor (+ tanda ✍️ bila ada scan TTD), Jenis (badge kode + nama + klasifikasi), Klien, Perihal, Tanggal, Status (workflow), Aksi.
• Tombol aksi sama seperti tabel Surat Kuasa, tetapi edit ke edit.php?id=&lanjutan=1 (bukan modal).

5.3 Master 20 Jenis Surat Lain

5.4 Workflow Status Surat

Status diubah lewat dropdown langsung di tabel atau di halaman Edit. Setiap perubahan mencatat timeline otomatis:

draf (Drafting) → review (Review Partner) → proses (Proses) → final (Final)
    → ditandatangani (Signed) → terkirim (Sent / Registered)
                    ↘ batal (Batal) — dari status mana pun

Prinsip: Drafting → Review Partner → Signed → Sent/Registered — sesuai alur persuratan firma hukum. Surat berstatus final/ditandatangani adalah kandidat e-materai (bab 14).

6. Edit Surat, Timeline & Tanda Tangan Basah

Buka dari tombol Edit di Jenis Surat (edit.php?id=..., surat lanjutan: edit.php?lanjutan=1&id=...). Halaman dibagi dua kolom:

Kolom kiri — Timeline & Status Surat

• Dropdown ubah status (draf → review → proses → final → ditandatangani → terkirim / batal).
• Riwayat lengkap setiap perubahan status + catatan + waktu + pelakunya.

Kolom kanan — Form isi surat

• Identitas pemberi kuasa, jenis & poin isi (editable), penandatangan multi-advokat (chip, urutan sesuai centang), kota/tanggal titimangsa, pembuka & penutup.
• Simpan → perubahan tercatat di audit log.

Upload scan Tanda Tangan Basah ⭐

Setelah surat dicetak PDF dan ditandatangani basah oleh klien:

1. Di halaman Edit, cari “Upload Scan Tanda Tangan Basah (PNG/JPG)”.
2. Upload hasil scan halaman tanda tangan.
3. File tersimpan ke nomor surat klien tersebut, status otomatis berubah menjadi ditandatangani (Signed) + tercatat di timeline (“Scan tanda tangan basah diupload”).

Scan TTD advokat (bukan klien) diatur per anggota di Firma & Pengaturan dan otomatis tertanam di PDF (bab 15.2).

7. Template Poin & Generate AI

7.1 Template Poin (menu 🧩 Template Poin)

• Setiap jenis surat memiliki template poin baku (global, dari master jenis) dan dapat memiliki override per firma.
• Bila firma mengubah template, surat baru memakai versi firma; template global tetap tersedia sebagai default semua firma lain.
• Edit di sini agar tidak perlu mengulang pengetikan di setiap surat.

7.2 Generate AI (Gemini)

• Tombol 🤖 Generate AI tersedia di Langkah 3 form buat surat.
• API key Gemini dikelola per firma di Firma & Pengaturan → AI (Gemini) API Keys (lihat bab 15.4). Banyak key membentuk satu pool per firma dan dipakai bergantian secara acak; statistik pemakaian/gagal tiap key terekam.
• Hasil generate menjadi draf poin isi — selalu review dan edit sebelum dipakai.

8. Data Klien

Menu Klien → Data Klien (semua peran internal; hapus hanya leader).

Menambah / mengedit klien

1. Klik + Tambah Klien (atau ✏️ pada baris klien).
2. Scan KTP (opsional) — drop foto KTP, data terbaca otomatis (OCR).
3. Isi: Nama Lengkap *, NIK, Tempat/Tanggal Lahir, Jenis Kelamin, Agama, Pekerjaan, Alamat, Telepon, Email, Catatan.
4. Portal klien — isi Email Login Portal + password agar klien dapat masuk ke Portal (bab 18). Badge kolom Portal menunjukkan ✓ portal / nonaktif.

Aksi per klien

• 📁 Dokumen — buka arsip dokumen klien tersebut.
• 📜 Buat Surat Kuasa — langsung ke form buat surat dengan klien terpilih (identitas terisi otomatis).
• 🗑 Hapus (leader saja) — dengan konfirmasi, beserta relasinya.

Gunakan kolom pencarian (nama / NIK / telepon) untuk klien yang banyak.

9. Arsip Dokumen (Berversi + Kerahasiaan)

Menu Klien → Arsip Dokumen. Digital repository dokumen klien: putusan pengadilan, somasi, litigasi, replik, duplik, dan lainnya — lengkap dengan riwayat versi (draf lama tidak hilang).

Upload dokumen

1. Pilih klien di dropdown kiri atas.
2. Klik ⬆ Upload Dokumen → isi Kategori (putusan/somasi/litigasi/replik/duplik/ lainnya), Judul, Nomor Dokumen, Keterangan, pilih file.
3. Folder penyimpanan otomatis ter-scope firma & per tanggal.

Kompresi gambar otomatis ⭐

Semua gambar yang diunggah — KTP, tanda tangan, logo, dokumen berbentuk gambar, termasuk dari aplikasi mobile — dikompresi otomatis di server:

• Foto/scan dikonversi ke JPEG (kualitas 82) dan metadata EXIF dibuang (data lokasi & perangkat ikut hilang — lebih aman dan berkas jauh lebih kecil).
• Gambar lebih dari 2048 px otomatis diperkecil; PNG diperkecil tanpa penurunan kualitas (lossless).
• PDF tidak diubah, dan bila kompresi gagal berkas asli tetap tersimpan — proses upload tidak pernah gagal karena kompresi.

Riwayat versi (version control) ⭐

• Badge v1/v2/... pada tiap baris = jumlah versi.
• Tombol ↺ Riwayat versi membuka daftar semua versi (file, ukuran, waktu, uploader, catatan).
• ＋ Upload versi baru — menambah versi; versi terbaru menjadi versi aktif.
• Pulihkan versi lama → dipulihkan sebagai versi baru (versi aktif tidak tertimpa).
• Hapus versi individual bila perlu.

Kerahasiaan dokumen ⭐

• Tombol 🔒 menandai dokumen RAHASIA (tanda 🔒 + label di tabel).
• Dokumen rahasia hanya dapat diunduh oleh leader / superadmin; peran lain melihat “🔒 akses terbatas”.
• Dokumen rahasia tidak pernah diekspos ke Portal Klien (prinsip kerahasiaan penyimpanan cloud).

10. Jadwal Sidang & Pengingat

Menu Beranda → Jadwal Sidang.

Kelola jadwal

• ＋ Tambah Sidang — isi Perkara *, Nomor Perkara, Pengadilan, Agenda, Tanggal *, Jam, Klien terkait, Status (terjadwal/selesai/ditunda/batal), Catatan.
• Kartu Terdekat menampilkan agenda mendatang dengan tombol Edit/Hapus.
• Kalender bulanan — navigasi ‹ › antar bulan; setiap tanggal menampilkan event: 🟦 Sidang · ✅ Selesai · ⏸ Ditunda · ⛔ Batal · ⏳ Batas replik/duplik (klik untuk membuka surat terkait).

Pengingat otomatis ⭐

• Pengingat sidang H-1/H-0 — notifikasi ke leader untuk sidang besok dan hari ini (idempoten, tidak dobel per hari).
• Pengingat batas waktu replik/duplik H-1 — bila surat lanjutan memiliki batas waktu.
• Jadwal sidang mendekat juga muncul sebagai widget Sidang Terdekat di Dashboard.
• Skrip cron_pengingat_sidang.php tersedia untuk eksekusi terjadwal via cron server (opsional — pengingat juga jalan otomatis saat Dashboard dibuka).

11. Keuangan & Pajak

Menu Keuangan → Transaksi & Pajak. Pilih periode (bulan/tahun) → Tampilkan.

Ringkasan & perhitungan pajak (otomatis)

• Klik “Tarif pajak & catatan kepatuhan” untuk mengubah tarif per firma: PPN %, PPh 4(2) UMK % (0,5%, PP 55/2022), PPh 4(2) profesi % (2%).
• Catatan kepatuhan tersedia di halaman (bukan nasihat pajak — sesuaikan status NPWP/PKP firma dan konsultasikan ke konsultan pajak).

Transaksi

• ＋ Tambah Transaksi — Tanggal *, Jenis (pendapatan/biaya/akomodasi) *, Kategori, Uraian, Jumlah × Kuantitas, Klien (opsional).
• Grafik pendapatan vs pengeluaran bulan berjalan.
• 🖨 PDF — laporan keuangan bulan terpilih berkop firma, siap cetak/arsip.
• Dashboard juga menampilkan ringkasan bulan berjalan + tombol 🖨 PDF Keuangan.

12. Invoice (Dua Arah)

Menu Keuangan → Invoice. Dua arah tagihan dalam satu halaman:

Kartu ringkasan di atas: Belum Lunas, Sudah Lunas, Jumlah Invoice.

Membuat invoice

1. Klik ＋ Buat Invoice (modal).
2. Penerima: pilih Klien (data terisi otomatis) atau isi manual; untuk PT → Firma, isi nama firma penerima.
3. Tanggal, Jatuh Tempo, Alamat Penerima.
4. Item Tagihan — uraian, kuantitas, satuan, harga (＋ Tambah Item untuk beberapa item).
5. PPN on/off — centang PPN (aktif/nonaktif) bila ingin kena PPN, atur tarif (default 11%); biarkan kosong untuk tanpa PPN.
6. Metode pembayaran & catatan (opsional).
7. Simpan → nomor invoice otomatis, mis. INV/F1/2026/09/0001.

Mengelola invoice

• Status via dropdown: draf → terkirim → lunas (atau batal). Terlihat sebagai badge warna.
• 📄 PDF — cetak/unduh PDF berkop firma lengkap dengan baris TERBILANG.
• 📧 Kirim ke email klien (arah Firma → Klien, non-batal) — PDF terkirim sebagai lampiran; pesan sukses/gagal tampil di halaman.
• ✏️ Edit — hanya invoice berstatus draf.
• 🗑 Hapus — hanya draf.
• Invoice langganan otomatis: setiap pembayaran Midtrans lunas otomatis membuat invoice PT → Firma berstatus lunas (idempoten — tidak dobel) + mencatat biaya langganan ke jurnal keuangan firma.

13. Laporan

Menu Beranda → Laporan & Rekap. Pilih bulan/tahun → Tampilkan.

• Rekap Surat Kuasa per Bulan (12 bulan terakhir) — kolom Umum, Khusus, Istimewa, Total, Ditandatangani, Batal.
• Daftar Surat Kuasa bulan terpilih — nomor, jenis, pemberi kuasa, penandatangan, tanggal, status.
• Daftar Klien — rekap klien firma.
• Tombol 🖨 Cetak — cetak laporan lewat dialog print browser (layout siap cetak).

Untuk laporan keuangan berkop, gunakan PDF di modul Keuangan (bab 11).

14. E-Materai (Opsional)

Menu Surat → E-Materai. Integrasi stempel elektronik — opsional.

Mode integrasi (diatur leader)

• simulasi (default) — mencatat proses stempel tanpa memanggil API (uji coba/arsip internal).
• api — untuk penggunaan nyata dengan penyedia e-materai resmi (mis. Peruri/GPRM atau mitra reseller berizin). Permintaan tercatat berstatus diajukan hingga webhook provider mengonfirmasi terstempel.

Mengajukan stempel

1. Pastikan surat berstatus final atau ditandatangani dan belum terstempel.
2. Daftar kandidat tampil otomatis di kartu Ajukan Stempel Materai.
3. Klik ajukan pada surat yang diinginkan → permintaan tercatat (alert hijau “Permintaan e-materai tercatat”).

15. Firma & Pengaturan

Menu Sistem → Firma & Pengaturan (setting.php). Semua pengaturan ter-scope firma aktif. Domain hanya dapat diubah superadmin.

15.1 Profil Firma

Nama, deskripsi kantor, alamat, telepon, email, kota, nama & gelar leader, kode dokumen (penomoran surat), footer surat (1–3 baris), dan logo (kosong = placeholder inisial firma otomatis dari nama/kode).

15.2 Anggota Firma (leader)

• Tambah anggota — email, nama, gelar, jabatan (leader/advokat/paralegal/staff), telepon. Email yang belum terdaftar otomatis dibuatkan akunnya dan bisa langsung login dengan Google.
• Edit anggota — data + upload scan tanda tangan advokat → otomatis tertanam di PDF surat yang ditandatanganinya.
• Nonaktifkan — akun tidak bisa login & tidak muncul sebagai kandidat penandatangan (datanya tetap tersimpan).
• Persetujuan permintaan akses — bila ada pendaftar menunggu, leader menyetujui sekaligus menetapkan jabatannya.

15.3 Gaya Surat & Kop (berlaku untuk preview & PDF)- Gaya kop: klasik (default — kop penuh: nama, deskripsi & alamat di tengah + garis ganda), a (hanya logo kanan atas; alamat pindah ke footer kiri), b (logo kanan atas, lalu nama, deskripsi & alamat rata kiri di bawahnya), c (logo kanan atas + nama/deskripsi di tengah; alamat di footer kiri), d (halaman polos tanpa kop).

• Ukuran kertas: A4 / F4-Folio / Letter.
• Font surat: Times New Roman / Arial(Helvetica) / Courier, ukuran 9–14 pt (default 12).
• Spasi antar baris: 1 / 1.15 (default) / 1.5.
• Margin surat resmi (cm) — default tata naskah dinas: Atas 4 (ruang kop), Kiri 4 (penjilidan), Bawah 3, Kanan 3. Rentang 1–6 cm.
• Logo kop & logo footer kustom (PNG/JPG) + garis ganda kop on/off + ukuran logo kop 10–80 mm.
• Posisi logo bisa digeser (drag) ⭐ — di kartu pratinjau kop, seret langsung logo kop maupun logo footer ke atas/bawah/kiri/kanan; saat dilepas posisi tersimpan otomatis. Untuk presisi, gunakan 4 input angka offset (mm) di baris kontrol: Kop X / Kop Y / Footer X / Footer Y (rentang −30 s.d. +30 mm; X positif = kanan, Y positif = bawah). Input dan drag tersinkron dua arah. Tombol ↺ Reset Posisi Logo mengembalikan semuanya ke posisi bawaan gaya kop. Posisi ini berlaku konsisten di pratinjau surat (HTML) dan PDF (surat kuasa, surat lanjutan, invoice, laporan keuangan), serta tersimpan per firma.
• Kompatibilitas logo: PNG hasil ekspor yang interlaced (Adam7) atau 16-bit otomatis dikonversi saat PDF dibuat — tidak perlu mengolah ulang gambar.
• Format nomor surat: template {NO}/{KODE}/{ROMAWI_BULAN}/{TAHUN} — dapat disesuaikan.
• Penutup baku surat (editable).
• Mode Tampilan (posisi menu): Sidebar kiri (default) / Topbar / Keduanya.

15.4 AI (Gemini) API Keys

• Semua user firma boleh menambah key; key diuji otomatis ke Google sebelum disimpan.
• Seluruh key membentuk satu pool per firma, dipakai bergantian acak; status aktif, label, pemilik, jumlah dipakai/gagal, dan waktu terakhir tampil di tabel.
• Scope: user hanya melihat key milik firmanya; superadmin melihat semua.
• Hapus key per item bila tidak dipakai.

15.5 Splash Screen Mobile

Leader mengelola slide show yang tampil sebelum login di aplikasi mobile: tambah slide (gambar + judul + deskripsi + durasi 2–15 detik), aktif/nonaktifkan, urutkan naik/turun, edit, dan hapus.

• Edit slide ⭐ — tombol ✏️ Edit pada kartu slide membuka form untuk mengubah judul, deskripsi, dan durasi (2–15 detik), serta mengganti foto (PNG/JPG maks 5 MB, opsional — kosongkan bila foto tetap). Foto lama otomatis dihapus dari server saat diganti, jadi tidak menumpuk.
• Perubahan langsung berlaku di aplikasi mobile — slide show dimuat ulang dari server setiap aplikasi dibuka (tanpa perlu build ulang aplikasi).

15.6 Superadmin di halaman ini

• Kartu “Firma Pengguna Sistem Ini” — daftar semua firma + statistik (anggota, klien, surat) dengan tombol pindah konteks (bekerja sebagai firma mana pun), edit dan buat firma baru.

16. Langganan & Tagihan (Midtrans)

Menu Sistem → Langganan & Tagihan. Hanya leader yang dapat membayar; semua anggota dapat melihat status.

Paket

Membeli / memperpanjang

1. Pilih paket di dropdown → 💳 Bayar Sekarang.
2. Bila kredensial Midtrans terisi → halaman Midtrans Snap terbuka (QRIS, VA, e-wallet, kartu). Bila belum → mode simulasi: pembayaran langsung dianggap lunas untuk pengujian.
3. Setelah selesai, Anda kembali otomatis; halaman mengecek status pembayaran setiap beberapa detik dan mengaktifkan langganan segera saat lunas — tanpa menunggu webhook. Tombol Cek Status tersedia untuk order pending.
4. Riwayat pembayaran (waktu, paket, jumlah, Order ID, metode, status) tampil di bawah.
5. Invoice PT → Firma dibuat otomatis saat lunas (bab 12).

Firma kedaluwarsa tetap bisa login; halaman inti diarahkan ke halaman ini. Aktivasi/perpanjangan manual oleh superadmin juga tersedia (bab 17).

17. Panel Superadmin

Menu Sistem → 🛡️ Superadmin — hanya untuk superadmin. Satu halaman kontrol sistem.

Ringkasan

Firma terdaftar · Langganan aktif · Trial dibuat · Total pendapatan (lunas).

🏛️ Firma & Langganan (Customer Handling)

Tabel seluruh firma: domain, jumlah users/klien, langganan berjalan (paket, sisa hari, tombol Stop untuk menghentikan), dan aksi:

• Beri langganan — pilih paket (trial 1 bln / bulanan / 6 / 12 bulan / unlimited) → Beri. Trial hanya boleh sekali per firma (validasi).
• 🌐 Domain — atur domain + identitas publik landing page (nama publik, tagline). Arahkan DNS A/CNAME domain ke server; aplikasi mendeteksi firma otomatis dari hostname. Kosong = domain default advokat.sapulidi.co.id.

Bagian lain

• Audit Log — jejak semua perubahan (buat/update/hapus/status/login/bayar/langganan) beserta data lama→baru, IP, user agent, pelaku, dan waktu.
• Pembayaran — daftar transaksi Midtrans seluruh firma.
• Manajemen pengguna sistem ada di menu 🔧 Pengguna; pengamatan cache AI di 🧠 Cache AI.

Menjadikan superadmin pertama

Login sekali dengan akun Google Anda, lalu jalankan SQL (lihat README):

UPDATE users SET jabatan='superadmin', firma_id=NULL WHERE email='email-anda@gmail.com';

18. Portal Klien

Portal khusus klien firma — klien login dengan email & password portal (dibuat leader di Data Klien) atau Google bila emailnya terdaftar.

Setelah login (halaman judulnya “Selamat datang, {nama klien}”), klien melihat:

1. 📜 Surat Kuasa Saya — tabel nomor, jenis, tanggal, status + tombol Unduh PDF (cetak_klien.php — hanya surat miliknya). Setiap baris punya detail “Lihat timeline”: riwayat status lengkap — dari draf → proses → final → ditandatangani → terkirim beserta catatan dan waktu, sehingga klien selalu tahu progres suratnya.
2. 📨 Surat Perkara Saya — surat lanjutan (somasi, litigasi, replik, duplik, dll.) miliknya: nomor, jenis, perihal, tanggal, status.
3. 🗂️ Dokumen Saya — dokumen non-rahasia klien (kategori putusan/somasi/litigasi/ replik/duplik/lainnya) dengan tautan unduh. Dokumen berlabel RAHASIA tidak ditampilkan di portal.

Menu portal hanya berisi 🏠 Dashboard Saya dan 🚪 Keluar — sengaja sederhana.

Keamanan: setiap permintaan memverifikasi kepemilikan data (klien_can_access_surat) — klien tidak dapat membuka surat/dokumen klien lain, dan halaman internal firma tidak dapat diakses dari portal.

19. Aplikasi Mobile (Flutter)

Aplikasi Android & iOS dengan fungsi inti yang sama dengan web. Detail teknis di mobile/README.md.

Fitur: login Google, dashboard, surat kuasa & surat lanjutan (ubah status), klien, dokumen, jadwal sidang, laporan. Data via REST api.php dengan Bearer token per perangkat (tombol logout mencabut token). Layar pembuka (splash slide show) diambil dari server dan dikelola leader dari web (bab 15.5).

Notifikasi push: portal klien & mobile menerima notifikasi (mis. konfirmasi pembayaran, pengingat batas waktu replik/duplik) — diatur dari server (FCM).

19.1 Email petunjuk otomatis saat login ditolak ⭐

Bila seseorang mencoba Masuk dengan Google di aplikasi mobile dengan email yang belum terdaftar / belum disetujui superadmin, selain pesan kesalahan di layar sistem mengirimkan email informasi & petunjuk penggunaan ke alamat tersebut (otomatis, via SMTP server):

• Isi email: alasan akses ditolak (kerahasiaan data firma), langkah pendaftaran (hubungi superadmin/pimpinan firma), petunjuk login, ringkasan fitur aplikasi, dan panduan membuat firma sendiri untuk pertama kali (bagi pendaftar yang belum tergabung di firma mana pun: buat firma → otomatis leader + trial 30 hari).
• Dipersonalisasi dengan nama firma sesuai domain yang diakses.
• Anti-spam: maksimal 1 email per alamat per 10 menit meski percobaan diulang.
• Pengiriman non-blocking — tidak memperlambat respons aplikasi.
• Bila SMTP belum dikonfigurasi di server, email dilewati diam-diam — aplikasi tetap berfungsi normal.

19.2 Optimasi performa

• Tab dashboard dimuat lazy — data tiap tab baru diambil saat pertama dibuka.
• Data dashboard & agenda diambil paralel; pencarian klien di-debounce 400 ms.
• Semua gambar yang diunggah dikompresi otomatis di server (lihat bab 9).

Instalasi singkat:

cd mobile
flutter pub get
flutter run                 # emulator Android (API: http://10.0.2.2:8080)
flutter build apk --release # rilis Android
flutter build ipa --release # rilis iOS (butuh macOS + Xcode)

Atur alamat server di lib/api.dart → ApiConfig.baseUrl dan daftarkan SHA-1/package Android + serverClientId iOS di Google Cloud Console.

20. Alur Kerja Harian (Contoh Skenario)

Skenario A — Surat Kuasa baru dari awal

1. Klien → + Tambah Klien (upload KTP → data terisi otomatis) + isi email login portal.
2. + Surat Kuasa (Form Lengkap) → Langkah 1 upload KTP (terisi otomatis) → Langkah 2 pilih klien tersimpan → Langkah 3 pilih jenis & sesuaikan poin → Langkah 4 pilih advokat penandatangan → Simpan.
3. View untuk pratinjau → Unduh PDF → cetak.
4. Klien menandatangani basah → Edit surat → upload scan TTD basah → status otomatis ditandatangani.
5. (Opsional) E-Materai → ajukan stempel untuk surat final.
6. Serahkan berkas → ubah status terkirim (Sent/Registered).

Skenario B — Somasi & tindak lanjut litigasi

1. Buat surat jenis SOM (Surat Somasi) via form lengkap — isi Tujuan (nama pihak & alamat) dan Perihal; poin baku somasi termasuk tenggat 7 hari.
2. Kirim; bila berlanjut ke pengadilan, buat GGT (Gugatan) lalu JWB (Jawaban), RPL (Replik), DPL (Duplik) sesuai tahapan — masing-masing dengan batas waktu yang tercatat.
3. Jadwal Sidang untuk setiap agenda → pengingat H-1/H-0 otomatis muncul di Dashboard.
4. Setelah putusan → upload ke Arsip Dokumen kategori putusan.

Skenario C — Penagihan & pembukuan bulanan

1. Invoice → buat invoice Firma → Klien (PPN on/off sesuai kesepakatan) → ubah status terkirim → 📧 kirim ke email klien.
2. Saat dibayar → status lunas.
3. Keuangan → catat transaksi pendapatan/biaya/akomodasi → pajak dihitung otomatis → 🖨 PDF Keuangan untuk arsip/direksi.
4. Laporan → rekap 12 bulan untuk evaluasi.

Skenario D — Klien memantau perkara

1. Klien membuka portal (email + password dari firma / Google).
2. Melihat status surat & timeline progres, mengunduh PDF surat kuasanya.
3. Memantau dokumen perkara (putusan, somasi) yang dibagikan firma — dokumen rahasia tidak tampil.

21. Troubleshooting & FAQ

Dokumen ini dibuat dari kondisi aplikasi terkini (September 2026). Bila ada fitur yang berubah, perbarui bab terkait. Panduan instalasi & konfigurasi teknis: README.md. Panduan deploy: deploy/README.md, deploy/MANUAL.md, deploy/AAPANEL.md.