# Sintesis 07: Migrasi Riwayat Transaksi Server-Side dan Audit Trail Everest ERP

Dokumen sintesis ini menghimpun sembilan berkas sumber markdown yang saling melengkapi dan sebagian saling bertentangan. Fokus utama adalah migrasi halaman Riwayat (History) seluruh modul transaksi Everest dari DataTables client-side ke server-side, dilengkapi jejak audit data yang menyertainya: rekonsiliasi ID supplier, skor kepatuhan master data, dan masalah serial number pada Buku Pembantu Persediaan.

Konteks platform yang konsisten disebut dalam sumber: PHP 5.6, CodeIgniter 3.1.8 dengan HMVC Wiredesignz, MariaDB 10 / MySQL, jQuery DataTables 1.10+, dan MariaDB/MySQL sebagai basis data. Kode sumber berada di `W:/everest_10jul/application/`. Standar audit internal dirujuk ke `W:\GLOBAL_AGENT` melalui `global_rules.md` dan `AGENTS.md`.

---

## 1. Ringkasan Eksekutif

1. **Akar masalah.** Halaman History di sekitar 70 file `History.php` pada `application/modules/` memuat 100+ baris transaksi sekaligus lewat `MdlTransaksi`, melakukan loop PHP untuk *unserializing* blob, format tanggal, kalkulasi finansial, dan pemanggilan helper per baris. Akibatnya muat halaman 3-10 detik per pergantian tab/tanggal dan berisiko *memory exhaustion*; sisi klien juga mengalami *browser freezing/lag* ketika dataset ribuan hingga ratusan ribu transaksi masuk ke DOM.
2. **Solusi inti.** Satu engine terpusat di `application/libraries/DatatablesHistory.php` (alternatif: library per-modul `DatatablesHistory.php`) menangani query binding SARGable ke tabel `transaksi`, multi-keyword search (AND), paging/sorting server-side dengan protokol `draw`, `start`, `length`, `recordsTotal`, `recordsFiltered`, dan filter tanggal SARGable `dtime >= date1` serta `dtime <= date2`. Modularisasi endpoint `showDataAjax()` pada controller `History.php` setiap modul menjadi satu-satunya jalur data AJAX.
3. **Strategi rollout.** Bukan *big bang*, melainkan *Canary Rollout / User-Level Feature Flag*: cookie `pref_history_serverside_{USER_ID}` berumur `time() + (365 * 86400)` (1 tahun) plus cache `$_SESSION['login']['pref_history_serverside']`, dengan dispatcher pada `viewHistory()` dan `showData()`. Konsekuensitsl-nya: nol downtime, *self-service instant rollback*, dan preferensi persisten.
4. **Standar layout akhir.** `blueprint_layout_akhir_history.md` v1.1 menetapkan 12 pilar: server-side DataTables, tab step diganti tombol filter step, pencarian 3 lapis dengan reset cerdas saat 0 data, sorting aman via mapping `$safeDbSortCols`, batch query `transaksi_data_registry` dengan fallback `id_top`, toggle mode, kolom seragam antar-step via `getUniformHistoryFields($jenisTr)`, dual pagination atas-bawah, toolbar compact, toolbar rentang tanggal AJAX, standardisasi tag `tableHistoryShow`, serta **default mode baru + onboarding banner berbasis `localStorage`**.
5. **Status implementasi.** Modul `penjualan` tercatat sebagai satu-satunya pilot yang *selesai* (status lain: "Siap Migrasi"). Namun `RANGKUMAN_PERCAKAPAN` mencatat dua modul yang *sudah* punya server-side sebelum program ini: `kas` (khusus `jenisTr = '4467'` via `dataHistoryServerSide()`) dan `invoicing` (via `showDataAjax()`).
6. **Verifikasi.** `UAT_HISTORY.md` (versi 1.1) memuat 13 skenario berprefix `UAT-PBL-01` sampai `UAT-PBL-13` untuk modul `pembelian`, memakai metode Golden Circle 5W+1H, dengan 7 zona observasi dan 4 kriteria exit.
7. **Audit trail.** Dua laporan rekonsiliasi supplier 4 (`PT.PANASONIC GOBEL INDONESIA`) menghasilkan selisih identik `1.926.342.168,03058` dari 97 transaksi mismatch; `audit_proyek_komprehensif.md` mengaudit 253 proyek aktif + 27 terhapus di database `run_everest_modul`; `masterdata_compliance_score.md` menilai `MasterData.php` (28.401 baris) rata-rata 6/100; `serial_number_issue_25137.md` menelusuri serial number produk 25137 yang tidak muncul di `/LedgerV2/viewBalances_l1/RekeningPembantuProduk/1010030030`.

---

## 2. Kebutuhan dan Masalah Riwayat Transaksi

### 2.1 Sumber Masalah

Halaman History tersebar di puluhan modul: `penjualan`, `pembelian`, `invoicing`, `distribusifg`, `penerimaan`, `kas`, `pembayaran`, `biaya`, `inputstok`, `pindahgudang`, `produksi`, `returpenjualan`, dan lainnya.

### 2.2 Gejala Terukur

| Gejala | Angka / Deskripsi | Sumber |
|---|---|---|
| Waktu muat halaman | 3-10 detik per pergantian tab/tanggal | BLUEPRINT_MIGRASI, RANGKUMAN |
| Jumlah baris per fetch | 100+ transaksi sekaligus | BLUEPRINT_MIGRASI |
| Jumlah file controller History | sekitar 70 file di `application/modules/` | RANGKUMAN Sesi 1 |
| Beban DOM | ribuan hingga ratusan ribu transaksi di browser *client-side* | blueprint_layout_akhir |
| Dampak pengguna | *browser freezing/lag*, *memory exhaustion* | kedua blueprint |
| Dampak server | *server resource starvation* akibat query besar tanpa limitasi bertahap | blueprint_layout_akhir |

### 2.3 Empat Penyebab Teknis (Urut Prioritas)

1. **High Latency & Memory Exhaustion.** `MdlTransaksi` mengambil dataset besar, lalu loop PHP melakukan *unserializing blob*, format tanggal, kalkulasi finansial, dan pemanggilan helper per baris.
2. **Kolom Kustom dan Endemik.** Tiga kelompok kolom tidak pernah menjadi masalah bila query sederhana, tetapi menjadi sumber kegagalan migrasi:
   - **Status Pembayaran** (`status_bayar` / `status_next`): bukan kolom tabel `transaksi`. Dihitung dinamis dari `transaksi_payment_source`, sisa piutang, dan termin pembayaran.
   - **Isi / Rincian Barang** (`item_fields`): mini-tabel produk berisi SKU, barcode, nama barang, qty; sumbernya `transaksi_data_registry` (disebut juga NoSQL / MongoDB) pada step 9 dengan label `items` dan `items2`.
   - **Step & Key** (`ids_his`): nomor dokumen atau aktor per langkah, misalnya `nomer_soa`, `pengirim_nama`, `worker_nama`, `seller_nama`, disimpan sebagai blob JSON `ids_his`.

3. **Custom Buttons.** Export Excel kustom (`customButton`), cetak nota valas (`print_nvalas`), dan sejenisnya.
4. **Pencarian Client-Side Lambat.** DataTables client-side hanya dapat mencari data yang sudah ter-render di halaman saat itu; data di luar batasan query PHP tidak dapat dicari tanpa me-load ribuan baris ke DOM.

### 2.4 Feedback Kunci dari Pengguna

Pengguna menyatakan secara eksplisit bahwa kegagalan migrasi di masa lalu bukan semata-mata soal *custom button*, melainkan justru kolom yang dikustomisasi. Inilah yang menggeser fokus migrasi dari sekadar memindahkan query ke penanganan kolom endemik di dalam engine.

---

## 3. Arsitektur Riwayat Server-Side

### 3.1 Struktur File per Modul

```
application/
  helpers/
    he_finansial_helper.php                  # fin_get_payment_status()
    he_misc_helper.php                       # viewDetailTransaksi(), tag tableHistoryShow
  libraries/
    DatatablesHistory.php                   # engine bersama (lokasi kanonik menurut BLUEPRINT_MIGRASI)
  modules/
    {nama_modul}/
      controllers/History.php                # extends Modul_Controller -> MX_Controller
      views/history.php
      template/history.html                  # wrapper template Layout
      UAT_HISTORY.md                         # instrumen UAT spesifik modul
```

Pada `blueprint_layout_akhir_history.md` lokasi engine dinyatakan alternatif: `application/modules/[nama_modul]/libraries/DatatablesHistory.php` dengan anotasi "atau shared". Lokasi kanonik `application/libraries/DatatablesHistory.php` hanya disebut di BLUEPRINT_MIGRASI. Ini became kontradiksi yang harus diputuskan sebelum migrasi massal (lihat Bagian 12).

### 3.2 Anatomi Controller `History.php`

| Metode | Peran | Detail |
|---|---|---|
| `viewHistory($jenisTr, $jenisTrsub)` | Dispatcher halaman utama | URL: `{base}{modul}/History/viewHistory/{jenisTr}/{jenisTrsub}`. Baca cookie/sesi, lempar ke `viewHistoryServerSide()` atau `viewHistoryLegacy()`. Set view `"mode" => "viewHistory"` (atau `$this->uri->segment(3)`). |
| `showData($jenisTr, $jenisTrsub)` | Dispatcher partial tab | Dipanggil dari `$('#historyList').load('$linkStep')`. Lempar ke `showDataServerSide()` atau `showDataLegacy()`. Set view `"mode" => "showData"`. |
| `showDataAjax($jenisTr, $currentState)` | Endpoint AJAX DataTables | Dipanggil `table.DataTable({ ajax: ... })`. Instansiasi engine lalu eksekusi query server-side. |
| `toggleHistoryMode()` | Endpoint toggle | Terima `$_GET['mode']` (`'new'` atau `'old'`) dan `$_GET['redirect']`. |
| `viewHistoryLegacy()` | Fungsi lama yang di-*rename* | Tambahkan `"isServerSide" => false` pada `$data`. |
| `viewHistoryServerSide()` | Persiapan UI tanpa query berat | Salin label, steps, links, dates dari legacy. Isi `"arrayHistory" => array()`, `"isServerSide" => true`, `"mode" => $this->uri->segment(3)`. |
| `showDataLegacy()` / `showDataServerSide()` | Pemisahan path render | Legacy retains query; server-side tidak menjalankan query berat. |
| `getUniformHistoryFields($jenisTr)` | Definisi kolom seragam | `protected`, Appears di layout v1.1 saja. |
| `setFilterHook($callback)` | Hook filter endemik | Dipanggil pada objek engine, bukan controller. |

Properti controller yang dibutuhkan: `$this->jenisTr`, `$this->configUi`, `$this->configLayout`, `$this->placeId`.

### 3.3 Anatomi View `history.php`

`switch ($mode)` memiliki dua *case* utama:

- **`case "viewStatus":` / `case "viewHistory":`** merender template lengkap dengan header layout Everest ERP:
  ```php
  $p = New Layout("$title", "$subTitle", MODUL_TEMPLATE_PATH . "/template/history.html");
  $p->render();
  ```
  Cabang `$isServerSide == true`: `<thead>` dari `$arrayHistoryLabels`, `<tbody></tbody>` kosong, paging dan AJAX DataTables ke `showDataAjax`. Cabang `$isServerSide == false`: tabel legacy dengan `<tbody>` berisi loop PHP `foreach ($arrayHistory as $ii => $row)`.

- **`case "showData":`** hanya meng-echo `$content` tanpa `New Layout`, dipakai saat navigasi tab via AJAX (`$('#historyList').load('$linkStep')`), dengan dua cabang server-side versus legacy yang sama.

### 3.4 Kontrak Protokol DataTables

**Parameter request (dikirim browser ke server):**

| Parameter | Sumber | Fungsi |
|---|---|---|
| `draw` | DataTables core | Echo balik penanda request untuk sinkronisasi XHR |
| `start` | DataTables core | Offset baris awal |
| `length` | DataTables core | Jumlah baris per halaman |
| `search[value]` | DataTables core | Kata kunci pencarian global, multi-keyword dengan operator AND |
| `order[i][column]`, `order[i][dir]` | DataTables core | Sorting; kolom dipetakan lewat `$safeDbSortCols` ke kolom database riil |
| `columns[i][data]`, `columns[i][name]`, `columns[i][searchable]`, `columns[i][orderable]` | DataTables core | Metadata kolom untuk filtering dan sorting |
| `currentState` | Custom view | Filter tahap / step; default `"all"` |
| `date1`, `date2` | Custom view | Rentang tanggal; dipetakan ke `dtime >= date1` dan `dtime <= date2` |
| `date_global` | Custom view | `1` bila pengguna memilih "Semua Tanggal", `0` bila rentang aktif |

**Parameter response (dikirim server ke browser):** `draw`, `recordsTotal`, `recordsFiltered`, `data`. Pada `drawCallback` sisi view, sumber juga membaca `pageInfo.recordsDisplay` untuk mendeteksi kondisi nol data.

### 3.5 Konfigurasi Inisialisasi DataTables (layout v1.1)

| Opsi | Nilai |
|---|---|
| `serverSide` | `true` |
| `processing` | `true` |
| `fixedHeader` | `true` |
| `searchDelay` | `800` (ms) |
| `pageLength` | `10` |
| `lengthMenu` | `[[10, 20, 50, 100], [10, 20, 50, 100]]` |
| `ajax.url` | `MODUL_PATH . "History/showDataAjax/$jenisTr/$currentState"` |
| `ajax.type` | `POST` |
| `columns` | Variabel PHP `$columnsJsStr` yang dibangun dari `$arrayHistoryLabels` |
| `dom` | `row dt-toolbar-top` (B, f) / `row dt-toolbar-sub` (l, p) / `row` (tr) / `row dt-toolbar-bottom` (i, p) |

Tombol `buttons`: `extend: 'print'` dengan teks Cetak dan `footer: true`; tombol `Unduh Tabel` (`btn-sm btn-success`) memanggil `fnExcelReport('$tableHtmlId')`; ditambah dua variabel templat `$download_step_buttons` (dropdown `[Unduh Data Mentah v]`) dan `$step_filter_buttons` (tombol filter step).

### 3.6 Handling Kolom Endemik di Engine

**a. Status Pembayaran.** Engine memuat helper finansial lalu memanggil:

```php
$this->ci->load->helper('he_finansial');
$status = fin_get_payment_status($row->id, 1000.0, true);
```

Helper menghasilkan tiga badge HTML resmi Everest ERP: LUNAS (badge success), CICILAN (badge warning), BELUM LUNAS (badge danger atau neutral). Parameter kedua `1000.0` tidak dijelaskan maknanya dalam sumber; Presumably toleransi pembulatan atau ambang, namun **tidak dispesifikasikan di sumber**.

**b. Rincian Barang (`item_fields`).** Query batch ke registry:

```php
$reg = $this->ci->db->select('dataDoc')
    ->where('transaksi_id', $row->id)
    ->where_in('step', array(9, 'items', 'items2'))
    ->get('transaksi_data_registry')
    ->row();
```

Render memakai `viewDetailTransaksi()` dengan fallback HTML mini-tabel kolom SKU, Barcode, Nama Produk, Qty, Satuan.

**c. Step & Key (`ids_his`).** Parsing blob JSON:

```php
$idsHis = !empty($row->ids_his) ? blobDecode($row->ids_his) : array();
if (is_array($colDef) && isset($colDef['step']) && isset($colDef['key'])) {
    $val = isset($idsHis[$colDef['step']][$colDef['key']]) ? $idsHis[$colDef['step']][$colDef['key']] : '';
    if (empty($val) && isset($row->{$colDef['key']})) {
        $val = $row->{$colDef['key']};
    }
}
```

Fallback ke atribut objek `$row` sebagai kolom pengganti adalah underpin agar kolom tidak kosong saat `ids_his` tidak terisi.

**d. Filter Hook Endemik (`setFilterHook`).** Setiap modul menyuntik filter database sebelum query dijalankan. Contoh resmi dari modul `penjualan` untuk freelance salesperson:

```php
if (isset($this->session->login['employee_type']) && $this->session->login['employee_type'] == "employee_freelance") {
    $sellerId = $this->session->login['id'];
    $this->datatableshistory->setFilterHook(function($db) use ($sellerId) {
        $db->where('transaksi.seller_id', $sellerId);
    });
}
```

Ini bukan sekadar optimalisasi; filter ini adalah **isolasi hak akses**. Melewatkannya pada modul `penjualan` berarti membuka data transaksi salesperson lain.

### 3.7 Relasi, Pair, dan Registry

Pilar 5 layout v1.1 merangkum penanganan data pendukung:

- Batch querying `transaksi_data_registry` mencakup `id` **dan** `id_top`.
- *Unpacking compound keys* dengan separator `__`.
- Fallback `item_fields` agar kolom pair tidak kosong.

Fungsi ini yang membuat kolom identitas dokumen turunan tetap terisi. `UAT-PBL-12` memverifikasi bahwa baris GRN tetap memuat nama supplier, PRE PO number, PO number, gudang penerimaan, dan referral invoice vendor berkat fallback ke transaksi induk `id_top`.

---

## 4. Layout Akhir Halaman History

### 4.1 Dua Belas Pilar

| No | Pilar | Deskripsi Teknis |
|---|---|---|
| 1 | Server-Side DataTables | Paging, sorting, filtering 100 persen di server melalui `DatatablesHistory.php` dan `History::showDataAjax()` |
| 2 | Tab diganti Filter Step dan Unduh Mentah | Tab `nav-tabs` konvensional disembunyikan; diganti tombol filter step instan (`Semua`, `Step 1`, `Step 2`, ...) dan dropdown collection DataTables `[Unduh Data Mentah]` |
| 3 | Pencarian Bertingkat dan Reset Cerdas | Tiga lapis: Rentang Tanggal + Filter Step + Kata Kunci Global. Jika `recordsDisplay === 0`, muncul dialog reset per layer atau global |
| 4 | Sorting Multi-Kolom Database Aman | Mapping `$safeDbSortCols` 25+ kolom |
| 5 | Relasi / Pair / Registry | Batch query `transaksi_data_registry` (`id`, `id_top`), *unpacking* compound key `__`, fallback `item_fields` |
| 6 | Toggle Mode Lama-Baru | Tombol switch instan di header berbasis Session/Cookie `pref_history_serverside` |
| 7 | Kolom Seragam Antar-Step | Helper `getUniformHistoryFields($jenisTr)` mencegah struktur tabel bergeser saat ganti step |
| 8 | Dual Pagination | Kontrol pagination di toolbar atas (sebelah kanan page length) dan toolbar bawah (sebelah kanan info record) |
| 9 | Toolbar Rapi dan Compact | `[Cetak] [Unduh Tabel] [Unduh Data Mentah] | [Semua] [Step A] [Step B]...` di kiri, pencarian di kanan |
| 10 | Toolbar Rentang Tanggal AJAX | Panel filter tanggal lama disembunyikan via CSS `.legacy-date-filter-panel`; diganti toolbar compact date range yang reload AJAX |
| 11 | Standardisasi Tag Tabel Detail | Semua tabel rincian item wajib: `<table name="tableHistoryShow" class="table dataTable table-bordered $show_css compact" style="margin-top:0px;font-size:10px;">` |
| 12 | Default Mode Baru dan Onboarding Banner | Default mode baru bagi pengguna tanpa jejak setting; banner interaktif dengan `[Paksa Kembali Ke Mode Lama]` dan `[Saya Mengerti]`, disimpan di `localStorage` |

### 4.2 Definisi Kolom Seragam

```php
protected function getUniformHistoryFields($jenisTr)
{
    $fields = array(
        "nomer"              => array("label" => "Nomer Transaksi", "type" => "link_detail"),
        "tanggal"            => array("label" => "Tanggal",            "type" => "date"),
        "customer_nama"      => array("label" => "Pihak Terkait",       "type" => "text"),
        "gudang_asal_nama"   => array("label" => "Gudang Asal",        "type" => "text"),
        "gudang_tujuan_nama" => array("label" => "Gudang Tujuan",      "type" => "text"),
        "item_fields"        => array("label" => "Rincian Item",       "type" => "items_preview"),
        "status_dokumen"     => array("label" => "Status",             "type" => "status_badge"),
        "action"             => array("label" => "Aksi",               "type" => "action_buttons")
    );
    return $fields;
}
```

Catatan kritis: meskipun menerima parameter `$jenisTr`, implementasi yang ditampilkan bersifat **statis**. Sumber memandangnya sebagai "sesuaikan mapping kolom seragam modul di sini", sehingga setiap modul wajib meng-override fungsi ini. Nama kolom yang relevan adalah kolom fisik atau entitas tabel `transaksi` seperti `nomer`, `dtime`, `customer_nama`, `gudang_asal_nama`, `gudang_tujuan_nama`, `status_dokumen`, `id_top`, `jenis`, `seller_id`.

### 4.3 Onboarding Banner dan LocalStorage

Dua kunci `localStorage` didefinisikan:

| Kunci | Nilai | Fungsi |
|---|---|---|
| `history_new_mode_notice_dismissed` | `'1'` | Menandai banner pernah ditutup; dicek saat `$(document).ready` |
| `pref_history_mode` | `'old'` atau `'new'` | Dicatat saat pengguna mengkonfirmasi switch mode |

Alur pada `switchHistoryMode(mode, url)`:

1. Tampilkan `confirm()` dengan pesan berbeda untuk `'old'` dan `'new'`.
2. Simpan `pref_history_mode` ke `localStorage` (dibungkus `try/catch`).
3. Jika `mode === 'old'`, sekalian set `history_new_mode_notice_dismissed = '1'`.
4. `$.ajax({ url: url, type: 'GET', dataType: 'json' })`; `success` melakukan `location.reload()`, `error` melakukan `location.href = url` sebagai fallback.

Fungsi `dismissHistoryUpgradeNotice()` melakukan `slideUp(200)` pada `.history-upgrade-notice-banner`.

Pesan banner yang ditampilkan: "Pemberitahuan Peningkatan Sistem: Tampilan riwayat transaksi sedang ditingkatkan ke sistem baru (lebih cepat dan hemat memori). Jika Anda mengalami kendala, menemukan bug, atau merasa tidak nyaman, Anda dapat beralih kembali ke mode lama kapan saja."

Styling banner: `alert alert-info alert-dismissible`, `border-left:4px solid #0284c7`, `background-color:#f0f9ff`, `color:#0369a1`, `font-size:12px`. Pada mode server-side, CSS ini juga disuntik: `.legacy-date-filter-panel, #legacy_date_filter { display: none !important; }`.

### 4.4 Dialog Reset Cerdas Saat Nol Data

Ditangani di `drawCallback`. Kondisi pemicu: `pageInfo.recordsDisplay === 0` **dan** (`hasSearchVal` atau `isStepFiltered` atau `isDateFiltered`). Alert disisipkan ke sel `td.dataTables_empty` bila ada, jika tidak di-*prepend* ke kontainer tabel.

Tiga tombol pintas yang dikondisikan:

| Tombol | Condition | Aksi |
|---|---|---|
| `[Cari di Semua Tahapan]` | `isStepFiltered` | `resetStepFilter_{id}()`: `activeStep = 'all'`, set ulang kelas `.btn-step-filter`, `table.ajax.reload()` |
| `[Cari di Semua Tanggal]` | `isDateFiltered` | `resetDateFilter_{id}()`: `isGlobalDate = true`, kosongkan kedua input, update label, reload |
| `[Cari di Seluruh Data Global]` | salah satu aktif | `resetAllFilters_{id}()`: kombinasi keduanya |

Label tanggal aktif dua bentuk: badge `label label-info` dengan ikon `fa-globe` dan teks "Semua Tanggal" bila `isGlobalDate` atau kedua input kosong; badge `label label-default` dengan `fa-calendar` dan teks `d1 s/d d2` (dengan fallback `...`) bila rentang aktif.

### 4.5 Isolasi Panel Filter Tanggal Lama

Pada `template/history.html`, baris pembungkus filter tanggal lama diberi identitas:

```html
<div class="row legacy-date-filter-panel" id="legacy_date_filter">
    <div class="col-md-12">
```

Isi panel lama: input `#date1` dan `#date2` bertipe `date`, tombol navigasi `location.href='{url}?date1='+...+'&date2='+...+'{getSearch}'`. Karena hidden, jalur ini hanya relevan saat mode legacy aktif.

---

## 5. Blueprint Migrasi History Server-Side

### 5.1 Langkah 1: Controller

1. **Tambah endpoint `toggleHistoryMode()`.** Guard session via `gotoLogin()` bila `!isset($this->session->login['id'])`. Ambil `$userId`, `$targetMode` dari `$_GET['mode']` default `'new'`, `$redirectUrl` dari `$_GET['redirect']`. Nilai cookie `($targetMode === 'new') ? '1' : '0'`, set `setcookie("pref_history_serverside_" . $userId, $cookieVal, time() + (365 * 86400), "/")`, cache ke `$_SESSION['login']['pref_history_serverside']`, lalu `redirect()`.
2. **Ubah `viewHistory()` menjadi dispatcher.** Urutan prioritas: `$_SESSION` menang atas `$_COOKIE`; bila cookie ada, session diisi dari cookie.
3. **Buat `viewHistoryServerSide()`.** Salin persiapan UI legacy, tanpa query `MdlTransaksi`, dengan `arrayHistory` kosong.
4. **Ubah `showData()` menjadi dispatcher.** Guard pada versi template: `isset($this->session->login['id']) ? ... : 0`, tanpa `gotoLogin()` (berbeda dari `viewHistory()`).
5. **Tambah `showDataAjax()`.** Bila session habis, kembalikan JSON `draw`, `recordsTotal`, `recordsFiltered`, `data` kosong dengan `error` bernilai `"Session expired"`. Wajib `require_once APPPATH . 'libraries/DatatablesHistory.php'` bila `!class_exists('DatatablesHistory', false)`. Inisialisasi: `$this->datatableshistory->init($jenisTr, $this->configUi, $this->configLayout, $this->placeId)`, opsional `setFilterHook()`, lalu `execute()`. `$jenisTr` diambil dari `$this->jenisTr` atau fallback `$this->uri->segment(4)`.

### 5.2 Langkah 2: View

1. **Inisialisasi tombol switch di awal `switch ($mode)`.** Hitung `$currentFullUrl = current_url() . (!empty($_SERVER['QUERY_STRING']) ? '?' . $_SERVER['QUERY_STRING'] : '')`. Mode server-side memunculkan `<a>` kuning `btn-warning` berikon `fa-backward` menuju `toggleHistoryMode?mode=old&redirect=<urlencode>`; mode legacy memunculkan `<a>` hijau `btn-success` berikon `fa-rocket` menuju `mode=new`.
2. **Pasang tombol di dua titik.** Baris tab navigasi (`<li class='pull-right'>`) dan header box (`<span class='box-tools pull-right'>$btnSwitchHistory &nbsp; $strBg</span>`).
3. **Percabangan render tabel.** `if ($isServerSide) { ... } else { ... }` sesuai Bagian 3.3.

### 5.3 Langkah 3: Validasi Sintaks

```
C:\xampp\php\php.exe -l application/modules/{nama_modul}/controllers/History.php
C:\xampp\php\php.exe -l application/modules/{nama_modul}/views/history.php
```

Harapan keluaran: `No syntax errors detected`.

### 5.4 Langkah 4 (layout v1.1): Helper

`application/helpers/he_misc_helper.php` harus memakai tag baku:

```php
$tblItems .= "<table name='tableHistoryShow' class='table dataTable table-bordered $show_css compact' style='margin-top:0px;font-size:10px;'>";
```

Tujuan: kolom pair / rincian tidak merusak lebar kontainer tabel utama.

### 5.5 Inventaris Modul dan Status

| No | Modul | Path Controller | Status | Catatan Endemik |
|---|---|---|---|---|
| 1 | penjualan | `application/modules/penjualan/controllers/History.php` | SELESAI (PILOT) | Filter salesperson freelance (`transaksi.seller_id`) |
| 2 | pembelian | `application/modules/pembelian/controllers/History.php` | Siap Migrasi | Pihak supplier, foreign currency / valas (`print_nvalas`) |
| 3 | distribusifg | `application/modules/distribusifg/controllers/History.php` | Siap Migrasi | Filter gudang asal, surat jalan dan ekspedisi |
| 4 | penerimaan | `application/modules/penerimaan/controllers/History.php` | Siap Migrasi | Step penerimaan gudang, nomor PO |
| 5 | invoicing | `application/modules/invoicing/controllers/History.php` | Siap Migrasi | Status faktur pajak, pelunasan |
| 6 | kas | `application/modules/kas/controllers/History.php` | Siap Migrasi | Kolom kasir, penagihan, penerima/penyerah dana |
| 7 | pembayaran | `application/modules/pembayaran/controllers/History.php` | Siap Migrasi | Aliran kas keluar / pelunasan hutang |
| 8 | biaya | `application/modules/biaya/controllers/History.php` | Siap Migrasi | Akun beban dan pajak supplier |
| 9 | inputstok | `application/modules/inputstok/controllers/History.php` | Siap Migrasi | Penyesuaian stok manual / opname |
| 10 | pindahgudang | `application/modules/pindahgudang/controllers/History.php` | Siap Migrasi | Mutasi antar-cabang/gudang |
| 11 | produksi | `application/modules/produksi/controllers/History.php` | Siap Migrasi | SPK dan hasil kerja mesin/operator |
| 12 | returpenjualan | `application/modules/returpenjualan/controllers/History.php` | Siap Migrasi | Penerimaan kembali produk retur |

Modul `distribusifg_non_paket` disebut tambahan dalam RANGKUMAN sebagai target berikutnya tetapi tidak masuk tabel 12 pilar.

### 5.6 Jebakan Umum (Common Pitfalls)

1. **Wajib `require_once APPPATH . 'libraries/DatatablesHistory.php';`.** CI3 Wiredesignz HMVC tidak selalu me-load library pihak ketiga lewat magic getter `$this->datatableshistory`. Selalu sertakan `class_exists` guard.
2. **Jangan set `$data['mode'] = 'showData'` di dalam `viewHistory()`.** Nilai mode pada `viewHistory()` harus `'viewHistory'`, jika tidak template `history.html` tidak ter-render dan halaman kehilangan navigasi, menu samping, serta header.
3. **Waspada line endings Windows (`\r\n` vs `\n`).** Pada view `history.php` berukuran besar (lewat 3000 baris), jangan mengandalkan potongan teks pendek; gunakan string unik atau skrip scratch berorientasi string pasti.

4. **Kompatibilitas PHP 5.6 wajib dijaga.** Dilarang keras `??` (gunakan `isset($x) ? $x : $default`), short array `[]` (gunakan `array()`), anonymous class, dan arrow function `fn()`.

### 5.7 Checklist Validasi Modul Baru

| Kelompok | Butir |
|---|---|
| Kode | `php -l` lolos pada semua berkas yang diubah |
| Default mode | Pengguna baru tanpa jejak cookie/session langsung dapat Mode Baru |
| Onboarding | Banner muncul pada kunjungan pertama dengan `[Paksa Kembali Ke Mode Lama]` dan `[Saya Mengerti]`; klik `[Saya Mengerti]` menutup banner dan tidak muncul lagi setelah reload; klik `[Paksa Kembali Ke Mode Lama]` menampilkan konfirmasi lalu berpindah ke legacy |
| Toggle | Tombol `[Coba Tampilan History Baru]` dan `[Kembali Ke Tampilan History Lama]` di header berfungsi mulus dua arah |
| Isolasi filter | Panel tanggal lama di `template/history.html` tersembunyi sempurna pada mode baru |
| Filter tanggal | Tombol `[Terapkan]` memicu `table.ajax.reload()` tanpa reload halaman |
| Reset | Alert kuning 0 data muncul dengan tiga tombol pintas Step, Tanggal, dan Global yang berfungsi |
| Sorting | `Tanggal`, `Nomor`, `Status`, `Customer` terurut ASC/DESC tanpa error database |
| Ekspor | Dropdown `[Unduh Data Mentah]` menampilkan daftar ekspor per step; `[Unduh Tabel]` mengunduh tabel aktif |
| Detail | Detail item merender dengan class baku dan font 10px |
| Dokumentasi | `UAT_HISTORY.md` spesifik modul sudah di-generate |

### 5.8 Risiko dan Mitigasi

| Risiko | Dampak | Mitigasi dari sumber |
|---|---|---|
| Kolom endemik gagal render (Status, Isi) | Data tampak kosong, user salah baca sebagai data hilang | Engine `DatatablesHistory.php` mengintegrasikan `fin_get_payment_status()`, query `transaksi_data_registry` step 9, dan parsing `ids_his` dengan fallback atribut objek |
| Modul punya filter akses yang lupa dipindahkan | Kebocoran data antar-user | Wajib gunakan `setFilterHook()`; contoh pola tersedia di `penjualan` |
| Perilaku berubah mendadak bagi pengguna yang sedang bertransaksi | Komplain operasional dan downtime | Mode opt-in / opt-out per pengguna dengan rollback 1 klik |
| File view sangat besar dan edit gagal diam-diam | Layout rusak sebagian | Perhatikan line endings; pakai skrip scratch dengan string unik |
| Ketidakcocokan engine API antar blueprint | Kode tidak jalan saat plug-and-play | Belum diselesaikan; lihat Bagian 12 |
| Search client-side tidak menjangkau data di luar query lama | User mengira data hilang | Multi-keyword search SARGable di server |
| Sorting pada kolom virtual/relasi | SQL error | Mapping `$safeDbSortCols` dengan fallback aman |

---

## 6. Rangkuman Percakapan Migrasi History

### 6.1 Kronologi Tujuh Sesi

| Sesi | Isi | Hasil Keputusan |
|---|---|---|
| 1 | Permintaan audit seluruh controller `History` | Ditemukan sekitar 70 file. Sudah server-side: `kas` (`jenisTr = '4467'` via `dataHistoryServerSide()`), `invoicing` (via `showDataAjax()`). Mayoritas masih client-side |
| 2 | Pemilihan pilot dan checklist modul | `penjualan` dipilih sebagai pilot; dibuat `checklist_migrasi_history_serverside.md` dan `implementation_plan.md` |
| 3 | Pembuatan engine terpusat | `application/libraries/DatatablesHistory.php`: query binding SARGable, multi-keyword search AND, paging/sorting, filter tanggal `dtime >= date1` dan `dtime <= date2` |
| 4 | Uji coba pertama dan troubleshooting | Fatal error `Call to a member function init() on null` pada line 2064 diperbaiki dengan `class_exists` + `require_once`; kolom Status dan Isi kosong diperbaiki dengan integrasi helper Registry |
| 5 | Gagasan tombol switch opt-in | Dinilai sebagai Best Practice Enterprise (Canary Rollout / User-Level Feature Flag) |
| 6 | Pemasangan fitur switch di `penjualan` | Endpoint `toggleHistoryMode()`, dispatcher di `viewHistory()` dan `showData()`, tombol di dua titik view, validasi `php -l` lolos |
| 7 | Penyusunan blueprint terpusat | `BLUEPRINT_MIGRASI_HISTORY_SERVERSIDE.md` diperbarui sebagai SSOT agar agent berikutnya tidak perlu scanning codebase |

### 6.2 URL Pengujian yang Tercatat

`penjualan/History/viewHistory/5822/5822pkd?page=3&date1=2026-08-20&date2=2026-09-19`. Parameter ini penting sebagai fixture regresi: kombinasi `page`, rentang `date1`-`date2` berselang satu bulan, dan sub-tipe dokumen `pkd`.

### 6.3 Akar Kegagalan Migrasi Masa Lalu (Troubleshooting Sesi 4)

1. **Fatal error `Call to a member function init() on null` (line 2064).** MX_Controller di CI3 tidak me-load library otomatis lewat magic getter. Solusi: `if (!class_exists('DatatablesHistory', false)) { require_once APPPATH . 'libraries/DatatablesHistory.php'; }`.
2. **Kolom Status kosong.** Bukan field fisik `transaksi`; diintegrasikan `fin_get_payment_status($row->id, 1000.0, true)` dari `he_finansial_helper.php`.
3. **Kolom Isi kosong.** Data di NoSQL / `transaksi_data_registry` step 9 (`items`, `items2`); diintegrasikan query registry plus `viewDetailTransaksi()` dengan fallback mini-tabel.
4. **Kolom Step dan Key kosong.** Field `nomer_soa`, `pengirim_nama`, `worker_nama`, `seller_nama` di-decode dari blob JSON `ids_his` per step.

### 6.4 Tabel Keputusan Teknis

| Aspek | Keputusan |
|---|---|
| Engine server-side | Library terpusat `application/libraries/DatatablesHistory.php` |
| Penyimpanan pilihan user | Cookie browser 1 tahun `pref_history_serverside_{UID}` plus `$_SESSION['login']` |
| Alur controller | Pola dispatcher: `viewHistory()` dan `showData()` membagi ke `*ServerSide()` atau `*Legacy()` |
| Kolom status pembayaran | `fin_get_payment_status()` dari `he_finansial_helper.php` |
| Kolom rincian barang | `transaksi_data_registry` step 9, render via `viewDetailTransaksi()` |
| Kolom step dan key | Decode JSON blob `ids_his` per nomor step dan nama key |
| Filter endemik modul | `$this->datatableshistory->setFilterHook($callback)` |
| Kompatibilitas bahasa | Wajib PHP 5.6; tanpa `??`, short array `[]`, arrow function |

### 6.5 Alasan di Balik Keputusan

- **Engine tunggal, bukan copy-paste.** Migrasi 70 controller dengan query sendiri akan menghasilkan duplikasi ribuan baris; satu library reusable menjaga efisiensi dan kemudahan review.
- **Feature flag, bukan cutover.** Karena tidak bisa dipastikan fitur dan kolom unik apa saja yang ada di setiap modul history, tombol opt-in dipilih. Konsekuensinya: fitur bisa diuji lapangan tanpa memaksa pengguna yang sedang sibuk menghadapi perubahan mendadak.
- **Rollback instan 1 detik.** Bila ada kolom kustom yang belum ter-render sempurna di satu modul, user cukup klik tombol, tanpa menunggu perbaikan kode.
- **Persistensi 1 tahun.** Supaya user tidak perlu menekan tombol berulang kali setiap kali masuk, dan agar preferensi tidak reset di sesi berikutnya.

### 6.6 Status Terkini dan Antrian Selanjutnya

- Pilot `penjualan` selesai dipasang dan siap diuji pengguna.
- Blueprint terpusat lengkap sebagai panduan baku developer maupun agent.
- Antrian berikutnya: `pembelian`, lalu `distribusifg` dan `distribusifg_non_paket`, `penerimaan`, `invoicing`, dan `kas`.

---

## 7. Instrumen UAT History (Golden Circle 5W1H)

### 7.1 Identitas Instrumen

- Judul: "INSTRUMEN UAT: RIWAYAT TRANSAKSI PEMBELIAN (SERVER-SIDE DATATABLES)"
- Modul: `pembelian`
- Metode: Golden Circle (Why, How, What) dan 5W + 1H
- Versi Sistem: 1.1 (Server-Side DataTables + Onboarding LocalStorage)

### 7.2 WHY - Lingkaran Inti

**Why.** Menghapus keluhan sistem macet saat staf pengadaan dan gudang membuka riwayat pembelian berisi puluhan ribu PO dan Surat Jalan Masuk (GRN); menjamin integritas rantai pasok dan hutang dagang (Procure-to-Pay) untuk kolom Nama Supplier, Nomor PRE-PO, Nomor PO, Nomor GRN, Gudang Penerimaan, Referral Invoice Vendor, Diskon, PPN Masukan, dan Total Nilai; melindungi transacti valuta asing melalui cetak nota valas dan data mentah per tahapan (Pre-PO, PO, Pre-GRN, GRN) untuk rekonsiliasi akuntansi hutang dagang; serta memberi edukasi visual lewat banner peningkatan sistem dengan jalan keluar tombol kembali ke mode lama.

**Who.** Penguji utama: staf Purchasing / Procurement dan Admin Gudang Penerimaan. Penguji pendukung: bagian Hutang / Accounts Payable dan Finance. Verifikator teknis: QA / Developer yang memeriksa network payload AJAX, query binding database, dan log konsol.

**When.** Dijalankan pada tahap verifikasi rilis modul `pembelian` setelah 12 pilar arsitektur Server-Side DataTables selesai diterapkan.

### 7.3 HOW - Lingkaran Proses

**Where.**
- `[base_url]/pembelian/History/viewHistory/466` - FG Purchasing
- `[base_url]/pembelian/History/viewHistory/461` - Supplies Purchasing
- `[base_url]/pembelian/History/viewHistory/463` - Service Purchasing
- Lingkungan uji: browser desktop (Chrome, Firefox, Edge) dengan DevTools aktif.

**How - Tujuh Zona Observasi.**

1. Zona Onboarding Pengguna Baru: respon default mode baru dan interaksi banner via `localStorage`.
2. Zona Toggle Mode: peralihan dua arah Mode Baru dan Mode Lama.
3. Zona Filter Tanggal AJAX: filter tanggal tanpa refresh halaman.
4. Zona Tahapan Transaksi: filtrasi Pre PO, PO, Pre GRN, GRN.
5. Zona Pencarian dan Fail-Safe Data Kosong: banner interaktif saat data 0.
6. Zona Ekspor dan Cetak: unduh tabel, unduh data mentah per step, cetak dokumen.
7. Zona Integritas Data Kolom Pasangan dan Valas: data registry `item_fields`, nama supplier, referral invoice vendor, dan valas (`print_nvalas`).

### 7.4 WHAT - Matriks 13 Skenario

| ID | Fitur yang Diuji | Alasan | Langkah dan Ekspektasi |
|---|---|---|---|
| UAT-PBL-01 | Default Mode dan Banner Onboarding | Pastikan staf baru diarahkan ke server-side cepat dengan panduan | `localStorage.clear()`, buka `/pembelian/History/viewHistory/466`; hasil: langsung Mode Baru plus banner biru "Pemberitahuan Peningkatan Sistem..." dengan `[Paksa Kembali Ke Mode Lama]` dan `[Saya Mengerti]` |
| UAT-PBL-02 | Dismiss Banner via `localStorage` | Banner tidak boleh mengganggu user yang sudah paham | Klik `[Saya Mengerti]` (banner slide up), refresh; banner tetap tidak muncul (`history_new_mode_notice_dismissed = 1`) |
| UAT-PBL-03 | Paksa Revert ke Mode Lama via Banner | Jalan keluar instan untuk staf operasional | Klik `[Paksa Kembali Ke Mode Lama]`; konfirmasi muncul, setelah disetujui halaman reload ke mode lama dengan tab nav konvensional dan filter tanggal lama |
| UAT-PBL-04 | Toggle Mode Manual di Header | Fleksibilitas kapan saja | Klik hijau `[Coba Tampilan History Baru]` lalu kuning `[Kembali Ke Tampilan History Lama]`; perpindahan dua arah mulus |
| UAT-PBL-05 | Filter Rentang Tanggal Murni AJAX | Ganti periode tanpa refresh | Set `filter_date1` dan `filter_date2`, klik `[Terapkan]`; data ter-update AJAX tanpa reload URL. Klik `[Semua Tanggal]`; input kosong, badge "Semua Tanggal" aktif |
| UAT-PBL-06 | Filter Step Tahapan Pembelian | Saring pengadaan per tahapan | Klik `[Semua]`, `[PRE PURCHASE ORDER]`, `[PURCHASE ORDER]`, `[PRE GOODS RECEIVED NOTE]`, `[GOODS RECEIVED NOTE]`; tombol aktif biru, baris terfilter instan via AJAX |
| UAT-PBL-07 | Unduh Data Mentah Per-Step | Rekap per step untuk rekonsiliasi hutang dan audit | Buka dropdown `[Unduh Data Mentah]`, pilih opsi; spreadsheet Excel terunduh utuh |
| UAT-PBL-08 | Unduh Tabel Aktif dan Cetak | Ekspor cepat data layar | Klik `[Unduh Tabel]` (Excel via `fnExcelReport`), klik `[Cetak]` (jendela print browser rapi) |
| UAT-PBL-09 | Pencarian Bertingkat dan Dialog 0 Data | Cegah kebingungan saat nomor PO/GRN tidak muncul | Cari `PO-SUPPLIER-TIDAK-ADA-999`; alert kuning "Data tidak ditemukan..." dengan `[Cari di Semua Tahapan]`, `[Cari di Semua Tanggal]`, `[Cari di Seluruh Data Global]`; klik pintas reset, filter ter-reset dan tabel reload |
| UAT-PBL-10 | Dual Pagination Atas dan Bawah | Efisiensi navigasi | Pindah halaman lewat pagination atas; pagination bawah tersinkronisasi. Ganti panjang halaman 10, 20, 50, 100; jumlah baris berubah seketika |
| UAT-PBL-11 | Sorting Multi-Kolom Database | Urutkan per tanggal, nomor, supplier | Klik header `Tanggal`, `Nomor`, `Supplier`; urutan ASC/DESC tanpa error SQL |
| UAT-PBL-12 | Kelengkapan Kolom Registry dan Identitas Dokumen | Pastikan dokumen turunan tidak kehilangan identitas | Periksa baris GRN / 467; kolom nama supplier, PRE PO number, PO number, gudang penerimaan, dan referral invoice vendor terisi berkat fallback ke transaksi induk `id_top` |
| UAT-PBL-13 | Tampilan Rincian Item Barang | Rincian SKU, qty, harga satuan, dan diskon tampil rapi | Klik lihat detail pada kolom isi; tabel rincian muncul format `compact` font 10px tanpa merusak lebar kontainer utama |

### 7.5 Kriteria Penerimaan (Exit Criteria)

1. Seluruh 13 skenario berstatus PASSED.
2. Pengguna baru otomatis masuk ke mode baru dengan banner ramah.
3. Tidak ada error JavaScript pada console browser.
4. Tim purchasing dan pergudangan menyatakan nyaman memakai sistem riwayat pembelian baru.

Catatan keterkaitan: instrumen ini **sudah ada** untuk modul `pembelian` yang pada BLUEPRINT_MIGRASI masih berstatus "Siap Migrasi".URUTAN_DOKUMEN tidak konsisten (lihat Bagian 12).

---

## 8. Rekonsiliasi ID Supplier 4

### 8.1 Identitas Keduanya

| Aspek | Laporan Full | Laporan Mismatch-Only |
|---|---|---|
| Nama berkas | `rekonsiliasi_transaksi_id_supplier_4_20260418_100638.md` | `rekonsiliasi_transaksi_id_supplier_4_mismatch_only_20260418_101235.md` |
| Waktu pada nama berkas | 2026-04-18 10:06:38 | 2026-04-18 10:12:35 (enam menit kemudian) |
| Judul H1 | Laporan Rekonsiliasi per transaksi_id | Laporan Rekonsiliasi Mismatch per transaksi_id |
| Ukuran | 2.836 byte, 39 baris | 17.637 byte, 113 baris |
| `supplier_id` | 4 | 4 |
| `supplier_nama` | PT.PANASONIC GOBEL INDONESIA | PT.PANASONIC GOBEL INDONESIA |
| `rekening acuan` | `1010020030` | tidak dispesifikasikan di sumber |
| `cabang_id` | -1 | tidak dispesifikasikan di sumber |
| `gudang_id` locker | -1 | tidak dispesifikasikan di sumber |
| Filter | seluruh transaksi | `status_rekonsiliasi != MATCH` |

### 8.2 Tabel Perbandingan Angka

| Metrik | Laporan Full | Laporan Mismatch-Only | Selisih |
|---|---:|---:|---:|
| `total_transaksi` / `total_mismatch` | 775 | 97 | - |
| `status_MATCH` | 678 | tidak ada (filter sudah ekscludes MATCH) | - |
| `status_LOCKER_UNDER` | 41 | 41 | 0 |
| `status_LOCKER_ZERO` | 56 | 56 | 0 |
| `total_debet_rek` / `total_debet_rek_mismatch` | 7.395.422.141,53798 | 2.068.502.449,00436 | 5.326.919.692,53362 |
| `total_locker_awal` / `total_locker_awal_mismatch` | 5.469.079.973,5074 | 142.160.280,973779 | 5.326.919.692,533621 |
| `total_selisih` | 1.926.342.168,03058 | 1.926.342.168,03058 | **0** |

### 8.3 Temuan Kuantitatif Kunci

1. **Selisih total identik.** Kedua dokumen menghasilkan `1.926.342.168,03058`. Secara aritmetika, seluruh selisih berasal dari 97 baris mismatch; 678 baris MATCH menyumbang selisih nol.
2. **Konservasi angka.** `7.395.422.141,53798 - 2.068.502.449,00436 = 5.326.919.692,53362` dan `5.469.079.973,5074 - 142.160.280,973779 = 5.326.919.692,533621`. Kedua selisih MATCH bernilai nol sampai presisi floating point.
3. **Distribusi 97 mismatch.** `LOCKER_ZERO` 56 baris menyumbang `946.767.530,46` (49,16 persen); `LOCKER_UNDER` 41 baris menyumbang `979.574.637,57` (50,84 persen).
4. **Tiga status, tapi `locker_nilai_active` selalu nol.** Pada seluruh 97 baris, `locker_nilai_active = 0,000000`. Kolom ini hanya ada di laporan mismatch-only.-meaningful diff: locker tidak pernah punya nilai aktif untuk supplier ini.
5. **Identitas baris MATCH tidak tersedia.** Laporan full hanya menyediakan 20 baris teratas, bukan daftar 678 baris MATCH. Karena itu laporan full tidak dapat diaudit ulang secara independen.

### 8.4 Distribusi Mismatch per Jenis Transaksi

Dihitung ulang dari tabel pada laporan mismatch-only:

| `jenis` | Jumlah Baris | Sum `debet_rek` | Sum `locker_awal` | Sum `selisih` |
|---|---:|---:|---:|---:|
| 467 | 93 | 1.359.272.449,05 | 142.160.280,97 | 1.217.112.168,08 |
| 3344 | 2 | 368.221.500,00 | 0,00 | 368.221.500,00 |
| 999 | 1 | 317.354.905,00 | 0,00 | 317.354.905,00 |
| 967 | 1 | 23.653.594,95 | 0,00 | 23.653.594,95 |
| **Total** | **97** | **2.068.502.449,00436** | **142.160.280,973779** | **1.926.342.168,03058** |

Dominasi `jenis = 467` (93 dari 97, yaitu 95,88 persen) menunjukkan masalah terkonsentrasi pada satu alur dokumen, bukan tersebar merata.

### 8.5 Sepuluh Selisih Terbesar

| # | `transaksi_id` | `jenis` | `nomer` | `fulldate` | `debet_rek` | `locker_awal` | `selisih` | Status |
|---|---|---|---|---|---:|---:|---:|---|
| 1 | 611713 | 3344 | 3344.-1.107 | 2025-11-05 | 361.471.500,000000 | 0,000000 | 361.471.500,000000 | LOCKER_ZERO |
| 2 | 552047 | 999 | 999.-1.63 | 2025-08-28 | 317.354.905,000000 | 0,000000 | 317.354.905,000000 | LOCKER_ZERO |
| 3 | 496545 | 467 | 467.-1.2747 | 2025-06-28 | 58.243.764,703792 | 3.505.411,764580 | 54.738.352,939212 | LOCKER_UNDER |
| 4 | 505959 | 467 | 467.-1.2803 | 2025-07-07 | 58.243.764,703792 | 3.505.411,764580 | 54.738.352,939212 | LOCKER_UNDER |
| 5 | 506207 | 467 | 467.-1.2804 | 2025-07-08 | 58.243.764,703792 | 3.505.411,764580 | 54.738.352,939212 | LOCKER_UNDER |
| 6 | 493520 | 467 | 467.-1.2729 | 2025-06-25 | 58.243.764,703792 | 3.505.411,764580 | 54.738.352,939212 | LOCKER_UNDER |
| 7 | 494063 | 467 | 467.-1.2739 | 2025-06-25 | 58.243.764,703792 | 3.505.411,764580 | 54.738.352,939212 | LOCKER_UNDER |
| 8 | 494735 | 467 | 467.-1.2744 | 2025-06-26 | 58.243.764,703792 | 3.505.411,764580 | 54.738.352,939212 | LOCKER_UNDER |
| 9 | 507297 | 467 | 467.-1.2810 | 2025-07-09 | 58.243.764,703792 | 6.201.882,352719 | 52.041.882,351073 | LOCKER_UNDER |
| 10 | 508794 | 467 | 467.-1.2819 | 2025-07-10 | 58.243.764,703792 | 6.201.882,352719 | 52.041.882,351073 | LOCKER_UNDER |

Dua baris terbesar (361,5 juta dan 317,4 juta) menyumbang 35,26 persen dari total selisih. Keduanya berstatus `LOCKER_ZERO`, keduanya `locker_awal = 0`, dan keduanya bukan `jenis = 467`.

### 8.6 Pola `debet_rek` Berulang

Nilai `debet_rek` berulang pada banyak baris `jenis = 467`: `58.243.764,703792` muncul pada 14 baris; `30.582.866,396999` pada 5 baris; `29.121.882,351896` pada 2; `27.275.294,116594` pada 2; `15.079.058,823353` pada 3; `9.462.198,000000` pada 5; `4.221.176,470425` pada 6; `3.505.411,764580` pada 15; `3.861.458,823628` pada 3; `3.775.058,823394` pada 2; `3.564.423,529503` pada 3. Pola ini konsisten dengan satu dokumen induk yang dipecah ke banyak dokumen turunan dengan nilai turunan yang tidak sama.

### 8.7 Jejak Waktu

| Observasi | Nilai |
|---|---|
| Rentang `fulldate` | 2024-03-15 sampai 2025-11-05 |
| `reg_create_at` | seragam `2026-02-02 23:03:36` pada seluruh 97 baris |
| Nilai kosong pada `locker_last_dtime` | 2 baris (`552047` jenis 999, `573520` jenis 967) |
| Klaster `locker_last_dtime` | 2025-04-17 10:29:07 sampai 10:29:09 (puluhan baris) dan 2025-08-20 10:19:44 sampai 11:52:30 |

`reg_create_at` yang seragam pada semua baris menunjukkan laporan dibangun dari satu snapshot registry, bukan dari satu proses rekonsiliasi per transaksi. Klaster timestamp `locker_last_dtime` pada 2025-04-17 dan 2025-08-20 mengindikasikan pemrosesan massal; interpretasi ini **tidak dinyatakan eksplisit di sumber**.

### 8.8 Hipotesis Penyebab (Tidak Dispesifikasikan di Sumber)

Sumber tidak memuat analisis akar masalah untuk laporan ini; sumber hanya memuat angka. Hipotesis yang konsisten dengan data namun belum dikonfirmasi:

1. Untuk `LOCKER_ZERO` (56 baris): `locker_awal = 0` padahal ada `debet_rek`; locker tidak pernah dibuat atau tidak ter-backfill.
2. Untuk `LOCKER_UNDER` (41 baris): `locker_awal` ada dan sama dengan `locker_nilai_diklaim`, tetapi nilainya jauh lebih kecil dari `debet_rek`; indikasi backfill hanya sebagian atau terpotong per dokumen turunan.
3. Dua baris dengan `locker_last_dtime` kosong adalah kandidat paling lemah untuk ditindaklanjuti karena tidak ada jejak pemrosesan sama sekali.

### 8.9 Rekomendasi Rekonsiliasi

1. Jalankan kueri verifikasi langsung ke database untuk memastikan 678 baris MATCH, karena laporan full tidak menyediakannya.
2. Rekonsiliasi per `jenis` terlebih dahulu (mulai `jenis = 467`, 93 baris) karena menyumbang 63,19 persen dari total selisih.
3. Prioritaskan `transaksi_id` 611713 dan 552047 yang bersama-sama menyumbang 678,8 juta.
4. Backfill `locker_awal` untuk 56 baris `LOCKER_ZERO` dan lengkapi 41 baris `LOCKER_UNDER`.
5. Investigasi dua baris tanpa `locker_last_dtime`.

---

## 9. Master Data dan Compliance Score

### 9.1 Scope Audit

- Target: pemecahan 5 Domain Bisnis pada controller `MasterData.php` berukuran 28.401 baris.
- Standar pengujian: `W:\GLOBAL_AGENT` (`global_rules.md` dan `AGENTS.md`).
- Rata-rata skor kode lama: **6 / 100** (kritis, gagal audit).
- Target skor kode baru: **100 / 100** (enterprise compliant).

### 9.2 Matriks Lima Aturan

| No | Aturan GLOBAL_AGENT | Skor Sebelum | Kondisi Saat Ini | Skor Target | Action Item untuk AI Agent |
|---|---|---:|---|---:|---|
| 1 | Keamanan Database (query binding dan `trans_start`) | 0/100 | Kueri `INSERT`/`UPDATE` mentah tanpa pembungkus transaksi; rentan data korup sebagian masuk sebagian gagal | 100/100 | Ubah semua string kueri mentah menjadi Query Builder aktif saat memindahkan kode ke Engine |
| 2 | Integritas Data dan Anti-Overselling (`qty <= saldo riil - locker`) | 10/100 | Nilai SPK (RAB) dihitung langsung (`$jml * $harga`) di Controller tanpa validasi stok fisik sebelum dikunci | 100/100 | Suntikkan rumus early validation saldo versus locker saat mengekstraksi logika SPK |
| 3 | Performa dan Indexing (dilarang `!=`, gunakan klausa `IN`) | 20/100 | Banyak klausa `!=` memaksa MySQL melakukan full table scan pada tabel masif | 100/100 | Bersihkan kueri read-only; konversi klausa negatif menjadi `WHERE IN (...)` agar composite index bekerja |
| 4 | Protokol Caching Redis (isolasi multi-app dan naming convention) | 0/100 | Status locker, state penomoran, dan akses data berat dihajar ke DB relasional; sesi bertumpuk liar di `$_SESSION` | 100/100 | Pastikan Engine pembaca state memanggil Redis, misalnya `locker_status_[MdlName]_[ID]` |
| 5 | Sinkronisasi Dokumentasi (doc-sync protocol) | 0/100 | `master_project.md` dan `kamus_transaksi.md` usang; perubahan status mutasi SPK tidak tercatat | 100/100 | Eksekusi Task Fase 9: update manual Markdown dokumentasi setelah kode selesai |

Verifikasi aritmetika: rata-rata `(0 + 10 + 20 + 0 + 0) / 5 = 6`, konsisten dengan klaim dokumen.

### 9.3 Komponen Teknis yang Disebut

| Komponen | Peran |
|---|---|
| `ComProjectWorkOrderEngine` | Tujuan ekstraksi kalkulasi nilai SPK (RAB) beserta early validation stok fisik |
| `trans_start()` / `trans_complete()` | Pembungkus transaksi untuk semua penulisan |
| Redis dengan *zero-config prefix* | Cache dropdown master dan parameter state, standar 50+ aplikasi server; naming convention `locker_status_[MdlName]_[ID]` |
| `global_rules.md` dan `AGENTS.md` | Dokumen aturan acuan di `W:\GLOBAL_AGENT` |
| `master_project.md`, `kamus_transaksi.md` | Dokumentasi pusat yang harus di-sync |

### 9.4 Kesimpulan Sumber

Kondisi modul disebut "sangat berbahaya secara operasional" dan pemecahan menjadi 5 Domain Engine bukan lagi pilihan refactoring melainkan **evakuasi arsitektur wajib** untuk menyelamatkan integritas data klien.

### 9.5 Keterkaitan dengan Migrasi History

Ada dua irisan teknis yang tidak dieksplisitasi di sumber:

1. **Redis versus query berulang.** Pilar 4 blueprint history menyebut query SARGable dan batch query registry, **bukan** Redis. Namun audit master data menyatakan status locker dihajar berulang ke DB relasional dan wajib dipindah ke Redis. Bila engine history memuat kolom `locker_*`, pola cache yang sama seharusnya diterapkan.
2. **Anti-index pada klausa `!=`.** Blueprint history menyebut SARGable dan composite index sebagai kunci; audit master data menunjukkan klausa `!=` adalah penyebab utama full table scan. Aturan yang sama berlaku untuk query filter step dan filter tanggal pada engine history.

Kedua hal tersebut **tidak dispesifikasikan di sumber** sebagai linkage formal; ini konsekuensi logis dari dua dokumen terpisah.

---

## 10. Serial Number Issue

### 10.1 Gejala

Produk ID **25137** (`KABEL SUPREME NYM 4 X 4 - POS`) tidak menampilkan daftar serial number pada Buku Pembantu Persediaan di `/LedgerV2/viewBalances_l1/RekeningPembantuProduk/1010030030`.

### 10.2 Bukti pada Database

| Aspek | Nilai |
|---|---|
| Tabel `produk`, kolom `jml_serial` | `1` (aktif, menggunakan serial) |
| Tabel `produk_per_serialnumber` | 15 item terdaftar, `status = 1`, `trash = 0` |
| Transaksi pembentuk serial | Transaksi ID `845267`, nomor `1334sc.-1.-1.211` |
| Tabel `_rek_pembantu_produk_perserial_cache` untuk `produk_id = 25137` | kosong (0) |

### 10.3 Penyebab Teknis

**A. Transaksi masih Draft (`1334sc`).** Transaksi ID `845267` memiliki `jenis = '1334sc'`, yaitu Step 2 (Scan QR/Barcode) dari alur Konversi Produk Pusat (`1334`). Karena belum mencapai Step 3 (`1334`, Otorisasi Konversi Produk), tabel `_rek_pembantu_produk_cache` maupun `_rek_pembantu_produk_perserial_cache` masih bernilai `transaksi_id = 0` dan `transaksi_no = 0`.

**B. Komponen Akunting Tidak Mendukung Serial Ledger.** Berdasarkan `application/config/heTransaksi_core.php` pada line 29906, transaksi `jenis = 1334` hanya mendaftarkan satu komponen pada `"components" -> "detail"`:

```php
array(
    "comName" => "RekeningPembantuProduk",
    "loop" => array(
        "persediaan produk" => "-sub_hpp",
    ),
    ...
)
```

Komponen `ComRekeningPembantuProdukPerSerial` dan `ComRekeningPembantuProdukPerSerialIntransit` **tidak didaftarkan**. Akibatnya hanya saldo kuantitas produk umum yang bertambah; data serial number tidak disalin ke tabel cache.

**C. Skrip Perbaikan Hardcoded.** Fungsi `copySerialNumber()` di `application/controllers/ToolsGenerator.php` line 6243 mengunci kuerinya pada satu transaksi:

```sql
WHERE p.status = '1'
  AND p.trash = '0'
  AND p.cabang_id != -100
  AND p.transaksi_id = '846523'
```

Transaksi `845267` tidak ikut tersalin saat utilitas dijalankan.

### 10.4 Rantai Penyebab

`1334sc` masih draft (Step 2) sehingga tidak ada posting ledger; konfigurasi `1334` tidak mendaftarkan komponen per-serial sehingga data tidak akan tersalin meski diposting; skrip `copySerialNumber()` terkunci pada `846523` sehingga tidak dapat menutupi `845267`. Tiga sebab kumulatif.

### 10.5 Catatan Kritis tentang Klausa `!=`

Klausa `p.cabang_id != -100` pada skrip `copySerialNumber()` adalah contoh konkret pelanggaran aturan GLOBAL_AGENT pada audit master data (aturan 3: dilarang `!=`, gunakan `IN`). Aturan yang sama akan mencegah full table scan pada tabel `produk_per_serialnumber`.

### 10.6 Keterkaitan dengan Rekonsiliasi Locker

Dokumen ini dan laporan rekonsiliasi supplier 4 sama-sama berputar pada data di luar tabel `transaksi`: serial pada cache `_rek_pembantu_produk_perserial_cache`, locker pada `locker_awal` dan `locker_nilai_active`. Keduanya menunjukkan pola yang sama: **data primer benar, data turunan (cache) tidak sinkron**. Dalam kasus serial, cache kosong; dalam kasus locker, cache ada tapi bernilai nol atau kurang. Namun sumber **tidak menyatakan** relasi formal antar keduanya, dan nomor rekening yang disebut berbeda (`1010030030` untuk LedgerV2 produk, `1010020030` untuk rekening acuan rekonsiliasi).

### 10.7 Catatan tentang Nomor Rekening

`1010030030` (LedgerV2, RekeningPembantuProduk, produk 25137) dan `1010020030` (rekening acuan rekonsiliasi supplier 4) berbeda pada posisi keempat digit (`1003` versus `1002`), meski keduanya berbagi prefix `101`. Apakah ini salah ketik pada satu dokumen atau memang dua rekening berbeda **tidak dispesifikasikan di sumber**; namun pola ini layak diverifikasi karena kesalahan digit pada rekening acuan akan membuat seluruh angka selisih `1.926.342.168,03058` tidak valid.

---

## 11. Audit Proyek Komprehensif (Konteks Audit Trail)

Dokumen Though di luar cakupan migrasi History, `audit_proyek_komprehensif.md`Nnneeded sebagai pembanding methodologi audit yang dipakai pada ERP ini.

- Tanggal audit: 26 Agustus 2026.
- Populasi: 253 proyek aktif (`trash = 0`, `status = 1`) plus 27 proyek terhapus.
- Database: `run_everest_modul`, tabel `project_produk`, `transaksi_payment_source`, `transaksi`.

### 11.1 Ringkasan Dimensi

| # | Dimensi | Temuan | Severity |
|---|---|---:|---|
| 1 | Cabang mismatch (TPS versus `project_produk`) | 21 | MEDIUM |
| 2 | Proyek terhapus (`trash = 1`) | 27 | INFO |
| 3 | DP request tapi kasir belum terima | 0 | CLEAN |
| 4 | Faktur 7499 belum senilai kontrak | 60 | MEDIUM |
| 5 | `closing_status > 0` | 107 | INFO |
| 6a | Tanpa SO/SPK (`quot_nomer` kosong) | 15 | HIGH |
| 6b | Harga kontrak Rp 0 | 21 | HIGH |
| 6c | SPK ada, SO kosong | 0 | CLEAN |
| 6d | Customer kosong/NULL | 0 | CLEAN |
| 6e | Customer multi-cabang | 2 | INFO |
| 6f | SO nomer duplikat | 0 | CLEAN |
| 6g | Overpayment (bayar > tagihan) | 0 | CLEAN |

Distribusi 253 proyek aktif: Faktur 7499 lengkap 165, Faktur 7499 belum lengkap 60, tanpa TPS atau aktivitas tagihan 28.

### 11.2 Temuan Kritis yang Relevan bagi History

| # | Temuan | Detail Kunci |
|---|---|---|
| 1 | Empat proyek dengan TPS hanya `cabang_id = -1` | #281 RUANG BROWNIES, #282 VICTORIA CENTRAL DISTRICT, #283 AMARILLO VILLAGE, #284 CANNA - UNIT. Jika kasir login di cabang manapun, proyek tidak terlihat di panel EPFC karena filter isolasi cabang |
| 2 | Empat proyek `closing_status = 99` tetapi masih `trash = 0, status = 1` | #8 PASADENA GRAND RESIDENCES (TROPIS) ditutup 2024-10-31 17:12:15 oleh `everest`; #9 MENTENG VILLAGE 2024-10-31 17:13:06 oleh `everest`; #11 PASADENA GRAND RESIDENCES (CLASSIC) 2024-11-02 09:47:25 oleh `everest`; #25 NORTH MALIBU 2025-04-17 14:05:31 oleh `sys_shadow` |
| 3 | Gap tagihan belum terbit untuk 60 proyek | Sekitar **Rp 6,03 miliar**. Gap terbesar #231 GRAND PASADENA VILLAGE sebesar `Rp 1.929.837.993` (kontrak `Rp 2.893.310.335`, faktur `Rp 963.472.342`, 33,3 persen) |
| 4 | Enam proyek punya SO tetapi harga 0 | #193 dengan SO `588so.1.3557.1`, #259 `588so.1.1478.61`, #260 `588so.1.1478.60`, #261 `588so.1.1478.59`, #262 `588so.1.1478.58`, #263 `588so.1.1478.57`. Hipotesis: SPK belum diapprove sehingga harga belum ter-sync ke `project_produk.harga` |

### 11.3 Pola Nomor Dokumen

Terlihat pola nomor yang konsisten dengan tabel rekonsiliasi: nomor transaksi history membentuk `{jenis}.{step}.{urut}` (contoh `467.-1.2747`, `999.-1.63`, `3344.-1.107`), sedangkan nomor SO project berbentuk `588so.1.3557.1`. Ini membantu memahami kolom `nomer` di tabel history dan kolom `nomer_soa` di dalam `ids_his`.

---

## 12. Temuan Lintas-Dokumen dan Kontradiksi

### 12.1 Kontradiksi Teknis Antara Dua Blueprint

| No | Aspek | BLUEPRINT_MIGRASI_HISTORY_SERVERSIDE | blueprint_layout_akhir_history v1.1 | Dampak |
|---|---|---|---|---|
| K1 | Default mode | `$isServerSide = false`, opt-in | `$isServerSide = true`, opt-out lewat banner | Pengguna baru melihat tampilan berbeda tergantung versi blueprint yang dipakai |
| K2 | Elemen toggle | `<a href='...'>` link biasa, reload penuh | `<button>` + `switchHistoryMode(mode, url)` dengan `$.ajax` lalu `location.reload()` | Dua UX berbeda; link lebih sederhana dan tahan gagal |
| K3 | Controller toggle | `$_GET['mode']` dan `$_GET['redirect']` langsung; tidak ada cabang AJAX | `$this->input->get()`; menambah cabang `is_ajax_request()` yang mengembalikan JSON `{"status":"success","mode":...}` | Versi v1.1 kompatibel dengan AJAX, versi lama tidak |
| K4 | Redirect fallback | `MODUL_PATH . "History/viewHistory/" . $this->jenisTr` | `base_url() . $this->uri->segment(1) . "/History/data"` | Endpoint fallback berbeda; `/History/data` **tidak didefinisikan** di anatomy controller mana pun |
| K5 | Lokasi engine | `application/libraries/DatatablesHistory.php` (kanonik, shared) | `application/modules/[nama_modul]/libraries/DatatablesHistory.php` "(atau shared)" | Risiko duplikasi engine dan perilaku berbeda antar modul |
| K6 | API engine | `init($jenisTr, $this->configUi, $this->configLayout, $this->placeId)` lalu `execute()` | `$dt->getData($jenisTr, $stepFilter, $date1, $date2, $isGlobalDate, $postData)` | Kontrak berbeda; kode dari satu blueprint tidak jalan di blueprint lain |
| K7 | `pageLength` | "paging 20" | `pageLength: 10`, `lengthMenu [[10,20,50,100],[10,20,50,100]]` | Perilaku bawaan tabel berbeda |
| K8 | Guard session expired | JSON dengan `draw`/`recordsTotal`/`recordsFiltered`/`data` kosong plus `error: "Session expired"` | `show_404()` bila bukan AJAX | Respons HTTP berbeda; 404 menutupi diagnosis sesi habis |
| K9 | Penanda nama file | `DatatablesHistory.php` dan kelas `DatatablesHistory` | `DatatablesHistory.php` dan `DatatablesHistory` | Nama file berbeda kapitalisasi; pada Windows tidak bermasalah, pada Linux bermasalah |

### 12.2 Kontradiksi Status Modul

| Aspek | BLUEPRINT_MIGRASI (tabel inventaris) | RANGKUMAN PERCAKAPAN |
|---|---|---|
| `kas` | "Siap Migrasi" | Sudah server-side untuk `jenisTr = '4467'` via `dataHistoryServerSide()` |
| `invoicing` | "Siap Migrasi" | Sudah server-side via `showDataAjax()` |
| `pembelian` | "Siap Migrasi" | Termasuk antrian berikutnya; namun `UAT_HISTORY.md` untuk `pembelian` sudah terbit |
| Cakupan modul | 12 modul terdaftar | sekitar 70 file controller `History.php` |

Implikasi: tabel inventaris 12 modul kemungkinan hanya daftar prioritas migrasi, bukan daftar Exhaustif modul yang ada. Dan keberadaan `UAT_HISTORY.md` untuk `pembelian` menunjukkan implementasi module `pembelian` sudah(Setidaknya) sampai tahap verifikasi,amadvan stigma tabel inventaris.

### 12.3 Ketidaksesuaian Minor

| No | Aspek | Sumber A | Sumber B |
|---|---|---|---|
| M1 | Nama variabel `filter_date1` | UAT-PBL-05 menyebut `filter_date1` dan `filter_date2` | View v1.1 memakai `filter_date1_$tableHtmlId` dan `filter_date2_$tableHtmlId` |
| M2 | Nama kolom step | Blueprint menyebut `status_bayar` dan `status_next` | View v1.1 memakai `status_dokumen` dengan tipe `status_badge` |
| M3 | Sifat `getUniformHistoryFields($jenisTr)` | Menerima parameter `jenisTr` | Body fungsi mengembalikan array statis yang mengabaikan parameter tersebut |
| M4 | Badge status | Sumber menyebut emoji LUNAS, CICILAN, BELUM LUNAS | Sintesis ini tidak dapat merender emoji; warna badge (success, warning, danger atau neutral) adalah pembeda yang dapat diandalkan |
| M5 | `recordsDisplay` | View v1.1 membaca `pageInfo.recordsDisplay` | Protokol respons resmi DataTables adalah `recordsFiltered` |
| M6 | Guard `showData()` | BLUEPRINT memakai `isset($this->session->login['id']) ? ... : 0` tanpa `gotoLogin()` | `viewHistory()` memakai `gotoLogin()`. Inkonsisten penanganan otorisasi dalam satu controller |

### 12.4 Inkonsistensi Tanggal, Urutan, dan Nomor Rekening

| Peristiwa | Tanggal |
|---|---|
| Rekonsiliasi supplier 4 (dua berkas) | 2026-04-18 |
| Audit proyek komprehensif | 2026-08-26 |
| Rentang tanggal pada URL uji `penjualan` | 2026-08-20 sampai 2026-09-19 |
| Snapshot `reg_create_at` pada laporan rekonsiliasi | 2026-02-02 |
| `locker_last_dtime` klaster terakhir | 2025-08-20 |

Observasi: nama berkas laporan rekonsiliasi bertanggal 2026-04-18, memakai data registry yang di-create 2026-02-02, sedangkan lock terakhir menyentuh data pada 2025-08-20. Artinya laporan tersebut tertinggal sekitar 1,5 bulan dari snapshot dan belum menangkap lock setelah 2025-08-20, walaupun `fulldate` transaksi sudah mencapai 2025-11-05. **Interpretasi ini tidak dinyatakan di sumber.**

Potensi salah rujuk nomor rekening: `1010020030` (rekening acuan rekonsiliasi supplier 4) versus `1010030030` (RekeningPembantuProduk untuk produk 25137). Lihat Bagian 10.7.

### 12.6 Kredibilitas dan Bukti

| Klaim | Status bukti |
|---|---|
| "Nol risiko downtime" | Klaim arsitektural; tidak ada metrik downtime sebelum-sesudah |
| "Migrasi selesai di `penjualan`" | Hanya `php -l` lolos; tidak ada bukti UAT PASSED |
| "Seluruh 13 skenario UAT PASSED" | Syarat exit, bukan hasil; semua kotak status `[ ]` kosong di dokumen |
| "Target 100/100 master data" | Target, bukan hasil terukur |
| "Rata-rata 6/100" | Konsisten secara aritmetika |
| Total selisih rekonsiliasi | Konsisten dan dapat diverifikasi ulang (Bagian 8.2) |
| Diagnosis serial number 25137 | Didukung bukti database dan konfigurasi; kuat |

### 12.7 Celah Pengujian yang Teridentifikasi

1. **Tidak ada uji beban.** Klaim perbaikan 3-10 detik tidak diukur ulang dengan angka setelah migrasi.
2. **Tidak ada uji beban concurrency.** 70 controller yang berbagi satu engine shared belum diuji untuk kontensi.
3. **Filter `setFilterHook` hanya diuji pada satu kasus** (`employee_freelance` di `penjualan`). Modul lain dengan filter akses berbeda belum terverifikasi.
4. **Uji 0 data hanya pada `pembelian`.** Skenario `UAT-PBL-09` hanya memakai satu kata kunci absence.
5. **Tidak ada uji pada `jenisTr` NULL.** Default `$currentState = "all"` pada view v1.1, sementara BLUEPRINT memakai `$this->uri->segment(4)` sebagai fallback `$jenisTr`; perilaku saat keduanya kosong tidak dispesifikasikan.
6. **Uji konsistensi angka rekonsiliasi tidak ada.** Kedua laporan tidak saling memvalidasi dan tidak ada skrip yang menghasilkan keduanya dari sumber data yang sama.

---

## 13. Lampiran: Daftar File Sumber

| Nama File | Ukuran (byte) | Topik H1 | Peran |
|---|---:|---|---|
| `BLUEPRINT_MIGRASI_HISTORY_SERVERSIDE.md` | 20.619 | BUKU PANDUAN LENGKAP & BLUEPRINT MIGRASI SERVER-SIDE DATATABLES (OPT-IN SWITCH) EVEREST ERP | Sumber utama arsitektur. Memuat kode lengkap, anatomi controller dan view, SOP 3 langkah, inventaris 12 modul, jebakan umum. Dipakai sebagai SSOT untuk agent |
| `RANGKUMAN_PERCAKAPAN_MIGRASI_HISTORY.md` | 9.171 | RANGKUMAN LENGKAP INTI PERCAKAPAN: MIGRASI SERVER-SIDE DATATABLES EVEREST ERP | Narasi kronologi 7 sesi, keputusan teknis, status implementasi, dan antrian modul berikutnya. Sumber utama untuk alasan di balik keputusan |
| `blueprint_layout_akhir_history.md` | 28.249 | BLUEPRINT ARSITEKTUR: STANDARISASI LAYOUT AKHIR HISTORY TRANSAKSI EVEREST | Versi 1.1 (Final dengan Onboarding Banner & Default Mode). Menetapkan 12 pilar, code lengkap controller, view, banner, toolbar, checklist replikasi |
| `UAT_HISTORY.md` | 8.856 | INSTRUMEN UAT: RIWAYAT TRANSAKSI PEMBELIAN (SERVER-SIDE DATATABLES) | Instrumen pengujian Golden Circle 5W+1H, 13 skenario UAT-PBL, 7 zona observasi, 4 kriteria exit. Modul `pembelian` |
| `rekonsiliasi_transaksi_id_supplier_4_20260418_100638.md` | 2.836 | Laporan Rekonsiliasi per transaksi_id | Laporan agregat penuh untuk supplier 4: 775 transaksi, rekening acuan, cabang, gudang, dan Top 20 selisih |
| `rekonsiliasi_transaksi_id_supplier_4_mismatch_only_20260418_101235.md` | 17.637 | Laporan Rekonsiliasi Mismatch per transaksi_id | Laporan detail 97 baris mismatch dengan kolom tambahan `locker_nilai_active`, `locker_nilai_diklaim`, `reg_create_at`, `locker_last_dtime`. Sumber untuk agregasi per jenis pada Bagian 8.4 |
| `masterdata_compliance_score.md` | 3.784 | Hasil Penilaian Kepatuhan (Compliance Score): Controller `MasterData.php` | Matriks 5 aturan GLOBAL_AGENT dengan skor sebelum dan target; rata-rata 6/100 versus target 100/100 |
| `serial_number_issue_25137.md` | 2.845 | Analisis Masalah: Serial Number Produk 25137 Tidak Tampil di LedgerV2 | Diagnosis tiga lapis untuk produk 25137: transaksi draft `1334sc`, komponen serial tidak terdaftar di `heTransaksi_core.php`, skrip `copySerialNumber()` hardcode pada transaksi 846523 |
| `audit_proyek_komprehensif.md` | 15.026 | Laporan Audit Komprehensif - Project Produk Everest ERP | Audit 253 proyek aktif + 27 terhapus di `run_everest_modul`; konteks pembanding methodologi audit, bukan bagian dari migrasi History |

Total sembilan berkas, 118.961 byte.

### 13.1 Referensi Kode, Path, dan Nilai Kunci yang Dikumpulkan

| Kelompok | Isi |
|---|---|
| Engine dan controller | `application/libraries/DatatablesHistory.php` (lokasi kanonik menurut BLUEPRINT_MIGRASI); `application/modules/{modul}/libraries/DatatablesHistory.php` (lokasi alternatif menurut layout v1.1); `application/modules/{modul}/controllers/History.php` (extends `Modul_Controller` -> `MX_Controller`); `application/modules/{modul}/views/history.php`; `application/modules/{modul}/template/history.html` |
| Helper dan konfigurasi | `application/helpers/he_finansial_helper.php` dengan `fin_get_payment_status($id, 1000.0, true)`; `application/helpers/he_misc_helper.php` dengan `viewDetailTransaksi()` dan tag `tableHistoryShow`; `application/config/heTransaksi_core.php` line 29906 (komponen ledger `jenis = 1334`); `application/controllers/ToolsGenerator.php` line 6243 (`copySerialNumber()` hardcode `transaksi_id = '846523'`) |
| Tabel transaksi, produk, ledger, dan proyek | `transaksi` (`id`, `nomer`, `dtime`, `jenis`, `id_top`, `seller_id`, `ids_his`); `transaksi_payment_source` (kalkulasi status pembayaran); `transaksi_data_registry` (rincian item step 9, kolom `dataDoc`); `produk.jml_serial`; `produk_per_serialnumber` (15 serial untuk produk 25137); `_rek_pembantu_produk_perserial_cache` (kosong untuk 25137); `_rek_pembantu_produk_cache`; database `run_everest_modul`; `project_produk` (`harga`, `closing_status`, `trash`, `status`, `cabang_id`, `quot_nomer`, `project_start_nomer`, `uang_muka_request`) |
| Fungsi, konstanta, kunci | `blobDecode()`; `fnExcelReport($tableHtmlId)`; `gotoLogin()`; `MODUL_PATH` dan `MODUL_TEMPLATE_PATH`; `pref_history_serverside_{UID}` (TTL 1 tahun); `history_new_mode_notice_dismissed` dan `pref_history_mode` di `localStorage`; mapping `$safeDbSortCols`; naming Redis `locker_status_[MdlName]_[ID]`; validasi sintaks `C:\xampp\php\php.exe -l <file>` |
