# Sintesis Terpadu: Diskon, Kompensasi Harga dan Promo pada Everest ERP

**Sistem:** Everest ERP (CodeIgniter 3.1.8 / Wiredesignz HMVC / PHP 5.6 / MariaDB 10)
**Codebase rujukan:** `w:\everest_opname28sep`
**Database operasional:** `192.168.5.10` (`everest_26sep`) dan replika analitik `192.168.5.17` (`run_everest_modul`)
**Modul terkait:** `pembelian` (jenisTr `466`, `467`), `kompensasiharga` (jenisTr `3333`, `3344`), `returpembelian` (jenisTr `9911`), `pembatalan`
**Periode analisis:** 2024 sampai 2026-09-30
**Jumlah dokumen sumber disintesis:** 10
**Status dokumen:** Dokumen sintesis referensi tunggal untuk domain diskon pembelian

---

## 1. Ringkasan Eksekutif

Sistem diskon pembelian Everest ERP berjalan pada dua jalur yang tidak saling berkunci: sisi hulu (komitmen di PO dan penerbitan hak fisik di GRN) serta sisi hilir (pengakuan di buku pembantu piutang supplier `1010020030` dan realisasi klaim `3333`). Audit end-to-end menemukan bahwa kedua sisi tersebut menyimpang secara sistemik sehingga menghasilkan empat titik kerusakan yang saling merantai.

**Empat titik kerusakan inti:**

1. **Titik 1 - Plafon pre-locker nol.** Saat PO `466` diterbitkan, komponen `SyncDiskonPembelian` mengisi `stock_locker_pre_diskon`. Pada sebagian PO (contoh `PO 383654` / `PO.-1.1849`) seluruh 18 baris tercatat `nilai = 0.0000000000`.
2. **Titik 2A - Slot locker hilang.** Saat GRN `467` disimpan, `PreSyncDiskonPembelian.php` memfilter `nilai > 10` pada pre-locker. Karena nol, sistem masuk blok destruktif `else` yang menulis `$_SESSION[..]["diskon_1_nilai"] = 0`, sehingga Diskon 1 tidak masuk `items4_sum` dan `ComLockerDiskonValue` tidak pernah membuat baris slot di `stock_locker_diskon`. Kasus: `GRN.-1.2496` hanya punya Diskon 2 dan Diskon 3.
3. **Titik 2B - Over-debit buku pembantu.** Komponen master `[98]`/`[99]` dan komponen detail `[3]`/`[4]`/`[5]`/`[6]` sama-sama mendebet COA `1010020030`, sehingga debet membengkak 2x sampai 4x. Pada penerimaan parsial, `main['diskon_nilai_total']` menyalin total diskon PO utuh (Rp 24.628.767) ke satu GRN parsial 50 unit (pad seharusnya proporsional Rp 12.076.285).
4. **Titik 3 - Mismatch ID selector klaim.** `coTransaksiUi.php` baris 2610 masih memakai `"pihakNameMainDiskonIdSelector" => "id"`. Karena model adalah `MdlSupplierDiskon`, `pihakMainID` terkirim berisi `2` (ID jenis diskon), bukan ID GRN (contoh `34662`). Query mutasi kredit `WHERE extern_id = '2' AND extern2_id = '' AND extern3_id = '11'` tidak menemukan cache GRN sehingga mutasi kredit di `__rek_pembantu_subpiutangsuppliertrans__1010020030` gagal formed secara senyap (silent fail).
5. **Titik 4 - Fallback DataTable ke sumber anomali.** `Transaksi::viewKlaimSupplierDataAjax()` jatuh ke `_rek_pembantu_subpiutangsuppliertrans_cache` yang sudah over-debit, menghasilkan tampilan sisa diskon Rp 20.185.738 (seharusnya Rp 7.633.256): `24.628.767 - 4.443.029 = 20.185.738`.

**Metrik dampak live (DB 5.17):**

| Indikator | DB 5.17 (replika) | DB 5.10 (master, estimasi) | Status |
| :--- | ---: | ---: | :--- |
| GRN diskon sehat dan selaras | 4.985 GRN | sekitar 5.200 GRN | Valid |
| GRN over-debit jurnal | 2.308 GRN | sekitar 2.450 GRN | Debet 2x-4x, aktif setiap hari |
| GRN locker defisit / ter-wipe | 114 GRN | sekitar 125 GRN | Slot fisik valued Rp 0 |
| Klaim `3333` tanpa mutasi kredit | 0 (sudah dipatch) | - | Sebelumnya 49 dokumen |
| Anomali retur `9911` locker menggantung | 35 GRN | sekitar 40 GRN | Berisiko klaim ganda |
| Total akumulasi diskrepansi nominal | Rp 2.441.933.245,69 | sekitar Rp 2,6 miliar | Selisih semu fisik vs buku |

Sebagian angka pada tabel bersifat estimasi (ditandai dengan kata "sekitar" pada dokumen sumber); angka eksak hanya yang tertulis di tabel utama. Dokumentasi sumber juga mencatat dua snapshot yang berbeda untuk 49 klaim: `analisis_hulu_hilir_diskon.md` (2026-09-29) masih menyebut 49 dokumen aktif, sedangkan `MASTER_BLUEPRINT_DAN_PROTOKOL_DISKON_PEMBELIAN.md` (2026-09-30) mencatat 0 dokumen karena sudah dipatch.

---

## 2. Konsep Diskon Hulu-Hilir (Tabel Perbandingan)

### 2.1 Peta Fase dan Level

| Fase | Modul | jenisTr | Nomer Contoh | Tabel Sumber | Peran Level |
| :--- | :--- | :---: | :--- | :--- | :--- |
| Hulu 1 - PO | `pembelian` | `466` | `PO.-1.1849` (189 unit) | `transaksi.items4_sum`, `transaksi.items5_sum` | Komitmen kontrak |
| Hulu 1b - Pre-PO | `pembelian` | `466r` | `PRE.PO.FG` | `stock_locker_pre_diskon` | Plafon awal hak diskon |
| Hulu 2 - GRN | `pembelian` | `467` | `GRN.-1.2496` (50 unit) | `stock_locker_diskon` | Terbitnya hak fisik gudang |
| Hulu 3 - Import GRN | `pembelian` | `460` | `GRN.IMP` | `stock_locker_diskon` | Terbitnya hak fisik impor |
| Hilir 1 - Klaim | `kompensasiharga` | `3333` | `3333.-1.191`, `3333.-1.2570` | `__rek_pembantu_subpiutangsuppliertrans__1010020030` | Realisasi pencairan piutang |
| Hilir 1b - Tambahan diskon | `kompensasiharga` | `3344` | - | `stock_locker_diskon` | Rebate / diskon tambahan supplier |
| Hilir 2 - Monitoring | `kompensasiharga` | `3333` | DataTable | `stock_locker_diskon` UNION cache | Tampilan sisa diskon |
| Anomali - Retur | `returpembelian` | `9911` | `trash_4 = 1` | `stock_locker_diskon` baris kontra | Penolakan hak diskon |

### 2.2 Perbandingan Level Hulu vs Hilir

| Aspek | Level Hulu (PO `466` / GRN `467`) | Level Hilir (Klaim `3333` / DataTable) |
| :--- | :--- | :--- |
| Transaksi | Penerbitan PO dan penerimaan barang | Realisasi klaim ke supplier, monitoring |
| Orientasi | Fengsu (barang masuk) | Pengakuan piutang dan pencairan |
| Sumber primer | `stock_locker_diskon` kolom `nilai` | `__rek_pembantu_subpiutangsuppliertrans__1010020030` |
| Sumber fallback | Tidak ada fallback resmi | `_rek_pembantu_subpiutangsuppliertrans_cache` |
| Arah jurnal | Debet COA `1010020030` | Kredit COA `1010020030` |
| Kunci dokumen | `transaksi_id` OR `nomer` | `extern_id` / `extern2_id` / `extern3_id` |
| Status doc | `status = 1`, `trash = 0` | `trash_4 = 0` |
| Risiko utama | Over-debit 2x-4x, slot locker hilang | Mutasi kredit gagal formed, fallback angka bengkak |
| File inti | `PreSyncDiskonPembelian.php`, `coTransaksiCore.php` | `coTransaksiUi.php`, `Transaksi.php`, `ComRekeningPembantuPiutangSupplierDetailTransItem.php` |

### 2.3 Kerangka 3-Way Matching dan Kriteria Status

Setiap GRN dinyatakan **Sehat / Selaras Sempurna** hanya bila tiga syarat terpenuhi:

1. `Hak Seharusnya (Pilar 1) == Total Terbit Locker (Pilar 2)` dengan toleransi diskrepansi rounding paling besar Rp 100.
2. `Total Terbit Locker (Pilar 2) == Debet Jurnal Piutang (Pilar 3)`.
3. `Total Locker Diklaim == Kredit Jurnal Realisasi (Klaim 3333)`.

Rumus pembanding:

- Pilar 1: `Expected Diskon = SUM(Qty Diterima x Tarif Diskon Satuan)`
- Pilar 2: `Total Terbit Locker = SUM((nilai + IFNULL(nilai_diklaim, 0)) x IF(jumlah < 0, -1, 1))`
- Pilar 3: `Debet Jurnal Piutang = SUM(debet pada COA 1010020030)` dan `Kredit Realisasi Klaim = SUM(kredit dari dokumen 3333)`

Klasifikasi status anomali:

| Status | Formula Ambang | Titik Rusak |
| :--- | :--- | :--- |
| MATCHED | `Pilar 1 == Pilar 2 == Debet Pilar 3` (toleransi <= Rp 100) dan `Klaim Locker == Kredit Jurnal` | - |
| OVER-DEBIT JURNAL | `Debet Jurnal > 1.2 x Total Terbit Locker` | 2B |
| LOCKER DEFISIT / TER-WIPE | `Total Terbit Locker < Expected Diskon - 100` | 2A |
| KLAIM DESINKRONISASI | `ABS(Klaim Locker - Kredit Jurnal) > 100` | 3 |
| RETUR MENGGANTUNG | `Saldo Buku == 0` DAN `Saldo Locker > 100` DAN ada dokumen `9911` | Anomali retur |

---

## 3. Aturan Pembacaan Data Diskon

### 3.1 Dekoder Blob Registry PHP 5.6 Safe

Rincian tarif diskon per barang disimpan sebagai serialized PHP yang di-base64 pada `transaksi.items4_sum` (diskon nominal atau persen) dan `transaksi.items5_sum` (diskon hadiah barang atau promo free produk). Unserialize bawaan PHP 5.6 pada arsitektur 64-bit sering gagal karena payload integer 64-bit (contoh `i:10000000000;`). Normalisasi WAJIB sebelum unserialize:

```php
$fnDecodeRegistry = function($blob) {
    if (empty($blob)) return array();
    $decoded = base64_decode($blob);
    if (!$decoded) return array();
    $fixed = preg_replace_callback('/i:(\d{10,});/', function($m) {
        return 's:' . strlen($m[1]) . ':"' . $m[1] . '";';
    }, $decoded);
    $res = @unserialize($fixed);
    return is_array($res) ? $res : array();
};
```

### 3.2 Kolom Kritis `stock_locker_diskon`

| Kolom | Status | Aturan |
| :--- | :--- | :--- |
| `nilai` | Saldo riil | WAJIB dipakai sebagai saldo hak aktif yang tersisa dan dapat dipotong |
| `nilai_unit` | Nilai semu | DILARANG dipakai sebagai saldo; pernah terisi angka lama setelah proses repair/reset `nilai = 0` |
| `nilai_diklaim` | Akumulasi klaim | Diisi saat klaim `3333`, menambah nilai yang sama saat pengurangan `nilai` |
| `jumlah` | Pengali arah | `jumlah < 0` berarti baris pembalik kontra retur, nilainya dikalikan -1 |
| `state` | Status baris | `active` untuk slot sah |
| `jenis_locker` | Klasifikasi | `stock` untuk locker fisik |
| `jenis` | Klasifikasi | `diskon` untuk baris diskon |
| `produk_id` | Slot diskon | 1 sampai 8; `produk_id = 7` berarti free produk |
| `transaksi_id` | Relasi | ID transaksi GRN |
| `nomer` | Relasi alternatif | Nomer dokumen fisik, wajib dipakai bersama `transaksi_id` |

Formula baku agregasi locker:

```sql
-- FORMULA RESMI AGREGASI SALDO LOCKER DISKON
SELECT
    SUM((nilai + IFNULL(nilai_diklaim, 0)) * IF(jumlah < 0, -1, 1)) AS total_locker_terbit,
    SUM(nilai * IF(jumlah < 0, -1, 1)) AS sisa_locker_aktif,
    SUM(IFNULL(nilai_diklaim, 0) * IF(jumlah < 0, -1, 1)) AS total_locker_klaim
FROM stock_locker_diskon
WHERE (transaksi_id = 34662 OR nomer = 'GRN.-1.2496')
  AND jenis_locker = 'stock'
  AND jenis = 'diskon';
```

### 3.3 Aturan Relasi Kunci Dokumen Ganda

Pada database live, data lama atau hasil migrasi kadang mengisi kolom `nomer`, bukan `transaksi_id` (terisi 0 atau ID lama). Setiap pencarian slot locker WAJIB memakai klausa ganda:

```sql
WHERE (transaksi_id = $grnId OR nomer = '$grnNomer')
```

Hal yang sama berlaku pada relasi klaim `3333` ke GRN asal: `reference_id = grn.id` ATAU `reference_nomer = grn.nomer`.

### 3.4 Deteksi Tabel Sharded Buku Pembantu

Sistem mempartisi buku pembantu per kode COA dengan nama tabel berakhiran COA.

| Urutan | Tabel | Kondisi Pemakaian |
| :--- | :--- | :--- |
| 1 | `__rek_pembantu_subpiutangsuppliertrans__1010020030` | Tabel prioritas (sharded) |
| 2 | `_rek_pembantu_subpiutangsuppliertrans` | Fallback bila tabel sharded belum terbentuk |
| 3 | `_rek_pembantu_subpiutangsuppliertrans_cache` | Fallback kedua dengan filter `periode = 'forever'` |

### 3.5 Aturan Debet dan Kredit

- **Debet (Pengakuan Piutang Diskon):** GRN mendebet rekening `1010020030` sebagai pengakuan hak klaim ke supplier atas barang yang sudah masuk gudang.
- **Kredit (Pencairan atau Pelunasan):** Terjadi saat dokumen klaim diskon `3333` diterbitkan ke kasir atau supplier, atau saat pembatalan retur pembelian `9911`.

### 3.6 Aturan Transaksi Pemotong

- **Klaim `3333`:** mengurangi `nilai` pada `stock_locker_diskon`, menambahkan nilai sama ke `nilai_diklaim`, dan menjurnal mutasi KREDIT pada `1010020030`.
- **Retur / pembatalan `9911` (`trash_4 = 1`):** sistem mencatat baris pembalik kontra dengan `jumlah = -1` dan `nilai = -X` untuk menolkan saldo fisik. GRN dengan `trash_4 = 1` WAJIB dieksklusi dari kueri anomali aktif dengan filter `WHERE (t.trash_4 = 0 OR t.trash_4 IS NULL)`.

### 3.7 Aturan Handling Pengiriman Parsial

Penyebab over-debit pada PO parsial adalah pengakuan di muka (*in-advance lump-sum recognition*) oleh modul pembelian lawas. Indikasi forensik:

- GRN ke-1: `debet_jurnal > 1.2 * total_locker`.
- GRN ke-2 dan seterusnya: fisik locker terbit sesuai barang, tetapi `debet_jurnal = 0` karena sudah dijurnal di muka.

Kondisi ini dinilai sebagai diskrepansi waktu pengakuan (*timing difference*), bukan kehilangan uang riil. Analisis WAJIB dilakukan kumulatif pada level PO dengan pengelompokan per induk PO.

### 3.8 Keselamatan Kueri (Query Safety)

- **KRITIKAL:** DILARANG menulis komentar PHP single-line `// ...` di dalam string SQL PHP (`$sql = " ... ";`). PHP tidak mengabaikan `//` di dalam tanda kutip, sehingga `//` terkirim mentah ke MariaDB dan memicu syntax error 1064. Akibatnya kueri mengembalikan `FALSE` dan seluruh KPI tampil `0 GRN`. Gunakan komentar SQL `-- komentar` atau `/* komentar */`.
- **Multi-database host:** DB `192.168.5.10` (`everest_26sep`) adalah operasional utama harian; DB `192.168.5.17` (`run_everest_modul`) adalah replika atau staging AI analitik. Parameter switcher URL wajib mendukung `?source=517` maupun `?source=5.17`.

### 3.9 Diskon 7 (Free Produk)

`produk_id = 7` menandai free produk atau hadiah barang. Aturally, bonus barang pada PO umumnya hanya diserahkan pada salah satu pengiriman GRN pertama, bukan dipecah proporsional di seluruh GRN parsial.

---

## 4. Protokol Diskon Pembelian (Master Blueprint)

### 4.1 Kedudukan Master Blueprint

`MASTER_BLUEPRINT_DAN_PROTOKOL_DISKON_PEMBELIAN.md` ditetapkan sebagai **MANDATORY STANDARD** dan menyintesis tiga dokumen: `analisis_hulu_hilir_diskon.md`, `ATURAN_PEMBACAAN_DATA_DISKON.md`, dan `rencana_perbaikan_codebase_diskon.md`. Setiap perubahan kode yang menyentuh `stock_locker_diskon`, `stock_locker_pre_diskon`, atau rekening `1010020030` WAJIB mengacu pada blueprint tersebut.

### 4.2 Kerangka Investigasi Forensik 5W+1H

| Elemen | Dimensi | Pertanyaan Kunci |
| :--- | :--- | :--- |
| WHAT | Status ketersediaan hak | Apakah diskon aktif, habis terklaim sah, ter-wipe (0 tanpa klaim), atau menggantung akibat retur? |
| WHO | Pihak terlibat | ID dan nama supplier, petugas penerima barang GRN, kasir proses klaim `3333` |
| WHERE | Jejak audit 4 lapis | `stock_locker_pre_diskon` -> `stock_locker_diskon` -> `__rek_pembantu_...` -> `jurnal` GL |
| WHEN | Kronologi dan aging | Tanggal PO -> GRN -> debet jurnal -> realisasi klaim `3333`, beserta rentang hari |
| WHY | Kausalitas | Reset di `PreSyncDiskonPembelian`, duplikasi komponen di `coTransaksiCore`, atau mismatch di `coTransaksiUi`? |
| HOW | Tindakan rekonsiliasi | Normalisasi debet cache, restorasi slot locker, atau suntik mutasi kredit susulan? |

### 4.3 Anatomi Detail Empat Titik Kerusakan

**Titik 1 - Plafon awal pre-locker nol**
- Lokasi: `application/models/Preprocs/PreSyncDiskonPembelian.php`
- Gejala: seluruh baris `stock_locker_pre_diskon` bernilai `0.0000000000` (PO `383654` / `PO.-1.1849`).
- Akar masalah: filter kueri mengasumsikan nilai sudah ada di locker sebelum transaksi disimpan, atau lookup gagal memetakan id supplier atau cabang sehingga menghasilkan `0`.
- Dampak berantai: nilai 0 menjadi trigger kondisi destruktif di fase GRN.

**Titik 2A - Slot fisik locker ter-wipe saat simpan GRN**
- Lokasi: `PreSyncDiskonPembelian.php` baris 276-284 dan 327.
- Gejala: GRN punya hak diskon pada kontrak atau registry, tetapi slot barisnya TIDAK PERNAH TERBIT di `stock_locker_diskon` (Diskon 1 pada `GRN.-1.2496`).
- Akar masalah pada baris 327:

```php
$m->addFilter("transaksi_id='$po_id'");
$m->addFilter("reference_id='$referenceID'");
$m->addFilter("nilai>'10'");
$tmp = $m->lookUpAll()->result();
```

- Efek destruktif:

```php
$key_reset = "diskon_$diskon_key_id" . "_nilai";
$_SESSION[$cCode][$src_key][$pID][$key_reset] = 0;
$_SESSION[$cCode][$src_key][$pID]["sub_" . $key_reset] = 0;
```

**Titik 2B - Over-debit buku pembantu `1010020030`**
- Lokasi: `application/modules/pembelian/config/coTransaksiCore.php` step `467`.
- Akar masalah 1 (duplikasi komponen): master `[98]`/`[99]` mendebet `1010020030` memakai `main['diskon_nilai_total']`, sementara detail `[3]`, `[4]`, `[5]`, `[6]` mendebet rekening sama per baris barang dari `items4_sum['sub_diskon_nilai']`. Keduanya berjalan bersamaan.
- Akar masalah 2 (lump-sum PO parsial): `main['diskon_nilai_total']` menyalin Rp 24.628.767 (total PO) alih-alih Rp 12.076.285 (proporsional 50 dari 189 unit).

**Titik 3 - Mismatch selector ID klaim `3333`**
- Lokasi: `application/modules/kompensasiharga/config/coTransaksiUi.php` baris 2610.
- Konfigurasi cacat:

```php
"pihakNameMainDiskonIdSelector" => "id",
"pihakNameMainDiskonIdProcessor" => "id",
```

- Dampak: `pihakMainID` terkirim berisi `2`, query mutasi kredit `WHERE extern_id = '2' AND extern2_id = '' AND extern3_id = '11'` tidak menemukan cache yang tercatat `extern_id = 34662`, sehingga 49 dokumen klaim gagal forming mutasi kredit (43 di antaranya serentak pada 2026-07-22).

**Titik 4 - Fallback DataTable menampilkan angka bengkak**
- Lokasi: `application/modules/kompensasiharga/controllers/Transaksi.php` baris 6345-6385 pada `viewKlaimSupplierDataAjax()`.
- Aritmetika: `Debet 24.628.767 - Klaim 4.443.029 = 20.185.738`, padahal seharusnya `7.633.256` untuk Diskon 1 pada `GRN.-1.2496`.

**Anomali khusus - Retur `9911` belum melepas locker fisik**
- Lokasi: modul `returpembelian`, jenisTr `9911`, ditandai `trash_4 = 1`.
- Gejala: jurnal sudah mengkredit piutang kembali ke Rp 0, tetapi `stock_locker_diskon` masih aktif utuh.
- Akar masalah: modul retur memposting mutasi pembatalan akuntansi tanpa menginstruksikan modul locker menerbitkan baris pembalik kontra `jumlah = -1` atau menolkan kolom `nilai`, sehingga petugas dapat mencairkan klaim atas barang yang sudah diretur.

### 4.4 Matriks Dampak Tahunan

| Kategori data bermasalah | 2024 | 2025 | 2026 | Total | Status terkini |
| :--- | ---: | ---: | ---: | ---: | :--- |
| Klaim `3333` tanpa mutasi kredit | 6 dok | 0 dok | 43 dok | 49 dokumen | Terhenti sejak update selector, 49 dokumen lama menggantung |
| GRN `467` jurnal over / beda locker | 1.075 dok | 920 dok | 314 dok | 2.308 dokumen | Masih aktif setiap hari, terkonfirmasi 2026-09-29 dengan debet 4x |

---

## 5. Kompensasi Harga

### 5.1 Arsitektur Modul `kompensasiharga`

Base controller `Modul_Controller.php` melakukan session validation (`gotoLogin()`, `validateUserSession()`), memuat 4 config wajib (`coTransaksiUi`, `coTransaksiCore`, `coTransaksiLayout`, `coTransaksiValues`), mem-parse `jenisTr` dari URI segment 4, dan membentuk `cCode = "_TR_" + jenisTr`.

| Controller | Ukuran | Peran |
| :--- | :--- | :--- |
| `Transaksi.php` | 6.807 baris | Index, panel klaim, DataTable, initKlaimQueue, utility saldo |
| `Create.php` | 11.579 baris | Form klaim,(queue mode), save, helper ringkasan |
| `FollowUp.php` | 1.504.556 byte | Pembaruan/revisi transaksi klaim |
| `_shoppingCart.php` | - | Keranjang item klaim |
| `_processSelectNota.php` | - | Selector nota/GRN |
| `_processSelectNotaItem.php` | - | Selector item nota |
| `_processSelectProduct.php` | - | Selector produk diskon |
| `_selectorItem.php`, `_selectorPihak.php`, `_selectorPihakMain.php` | - | Selector item, pihak, dan pihak utama (pembawa bug `pihakMainID`) |
| `Printing.php` | - | Cetak dokumen klaim |
| `ActivityReport.php` | - | Laporan aktivitas |

### 5.2 Tiga Panel AJAX pada Index

| Panel ID | Target URL | Fungsi |
| :--- | :--- | :--- |
| `#undoneList` | `Transaksi/viewUndoneItemsIndex/{jenisTr}` | Daftar transaksi belum selesai |
| `#historyList` | `History/showData/{jenisTr}` | Riwayat 10 transaksi terakhir |
| `#klaimList` | `Transaksi/viewKlaimSupplierIndex/{jenisTr}` | Daftar klaim ke supplier |

Untuk `jenisTr = '3333'`, panel `#undoneList` di-hide dan di-empty; hanya `#historyList` dan `#klaimList` ditampilkan. Data yang dikirim ke view: `mode`, `template`, `title`, `subTitle` (dari `steps[1]['label']`), `jenisTr`, `addLink`, `scriptBotto`, `steps`, `allSteps`, `linkMenu`.

### 5.3 DataTable `viewKlaimSupplierDataAjax()`

Lokasi: `Transaksi.php` baris 5802-6639. Alur query: parse parameter DataTable, build `whereBase`, count total records, count sisa dengan JOIN locker UNION cache, hitung badge count per Diskon 1-8, tentukan kategori badge, pilih JOIN sesuai filter aktif, proses search value dengan reverse prefix translation map, counter extraction, ekspansi relasi PO/Pre-PO, query page data plus lookups, bangun JSON response.

Sumber data bersifat dual-source plus fallback:

| Sumber | Peran |
| :--- | :--- |
| `stock_locker_diskon` | Sumber primer (fisik) |
| `subpiutangsuppliertrans_cache` | Sumber sekunder / fallback |
| `subpiutangsuppliertrans` COA `1010020030` | Mutasi klaim (riwayat klaim diproses) |

Setiap transaksi GRN menampilkan hingga 8 slot diskon (`diskon_1_nilai` sampai `diskon_8_nilai`). Logika pengisian per slot: prioritas `stock_locker_diskon`; bila `nilai = 0`, cek `_rek_pembantu_subpiutangsuppliertrans_cache` untuk slot yang sama; `sisa_diskon` dihitung dari gabungan keduanya.

### 5.4 Badge Filter System

| Filter Key | Keterangan | Logika SQL |
| :--- | :--- | :--- |
| `all` | Semua nota dengan sisa diskon | UNION locker + cache, `nilai >= 1` |
| `reguler` | Diskon reguler tanpa free produk | `has_fp=0`, `has_reg=1` |
| `freeproduk` | Free produk saja | `has_fp=1`, `has_reg=0`, `produk_id=7` |
| `kombinasi` | Reguler + free produk | `has_fp=1`, `has_reg=1` |
| `d1` .. `d8` | Diskon spesifik per `produk_id` | `produk_id = N` |

### 5.5 Reverse Prefix Translation Map

| Format UI | Kode DB |
| :--- | :--- |
| `PRE.PO.FG.IMP` | `460r` |
| `PO.FG.IMP` | `460a` |
| `GRN.IMP` | `460` |
| `PRE.PO.FG` | `466r` |
| `PO.FG` | `466` |
| `PRE.GRN` | `467r` |
| `GRN` | `467` |
| `KPH` | `3333` |

### 5.6 Struktur JSON Response

```json
{
  "draw": 1,
  "recordsTotal": 150,
  "recordsFiltered": 45,
  "data": [["<checkbox>", 1, "2026-01-15", "PT ABC", "467.-1.3420", "..."]],
  "countSisa": 45,
  "countTotal": 150,
  "diskonBadges": {
    "all": 45, "reguler": 20, "freeproduk": 15, "kombinasi": 10,
    "d1": 30, "d2": 25, "d3": 10, "d4": 5, "d5": 3, "d6": 2, "d7": 15
  },
  "sumFooterGlobal": { "diskon_1_nilai": 5000000, "sisa_diskon": 15000000 },
  "sumFooterPage": { "diskon_1_nilai": 500000 }
}
```

### 5.7 Antrian Klaim (Queue Mode `3333`)

`Transaksi::initKlaimQueue()` (baris 6642-6729) menerima POST berisi array `items[]` dari checkbox DataTable. Validasi: jika tidak ada item valid, return error JSON; setiap item diperiksa `trash_4 != 1`; bila ada yang dibatalkan, return error "nota diretur". Setelah lolos, session `_TR_3333` di-reset dan antrean disimpan.

Struktur session antrean:

```php
$_SESSION['klaim_queue_3333'] = array(
    "current_index" => 0,
    "supplier_id"   => 123,
    "supplier_nama"  => "PT ABC",
    "is_freeproduk"  => 0,
    "items" => array(
        0 => array(
            "grn_id"        => 456,
            "nomer"         => "467.-1.3420",
            "sisa"          => 5000000.0,
            "supplier_id"   => 123,
            "supplier_nama" => "PT ABC",
            "is_freeproduk" => 0,
            "status"        => "pending",
            "klaim_nomer"   => "",
            "klaim_dtime"   => "",
        ),
    ),
    "total_items" => 5,
    "created_at"  => "2026-01-15 10:30:00",
);
```

Perintah antrian pada `Create::index()` (baris 47-1187):

| Parameter GET | Fungsi |
| :--- | :--- |
| `queueMode=1` | Aktifkan mode antrian |
| `jumpQueue={idx}` | Loncat ke item antrian tertentu |
| `skipQueue=1` | Lewati item aktif, pindah berikutnya |
| `removeQueue={idx}` | Keluarkan item dari antrian |
| `cancelQueue=1` | Batalkan seluruh antrian |

`Create::loadQueueGrnIntoSession()` (baris 1190-1481): reset `items`/`items2`/`items2_sum`, set Branch PUSAT (DC) dengan `cabangID = -1`, set supplier dari parameter antrian, set nota/GRN aktif, lookup PPN vendor dari registry GRN, load `stock_locker_diskon` via `MdlLockerStockDiskonVendor`. Filter berbeda menurut `isFreeProduk`: untuk free produk `produk_id = 7` dengan `jumlah > 0`; untuk reguler `produk_id IN (0..6, 8)` dengan `nilai > 0`. Struktur item session:

```php
$_SESSION[$cCode]['items'][$key_header] = array(
    "handler"      => "kompensasiharga/_processSelectNota",
    "id"           => $row_id,
    "refID"        => $grnId,
    "jml"          => $itemJml,
    "harga"        => $itemHarga,
    "subtotal"     => $jml * $harga,
    "diskon_id"    => $produk_id,
    "diskon_nama"  => $nama,
    "nama"         => $nomer,
    "transaksi_id" => $grnId,
    "ppnFactor"    => $finalPpnVendor,
);
```

Setelah `save()` (baris 5379-5430) berhasil, item aktif ditandai `status = 'completed'`, `klaim_nomer` dan `klaim_dtime` diisi, lalu sistem mencari item pending berikutnya. Jika tidak ada, `queueCompleted = true`, `buildQueueSummaryHtml()` (baris 11419-11512) membangun tabel ringkasan (deteksi multi-supplier), `unset SESSION klaim_queue_3333`, SweetAlert2 "PROSES ANTRIAN SUKSES", redirect ke `Transaksi/Index/3333`. Halaman sukses standalone `renderQueueSuccessPage()` (baris 11514-11577) memakai panel Bootstrap `panel-success`.

### 5.8 Utility Saldo Diskon

| Fungsi | Tabel Target | Fungsi |
| :--- | :--- | :--- |
| `cekSaldoDiskonGrn($kiriman)` | `_rek_pembantu_subpiutangsuppliertrans_cache` | Reset `debet = 0` untuk array of `extern_id` |
| `cekSaldoDiskonGrnCache($kiriman)` | `_rek_pembantu_subpiutangsuppliertrans_cache` | Update `debet` per supplier, transaksi, `diskon_id` |

### 5.9 Config Key `viewKlaimSupplier`

Lokasi `coTransaksiUi.php` baris 3515-3605.

```
viewKlaimSupplier
|--- enabled: true
|--- jenisSource: ["467"]
|--- historyFields
|   |--- dtime -> "date"
|   |--- suppliers_nama -> "supplier/vendor"
|   |--- nomer -> "Nomer GRN"
|   |--- po -> {step:2, key:"nomer"}   (Nomer PO dari ids_his)
|   |--- oleh_nama -> "person"
|   |--- diskon_1_nilai .. diskon_8_nilai
|   +--- keterangan
|--- historySumFields      (Footer sum)
|--- historyKlaimFields    (Mapping nilai_diklaim per slot)
|--- pairedModel
|   |--- comName: ComRekeningPembantuPiutangSupplierDetailTransMain
|   +--- filter: [periode=forever, rekening=1010020030]
|--- addPairedModel
|   +--- mdlName: MdlSupplier
|--- addPairedModelLocker
|   |--- mdlName: MdlLockerStockDiskonVendor
|   +--- filter: [jenis=diskon, state=active]
|--- addTabHeaderLimit: 10
+--- labelAlias
    |--- 3 -> "belum diklaim"
    |--- 4 -> "klaim sebagian"
    +--- 5 -> "sudah klaim (habis)"
```

### 5.10 Peta Tabel Database Modul

| Tabel | Kegunaan |
| :--- | :--- |
| `transaksi` | Master transaksi (GRN jenis `467`, Klaim jenis `3333`) |
| `stock_locker_diskon` | Locker fisik sisa diskon per GRN per slot |
| `_rek_pembantu_subpiutangsuppliertrans_cache` | Cache subpiutang supplier (fallback) |
| `__rek_pembantu_subpiutangsuppliertrans__1010020030` | Mutasi buku pembantu piutang supplier |
| `transaksi_data_registries` | Registry values (`main`, `ppnFactor`, dll) |

### 5.11 Jenis Transaksi dan Menu

| jenisTr | Label | Keterangan |
| :--- | :--- | :--- |
| `3333` | REALISASI KLAIM KE SUPPLIER | Transaksi utama modul (link menu 2) |
| `3344` | TAMBAHAN DISKON | Diskon tambahan oleh supplier (rebate atau mendapat barang), link menu 1 |

Link menu pada halaman index modul: (1) `Create/index/3344` dan (2) `Create/index/3333`.

---

## 6. Klaim Diskon dan Checklist UAT

### 6.1 Definition of Done Klaim

Sebuah klaim `3333` dianggap tuntas bila keempat kondisi berikut terpenuhi:

1. Saldo `nilai` pada `stock_locker_diskon` berkurang dan `nilai_diklaim` bertambah sebesar nilai klaim.
2. Mutasi KREDIT terbentuk di `__rek_pembantu_subpiutangsuppliertrans__1010020030` dengan `extern_id` yang merujuk ID GRN.
3. Akumulasi `kredit` pada `_rek_pembantu_subpiutangsuppliertrans_cache` bergerak dan nilai `debet` rekening `1010020030` berkurang tepat sebesar klaim.
4. Status dokumen GRN pada DataTable berpindah dari "Siap Diklaim" kehabisan atau sisa diskon berkurang sesuai klaim.

### 6.2 Checklist UAT Klaim `3333`

| No | Fitur / Area | Skenario Pengujian | Acceptance Criteria | Status |
| :--: | :--- | :--- | :--- | :---: |
| 1 | Index Dashboard | Akses `kompensasiharga/Transaksi/Index/3333` | Panel oranye "item you specified has no entry" hilang atau bersih | PASS/FAIL |
| 2 | Filter "Siap Diklaim" | Klik tab filter "Siap Diklaim" | Semua baris punya sisa diskon >= Rp 1 dan checkbox aktif, tidak ada sisa 0 | PASS/FAIL |
| 3 | Badge Counter | Cek angka badge (Reguler, Free Produk, Kombinasi, D1..D8) | Jumlah angka badge sesuai total data saat tombol diklik | PASS/FAIL |
| 4 | Filter Supplier | Pilih supplier di dropdown | Tabel refresh, hanya memunculkan nota milik supplier terpilih | PASS/FAIL |
| 5 | Batch Selection | Centang 2-3 nota supplier sama | Floating bar hijau memuat jumlah nota terpilih dan total nominal sisa diskon | PASS/FAIL |
| 6 | Inisiasi Antrean | Klik "Proses Klaim Bertahap" | Masuk ke `Create?queueMode=1`, banner "Nota 1 dari N" | PASS/FAIL |
| 7 | Proses Nota ke-1 | Lengkapi form dan klik "Simpan" | Transaksi tersimpan, antrean auto berpindah ke nota ke-2 | PASS/FAIL |
| 8 | Fitur Lewati (Skip) | Klik "Lewati Nota Ini (Skip)" | Nota dilewati tanpa potong saldo, form memuat nota berikutnya | PASS/FAIL |
| 9 | Batal Antrean | Klik "Batalkan Antrean (Cancel)" | Modal SweetAlert2 ringkasan: daftar selesai dan daftar diskip | PASS/FAIL |
| 10 | Selesai dan Redirect | Klik "Kembali ke Daftar Klaim" | Kembali ke Index `3333` bersih tanpa sesi menggantung | PASS/FAIL |
| 11 | Validasi Saldo | Periksa nota terklaim di tabel index | Nota hilang dari "Siap Diklaim" jika habis, atau sisa berkurang sesuai klaim | PASS/FAIL |
| 12 | Buku Bantu Cache | Cek `_rek_pembantu_subpiutangsuppliertrans_cache` | Nilai `debet` rekening `1010020030` berkurang tepat sebesar nilai klaim | PASS/FAIL |
| 13 | Locker Stock | Cek `stock_locker_diskon` pasca transaksi | Kunci hold terlepas bersih, `state` normal, tidak ada lock nyangkut | PASS/FAIL |

Hasil akhir pada dokumen UAT berstatus **LULUS (DITERIMA)** dengan kolom tanda tangan penguji dan supervisor masih kosong, serta kolom tanggal dan tester belum diisi.

### 6.3 Matriks Verifikasi dan Troubleshooting

| Parameter Uji | Sebelum Perbaikan | Target Setelah Perbaikan | Cara Verifikasi di `Tool::traceDiskonPembelian` |
| :--- | :--- | :--- | :--- |
| Kasus GRN 2496 Diskon 1 | Diskon 1 hilang di locker; layar tampil sisa Rp 20,1 Jt | Diskon 1 terbit Rp 7.633.256; sisa tampil tepat Rp 7.633.256 | Bagian 1 dan Pilar 2: 3 baris diskon lengkap dengan badge hijau |
| Penerimaan PO parsial | GRN pertama mendebet utuh Rp 24,6 Jt | GRN pertama hanya mendebet Rp 12,07 Jt proporsional 50 unit | Pilar 3 Debet Akuntansi sama dengan nilai fisik Pilar 2 |
| Input klaim baru `3333` | Mengirim `pihakMainID = 2`; mutasi kredit tidak muncul | Mengirim `pihakMainID = [ID GRN]`; mutasi kredit terposting seketika | Bagian 3 Riwayat Pemotong: badge hijau "Kredit Sukses Terposting" |
| GRN batal atau retur `9911` | Saldo buku 0, saldo locker aktif menggantung | Saldo locker dinolkan via pembalik kontra `jumlah = -1` | Status banner "DISKON dan JURNAL SESUAI LENGKAP" atau badge kontra retur |

---

## 7. Locker Finance dan Badge Unsettled

### 7.1 Transaction Concurrency Locker pada Modul Keuangan

Implementasi berbasis *Composite Key* `(cabang_id, jenis_tr, booking_number, oleh_id)` di enam modul kelompok keuangan dan akuntansi.

**Empat langkah standar wajib per modul:**

1. **Lock Registration:** memanggil `MdlLockerTransaksi::execLocker()` saat draf transaksi keuangan dibuka atau dibuat.
2. **Fail-Fast Early Validation:** memanggil `MdlLockerTransaksi::cekLoker()` di bagian paling atas controller, sebelum transaksi database atau pembentukan UI.
3. **Interactive UI Lock Modal:** menampilkan modal "Transaksi Terkunci" dengan tombol *Ambil Alih Transaksi* (`?forceRetakeLock=1`) bila petugas pertama idle >= 5 menit.
4. **Lock Release:** memastikan lock dilepas (`jumlah = 0`) setelah posting berhasil atau saat menekan Batal atau Logout.

**Spesifikasi modal "Transaksi Terkunci":**

| Field Kartu Petugas | Data Source | Contoh |
| :--- | :--- | :--- |
| Petugas Aktif | `nama_login` + `oleh_id` | Nurhayati (ID: 69) |
| IP Address | `ip_address` | 192.168.5.4 |
| Perangkat | `device_info` / `user_agent` | PC / Edge |
| Aktif Terakhir | `dtime_last_active` | 2026-08-14 13:30:45 |

Tombol aksi: (1) "Ambil Alih Transaksi (Petugas Idle)" disabled bila `Aktif Terakhir` < 5 menit dengan indikator timer, aktif bila >= 5 menit (mengubah `jumlah = 0` dan mengalihkan kunci); (2) "Kembali ke Daftar Transaksi".

**Status Implementasi per Modul:**

| # | Modul | Controller Terdampak | Status Rata-rata |
| :--: | :--- | :--- | :--- |
| 1 | `pembayaran` (A/P Settlement) | `Create.php`, `FollowUp.php`, `_shoppingCart.php`, `_processSelectNota.php` | 5 checklist tercentang |
| 2 | `penerimaan` dan `penerimaanprojek` (A/R Receipt) | `penerimaan/Create.php`, `FollowUp.php`, `_processSelectNota.php`, `penerimaanprojek/Create.php` | 6 checklist tercentang (termasuk Multi-Branch Isolation Test) |
| 3 | `kas` dan `pettycast` | `kas/Create.php`, `kas/FollowUp.php`, `pettycast/Create.php` | 4 checklist tercentang |
| 4 | `biaya` | `Create.php`, `FollowUp.php`, `_processSelectBiaya.php` | 4 checklist tercentang |
| 5 | `settlement` | `Create.php`, `FollowUp.php` | 4 checklist tercentang |
| 6 | `adjustmentjurnal` | `Create.php`, `FollowUp.php` | 4 checklist tercentang |

Pada `pembayaran` dan `penerimaan` terdapat Lock Registration tambahan pada `_processSelectNota.php`: kunci nota saat checkbox dicentang dengan Composite Key `cabang_id`, `transaksi_id = trID`, `state = 'hold'`, plus dukungan retake lock bila idle >= 5 menit.

### 7.2 Badge Unsettled Transaksi (`my settlement`)

Target: modul `penerimaan` (jenisTr `749` A/R Receipt) dan modul `kas`. Tujuan: menampilkan badge counter angka pada tombol `my settlement` (fuchsia/pink di bilah navigasi kanan atas) untuk jumlah nota penerimaan kas milik kasir aktif yang belum diselesaikan atau disetor (`sisa > 0`).

| Aspek | Keputusan Desain |
| :--- | :--- |
| Lingkup | Opsi A - personal kasir: `extern_id = my_id()` dan `cabang_id = my_cabang_id()` |
| Kondisi tampil | Fail-clean: `Count > 0` tampil badge; `Count == 0` kembalikan string kosong, tombol tetap bersih tanpa angka 0 |
| Gaya badge | `background:#ffffff`, `color:#d81b60`, `font-weight:bold`, `border-radius:10px`, `padding:2px 7px`, `font-size:11px`, `box-shadow:0 1px 2px rgba(0,0,0,0.2)` |

Sumber data: tabel `transaksi_payment_source`. Kriteria filter dengan Active Record:

```php
$this->db->from("transaksi_payment_source");
$this->db->where("target_jenis", "759");   // Penyetoran Kas / Settlement
$this->db->where("sisa >", 0);
$this->db->where("cabang_id", $cabangId);
$this->db->where("extern_id", $userId);
$count = (int)$this->db->count_all_results();
```

Efisiensi: agregasi `COUNT(1)` langsung pada tabel yang berindeks `target_jenis`, `cabang_id`, dan `extern_id`, eksekusi sekitar 2-3 ms.

Berkas yang dimodifikasi:

| # | Berkas | Perubahan |
| :--: | :--- | :--- |
| 1 | `application/helpers/he_misc_helper.php` | Tambah fungsi global `getMySettlementBadgeHtml()` kompatibel PHP 5.6 dengan guard `function_exists` dan validasi `session->login['id']` serta `session->login['cabang_id']` |
| 2 | `application/libraries/Layout.php` | Daftarkan tag `{settlement_badge}` pada method `__construct()` |
| 3 | `application/modules/penerimaan/views/transaksi.php` | Daftarkan tag pada `case "index"` |
| 4 | `application/modules/penerimaan/template/transaksi_index.html` | Sisipkan `{settlement_badge}` pada `li#viewMySettlement` |
| 5 | `application/modules/kas/views/transaksi.php` | Daftarkan tag pada `case "index"` |
| 6 | `application/modules/kas/template/transaksi_index.html` | Sisipkan `{settlement_badge}` pada `li#viewMySettlement` |

Template target:

```html
<li id="viewMySettlement">
    <a class="text-white bg-fuchsia" href="{base}settlement/Transaksi/index/759"
       data-toggle="tooltip" data-placement="bottom" title="my {trName} settlement">
        <span class='fa fa-gg'></span> my settlement {settlement_badge}
    </a>
</li>
```

Prosedur uji: (1) kasir dengan tanggungan setoran (`count > 0`) membuka `penerimaan/Transaksi/index/749` dan `kas/Transaksi/index/...` dan memastikan badge muncul; (2) kasir tanpa tanggungan setelah semua settlement selesai, refresh, pastikan tombol bersih; (3) uji kompatibilitas sintaks PHP 5.6 memakai `intval()` dan `array()`, tanpa operator `??`.

Status dokumen handbook: siap dikerjakan, disimpan sebagai handbook sesuai instruksi.

---

## 8. Pembatalan dan Lock Transaksi

### 8.1 Modul `pembatalan`

Modul ini membatalkan transaksi yang sudah tercatat. Analisis berfokus pada `_processSelectNotaRevert.php` fungsi `select()`.

| Aspek | Temuan |
| :--- | :--- |
| Locker stok produk | Jika `lockerCheck.enabled == true`: lookup `MdlLockerStock` sesuai konfigurasi, validasi ketersediaan stok, update `active` stock untuk mengurangi jumlah tersedia, update atau insert `hold` stock untuk user saat seleksi barang |
| Locker transaksi di `select()` | TIDAK ADA; tidak ada penguncian nomor nota atau transaksi pembatalan secara keseluruhan, tidak ada pencegahan notifikasi atau nota yang sama dipilih ulang user lain |
| Locker transaksi di post-processing | Hanya pada konfigurasi `16677` dan `16678` ditemukan `LockerTransaksi` yang mengubah status hold untuk transaksi komisi; merupakan mekanisme khusus setelah save |

Pembedaan penting: `locker stock` melindungi stok item, sedangkan `locker transaksi` melindungi dokumen nota atau transaksi secara langsung.

### 8.2 Validasi Pra-Pembatalan yang Sudah Ada

- FIFO stock validation untuk jenis nota tertentu.
- Cek apakah ada registri yang menunjukkan transaksi sudah dikirim atau diproses.
- Cek detail qty (`produk_ord_jml` vs `valid_qty`) saat `detailCekQty` diaktifkan.
- Pemeriksaan hubungan transaksi dengan payment source, sales order, packing list, dan retur.

Kasus umum pembatalan: salah barang, salah orang, salah metode pembayaran, stok tidak tersedia atau barang habis, transaksi sudah diproses lebih lanjut (faktur, kirim, retur), masalah invoice atau payment source.

Kondisi pemblokiran pembatalan: transaksi sudah dikirim sebagai packing list (`5822spd`, `5823spd`), faktur PPN keluaran sudah dibuat, retur pembelian atau retur penjualan sudah tercatat, nota atau SO sudah cancel/reject sebelumnya.

### 8.3 Rekomendasi Teknis Pembatalan

- Validasi locker transaksi di awal `select()` memakai model `LockerTransaksi` atau similar; cek `state = 'hold'` dan `jumlah = 1`; bila ada lock aktif tampilkan pesan nota sedang diproses user lain; lepas lock saat pembatalan selesai. Target utama: mencegah `select` ulang nota `9912` atau `9911`.
- Pertajam validasi: cek status transaksi induk atau referensi, cek ulang ketersediaan stok bila pembatalan mengembalikan stok, verifikasi apakah pembayaran terkait sudah dibatalkan.
- Pembagian peran tim: programmer mengimplementasikan locker transaksi, analis bisnis menentukan alasan pembatalan yang wajib ditangani, tim QA membuat skenario uji untuk kasus `select` ulang dan pembatalan nota.

### 8.4 Antisipasi Race Condition dengan Row Locking

`SELECT` biasa tidak cukup bila dua user membuka nota bersamaan. Rekomendasi memakai MariaDB Row Locking `FOR UPDATE` di dalam `$this->db->trans_start()` sampai `$this->db->trans_complete()`:

```sql
SELECT id, oleh_id, oleh_nama
FROM stock_locker_transaksi
WHERE transaksi_id = ?
  AND state = 'hold'
  AND jumlah = '1'
FOR UPDATE
```

Notifikasi ramah pengguna awam menghindari istilah teknis. Judul: "Dokumen Sedang Digunakan". Pesan: "Maaf, Nota ini sedang diproses oleh [Nama Pengguna] ([Cabang]). Mohon tunggu beberapa saat atau hubungi rekan Anda untuk bergantian memproses nota ini agar data tidak tumpang tindih." Opsi ambil alih ditampilkan bila idle > 5 menit dengan tombol "Ambil Alih Dokumen".

### 8.5 Mekanisme Pencegahan Double Payment (Pessimistic Lock + Heartbeat)

Arsitektur untuk mencegah pelunasan ganda pada faktur yang sama memakai *stateless session lock* berbasis waktu (TTL) pendek yang diperpanjang heartbeat.

| Tahap | Mekanisme | Detail |
| :--- | :--- | :--- |
| 1 | Pembukaan halaman | Terbitkan kunci dengan TTL 60 detik plus token unik ke browser Pengguna A. Syarat: faktur belum dikunci ATAU `locked_until` sudah kedaluwarsa. Simpan ID User, waktu `sekarang + 60 detik`, dan `Lock Token` |
| 2 | Penolakan akses | Pengguna B ditolak dan dialihkan ke daftar faktur dengan pesan peringatan |
| 3 | Heartbeat | AJAX setiap 30 detik membawa ID Faktur dan Lock Token; bila token cocok, `locked_until` di-update menjadi `waktu sekarang + 60 detik` |
| 4 | Unlock skenario A | Pembayaran berhasil: server validasi Lock Token, transaksi diproses, kolom penguncian di-set NULL |
| 5 | Unlock skenario B | Pengguna menekan Batal: script JavaScript menembak API Unlock via AJAX, kunci terhapus instan sebelum halaman berpindah |
| 6 | Unlock skenario C | Browser ditutup tanpa logout: heartbeat terhenti, kunci expired maksimal 60 detik, Pengguna B dapat mengambil alih |

**Garda final (proteksi lapis akhir):** saat submit, server memeriksa (1) `Lock Token` dari form masih cocok dengan database, (2) `locked_until` belum kedaluwarsa. Jika tidak cocok atau kedaluwarsa, pembayaran dibatalkan demi keamanan data dan pengguna diminta memuat ulang halaman.

### 8.6 Relasi Pembatalan dengan Locker Diskon

Retur pembelian `9911` memotong jalur yang sama dengan pembatalan: memposting kredit pembantu piutang (saldo buku menjadi 0) tanpa menerbitkan baris pembalik kontra di `stock_locker_diskon`. Konsekuensinya saldo locker menggantung dan rawan dicairkan ganda. Perbaikan yang disepakati: terbitnya baris kontra `jumlah = -1`, `nilai = -X`, dan filter `trash_4 = 0` pada dashboard.

---

## 9. Rencana Perbaikan Codebase Diskon

### 9.1 Peta File dan Peran

```
w:\everest_opname28sep\
|--- application/
|   |--- models/
|   |   |--- Preprocs/
|   |   |   +--- PreSyncDiskonPembelian.php                        [PILAR 1 - HULU]
|   |   +--- Coms/
|   |       +--- ComRekeningPembantuPiutangSupplierDetailTransItem.php [PILAR 2 - HILIR]
|   +--- modules/
|       |--- pembelian/
|       |   +--- config/
|       |       +--- coTransaksiCore.php                           [PILAR 1 - HULU]
|       +--- kompensasiharga/
|           |--- config/
|           |   +--- coTransaksiUi.php                             [PILAR 2 - HILIR]
|           +--- controllers/
|               +--- Transaksi.php                                 [PILAR 2 - HILIR]
+--- tools/  (Script Rekonsiliasi Database PHP 5.6 CLI)
    |--- patch_restore_stock_locker_diskon.php                     [PILAR 3 - DB PATCH]
    |--- patch_normalize_grn_overdebit.php                         [PILAR 3 - DB PATCH]
    +--- patch_reconcile_49_klaim_mutasi.php                       [PILAR 3 - DB PATCH]
```

Komponen turunan yang disebut: `ComLockerDiskonValue` (penerbit slot locker), `MdlSupplierDiskon` (model jenis diskon), `MdlSupplier`, `MdlLockerStockDiskonVendor` (model locker vendor), `ComRekeningPembantuPiutangSupplierDetailTransMain` (paired model), `MdlLockerTransaksi`, `MdlLockerStock`, `ValueGate::buildValue()`, `heFetchElement_modul()`, `heInitGates_he_cart()`.

### 9.2 Pilar 1 - Perbaikan Hulu

**`PreSyncDiskonPembelian.php` - anti-reset destruktif.** Ganti blok baris 276-284 agar tidak mereset ke 0. Bila pre-diskon tidak ditemukan, ambil persentase diskon dari registry PO atau kontrak master supplier lalu hitung proporsional terhadap qty GRN:

```php
if (!empty($tmp)) {
    // Jalur normal jika pre-diskon valid
    $_SESSION[$cCode][$src_key][$pID][$key_reset] = $tmp[0]->nilai;
} else {
    $poDiscountPct = isset($poItems4[$pID]["diskon_{$diskon_key_id}_persen"]) ? floatval($poItems4[$pID]["diskon_{$diskon_key_id}_persen"]) : 0;
    $hargaBeliUnit = isset($currentItems[$pID]['harga']) ? floatval($currentItems[$pID]['harga']) : 0;
    if ($poDiscountPct > 0 && $hargaBeliUnit > 0) {
        $calculatedDiskonUnit = ($poDiscountPct / 100) * $hargaBeliUnit;
        $_SESSION[$cCode][$src_key][$pID][$key_reset] = $calculatedDiskonUnit;
        $_SESSION[$cCode][$src_key][$pID]["sub_" . $key_reset] = $calculatedDiskonUnit * $qtyDiterima;
    } else {
        $_SESSION[$cCode][$src_key][$pID][$key_reset] = 0;
        $_SESSION[$cCode][$src_key][$pID]["sub_" . $key_reset] = 0;
    }
}
```

Rumus proporsional yang berlaku:

```text
diskon_nilai = (diskon_persen / 100) x harga_satuan_po
diskon_nilai_total_GRN = SUM(items4_sum['sub_diskon_nilai']) untuk GRN tersebut saja
Debet Diskon GRN = (Qty Diterima / Qty PO) x Total Diskon PO
```

**`coTransaksiCore.php` (pembelian, step `467`) - anti-overdebit.**

1. Hapus pemicu debet COA `1010020030` pada level master `[98]` dan `[99]`. Biarkan debet hanya dieksekusi oleh Detail Trans Item `[5]` (`RekeningPembantuPiutangSupplierDetailTransItem`) yang membaca langsung dari `items4_sum`, murni berdasarkan barang yang diterima secara fisik pada GRN tersebut. Pastikan pemetaan komponen `[3]`, `[4]`, `[6]` saling eksklusif, tidak saling menumpuk.
2. Pastikan `main['diskon_nilai_total']` untuk GRN parsial dihitung dari penjumlahan item yang diterima pada GRN tersebut, bukan menyalin total diskon PO utuh.

### 9.3 Pilar 2 - Perbaikan Hilir

**`coTransaksiUi.php` - koreksi selector ID klaim.** Pada baris 2610 ubah field selector dan processor agar membawa ID transaksi GRN:

```php
"pihakNameMainDiskonIdSelector" => "transaksi_id",
"pihakNameMainDiskonIdProcessor" => "transaksi_id",
```

**`Transaksi.php` - formula baku DataTable.** Hapus fallback liar ke debet cache yang rentan over-debit:

```php
$diskonPlafon = ($locker_terbit > 0) ? $locker_terbit : $expected_diskon_registry;
$totalKlaim = $locker_diklaim;
$sisaDiskon = max(0, $diskonPlafon - $totalKlaim);
```

Formula yang ditetapkan:

```text
Diskon Supplier = Plafon Diskon Riil GRN (Registry items4_sum atau Locker Fisik Awal)
Total Klaim     = SUM(Mutasi Kredit Klaim yang Sah)
Sisa Diskon     = Diskon Supplier - Total Klaim
```

Dengan formula ini pada GRN `2496` kolom Diskon Supplier selalu tertib Rp 12.076.285,83 (atau Rp 7.633.256,37 untuk Diskon 1) dan Sisa Diskon akurat.

**`ComRekeningPembantuPiutangSupplierDetailTransItem.php` - fail-fast validation.**`** presently silent failure pada balance protection:** ketika user mengajukan klaim atas nota yang saldonya di cache sudah bernilai 0, pemeriksaan `accountBalanceProtections` menyebabkan komponen mengembalikan `false` atau tidak mengeksekusi insert ke `__rek_pembantu_subpiutangsuppliertrans__1010020030`, sementara GL jurnal umum dan pemotongan locker tetap berjalan. Inilah penyebab 43 klaim pada 2026-07-22 tidak memiliki mutasi kredit. Komponen juga sangat bergantung pada `static['extern_id']`.

Perbaikan: (1) validasi fail-fast di awal controller `Create.php` / `FollowUp.php` sebelum `$this->db->trans_start()`, periksa kecukupan sisa piutang diskon nota GRN terpilih terhadap nilai klaim; jika tidak cukup, tolak di form input agar transaksi tidak terbentuk setengah jalan di jurnal umum tanpa buku pembantu; (2) pencatatan error log eksplisit bila posting mutasi pembantu gagal.

### 9.4 Pilar 3 - Rekonsiliasi Database Produksi

**Script 1 `tools/patch_restore_stock_locker_diskon.php`** - target 114 GRN kehilangan baris fisik locker. Algoritma: (1) cari seluruh GRN aktif dengan `jenis = '467'`, `status = 1`, `trash = 0`, `trash_4 = 0`; (2) parse blob `transaksi_data_registry` untuk daftar barang dan tarif diskon seharusnya; (3) cek apakah setiap jenis diskon (`produk_id`) sudah punya baris aktif di `stock_locker_diskon`; (4) bila belum ada dan haknya > 0, `INSERT` dengan `transaksi_id` = ID GRN, `nomer` = Nomer GRN, `produk_id` = ID jenis diskon, `nilai` = nilai hak proporsional, `nilai_diklaim` = 0, `state` = `'active'`, `jumlah` = 1, `jenis_locker` = `'stock'`, `jenis` = `'diskon'`; (5) catat log ke tabel audit `_audit_patch_diskon_log`.

**Script 2 `tools/patch_normalize_grn_overdebit.php`** - target 2.308 GRN over-debit pada `_rek_pembantu_subpiutangsuppliertrans_cache`. Algoritma: (1) ambil GRN dengan selisih `debet` cache > 1.2x fisik locker terbit; (2) hitung `Debet Benar = Total Terbit Fisik Locker`; (3) update baris cache:

```sql
UPDATE _rek_pembantu_subpiutangsuppliertrans_cache
SET debet = $debetBenar,
    saldo_debet = $debetBenar,
    debet_akhir = $debetBenar - kredit
WHERE extern_id = $grnId AND rekening = '1010020030';
```

(4) lakukan update selaras pada tabel mutasi `__rek_pembantu_subpiutangsuppliertrans__1010020030` untuk baris debet awal transaksi GRN tersebut. Versi script pada dokumen rencana juga menyebut pembaruan untuk periode `forever`, `tahunan`, `bulanan`, dan `harian`.

**Script 3 `tools/patch_reconcile_49_klaim_mutasi.php`** - target 49 klaim `3333` tanpa mutasi kredit. Algoritma: (1) loop 49 dokumen klaim target; (2) dapatkan ID GRN referensi sah dari `transaksi` (`reference_id` atau `reference_nomer`); (3) klasifikasi menjadi dua kelompok:

| Kelompok | Definisi | Tindakan |
| :--- | :--- | :--- |
| A - Klaim sah | Memotong locker, jurnal pembantunya tertinggal | Buat entri mutasi kredit baru di `__rek_pembantu_subpiutangsuppliertrans__1010020030`: `extern_id` = ID GRN benar, `debet` = 0, `kredit` = `transaksi_nilai`, `dtime` = waktu transaksi klaim asli, `keterangan` = `[PATCH REKONSILIASI] Klaim Diskon ` + nomer klaim; update akumulasi `kredit` pada tabel cache |
| B - Klaim phantom atau duplikasi | Diajukan atas GRN yang saldonya sudah pernah lunas (duplikasi 2026-07-22) | Beri penandaan audit khusus dan buatkan rekomendasi jurnal koreksi pembalik untuk disetujui tim Akuntansi |

### 9.5 Protokol Keselamatan Eksekusi

1. **Sintaks PHP 5.6 mutlak.** Dilarang shorthand array `[]`, null coalescing `??`, arrow function `fn() =>`, dan spread operator `...`. Wajib `array()`, `isset($x) ? $x : $default`, dan fungsiClosure `function($x) { return ...; }`.
2. **Backup tabel bayangan** sebelum patch pada database live `192.168.5.10`:

```sql
CREATE TABLE _bak_20260930_stock_locker_diskon AS SELECT * FROM stock_locker_diskon;
CREATE TABLE _bak_20260930_rek_cache AS SELECT * FROM _rek_pembantu_subpiutangsuppliertrans_cache;
CREATE TABLE _bak_20260930_rek_mutasi AS SELECT * FROM __rek_pembantu_subpiutangsuppliertrans__1010020030;
```

Catatan: dokumen `rencana_perbaikan_codebase_diskon.md` memakai suffix `20260929`, sedangkan master blueprint memakai `20260930`. Keduanya merupakan snapshot berbeda dengan tanggal analisis berbeda.

3. **Transaction Wrapping:** setiap operasi batch DB wajib dibungkus `$this->db->trans_start()` dan `$this->db->trans_complete()`.
4. **Dry-Run Mode:** seluruh script migrasi wajib memiliki parameter `--dry-run` untuk menampilkan simulasi sebelum commit nyata.

### 9.6 Urutan Eksekusi Empat Langkah

| Langkah | Cakupan | Output |
| :--- | :--- | :--- |
| 1 - Kunci dan perbaiki codebase | `coTransaksiUi.php` (selector `transaksi_id`), `PreSyncDiskonPembelian.php` (anti-reset), `coTransaksiCore.php` pembelian (anti-overdebit), `Transaksi.php` kompensasiharga (formula DataTable) | Transaksi rusak baru terhenti |
| 2 - Dry-run script rekonsiliasi | `php tools/patch_normalize_grn_overdebit.php --dry-run`, `php tools/patch_restore_stock_locker_diskon.php --dry`, audit 49 klaim | Verifikasi angka sebelum modifikasi |
| 3 - Eksekusi rekonsiliasi DB | Backup shadow, eksekusi normalisasi debet GRN dan restorasi locker, rekonsiliasi 49 mutasi kredit | Pembersihan data historis 2024-2026 |
| 4 - Validasi dan uji UI | Buka DataTable `Transaksi` pastikan angka sisa benar; uji input klaim baru: mutasi kredit pas; buka dashboard `Tool/traceDiskonPembelian` | Jumlah GRN anomali mendekati 0 |

---

## 10. Temuan Lintas-Dokumen dan Kontradiksi

### 10.1 Kontradiksi Angka Dampak

| Topik | `analisis_hulu_hilir_diskon.md` (2026-09-29) | `MASTER_BLUEPRINT` (2026-09-30) | Catatan |
| :--- | :--- | :--- | :--- |
| Klaim `3333` tanpa mutasi kredit | 49 dokumen masih listed, "terhenti sejak update selector, 49 dokumen lama menggantung" | 0 dokumen, "telah dinormalisasi", 49 sebelumnya | Master lebih baru; status aktif berubah dalam 1 hari |
| Suffix backup | Tidak dibahas | `_bak_20260930_*` | Rencana perbaikan memakai `_bak_20260929_*` |
| Jumlah baris SQL agregasi | 3 metrik (Total Terbit, Sisa Saldo, Total Klaim) | 3 metrik dengan alias (`total_locker_terbit`, `sisa_locker_aktif`, `total_locker_klaim`) | Konsisten |
| Nilai `debet_akhir` | Disingkat `debet_akhir` dan `saldo_debet` | `debet_akhir = $debetBenar - kredit` | Master lebih eksplisit |

### 10.2 Kontradiksi dan Inkonsistensi Teknis

1. **Filter pre-diskon tidak konsisten antar dokumen.** `analisis_hulu_hilir_diskon.md` menyebut filter hanya `WHERE nilai > 10` pada `stock_locker_pre_diskon`; `rencana_perbaikan_codebase_diskon.md` dan master blueprint menunjukkan tiga filter: `transaksi_id='$po_id'`, `reference_id='$referenceID'`, `nilai>'10'`. Dampak kode berbeda karena cakupan data berbeda.
2. **Lokasi file `coTransaksiCore.php` lvl 75-95.** `analisis_hulu_hilir_diskon.md` menautkan baris 75-95 sebagai terkait Titik 1, sedangkanTitik 2 dan rencana perbaikan menunjuk baris 120-215. Master blueprint tidak menyebut nomor baris untuk file ini.
3. **`extern3_id = '11'`.** Nilai literal 11 muncul pada query mutasi kredit (`WHERE extern_id = '2' AND extern2_id = '' AND extern3_id = '11'`), tetapi tidak ada dokumen sumber yang menjelaskan makna kode 11 tersebut. Perlu konfirmasi developer.
4. **Sumber data registry tidak konsisten.** `rencana_perbaikan_codebase_diskon.md` memakai nama `transaksi_data_registry` (tunggal), sedangkan `analisis_modul_kompensasiharga.md` memakai `transaksi_data_registries` (jamak). Salah satu keliru ketik.
5. **Free produk pada `produk_id = 7`.** `analisis_modul_kompensasiharga.md` menandai `freeproduk` sebagai `produk_id=7` dan filter reguler `produk_id IN (0..6, 8)`, sedangkan `ATURAN_PEMBACAAN_DATA_DISKON.md` menyebut "Diskon 7 (Free Produk / Hadiah)" tanpa mencantumkan ID produk. Perlu konfirmasi mapping slot diskon 1-8 ke jenis diskon.
6. **Komponen master `[98]` vs `[99]`.** `analisis_hulu_hilir_diskon.md` menyebut "Komponen Master [99]", sedangkan `rencana_perbaikan_codebase_diskon.md` dan master blueprint menyebut `[98]` dan `[99]`.Perlunya konfirmasi apakah keduanya benar-benar mendebet.
7. **Toleransi dan ambang.** Klasifikasi OVER-DEBIT memakai `> 1.2 x Total Terbit Locker`, sedangkan syarat MATCHED memakai toleransi absolut Rp 100. Kedua ambang tidak konsisten secara metodologis: selisih Rp 100 pada locker Rp 1 juta lolos MATCHED tetapi tidak pada ambang rasio 1.2.
8. **Nilai nominal Diskon 1 GRN `2496`.** Catatan: dokumen hulu-hilir menyebut "Diskon 1 pada GRN.-1.2496 senilai Rp 7.633.256,37" sebagai target restorasi, sedangkan master blueprint menyebut setelah perbaikan GRN 2496 total tampil Rp 12.076.285,83 dengan sisa Rp 7.633.256. Keduanya dapat konsisten bila Rp 12.076.285,83 adalah total semua slot dan Rp 7.633.256,37 adalah slot Diskon 1 saja setelah dikurangi klaim Rp 4.443.029.
9. **Angka 49 klaim.** `rencana_perbaikan_codebase_diskon.md` menyebut 6 dok (2024), 0 dok (2025), 43 dok (2026) = 49; tabel master blueprint menulis "0 dokumen (Telah di-Patch)" pada DB 5.17 dengan kolom DB 5.10 kosong. Kolom DB 5.10 tidak diisi untuk metrik ini.
10. **Rentang baris berbeda untuk fungsi sama.** `viewKlaimSupplierDataAjax()` disebut mulai baris 5802 (analisis modul) dan baris 6345-6385 (titik kerusakan 4). Bagian 5802-6345 adalah query dan badge, sedangkan 6345-6385 adalah logika fallback. Bukan kontradiksi, tetapi perlu Surgical clarity saat patching.
11. **Dokumen UAT belum bertanggal.** `UAT_CHECKLIST_KLAIM_DISKON_3333.md` menandai LULUS pada 13 item, tetapi kolom tanggal, tester, dan tanda tangan kosong. Status PASS belum dapat diaudit.
12. **Ceklist locker finance belum mencakup `kompensasiharga`.** Enam modul terpilih tidak memuat `kompensasiharga`, padahal UAT item 13 menguji pelepasan lock `stock_locker_diskon`. Coverage gap antara requirement dan implementasi.
13. **Status badge handbook.** `HANDBOOK_BADGE_UNSETTLED_TRANSAKSI.md` berstatus "siap dikerjakan", bukan selesai. Bulanan badge `my settlement` belum ada di produksi.
14. **Mekanisme lock tidak seragam.** Tiga pendekatan berbeda dipakai bersamaan: `MdlLockerTransaksi` Composite Key dengan retake idle 5 menit (modul keuangan), `LockerTransaksi` state hold dengan `FOR UPDATE` (modul `pembatalan`), dan pessimistic lock TTL 60 detik plus heartbeat 30 detik (`LOCK_TRANSAKSI.MD`). Belum ada standardisasi.
15. **Patch script masih disengaja.** `rencana_perbaikan_codebase_diskon.md` menyebut `patch_reconcile_49_klaim_mutasi.php` akan dijalankan, sementara master blueprint sudah menyatakan 0 dokumen tersisa. Kemungkinan patch dipatch atau estimasi master blueprint bersifat target, bukan realita.
16. **Istilah "badge hijau" tidak terdefinisi.** Master blueprint menyebut badge hijau "Kredit Sukses Terposting" dan badge kontra retur, namun tidak ada dokumen sumber yang mendefinisikan implementasinya. `HANDBOOK_BADGE_UNSETTLED_TRANSAKSI.md` hanya menangani badge unsettled, bukan badge status klaim.

---

## 11. Lampiran: Daftar File Sumber

| Nama File | Ukuran | Topik H1 | Peran |
| :--- | ---: | :--- | :--- |
| `analisis_hulu_hilir_diskon.md` | 14.507 byte (204 baris) | DOKUMEN ANALISIS ALUR HULU - HILIR DISKON SUPPLIER | Sumber primer untuk 4 titik kerusakan sistemik, diagram Mermaid alur, matriks dampak tahunan 2024-2026, dan rencana 3 pilar. Dokumen tertua (2026-09-29). |
| `ATURAN_PEMBACAAN_DATA_DISKON.md` | 9.206 byte (139 baris) | ATURAN & PROTOKOL FORENSIK PEMBACAAN DATA DISKON PEMBELIAN | Sumber aturan baca data: 3-Way Matching, dekoder blob registry PHP 5.6 safe, perbedaan kolom `nilai` vs `nilai_unit`, formula agregasi locker, relasi `transaksi_id` OR `nomer`, deteksi tabel sharded, query safety. |
| `rencana_perbaikan_codebase_diskon.md` | 15.576 byte (244 baris) | RENCANA & ANALISIS DETAIL PERBAIKAN CODEBASE HULU - HILIR DISKON SUPPLIER | Sumber action plan per file: peta arsitektur file, root cause per file, 3 script CLI rekonsiliasi, protokol keselamatan eksekusi, urutan 4 langkah. |
| `MASTER_BLUEPRINT_DAN_PROTOKOL_DISKON_PEMBELIAN.md` | 31.451 byte (479 baris) | MASTER BLUEPRINT, PROTOKOL FORENSIK & RENCANA PERBAIKAN ARSITEKTUR DISKON PEMBELIAN | Dokumen standard mandatory; menyintesis tiga dokumen di atasnya. Sumber metrik dampak DB 5.17 vs 5.10, kerangka 5W+1H, anomali retur `9911`, matriks verifikasi, runbook 4 fase. |
| `analisis_modul_kompensasiharga.md` | 17.756 byte (523 baris) | Analisis Mendalam Modul `kompensasiharga` | Sumber arsitektur modul hilir: peta controller, 3 panel AJAX, DataTable server-side dan badge filter, reverse prefix map `jenisTr`, queue mode `3333`, config key `viewKlaimSupplier`, peta tabel database. |
| `UAT_CHECKLIST_KLAIM_DISKON_3333.md` | 2.966 byte (22 baris) | LAPORAN USER ACCEPTANCE TESTING (UAT) | Sumber checklist UAT 13 item untuk modul `3333`, mencakup filter, badge, batch selection, antrian, validasi saldo, buku bantu cache, dan pelepasan locker. |
| `ceklist_locker_finance.md` | 8.012 byte (97 baris) | Ceklist Implementasi Transaction Concurrency Locker (Modul Finance & Keuangan) | Sumber standar 4 langkah transaction concurrency locker berbasis Composite Key, spesifikasi modal "Transaksi Terkunci", dan checklist per modul keuangan (pembayaran, penerimaan, kas, biaya, settlement, adjustmentjurnal). |
| `pembatalan-discussion.md` | 5.240 byte (120 baris) | Analisis Modul Pembatalan - Locker dan Alur Pembatalan | Sumber analisis modul `pembatalan`: locker stok di `_processSelectNotaRevert.php`, absennya locker transaksi di `select()`, kondisi pemblokiran pembatalan, rekomendasi `FOR UPDATE` dan notifikasi ramah pengguna. |
| `HANDBOOK_BADGE_UNSETTLED_TRANSAKSI.md` | 7.124 byte (165 baris) | HANDBOOK IMPLEMENTASI: BADGE JUMLAH TRANSAKSI UNSETTLED (MY SETTLEMENT) | Sumber handbook badge counter `my settlement` berbasis `transaksi_payment_source`, desain fail-clean, 6 berkas yang dimodifikasi, dan prosedur uji kompatibilitas PHP 5.6. |
| `LOCK_TRANSAKSI.MD` | 3.911 byte (51 baris) | Mekanisme Pencegahan Race Condition - Pelunasan Faktur | Sumber arsitektur short-lived pessimistic lock plus heartbeat (TTL 60 detik, heartbeat 30 detik), 3 skenario unlock, dan validasi ganda saat submit. |

**Total sumber:** 10 file, 125.745 byte, 1.942 baris.

---

## 12. Ringkasan Tindakan Prioritas

| Prioritas | Tindakan | Target | Risiko Bila Tertunda |
| :--- | :--- | :--- | :--- |
| P0 | Ubah selector dan processor ke `transaksi_id` | `coTransaksiUi.php` baris 2610 | 49 klaim lanjut gagal forming mutasi kredit |
| P0 | Hapus reset destruktif `diskon_*_nilai = 0` | `PreSyncDiskonPembelian.php` baris 276-284 dan 327 | Slot locker baru terus hilang (114 GRN terdeteksi) |
| P0 | Hapus duplikasi debet master `[98]`/`[99]`, proporsionalkan `main['diskon_nilai_total']` | `coTransaksiCore.php` step `467` | Over-debit 2x-4x terus terjadi setiap hari (2.308 GRN) |
| P1 | Terapkan fail-fast validation saldo klaim | `ComRekeningPembantuPiutangSupplierDetailTransItem.php` | Silent fail berulang, jurnal umum terbentuk tanpa buku pembantu |
| P1 | Terbitkan baris kontra `jumlah = -1` saat retur `9911` | Modul `returpembelian` | 35 GRN retur rentan klaim ganda |
| P1 | Ganti fallback DataTable ke formula plafon dikurangi klaim | `Transaksi.php` `viewKlaimSupplierDataAjax` | Angka bengkak Rp 20.185.738 terus ditampilkan ke user |
| P2 | Jalankan 3 script CLI dengan `--dry-run` lalu `--commit` setelah backup shadow | `tools/patch_*.php` | Data historis 2024-2026 tetap tidak selaras (Rp 2,44 miliar) |
| P2 | Bersihkan marker `//` di dalam string SQL seluruh query dashboard diskon | Script query dashboard | KPI tampil `0 GRN` tanpa indikasi error (kejadian 2026-09-30) |
| P3 | Tambahkan `kompensasiharga` ke ceklist locker finance | `ceklist_locker_finance.md` | Coverage gap lock pada proses klaim diskon |
| P3 | Implementasikan badge unsettled `my settlement` | 6 berkas pada handbook | Kasir tidak mendapat indikator setoran tertunda |

---

*Dokumen sintesis ini disusun dari 10 dokumen sumber pada direktori `W:\_md_result\file_md_everest\`. Seluruh angka, nama tabel, nama kolom, jenisTr, dan nomor baris diambil langsung dari sumber. Tidak ada data yang diestimasi di luar penandaan eksplisit yang dicantumkan.*