# Infrastruktur Database, Backup, dan Performa - Sintesis Lintas Dokumen (san)

Dokumen sintesis ini menghimpun 20 dokumen sumber terkait infrastruktur database MariaDB, strategi backup dan pemulihan, optimasi performa endpoint, migrasi JSON Data Registry antar modul, arsitektur controller (modul, non-modul, dan CLI), serta analisis akses data dan gap menuju pola otorisasi SAP-style. Seluruh isi digabungkan, dielaborasi, dan disertai penandaan kontradiksi antar dokumen serta penetapan versi mutakhir.

---

## 1. Ringkasan Eksekutif

Pola arsitektur yang muncul konsisten dari seluruh dokumen adalah sebuah ERP PHP yang berevolusi dalam beberapa generasi dan berjalan di atas MariaDB. Ada dua basis kode yang hidup berdampingan:

1. **Generasi lama (CI3 / HMVC)**: `application/modules/<modul>/` dengan `MX_Controller`, `application/controllers/`, dan target runtime **PHP 5.6 + CodeIgniter 3**, seperti pada environment `san_staging`.
2. **Generasi baru (CI4-style)**: `app/Controllers/`, `app/Views/`, namespace `App\Models\`, fungsi `show_404()`, `$this->template->view()`, seperti pada aplikasi CRM di host `charly.mayagrahakencana.com`.

Pada lapisan database, strategi yang tercatat berkembang dalam tiga tahap dan **versi mutakhir adalah tahap ketiga**:

- **Tahap 1 (deprecated)**: `rsync` langsung ke `/var/lib/mysql` - dinyatakan tidak aman.
- **Tahap 2**: `mariabackup` online di source lalu `prepare`, ditarik mirror dengan `rsync`/SSH, lalu restore lokal (source online, mirror downtime).
- **Tahap 3 (mutakhir, adopted)**: **replikasi MariaDB 10.3 primary-replica** (primary `192.168.61.1`, replica `192.168.5.17`) plus **backup GFS langsung dari replica ke Windows Storage Vault** dengan proteksi *Zero-Write* (matikan SQL Thread + `read_only=ON` selama streaming). Backup harian penuh tidak lagi disimpan di source.

Pada lapisan performa, ada dua agenda yang berjalan: (a) generik reusable untuk seluruh modul `san_staging` berbasis runbook enam tahap dengan baseline 5 run, dan (b) studi kasus `Katalog/viewProduk` yang sudah menghasilkan angka terukur: **4814,68 ms -> 3182,42 ms (-33,90%)** dengan peak memory 579 MB -> 476 MB (-17,79%).

Pada lapisan skema, terdapat **dua arah migrasi yang saling bertentangan** dan harus diputuskan sebelum eksekusi lanjutan: migrasi *format* (blob -> JSON di tabel global `transaksi_data_json`) versus migrasi *fisik per modul* (tabel `pembelian_*` dengan kolom relasional). Status terukur: 4 dari 22 modul selesai UAT pada jalur JSON.

Pada lapisan keamanan, metode akses saat ini bersifat hybrid dan tersebar; target SAP-style (`Authorization Object + Action + Context`) masih pada tahap rancangan transisi bertahap 5 fase.

---

## 2. Topologi dan Environment

### 2.1 Host dan Peran

| Peran | Host / Path | Detail Kunci |
|---|---|---|
| Database Primary (source) | `192.168.61.1` | MariaDB 10.3, `server_id=61`, `log_bin=mysql-bin`, `binlog_format=ROW`, `sync_binlog=1`, `innodb_flush_log_at_trx_commit=1` |
| Database Replica (mirror) | `192.168.5.17` | MariaDB 10.3, `server_id=17`, `relay_log=relay-bin`, `read_only=ON`, `skip_slave_start=ON` |
| Replica untuk backup | "Server Database Replica (Slave)" | Target script `backup_mariabackup_gfs_direct.sh` (path dev: `z:/san_29agus/`) |
| Windows Storage Vault | Mount CIFS ke Linux | Diakses `ls "$MOUNT_POINT"`; opsi remount `cache=loose,wsize=1048576` |
| Log server (audit traffic) | `192.168.5.10` | Tabel `log`, dipakai untuk verifikasi "0 errors" |
| App CRM (generasi baru) | `charly.mayagrahakencana.com` | Halaman `items/index/items`, `app/Controllers/Items.php` di `w:/san_ibb_2jul` |
| Staging ERP (generasi lama) | `https://demo.mayagrahakencana.com/san_staging` | Base URL untuk uji endpoint terautentikasi |
| Sandbox replikasi | `z:/san_9agus_json` | Sumber acuan status migrasi JSON |
| Sandbox CLI penjualan | `z:/san_sarana_7jul` | Sumber acuan `Cli.php` |
| Sandbox controller non-modul | `z:/san_ibb_2jul` | Sumber acuan action bar non-reload |
| Sandbox database holding | `san_30mar` | Target migrasi arsitektur *modular monolith* |
| Database pivot sales | `san_13mar` | Sumber tabel `z_sales_salesman_cache`, `z_sales_pembantu_cache` |
| Database subsidiary (referensi pola) | `san_tsa_28agu`, `san_sarana_30jun` | Sumber pola tabel berawalan modul |

### 2.2 Stack Aplikasi

| Komponen | Generasi Lama (san_staging) | Generasi Baru (app CRM) |
|---|---|---|
| PHP | 5.6 (dijaga kompatibel) | Tidak dinyatakan; ada indikasi PHP 7+ (operator `??`) |
| Framework | CodeIgniter 3 (HMVC, `MX_Controller`) | CodeIgniter 4-style (`app/Controllers`, `app/Views`) |
| Struktur view | `application/modules/*/views/` | `app/Views/<modul>/` |
| Model | `Mdls/`, `Mdl<Domain>Transaksi.php` | `App\Models\<Name>_model` |
| CLI | `php index.php penjualan/cli/...` | Tidak ada |
| MariaDB | 10.3 (replikasi), "MariaDB 10" (dokumen otorisasi) | Sama |

### 2.3 Registry Modul san_staging (58 direktori)

`addons`, `adjustment`, `adjustmentjurnal`, `akunting`, `akunting_`, `api`, `asetmanagement`, `banking`, `biaya`, `dashboard`, `deviden`, `distribusifg`, `distribusijasa`, `distribusiproduksi`, `distribusisupplies`, `kas`, `kasOLD`, `konversi`, `konversi_varian`, `laporan`, `laporankeuangan`, `laporankeuangan_ori_sebelum_suport_neraca_adjustment`, `laporankeuangan_sebelum_adj_20240118`, `openbalance`, `opname`, `opname_ori`, `opname_v0`, `pembatalan`, `pembayaran`, `pembelian`, `pembelian_05mei2026`, `pembelian_26apr2026`, `pembelian_28apr2026`, `pembelianimport`, `pembelianimport_26apr2026`, `pembelianjasa`, `pembelianprojek`, `pembelianprojek__`, `penerimaan`, `penerimaanOLD`, `penerimaanprojek`, `penjualan`, `penjualanproject`, `pettycast`, `pindahgudang`, `pindahgudang_`, `pindahgudang_29apr2026`, `produksi`, `produksi_sebelum_geser_bom`, `produksiproses`, `requeststok`, `saham`, `statik`, `taxes`, `taxes_24apr2026`, `tools`, `valas`, `webservice`.

**Temuan:** pola nama direktori menunjukkan **backup in-place** (`pembelian_05mei2026`, `taxes_24apr2026`, `opname_ori`, `kasOLD`) dan ada sufiks ganda (`pembelianprojek__`, `pindahgudang_`, `akunting_`) yang merupakan artefak proses, bukan desain. Ini membawa risiko pemeliharaan dan sebaiknya dikonsolidasikan.

---

## 3. Replikasi MariaDB dan Mirror Tanpa Downtime

### 3.1 Alur A - Hot Backup Mirror (metode tahap 2, sudah disuperseded)

Dua skrip: `scripts/mariadb/source_mariabackup.sh` dan `scripts/mariadb/mirror_restore_latest.sh`. Alur: source `mariabackup --backup` saat database online -> `prepare` di source sampai konsisten -> mirror menarik folder yang sudah `prepare` -> mirror restore lokal.

Prasyarat: paket `mariadb-backup`/`mariabackup` di kedua host, `rsync`/`ssh`/`systemctl` tersedia, mirror bisa SSH ke source tanpa password (SSH key), skrip dijalankan sebagai `root`.

```sql
CREATE USER 'backup'@'127.0.0.1' IDENTIFIED BY 'ganti_password_kuat';
GRANT RELOAD, PROCESS, LOCK TABLES, REPLICATION CLIENT ON *.* TO 'backup'@'127.0.0.1';
FLUSH PRIVILEGES;
```

Credential `/etc/my.cnf.d/mariabackup.cnf` berisi `[client]` dengan `user=backup` dan `password=ganti_password_kuat`. Deploy skrip dan pengetatan permission:

```bash
chown root:root /etc/my.cnf.d/mariabackup.cnf
chmod 600 /etc/my.cnf.d/mariabackup.cnf
install -m 750 scripts/mariadb/source_mariabackup.sh /usr/local/sbin/source_mariabackup.sh
install -m 750 scripts/mariadb/mirror_restore_latest.sh /usr/local/sbin/mirror_restore_latest.sh
```

```cron
0 1 * * * /usr/local/sbin/source_mariabackup.sh >> /var/log/source_mariabackup.cron.log 2>&1
40 1 * * * SOURCE_HOST=192.168.61.1 SOURCE_SSH_USER=root /usr/local/sbin/mirror_restore_latest.sh >> /var/log/mirror_restore_mariadb.cron.log 2>&1
```

Jeda 40 menit (01:00 -> 01:40) adalah SLA internal agar backup source selesai sebelum mirror menarik. Eksekusi manual contoh: `SOURCE_HOST=192.168.61.1 SOURCE_SSH_USER=root /usr/local/sbin/mirror_restore_latest.sh`. Output yang diverifikasi: `ls -lah /backup/mariadb/latest`, `systemctl status mariadb --no-pager`, `mysql -e "SHOW DATABASES;"`.

Larangan eksplisit: jangan `rsync` datadir live (`/var/lib/mysql`) saat MariaDB berjalan; `FLUSH TABLES WITH READ LOCK` tidak cukup untuk copy file-level InnoDB yang aman.

### 3.2 Alur B - Replikasi Primary-Replica (versi mutakhir untuk sinkronisasi)

Skenario: source online, mirror ikut update otomatis, tidak ada full backup harian di source. Prinsip: **replication bukan pengganti backup** - ia melindungi dari kegagalan server, bukan dari salah hapus data.

Konfigurasi primary `my.cnf`/`server.cnf`: `[mysqld]` dengan `server_id=61`, `log_bin=mysql-bin`, `binlog_format=ROW`, `expire_logs_days=7`, `sync_binlog=1`, `innodb_flush_log_at_trx_commit=1`. Konfigurasi replica: `[mysqld]` dengan `server_id=17`, `relay_log=relay-bin`, `read_only=ON`, `skip_slave_start=ON`. Restart dengan `systemctl restart mariadb` di masing-masing server.

Skrip otomatis: `scripts/mariadb/primary_prepare_replication.sh` (deploy ke `/usr/local/sbin/primary_prepare_replication.sh`) dan `scripts/mariadb/bootstrap_replica_from_primary.sh` (deploy ke `/usr/local/sbin/bootstrap_replica_from_primary.sh`).

```bash
# Di primary (192.168.61.1)
REPL_PASSWORD='GantiPasswordKuat!' REPL_ALLOWED_HOST='192.168.5.%' \
MYSQL_PRIMARY_DEFAULTS_FILE='/root/.my.cnf' /usr/local/sbin/primary_prepare_replication.sh

# Di replica (192.168.5.17)
PRIMARY_HOST='192.168.61.1' PRIMARY_SSH_USER='root' \
PRIMARY_BACKUP_DEFAULTS_FILE='/etc/my.cnf.d/mariabackup.cnf' \
REPL_USER='repl' REPL_PASSWORD='GantiPasswordKuat!' \
MYSQL_LOCAL_DEFAULTS_FILE='/root/.my.cnf' /usr/local/sbin/bootstrap_replica_from_primary.sh
```

Jalur manual (fallback). Pembuatan user replikasi: `CREATE USER 'repl'@'192.168.5.%' IDENTIFIED BY 'GantiPasswordKuat!';` dengan `GRANT REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'repl'@'192.168.5.%';` lalu `FLUSH PRIVILEGES;`.

Seed awal via stream dari primary: `mariabackup --backup --stream=xbstream --defaults-extra-file=/etc/my.cnf.d/mariabackup.cnf | ssh root@192.168.5.17 "cat > /var/tmp/seed.xbstream"`.

Restore di replica: `systemctl stop mariadb`; `rm -rf /var/lib/mysql/*`; `mkdir -p /var/tmp/seed`; `cd /var/tmp/seed`; `mbstream -x < /var/tmp/seed.xbstream`; `mariabackup --prepare --target-dir=/var/tmp/seed`; `mariabackup --copy-back --target-dir=/var/tmp/seed --datadir=/var/lib/mysql`; `chown -R mysql:mysql /var/lib/mysql`; `systemctl start mariadb`; `cat /var/tmp/seed/xtrabackup_binlog_info`.

Penyambungan: `STOP SLAVE;` lalu `RESET SLAVE ALL;` lalu `CHANGE MASTER TO MASTER_HOST='192.168.61.1', MASTER_PORT=3306, MASTER_USER='repl', MASTER_PASSWORD='GantiPasswordKuat!', MASTER_LOG_FILE='mysql-bin.000123', MASTER_LOG_POS=456789;` lalu `START SLAVE;`.

**Peringatan operasional:** perintah `rm -rf /var/lib/mysql/*` bersifat destruktif total. Wajib digate dengan konfirmasi path, stop service, dan pencatatan offset binlog sebelum eksekusi.

Verifikasi rutin harian memakai `SHOW SLAVE STATUS\G` dan memantau lima metrik: `Slave_IO_Running: Yes`, `Slave_SQL_Running: Yes`, `Seconds_Behind_Master` kecil/mendekati `0`, `Last_IO_Error`, dan `Last_SQL_Error`.

SLA dan kontrol operasional produksi: (1) NTP/time sync aktif di kedua server karena replikasi sensitif terhadap skew waktu; (2) firewall port `3306` hanya dibuka antar host yang perlu (primary <-> `192.168.5.%`); (3) retensi binlog di primary (`expire_logs_days`) harus >= SLA recovery replica; (4) jika replica dipakai untuk baca aplikasi, `read_only=ON` tetap dipertahankan; (5) backup periodik terpisah (misalnya mingguan) tetap disiapkan.

---

## 4. Backup dan Pemulihan - GFS Langsung ke Windows Vault

### 4.1 Root Cause Insiden (dokumen berstatus "Production Ready", 31 Agustus 2026)

Gejala: pencadangan incremental maupun full pada replica gagal mendadak.

```text
ERROR: Script gagal di baris 173 (Perintah: zstd) dengan exit code 134
ERROR: Incremental Pipeline Gagal!
```

Analisis berlapis:

1. **Exit code 134** berasal dari sinyal `SIGABRT` (Signal 6) yang memicu *core dump*.
2. **Pelaku sebenarnya adalah `mariabackup`, bukan `zstd`.** Trap bash melaporkan `zstd` karena berada di ujung pipeline dan dipanggil dengan flag `pipefail`.
3. Log detail `/tmp/mariabackup_local_*.log`:

```text
[01] Streaming ./run_sumber_boga_modul/transaksi_realtimepos.ibd
InnoDB: Retry attempts for reading partial data failed.
InnoDB: Tried to read 10485760 bytes at offset 4582277120, but was only able to read 0
InnoDB: Operating system error number 61 in a file operation (ENODATA: No data available)
mariabackup(_Z15xb_fil_cur_readP12xb_fil_cur_tR14CorruptedPages+0x383)
```

4. **Akar masalah:** tabel `run_sumber_boga_modul.transaksi_realtimepos` berukuran **7,0 GB** menerima aliran transaksi tinggi *real-time* dari master. Saat `mariabackup` membaca blok pada offset **4.582.277.120 byte (4,58 GB)**, SQL Thread replica (`Slave_SQL_Running`) terus menulis halaman sehingga *file size descriptor* dan posisi EOF bergeser (*race condition* / *torn read*). `mariabackup` melakukan abort demi mencegah arsip backup rusak.

Angka kunci untuk audit: 7,0 GB ukuran tabel, 4,58 GB offset konflik, 10.485.760 byte (10 MiB) ukuran blok percobaan baca, errno 61 (`ENODATA`), fungsi `xb_fil_cur_read`.

### 4.2 Arsitektur Solusi - Zero-Write Replica Protection

Referensi: MariaDB Knowledge Base dan Percona XtraBackup official best practice. Urutan:

1. `STOP SLAVE SQL_THREAD;` + `SET GLOBAL read_only = ON;` + `FLUSH TABLES;`
   - **I/O Thread tetap aktif** sehingga binlog tetap terunduh; seluruh file `.ibd` menjadi 100% statis dan konsisten.
2. `mariabackup --slave-info --lock-ddl-per-table | zstd -3` langsung ke Windows Vault (bebas bit-rot dan race condition).
3. `SET GLOBAL read_only = OFF;` + `START SLAVE SQL_THREAD;` - replikasi aktif normal dan mengejar relay log lokal.
4. Verifikasi SHA256 dan retensi GFS.

Perbedaan penting dari metode hot-backup mirror: **backup tidak lagi menyalin file-level/InnoDB saat SQL thread hidup**, dan tidak lagi butuh full backup harian di source.

### 4.3 Perbaikan Kode pada `backup_mariabackup_gfs_direct.sh`

**A. Fail-safe kernel multi-sinyal.** Fungsi `cleanup()` menjalankan `SET GLOBAL read_only = OFF;` dan `START SLAVE SQL_THREAD;` lewat `mysql --user="$DB_USER" --password="$DB_PASS" -e "..."` dengan `2>/dev/null || true`, lalu memindahkan log ke `$LOCAL_LOG_DIR/mariabackup_${DATE}_$$.log` bila `$BACKUP_LOG` ada. Diaktivkan dengan `trap cleanup EXIT INT TERM HUP`, menjamin server kembali normal pada kondisi sukses, gagal di tengah, error syntax, `Ctrl+C` (sinyal `INT`), `TERM`, maupun `HUP`.

**B. Flag khusus replikasi.** `--slave-info` menyimpan koordinat binlog master (`xtrabackup_slave_info`) untuk disaster recovery dan pembuatan replica baru; `--safe-slave-backup` mengamankan kuncian metadata saat snapshot checkpoint; `--lock-ddl-per-table` mengunci metadata tabel selama pembacaan `.ibd`.

**C. Isolasi status pipeline dan sanitasi Telegram.** `trap - ERR` di sekitar pipeline, lalu evaluasi terpisah `${PIPESTATUS[0]}` (mariabackup) vs `${PIPESTATUS[1]}` (zstd). Sanitasi log error memakai `sed 's/</\&lt;/g; s/>/\&gt;/g'` untuk mencegah HTTP 400 di Telegram API.

**D. CIFS Vault health check.** Fungsi `ensure_vault_mounted` melakukan uji I/O ringan `ls "$MOUNT_POINT"` sebelum backup; bila terdeteksi *stale handle* akibat gangguan jaringan Windows, skrip melakukan *lazy remount* dengan parameter performa `cache=loose,wsize=1048576`.

### 4.4 Operasional GFS

Inisialisasi ulang rantai (full backup paksa) melalui `/path/to/backup_mariabackup_gfs_direct.sh --force-full`. Jadwal otomatis harian dideteksi skrip sendiri: **Minggu** menjalankan Full Backup Mingguan, **Senin - Sabtu** menjalankan Incremental Backup Harian berbasis LSN terakhir di `/var/lib/mariabackup_metadata/latest_lsn.txt`.

Pembersihan binlog yatim: jika ditemukan berkas log lama yang tidak terdaftar di `SHOW BINARY LOGS;` dan prefix aktif sudah dikonfirmasi via `SHOW VARIABLES LIKE 'log_bin%';`, jalankan `rm -f /var/lib/mysql/mariadb-bin.*`. Retensi otomatis diset di runtime dengan `SET GLOBAL expire_logs_days = 3;` dan di `[mysqld] expire_logs_days = 3`.

### 4.5 Matriks RTO/RPO yang Turun dari Dokumen

| Parameter | Nilai | Sumber |
|---|---|---|
| Backup harian | 1 full (Minggu) + 6 incremental (Senin-Sabtu) | Dokumen GFS |
| Basis incremental | LSN chain | Dokumen GFS |
| Lokasi arsip | Windows Storage Vault via CIFS | Dokumen GFS |
| Kompresi | `zstd -3` | Dokumen GFS |
| RPO teoretis | 1 hari (jika cron harian) | Cron mirror tahap 2 |
| RTO mirror | restart MariaDB saat restore | Dokumen mirror tahap 2 |
| RTO regenerasi replica | durasi `mariabackup --backup --stream` + `prepare` + `copy-back` | Dokumen replikasi |
| Basis point recovery | `mysql-bin.000123` offset `456789` dari `xtrabackup_binlog_info` | Dokumen replikasi |
| Retensi binlog | 7 hari (`my.cnf` primary) vs 3 hari (runtime CLI) - konflik | Kedua dokumen |

---

## 5. Optimasi Performa: Katalog, DataTable Server-Side, Action Bar Non-Reload

### 5.1 Runbook Generik Reusable (san_staging)

**Tujuan:** prosedur standar lintas modul, aman untuk PHP 5.6 + CI3, menghasilkan bukti before/after terukur.

**Guardrails:** jangan ubah `MdlTransaksi` dan `MdlMother` tanpa persetujuan; jangan ubah method request (`GET` tetap `GET`, `POST` tetap `POST`); backward compatible terhadap URL, parameter, dan alur UI existing; verifikasi berbasis data real pada endpoint yang sama.

**Input wajib:** nama modul target, endpoint target lengkap (URL), cookie login aktif (`ci_session`) untuk uji terautentikasi, waktu endpoint dari browser/devtools, contoh transaksi/ref untuk regresi.

**Enam tahap eksekusi:**

- **Tahap A - Baseline**: catat waktu endpoint sebelum revisi, minimal 5 run; pecah bottleneck ke query-level; simpan angka before.
- **Tahap B - Isolasi Akar Masalah**: tracing fungsi controller/model/helper; identifikasi query berat (`EXPLAIN`, scan rows, filesort, temporary); identifikasi loop CPU-heavy (decode/unserialize/calc berulang).
- **Tahap C - Revisi Minimal**: ubah titik bottleneck paling impact; pertahankan output contract lama; hindari refactor luas.
- **Tahap D - Verifikasi Teknis**: `php -l` untuk file yang diubah; uji kesetaraan output before/sesudah; uji endpoint terautentikasi 5x catat avg/min/max.
- **Tahap E - Verifikasi Fungsional**: smoke test alur utama modul (view, edit, reject, followup, varian sesuai modul); catat pass/fail per skenario.
- **Tahap F - Penutupan**: ringkas before/after, tandai pending QA manual, simpan evidence.

**Perintah verifikasi terautentikasi:**

```powershell
powershell -ExecutionPolicy Bypass -File .\docs\verify_followup_authenticated.ps1 `
  -Cookie "ci_session=ISI_DARI_BROWSER" `
  -Runs 5 `
  -BaseUrl "https://demo.mayagrahakencana.com/san_staging" `
  -PrePreviewPath "/{modul}/FollowUp/{endpoint_prepreview}" `
  -PreviewPath "/{modul}/FollowUp/{endpoint_preview}" `
  -IncludePreview
```

**Kriteria lulus (SLA):** uji terautentikasi 5 run lulus dengan `redir=0` (bukan login redirect). Status akhir salah satu dari: `Closed`, `Closed with manual QA pending`, `Pending`.

**Batasan:** tidak semua modul memakai pattern `FollowUp`; endpoint yang butuh action stateful (bukan GET read-only) harus divalidasi di sandbox data/staging yang aman.

**Template isi otomatis (11 seksi):** Metadata Eksekusi (tanggal, PIC, environment `san_staging`, PHP `5.6`, CI3, modul, endpoint utama, endpoint pembanding, metode HTTP `GET`, baseline detik, target detik) -> Guardrail Wajib -> Scope Investigasi -> Baseline Measurement (tabel Run/Endpoint/HTTP Code/TTFB/Total/Catatan, lalu rata-rata, P95, worst) -> Checklist Root Cause -> Rencana Revisi (Quick Wins / Structural Fix / Safety & Compatibility) -> Log Revisi -> Verifikasi Teknis -> Verifikasi End-to-End -> Hasil Akhir -> Approval. Pola file turunan: `docs/runbook_perf_pembelian_followup_YYYYMMDD.md`.

### 5.2 Studi Kasus `Katalog/viewProduk` - Rencana dan Angka Terukur

**Metadata:** dokumen `KATALOG_PERFORMANCE_PLAN.md` dibuat 2026-05-28, endpoint fokus `Katalog/viewProduk` mode `KatalogGudang`, tujuannya semua data tetap tampil lengkap tetapi load lebih ringan.

**Prinsip wajib:** (1) informasi produk tetap lengkap per cabang dan per gudang; (2) tidak menambah jumlah klik user; (3) aturan bisnis wajib sama - tampil jika saldo > 0, jika saldo = 0 tampil hanya bila ada mutasi tahun berjalan; (4) setiap perubahan wajib punya bukti ukur sebelum dan sesudah.

**Metode 1 - Quick Win (target 1 hari kerja, risiko rendah):** QW-01 baseline profiling per blok (query produk, harga, stok, hold, images, fifo, pairing, render) 1-2 jam `IN_PROGRESS`; QW-02 aktifkan filter bisnis final tanpa mengubah kolom 1-2 jam `TODO`; QW-03 batasi query turunan ke kandidat produk hasil QW-02 2-3 jam `TODO`; QW-04 bersihkan beban non-esensial (matikan debug, rapikan filter duplikat) 1 jam `TODO`; QW-05 verifikasi parity data 1 jam `TODO`; QW-06 uji performa 3 skenario (`q` kosong, `q` terisi, filter kategori) dengan p50/p95 1 jam `TODO`.

**Metode 2 - Sistemik (target 1-2 sprint):** SYS-01 pisahkan service katalog agar controller tipis dan terukur 1-2 hari; SYS-02 read model stok teragregasi per `cabang-gudang-produk` (active/hold/total) 2-3 hari; SYS-03 pipeline refresh terjadwal (cron/incremental + fallback rebuild) 1-2 hari; SYS-04 query kontrak tunggal untuk produk + harga + stok + hold + image pointer 1-2 hari; SYS-05 hardening indeks DB (index komposit sesuai filter/join aktual) 1 hari; SYS-06 guardrail observability (durasi, row count, memory + threshold alert) 1 hari; SYS-07 rollout bertahap dengan feature flag `katalog_v2` dan A/B internal 1 hari. Seluruh SYS berstatus `TODO` dengan rantai dependency SYS-01 -> SYS-02 -> SYS-03/SYS-04 -> SYS-05/SYS-06 -> SYS-07.

**SLA:** Quick Win menuntut p95 turun minimal **30%**, jumlah row hasil akhir tidak melanggar rule bisnis, dan tidak ada perubahan struktur data yang diterima view. Sistemik menuntut p95 turun minimal **60%** dari baseline awal, render browser stabil untuk dataset besar, hasil konsisten dengan rule bisnis, serta aman melalui feature flag dan rollback plan. Trace Board adalah sumber kebenaran progres dengan status `TODO`, `IN_PROGRESS`, `BLOCKED`, `DONE`. Log harian 2026-05-28: hook profiling siap dengan parameter `profile_katalog=1`, log JSON `KATALOG_PROFILE` aktif, belum ada sampel metrik runtime dari environment user.

### 5.3 Angka Baseline vs Sesudah (Endpoint `/Katalog/viewProduk?profile_katalog=1`)

Metrik (`total_ms` 4814,68 -> 3182,42, delta **-1632,26 ms (-33,90%)**; `peak_memory_mb` 579 -> 476, delta **-103 MB (-17,79%)**; `counts.produk` 1390 -> 1390; `counts.harga_total` 73920 -> 49018, -24902 (-33,68%); `counts.stok_active` 13028 -> 12649, -379 (-2,91%); `counts.stok_hold` 34 -> 34; `counts.images` 955 -> 921, -34 (-3,56%); `counts.cabang` 13 -> 13; `counts.dataParents` 1390 -> 1292, -98 (-7,05%); `counts.dataChildCabang` 13 -> 13).

Blok (ms, urut eksekusi): `request_parsed` 5,70; `query_default_gudang_and_cabang` 7,16; `query_mutasi_tahunan` 438,22; `map_cabang_gudang` 44,30; `query_produk_dan_harga_produk` 1756,82; `query_harga_lanjutan_dan_stok` 725,10; `query_images_dan_cabang` 150,63; `map_specs` 59,22; `map_hargas` 366,50; `map_stok_dan_hold` 232,18; `map_images` 2,21; `map_cabang_master` 0,05; `query_dan_map_fifo` 59,34; `pairing_final_matrix` 949,45; `payload_ready` 17,79. Jumlah = 4814,67 ms (cocok `total_ms`).

Step timing sesudah (hanya 5 blok yang dirinci): `query_mutasi_tahunan` 455,13; `query_produk_dan_harga_produk` 1141,08; `query_harga_lanjutan_dan_stok` 490,54; `map_hargas` 203,20; `pairing_final_matrix` 423,03; `total_ms` 3182,42.

Delta per blok yang dirinci: `query_produk_dan_harga_produk` **-615,74 (-35,05%)**; `pairing_final_matrix` **-526,42 (-55,44%)**; `map_hargas` -163,30; `query_harga_lanjutan_dan_stok` -234,56; `query_mutasi_tahunan` **+16,91 (regresi)**.

Perbandingan terhadap Tahap-2 (baseline kedua): `total_ms` 4177,56 -> 3182,42 (-995,14); `query_produk_dan_harga_produk` 1817,56 -> 1141,08 (-676,48); `map_hargas` 348,94 -> 203,20 (-145,74).

**Analisis tambahan (temuan baru):**

1. Baseline 4177,56 ms (Tahap-2) lebih cepat dari baseline 4814,68 ms (Tahap-1). Artinya pengukuran "before" tidak dilakukan pada kondisi mesin yang sama; perbandingan antar-checklist tidak boleh dicampur.
2. Sembilan blok yang tidak dirinci pada tabel "sesudah" (`request_parsed`, `query_default_gudang_and_cabang`, `map_cabang_gudang`, `query_images_dan_cabang`, `map_specs`, `map_images`, `map_cabang_master`, `query_dan_map_fifo`, `payload_ready`) berjumlah **346,40 ms** pada baseline. Agar konsisten dengan `total_ms` 3182,42, sisa blok sesudah harus **469,44 ms**, berarti **naik +123,04 ms (+35,5%)**. Ini regresi agregat yang tidak tercatat di dokumen.
3. `peak_memory_mb` turun 17,79%, di bawah target minimal 20% pada checklist, namun keputusan tetap **GO**. Target memori belum terpenuhi.
4. `dataParents` turun 98 item (1390 -> 1292) tetapi `counts.produk` tetap 1390 - filter diterapkan pada tahap pairing, bukan pada query master. Efeknya harus divalidasi terhadap rule saldo/mutasi.
5. Penurunan `images` hanya 34 item (955 -> 921) padahal 98 produk dikeluarkan dari `dataParents`; proporsinya tidak konsisten. `stok_active` turun 379 dari 13028. Kedua penurunan perlu rekonsiliasi sebelum GO dicatat final.
6. Checklist memuat seluruh poin "[ ]" belum tercentang (contract data, rule bisnis, 20 sampel produk, uji UI/fungsional) dan bagian "Alasan keputusan" masih kosong. Status GO decisions [x] tanpa bukti checkbox lain adalah temuan governance.

### 5.4 Pemetaan Server-Side `Katalog/viewProduk` (Acuan untuk Migrasi DataTable)

Model, tabel, dan peran query (urutan eksekusi):

1. `MdlGudangDefault_center` - default gudang pusat; `MdlGudangDefault` - default gudang cabang; `MdlCabang` - `allCabang` dan header cabang tabel; `MdlGudang` - `allGudangMember`, `gudangDefaultCabang`.
2. `ComRekeningPembantuProduk` -> `_rek_pembantu_produk_cache`; `fetchBalancePeriodeAllProduct("1010030030")` dengan `periode='tahunan'`, `thn=YEAR(now)`; sumber `extern_id` untuk produk dengan mutasi tahun berjalan.
3. `MdlProduk2` - `lookupByKeyword($q)` plus filter kategori `kat`; master produk basis.
4. `MdlHargaProduk` (`price`, `trash='0'`, `jenis='produk'`, `status='1'`), `MdlHargaProdukRakitan` (`price`, `jenis='item_rakitan'`), `MdlHargaProdukKomposit` (`price`, `jenis='produkKomposit'`) - harga gabungan memakai jenis value `hpp`, `jual`, `jual_nppn` dengan scope `produk_id IN (hasil produk keyword/kategori)`.
5. `MdlLockerStock` instance `st` -> `stock_locker` (`jenis='produk'`, `jenis_locker='stock'`, `state='active'`, `gudang_id IN allGudangDefault`) = stok aktif; instance `sthold` (`state='hold'`, `jumlah>0`) = stok hold/in-transit.
6. `MdlImages` -> `images` (`status='1'`, `trash='0'`, `jenis='produk'`, `parent_id IN (...)`).
7. `MdlFifoProdukJadi` -> `rek_cache_persediaan_produk_fifo`, hanya aktif jika `cabangID == CB_ID_PUSAT`.
8. `MdlDataTmp` - banner moderasi (`propose_jml`, `propose_datas`).

Rule bisnis wajib dipertahankan:

1. Produk tampil jika `saldo aktif > 0` (global), ATAU `saldo = 0` tetapi punya mutasi tahun berjalan.
2. Harga cabang: `hpp`, `jual`, `jual_nppn`; pembatasan tampilan harga jual sesuai hak cabang/user tetap sama.
3. FIFO hanya untuk mode pusat (`CB_ID_PUSAT`), per produk-cabang-gudang.
4. Hold/in-transit: jika `hold > 0`, tampil informasi in-transit.

Struktur data turunan yang dipakai view:

- `dataParents` (`$pairedResult`): key `produk_id`; metadata produk + `dimensi_m` + `images`.
- `dataChilds` (`$pairedDatas`): `[cabang_id][gudang_id][produk_id]`; field minimum `hpp`, `jual`, `jualnppn`, `in transit`, `stok avail`, `stok total`.
- `sumStokCabang` (`$sumSpecData`): `[cabang_id][produk_id]`.
- `cabang` (`$allCabang`): `[cabang_id] => nama`; `gudangData` (`$gudangDefaultCabang`): `[cabang_id][gudang_id] => {id, name, nama}` untuk header multi-level.

Parameter request: `q` (keyword), `kat` (kategori), `o` (konteks cabang/gudang user), `profile_katalog`, `profile_render`, `nocache`.

Komponen UI yang bergantung pada data ini: tabel mode `KatalogGudang` (layout `a`) dengan kolom statis produk plus kolom dinamis cabang/gudang; tombol history `Data/viewHistories/{ctrl}/{id}`; tombol in-transit `Katalog/modalInfoIntransit?id={produk_id}`; tombol Excel `ExcelWriter/katalogproduk/{blob}`; banner moderasi.

Parity checklist wajib saat build server-side (9 item): rule tampil saldo/mutasi identik; `recordsTotal` dan `recordsFiltered` konsisten; nilai harga/stok/hold/fifo per sampel produk sama; header cabang-gudang tidak berubah struktur; search global tetap berfungsi di seluruh data; sorting kolom utama konsisten; pagination stabil pada data besar; history modal, in-transit modal, dan download tetap jalan; banner moderasi tetap muncul benar.

Risiko migrasi: mismatch mapping nested `[cabang][gudang][produk]`; beda hasil search/sort jika logika dipindah ke SQL tanpa parity test; timeout jika endpoint server-side belum membatasi query per halaman.

### 5.5 Action Bar Tanpa Reload (`estimates`)

Kondisi awal: tombol **Tindakan** dirender PHP di `app/Views/estimates/view.php` **baris 187-461** dengan 11 variabel server; logikanya kompleks dan bergantung DB sehingga harus di-generate server-side tiap perubahan.

Variabel dan pengaruhnya: `$has_items` (`$jml_item > 0`, dari count items DB) mempengaruhi Mark as Won dan Send to Client; `$is_draft_or_sent` (`estimate_info->status`) hampir semua tombol; `$is_estimate_editable` (`_is_estimate_editable()`) Edit, Clone, Won, Declined; `$has_unresolved_custom_items` (`get_unresolved_count()`) Mark as Won; `$is_admin` (`login_user->is_admin`) Mark as Declined; `$client_info->is_lead` Send to Lead vs Client; `$show_invoice_option` (settings + permission) Create Invoice; `$can_create_projects` (permission) Create Project.

Rencana implementasi (4 file, tanpa perubahan DB dan tanpa perubahan Model):

1. **[NEW]** `app/Views/estimates/estimate_action_bar.php` - partial berisi `<div class='title-button-group'>` dan dropdown Tindakan; menerima `$estimate_info`, `$jml_item`, `$is_estimate_editable`, `$has_unresolved_custom_items`, `$is_admin`, `$client_info`, `$estimate_status`, `$show_invoice_option`, `$can_create_projects`.
2. **[MODIFY]** `app/Views/estimates/view.php` - ganti baris 187-461 dengan wrapper `id="estimate-action-bar-wrapper"` dan `view('estimates/estimate_action_bar', $action_bar_data)`.
3. **[NEW METHOD]** `Estimates.php` (setelah `get_estimate_status_bar()`, sekitar baris 6110) - `get_action_bar($estimate_id = 0)` yang memanggil `validate_numeric_value()`, `validate_estimate_access()`, `get_estimate_making_data()`, `count($view_data['estimate_items'])`, `Estimate_custom_items_model->get_unresolved_count()`, `_get_estimate_status_label()`, `_is_estimate_editable()`, `get_setting('module_invoice')` + `get_access_info('invoice')->access_type == 'all'`, `can_create_projects()`, dan mengembalikan `$this->template->view('estimates/estimate_action_bar', $view_data)`.
4. **[MODIFY]** `app/Views/estimates/details.php` - panggil `window.refreshEstimateActionBar(estimateId)` di 4 titik: `success callback update_item_field` (`view.php` L829), `success callback add_item`, `success callback delete_item`, `success callback map_custom_item`.

Fungsi JS global (re-`init` feather icon dan popover setelah `.html()`):

```js
window.refreshEstimateActionBar = function (estimateId) {
    $.get('<?php echo get_uri("estimates/get_action_bar"); ?>/' + estimateId, function (html) {
        if (html) {
            $('#estimate-action-bar-wrapper').html(html);
            if (window.feather) feather.replace();
            initDisabledActionPopovers(document.getElementById('estimate-action-bar-wrapper'));
        }
    });
};
```

Routing: cek apakah auto-discovery aktif di `app/Config/Routes.php`; jika aktif tidak perlu route manual.

Verification plan: (1) edit qty -> tombol Tindakan ter-update (`has_items`, `has_unresolved_custom_items`); (2) tambah item -> tombol "Tandai sebagai disetujui (won)" berubah state; (3) hapus semua item -> tombol "Kirim ke klien" disabled; (4) map custom item -> tombol Won aktif kembali.

**SLA desain:** 1 baris tambahan per `success callback`; total 4 file; nol perubahan skema; nol perubahan Model; tidak ada reload halaman penuh.

---

## 6. Migrasi JSON Data Registry Antar Modul (Acuan Baku)

### 6.1 Arsitektur Data

| Peran | Tabel | Format |
|---|---|---|
| Detail registry legacy | `transaksi_data_registry` (alias `dataRegistry`) | Blob (`serialize` / `base64_encode`) |
| Detail registry baru | `transaksi_data_json` (alias `dataJson`) | JSON (`json_encode` / `json_decode`) |
| Header registry (tetap) | `transaksi_registry` (alias `registry`) | Dibaca via `lookupBaseRegistries()` / `lookupRegistries()`; **tidak diubah** ke JSON |

### 6.2 Pemetaan Method Model (`MdlTransaksi.php`) - Shadow Methods

| Operasi | Legacy | Shadow JSON | Tabel Target | Penyimpanan |
|---|---|---|---|---|
| Write baru | `writeDataRegistries($id, $data)` | `writeDataRegistriesJson($id, $data)` | `transaksi_data_json` | `json_encode($val)` |
| Update | `updateDataRegistry($where, $data)` | `updateDataRegistryJson($where, $data)` | `transaksi_data_json` | `json_encode($val)` |
| Read by Master ID | `lookupDataRegistriesByMasterID($id)` | `lookupDataRegistriesJsonByMasterID($id)` | `transaksi_data_json` | `json_decode($val, true)` |
| Read dengan filter | `lookupDataRegistries()` | `lookupDataRegistriesJson()` | `transaksi_data_json` | `json_decode($val, true)` |
| Read joined main | `lookupDataRegistries_joined()` | `lookupDataRegistriesJson_joined()` | `transaksi` + `transaksi_data_json` | `json_decode($val, true)` |
| Read base data | `lookupBaseDataRegistries($ids)` | `lookupBaseDataRegistriesJson($ids)` | `transaksi_data_json` | `json_decode($val, true)` |
| Read main+slave | `lookupTransaksiDataRegistries($id)` | `lookupTransaksiDataRegistriesJson($id)` | `transaksi` + `transaksi_data_json` | `json_decode($val, true)` |

### 6.3 Aturan Penguraian

1. Wajib `json_decode($val, true)` - argumen kedua `true` menghasilkan array asosiatif multi-dimensi.
2. `blobDecode($val)` -> `json_decode($val, true)`.
3. `unserialize(base64_decode($val))` -> `json_decode($val, true)`.
4. **Pengecualian:** kolom utama di tabel `transaksi` seperti `counters` atau `ids_his` tetap diurai dengan `blobDecode()` karena bukan bagian dari `transaksi_data_json`.

### 6.4 Prosedur Refaktor (Find and Replace)

Langkah 1 - Write & Update: `writeDataRegistries(...)` -> `writeDataRegistriesJson(...)`; `updateDataRegistry(...)` -> `updateDataRegistryJson(...)`.

Langkah 2 - Read: `lookupDataRegistriesByMasterID` -> `lookupDataRegistriesJsonByMasterID`; `lookupDataRegistries` -> `lookupDataRegistriesJson`; `lookupDataRegistries_joined` -> `lookupDataRegistriesJson_joined`; `lookupBaseDataRegistries` -> `lookupBaseDataRegistriesJson`; `$tr->getFields()["dataRegistry"]` -> `$tr->getFields()["dataJson"]`.

Langkah 3 - Parsing: `unserialize(base64_decode($row->$param))` -> `json_decode($row->$param, true)`; `blobDecode($row->$param)` -> `json_decode($row->$param, true)`.

### 6.5 Contoh Komparasi Kode

Contoh A - Pembacaan registry (`Printing.php`, `_processSelectNotaItem.php`):

```php
// SEBELUM
$tmpReg = $tr->lookupDataRegistriesByMasterID($trID)->result();
$regFields = $tr->getFields()["dataRegistry"];
foreach ($tmpReg as $row) {
    foreach ($regFields as $param) {
        if (isset($row->$param)) {
            $masterTableInParams = unserialize(base64_decode($row->$param));
        }
    }
}

// SESUDAH
$tmpReg = $tr->lookupDataRegistriesJsonByMasterID($trID)->result();
$mongoFields = $tr->getFields()["dataJson"];
foreach ($tmpReg as $row) {
    foreach ($mongoFields as $param) {
        if (isset($row->$param)) {
            $masterTableInParams = json_decode($row->$param, true);
        }
    }
}
```

**Temuan:** nama variabel pada contoh "SESUDAH" masih `$mongoFields`, sisa penamaan dari implementasi berbasis MongoDB sebelumnya. Ini harus dinormalkan menjadi `$jsonFields` agar tidak membingungkan dan agar `grep` audit tidak salah tangkap.

Contoh B - Penulisan (`Create.php`, `FollowUp.php`): `$tr->writeDataRegistries($insertID, $baseRegistries)` -> `$tr->writeDataRegistriesJson($insertID, $baseRegistries)`.

Contoh C - Pembaruan (`Create.php`): `$tr->updateDataRegistry($where_registry, $baseRegistries)` -> `$tr->updateDataRegistryJson($where_registry, $baseRegistries)`.

### 6.6 Status Migrasi (Checklist 22 Modul)

Total modul utama: **22**. Selesai (Passed UAT): **4**. Proses/sebagian: **1**. Belum dikerjakan: **17**. Persentase penyelesaian **18,18%**. Seluruhnya berada di `application/modules/`.

- **SELESAI (4)**: `pembelian/`, `pembelianprojek/`, `pembelianjasa/` - semuanya memuat `Create`, `FollowUp`, `Printing`, `History`, `ActivityReport`, `_processSelectNotaItem`; serta `pembatalan/` dengan **Dual-Layer Fallback** aktif di `_processSelectNotaItem`, `_processSelectNota`, `_processSelectNotaRevert`, `Create`, `FollowUp`, `Printing`.
- **SEBAGIAN (1)**: `penjualan/` - `Create` dan `FollowUp` sudah sebagian; `Printing`, `ActivityReport`, `_processSelectNotaItem` belum.
- **BELUM (17)**, seluruhnya berstatus "Perlu audit & refaktor full": `pembelianimport/`, `penjualanproject/`, `penerimaan/`, `penerimaanprojek/`, `pembayaran/`, `distribusifg/`, `distribusijasa/`, `distribusiproduksi/`, `distribusisupplies/`, `pindahgudang/`, `opname/`, `adjustment/`, `adjustmentjurnal/`, `kas/`, `banking/`, `biaya/`, `produksi/`.

Target langkah berikutnya: selesaikan `penjualan` di `z:/san_9agus_json/application/modules/penjualan/`, tersisa `Printing.php`, `ActivityReport.php`, `_processSelectNotaItem.php`.

### 6.7 Arah Alternatif: Monolithic ke Modular Monolith (`longblob`)

Dua dokumen dengan H1 identik ("Rencana Migrasi Arsitektur: Monolithic ke Modular Monolith"). Sasaran: database holding `san_30mar` dengan tabel tunggal `transaksi_data_registry` berisi `longblob` -> modular monolith dengan awalan tabel per modul, meniru `san_tsa_28agu` / `san_sarana_30jun`. Pendekatan: **Strangler Fig Pattern**, migrasi modul demi modul (bukan Big Bang, risiko Big Bang dinilai 100%). Estimasi **6 sampai 12 bulan**, 50+ modul aktif, butuh rombak logika penyimpanan PHP CodeIgniter di seluruh aplikasi holding.

| Fase | Bulan | Isi |
|---|---|---|
| 1 - Persiapan & Pondasi | 1 | Ekstraksi skema `longblob` via `SELECT * FROM transaksi_data_registry LIMIT 100` lalu `unserialize()`/`json_decode()`; dokumen mapping variabel ke kolom relasional (contoh `["tanggal_transaksi"]` -> `tgl_transaksi (DATE)`); `CREATE TABLE` tabel modular kosong; pembuatan `Class Adapter` (`MdlMother`) sebagai pengatur lalu lintas dengan fungsi `insert()` dan `update()`; setup server staging berisi copy database production dan source code |
| 2 - Implementasi Modul Pilot | 2 | `MdlPembelianTransaksi.php` extends `MdlMother` dengan nama tabel `pembelian_transaksi_data_registry`; refactoring controller: hapus `$this->db->insert('transaksi_data_registry')` ganti `$this->MdlPembelianTransaksi->simpan($data)`; **normalisasi detail transaksi krusial** - satu baris per barang ke tabel relasional murni `pembelian_transaksi_detail`, BUKAN digumpalkan lagi menjadi blob/JSON; validasi di staging |
| 3 - Dual-Write & Backfill | 2-3 | Dual-write di `MdlMother`: tulis ke `pembelian_*` baru **DAN** replika ke tabel global lama format `longblob` agar modul Akuntansi/Gudang tidak kehilangan data; deploy ke production; cron job malam hari menarik histori 5-10 tahun ke belakang dan menyuntikkan ke tabel baru |
| 4 - Cut-Over & Pembersihan | 3 | Verifikasi checksum; hard cut-over dengan mematikan instruksi dual-write di `MdlMother`; `DELETE FROM transaksi_data_registry WHERE jenis = 'pembelian'` untuk storage recovery |
| 5 - Iterasi | 4-12 | Repetisi Fase 2-4 untuk Penjualan, HRD, Gudung, Produksi, dan sisa modul; bisa paralel antar developer karena tiap domain mandiri; `DROP TABLE transaksi_data_registry` setelah modul terakhir sukses |

Struktur target pilot: tabel `pembelian_transaksi_data_registry` (**11 kolom tanpa `longblob` berlebih**) plus tabel detail relasional `pembelian_transaksi_detail`, dengan relasi dan index untuk optimasi query.

Verification plan: (1) **Data Integrity / Checksum Script** membandingkan total Rupiah/Kuantitas antara `longblob` lama dan kolom tabel baru, laporan harus **PASS dengan selisih Rp 0**; (2) **Dry Run / UAT di staging** bersama perwakilan tiap divisi (misal Kepala Pembelian) memverifikasi histori transaksi sebelum naik production; (3) **UAT harian selama Dual-Write** dengan kepala divisi memeriksa laporan tiap hari agar transaksi lama dan baru muncul sempurna.

Open questions: modul mana dari 50+ yang memiliki ukuran data transaksi terbesar (dipakai menentukan Pilot Project); dan versi dokumen pertama menambah pertanyaan apakah ERP menggunakan ORM atau Active Record standar CodeIgniter (ORM mempermudah mapping) - **pertanyaan ORM ini hilang di versi kedua**, kemungkinan tidak sengaja atau sudah terjawab, harus dikonfirmasi.

---

## 7. Arsitektur Controller: Modul vs Non-Modul + CLI Controller Murni

### 7.1 Modul (HMVC / CI3)

Lokasi: `application/modules/penjualan`. Struktur:

- `config/` - `coTransaksiCore.php`, `coTransaksiUi.php` (UI, tata letak, default nilai transaksi).
- `controllers/` - alur logika transaksi utama.
- `models/` - `MdlPenjualanTransaksi.php`, `MdlCrmDataBridge.php`, `MdlCustomer.php`, `Mdls/...`.

Kontrol akses rule transaksi-step berasal dari `heTransaksi_ui` dengan fungsi `placeCanMakeTrans(...)` dan `placeCanFollowupTrans(...)`. Pola controller seragam: `Create`, `FollowUp`, `Printing`, `History`, `ActivityReport`, `_processSelectNotaItem` (pola yang sama untuk pembelian, pembelianprojek, pembelianjasa, pembatalan).

### 7.2 Non-Modul Controllers - Status 2026-07-27

Pelaksana: Agent 7 (Gatekeeper & Scope Crossing). Metodologi: audit empiris terhadap tabel `log` di server database `192.168.5.10` plus pemindaian direktori `application/controllers/`. Status deklaratif: **ALL 11 NON-MODULE CONTROLLERS FULLY COMPLETED & VERIFIED**. Checklist 11 item, seluruhnya berstatus `Done 2026-07-27`:

1. `application/controllers/Addons/ViewDetails.php` - Unique Row Key & Badge Varian.
2. `application/controllers/Katalog.php` (`/Katalog/viewProduk`) - fallback pencarian keyword varian SKU & `combination_key` dari tabel `var_product_variants`.
3. `application/controllers/Data.php` - Master Data Varian Relation & Generator; integrasi `generate_or_update_variants`, pembacaan `var_product_attributes`, pengaitan `product_id` master.
4. `application/modules/addons/controllers/Qr.php` - method `doPrint()` dengan resolusi data varian; stiker barcode/QR Code menyertakan label SKU `[SKU-VARIAN]` dan barcode spesifik varian fisik.
5. `application/controllers/Spread.php` - Spreadsheet Matriks Harga Varian Per Cabang; handler `hargaProduk` dan integrasi `heDataBehaviour` `MdlProduk`.
6. `application/controllers/Ledger.php` - Ledger Mutasi Stok Per Varian Dual-Write; `viewMovementGroup()` untuk mutasi Finished Goods (FG) terhubung ke `ComLockerStockDualWrite` dan `stock_locker_variant`.
7. `application/modules/*/controllers/Printing.php` - 6 modul: `requeststok`, `penerimaan`, `penerimaanprojek`, `pembatalan`, `pembelianprojek`, `penjualanproject`; badge `<span class='badge bg-blue'>` dan unique row key indexing.
8. `application/modules/*/views/printing.php` - 6 modul yang sama.
9. `application/controllers/ProductEditor.php`.
10. `application/controllers/VendorPrice.php`.
11. `application/controllers/SuppliesVariantSettings.php`.

Verifikasi yang dinyatakan: (1) `php -l application/controllers/[NamaController].php` PASS 100%; (2) Log Traffic Audit verified clean 0 errors pada log server.

**Catatan scope:** item 4 (`modules/addons/controllers/Qr.php`) secara struktur adalah controller **modul**, bukan non-modul, sehingga klaim "11 non-module controllers" tidak presisi. Selain itu `Addons/ViewDetails.php` berada di subdirektori, bukan langsung di `application/controllers/`.

### 7.3 Controller Generik `Items.php` (Generasi Baru)

File: `app/Controllers/Items.php` (`w:/san_ibb_2jul`). Halaman: `charly.mayagrahakencana.com/items/index/items`. Satu controller melayani banyak halaman lewat **URL segment ke-3**, dipakai di `__construct()` baris 17-43:

```php
$this->model = $model = url_segment(3);
$className = ucwords($model);
$model_name = "App\\Models\\" . $className . "_model";
if (class_exists($model_name)) {
    $this->Items_model = model($model_name);
} else {
    $this->Items_model = model("Items_model");
}
```

Halaman yang dilayani: Produk dijual, Satuan, Kategori konsumen, Sub bidang konsumen, Kategori item, Sub preferensi produk, Sumber, Sumber Prospek, Status prospek, Subsidiary.

Kontrak model wajib: `getFields()`, `get_details($options)`, `get_one($id)`, `ci_save($data, $id?)`, `delete($id, $undo?)`; opsional `getSyncroConfig()`, `get_max_counter_value()`, property `upload_file_allowed`. Struktur definisi field `getFields()` mendukung `form`, `column`, `form_key`, `fx`, `form_fx`, `links` (`url`, `fx`), `formates` (`decoding`, `image`), `optional` (nama method controller untuk dropdown), `form_datas`, `form_data_model`, `form_data_view`, `manages`.

Daftar method public (10 method): `index()` di `GET /items/index/[model]` (validasi akses, cek `getSyncroConfig()`, baca `_get_fields()`, deteksi kolom `optional` dan `manages`, render `items/index`; mengirim `$model`, `$field_to_view`, `$can_syncro_datas`, `$can_edit_datas`, `$api_base_url`, `$can_manage_optional`, `$manages`); `list_data()` di `POST /items/list_data/[model]` (DataTable AJAX dengan filter `category_id`, `jenis` (`item`, `paket`, `item_rakitan`, dll), `folders_id`, `search`); `modal_form()` di `POST /items/modal_form/[model]` (form modal, mode *managable* via GET `?x=`, upload file, template khusus model `domain`); `save()` di `POST /items/save/[model]` (iterasi field, `form_fx`, counter otomatis, proses upload, `Items_model->ci_save()`); `delete()` di `POST /items/delete/[model]` (soft delete dan `undo`); `syncro_data()` di `POST /items/syncro_data/[model]` (tarik dari Data Center API lewat `_sync_items_data()` untuk produk + varian dan `_sync_clients_data()` untuk customer batch 150/call); `variant_detail_modal()` di `POST /items/variant_detail_modal/[model]` (tabel `var_product_variants`, `var_product_variant_values`, `var_attributes` / `var_attribute_values`, `var_size_scale_values` opsional); `view()` (detail item modal + `client_info`); `save_files_sort()` (urut file lampiran hasil drag-drop); `download_sample_excel_file()` (unduh `import-items-sample.xlsx`).

Method private penting: `_get_fields()` dan `_get_fields_modal()` (subset dengan `form === true`); `_make_item_row($data)` (render baris: `links` -> `modal_anchor`, `formates` + `image` -> `<img>`, `variant_count` -> pill badge dapat diklik, default -> nilai mentah; kolom aksi edit/delete selalu ditambahkan); `_sync_items_data($datas)` (insert/update berbasis `id`, varian via `sync_variant_data_blocks()`, transaksi `transBegin/transCommit/transRollback`); `_sync_clients_data($datas)` (batch via GET `batch_start` dan `batch_size` default 150, resolving wilayah via `_resolve_postal_location_ids()`, pencocokan berbasis `dc_id` atau `company_name`); `_resolve_postal_location_ids()` (tabel `rise_postal_codes`, strategi bertingkat: kodepos+provinsi -> provinsi+kabupaten+kecamatan+kelurahan -> provinsi+kabupaten+kecamatan -> provinsi+kabupaten -> provinsi).

Dropdown helper yang dipanggil dinamis dari `index()`: `_get_jenis_dropdown()` (`item`, `item_rakitan`, `item_komposit`, `paket`), `_get_folders_dropdown()` (dari `folders_nama` di tabel items), `_get_categories_dropdown()` (dari `Item_categories_model`).

Kontrol akses di `validate_access_to_items()`: `is_admin` diizinkan; `access_invoice === 'all'` diizinkan; `access_estimate === 'all'` diizinkan; punya permission `data_mgk` diizinkan; modul `invoice`, `estimate`, atau `data_mgk` tidak aktif -> redirect `forbidden`.

Import Excel memakai trait `Excel_import` dengan header kolom wajib `title`, `category`, `rate`; opsional `description`, `unit_type`, `show_in_client_portal`.

**Risiko teknis tercatat pada dokumen:** method `test()`, `testbaca()`, `cek()`, dan `doResetCrmData()` adalah utilitas/debugging yang harus dilindungi atau dihapus sebelum production. Peringatan kedua: nama model diambil dari URL segment ke-3 dengan `ucwords()`, bersifat *namespace-sensitive* untuk `class_exists`. **Implikasi tambahan yang tidak disebut dokumen:** segment ke-3 yang dikendalikan user dapat dipakai untuk memuat model yang tidak dimaksud (arbitrary model loading) bila daftar putih tidak ditegakkan.

### 7.4 CLI Controller Murni (Tanpa `$_SESSION`)

Lokasi: `z:\san_sarana_7jul\application\modules\penjualan\controllers\Cli.php`. Default `$jenisTr = "sales_pre_order"`. Guardrail di constructor:

```php
class Cli extends MX_Controller
{
    private $jenisTr = "sales_pre_order";

    public function __construct()
    {
        parent::__construct();
        if (!$this->input->is_cli_request()) {
            show_404();
            exit;
        }
    }
}
```

Perintah CLI:

```bash
php index.php penjualan/cli/process_crm_to_order/[estimate_id]/[operator_user_id]/[json_options]
```

Contoh `json_options`:

```
'{"paymentMethod":"credit","tos":"LOCAL","shipping_date":"2026-07-07","due_date":"2026-08-06","capacity":"NON IMPORT","shipping_service":"NONE"}'
```

Lima langkah eksekusi:

1. **Validasi operator** - `SELECT` dari tabel `user` berdasarkan `id`; dipakai untuk audit trail (`oleh_id`, `oleh_nama`).
2. **Ambil order & item CRM** - `MdlCrmDataBridge` dengan `addFilter("qty_saldo > '0'")` dan `addFilter("estimate_id = '$estimate_id'")`, `lookUpAll()->result()`; `customer_id` diambil dari item pertama; `MdlCustomer->lookupByID($customer_id)->row_array()`.
3. **Penentuan opsi** - default: `shipping_date` = hari ini, `due_date` = hari ini + `due_days` customer (default 30), `payment_method` = `credit` bila `kredit_limit > 0` else `cash`, `tos` = `LOCAL`, `capacity` = `NON IMPORT`, `shipping_service` = `NONE`; `utasan` = `CKD` bila `ckd_cbm > 0` atau `ckd_kg > 0` else `CBU`. Nomor booking digenerate dari `dtimeNow()` (tanggal + waktu tanpa tanda `-` dan `:`).
4. **Susun `$txData`** - `master` (nomer, `pihak_id`, `pihak_nama`, `pihak_level`, `jenis`, `oleh_id`, `oleh_nama`, `cabang_id` default 1, `ref_order` = `crm`, `ref_order_estimate_id`, `payment_method`, `status` = 11, `trash` = 0, `created_at`), `master_values` (tos, tos_nama, shipping_date, due_date, shipping_service, capacity, utasan, cbu_cbm, cbu_kg, ckd_cbm, ckd_kg), `items` (produk_id, produk_nama, produk_kode, qty, harga, subtotal, no). Fallback harga lokal bila `produk_ord_hrg <= 0`: `SELECT nilai FROM price WHERE produk_id=... AND jenis_value='jual' AND cabang_id=CB_ID_PUSAT AND trash=0 AND status=1 ORDER BY id DESC`.
5. **Simpan transaksional** - `trans_start()`, `MdlPenjualanTransaksi->writeMainEntries($txData['master'])`, insert ke `transaksi_values` (`transaksi_id`, `key`, `value`) per atribut master_values, insert ke `transaksi_data` (`transaksi_id`, `produk_id`, `produk_nama`, `qty`, `harga`, `subtotal`, `created_at`) per item, `trans_complete()`, cek `trans_status()`, `catch (Exception $e)` -> `trans_rollback()` dan `exit(1)`.

Pemetaan parameter CLI ke UI form: `tos` (Term Of Shipment, default `LOCAL`) -> `transaksi_values` key `tos`; `paymentMethod` (default `credit` bila `kredit_limit > 0` else `cash`) -> kolom `payment_method` di `transaksi`; `shipping_date` (default hari ini `Y-m-d`) -> key `shipping_date`; `due_date` (default hari ini + `due_days` customer) -> key `due_date`; `capacity` (default `NON IMPORT`) -> key `capacity`; `shipping_service` (default `NONE`) -> key `shipping_service`; `cbu_cbm`/`cbu_kg` (default `0.0`) -> key masing-masing; `ckd_cbm`/`ckd_kg` (default `0.0`) -> key masing-masing; `utasan` otomatis (`CKD` bila CKD > 0 else `CBU`) -> key `utasan`; `auto_validation` otomatis (`YES`) -> kolom `auto_validation` atau setup internal.

**Temuan teknis pada CLI controller:**

1. Operator `??` pada `$user['cabang_id'] ?? 1` membutuhkan PHP 7.0+. Ini **bertentangan** dengan guardrail global "PHP 5.6" di runbook `san_staging` untuk modul penjualan yang sama.
2. `addFilter("estimate_id = '$estimate_id'")` menyisipkan input CLI mentah ke SQL. Karena dipanggil dari CLI, risikonya lebih rendah, tetapi tetap harus memakai prepared statement atau whitelist numerik.
3. Baris deskripsi menyebut "insert transaksi baru ke MySQL/MongoDB", sedangkan seluruh kode hanya memakai tabel MySQL (`transaksi`, `transaksi_values`, `transaksi_data`). Klaim MongoDB adalah sisa dokumentasi.
4. Kolom `auto_validation` dengan nilai `YES` ada di tabel pemetaan tetapi tidak ada di kode insert. Kontrak parameter tidak lengkap.
5. Tidak ada validasi bahwa item CRM sudah diproses; guard hanya `qty_saldo > '0'`. Risiko duplikasi order pada retry CLI. Idempotency key berbasis `estimate_id` + `status` belum ada.
6. CLI `process_crm_to_order` tidak set `transaksi_data_json`/registry sama sekali, sehingga jalur ini **tidak kompatibel** dengan rencana migrasi JSON Data Registry.

---

## 8. Akses Data dan Gap ke Gaya SAP

### 8.1 Model Akses Saat Ini (Hybrid)

Komponen inti:

- `Role/Membership` pada session login - user membawa array `membership` di `$_SESSION['login']`.
- Custom access per user di tabel `set_menu` - override hak akses transaksi per `menu_category + step`.
- Rule transaksi-step dari config `heTransaksi_ui` - `placeCanMakeTrans(...)`, `placeCanFollowupTrans(...)`.
- Data scope berbasis `cabang_id`/`gudang_id`, banyak diterapkan via filter model/controller.
- Column-level access via `set_access_kolom` - `has_access_kolom(...)`.

Kelebihan: cocok untuk codebase legacy; mendukung kombinasi role + pengecualian per user; sudah mempertimbangkan context cabang/gudang; sudah ada jejak historis perubahan akses.

Keterbatasan: enforcement tersebar di banyak helper/controller (bukan satu policy engine); definisi permission masih dekat ke menu/step; konsistensi antar modul bergantung disiplin tiap endpoint; sulit audit lintas modul karena sumber keputusan akses tidak tunggal.

### 8.2 Model Target SAP-Style

Prinsip: user tidak di-assign permission satu-satu, tetapi di-assign **Role** yang berisi **Authorization Object** (fungsi bisnis), **Action** (READ, CREATE, POST, APPROVE, REVERSE, dll), dan **Context** (company/cabang/gudang/divisi/periode/dokumen).

Karakteristik: lintas modul; row-level authorization; centralized enforcement di backend policy service (bukan UI); audit-ready dengan alasan dan context.

### 8.3 Tabel Perbandingan

| Aspek | Metode Saat Ini | SAP-Style Target | Gap |
|---|---|---|---|
| Unit kontrol | Membership + menu/step | Authorization Object + Action + Context | Besar |
| Sumber keputusan | Tersebar di helper/controller | Terpusat (policy engine/service) | Besar |
| Scope data | Cabang/gudang (manual per query) | Context-aware formal (org field) | Sedang-Besar |
| Lintas modul | Ada, tapi tidak uniform | Native lintas modul | Besar |
| Audit otorisasi | Ada history perubahan akses | Ada history + trace keputusan runtime | Sedang-Besar |
| Kemudahan review compliance | Sulit (banyak titik check) | Lebih mudah (single source of truth) | Besar |
| Backward compatibility | Tinggi untuk kondisi sekarang | Perlu adapter transisi | Terkelola |

### 8.4 Dampak Bisnis dan Kontrol

- **Stok** - risiko user salah otorisasi posting movement; kontrol: enforce object/action/context untuk create/followup/reverse.
- **Accounting/Jurnal** - risiko approval/posting oleh role tidak valid; kontrol: object khusus posting/approval/reversal dengan context unit/periode.
- **Approval Workflow** - risiko lompatan step; kontrol: action per step (APPROVE/REJECT/UNDO) di object workflow.
- **Laporan** - risiko data leakage lintas cabang/divisi; kontrol: context filter wajib di backend, bukan hanya menu.
- **Audit** - risiko tidak bisa menjawab "siapa boleh apa pada data mana dan mengapa"; kontrol: central policy trace dan log deny/allow.

### 8.5 Komponen dan Strategi Transisi

Tabel baru yang disarankan: `auth_roles`, `auth_user_roles`, `auth_objects`, `auth_actions`, `auth_role_permissions`, `auth_role_contexts`, `auth_policy_trace` (opsional). Tabel existing `set_menu`, `set_menu_manufactur`, `set_access_kolom` **tetap dipertahankan** selama transisi; jangan dihapus sebelum coverage policy baru tervalidasi.

Adapter layer: fungsi lama (`placeCanMakeTrans`, `placeCanFollowupTrans`, `has_access_kolom`) memanggil policy service baru secara bertahap dengan fallback ke mekanisme lama bila object belum tersedia.

Lima fase transisi:

- **Fase 0 - Baseline dan Mapping**: inventaris check akses endpoint kritikal; mapping `jenisTr + step` ke `authorization object + action`; definisikan context minimum `cabang_id`, `gudang_id`, `div_id`, `jenis_tr`, `step`. Output: matrix permission lintas modul dan daftar gap per modul.
- **Fase 1 - Build Fondasi (Non-Blocking)**: buat tabel auth baru; isi dari konfigurasi existing; policy service **read-only** (belum jadi gate utama).
- **Fase 2 - Dual Check (Monitor Mode)**: keputusan lama tetap dipakai, keputusan baru hanya dicatat/log; bandingkan mismatch.
- **Fase 3 - Enforce Bertahap per Domain**: urutan prioritas master data non-transaksional -> transaksi low-risk -> transaksi stok/accounting/approval. Setiap domain: UAT role matrix, validasi data scope, sign-off bisnis + audit internal.
- **Fase 4 - Cutover dan Hardening**: policy baru jadi sumber utama; mekanisme lama fallback terbatas; deprecate bertahap setelah audit lolos.

Contoh mapping praktis: `TRX_PURCHASE_ORDER` dengan Action `CREATE`, `READ`, `APPROVE_STEP_2`, `REJECT_STEP_2`, `UNDO_STEP_2` dan Context `cabang_id`, `gudang_id`; `TRX_GRN` dengan Action `CREATE`, `APPROVE`, `REVERSE` dan Context `cabang_id`, `gudang_id`, `periode`; `PRICE_COLUMN` dengan Action `READ` dan Context `kolom_key=jual/beli`, `cabang_id`.

Risiko dan mitigasi (5 pasang): mismatch rule lama vs baru -> user terkunci atau kebablasan -> dual-check monitor mode + log mismatch; cutover terlalu cepat -> gangguan transaksi operasional -> phased rollout per modul/domain; context tidak lengkap -> kebocoran data lintas unit -> wajib definisi context minimum per object; endpoint lama terlewat -> bypass policy baru -> endpoint inventory + regression test checklist; audit trail terputus -> sulit investigasi -> simpan trace keputusan allow/deny di runtime.

Kriteria sukses migrasi: tidak ada regresi akses pada proses transaksi kritikal; tidak ada data leakage lintas cabang/gudang/divisi; keputusan otorisasi dapat dijelaskan dan diaudit; role onboarding/offboarding lebih cepat dan konsisten; endpoint tidak bisa di-bypass lewat direct URL/API.

### 8.6 Lapisan Read-Model: `z_sales_salesman_cache` dan `z_sales_pembantu_cache`

Database `san_13mar`. Tabel `z_sales_salesman_cache` adalah jurnal header-level (dokumen) dengan rentang data **2021-01-04** sampai **2026-03-12**, **18.525 baris**, **8.111 transaksi unik** (`transaksi_id`).

Kolom kunci pivot: `transaksi_id` int(11); `rekening`/`jenis` varchar; `seller_nama`; `customer_nama`; `thn`/`bln`/`tgl`; `fulldate` date; `harga_bruto`; `diskon_nilai`; `ppn_nilai`; `harga_netto` (= `harga_bruto - diskon_nilai`); `ongkir_nilai`; `harga_nppn` (= `harga_netto + ppn_nilai`).

Tabel detail per item `z_sales_pembantu_cache` berisi **69.015 baris** dengan kolom tambahan `produk_kode`, `produk_part` (contoh `FC-H2`), `produk_satuan`, `produk_jenis`, `kategori_nama`. Tabel ini wajib dipakai untuk pivot per produk karena `z_sales_salesman_cache` berada di level header.

**Gotcha wajib:** ada **literal duplicate rows**; `SUM(harga_netto)` langsung menginflasi angka. Solusi wajib: dedup berbasis `GROUP BY` dengan `MAX()` per dokumen/status sebelum agregasi.

**Lifecycle dokumen (`rekening`):**

- Pre-Order (SPO): `582spo` (Lokal), `382spo` (Internasional), `588spo` (Proyek).
- Confirmed Order (SO): `582so`, `382so`, `588so`.
- Delivery/Shipped (SPD): `582spd`, `382spd`.
- Project Receipt: `7499`.

Untuk laporan realisasi sales, wajib filter ke tahap **Confirmed Order (SO)** saja untuk menghindari *double counting* lintas status.

Empat query pivot yang terdokumentasi: (A) pivot penjualan SO per salesman per tahun 2021-2026 dengan `WHERE rekening IN ('582so','382so','588so')` dan `MAX(harga_netto)`; (B) pipeline SPO vs SO vs SPD vs Project Receipt per salesman dengan `CASE` pemetaan stage; (C) konsentrasi pelanggan (top customers) per salesman dengan `LIMIT 15`; (D) pivot bulanan per tahun (`bln` `'01'`..`'12'`).

Pendekatan pivot dinamis: (A) **Flat SQL + PHP** (sangat direkomendasikan) - SQL mengembalikan `seller_nama`, `thn`, `SUM(net_sales)`, PHP menyusun array pivot dan daftar tahun unik (`sort($years)`), view merender `number_format($amount, 2, ',', '.')`; (B) **Dynamic SQL** dengan `SET @sql`, `GROUP_CONCAT(DISTINCT CONCAT('FORMAT(SUM(CASE WHEN thn = ''', thn, ...)))`, `PREPARE`/`EXECUTE`/`DEALLOCATE PREPARE`.

Analisis lanjutan yang enables oleh kedua tabel: RFM (Recency via `DATEDIFF(CURRENT_DATE(), MAX(fulldate))`, Frequency via `COUNT(DISTINCT transaksi_id)`, Monetary via `SUM(harga_netto)`), siklus pengiriman/SLA (`AVG(DATEDIFF(dtime_kirim, dtime_order))` dan `AVG(DATEDIFF(dtime_terima, dtime_kirim))` per `seller_nama`), Market Basket Analysis (self-join `z_sales_pembantu_cache p1` dan `p2` pada `transaksi_id` dengan `p1.produk_part < p2.produk_part`, `LIMIT 10`), Analisis Pareto 80/20, dan deteksi churn (konsumen rutin 6 bulan terakhir tanpa transaksi).

---

## 9. Standar Praktik dan Temuan

### 9.1 Standar Praktik yang Berlaku (Konsolidasi)

1. Backup tidak boleh dilakukan dengan copy file-level ke datadir yang sedang berjalan; `FLUSH TABLES WITH READ LOCK` tidak memadai untuk InnoDB.
2. Backup harus streaming ter-kompresi (`zstd -3`) ke media terpisah dengan verifikasi SHA256.
3. Jika backup diambil dari replica, SQL Thread **wajib** dimatikan selama streaming dan `read_only=ON` diaktifkan, dengan I/O Thread tetap hidup.
4. Setiap proses yang mengubah status server wajib dibungkus `trap cleanup EXIT INT TERM HUP` sehingga server selalu dikembalikan ke status normal.
5. Status pipeline harus dievaluasi per indeks (`${PIPESTATUS[n]}`), bukan lewat `pipefail` yang menyesatkan, dan `trap - ERR` dipakai di sekitar pipeline.
6. Log yang dikirim ke kanal eksternal (Telegram) wajib disanitasi (`sed` untuk `<` dan `>`).
7. Mount jaringan (CIFS) wajib di-health-check sebelum operasi berat dan di-remount dengan parameter performa bila stale handle terdeteksi.
8. Replikasi bukan backup; retensi binlog harus menutupi SLA recovery, dan backup periodik terpisah tetap wajib.
9. Optimasi performa wajib didahului baseline minimal 5 run dan diakhiri bukti before/after; `php -l` wajib lulus untuk tiap file yang diubah.
10. Guardrail model umum: `MdlTransaksi` dan `MdlMother` tidak boleh diubah tanpa persetujuan eksplisit.
11. Kontrak request tidak boleh berubah: `GET` tetap `GET`, `POST` tetap `POST`; backward compatibility URL, parameter, dan alur UI wajib dijaga.
12. Migrasi skema wajib bertahap dengan dual-write, backfill cron, checksum PASS, dan hard cut-over hanya setelah validasi 100%.
13. Backup yang setara perlu inisialisasi ulang rantai (`--force-full`) bila LSN chain rusak.

### 9.2 Angka Kunci yang Tersimpan

| Kategori | Angka |
|---|---|
| Katalog baseline | 4814,68 ms; peak memory 579 MB |
| Katalog sesudah | 3182,42 ms; peak memory 476 MB |
| Delta waktu | -1632,26 ms (-33,90%) |
| Delta memory | -103 MB (-17,79%) - target 20% belum tercapai |
| SLA p95 Quick Win | minimal -30% |
| SLA p95 Sistemik | minimal -60% |
| SLA memory (checklist) | minimal -20% |
| Count katalog | produk 1390, harga_total 73920->49018, stok_active 13028->12649, stok_hold 34, images 955->921, cabang 13, dataParents 1390->1292, dataChildCabang 13 |
| Blok terlama (baseline) | `query_produk_dan_harga_produk` 1756,82 ms; `pairing_final_matrix` 949,45 ms; `query_harga_lanjutan_dan_stok` 725,10 ms |
| Blok terp Liberties (sesudah) | `query_mutasi_tahunan` 455,13 ms (regresi +16,91 ms) |
| Migrasi JSON | 22 modul; 4 selesai; 1 sebagian; 17 belum (18,18%) |
| Migrasi arsitektur | 6-12 bulan; 50+ modul; 11 kolom tabel pilot |
| Pivot sales | 18.525 baris header; 8.111 transaksi unik; 69.015 baris detail; 2021-01-04 s/d 2026-03-12 |
| Controller non-modul | 11 item selesai 2026-07-27 |
| Replikasi | 2 host; `server_id` 61/17; retensi binlog 7 hari (config) vs 3 hari (runtime) |
| Backup GFS | 1 full/Minggu + 6 incremental/Seq; `zstd -3` |
| Insiden GFS | exit 134 (SIGABRT); tabel 7,0 GB; offset 4.582.277.120; errno 61 |
| Cron | backup source 01:00; mirror restore 01:40 |

### 9.3 Rekomendasi Tindak Lanjut Prioritas

1. **Putuskan arah migrasi skema** (JSON in-place vs tabel per modul). Semua usaha migrasi JSON pada 4 modul akan menjadi sia-sia bila keputusan diambiltable-per-modul.
2. **Rinci ulang 9 blok step timing yang tidak tercatat** pada tabel "sesudah" Katalog untuk memastikan tidak ada regresi tersembunyi +123 ms.
3. **Tutup checklist parity Katalog** (contract data, rule bisnis, 20 sampel, UI) sebelum GO dicatat final; rekonsiliasi penurunan `images` (-34) vs `dataParents` (-98).
4. **Samakan retensi binlog** antara config (`expire_logs_days=7`) dan operasional (`=3`) dan dokumentasikan alasannya.
5. **Tambahkan `auth_policy_trace` lebih awal** bila target audit SAP-style tercapai, karena saat ini belum ada jejak keputusan runtime.
6. **Hapus atau gate** method debug `test()`, `testbaca()`, `cek()`, `doResetCrmData()` di `Items.php`.
7. **Perbaiki kompatibilitas PHP** pada `Cli.php` (operator `??`) agar sesuai guardrail PHP 5.6, atau formalisasi upgrade runtime minimum ke PHP 7.
8. **Tambahkan idempotency key** pada `process_crm_to_order` agar retry CLI tidak membuat order ganda.
9. **Normalkan penamaan** `$mongoFields` -> `$jsonFields` pada acuan migrasi JSON.
10. **Konsolidasikan direktori backup** (`*_05mei2026`, `*OLD`, `*_ori`, sufiks ganda) agar registry modul `san_staging` mencerminkan kondisi single source.

---

## 10. Temuan Lintas-Dokumen dan Kontradiksi

| No | Topik | Versi A | Versi B | Penilaian / Versi Mutakhir |
|---:|---|---|---|---|
| 1 | Sinkronisasi DB | Hot backup mirror: source `mariabackup` online, mirror tarik via SSH/rsync lalu restore (mirror downtime) | Replikasi MariaDB 10.3 primary-replica (`192.168.61.1` -> `192.168.5.17`) | **Mutakhir: replikasi.** Mirror hot-backup menjadi mekanisme seed/graft, bukan sinkronisasi rutin. |
| 2 | Lokasi backup harian | Full backup harian disimpan di source (`/backup/mariadb/latest`) | "Tidak ingin menyimpan full backup harian di source" | **Mutakhir: chaining GFS di replica -> Windows Vault.** Source tidak menyimpan full harian. |
| 3 | Backup dijalankan di | Source (dokumen mirror) | Replica/slave (dokumen GFS) | **Mutahari: replica**, dengan proteksi Zero-Write. |
| 4 | Prefix binlog | `log_bin=mysql-bin`, file `mysql-bin.000123` (dokumen replikasi) | `rm -f /var/lib/mysql/mariadb-bin.*` (dokumen GFS) | **Kontradiksi teknis.** Prefix harus satu; doktor GFS sudah mewajibkan `SHOW VARIABLES LIKE 'log_bin%'` - zpola. Disarankan `log_bin=mariadb-bin` agar konsisten. |
| 5 | Retensi binlog | `expire_logs_days=7` di `my.cnf` primary | `SET GLOBAL expire_logs_days = 3` + `[mysqld] expire_logs_days = 3` | **Kontradiksi.** Versi mutakhir minimal harus >= siklus full+incremental (7 hari) atau RPO yang disepakati. |
| 6 | Nama API replikasi | `SHOW SLAVE STATUS`, `STOP SLAVE`, `START SLAVE SQL_THREAD`, `MASTER_*`, `CHANGE MASTER TO`, `--slave-info`, `--safe-slave-backup`, `skip_slave_start` | MariaDB 11+ memakai `SHOW REPLICA STATUS`, `START REPLICA`, `REPLICA_*`, `--replica-info`, `--safe-replica-backup` | **Konsisten dengan MariaDB 10.3** (disebut di judul dokumen replikasi). Dokumen otorisasi hanya menyebut "MariaDB 10" - perlu dipinned ke 10.3.x. |
| 7 | Arah migrasi skema registry | `json_migration_reference.md`: blob -> JSON di tabel **global** `transaksi_data_json` via shadow method | `implementation_plan*.md`: blob -> **tabel per modul** `pembelian_transaksi_data_registry` (11 kolom) + `pembelian_transaksi_detail` | **Kontradiksi paling material.** Dua Architectural Different. Butuh keputusan arsitektur sebelum eksekusi lanjutan. |
| 8 | Jumlah modul migrasi | Checklist JSON: **22 modul** | Rencana arsitektur: **50+ modul** | Tidak kontradiktif secara logika (22 = subset yang sudah teridentifikasi), tetapi cakupan migrasi belum diverifikasi. |
| 9 | Jumlah sisa modul | Versi 1: "sisa **45+** modul lainnya" | Versi 2: "sisa **49** modul lainnya" | **Selisih aritmetika** karena basis hitungan berbeda (50 vs 51/50). Perlu satu angka baku. |
| 10 | Roadmap Katalog | Trace Board `KATALOG_PERFORMANCE_PLAN.md`: QW-01 `IN_PROGRESS`, QW-02..QW-06 `TODO` | `KATALOG_PRE_POST_CHECKLIST.md`: hasil Quick Win sudah tercatat, keputusan `[x] GO` | **Status plan tidak sinkron dengan bukti eksekusi.** Update Trace Board. |
| 11 | Baseline Katalog | Tahap-1: 4814,68 ms | Tahap-2: 4177,56 ms (disebut "Delta vs Tahap-2") | **Dua baseline berbeda.** Perbandingan lintas checklist tidak valid tanpa normalisasi kondisi mesin. |
| 12 | Sisa memory Katalog | Checklist: total turun >=30% (**terpenuhi 33,90%**) | memory turun >=20% (**tidak terpenuhi 17,79%**) tetapi GO diberikan | **SLA belum tuntas** namun GO sudah dicentang. |
| 13 | Suffix variabel JSON | Standar: `dataJson` | Contoh kode: `$mongoFields` | **Sisa penamaan MongoDB.** Normalkan. |
| 14 | Pengekodean | `json_decode($val, true)` | `counters`/`ids_his` tetap `blobDecode()` | Bukan kontradiksi; **pengecualian yang disengaja** dan harus diDocumentation sebagai aturan eksplisit. |
| 15 | Versi PHP | Guardrail global: PHP 5.6 + CI3 | `Cli.php` memakai `$user['cabang_id'] ?? 1` (PHP 7+) | **Kontradiksi runtime.** Tentukan minimum PHP 7 untuk modul penjualan, atau ganti `??` dengan `isset()`. |
| 16 | Basis kode | `application/modules/`, `application/controllers/`, `MX_Controller` (CI3) | `app/Controllers/`, `app/Views/`, `App\Models\` (CI4-style) | **Dua generasi berdampingan.** Roadmap non-modul masih memakai path CI3 (`application/controllers/`), sedangkan `Items.php` dan action bar memakai CI4. |
| 17 | Lokasi sandbox | `z:/san_29agus`, `z:/san_9agus_json`, `z:/san_sarana_7jul`, `z:/san_ibb_2jul`, `w:/san_ibb_2jul` | - | Lima workspace berbeda pada dokumen yang sama. Wajibinventaris mana yang canonical. |
| 18 |mysql/MongoDB CLI | Deskripsi: "insert ke MySQL/MongoDB" | Kode hanya MySQL (`transaksi`, `transaksi_values`, `transaksi_data`) | **Dokumentasi usang.** Klaim MongoDB tidak didukung kode. |
| 19 | Auto-Validation | Tabel pemetaan: kolom `auto_validation` = `YES` | Kode `Cli.php`: tidak ada insert kolom tersebut | **Kontrak parameter tidak lengkap.** |
| 20 | Jumlah "non-module controller" | Judul: "ALL 11 NON-MODULE CONTROLLERS" | Checklist memuat `modules/addons/controllers/Qr.php` (controller modul) | **Klaim tidak presisi.** Byte aktual: 10 controller non-modul + 1 controller modul. |
| 21 | Open Questions | Versi 1: 2 pertanyaan (prioritas modul + kesiapan ORM/Active Record) | Versi 2: 1 pertanyaan (prioritas modul saja) | **Pertanyaan ORM hilang.** Konfirmasi apakah sudah terjawab. |
| 22 | Deduplikasi pivot sales | Aturan: `GROUP BY transaksi_id, jenis, rekening` dengan `MAX()` | Query A: `GROUP BY transaksi_id, thn, seller_nama` tanpa `jenis` | **Aturan dan implementasi tidak identik.** Karena query sudah memfilter `rekening IN (SO)`, hasil praktis sama; tetapi divergensi ini harus dibakukan. |
| 23 | Fungsi versi CLI | `STATUS = 11` dan `jenisTr = "sales_pre_order"` | Lifecycle pada `z_sales_salesman_cache` memakai kode rekening `582spo`/`582so`/`582spd`/`7499` | **Dua taksonomi status** (kode numerik transaksi vs kode rekening pivot). Perlu tabel konversi resmi sebelum laporan sales dan CLI disatukan. |
| 24 | Skema tabel pivot | `harga_netto` = `harga_bruto - diskon_nilai` | `harga_nppn` = `harga_netto + ppn_nilai` | Konsisten, tetapi `ppn_nilai` sudah termasuk dalam `harga_nppn` - beware double count bila `SUM(harga_netto)` dan `SUM(harga_nppn)` dijumlahkan bersama. |
| 25 | Target versi mariabackup | `mariabackup` | Nama fungsi C++ `xb_fil_cur_read` dan file `xtrabackup_binlog_info` | Nama internal warisan XtraBackup; normal di build MariaDB 10.3. Tidak konflik, tapi perlu dicatat agar tidak mencari paket `xtrabackup`. |

---

## 11. Lampiran: Daftar File Sumber

| Nama File | Ukuran (byte) | Topik H1 | Peran |
|---|---:|---|---|
| `mariadb-hot-backup-mirror.md` | 2852 | MariaDB Mirror Tanpa Downtime Source (mariabackup) | Definisi metode tahap 2: online `mariabackup` di source, `prepare` di source, tarik via SSH, restore lokal. Menyediakan user `backup`@`127.0.0.1`, `/etc/my.cnf.d/mariabackup.cnf`, deploy skrip, cron 01:00/01:40, larangan `rsync` datadir live. |
| `mariadb-replication-primary-replica.md` | 3813 | MariaDB 10.3 Primary-Replica (Tanpa Backup Harian di Source) | Definisi **arsitektur replikasi mutakhir**: topologi `192.168.61.1` -> `192.168.5.17`, konfigurasi `server_id`/`log_bin`/`read_only`, skrip prepare & bootstrap, jalur manual seed via `mbstream` + `--copy-back`, `CHANGE MASTER TO`, checklist `SHOW SLAVE STATUS`, 5 kontrol operasional produksi. |
| `DOKUMENTASI_PERBAIKAN_MARIABACKUP_REPLICA_GFS.md` | 6372 | Dokumentasi Teknis Perbaikan MariaBackup GFS (Replica Database Direct to Windows Vault) | **Acuan operasional backup mutakhir** (31 Agustus 2026, Production Ready): root cause exit 134 pada `run_sumber_boga_modul.transaksi_realtimepos` 7,0 GB, arsitektur Zero-Write Replica Protection, `trap cleanup EXIT INT TERM HUP`, flag `--slave-info`/`--safe-slave-backup`/`--lock-ddl-per-table`, `${PIPESTATUS}`, sanitasi Telegram, `ensure_vault_mounted` CIFS, jadwal GFS, pembersihan binlog yatim. |
| `runbook_performance_reusable_san_staging.md` | 4461 | Runbook Reusable Optimasi Performa Modul (san_staging) | Standar operasional performa generik: guardrails `MdlTransaksi`/`MdlMother`, input wajib, 6 tahap A-F, perintah `verify_followup_authenticated.ps1` 5 run, checklist 11 item, format laporan, batasan, dan **registry 58 direktori modul san_staging**. |
| `runbook_performance_template_isi_otomatis.md` | 3716 | Runbook Performance (Template Isi Otomatis) - SAN Staging | Template 11 seksi untuk duplikasi per modul: metadata (PHP 5.6, CI3, `GET`), guardrail wajib, scope investigasi, tabel baseline 5 run dengan rata-rata/P95/worst, checklist root cause (query N+1, missing index, cache request), rencana Quick Win/Structural Fix/Safety, log revisi, verifikasi `php -l`, verifikasi E2E, hasil akhir, approval, dan cara pakai cepat `docs/runbook_perf_pembelian_followup_YYYYMMDD.md`. |
| `KATALOG_PERFORMANCE_PLAN.md` | 5256 | Rencana Perbaikan Kinerja Katalog Produk | Rencana dua metode untuk `Katalog/viewProduk` mode `KatalogGudang`: QW-01..QW-06 (target 1 hari) dan SYS-01..SYS-07 (1-2 sprint, feature flag `katalog_v2`); SLA p95 -30% dan -60%; Trace Board master 13 task; log harian 2026-05-28 dengan `profile_katalog=1` dan `KATALOG_PROFILE`; Definition of Done. |
| `KATALOG_PRE_POST_CHECKLIST.md` | 3938 | KATALOG Quick Win - Pre/Post Compare Checklist | Bukti ukur before/after `/Katalog/viewProduk?profile_katalog=1`: baseline `total_ms` 4814,68 dan 15 step timing, 10 counter, 6 step sesudah, delta per blok, delta vs Tahap-2, checklist contract data/rule bisnis/20 sampel/UI, keputusan Go/No-Go. |
| `SERVER_SIDE_MAPPING_KATALOG.md` | 4925 | SERVER_SIDE_MAPPING_KATALOG | Acuan migrasi DataTable server-side: 14 model + tabel + filter (`_rek_pembantu_produk_cache`, `price`, `stock_locker`, `images`, `rek_cache_persediaan_produk_fifo`), 4 rule bisnis wajib, 5 struktur data turunan (`dataParents`, `dataChilds`, `sumStokCabang`, `cabang`, `gudangData`), parameter request, 5 komponen UI dengan endpoint, 9-item parity checklist, 3 risiko migrasi. |
| `items_controller.md` | 12526 | Dokumentasi: Controller `Items.php` | Dokumentasi lengkap controller generik CI4 `app/Controllers/Items.php`: dynamic model via `url_segment(3)` + `ucwords()` + `class_exists()`, kontrak 5 method model wajib + 3 opsional, struktur `getFields()`, 10 method public dengan URL dan parameter, 5 method private (`_get_fields`, `_make_item_row`, `_sync_items_data`, `_sync_clients_data`, `_resolve_postal_location_ids`), 3 dropdown helper, tabel kontrol akses, header import Excel, diagram alur, catatandebug method dan peringatan namespace. |
| `json_migration_reference.md` | 5628 | Panduan Baku Refaktor Migrasi JSON Data Registry (Acuan Antar Modul) | **Acuan baku migrasi blob -> JSON**: 3 tabel (`transaksi_data_registry`, `transaksi_data_json`, `transaksi_registry`), tabel 7 shadow method (`writeDataRegistriesJson`, `updateDataRegistryJson`, `lookupDataRegistriesJsonByMasterID`, `lookupDataRegistriesJson`, `lookupDataRegistriesJson_joined`, `lookupBaseDataRegistriesJson`, `lookupTransaksiDataRegistriesJson`), aturan decoding + pengecualian `counters`/`ids_his`, 3 langkah find-replace, 3 contoh kode before/after. |
| `module_migration_checklist.md` | 3348 | Checklist Status Migrasi JSON Data Registry Antar Modul | Status tracking 22 modul: 4 selesai UAT (pembelian, pembelianprojek, pembelianjasa, pembatalan), 1 sebagian (penjualan), 17 belum. Target berikutnya `penjualan` di `z:/san_9agus_json/application/modules/penjualan/` dengan 3 file tersisa. |
| `cli_implementation_plan.md` | 13404 | Rencana Implementasi & Dokumentasi CLI Controller Murni (Tanpa $_SESSION) | Rancangan `Cli.php` lengkap (`MX_Controller`, guard `is_cli_request()`, `$jenisTr = "sales_pre_order"`), 5 langkah `process_crm_to_order($estimate_id, $operator_id, $json_options)`, query CRM + fallback harga `price`, transaksi `writeMainEntries` + `transaksi_values` + `transaksi_data`, dan tabel pemetaan 11 parameter CLI ke kolom database. |
| `implementation_plan.md` | 5005 | Rencana Migrasi Arsitektur: Monolithic ke Modular Monolith | Versi 1 rencana Strangler Fig untuk `san_30mar` -> pola `san_tsa_28agu`: 5 fase (1 Bulan 1 persiapan, 2 Bulan 2 pilot Pembelian, 3 Bulan 2-3 dual-write + backfill, 4 cut-over + storage recovery, 5 Bulan 4-12 iterasi 45+ modul), 2 open questions (prioritas modul + ORM/Active Record), verification plan (data integrity checker, dry run staging per divisi). |
| `implementation_plan_database_cutoff_gemini po high.md` | 6981 | Rencana Migrasi Arsitektur: Monolithic ke Modular Monolith | Versi 2 dari rencana yang sama, lebih rinci: 5 langkah Fase 1 (termasuk `MdlMother` sebagai adapter `insert()`/`update()`), Fase 2 dengan normalisasi detail ke `pembelian_transaksi_detail`, `MdlPembelianTransaksi` extends `MdlMother`, Fase 3 dual-write di `MdlMother`, Fase 4 dengan perintah eksplisit `DELETE FROM transaksi_data_registry WHERE jenis = 'pembelian'`, Fase 5 dengan 49 modul dan `DROP TABLE`. |
| `implementation_plan_non_reload.md` | 7135 | Implementation Plan: Refresh Action Bar Tanpa Reload Halaman | Rencana 4 file untuk refresh action bar `estimates` via AJAX: partial baru `estimate_action_bar.php` (ekstraksi `view.php` L187-461), wrapper `#estimate-action-bar-wrapper`, method baru `Estimates::get_action_bar()`, fungsi JS global `refreshEstimateActionBar()`, 4 titik pemicu di `details.php`/`view.php` L829, plus verification plan 4 skenario. |
| `roadmap-non-module-controllers.md` | 3582 | Roadmap & Penanganan Controller di Luar Modul (Non-Module Controllers) | Status 11 controller non-modul selesai 2026-07-27 oleh Agent 7: 6 temuan empiris (badge varian `badge bg-blue`, fallback SKU varian di `Katalog.php`, `generate_or_update_variants` di `Data.php`, QR `doPrint()`, `hargaProduk` di `Spread.php`, `viewMovementGroup()` + `ComLockerStockDualWrite` di `Ledger.php`), checklist 11 item, verifikasi `php -l` dan log `192.168.5.10` 0 errors. |
| `application_2.md` | 6775 | My Symfony application v1.0 | Dokumentasi output CLI Symfony (Referensi teknis untuk pola CLI): command `help`, `list`, `descriptor:command1` (dengan alias `alias1`, `alias2`), `descriptor:command2` (argumen wajib + option), `descriptor:command4` (alias), beserta tabel argumen dan 10 option global (`--format`, `--raw`, `--help`, `--quiet`, `--verbose`, `--version`, `--ansi`, `--no-ansi`, `--no-interaction`). Menegaskan bahwa argumen dan option harus punya `Is required`, `Is array`, `Default` yang eksplisit. |
| `application_mbstring.md` | 4220 | MbString application | Uji regresi encoding mbstring/UTF-8 pada layer CLI: judul non-ASCII pada aplikasi uji (termojibake) dan command non-ASCII beserta argumen/option non-ASCII terbukti terbaca utuh, sementara nama option di usage baris(`<argument_name>`) masih hardcoded ASCII - temuan inkonsistensi label. Relevan untuk `z_sales_salesman_cache` yang memuat `seller_nama` dan `customer_nama` ber- spasi akhir. |
| `access-method-gap-to-sap-style.md` | 8677 | Perbedaan Metode Hak Akses Saat Ini vs SAP-Style | Analisis gap otorisasi: 5 komponen mekanisme saat ini (`$_SESSION['login']` membership, `set_menu`, `set_menu_manufactur`, `set_access_kolom`, `heTransaksi_ui` dengan `placeCanMakeTrans`/`placeCanFollowupTrans`/`has_access_kolom`), target SAP-style, tabel 7 aspek gap, 5 area dampak bisnis, 7 tabel auth baru, adapter layer, 5 fase transisi, 3 contoh mapping object/action/context, tabel 5 risiko + mitigasi, 5 kriteria sukses, dan 4 keputusan yang disarankan. |
| `z_sales_salesman_cache_analysis.md` | 17061 | Analisis Tabel Database `z_sales_salesman_cache` & Formula Laporan Pivot Sales | Analisis read-model untuk laporan pivot sales pada `san_13mar`: karakteristik `z_sales_salesman_cache` (18.525 baris, 8.111 transaksi unik, 2021-01-04 s/d 2026-03-12), 12 kolom pivot, tabel detail `z_sales_pembantu_cache` (69.015 baris), gotcha literal duplicate rows dan solusinya, taksonomi lifecycle `rekening` (SPO/SO/SPD/7499), 4 query pivot lengkap, 2 pendekatan pivot dinamis (flat SQL + PHP dengan `number_format`; dynamic SQL dengan `GROUP_CONCAT` + `PREPARE`), dan 5 analisis lanjutan (RFM, SLA lead time, market basket, Pareto 80/20, churn). |

**Total: 20 file sumber, 129.675 byte.**
