# Blueprint UAT Modul Kas: Pipeline Berjenjang Penuh (Multi-Tier Pipeline)

Dokumen ini adalah spesifikasi pengujian penerimaan pengguna (*User Acceptance Testing* - UAT) berjenjang dan komprehensif untuk seluruh **24 class controller** dan **1 berkas include pendukung** pada modul [application/modules/kas/](file:///z:/everest_19okt/application/modules/kas) (CodeIgniter 3.1.8 HMVC Wiredesignz, PHP 5.6).

Pengujian dirancang secara ketat dengan prinsip **Anti-Happy Test** (menguji kegagalan, anomali konkurensi, celah keamanan, dan integritas akuntansi) melalui **3 Jenjang Pengujian (*Multi-Tier Pipeline*)**:
1. **Tier 1 (Audit Statis & Analisis Logika Baris Kode):** Audit mendalam kondisi *Yes*, *No*, dan *Else* pada 25 berkas kode sumber. (Status: **SELESAI 100%** di [UAT_RESULTS_KAS.md](file:///z:/everest_19okt/UAT_RESULTS_KAS.md)).
2. **Tier 2 (Backend DB & Assertion Runner):** Eksekusi script verifikasi backend CLI/PHP untuk memvalidasi konsistensi tabel database (`transaksi`, `transaksi_values`, `jurnal`, `stock_locker_transaksi`) dan NoSQL MongoDB. (Status: **PENDING**).
3. **Tier 3 (Dynamic Browser E2E Interaction via Subagent):** Pengujian dinamis berbasis interaksi antarmuka pengguna, navigasi modal AJAX, pengujian multi-role (Cabang -> Holding), dan perekaman video WebP. (Status: **PENDING / PARSIAL** di [UAT_LIVE_TRANSACTIONS_KAS.md](file:///z:/everest_19okt/UAT_LIVE_TRANSACTIONS_KAS.md)).

---

## 1. 🔑 Data Kredensial & Lingkungan UAT Definitif

Tabel akun dan lingkungan pengujian terverifikasi pada basis data `run_everest_modul` (`per_employee`):

| Parameter | Konfigurasi Uji Coba | Keterangan Akses |
| :--- | :--- | :--- |
| **URL Server Target** | `https://demo.mayagrahakencana.com/everest_19okt/` | Server staging/demo aktif |
| **Akun Cabang (Branch)** | User: `sys_` \| Peran: `sys_shadow` \| Cabang: **Pinang** | Pembuat transaksi draf, input data, submit |
| **Akun Holding (Parent)** | User: `holding_` \| Peran: `Shadow` \| Cabang: **PUSAT (DC)** | Verifikasi, approval bertingkat, monitoring |
| **Akun Superadmin** | User: `2` (`sys_`) \| Peran: `c_holding` / All \| Cabang: **Pusat** | Bypass audit & inspeksi diagnostik global |
| **Password Akun UAT** | `123456` (Hash MD5: `e10adc3949ba59abbe56e057f20f883e`) | Kredensial standar lingkungan pengujian |

---

## 2. 🏛️ Pemetaan 4 Alur Bisnis Nyata Kas (Lifecycle Slices)

Untuk mencegah pengujian sub-controller fragmen AJAX (prefix `_`) terisolasi tanpa konteks, 24 controller dikelompokkan ke dalam 4 alur bisnis transaksi:

```
[Alur 1: Kas Biaya Operasional]
  Create.php -> _selectorPihak -> _processPihak -> _selectorItem -> _processSelectBiaya -> _shoppingCart -> FollowUp.php

[Alur 2: Pelunasan Nota Tagihan]
  Create.php -> _selectorPihak -> _processPihak -> _processSelectNota -> _processSelectNotaItem -> _shoppingCart -> FollowUp.php -> Pembelian.php

[Alur 3: Kas Masuk Tunai Barang / Uang Muka]
  Create.php -> _selectorItem -> _processSelectProduct -> _processSelectProductKomposit -> _processSelectProductPpn -> _processSelectValas -> _shoppingCart -> FollowUp.php

[Alur 4: Otorisasi, Dokumen Cetak, & Laporan]
  Transaksi.php -> ViewDetails.php -> Printing.php -> History.php -> ActivityReport.php -> Debug.php
```

---

## 3. 📋 Tabel Master Checklist 24 Controller (Status 3 Tier)

| No | Controller / Berkas | Tipe | Grup | Tier 1 (Audit Statis) | Tier 2 (DB Assertion) | Tier 3 (Browser E2E) |
| :---: | :--- | :--- | :---: | :---: | :---: | :---: |
| 1 | [Modul_Controller.php](file:///z:/everest_19okt/application/modules/kas/controllers/Modul_Controller.php) | Base Controller | Grup 1 | **SELESAI** | PENDING | PENDING |
| 2 | [_construct_file.php](file:///z:/everest_19okt/application/modules/kas/controllers/_construct_file.php) | Script Include | Grup 1 | **SELESAI** | PENDING | PENDING |
| 3 | [Create.php](file:///z:/everest_19okt/application/modules/kas/controllers/Create.php) | Transaksi Inti | Grup 2 | **SELESAI** | PENDING | PARSIAL (4467) |
| 4 | [FollowUp.php](file:///z:/everest_19okt/application/modules/kas/controllers/FollowUp.php) | Transaksi Inti | Grup 2 | **SELESAI** | PENDING | PENDING |
| 5 | [Transaksi.php](file:///z:/everest_19okt/application/modules/kas/controllers/Transaksi.php) | Transaksi Inti | Grup 2 | **SELESAI** | PENDING | PARSIAL (4467) |
| 6 | [_shoppingCart.php](file:///z:/everest_19okt/application/modules/kas/controllers/_shoppingCart.php) | Sub-Controller | Grup 3 | **SELESAI** | PENDING | PARSIAL (4467) |
| 7 | [_followupLiveEdit.php](file:///z:/everest_19okt/application/modules/kas/controllers/_followupLiveEdit.php) | Sub-Controller | Grup 3 | **SELESAI** | PENDING | PENDING |
| 8 | [_processSelectBiaya.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectBiaya.php) | Sub-Controller | Grup 4 | **SELESAI** | PENDING | PENDING |
| 9 | [_processSelectNota.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectNota.php) | Sub-Controller | Grup 4 | **SELESAI** | PENDING | PENDING |
| 10 | [_processSelectNotaItem.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectNotaItem.php) | Sub-Controller | Grup 4 | **SELESAI** | PENDING | PENDING |
| 11 | [_processSelectProduct.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectProduct.php) | Sub-Controller | Grup 5 | **SELESAI** | PENDING | PENDING |
| 12 | [_processSelectProductKomposit.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectProductKomposit.php) | Sub-Controller | Grup 5 | **SELESAI** | PENDING | PENDING |
| 13 | [_processSelectProductPpn.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectProductPpn.php) | Sub-Controller | Grup 5 | **SELESAI** | PENDING | PENDING |
| 14 | [_processSelectValas.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectValas.php) | Sub-Controller | Grup 5 | **SELESAI** | PENDING | PENDING |
| 15 | [_selectorItem.php](file:///z:/everest_19okt/application/modules/kas/controllers/_selectorItem.php) | Picker Modal | Grup 6 | **SELESAI** | PENDING | PARSIAL (4467) |
| 16 | [_selectorPihak.php](file:///z:/everest_19okt/application/modules/kas/controllers/_selectorPihak.php) | Picker Modal | Grup 6 | **SELESAI** | PENDING | PARSIAL (4467) |
| 17 | [_selectorPihakMain.php](file:///z:/everest_19okt/application/modules/kas/controllers/_selectorPihakMain.php) | Picker Modal | Grup 6 | **SELESAI** | PENDING | PENDING |
| 18 | [_processPihak.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processPihak.php) | Sub-Controller | Grup 6 | **SELESAI** | PENDING | PARSIAL (4467) |
| 19 | [_processPihakMain.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processPihakMain.php) | Sub-Controller | Grup 6 | **SELESAI** | PENDING | PENDING |
| 20 | [ActivityReport.php](file:///z:/everest_19okt/application/modules/kas/controllers/ActivityReport.php) | Laporan | Grup 7 | **SELESAI** | PENDING | PENDING |
| 21 | [Printing.php](file:///z:/everest_19okt/application/modules/kas/controllers/Printing.php) | Cetak Dokumen | Grup 7 | **SELESAI** | PENDING | PARSIAL (Error Test) |
| 22 | [History.php](file:///z:/everest_19okt/application/modules/kas/controllers/History.php) | Audit Trail | Grup 7 | **SELESAI** | PENDING | PENDING |
| 23 | [ViewDetails.php](file:///z:/everest_19okt/application/modules/kas/controllers/ViewDetails.php) | Pratinjau | Grup 7 | **SELESAI** | PENDING | PENDING |
| 24 | [Pembelian.php](file:///z:/everest_19okt/application/modules/kas/controllers/Pembelian.php) | Relasi Modul | Grup 7 | **SELESAI** | PENDING | PENDING |
| 25 | [Debug.php](file:///z:/everest_19okt/application/modules/kas/controllers/Debug.php) | Diagnostik | Grup 7 | **SELESAI** | PENDING | PENDING |

---

## 4. Matriks UAT Rinci Per Controller (Kondisi Yes, No, Else)

### Grup 1: Base Controller & Core Gate

#### 1. [Modul_Controller.php](file:///z:/everest_19okt/application/modules/kas/controllers/Modul_Controller.php)
* **Yes:**
  * User dengan sesi login aktif (`$_SESSION['login']['id']`) mengakses endpoint kas. Seluruh konfigurasi (`coTransaksiUi`, `coTransaksiCore`, `coTransaksiLayout`, `coTransaksiValues`) termuat sempurna ke properti controller.
  * Otorisasi cabang (`my_cabang_id()`) dan hak akses (`alowedAccess(my_id())`) terverifikasi.
* **No:**
  * Sesi login kosong (`!isset($_SESSION['login'])`). Sistem langsung memanggil `gotoLogin()` dan memutus eksekusi tanpa kebocoran data.
  * User tidak memiliki hak akses pada modul kas: akses diblokir oleh helper `he_access_right`.
* **Else:**
  * **Segment Tampering:** User mengubah parameter URL `segment(4)` dengan kode acak atau angka negatif (misal `/kas/Create/index/99999` atau `-1`). Sistem wajib menangani jenis transaksi tidak terdaftar secara elegan tanpa memunculkan pesan debug oranye/biru mentah ke browser pengguna.
  * **Multi-Tab Collision:** User membuka dua jenis transaksi kas yang sama (misal dua kas masuk `_TR_401` untuk cabang berbeda) di dua tab browser simultan. Sistem harus mencegah tumpang tindih memori sesi (`$_SESSION['_TR_401']`).

#### 2. [_construct_file.php](file:///z:/everest_19okt/application/modules/kas/controllers/_construct_file.php)
* **Yes:**
  * Di-include oleh sub-controller lama untuk bootstrap sesi, konfigurasi, dan penentuan `$this->cCode`.
* **No:**
  * Sesi kadaluarsa saat berkas di-include: mengeksekusi `gotoLogin()` seketika.
* **Else:**
  * **Direct Access Attempt:** Mengakses berkas ini secara langsung via URL HTTP (misal `http://.../kas/_construct_file`). Webserver/CI wajib memblokir akses langsung (`Direct script access denied`).
  * **Double Inclusion Conflict:** Pemanggilan include berulang kali tidak boleh mendefinisikan ulang konstanta atau menyebabkan redeclaration error.

---

### Grup 2: Alur Transaksi Utama

#### 3. [Create.php](file:///z:/everest_19okt/application/modules/kas/controllers/Create.php)
* **Yes:**
  * Parameter draf lengkap (tanggal, rekening kas sumber/tujuan, pihak terkait, item keranjang $\ge$ 1). Transaksi DB (`trans_start()`) sukses, nomor transaksi terbentuk, rincian tersimpan di MySQL dan draf di-backup ke MongoDB.
* **No:**
  * Tombol "Simpan" ditekan saat keranjang kosong: sistem memutus proses dengan `die("belum ada item yang dipilih")`.
  * Mode maintenance aktif (`$this->transaksiMaintenance == true`): sistem menghentikan proses dengan pesan maintenance resmi.
* **Else:**
  * **Double Submit / Spamming:** Klik tombol simpan berulang kali secara cepat. Sistem wajib menerapkan idempoten: hanya 1 nomor transaksi yang boleh terbentuk, klik selanjutnya diblokir oleh locker/token.
  * **Session Persistence Bug:** Setelah transaksi berhasil disimpan, `$_SESSION[$cCode]` wajib di-unset secara total di backend agar keranjang tidak tertinggal jika browser gagal me-reload.
  * **Early Validation Fail-Fast (Rule 3.8):** Pengecekan status dokumen referensi (seperti SO `trash_4 == 1`) wajib dilakukan SEBELUM `$this->db->trans_start()` dipanggil, sehingga pembatalan tidak meninggalkan koneksi database menggantung.

#### 4. [FollowUp.php](file:///z:/everest_19okt/application/modules/kas/controllers/FollowUp.php)
* **Yes:**
  * Verifikator dengan wewenang menyetujui transaksi draf via `doFollowup()`: step transaksi naik ke tahap final, jurnal terbentuk, dan lock dilepas.
  * Verifikator menolak transaksi via `doRevert()` / `doRevertAll()`: status berubah menjadi `trash_4 = 1`.
* **No:**
  * Otorisasi transaksi yang itemnya sudah diproses oleh user lain (`valid_qty <= 0`): sistem menolak dengan pesan "Transaksi gagal disimpan karena sudah diotorisasi".
* **Else:**
  * **Retake Lock Guard (< 5 menit vs $\ge$ 5 menit - Rule 3.10.3):**
    * Jika Petugas A sedang membuka transaksi, Petugas B mengakses dengan `?forceRetakeLock=1` dalam waktu < 5 menit: tombol ambil alih wajib disabled dan akses Petugas B diblokir dengan halaman "Transaksi Terkunci".
    * Jika Petugas A idle > 5 menit: Petugas B diizinkan mengambil alih lock secara resmi.
  * **Concurrency Locking In-Transaction:** Row locking `SELECT ... FOR UPDATE` via `$tr->getCekPrevalue()` wajib dibungkus di dalam blok `$this->db->trans_start()` agar lock tidak terlepas seketika akibat MySQL autocommit.

#### 5. [Transaksi.php](file:///z:/everest_19okt/application/modules/kas/controllers/Transaksi.php)
* **Yes:**
  * Menampilkan riwayat transaksi kas aktif sesuai hak akses cabang pengguna, pagination bekerja tepat, dan status step ditampilkan sinkron.
* **No:**
  * User dari Cabang A mencoba melihat transaksi Cabang B tanpa hak multi-cabang: data disaring ketat berdasarkan `cabang_id`.
* **Else:**
  * **Filtering Dokumen Batal:** Transaksi dengan status `trash_4 = 1` tidak boleh muncul dalam daftar transaksi yang siap dibayar/difollow-up.
  * **Payment Source Integrity:** Saat memilih sumber pembayaran (`selectPaymentSrc`), pastikan rekening yang dipilih berstatus aktif dan saldo tidak menjadi minus (jika aturan saldo negatif berlaku).

---

### Grup 3: Keranjang Sesi & Live Edit

#### 6. [_shoppingCart.php](file:///z:/everest_19okt/application/modules/kas/controllers/_shoppingCart.php)
* **Yes:**
  * Merender item keranjang belanja draf, menghitung akumulasi debet/kredit, subtotal, dan grand total secara presisi via `viewCart()`.
* **No:**
  * Pemanggilan `reset()` membersihkan seluruh isi keranjang dan melepas reservasi locker.
* **Else:**
  * **Auto-Save Draft ke MongoDB (Rule 3.11):** Perubahan isi keranjang wajib tersimpan ke NoSQL MongoDB via AJAX auto-save secara berkala, dan pemulihan draf hanya diizinkan untuk pemilik draf (`user_id === my_id()`).
  * **Floating Point Mismatch:** Penjumlahan nominal kas berdesimal panjang tidak boleh mengalami selisih sen pada grand total.

#### 7. [_followupLiveEdit.php](file:///z:/everest_19okt/application/modules/kas/controllers/_followupLiveEdit.php)
* **Yes:**
  * Petugas pengoreksi yang memiliki hak edit mengubah catatan atau nominal item tertentu saat proses verifikasi; nilai terupdate di DB dan sesi.
* **No:**
  * Petugas tanpa hak akses edit mencoba mengubah kolom terkunci: sistem menolak request AJAX.
* **Else:**
  * **Live Edit pada Transaksi yang Sedang Di-Lock:** User melakukan live edit pada transaksi yang sedang dikunci oleh supervisor lain: request wajib di-reject dengan pesan lock conflict.
  * **Journal Recalculation:** Jika nilai nominal di-edit langsung via live edit, jurnal akuntansi terkait wajib dihitung ulang sebelum approval final dijalankan.

---

### Grup 4: Pemrosesan Akun Biaya, Nota, & Item

#### 8. [_processSelectBiaya.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectBiaya.php)
* **Yes:**
  * Memilih akun COA beban/biaya operasional, memvalidasi keberadaan akun, dan menambahkan baris ke `$_SESSION[$cCode]['items']`.
* **No:**
  * Input nominal melebihi pagu anggaran atau bernilai negatif: diblokir oleh validasi.
* **Else:**
  * **Stock Locker Dual-Write Integrity (Rule 3.2):** Jika biaya terkait dengan pengeluaran stok barang operasional, penulisan locker WAJIB menggunakan `ComLockerStockDualWrite`, bukan manual update langsung ke tabel.
  * **Undefined Variable Crash:** Pada cabang penolakan stok (`sizeof($tmpC) == 0`), pastikan variabel `$row` tidak diakses secara ilegal untuk mencegah PHP fatal notice.

#### 9. [_processSelectNota.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectNota.php)
* **Yes:**
  * Memilih nota hutang/piutang yang akan dilunasi, mencatat nomor nota referensi, dan menghitung sisa tagihan yang harus dibayar.
* **No:**
  * Memilih nota yang sudah berstatus lunas penuh: sistem menolak penambahan nota.
* **Else:**
  * **Server-Side Validation of Invoice Balance:** Nilai `tagihan` dan `sisa` DILARANG dipercaya langsung dari HTTP GET (`$_GET['tagihan']`, `$_GET['sisa']`). Sistem wajib melakukan re-query ke database untuk memverifikasi sisa saldo riil saat item ditambahkan.
  * **Concurrency Race Pelunasan Nota:** Jika Nota #101 dilunasi oleh kasir lain di detik yang sama, sistem harus menggagalkan transaksi dengan pesan error jelas sebelum disimpan ke keranjang.

#### 10. [_processSelectNotaItem.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectNotaItem.php)
* **Yes:**
  * Melakukan pelunasan spesifik pada rincian baris barang/jasa tertentu di dalam sebuah nota tagihan.
* **No:**
  * Mengalokasikan pembayaran melebihi nilai baris item terkait: sistem menolak alokasi.
* **Else:**
  * **Sub-Item Rounding:** Akumulasi pembayaran per baris item nota harus tepat sama dengan grand total pelunasan nota induk tanpa deviasi pembulatan desimal.

---

### Grup 5: Pemrosesan Produk, Komposit, PPN, & Valas

#### 11. [_processSelectProduct.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectProduct.php)
* **Yes:**
  * Menangani transaksi kas yang disertai pengeluaran/penerimaan barang dagangan langsung (tunai langsung barang).
* **No:**
  * Stok barang persediaan di gudang tidak mencukupi: transaksi ditolak.
* **Else:**
  * **Hold Stock Locker:** Qty barang yang dipilih wajib masuk ke status `hold` di locker stock milik user aktif agar tidak diambil oleh transaksi penjualan lain.

#### 12. [_processSelectProductKomposit.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectProductKomposit.php)
* **Yes:**
  * Memilih produk komposit (bundling), memecah komponen penyusunnya, dan menghitung total harga komposit secara proporsional.
* **No:**
  * Salah satu komponen penyusun barang komposit memiliki stok kosong: transaksi dibatalkan.
* **Else:**
  * **Atomic Component Locking:** Seluruh komponen penyusun komposit wajib di-lock secara atomik; jika satu komponen gagal di-lock, seluruh penguncian komponen lainnya wajib di-rollback.

#### 13. [_processSelectProductPpn.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectProductPpn.php)
* **Yes:**
  * Menghitung nilai dasar pengenaan pajak (DPP) dan PPN secara tepat sesuai tarif aktif (`$_SESSION['login']['ppnFactor']`).
* **No:**
  * Format nilai PPN atau persentase tarif tidak valid/negatif: form diblokir.
* **Else:**
  * **PPN Rate Migration:** Menguji ketahanan kalkulasi saat transaksi menggunakan tarif PPN lama (10%) vs tarif PPN baru (11% / 12%) agar tidak terjadi selisih 1 rupiah pada pembukuan hutang/piutang pajak.

#### 14. [_processSelectValas.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processSelectValas.php)
* **Yes:**
  * Menerapkan kurs mata uang asing ke rupiah (misal USD ke IDR), menghitung ekuivalen rupiah untuk pembukuan buku besar.
* **No:**
  * Kurs bernilai 0 atau negatif: input diblokir.
* **Else:**
  * **Exchange Rate Precision & Selisih Kurs:** Penggunaan kurs dengan pecahan desimal presisi tinggi tidak boleh merusak keseimbangan jurnal Debet vs Kredit di `ComJurnal`. Selisih kurs wajib dialokasikan otomatis ke akun Laba/Rugi Selisih Kurs.

---

### Grup 6: Modal Selector & Handler Pihak Ketiga

#### 15. [_selectorItem.php](file:///z:/everest_19okt/application/modules/kas/controllers/_selectorItem.php)
* **Yes:**
  * Membuka popup modal picker untuk memilih COA biaya atau produk; pencarian kata kunci menghasilkan data akurat dan cepat.
* **No:**
  * Kata kunci tidak ditemukan: menampilkan antarmuka kosong dengan pesan "Data tidak ditemukan".
* **Else:**
  * **SQL Injection & XSS pada Pencarian:** Kolom pencarian modal wajib menggunakan parameterized query atau query builder CI3, kebal terhadap payload kutip (`' OR 1=1 --`) dan script alert.

#### 16. [_selectorPihak.php](file:///z:/everest_19okt/application/modules/kas/controllers/_selectorPihak.php)
* **Yes:**
  * Menampilkan daftar entitas pihak ketiga (Customer, Vendor, Supplier) sesuai jenis transaksi kas yang sedang berjalan.
* **No:**
  * Entitas pihak ketiga yang berstatus non-aktif/blacklist tidak boleh dimunculkan pada daftar pilihan.
* **Else:**
  * **Cross-Branch Entity Isolation:** Jika entitas terikat cabang tertentu, entitas dari cabang lain tidak boleh bocor ke modal cabang yang tidak berhak.

#### 17. [_selectorPihakMain.php](file:///z:/everest_19okt/application/modules/kas/controllers/_selectorPihakMain.php)
* **Yes:**
  * Menampilkan pihak utama penanggung jawab transaksi internal (karyawan / pemegang kas kecil).
* **No:**
  * Karyawan yang sudah resign/non-aktif tidak dapat dipilih.
* **Else:**
  * **Session State Consistency:** Memastikan ID karyawan terpilih sinkron dengan cabang penempatan aktif di sesi login.

#### 18. [_processPihak.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processPihak.php)
* **Yes:**
  * Menerima parameter pihak ketiga dari modal dan menyimpannya ke `$_SESSION[$cCode]['main']['pihakID']` dan `pihakName`.
* **No:**
  * Request tanpa parameter ID pihak ketiga: membatalkan proses dan memunculkan notifikasi.
* **Else:**
  * **Switching Pihak Mid-Cart:** Pengguna mengganti pihak ketiga saat keranjang sudah berisi item nota: sistem wajib mengosongkan nota dari pihak lama atau memberi peringatan bahwa nota pihak sebelumnya akan dihapus dari keranjang.

#### 19. [_processPihakMain.php](file:///z:/everest_19okt/application/modules/kas/controllers/_processPihakMain.php)
* **Yes:**
  * Menyimpan entitas pihak utama ke sesi transaksi draf.
* **No:**
  * Parameter data kosong: tidak mengubah sesi eksisting.
* **Else:**
  * **Re-binding Akun Kas Terikat:** Jika pihak utama memiliki akun kas khusus (misal kas kecil kasir), sistem wajib memperbarui default akun kas tujuan.

---

### Grup 7: Pelaporan, Cetak, Audit, & Bridging

#### 20. [ActivityReport.php](file:///z:/everest_19okt/application/modules/kas/controllers/ActivityReport.php)
* **Yes:**
  * Menampilkan laporan rekap mutasi kas keluar/masuk dalam rentang tanggal tertentu; total mutasi debet/kredit klop dengan saldo rekening bank.
* **No:**
  * Rentang tanggal terbalik (tanggal akhir < tanggal awal): sistem memunculkan validasi error.
* **Else:**
  * **Memory Exhaustion on Large Datasets:** Menarik laporan aktivitas kas selama 1 tahun penuh dengan ribuan baris: sistem wajib menggunakan chunking/pagination agar tidak memicu memory limit exhaustion (`Fatal error: Allowed memory size exhausted`).

#### 21. [Printing.php](file:///z:/everest_19okt/application/modules/kas/controllers/Printing.php)
* **Yes:**
  * Merender format cetak voucher bukti kas masuk/keluar (PDF / HTML view) dengan format angka dan tanda tangan resmi.
* **No:**
  * Mencetak transaksi yang belum disetujui / berstatus draf: sistem menampilkan watermark "DRAF / BELUM DISETUJUI" atau memblokir pencetakan final.
* **Else:**
  * **XSS Injection via Transaction Notes:** Transaksi kas yang memiliki catatan dengan karakter HTML (`<script>`, `<iframe>`, tags) wajib lolos escaping `html_escape()` saat dirender ke dokumen cetak agar layout tidak rusak dan kebal eksploitasi browser.

#### 22. [History.php](file:///z:/everest_19okt/application/modules/kas/controllers/History.php)
* **Yes:**
  * Menampilkan kronologi audit trail dari pembuatan draf, revisi, hingga otorisasi final transaksi kas beserta waktu dan ID petugas.
* **No:**
  * Transaksi tidak ditemukan / ID salah: menampilkan pesan notifikasi aman.
* **Else:**
  * **Immutable Audit Trail:** Memastikan halaman riwayat tidak menyediakan endpoint manipulasi/penghapusan log riwayat (hanya-baca / read-only).

#### 23. [ViewDetails.php](file:///z:/everest_19okt/application/modules/kas/controllers/ViewDetails.php)
* **Yes:**
  * Menampilkan detail lengkap suatu transaksi kas tanpa menginisialisasi atau merusak keranjang sesi belanja pengguna yang sedang aktif.
* **No:**
  * User tanpa hak akses cabang transaksi mencoba membuka ID transaksi: sistem memblokir akses detail.
* **Else:**
  * **Side-Effect Free:** Memastikan pembukaan ViewDetails pada tab baru tidak menimpa array `$_SESSION['_TR_xxx']` di tab kerja utama pengguna.

#### 24. [Pembelian.php](file:///z:/everest_19okt/application/modules/kas/controllers/Pembelian.php)
* **Yes:**
  * Menjembatani transaksi kas pelunasan langsung ke modul pembelian, menandai status pembayaran PO/faktur pembelian menjadi lunas.
* **No:**
  * Faktur pembelian yang direferensikan dalam status batal (`trash_4 = 1`): sistem menolak pembayaran.
* **Else:**
  * **Cross-Module Rollback:** Jika terjadi kegagalan saat update status faktur di modul pembelian, mutasi kas di modul kas wajib ikut di-rollback secara atomik dalam satu transaksi database.

#### 25. [Debug.php](file:///z:/everest_19okt/application/modules/kas/controllers/Debug.php)
* **Yes:**
  * Menjalankan fungsi diagnosa internal pada lingkungan pengembangan (*development*).
* **No:**
  * Diakses oleh pengguna umum / non-developer: akses ditolak.
* **Else:**
  * **Production Exposure Guard:** Controller ini DILARANG mengekspos informasi kredensial database, phpinfo, atau query mentah pada lingkungan staging/produksi.

---

## 5. 🚀 Standar Protokol & Template Perintah Eksekusi Mandiri (SOP Prompt)

Untuk menjalankan pengujian dinamis mandiri per alur bisnis kas, format perintah baku berikut digunakan sebagai pemicu (*trigger*) instruksi:

```markdown
Jalankan Eksekusi UAT Pipeline Berjenjang Penuh untuk [NAMA ALUR TRANSAKSI KAS].

Lingkungan Target: https://demo.mayagrahakencana.com/everest_19okt/
Akun Pengujian:
- Cabang: User sys_ / 123456 (Cabang Pinang)
- Holding / Otorisator: User holding_ / 123456 (PUSAT - DC)

Cakupan Jenjang yang Wajib Dieksekusi:
1. Jenjang 2 (Backend DB Verification):
   - Jalankan script verifikasi scratch CLI untuk memverifikasi snapshot database sebelum dan sesudah transaksi.
   - Periksa tabel: `transaksi`, `transaksi_values`, `jurnal` (balance Debet == Kredit), dan `stock_locker_transaksi`.
   
2. Jenjang 3 (Browser E2E Mandiri via Browser Subagent):
   - Buka browser, login sebagai Cabang (`sys_`).
   - Buka form [URL Endpoint Kas].
   - Uji Skenario YES: Input data lengkap, pilih pihak via modal AJAX, simpan transaksi sampai terbit nomor transaksi resmi.
   - Uji Skenario NO: Submit dengan data kosong / nominal minus, verifikasi penolakan UI/SweetAlert.
   - Uji Skenario ELSE: Login ganda / verifikasi proteksi lock transaksi.
   - Handover ke Holding: Logout -> Login sebagai `holding_` -> Lakukan otorisasi/approval dan verifikasi perubahan status transaksi.
   - Rekam seluruh alur interaksi ke file video WebP.

Output yang Diminta:
- Terbitkan berkas laporan hasil eksekusi: UAT_REPORT_[NAMA_ALUR].md berisi nomor transaksi riil yang terbentuk, bukti rekaman WebP, dan log query/tabel database.
- JANGAN ubah kode sumber aplikasi apapun (Read-Only Test).
```

---

## 6. ⚖️ Kriteria Kelulusan Pipeline Berjenjang (Acceptance Criteria)

1. **Integritas Akuntansi Mutlak (Tier 2):** Seluruh transaksi final wajib menghasilkan jurnal dengan selisih Debet minus Kredit tepat Rp 0 (tidak boleh ada toleransi deviasi pembulatan rupiah).
2. **Keandalan Concurrency Lock (Tier 2 & 3):** Tidak boleh ada transaksi yang berhasil disetujui ganda atau diproses bersamaan oleh dua pengguna tanpa melewati mekanisme lock resmi (`MdlLockerTransaksi`).
3. **Isolasi Memori Sesi (Tier 3):** Pembukaan transaksi kas multi-tab tidak boleh merusak draf transaksi lain (`$_SESSION[$cCode]`).
4. **Idempotensi Penulisan (Tier 3):** Percobaan submit tombol ganda / spamming tidak boleh menghasilkan transaksi duplikat di database.
5. **Kebersihan Failure State (Tier 2):** Setiap kegagalan pada cabang **No** dan **Else** wajib mengeksekusi `$this->db->trans_rollback()` dan tidak meninggalkan *orphan records* di tabel MySQL maupun MongoDB.
6. **Validitas Bukti Visual (Tier 3):** Seluruh eksekusi antarmuka browser wajib memiliki bukti rekaman interaksi format `.webp` yang dapat diputar ulang.

---

## 7. 📊 Status Progres Pipeline Berjenjang Terkini

* **Tier 1 (Audit Statis Kode Sumber):** **SELESAI (100%)** per 2026-10-22 pada [UAT_RESULTS_KAS.md](file:///z:/everest_19okt/UAT_RESULTS_KAS.md) (24 Controller + 1 Include).
* **Tier 2 (Backend DB Assertion Runner):** **SIAP EKSEKUSI (Fase 2)** &mdash; Template script verifikasi DB disiapkan pada instrumen scratch.
* **Tier 3 (Browser E2E Dynamic Walkthrough):** **PARSIAL (1/4 Alur)** &mdash; Transaksi kas 4467 terverifikasi di [UAT_LIVE_TRANSACTIONS_KAS.md](file:///z:/everest_19okt/UAT_LIVE_TRANSACTIONS_KAS.md); Alur 1, 2, dan 4 siap dieksekusi secara otonom.


