# Arsip Dokumen — Panduan Pemasangan

Aplikasi arsip PDF hasil scan **invoice (NP…/RNP…)** dan **surat jalan (SJ…)** untuk dua perusahaan (PT CMP, PT KAL),
dicocokkan dengan ekspor Excel Odoo, dan dikirim ke pelanggan lewat Email / WhatsApp.
Arsitektur sama dengan Invoice Renamer: PHP di hosting cPanel + `storage_api.php` di server IIS kantor.

## 1. Hosting (cPanel)

1. Unggah isi folder ini ke document root subdomain (mis. `~/arsip`), atau ke `~/arsip` lalu arahkan subdomain ke `~/arsip/public`.
   Struktur: `public/` (web root), `src/`, `config/`, `tools/`, `vendor/`.
2. **Database**: cPanel › MySQL Databases → buat database + user (hak ALL PRIVILEGES). Paket rilis TIDAK membawa konfigurasi nyata: salin `config/database.contoh.php` menjadi `config/database.php` lalu isi nilai sah (lewat kanal aman, jangan lewat chat/email). Pemasangan pertama memakai paket PENUH (`arsip_v…zip`); pembaruan memakai `update_v…zip` dengan `unzip -o … -x 'config/*'`.
3. **Tabel + akun Super Admin** — pilih salah satu cara:
   - **A. phpMyAdmin**: pilih database → Import → `database/arsip_dokumen.sql`. Sudah berisi 16 tabel, perusahaan CMP/KAL,
     dan Super Admin **myluxton@gmail.com / `Arsip@2026`**.
   - ~~B. Browser (`setup.php`)~~ **dinonaktifkan sejak 5.102 (PT-REV-020)**: `public/setup.php` kini hanya halaman penjelasan (410), tidak memasang tabel dan tidak membuat akun. Pakai cara A atau C.
   - **C. Terminal cPanel**: `php tools/migrate.php` (juga membuat Super Admin bawaan bila tabel users kosong), lalu
     `php tools/buat_superadmin.php "NAMA" email@domain.com PasswordBaru` untuk akun/password sendiri.
   Ganti password awal lewat menu **Profil** (klik nama di sidebar).
4. Salin `config/mailer.contoh.php` menjadi `config/mailer.php` dan isi (SMTP cPanel, `app_url` = alamat aplikasi) atau lewat Setting › Mailer. Jalankan `php tools/preflight_rilis.php` (hanya membaca: memeriksa PHP, ekstensi, konfigurasi terisi, folder runtime, dan — dengan `--manifest` — sha256 tiap berkas terhadap `docs/rilis/MANIFEST.json`) dan `php tools/selfcheck.php` bila ada terminal. Berkas yang tidak boleh ditimpa saat deploy tercantum di `docs/rilis/DILINDUNGI.txt`; langkah deploy lengkap di `docs/rilis/README_DEPLOY.md`.
5. Pendaftar berikutnya lewat halaman **Daftar**: aktivasi email → Super Admin memberi role (User / Supervisor / Super Admin) dan akses perusahaan.
6. Master Perusahaan: seed awal `CMP` (prefix `02`, nomor `NP02…`/`SJ02…`) dan `KAL` (prefix `01`, nomor `NP01…`/`SJ01…`).
   Prefix ini dipakai untuk menolak baris Excel milik perusahaan lain, dan memindahkan otomatis scan yang salah folder (NP01 di folder CMP → folder masuk KAL).

## 2. Server IIS kantor

1. Salin `tools/storage_api.php` ke folder web IIS **terpisah** dari milik Renamer, mis. `C:\inetpub\wwwroot\arsip\storage_api.php`.
   Beri hak **Modify** untuk `IIS_IUSRS` pada folder itu (untuk `storage_config.json`) dan pada folder arsip (mis. `D:\Arsip`).
2. Di browser **di server itu**, buka `http://localhost/arsip/storage_api.php?op=ping` → catat `pairing_code`.
3. Di aplikasi: Setting › Share Folder → pilih **Server kantor**, isi URL publik `storage_api.php`, folder dasar (mis. `D:\Arsip`),
   tempel kode pemasangan → **PASANGKAN**. Lalu **UJI KONEKSI**.
4. Di tabel *Folder per Perusahaan* isi:
   - **Folder database Excel**: `D:\database\ptcmp` dan `D:\database\ptkal` (tempat Anda menaruh ekspor Odoo).
   - **Folder scan** (opsional): folder tujuan scanner. Kosong = `D:\Arsip\{KODE}\masuk`.
   Subfolder `invoice`, `surat_jalan`, `lain` dibuat otomatis.
5. Arahkan scanner ke folder scan tiap perusahaan. Jika scanner punya opsi **"searchable PDF / OCR"**, aktifkan — nomor akan terbaca dari teks tanpa OCR tambahan.

### OCR (hanya bila scan berupa gambar murni)
Pasang di server IIS: **Tesseract** (UB-Mannheim installer → `C:\Program Files\Tesseract-OCR\tesseract.exe`) dan
**Poppler for Windows** (`pdftoppm.exe`, `pdftotext.exe` → `C:\poppler\Library\bin`). Lokasi lain bisa diisi di `storage_config.json` → `tools`.
Setelah itu centang **"Gunakan OCR"** di halaman Pindai Scan.

## 3. Alur harian

1. **Import Data**: taruh ekspor Odoo (`res.partner.xlsx`, `product.template.xlsx`, `account.invoice.xlsx`,
   `account.invoice.line.xlsx`, `stock.picking.xlsx`) di folder database perusahaan → Import Data → **Import semua yang dikenali**
   (atau otomatis lewat cron). Baris yang sudah ada dibandingkan kolom per kolom; hanya yang berbeda ditulis.
   Mode (Setting › Sistem): **Sinkron penuh** (bawaan) — Odoo sumber kebenaran, semua kolom yang berbeda ditimpa;
   **Lewati** — hanya Status / tanggal bayar / jatuh tempo. Kontak pelanggan yang diisi manual tidak ditimpa nilai kosong.
   Setiap perubahan tercatat: Riwayat Import → klik angka *diperbarui*. Nomor berprefix perusahaan lain ditolak.
   Bila kode pelanggan / tanggal invoice berubah setelah PDF diarsipkan, halaman **Dokumen** menampilkan peringatan
   "arsip perlu di-rename ulang" dengan tombol rename ulang (otorisasi).
2. **Pindai Scan**: satu scan = satu paket (nota halaman 1 + SJ + resi + PO). Nomor nota dibaca (nama file → teks PDF → OCR),
   dicocokkan dengan data, di-rename menjadi `DOK_PTCMP_2026-09-15_NP022602186_KODEPEL_NAMA PELANGGAN_KODESALES.pdf` (kode sales = Salesperson Odoo pada invoice, atau master pelanggan) dan dipindah ke `{KODE}\invoice`
   (SJ tunggal ke `surat_jalan`). Nomor SO/SJ lain yang ikut terbaca dicatat sebagai *nomor terkait* sehingga bisa dicari. Yang gagal: **Tetapkan manual**.
   File "tanpa data" (nomor terbaca tapi belum ada di Excel) otomatis dicocokkan ulang setelah import berikutnya.
   Judul di dalam PDF (yang tampil di tab browser) ikut ditulis ulang menjadi `NOMOR - NAMA PELANGGAN (tanggal)`; untuk arsip lama pakai tombol **Perbaiki judul PDF**.
   Setelah format nama berubah (mis. v1.6 menambah kode sales), halaman Dokumen menampilkan daftar arsip yang namanya belum sesuai → **Rename ulang semua** merapikan file di server + database + judul PDF sekaligus.
3. **Kirim Dokumen**: cari invoice/SJ → centang → Email atau WhatsApp (lampiran, atau tautan unduh bila paket WA teks-saja).
   Promosi (Master Data › Promosi) punya **judul** dan **isi** (sejak v5.008k): di pesan email dan WhatsApp keduanya ikut (judul tebal di WhatsApp), di Buku Ekspedisi hanya **judul**.
   Sejak v5.008g, di bawah pesan **otomatis** ditambahkan *Nomor Rekening Perusahaan* (bank, nomor, nama rekening — semua rekening aktif, yang utama dulu) dan *No. Whatsapp Penagihan*: pita ungu rata tengah di kaki email (serupa kepala email), teks di WhatsApp (hanya di pesan utama, termasuk mode tautan). Datanya dari Master Data › Perusahaan › Rekening Bank dan kolom WhatsApp perusahaan; **keduanya wajib terisi** — bila belum, jendela kirim menampilkan peringatan dan pengiriman ditolak sampai dilengkapi.
4. **Divisi** (Setting › User, hanya untuk role USER): *Sales Support* dan *Finance*. Menu yang boleh dibuka tiap divisi diatur
   di Setting › Permission › *Menu per Divisi* (bawaan: Sales Support = Dashboard, Dokumen, Pindai; Finance = Dashboard, Dokumen, Kirim, Data).
   USER tanpa divisi = semua menu operasional. Supervisor / Super Admin tidak dibatasi.
5. **Otorisasi**: setiap perubahan oleh role **USER** (import, pindai, tetapkan, hapus, kirim, ubah data) memunculkan popup
   password Supervisor / Super Admin; semua tercatat di Setting › Permission › Log Otorisasi.

6. **Keamanan & Privasi** (menu sendiri, Super Admin, v1.7) — enam halaman:
   - **Akses IP**: whitelist alamat IP (lihat di bawah).
   - **Jam Kerja**: saklar + jadwal per hari + hari libur. Di luar jam, role USER ditolak login dan sesi yang terbuka diputus (≤20 detik);
     Supervisor/Super Admin bebas. **Izin lembur**: pilih user + sampai jam berapa.
   - **Login & Password**: kunci sementara setelah N kali salah (email admin), suspend setelah M kali, notifikasi email login dari
     perangkat baru, panjang minimal & umur password, wajib ganti (akun berpassword bawaan otomatis), **OTP email** (mati / admin / semua)
     dengan "ingat perangkat" N hari. Halaman `password.php` dan `otp.php` dipakai otomatis saat login.
   - **Sesi & Perangkat**: satu sesi per user, sesi terikat IP+browser, keluarkan sesi per user / semua; daftar perangkat yang pernah
     login; **perangkat disetujui** boleh melewati whitelist IP (karyawan ber-IP dinamis meminta dari halaman 403 → email admin → setujui).
   - **Server & Data**: kunci storage_api ke IP hosting (`allow_ip`, butuh storage_api ≥ 4.2), peringatan bila URL bukan HTTPS,
     umur & batas buka tautan pelanggan, peringatan email bila unduh/hapus massal, suspend akun tidur (cron `--keamanan`), header keamanan HTTP.
   - **Log Keamanan**: semua peristiwa keamanan dengan filter jenis & pencarian.
   Akses IP: whitelist alamat IP. Urutan aman: buka halaman → klik **Daftarkan IP saya**
   (atau tambah IP/CIDR kantor, mis. `36.68.10.0/24`, wildcard `36.68.*.*`, rentang `a-b`) → geser saklar **Aktif**. Setelah aktif, login,
   semua halaman dan API hanya bisa dibuka dari IP terdaftar; tautan unduh pelanggan (`share.php`) tetap terbuka. Percobaan yang ditolak
   tercatat (IP, jumlah, URL) dengan tombol **Izinkan**; halaman 403 menampilkan IP pengunjung. Terkunci? `php tools/ip_whitelist.php --off`.
   Bila IP kantor dinamis (berubah tiap modem restart), daftarkan blok ISP (CIDR) atau minta IP statis ke ISP.

7. **Penagihan** (menu sendiri; divisi Finance bawaan, v2.0): piutang dari invoice **Open** hasil import Odoo.
   - *Ringkasan*: total, lewat tempo, jatuh tempo 7 hari, umur piutang, per sales, per pelanggan (SOA PDF, kirim SOA, kecualikan).
   - *Pengingat hari ini*: antrean sesuai jadwal (bawaan H-3, H+1, H+7, H+14), satu pesan per pelanggan + PDF invoice.
     Alur harian: **import invoice dulu** (cron atau manual) → buka tab Pengingat → centang → **Kirim** (otorisasi untuk USER).
     Bila invoice belum diimport hari ini, pengiriman ditahan (bisa dipaksa). Cron `--tagih` hanya mengirim email ringkasan ke admin/finance.
   - *Pengaturan* (Supervisor): jadwal, kanal, template WA/Email dengan variabel `{nama} {perusahaan} {tahap} {daftar} {total} {jumlah} {pengirim} {sales}`.
8. **Pencarian isi dokumen** (v2.0): teks OCR/PDF disimpan saat pindai; untuk arsip lama klik **Indeks isi** di halaman Dokumen (Supervisor; OCR di server kantor, bertahap).
   Centang *di isi dokumen* pada kotak Cari untuk mencari nomor PO, nama barang, nomor resi. Berkas yang isinya sama persis dengan arsip ditahan sebagai **DUPLIKAT** di antrean pindai.
9. **Unggah dari HP** (`/unggah.php`, tombol di Pindai Scan): foto nota dengan kamera → otomatis PDF → folder masuk → dipindai. Di Chrome Android: ⋮ → *Tambahkan ke layar utama*.

10. **Buku Ekspedisi** (v2.1; menu untuk divisi Sales Support & Finance): pengganti buku serah terima nota asli.
    Alur: Sales Support buka rentang tanggal nota → **Catat semua** (centang SS otomatis dari data: Nota Asli, Cash Netto bila termin 7 hari,
    SKPD/RKIP bila kode faktur 07, Surat Jalan bila ada; termin Cash Netto diatur di Setting › Sistem, bawaan 7 & 30 hari) → klik baris → lengkapi resi/memo → SIMPAN. Finance membuka nota yang *menunggu*,
    mencentang kolom **FIN** → SIMPAN (jejak Approve terisi). Mengubah sisi yang sudah tersimpan: tombol **EDIT** → otorisasi Supervisor.
    **Cetak PDF** / **Unduh PDF** mencetak buku per rentang tanggal (landscape) lengkap dengan kotak centang dan baris barang.

11. **Reset data** (v2.2, Super Admin): Setting › Sistem › *Zona Berbahaya* — ketik RESET + password; pilih nasib berkas PDF arsip (dikembalikan ke folder
    masuk / dibiarkan / dihapus). Dari terminal: `php tools/reset_data.php --yes [--file=kembalikan|biarkan|hapus] [--log]`. User, perusahaan, pengaturan, whitelist IP, perangkat tidak dihapus.
12. **Dashboard per divisi** (v2.2): Sales Support melihat kartu arsip; Finance melihat dashboard penagihan + grafik; Supervisor keduanya; Super Admin keduanya + User Login. Sidebar bisa dikecilkan (tombol «).

## 3b. Master Wilayah & Master Bank (v2.3)
Menu **Master Data** (Admin) punya tiga bagian: Master Perusahaan, Master Wilayah, Master Bank.

**Master Wilayah** — empat tab berjenjang: Propinsi (kode 2 digit) › Kabupaten/Kota (4) › Kecamatan (6) › Kelurahan/Desa (10, memuat kode pos). Kode mengikuti BPS/Kemendagri: kode anak selalu diawali kode induknya.
- Data bawaan dimuat otomatis oleh `php tools/migrate.php` saat tabel masih kosong (38 propinsi, 514 kab/kota, 7.206 kecamatan, 81.819 kelurahan; berkas `database/wilayah.sql`, ±1 menit). Kecamatan/kelurahan Papua dengan kode lama yang tidak punya induk di sumber (5 kecamatan, ±1.600 kelurahan) tidak ikut — tambahkan manual bila perlu.
- Tambah: pilih induk (select berjenjang), kosongkan kode → otomatis nomor urut berikutnya di bawah induk; atau isi kode sendiri (harus diawali kode induk).
- Ubah: nama & kolom lain bebas; kode hanya bisa diganti bila belum punya anak (perubahan kode ikut diperbarui di cabang bank).
- Hapus (Supervisor/Super Admin): ditolak bila masih punya wilayah di bawahnya atau dipakai cabang bank — hapus dari jenjang terbawah dulu.
- Filter propinsi → kab/kota → kecamatan saling terfilter; klik angka di kolom Kab/Kota / Kecamatan / Kelurahan untuk turun ke jenjang bawahnya dengan filter terisi.
- Tombol **Muat data bawaan** (Super Admin) menambahkan kembali baris bawaan yang terhapus tanpa mengubah yang sudah ada (`INSERT IGNORE`).

**Master Bank** — tab **Bank** (105 kode bank dari `kodebank.xlsx`: kode 3 digit, nama, kepemilikan, tipe, jenis, aktif) dan tab **Cabang Bank** (1.245 cabang bawaan BRI 002 / Mandiri 008 / BCA 014).
- Form cabang: bank, kode cabang (unik per bank), tipe kantor KPO/KCU/KCP/KK, nama, alamat, lalu wilayah **berjenjang**: pilih Propinsi → daftar Kabupaten/Kota terfilter → Kecamatan → Kelurahan; **kode pos terisi otomatis** dari kelurahan (boleh diubah).
- Berkas cabang sumber banyak yang kosong kelurahan/kecamatannya; yang belum cocok master ditampilkan sebagai teks kuning "wilayah asal" (mis. `JAKARTA TIMUR`) — buka Ubah, pilih wilayah yang sesuai, simpan.
- Hapus bank ditolak bila masih punya cabang (nonaktifkan saja). Semua perubahan oleh USER memerlukan otorisasi supervisor dan tercatat di Aktivitas.
- Cara pakai dari halaman lain: `GET api/wilayah.php?action=opsi&jenjang=kabkot&induk=31` mengembalikan `[{id,nama}]`; di JS ada `wlRangkai({provinsi:'id1', kabkot:'id2', kecamatan:'id3', kelurahan:'id4', pos:'idPos'}, nilaiAwal)` untuk memasang select berjenjang + kode pos otomatis.
- Bila migrate.php tidak bisa dijalankan: import `database/update_v2_3.sql`, lalu `database/wilayah.sql` dan `database/bank.sql` lewat phpMyAdmin (atau `mysql -u user -p db < database/wilayah.sql`).

## 3c. Catatan v2.3 lainnya
- **Buku Ekspedisi**: Finance hanya bisa melihat nota yang statusnya *belum dicatat* — centang FIN baru bisa diisi setelah Sales Support mencatat nota itu (atau lewat "+ Catat semua" oleh Sales Support/Supervisor). Filter tanggal kosong = semua nota (maks 300 terbaru); "Catat semua" tetap butuh rentang tanggal.
- **Pindai Scan** hanya mengenali nomor nota (NP…/RNP…). Berkas yang cuma memuat nomor SJ ditahan dengan keterangan "Hanya nomor surat jalan … terbaca" — tetapkan manual bila memang surat jalan. Bila ingin SJ ikut dikenali otomatis: Setting › Sistem › "Nomor yang dikenali pindai otomatis" (nota tetap diutamakan).
- **About** (menu paling bawah, semua user): versi & riwayat pembaruan (dipindah dari Setting › Sistem).

## 3d. Rekening Pelanggan (v2.4)
**Penagihan › Rekening Pelanggan** (sejak 5.011d; sebelumnya di Master Data). Daftar pelanggan diambil dari Data Odoo (tabel `partner`, mengikuti perusahaan aktif), rekeningnya disimpan di tabel `partner_rekening` milik aplikasi.
- Kotak **Cari** mencakup semua kolom: kode & nama pelanggan, kota, sales, serta isi rekeningnya (atas nama, nomor rekening, nama bank, cabang, catatan). Saring "Sudah ada / Belum ada" rekening, lalu klik barisnya untuk membuka daftar rekening pelanggan itu.
- Popup rekening juga menampilkan **detail pelanggan** dari data Odoo (`res.partner`): alamat lengkap + kelurahan/kecamatan/kab-kota/propinsi/kode pos, HP & telepon, email, NPWP, sales, status, dan jumlah invoice/open. Kolom yang kosong di Odoo tampil sebagai —.
- Tambah rekening: pilih **Bank** (nama bank) → **Cabang** (ketik kode atau nama, daftar otomatis tersaring per bank) → nomor rekening → atas nama → utama/aktif/catatan. Yang **wajib hanya bank dan cabang**; nomor rekening dan atas nama boleh dikosongkan dulu (tampil "belum diisi") lalu dilengkapi lewat Ubah.
- Bank atau cabang belum ada? Klik tombol **+** di samping pilihannya: formulir Master Bank / Cabang Bank terbuka, setelah SIMPAN data langsung masuk ke master dan terpilih otomatis — isian rekening yang sedang diketik tidak hilang.
- Rekening pertama otomatis menjadi **utama**; ganti dengan tombol ★. Hapus hanya Supervisor / Super Admin. Semua perubahan memerlukan otorisasi (untuk USER) dan tercatat di Aktivitas.
- Nomor rekening unik per bank: satu nomor tidak bisa didaftarkan dua kali di bank yang sama.
- Data rekening **tidak** ikut terhapus saat import ulang Odoo maupun Reset data, dan terikat ke kode pelanggan (kode pelanggan CMP & KAL tidak beririsan).

## 3e. Device & Agent Wablas (v2.5)
**Setting › Sistem › WhatsApp** kini punya daftar **Device**. Di Wablas, *token* milik device (satu nomor WhatsApp = satu token), sedangkan *secret key* milik akun — secret tetap diisi sekali di bagian atas.
- Tambah device: nama seperti di dashboard (mis. `wearmeizhu.com`), kode device (`WZCFSZ`), nomor, token, dan server bila device memakai domain sendiri. Tandai satu device sebagai **bawaan** — itu yang dipakai untuk mengirim pesan.
- Tombol **Cek** memanggil `api/device/info` dan menyimpan hasilnya: connected/disconnected, paket, kuota, masa aktif, waktu pemeriksaan.

**Setting › User**: tiap baris user punya tombol 💬 untuk mengatur **Agent Wablas**.
- Toggle *Sebagai Agent Wablas*, pilih Role (Lead/Head/Agent/Cashier/Employee), nama & email terisi otomatis dari data user, nomor WhatsApp dinormalkan ke `62…`, lalu pilih Device.
- Tombol **Daftarkan ke Wablas** memanggil `api/create-agent` (butuh password agent — disediakan otomatis, boleh diganti, catat sebelum menekan tombol). Hasilnya tercatat: *terdaftar* + waktu, atau *gagal* + pesan dari Wablas, dan sisa slot agent ditampilkan.
- Kalau Wablas menjawab **"Email already registered"**, berarti agentnya sudah ada di dashboard (API hanya bisa membuat, tidak memperbarui). Pakai tombol **"Sudah ada di Wablas"** untuk mencatat statusnya di aplikasi, atau daftarkan dengan email lain.
- **Password agent** disimpan di aplikasi supaya isian di form selalu sama dengan password login agent di Wablas (bisa dilihat/disalin Super Admin kapan saja). Kalau passwordnya diganti di dashboard Wablas, ubah juga di sini agar catatannya tetap cocok.
- **Batas API Wablas**: hanya pembuatan agent dan info device yang tersedia. Mengubah, memblokir, menghapus agent, serta memindahkan agent antar device harus dilakukan di dashboard Wablas (Team › User dan Team › Device Agent). Karena itu, menonaktifkan agent di aplikasi hanya menandai `aktif = 0` (catatan tetap disimpan agar histori chat terlacak) dan aplikasi mengingatkan untuk memblokir di dashboard bila perlu.
- Satu user = satu agent; email agent unik, dan satu nomor WhatsApp hanya boleh dipakai satu agent per device.

## 3f. Placeholder template pesan (v2.5)
Berlaku di Setting › Setting Mailer (email), Setting › Sistem › WhatsApp (template WA), dan Penagihan › Pengaturan:
`{nama}` pelanggan · `{perusahaan}` · `{jenis}` · `{jumlah}` · `{daftar}` · `{pengirim}` nama akun yang mengirim · `{jabatan}` · `{email}` email akun yang mengirim (Penagihan juga punya `{tahap}`, `{total}`, `{sales}`).
Contoh blok tanda tangan:
```
{perusahaan}
{pengirim}
{jabatan}
{email}
```
Placeholder yang tidak dikenal atau kosong dibuang otomatis — termasuk barisnya, jadi tanda tangan tidak berlubang bila Jabatan belum diisi di Profil. `{masa}` sudah tidak dipakai dan dibersihkan otomatis dari template lama saat migrasi.

## 3g. Kontak Pelanggan (v2.6)
**Penagihan › Kontak Pelanggan** (sejak 5.013; sebelumnya di Master Data). Data Odoo (`res.partner`) hanya menyimpan satu email dan satu nomor; di sini tiap pelanggan bisa punya banyak kontak per **bagian**.
- Kotak **Cari** mencakup semua kolom: kode & nama pelanggan, kota, sales, email/nomor dari Odoo, serta isi kontaknya (nama kontak, bagian, email, no. WhatsApp, jabatan, catatan).
- Cari pelanggan → klik barisnya → **+ Tambah kontak**: nama, bagian, no. WhatsApp, email, jabatan, catatan. Wajib isi minimal salah satu dari WhatsApp / email.
- **Bagian** adalah master kecil yang bisa ditambah lewat tombol **+** di samping pilihannya (bawaan: Finance, Administrasi, Purchasing, Gudang/Penerimaan, Pajak, Pemilik/Direksi). Bagian yang sudah dipakai kontak tidak bisa dihapus — nonaktifkan saja.
- Kontak pertama otomatis menjadi **utama**; ganti dengan tombol ★. Nomor disimpan dalam format `62…`.
- **Kirim Dokumen**: saat dokumen satu pelanggan dipilih, muncul dropdown **Kontak tujuan** berisi kontak dari Data Odoo + semua kontak pelanggan yang punya alamat sesuai kanal (email atau WhatsApp). Pilih salah satu → nama penerima & tujuan terisi otomatis; tetap bisa diketik manual atau diisi beberapa tujuan dipisah koma.
- Data kontak milik aplikasi: tidak ikut terhapus saat import ulang Odoo maupun Reset data.

## 3h. Divisi untuk Supervisor (v2.6)
Divisi (Sales Support / Finance) bisa diisi untuk role **USER maupun SUPERVISOR** di Setting › User (kolom Divisi).
- **Divisi diisi** → menu yang tampil mengikuti *Matriks Menu per Divisi* di Setting › Permission. Contoh bawaan: Sales Support = Dashboard, Dokumen, Buku Ekspedisi, Pindai Scan; Finance = Dashboard, Dokumen, Kirim Dokumen, Buku Ekspedisi, Penagihan, Data Odoo. Dashboard ikut menyesuaikan (Sales Support = kartu arsip, Finance = ringkasan penagihan).
- **Divisi dikosongkan** → semua menu, seperti perilaku lama.
- Wewenang supervisor tidak berkurang: tetap bisa memberi otorisasi, mengubah, menghapus, dan membuka EDIT di Buku Ekspedisi — hanya daftar menunya yang dipersempit.
- Super Admin selalu melihat semua menu dan tidak punya pilihan divisi.
- Divisi juga membatasi **Supervisor** (v2.8): Finance hanya dashboard Finance + kolom FIN di Buku Ekspedisi, Sales Support hanya dashboard arsip + kolom SS. Divisi dikosongkan = dua-duanya.
- Perubahan divisi berlaku pada permintaan berikutnya (v2.8 membaca divisi dari database, tidak menunggu login ulang).

## 3i. Pengkinian Data Pelanggan (v2.7)
**Master Data › Pengkinian Data** — pelanggan melengkapi sendiri data rekening & kontaknya lewat tautan.

**Alur:** pilih pelanggan (boleh centang banyak) → **Kirim Email / Kirim WhatsApp** → pelanggan membuka tautan di ponsel → isi rekening &/atau kontak → isian masuk tab **Verifikasi** → petugas **Terima** (baru ditulis ke Rekening/Kontak Pelanggan) atau **Tolak**.
- Tujuan pengiriman otomatis memakai **kontak utama** pelanggan; bila belum ada, memakai email/nomor dari data Odoo. Untuk satu pelanggan, tujuan boleh diketik manual.
- Tombol 🔗 membuat tautan tanpa mengirim, untuk disalin dan dikirim sendiri.
- Tautan: token acak 40 karakter, berlaku **14 hari** (ubah di tab Pengaturan), bisa dibuka berulang sampai diisi. Waktu & IP saat dibuka/diisi tercatat.
- Halaman pelanggan tidak memerlukan login dan **tidak terkena gerbang IP maupun jam kerja** — sama seperti tautan berbagi dokumen.
- **Alamat & NPWP hanya ditampilkan** (data Odoo tidak bisa ditulis balik dari aplikasi). Bila pelanggan ingin mengoreksi alamat, mereka menulisnya di kolom Catatan dan petugas memperbaikinya di Odoo.
- Saat diterima: rekening/kontak dengan nomor yang sudah terdaftar **diperbarui**, bukan dibuat dobel; bagian baru yang diketik pelanggan dibuat otomatis di master Bagian.
- Semua pengiriman dan keputusan verifikasi tercatat di Aktivitas dan memerlukan otorisasi untuk role USER.
- Daftar pelanggan dan antrean verifikasi selalu mengikuti **perusahaan yang sedang aktif** (v2.8); usulan milik perusahaan lain tidak bisa diproses sebelum berpindah perusahaan.

**Cabang Bank (v2.8):** saat membuka form cabang, tombol SIMPAN sengaja terkunci beberapa detik sampai pilihan
wilayah selesai dimuat — menyimpan sebelum itu dulu membuat wilayah cabang terhapus. Hindari juga menekan
**Muat data bawaan** di Master Bank setelah kode cabang diubah manual: baris bawaan dengan kode lama akan
ditambahkan kembali sebagai cabang terpisah.

## 3j. Pelanggan tercampur antar perusahaan (v2.8)
Kode pelanggan CMP dan KAL **tidak pernah sama** (dicek dari kedua res.partner.xlsx: 1.207 vs 1.576 kode, nol irisan).
Bila jumlah pelanggan satu perusahaan terlihat jauh lebih banyak dari data Odoo-nya, tabel `partner` perusahaan itu
tercampur. Tabel `partner` hanya cerminan Odoo, jadi cara paling bersih adalah **kosongkan lalu import ulang**:

1. cPanel › phpMyAdmin › database aplikasi › tab SQL:
   `DELETE FROM partner WHERE kode_perusahaan = 'KAL';`   (ganti KAL sesuai perusahaannya)
2. Aplikasi › pilih perusahaan itu › **Import Data › Dari server** › `res.partner.xlsx` › Import.

Setelah selesai, jumlah pelanggan harus sama persis dengan jumlah baris di res.partner.xlsx perusahaan tersebut.
Rekening & kontak pelanggan tidak ikut terhapus (tabelnya terpisah, berkunci kode pelanggan).
Yang hilang hanya hasil ubah manual di Data Odoo › Partner untuk perusahaan itu — nanti terisi lagi dari Odoo.
Sejak v2.8 import res.partner menolak baris yang kodenya sudah terdaftar di perusahaan lain, jadi tidak terulang.

## 3k. Peta alamat (v2.9)
Peta **ditanam langsung** di panel pelanggan (Rekening & Kontak Pelanggan), form Cabang Bank, dan Master Perusahaan.

**Menyiapkan kunci** (sekali saja, pakai project Google yang penagihannya sudah aktif):
1. **APIs & Services › Library** → cari **Maps Embed API** → **Enable**.
2. **APIs & Services › Credentials › Create credentials › API key**.
3. Buka kunci itu → **Application restrictions: Websites** → tambahkan `https://arsip.ptcmp-group.id/*`
   → **API restrictions: Restrict key** → centang **Maps Embed API** saja → Save.
4. **Setting › Sistem › Google Maps** → tempel kunci → klik **UJI PETA** (memakai kunci yang sedang diketik,
   belum perlu disimpan). Peta contoh muncul = kunci benar → **SIMPAN**.

Layar abu-abu atau pesan kesalahan Google saat diuji berarti salah satu dari: penagihan project belum aktif,
Maps Embed API belum di-Enable, atau domain aplikasi belum masuk pembatas *Websites*.

Maps Embed API mode *place* tidak dikenai biaya per tampilan. Kunci kosong = peta tidak dimuat, yang tampil
hanya alamat + keterangan singkat. Kunci ini memang terbaca di kode halaman — pembatas *Websites* itulah
yang membuatnya tidak bisa dipakai di situs lain, jadi jangan dilewati.

## 3l. Pemantauan dari luar (v2.9)
`tools/monitor.php` memantau server kantor **dari** hosting. Yang tidak bisa ia laporkan: kalau hostingnya
sendiri yang mati. Untuk itu ada alamat pemeriksaan kesehatan:

```
https://arsip.ptcmp-group.id/health.php
   200  {"ok":true,"app":"arsip"}    aplikasi hidup, database menjawab
   503  {"ok":false,"app":"arsip"}   PHP mati, config hilang, atau database tidak menjawab
```

Alamat ini tidak terkena gerbang IP maupun jam kerja (pemeriksa datang dari banyak IP di luar kantor),
dan tidak menampilkan versi, nama database, atau pesan galat apa pun.

**Memasang uptime check di Google Cloud** (tanpa ubah kode lagi):
1. Console › ☰ › **Monitoring** › **Uptime checks** › **+ CREATE UPTIME CHECK**
2. Protocol **HTTPS**, Resource type **URL**, Hostname `arsip.ptcmp-group.id`, Path `/health.php`,
   Check frequency **5 minutes** › NEXT
3. **Response validation**: timeout 10 detik, centang *Content matching* › *Response content contains* › isi `"ok":true` › NEXT
   (dengan ini, halaman yang hidup tapi databasenya mati tetap dihitung gagal)
4. **Alert & notification**: buat *notification channel* › **Email** › alamat yang benar-benar dibaca › beri nama kebijakan › NEXT
5. Klik **TEST** dulu — harus hijau — baru **CREATE**

Jangan arahkan uptime check ke `/` (halaman login): kalau gerbang IP diaktifkan, pemeriksa Google akan
diblokir dan Anda dapat peringatan palsu terus-menerus. Pakai `/health.php`.

## 3m. Mutasi Bank (v3.0)
**Penagihan › Mutasi Bank** — laporan uang masuk & keluar dari rekening koran.

**Sekali saja:** daftarkan rekening perusahaan di **Master Data › Perusahaan › 🏦** (Nama Bank, Kode Cabang,
Nomor Rekening, Nama Rekening). Nomor rekening inilah yang dipakai aplikasi untuk mengenali pemilik berkas.

**Tiap hari:** unduh mutasi dari internet banking (.csv), lalu **seret berkasnya ke kotak putus-putus** di halaman itu
(atau klik **UNGGAH MUTASI**). Boleh beberapa berkas sekaligus. Ekspor harian (tanggal ditulis 01/09/2026) maupun
bulanan (01/08) sama-sama diterima.
- Perusahaannya dikenali sendiri dari nomor rekening di kepala berkas.
- Berkas ditolak bila saldo berjalannya tidak runtut atau tidak cocok dengan baris kaki — itu tanda berkas
  terpotong atau salah unduh.
- Baris yang sudah pernah masuk dilewati (dicocokkan lewat sidik jari tiap baris), jadi berkas harian yang
  tanggalnya bertumpang tindih aman diunggah ulang.

Keterangan bank dipecah otomatis: jenis transaksi, nama pengirim, kode bank pengirim (BI-FAST, 3 digit),
kode cabang (4 digit), nomor referensi, dan nomor nota bila pelanggan menuliskannya di berita transfer.
Nomor nota itu **petunjuk saja** — status lunas tetap milik Odoo, aplikasi tidak mengubahnya.

Supervisor bisa membatalkan satu berkas lewat **Berkas yang sudah diimpor**.

**🔄 Baca ulang keterangan** membaca ulang keterangan bank pada baris yang sudah tersimpan dan mengisi ulang
nama pengirim, kode SWIFT, kode bank, jenis transaksi, dan nomor nota. Dipakai setelah aplikasi diperbarui,
supaya mutasi lama ikut menikmati kemampuan baca yang baru tanpa diunggah ulang. Angka uang tidak disentuh.

**Mencatat uang masuk (v3.1, dirombak di v5.008c):** pada baris uang masuk ada tombol **Catat** di kolom paling kanan.
Popupnya: cari pelanggan → centang nota yang dibayar → isi **Dibayar sekarang** untuk tiap nota (otomatis terisi sebesar
uang yang belum terpakai, paling banyak sisa nota) → isi keterangan bila perlu. Kolom **Status** memperlihatkan hasilnya
sebelum disimpan:
- **LUNAS** — uang yang sudah masuk untuk nota itu (dari semua transfer) mencapai total nota.
- **TITIPAN** — uangnya kurang; uang itu menunggu transfer berikutnya untuk melunasi nota yang sama.
Satu nota boleh dibayar beberapa transfer, dan satu transfer boleh membayar beberapa nota.

Bila **uang masuk lebih** dari nota yang dipilih, sisanya dipilih salah satu: **simpan sebagai titipan** (dipakai untuk nota
berikutnya milik pelanggan yang sama lewat kotak *Pakai titipan pelanggan*) atau **buang sebagai pendapatan lain-lain**
(untuk selisih kecil, mis. lebih Rp 250). Bila **kurang** sedikit dan memang tidak akan ditagih (mis. potongan biaya transfer),
centang **Anggap lunas** pada nota itu; selisihnya tercatat sebagai potongan.

Nota yang sudah dicatat **tidak hilang** walau sesudah impor Odoo statusnya berubah menjadi Paid: formulir tetap
menampilkannya (diberi tulisan *Odoo: Paid · tetap tercatat*), dan menyimpan ulang tidak menghapusnya. Tombol di daftar
berubah menjadi jumlah nota + tanda LUNAS/TITIPAN; tanda **tinjau** muncul pada catatan lama yang jumlahnya tidak sama
dengan uang masuk — buka, perbaiki, lalu simpan ulang. Di Lacak Dokumen, tahap *Uang masuk* dianggap selesai bila uang
transfer + titipan yang dipakai mencapai nilai nota.

Catatan ini **alat bantu kerja**, bukan pembukuan: status Open/Paid tetap milik Odoo dan tidak diubah aplikasi. Datanya
disimpan di tabel sendiri (`pelunasan_nota`) sehingga impor Odoo tidak memengaruhinya.

**Laporan Mutasi (v5.008e, disederhanakan di v5.008f):** tab **Laporan Mutasi** di Penagihan menampilkan dan mencetak uang masuk satu rekening untuk satu periode,
dalam susunan berkas kerja Finance: NO · TGL · KODE · DEBIT (BANK, POTONGAN, ADM BANK) · KODE CUSTOMER · TGL. NOTA · NO. NOTA ·
KREDIT (PIUTANG DAGANG, PIUTANG GIRO, LAIN-LAIN) · KETERANGAN · NOMOR PELUNASAN. Kolom Keterangan bank, Cabang, Jumlah, dan Saldo tidak dicetak,
dan uang keluar tidak dirinci; jumlahnya tetap ada di ringkasan bawah (saldo awal, mutasi debet beserta jumlah barisnya, mutasi kredit, saldo akhir).
Tanpa tanggal, yang tampil adalah hari terakhir yang ada datanya. **Cetak PDF** / **Unduh PDF** memakai kertas **8½ × 13 inci mendatar** (Folio / F4), baris dibuat lebih lega seperti tampilan layar.
Yang mengisi kolom nota adalah catatan *Catat Uang Masuk*:
- **PIUTANG DAGANG** = uang transfer itu yang menutup nota (ditambah potongan nota tersebut).
- **POTONGAN** = selisih kurang yang ditutup dengan *Anggap lunas* (positif, mis. 840 dan 50); selisih lebih yang dibuang sebagai
  pendapatan lain-lain tampil **negatif** (mis. -360).
- **LAIN-LAIN** = uang lebih yang disimpan sebagai titipan pelanggan. **PIUTANG GIRO** dan **ADM BANK** belum punya sumber data: kosong.
- **KETERANGAN** = NILAI NOTA, +GAB T/T (transfer lain untuk nota yang sama), +TITIPAN, dan K.B (kurang bayar), seperti di berkas Finance.
- Baris **kuning** = uang masuk yang belum dicatat; baris **merah muda** = catatan lama yang perlu ditinjau.

Rekapitulasi di bawah laporan: **A1** = jumlah BANK; **B − A2 − A3** = (piutang dagang + giro + lain-lain) − potongan − adm bank;
**SELISIH** = A1 − (B − A2 − A3). SELISIH nol berarti seluruh uang masuk sudah dicatat dan cocok; selisih sama dengan jumlah uang
masuk yang belum dicatat (baris kuning). Saldo awal, jumlah mutasi debet/kredit, dan saldo akhir dihitung dari baris mutasinya;
bila saldo berjalan tidak runtut, laporan memberi peringatan.

## 4. Cron (cPanel › Cron Jobs)

```
*/10 * * * *      php ~/arsip/tools/monitor.php                       # pantau server kantor
30 2 * * *        php ~/arsip/tools/monitor.php --backup --audit      # backup + audit SHA-256
*/15 6-20 * * *   php ~/arsip/tools/monitor.php --pindai --import     # pindai scan + import Excel baru (tambah --ocr bila perlu)
0 3 * * *         php ~/arsip/tools/monitor.php --keamanan            # suspend akun tidur, bersihkan log keamanan (v1.7)
30 7 * * 1-6      php ~/arsip/tools/monitor.php --tagih               # email ringkasan antrean pengingat tagihan (v2.0), setelah import pagi
```

## 5. Pembaruan
Setiap paket membawa `VERSION` (tampil di footer) dan `updates.json` (isi perubahan). `php tools/migrate.php` mencatat versi yang belum ada ke tabel `update_log` — lihat Setting › Sistem › Riwayat Pembaruan.
Sesi login: data sesi disimpan di `src/sessions` (dibuat migrate.php; harus bisa ditulis PHP), batas idle di Setting › Sistem (bawaan 480 menit).
Unzip paket update di `~/arsip` (`unzip -o update_X.zip -x 'config/*'`), lalu `php tools/migrate.php` (atau import `database/update_*.sql` lewat phpMyAdmin) dan `php tools/selfcheck.php`.

## Backup database dan restore drill (5.108)

Backup database kini konsisten (satu snapshot), terenkripsi, diverifikasi, berretensi, dan dipantau; kunci dan konfigurasi dicadangkan terpisah lewat bundel berkata sandi. Semua dijalankan dengan `php tools/backup.php` di terminal cPanel (`status`, `siapkan`, `db`, `bundel-buat`, `bundel-uji`, `atur`, `pulihkan`, `bundel-ekstrak`). **Pemasangan sekali, urutan, RPO/RTO, retensi, pemulihan total, dan batas yang belum terbukti: [docs/backup-restore-v5.108.md](docs/backup-restore-v5.108.md).** Cron malam yang sudah ada (`monitor.php --backup --audit`) otomatis ikut mencadangkan database setelah `siapkan`. Salinan hasil pulih untuk uji WAJIB diberi penanda staging (`config/lingkungan.flag` berisi `staging`) agar tidak mengirim email/WhatsApp ke pelanggan dan tidak menyentuh server kantor.

## Janji bayar dan pengecualian pengingat (5.114)

- Di **Penagihan › Lainnya › Janji Bayar**, Finance, Supervisor, dan Super Admin mencatat **janji bayar** per nota: jumlah, tanggal (paling jauh 90 hari), catatan, dan PIC Finance. Satu nota hanya punya satu janji aktif. **Janji hanyalah catatan tindak lanjut, bukan pembayaran**: tidak mengubah saldo atau status lunas. Kondisinya (*menunggu, sebagian, terpenuhi, terlewat*) dihitung dari **uang masuk resmi** (mutasi bank yang sudah dicatat ke nota, atau invoice lunas dari Odoo); janji tidak menutup sendiri, **Finance menutupnya** dengan hasil (dipenuhi, sebagian, dibatalkan, diganti). Akun Sales hanya melihat janji pelanggannya.
- Mengubah **jumlah atau tanggal wajib menulis alasan**; setiap perubahan, ganti PIC, dan penutupan tercatat dengan pelakunya (tombol *Riwayat*, juga di **Lacak Dokumen › Riwayat kejadian**, jenis *Janji bayar*). Bila dua orang membuka janji yang sama, yang menyimpan belakangan diberi tahu ada perubahan dan harus memuat ulang (tidak ada yang tertimpa).
- Janji **terlewat** (tanggal lewat, uang masuk belum mencukupi) muncul di Dashboard › **Perlu Tindakan Saya** sebagai *Janji bayar terlewat* (untuk Finance/Supervisor/Super Admin; tombol Buka membuka tab Janji Bayar). Tidak ada email atau WhatsApp otomatis.
- Janji **aktif menunda pengingat tagihan untuk nota itu** sampai sehari sesudah tanggal janji, lalu pengingat berjalan lagi sendiri.
- **Pengecualian pengingat** (Kecualikan dari pengingat) kini **wajib beralasan dan bertanggal berakhir (paling lama 30 hari)** dan tercatat riwayatnya; setelah berakhir pelanggan masuk pengingat lagi sendiri. Pengecualian lama yang tanpa tanggal tetap berlaku tetapi ditandai *tanpa batas (data lama)*: **tinjau dan perbarui**.
- Pasang: unggah zip, `unzip -o`, lalu **`php tools/migrate.php` WAJIB** (tiga tabel baru). Kontrak, aturan, dan batas: `docs/janji-bayar-v5.114.md`.

## Meja Koreksi OCR (5.115)

- Di **Pindai Scan › Meja Koreksi** operator memperbaiki **nomor** dan **jenis** dokumen yang salah terbaca. Pilihan **Antrean masuk** (berkas di folder masuk), **Arsip tersimpan** (hanya Supervisor/Super Admin), dan **Riwayat koreksi**. Klik **KOREKSI**: pratinjau berkas di kiri, isian di kanan (di HP tersusun ke bawah; ada tautan "buka pratinjau di tab baru").
- Ketik nomor yang benar: sistem langsung memeriksa data Odoo dan menampilkan pelanggan, tanggal, sales, dan nama arsip baru. **Pelanggan, tanggal, dan sales tidak bisa diisi manual**, selalu dari data Odoo untuk nomor itu. Nomor yang tidak ada di data, milik perusahaan lain, atau sudah punya arsip akan ditolak dengan pesan yang jelas.
- **Alasan wajib** (minimal 5 karakter). Isi berkas tidak berubah; hanya nomor, jenis, dan nama arsip. Tidak ada angka persentase keyakinan OCR; yang ditampilkan hanya cara nomor terbaca (nama berkas, teks PDF, OCR, manual).
- Bila dua orang mengoreksi berkas yang sama, yang kedua ditolak dengan pesan konflik dan perubahannya tidak tersimpan; muat ulang lalu ulangi.
- **Kembalikan** (Supervisor/Super Admin) di Riwayat koreksi memulihkan nilai sebelum koreksi sebagai koreksi baru; riwayat tidak dihapus. Hanya untuk koreksi terbaru; berkas yang sudah pernah dikirim ke pelanggan tidak dikembalikan ke antrean.
- `php tools/migrate.php` **WAJIB** sesudah memasang 5.115 (kolom `dokumen.versi` dan tabel `dokumen_koreksi`). Kontrak: `docs/koreksi-ocr-v5.115.md`.

## Higiene Rahasia (5.119)

- **Wajib sesudah ZIP folder hosting pernah dibagikan** (mis. hasil audit): ganti password MySQL di cPanel, lalu `php tools/higiene.php config-pindah --ya` memindahkan kredensial ke `../ptcmp-secret/database.php` (di luar folder aplikasi, izin 600), menguji koneksi, dan memulihkan otomatis bila gagal. Salinan config lama tersimpan di folder itu: hapus setelah aplikasi berjalan. Langkah lengkap dan pencatatan penerima ZIP: `docs/higiene-rahasia-v5.119.md`.
- `php tools/higiene.php periksa` memeriksa folder aplikasi tanpa mencetak rahasia: config lama yang mencetak galat database (paket update tidak memperbarui `config/*`), kredensial literal, sesi/PDF sementara/log tertinggal, zip/sql/bak di folder aplikasi (GAGAL bila di `public/`), kunci di dalam folder. Hasilnya ikut tampil di `php tools/preflight_rilis.php`.
- `php tools/higiene.php sesi-cabut --ya` mencabut sesi **basi** saja (tanpa memutus siapa pun); `--ya --semua` juga yang aktif (semua pengguna login ulang; lakukan di luar jam kerja). `temp-bersih --ya` menghapus PDF sementara tertinggal (> 3 hari). `izin --ya` mengubah izin `config/database.php` dan `config/mailer.php` menjadi 640 dan melengkapi `public/kartu/.htaccess`. Semuanya DRY-RUN bila tanpa `--ya` dan tercatat di Aktivitas.
- **Jangan men-zip folder hosting untuk dibagikan.** Pakai `php tools/higiene.php ekspor /jalur/di-luar-aplikasi/ekspor.zip`: hanya kode dan dokumen (allowlist), tanpa sesi, log, PDF, unggahan, `config/database.php`, kunci; ZIP tidak dibuat bila isinya memuat kredensial. Tanpa migrasi database.

## Laporan Terjadwal (5.118)

- Menu **Admin › Laporan Terjadwal** (hanya Super Admin) mengirim **ringkasan harian lewat email** ke akun yang Anda pilih. Isinya **hanya angka** per kategori (scan gagal, invoice tanpa PDF, menunggu Finance, janji bayar terlambat, pengiriman WhatsApp bermasalah, dan jumlah yang terlambat; Supervisor/Super Admin juga menerima ringkasan Kualitas Data). Tidak ada PDF, lampiran, atau data pelanggan, dan tidak ada yang dikirim ke pelanggan. Semua waktu **WIB**.
- Buat **JADWAL BARU** (bawaan harian 07:30 WIB; jam dapat diubah), pilih penerima, lalu **Pratinjau** (isi untuk akun Anda sendiri, tidak mengirim) dan **Uji kirim** (hanya ke email Anda sendiri). Jadwal baru **nonaktif**; aktifkan sesudah diuji. Tidak ada tombol hapus: **Nonaktifkan** saja (riwayat dipertahankan 12 bulan).
- Isi dihitung **saat dikirim menurut hak tiap penerima**: akun yang dinonaktifkan, kehilangan akses perusahaan, atau tidak punya menu sumber dilewati dan tidak menerima apa pun; akun divisi Sales tidak dapat dipilih.
- Satu laporan per hari per jadwal, walau cron berjalan berulang. Bila terlambat sampai 6 jam, laporan dikirim **sekali** bertanda *(terlambat)*; lebih dari itu hari itu ditandai *dilewati*. Layar menampilkan **TERLAMBAT** bila jadwal aktif belum berjalan sesudah jamnya.
- **Pengiriman yang gagal tidak diulang otomatis**, dan hasil yang tidak pasti (proses terhenti) tidak pernah diulang. Di **RIWAYAT**, Super Admin dapat memilih **KIRIM ULANG YANG GAGAL** (alasan wajib, maks 3 kali per penerima).
- Berjalan dari cron `monitor.php` yang sudah ada (tiap 10 menit): **tanpa cron baru**. Operator: `php tools/laporan.php status` (jadwal terlambat, gagal, tak pasti), `jalankan`, `nonaktifkan <id>`. `php tools/migrate.php` **WAJIB** sesudah memasang 5.118 (empat tabel `laporan_*`). Kontrak: `docs/laporan-terjadwal-v5.118.md`.

## Tampilan Tersimpan (5.117)

- Di kepala halaman **Dokumen, Kirim Dokumen, Penagihan, Buku Ekspedisi, Data Odoo (Invoice, Surat Jalan, Partner, Produk)**, dan **Aktivitas** ada tombol **Tampilan**. Atur filter dan urutan seperti biasa, lalu **Simpan filter saat ini…** dan beri nama. Memilih nama di daftar menerapkan kembali filter itu. **Kelola tampilan…** untuk ganti nama, **Perbarui** (isi diganti filter saat ini), jadikan **default**, **Perbaiki**, atau **Hapus**.
- Tampilan **pribadi**: hanya milik Anda, per perusahaan, dan paling banyak 20 per halaman. Yang disimpan hanya filter dan urutan (bukan data, halaman ke-n, atau posisi gulir), jadi tampilan **tidak memperluas hak**: akun Sales tetap hanya melihat nota sendiri walau tampilannya memuat kode sales lain.
- **Default** dipakai hanya bila halaman dibuka **tanpa filter terakhir** (mis. sesudah login baru). Filter yang sedang Anda kerjakan selalu menang, begitu pula klik menu yang sudah aktif (membersihkan filter). Tombol menampilkan "default: nama" saat default sedang dipakai.
- Tampilan yang dibuat dengan versi lama atau memuat filter yang sudah tidak sah ditandai **perlu diperbaiki**: tidak diterapkan dan tidak menjadi default sampai **Perbaiki** (bagian tak sah dibuang) atau dihapus. Bila sebagian pilihan sudah tidak tersedia (mis. sales dihapus) saat tampilan dipakai, sisanya tetap diterapkan dan Anda diberi tahu.
- `php tools/migrate.php` **WAJIB** sesudah memasang 5.117 (tabel `tampilan_simpan`). Kontrak: `docs/saved-views-v5.117.md`.

## Kualitas Data (5.116)

- Menu **Admin › Kualitas Data** (Supervisor dan Super Admin) menampilkan lima kategori anomali untuk perusahaan aktif: **invoice tanpa PDF**, **dokumen tanpa pasangan** (nomor tidak ada di data Odoo atau berkas hilang), **kontak tidak valid** (nomor bukan 62xxxx, email tidak sah), **import usang** (belum diimpor lebih dari 7 hari) dan **kandidat duplikasi**. Jumlahnya selalu sama dengan daftar yang dibuka lewat **LIHAT**; tiap kategori menjelaskan tindakannya.
- Perbaikan lewat **DRY-RUN**: tombol DRY-RUN membuat rencana (nilai sebelum dan sesudah) tanpa mengubah data sama sekali. Jenisnya: **Rapikan kontak** (08xx menjadi 62xxxx, spasi email dibuang), **Cocokkan ulang** (berkas di antrean masuk yang nomornya kini ada di data) dan **Tandai ditinjau** (kandidat duplikasi, alasan wajib). Data Odoo (pelanggan, invoice, surat jalan) tidak disentuh: perbaiki dengan Import Data. **Tidak ada yang dihapus otomatis**, termasuk duplikasi.
- **COMMIT hanya oleh Super Admin**, per batch 50 item dan dapat dilanjutkan bila terhenti (item yang sudah selesai tidak diulang). Plan berlaku 24 jam; bila datanya berubah sebelum commit, plan ditolak sebagai **basi** dan harus dibuat ulang. Item yang berubah sejak dry-run dilewati, tidak ditimpa.
- **KEMBALIKAN** (Super Admin) memulihkan Rapikan kontak dan Tandai ditinjau; Cocokkan ulang dikembalikan per dokumen lewat Pindai Scan › Meja Koreksi › Kembalikan. Riwayat dry-run dan commit disimpan 12 bulan.
- `php tools/migrate.php` **WAJIB** sesudah memasang 5.116 (tiga tabel `kualitas_*`). Kontrak: `docs/kualitas-data-v5.116.md`.

## SLA serah terima Sales Support → Finance (5.113)

- Setiap serah terima di **Buku Ekspedisi** kini punya **tenggat**: 2 hari kerja (Senin–Jumat, 08:00–17:00 WIB; akhir pekan dan hari libur tidak dihitung) sejak Sales Support menyimpan catatan sampai Finance menerima. Tenggat, **PIC Finance**, dan jejak perubahannya tampil di dialog nota (panel *SLA serah terima*), di **Perlu Tindakan Saya** (kategori *Menunggu diterima Finance*: **Terlambat** kini berarti tenggat SLA lewat) dan di **Riwayat kejadian** (kecuali untuk akun Sales). Yang menentukan *selesai* tetap status Buku Ekspedisi: begitu Finance menerima, SLA selesai dan tidak dapat diubah.
- **PIC**: Supervisor/Super Admin menetapkan siapa pun dari Finance; USER Finance hanya dapat mengambil atau melepas dirinya sendiri. **Tunda tenggat**: Finance/Supervisor/Super Admin memilih hari kerja baru (paling jauh 5 hari kerja dari hari ini, maks 3 kali per nota kecuali Super Admin) dan **wajib menulis alasan**; tercatat dengan pelakunya. Menunda tidak mengubah status serah terima.
- **Eskalasi**: nota yang melewati tenggat diemailkan **sekali** ke Super Admin dan Supervisor yang punya menu Buku Ekspedisi, dan sekali lagi bila lewat dua kali tenggat. Berjalan di cron `monitor.php` yang sudah ada (tiap 10 menit): **tidak perlu cron baru**. Serah terima yang sudah menunggu sebelum SLA dipasang diberi tanda *data lama (sebelum SLA)* dan **tidak** dieskalasi.
- **Super Admin** mengisi **hari libur** dan mengatur durasi/jam kerja di **Setting › Sistem › SLA Serah Terima & Hari Libur**. Mengubahnya **tidak menggeser** tenggat nota yang sedang menunggu; tombol *Hitung ulang* (atau `php tools/sla.php hitung-ulang --ya`) memakainya untuk yang masih menunggu, tercatat per nota. Daftar libur kosong saat dipasang: **isi libur nasional/cuti bersama tahun ini** supaya hitungannya benar.
- Pasang: unggah zip, `unzip -o`, lalu **`php tools/migrate.php` WAJIB** (tiga tabel baru; nota yang sudah menunggu diberi baris SLA). Periksa: `php tools/sla.php status`. Kontrak, aturan, dan batas: `docs/sla-serah-terima-v5.113.md`.

## Riwayat kejadian di Lacak Dokumen (5.112)

- Di halaman **Lacak Dokumen**, di bawah garis waktu satu nota dan di bawah daftar nota satu pelanggan, ada tombol **Tampilkan riwayat kejadian**. Isinya semua kejadian yang tersimpan (pemindaian dan koreksi dokumen, Buku Ekspedisi, pengiriman email/WhatsApp termasuk bot, pengingat tagihan, uang masuk, keputusan operator) dengan asal, pelaku, waktu, hasil, dan buktinya, terbaru di atas, dapat disaring per jenis.
- **Bukti ditampilkan apa adanya**: WhatsApp berstatus *diterima penyedia* BUKAN berarti sampai ke ponsel; email *terkirim* = diterima server email. Data lama yang tidak lengkap diberi label ("data lama: pelaku tidak tercatat", "hanya tanggal"), tidak ditebak. Nomor WhatsApp dan email penerima **disamarkan** untuk akun biasa; Supervisor dan Super Admin melihat utuh. Kejadian lihat/unduh dokumen dan isi pesan bot tidak ikut.
- Hak sama dengan Lacak Dokumen (akun Sales hanya nota/pelanggannya sendiri). Tidak ada tabel atau pengaturan baru dan **tidak perlu `php tools/migrate.php`**. Kontrak, sumber tiap kejadian, dan batasnya: `docs/riwayat-v5.112.md`.

## Perlu Tindakan Saya di Dashboard (5.111)

- Bagian di Dashboard, **di bawah** ringkasan per perusahaan dan Penagihan yang lama (tampil bila akun punya menu Pindai Scan, Buku Ekspedisi, atau Kirim Dokumen; akun Sales tidak melihatnya) mengumpulkan pekerjaan yang menunggu: **scan gagal dicocokkan** dan **invoice belum ada PDF** (Sales Support), **nota menunggu diterima Finance** (Finance), **pengiriman WhatsApp gagal atau belum pasti** (pengirim; Supervisor dan Super Admin melihat semuanya).
- **Saya** = kategori divisi Anda; **Tim** = semua kategori yang boleh Anda lihat. Urut dari yang paling lama; tanda **Terlambat** bila lewat 3 hari (scan; *menunggu Finance* memakai tenggat SLA sejak 5.113), 7 hari (invoice tanpa PDF), atau 1 hari (pengiriman). Klik kartu kategori untuk menyaring; tombol **Buka** membawa ke halaman sumber (pengiriman: tab Operasi WhatsApp), dan halaman itu tetap memeriksa hak Anda sendiri.
- Tidak ada tabel, pengaturan, atau penugasan baru dan **tidak perlu `php tools/migrate.php`**: item hilang sendiri begitu status di modul sumber berubah. Kategori yang sumbernya gagal dibaca tampil **"—"** dengan catatan (bukan 0). Kontrak, sumber tiap kategori, dan batasnya: `docs/worklist-v5.111.md`.

## Uji regresi bisnis dan inventaris pustaka (5.110)

- Sebelum membangun paket di mesin pengembangan: `ARSIP_UJI_PHP=<php.exe> ARSIP_UJI_DB=127.0.0.1:33306 python tools/regresi/jalankan.py --tulis-hasil` (butuh PHP >= 8.1 dan server MySQL/MariaDB **uji**, bukan produksi; ±110 detik, 90 kasus). **Jangan menjalankannya di hosting.** Gagal = paket tidak akan dibuat; hasil kedaluwarsa atau belum ada = paket dibuat dengan peringatan "BELUM DIVERIFIKASI".
- `php tools/preflight_rilis.php` kini menuntut PHP **8.1** ke atas. Pustaka yang dipakai, versi, lisensi, dan catatan keamanan bertanggal: `docs/dependensi-v5.110.md`; cara kerja dan keterbatasan suite: `docs/regresi-v5.110.md`.

## Batas beban dan pemantauan (5.109)

- Tombol **Semua** di Data Odoo, Aktivitas, dan Mutasi Bank kini menampilkan paling banyak **5.000 baris per halaman**; bila tabelnya lebih besar muncul peringatan dan halaman berikutnya tetap dapat dibuka lewat pager. Unduhan CSV Mutasi Bank maksimal **50.000 baris**; lebih dari itu persempit rentang tanggal atau saringannya.
- `php tools/beban.php status` (hanya baca): batas, ukuran data, umur impor, antrean WhatsApp dan pindai, disk/cache, pemakaian jalur lama, dan putaran impor/pindai terakhir (keluar 1 = ada peringatan, bukan galat). `php tools/beban.php ukur [--kode=CMP]`: mengukur waktu query berat pada data nyata; jalankan di jam sepi.
- Cron impor/pindai (`monitor.php --import --pindai`): satu putaran pada satu waktu dan batas waktu 600 detik per putaran (`--anggaran=DETIK`, minimal 30); berkas yang belum sempat diproses dilanjutkan pada putaran berikutnya.
- Rincian, angka ukur, dan yang belum terbukti: `docs/beban-api-v5.109.md`.

## Penangkap webhook pesan masuk Wablas (PT-030add Fase 1, 5.064)

Fase 1 hanya MENGAMATI bentuk pesan masuk Wablas (teks, klik tombol Quick Reply / item list, tombol Test) sebagai dasar fitur menu invoice WhatsApp. Tidak membalas pelanggan, tidak membaca data invoice/pelanggan/dokumen, tidak mengubah database.

1. Di terminal cPanel (folder aplikasi): `php tools/wablas_webhook.php aktif` (bawaan 60 menit dan 50 rekaman; maksimum 240 menit dan 200 rekaman). Alat mencetak jalur `wablas_masuk.php?k=TOKEN` **sekali saja**; ganti `DOMAIN-ARSIP-ANDA` dengan domain Arsip.
2. Dashboard Wablas > Webhook Configuration: isi **Webhook URL for Inbound Message** dengan URL itu, lalu kirim pesan ke nomor device (atau tekan Test). Respons endpoint selalu kosong, jadi saklar Auto Reply tidak mengirim balasan apa pun.
3. Lihat hasil: `php tools/wablas_webhook.php lihat 5`. Nomor (deretan >= 8 angka) disamarkan, nama jadi inisial, kunci file/token/url dibuang, teks dipotong.
4. Selesai: `php tools/wablas_webhook.php mati` lalu **kosongkan kembali** kolom URL di dashboard Wablas. Penangkap juga mati sendiri bila waktu atau jumlah rekaman habis.

Catatan: token ada di URL (bisa muncul di log akses server) dan hanya tersimpan sebagai hash di database; jalankan `aktif` lagi untuk token baru. Log: `src/wablas_log/masuk.jsonl` (di luar public, dengan `.htaccess` tolak-semua).

## Menu WhatsApp /nota (PT-030add Fase 2, 5.065)

Pelanggan mengurus invoice sendiri lewat WhatsApp (Wablas). Hanya menu ANGKA (tanpa tombol). Mati bawaan.

**Prasyarat**
1. Device Wablas sudah didaftarkan di Setting › Sistem › WhatsApp Gateway dengan **Kode device sama persis** dengan di dashboard Wablas (mis. WZCFSZ). Pesan dari device yang tidak terdaftar diabaikan.
2. Nomor WhatsApp pelanggan terdaftar sebagai **kontak AKTIF** di menu Penagihan › Kontak Pelanggan (format 62…). Nomor yang tidak cocok mendapat jawaban "belum memiliki akses" dan tidak melihat data apa pun.
3. PDF invoice ada di arsip (halaman Dokumen). Lampiran WhatsApp maksimal **1,9 MB** (batas Wablas 2 MB).

**Memasang**
1. Setting › Sistem › tab **Menu WhatsApp** › **AKTIFKAN MENU & BUAT URL BARU**. URL tampil **sekali**; salin.
2. Dashboard Wablas › Webhook Configuration › **Webhook URL for Inbound Message**: tempel URL itu (kolom hanya satu, jadi menggantikan URL penangkap payload). Tracking URL dan Webhook Device biarkan kosong.
3. Uji dari nomor kontak terdaftar: ketik **/nota**.

**Untuk pelanggan**: /nota (atau /menu, MULAI) → pilih perusahaan (1 atau 2) → 1 Rekapitulasi Invoice OPEN · 2 Invoice Jatuh Tempo (jatuh tempo hari ini atau lebih awal) · 3 Permintaan file PDF (balas nomor urut; satu PDF per permintaan). **0** = Batal di menu perusahaan dan Kembali di menu lain; /lanjut = halaman berikutnya (10 per halaman); perintah lama /kembali dan /batal tetap diterima. Sesi menu berakhir **15 menit** tanpa aktivitas. Obrolan biasa tidak dibalas.

**Template kata-kata (5.073)**: Setting › Sistem › Menu WhatsApp › *Template pesan menu*. Bisa diatur: kalimat sambutan, teks pilihan 0, petunjuk, **link URL di baris paling atas** menu perusahaan, sendirian (5.074; WhatsApp hanya membuat kartu pratinjau gambar bila pesan diawali link), dengan teks opsional di bawahnya; isian *Cara kirim link* (berlaku bila link diisi): **Kartu lengkap** = SATU pesan berisi gambar, judul, dan deskripsi yang dibaca otomatis dari halaman link (tag og; hasil disimpan 24 jam; gambar webp dikonversi otomatis ke jpg lewat GD dan disimpan sebagai berkas statis di folder public/kartu (alamat berakhiran .jpg, syarat Wablas; folder itu harus bisa ditulis PHP); alasan kegagalan tercatat di Aktivitas menu sebagai baris kartu:...), lalu link dan menu; bila halaman tidak punya gambar atau Wablas menolak, otomatis jatuh ke kartu Wablas lalu pesan biasa; **Satu pesan** = kartu pratinjau gambar + judul halaman + menu dalam satu pesan lewat endpoint Wablas send-link, Wablas selalu menambahkan link di akhir teks; **Dua pesan** = kartu + link dulu, menu menyusul tanpa link; **Pesan biasa** = link di baris pertama tanpa kartu. Bila send-link ditolak Wablas, otomatis pesan biasa dengan link di baris pertama, judul menu layanan (`{perusahaan}` diganti nama perusahaan), dan nama layanan 1-3. Nomor pilihan, alur, dan hak akses tetap. Pratinjau mengikuti isian sebelum disimpan; *Kembalikan ke bawaan* mengosongkan template. Link hanya boleh http:// atau https://. Teks tersimpan di database (pengaturan `wamenu_templat`); berlaku untuk pesan pelanggan berikutnya, tanpa mengaktifkan ulang menu.

**Pesan pembuka / sapaan otomatis: TIDAK ADA (dibatalkan sejak 5.078; kodenya dihapus di 5.105)**: WhatsApp hanya menjawab perintah **/nota** dan balasan di dalam sesi menu (angka, /lanjut, /kembali, /batal). Chat biasa, sapaan, "/menu", "MULAI", dan label tombol lama TIDAK pernah dibalas, siapa pun pengirimnya; isi respons webhook selalu kosong, sehingga pengaturan **Get Auto Reply From Webhook** di dashboard Wablas tidak berpengaruh. Formulir *Template pesan menu* hanya memuat kata-kata menu yang aktif (sambutan, teks pilihan 0, petunjuk, link, judul dan layanan menu layanan); isian pembuka lama (judul/isi/label tombol/footer/jeda/jenis) sudah dihapus dari formulir dan tidak lagi mempengaruhi penyimpanan. Template lama yang tersimpan tetap terbaca (isian pembuka diabaikan) dan disalin SEKALI ke arsip app_settings `wamenu_templat_lama` pada penyimpanan/reset pertama (tidak dipakai kode). Sapaan/greeting yang Anda atur di dashboard Wablas sendiri berada di luar aplikasi ini; matikan di sana bila tidak diinginkan. Alasan pesan tidak dibalas tidak dicatat (diam total); bila item Interactive List Wablas berjudul persis /nota dipilih, aplikasi membaca judul itemnya seperti /nota.

**Aturan keamanan**: hak akses = kode pelanggan yang mendaftarkan nomor itu sebagai kontak aktif, dicek ulang di setiap langkah; maksimal 20 pesan/menit dan 10 PDF/jam per nomor; pesan dari akun sendiri, grup, dan media diabaikan. Aktivitas tercatat tanpa nomor lengkap dan tanpa isi pesan (panel › Aktivitas menu).

**Mematikan**: tombol **MATIKAN MENU**, lalu kosongkan kolom Webhook URL di dashboard Wablas.

## Keamanan akun Sales (5.013)
- **Jam kerja per divisi:** role USER di divisi yang dicentang di Setting › Keamanan › Jam Kerja › *Divisi yang bebas jam kerja* boleh masuk kapan saja. Bawaan: **Sales** (bekerja dari HP di lapangan). Supervisor dan Super Admin memang tidak pernah dibatasi jam.
- **OTP email:** pilihan baru *Semua level kecuali Super Admin* (Setting › Keamanan › Login & Password). Perangkat yang sudah diverifikasi diingat sesuai pengaturan (bawaan 30 hari), jadi HP yang sama tidak ditanya terus.
- **Akses IP:** tetap whitelist kantor; Sales di luar kantor masuk lewat VPN kantor.
- **Yang dilihat Sales:** Dashboard, Penagihan (Ringkasan = piutang, Invoice Open = tagihan, Kontak Pelanggan), dan Lacak Dokumen, semuanya disaring ke kode sales akun itu. Supervisor Sales tidak dibatasi per kode (bisa melihat anggota).

## SOP: HP Sales hilang atau dicuri (5.013a)
**Pemilik akun (Sales):**
1. Segera hubungi Super Admin (telepon/WA dari nomor lain) dan sebutkan nama akun. Jangan menunggu besok.
2. Bila bisa, ganti password email yang dipakai di aplikasi (karena OTP dikirim ke email itu) dan keluarkan Gmail/WA dari HP yang hilang.

**Super Admin (langkah, urut):**
1. Setting › Keamanan › **Sesi & Perangkat** › tabel *Sesi User* › klik **HP hilang** pada baris akun itu dan konfirmasi.
   - Semua sesi akun itu keluar dalam ±20 detik.
   - Perangkat milik akun itu dicabut kepercayaannya dan diblokir (login berikutnya dari perangkat mana pun wajib OTP).
   - Password wajib diganti saat login berikutnya.
   - Akun **dinonaktifkan** sampai Anda aktifkan lagi. Tindakan tercatat di Log Keamanan (jenis *HP hilang*) dan email notifikasi dikirim ke admin.
2. Periksa **Log Keamanan** dan **Aktivitas** akun itu beberapa jam terakhir: login tak dikenal, banyak membuka pelanggan (jenis *Ganjil*). Bila ada tanda penyalahgunaan, laporkan ke pimpinan.
3. Setelah pemilik terbukti (bertemu langsung atau telepon verifikasi): Setting › User › ubah status akun ke **aktif**. Pemilik login dari HP baru, memasukkan kode OTP, lalu mengganti password.
4. Bila HP ditemukan kembali: perangkat lama tetap diblokir; daftarkan ulang lewat login + OTP.

**Catatan:** Super Admin tidak diproses lewat tombol ini. Bila whitelist IP aktif, HP baru harus lewat VPN kantor atau disetujui di tabel *Perangkat Dikenal*.

## Peringatan aktivitas ganjil akun Sales (5.013a)
Setting › Keamanan › Server & Data › *Peringatan bila akun Sales membuka data melebihi* (bawaan **15** pelanggan per 10 menit; 0 = mati). Yang dihitung: membuka pelanggan di Lacak Dokumen, membuka Kontak Pelanggan, dan Statement of Account. Melewati ambang: tercatat sebagai *Ganjil* di Log Keamanan dan email ke admin (maksimal 1x/jam). Hanya peringatan, tidak memblokir akun.

## Perbaikan akses data pelanggan Sales (5.013a)
Endpoint per-pelanggan Kontak (ambil, simpan, utama, untuk_kirim) dan Rekening (ambil, utama) sekarang memeriksa di server bahwa pelanggan itu milik kode sales akun Sales yang meminta. Sebelumnya hanya daftar yang disaring, sehingga kode pelanggan orang lain bisa dibuka lewat panggilan langsung.

## Meminta akses perangkat dan Perangkat Dikenal (5.013c)
**Perangkat Dikenal** terisi OTOMATIS: setiap login berhasil mencatat perangkatnya (browser + sistem operasi, IP, waktu) dan memasang cookie perangkat. Tidak ada yang perlu diminta. Di sini Super Admin bisa memberi label, mencabut kepercayaan OTP, atau memblokir perangkat. (Sebelum 5.013c tabel ini tidak tampil karena id ganda di halaman.)

**Permintaan Akses Perangkat** hanya muncul bila ada orang yang MEMINTA, dan syaratnya:
1. Whitelist IP aktif (Setting > Keamanan > Akses IP), dan
2. saklar *Perangkat yang disetujui boleh melewati whitelist IP* menyala (Keamanan > Sesi & Perangkat > Aturan Sesi).

Cara meminta (oleh pengguna): buka alamat aplikasi dari jaringan yang BELUM terdaftar (misalnya HP dengan data seluler tanpa VPN). Halaman *Akses ditolak (403)* menampilkan formulir **Nama** dan **Email**; isi lalu kirim. Permintaan itu masuk ke tabel *Permintaan Akses Perangkat* dan email pemberitahuan dikirim ke admin. Formulir tidak muncul bila perangkat itu sudah pernah tercatat (sudah punya cookie perangkat) atau saklar di atas mati.

Cara menyetujui (oleh Super Admin): di tabel itu klik tanda centang (Setujui). Perangkat itu lalu boleh membuka aplikasi walau IP-nya tidak terdaftar; login tetap memakai password (dan OTP bila aktif). Untuk menolak, klik Blokir.

Catatan Sales: bila Sales memakai VPN kantor, IP mereka sudah terdaftar dan permintaan ini tidak diperlukan.

## Kode sales tambahan untuk Supervisor Sales (5.014)
Akun divisi Sales dibatasi ke kode salesnya sendiri (pelanggan, tagihan/piutang, kontak, lacak, dashboard). **Sales User** hanya kode sendiri. **Supervisor Sales** melihat kode sendiri **ditambah kode tambahan yang diisi Super Admin**; bila kosong, hanya kode sendiri.

Cara mengisi (Super Admin): Setting › User › klik **Detail** pada Supervisor Sales › kotak **Kode Sales Tambahan** › **atur** › isi kode dipisah koma (mis. `ROB, AGU`) › SIMPAN. Kode harus dikenal (ada di data pelanggan atau sebagai kode user). Perubahan tercatat di Aktivitas dan berlaku saat Supervisor memuat ulang halaman. Kode tambahan tidak dipakai bila akun tidak lagi Supervisor Sales. Super Admin tidak dibatasi.

## Pengumuman (lonceng) dan Tim & WA (5.015)
**Pengumuman.** Ikon lonceng di samping profil (sidebar; di HP di bilah atas) berlencana jumlah yang belum dibaca. Hanya **Super Admin** yang membuat dan menghapus pengumuman (klik lonceng › PENGUMUMAN BARU): judul, isi teks biasa, target (semua orang, satu divisi, satu perusahaan, atau orang tertentu), masa berlaku, dan tanda PENTING. Supervisor dan User hanya menerima dan membaca; satu arah, tanpa balasan. Super Admin melihat "dibaca X dari Y" per pengumuman. Lencana diperbarui tiap 60 detik dan saat berpindah halaman. **Cara membaca (5.020):** membuka lonceng tidak menandai apa pun; pengumuman baru ditandai dibaca satu per satu dengan tombol *Sudah saya baca* (atau sekaligus lewat *Tandai semua sudah dibaca*), lencana mengecil satu per satu. Urutan: PENTING yang belum dibaca, belum dibaca lainnya, lalu yang sudah dibaca (dilipat, klik judulnya untuk membuka lagi). Yang sudah dibaca dan lebih dari 30 hari disembunyikan dari daftar pengguna (arsip lengkap tetap ada bagi Super Admin); yang belum dibaca tidak pernah disembunyikan. Tabel baru: jalankan `php tools/migrate.php`.

**Tim & WA** (menu *Tim*, hanya Supervisor dan Super Admin).
- Super Admin: dapat menghubungi semua user aktif.
- Supervisor (semua divisi): hanya **bawahan langsung** (atasan = Supervisor itu, diatur Super Admin di Setting › User › Detail › Tambah Anggota) yang **divisinya sama**; tidak antar divisi.
- **Chat WA**: membuka WhatsApp pribadi Anda ke nomor di **Profil** penerima (wa.me). Tidak lewat server, tidak tercatat, tanpa batas.
- **Kirim lewat gateway**: pesan keluar dari nomor perusahaan (Fonnte/Wablas), isi bebas tanpa templat, ditambah baris nama pengirim di ujung. Tercatat per penerima di *Riwayat Pengiriman*. Supervisor dibatasi **30 pesan per hari** (hitungan per penerima; pengaturan `tim_wa_batas_harian` di app_settings); Super Admin tanpa batas harian. Penerima tanpa nomor di Profil tidak dapat dipilih.
- Syarat: gateway WhatsApp aktif (Setting › Sistem › WhatsApp) dan nomor telepon terisi di Profil penerima.

## Mutasi: KODE transaksi, Keterangan memo, hak USER (5.017)
- **Hak USER:** mengunggah mutasi dan mencatat uang masuk (Catat Uang Masuk) kini dikerjakan USER **tanpa password Supervisor** (tetap tercatat di Aktivitas). Yang tetap memerlukan Supervisor: hapus catatan, baca ulang keterangan, dan batalkan impor.
- **Keterangan** pada Catat Uang Masuk sekarang **memo** (kolom TEXT, maksimal 2.000 karakter): boleh beberapa baris (Enter). Di Laporan Mutasi (layar dan PDF) setiap baris tampil sendiri-sendiri. Jalankan `php tools/migrate.php` sekali untuk mengubah kolomnya.
- **KODE** (Laporan Mutasi dan daftar Mutasi Bank): **G** = Giro bila keterangan bank memuat *SETORAN TTL* (mis. "SETORAN TTL. WRK:1 BRHSL:1") dan cabang transaksi sama dengan cabang bank perusahaan (mis. 0284); **C** = Cash bila *SETORAN TUNAI* dan cabang sama; selain itu **T** = Transfer. Cabang bank perusahaan diambil dari Master Perusahaan › Rekening Bank (isi cabang rekeningnya; bila kosong semua kode tetap T).

## MASA (tahun kerja), Ingatkan Saya, dan masuk dengan sidik jari (5.058)

**MASA.** Setting › Sistem › Keamanan & Notifikasi › *MASA*: isi tahun (mis. `2026`) lalu SIMPAN. Setelah itu data bertanggal 01-01-2026 s/d 31-12-2026 saja yang tampil di Dokumen, Data Odoo (invoice, surat jalan),
Buku Ekspedisi, Kirim Dokumen, Mutasi Bank, Lacak (per pelanggan, Belum Terkirim), riwayat pengingat Tagihan, dan angka arsip di Dashboard. Tanda *MASA 2026* tampil di sidebar (desktop) / bilah atas (HP), dan kolom tanggal
hanya menerima tanggal tahun itu. Yang SENGAJA tidak dibatasi: daftar **Invoice Open** (piutang belum lunas) di Tagihan, Lacak per nomor nota, folder masuk (dokumen belum diproses), dan laporan mutasi dengan periode yang dipilih sendiri.
Kosongkan isian untuk menampilkan semua tahun. Hanya Super Admin yang bisa mengubahnya; berlaku untuk semua akun.

**Ingatkan Saya** (halaman login). Dicentang = sesi bertahan 30 hari di perangkat itu (token acak, bukan password; di database hanya hash-nya). Dicabut otomatis saat Keluar, ganti/reset password, "keluar semua sesi" oleh admin,
atau keluar paksa. Tidak melewati OTP atau kewajiban ganti password. Mati otomatis bila *sesi tunggal* aktif. Lama hari diatur di Setting › Keamanan (0 = fitur dimatikan). Daftar perangkat yang diingat ada di Profil › Sidik Jari & Perangkat (bisa dicabut).

**Masuk dengan sidik jari** (WebAuthn / passkey). Syarat: situs diakses lewat **HTTPS**, HP/perangkat punya sidik jari atau PIN layar. Cara memakai: masuk dengan password lebih dulu → Profil › *Sidik Jari & Perangkat* →
beri nama perangkat → *Aktifkan sidik jari di perangkat ini* → HP meminta sidik jari. Berikutnya di halaman login tekan *Masuk dengan sidik jari*. Aplikasi tidak pernah menerima data sidik jari; HP hanya mengirim tanda tangan, server menyimpan kunci publik.
Tiap HP didaftarkan sendiri; dapat dihapus kapan saja dari Profil. Verifikasi sidik jari dianggap faktor kedua, jadi OTP email dilewati. Admin dapat mematikannya di Setting › Keamanan (*Izinkan masuk dengan sidik jari*).
Kredensial terikat nama domain: bila alamat aplikasi berganti, sidik jari harus didaftarkan ulang.
