# PANDUAN & CHECKLIST UAT MULTI-ROLE & CROSS-ENTITY (PILOT: SAN_SARANA)
**Metode: Golden Circle (Why, How, What) & 5W + 1H Cross-Role Handshake Matrix**

- **Target Aplikasi Pilot:** `san_sarana`
- **Tanggal Pembaruan:** 20 November 2026
- **Lingkungan Uji:** 
  - **Aplikasi URL:** `https://demo.mayagrahakencana.com/normalisasi_sansub/san_sarana/`
  - **Holding Server:** `https://demo.mayagrahakencana.com/san_16nov/`
  - **CRM Server:** `https://angel.mayagrahakencana.com/`
  - **Database Host:** `192.168.5.10` | **Database Name:** `san_tsa_1agus`
  - **Status DDL Database:** `sync_san_tsa.sql` *(100% Selesai & Terverifikasi)*
  - **Runtime Interpreter:** PHP 5.6.39 / MariaDB 10.3.39-MariaDB-log / Google Chrome (V8)

---

## 🔑 MATRIKS AKUN UJI BERDASARKAN LOG DATABASE RIIL

Berdasarkan audit riil terhadap tabel `log` (23.240 entri aktivitas) dan tabel `per_employee` di database `san_tsa_1agus`, berikut adalah akun-akun operasional paling aktif yang digunakan untuk pengujian multi-peran:

| No | Peran dalam UAT | Username (`#uid`) | Password | Profil & Cabang Asal | Tanggung Jawab Operasional |
| :-: | :--- | :--- | :---: | :--- | :--- |
| **1** | **Cabang: Salesman** | `salesman` | `123456` | Nama: Sodrun (Fungsi: Penjualan / Operator) | Input pesanan awal (SO 19822), pilih produk varian, input uang muka. |
| **2** | **Pusat: Supervisor / Holding** | `holding_` | `123456` | Nama: Shadow (Membership: Holding, Multi-Cabang) | Verifikasi/Approval Konsumen, rekonsiliasi deviden, audit transaksi pusat. |
| **3** | **Cabang: Kasir & Keuangan** | `tsa.yanty.jkt` | `123456` | Nama: Yanty (Cabang: jkt-04, Kas & Settlement) | Penerimaan kas pembayaran, verifikasi uang muka faktur. |
| **4** | **Cabang: Gudang & Logistik** | `tsa.yanty.jkt` | `123456` | Nama: Yanty (Distribusi & Cetak Surat Jalan) | Cetak Surat Jalan, input tanda tangan digital (e-signature). |
| **5** | **Sistem: SuperAdmin / HR** | `superadmin` | `123456` | Nama: Superadmin (Akses Penuh Master Data) | Master Employee, validasi realtime AJAX username, setting permission. |

---

## 🎯 BAGIAN 1: PONDASI STRATEGIS (GOLDEN CIRCLE)

```mermaid
flowchart TD
    subgraph WHY["1. WHY (Tujuan Pokok)"]
        W1["Membuktikan Alur Transaksi Estafet Lintas Peran Berjalan Utuh, Zero Silent Data Loss & Zero JS Fatal Crash"]
    end
    subgraph HOW["2. HOW (Metodologi Simbiosis)"]
        H1["Tester Menguji Visual & UX di Browser <--> Runner Playwright Memvalidasi Event JS, DOM & Integritas Row DB"]
    end
    subgraph WHAT["3. WHAT (Matriks Pengujian)"]
        T0["Tahap 0: Multi-User Authentication Matrix"]
        T1["Tahap 1: Cabang Salesman Input SO 19822"]
        T2["Tahap 2: Pusat/Holding Approval Konsumen API"]
        T3["Tahap 3: Cabang Kasir Terima Pembayaran Kas"]
        T4["Tahap 4: Cabang Gudang Cetak Surat Jalan & E-Sign"]
        T5["Tahap 5: Holding Rekonsiliasi Deviden & Matriks DDD"]
        T6["Tahap 6: Admin Master Employee & AJAX Permission"]
    end
    WHY --> HOW --> WHAT
```

---

## 📋 BAGIAN 2: MATRIKS PENGUJIAN ESTAFET 5W + 1H & INTERACTIVE CHECKLIST

---

### TAHAP 0: MULTI-USER AUTHENTICATION MATRIX (GATE 0)
*Memastikan setiap aktor dapat login dan dialihkan ke dashboard/minidesk yang sesuai dengan hak aksesnya.*

- **Why:** Memvalidasi tidak ada sesi yang tertukar dan struktur menu ter-render sesuai ACL masing-masing peran.
- **What:** Login bergantian dengan 3 aktor utama (`holding_`, `salesman`, `tsa.yanty.jkt`).
- **Where:** URL: `https://demo.mayagrahakencana.com/normalisasi_sansub/san_sarana/`

#### Checklist Tahap 0:
- [ ] **Akun `holding_`:** Berhasil login, menampilkan judul "Welcome", dan memuat taskbar navigasi multi-cabang.
- [ ] **Akun `salesman`:** Berhasil login sebagai operator penjualan tanpa melempar fatal error PHP.
- [ ] **Akun `tsa.yanty.jkt`:** Berhasil login sebagai operasional cabang Jakarta.
- [ ] Konsol peramban tidak mengalami *fatal crash* JavaScript yang memblokir navigasi.

---

### TAHAP 1: SISI CABANG - INPUT SALES ORDER 19822 (ROLE: SALESMAN)
*Pengujian transaksi hulu oleh salesman cabang.*

- **Who:** Akun `salesman` (Password: `123456`).
- **Where:** URL: `/penjualan/create/19822` (atau `/penjualan/Transaksi/index/5822`).
- **Why:** Membuktikan salesman cabang dapat memilih customer, gudang, barang varian, dan menyimpan pesanan tanpa error sesi `items6_sum`/`items7`.
- **How:**
  1. Login sebagai `salesman`.
  2. Buka menu pembuatan SO (Order Penjualan).
  3. Pilih Konsumen, Gudang Cabang, dan Salesman.
  4. Tambahkan 2 produk (termasuk produk varian/paket).
  5. Masukkan rincian uang muka (DP).
  6. Klik tombol **Simpan Transaksi**.
  7. Catat Nomor Transaksi yang terbentuk (misal: `SO-xxxxx`).

#### Checklist Tahap 1:
- [ ] Form input SO terbuka lengkap dengan field konsumen, gudang, dan rincian item.
- [ ] Penambahan item ke keranjang belanja berjalan mulus via AJAX tanpa freeze.
- [ ] Tombol Simpan berhasil memproses transaksi dan menerbitkan nomor transaksi resmi.
- [ ] Data tersimpan di tabel database `penjualan_transaksi` dan `penjualan_transaksi_data`.
- [ ] Record registri deviden tersimpan di tabel `deviden_transaksi_registry`.

---

### TAHAP 2: SISI PUSAT - APPROVAL KONSUMEN & ORDER (ROLE: HOLDING / SPV)
*Pengujian verifikasi dan persetujuan dari sisi manajemen pusat.*

- **Who:** Akun `holding_` (Password: `123456`).
- **Where:** URL: `/penjualan/CustomerApprovalApi/approveBatchPendingCustomers` atau menu Approval Penjualan.
- **Why:** Membuktikan pihak holding/supervisor dapat menyetujui transaksi cabang dan penggantian `\Throwable` -> `Exception` tidak memicu crash 500.
- **How:**
  1. Login sebagai `holding_`.
  2. Buka daftar transaksi pending / approval konsumen.
  3. Lakukan verifikasi data SO yang dibuat oleh salesman pada Tahap 1.
  4. Klik tombol **Approve**.
  5. Periksa apakah status transaksi berubah menjadi aktif/disetujui.

#### Checklist Tahap 2:
- [ ] Akun holding dapat melihat transaksi yang diajukan oleh cabang.
- [ ] Proses approval menghasilkan respon sukses (status transaksi ter-update).
- [ ] Respon API approval mengembalikan JSON valid tanpa pesan error PHP di log.

---

### TAHAP 3: SISI CABANG - PENERIMAAN PEMBAYARAN KAS (ROLE: KASIR)
*Pengujian mutasi rekening kas dan komponen pembayaran.*

- **Who:** Akun `tsa.yanty.jkt` (Password: `123456`).
- **Where:** URL: `/pembayaran/` atau menu kasir follow up.
- **Why:** Membuktikan pemanggilan komponen pembayaran `ComRekeningTransaksiDataPembayaran.php` berjalan lancar saat kasir memproses pembayaran.
- **How:**
  1. Login sebagai `tsa.yanty.jkt`.
  2. Cari nomor transaksi SO dari Tahap 1.
  3. Input pembayaran uang muka / pelunasan ke rekening Kas/Bank cabang.
  4. Simpan pembayaran dan cetak bukti kwitansi.

#### Checklist Tahap 3:
- [ ] Transaksi SO dapat ditemukan oleh kasir untuk diproses pembayarannya.
- [ ] Nominal pembayaran terpotong/tercatat ke rekening buku kas cabang.
- [ ] Tidak ada error *Class Not Found* pada komponen pembayaran penerimaan.

---

### TAHAP 4: SISI CABANG - CETAK SURAT JALAN & E-SIGNATURE (ROLE: GUDANG / LOGISTIK)
*Pengujian pemrosesan barang keluar, layout printing, dan tanda tangan digital.*

- **Who:** Akun `tsa.yanty.jkt` atau `salesman`.
- **Where:** URL: `/distribusi/printing/surat_jalan/[TRANSAKSI_ID]`.
- **Why:** Memastikan pencetakan surat jalan memuat lookup nomor transaksi yang benar dan e-signature tersimpan utuh.
- **How:**
  1. Buka modul Distribusi -> Transaksi Pengiriman.
  2. Buka halaman cetak Surat Jalan atas transaksi dari Tahap 1.
  3. Lakukan tanda tangan digital pada canvas e-signature.
  4. Simpan e-signature dan klik Cetak / Print Preview.

#### Checklist Tahap 4:
- [ ] Layout Surat Jalan tampil rapi tanpa notice/warning PHP pada header/footer.
- [ ] Logo cabang tampil sesuai identitas cabang.
- [ ] Canvas e-signature dapat digores dan tombol Simpan Tanda Tangan berfungsi.
- [ ] Hasil print preview memuat gambar tanda tangan digital yang baru dibuat.

---

### TAHAP 5: SISI PUSAT - AUDIT DEVIDEN & LAPORAN MATRIKS (ROLE: HOLDING)
*Pengujian konsolidasi pelaporan tingkat eksekutif.*

- **Who:** Akun `holding_` (Password: `123456`).
- **Where:** URL: `/laporan/laporan_penjualan_matrix` dan audit tabel `deviden_*`.
- **Why:** Memastikan transaksi yang selesai di cabang otomatis terkonsolidasi ke laporan matriks bulanan holding dan tabel deviden.
- **How:**
  1. Login sebagai `holding_`.
  2. Buka Laporan Matriks Penjualan Bulanan (DDD).
  3. Pilih filter komparasi tahun berjalan vs tahun lalu.
  4. Periksa apakah nilai transaksi dari cabang tercermin pada kolom bulan berjalan.
  5. Klik salesman terkait untuk membuka modal drill-down transaksi.

#### Checklist Tahap 5:
- [ ] Laporan matriks 12 bulan tampil *side-by-side* tanpa error timeout database.
- [ ] Modal drill-down detail faktur salesman terbuka saat diklik.
- [ ] Tabel `deviden_transaksi_registry` memuat referensi transaksi cabang secara akurat.

---

### TAHAP 6: ADMINISTRATOR - MASTER PEGAWAI & AJAX PERMISSION (ROLE: SUPERADMIN)
*Pengujian manajemen hak akses dan validasi form realtime.*

- **Who:** Akun `superadmin` (Password: `123456`).
- **Where:** URL: `/statik/data/employee`.
- **Why:** Memastikan fitur deteksi duplikasi username realtime dan modal hak akses 3 tab berfungsi.
- **How:**
  1. Login sebagai `superadmin`.
  2. Buka menu Master Pegawai (`/statik/data/employee`).
  3. Buka form tambah employee baru.
  4. Ketik username yang sudah ada (misal: `salesman`), lalu pindahkan kursor (*blur*).
  5. Buka modal Hak Akses (BootstrapDialog) pada salah satu user.
  6. Klik tombol *Copy Login Name*.

#### Checklist Tahap 6:
- [ ] Peringatan merah AJAX realtime muncul saat username duplikat terdeteksi.
- [ ] Tombol *Copy Login Name* berhasil menyalin teks ke clipboard.
- [ ] Modal dialog hak akses (BootstrapDialog) terbuka dengan 3 tab permission lengkap.
- [ ] Kolom `referensi_crm_account` pada database `per_employee` terisi nilai yang valid.

---

## 📊 LEMBAR REKAPITULASI HASIL UAT BERSAMA

| Tahap | Skenario Alur UAT | Akun Uji Digunakan | Hasil Browser (Anda) | Hasil Playwright CLI (Agen) | Kesimpulan Akhir |
| :-: | :--- | :--- | :---: | :---: | :---: |
| **0** | Multi-User Auth Matrix | `holding_`, `salesman`, `tsa.yanty.jkt` | [ ] Pass  [ ] Fail | [ ] Pass  [ ] Fail | |
| **1** | Cabang: Input SO 19822 | `salesman` | [ ] Pass  [ ] Fail | [ ] Pass  [ ] Fail | |
| **2** | Pusat: Approval Konsumen | `holding_` | [ ] Pass  [ ] Fail | [ ] Pass  [ ] Fail | |
| **3** | Cabang: Kasir Pembayaran | `tsa.yanty.jkt` | [ ] Pass  [ ] Fail | [ ] Pass  [ ] Fail | |
| **4** | Cabang: Surat Jalan & E-Sign | `tsa.yanty.jkt` | [ ] Pass  [ ] Fail | [ ] Pass  [ ] Fail | |
| **5** | Pusat: Laporan & Deviden | `holding_` | [ ] Pass  [ ] Fail | [ ] Pass  [ ] Fail | |
| **6** | Admin: Master Employee & Hak Akses | `superadmin` | [ ] Pass  [ ] Fail | [ ] Pass  [ ] Fail | |

---

## ✍️ TANDA TANGAN PERSETUJUAN UAT (*SIGN-OFF*)

- **Penguji Manual Browser (User):** ____________________  *(Tanggal: _______________)*
- **Penguji Otomatisasi CLI (Agent):** ____________________  *(Tanggal: _______________)*
