# BLUEPRINT PENYETARAAN MULTI-SUBSIDIARY (FASE 1: DISCOVERY & GAP ANALYSIS)

- **Tanggal Audit:** 18 November 2026
- **Target Lingkungan:** PHP 5.6, CodeIgniter 3 (HMVC), MariaDB 10
- **Cakupan Subsidiary:** `san_add`, `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa`

---

## 1. Ringkasan Statistik Pemindaian Struktur Direktori

Pemindaian dilakukan dengan normalisasi *line-ending* (`CRLF` vs `LF`) untuk memisahkan perbedaan murni konten/logika dari perbedaan format sistem operasi:

| Direktori / Kategori | Total Path Unik | Identik di 5 Subsidiary | Hanya Ada di Sebagian (*Partial*) | Ada di 5 Subsidiary namun Berbeda |
| :--- | :---: | :---: | :---: | :---: |
| `application/controllers` | 119 | 106 | 7 *(file backup/trash)* | 6 |
| `application/models` | 1.000 | 993 | 2 | 5 |
| `application/views` | 59 | 58 | 0 | 1 |
| `application/libraries` | 448 | 445 | 1 | 2 |
| `application/helpers` | 70 | 65 | 0 | 5 |
| `application/config` | 45 | 38 | 1 *(file backup)* | 6 |
| `application/modules` (HMVC) | 6.099 | 5.618 | 428 *(10 file aktif, 418 trash/old)* | 53 *(36 file aktif, 17 trash)* |
| `application/template` | 73 | 72 | 0 | 1 |
| `application/third_party`, `core`, `hooks`, `cli`, `language` | 21 | 21 | 0 | 0 |
| `assets` | 87 | 78 | 7 *(6 logo cabang, 1 JS)* | 2 *(1 logo, 1 JS)* |
| `vendor` | 1.901 | 1.901 | 0 | 0 |

---

## 2. Matriks 1: File & Fitur yang Hanya Ada di Sebagian Subsidiary (*Partial Presence*)

Setelah mengeliminasi direktori sampah/arsip (`trash/`, `laporan_old/`, `inputstokunit_ori/`, file `.bak`, dan `.rar`), terdapat **11 file fungsional aktif** yang hanya ada di sebagian subsidiary:

| No | Modul / Kategori | Path File Relatif | Keberadaan Saat Ini | Absen Di | Analisis Teknis & Fungsi |
| :-: | :--- | :--- | :--- | :--- | :--- |
| 1 | **Laporan Penjualan Matrix (DDD)** | `application/libraries/laporan/MonthlyMatrixFormatter.php` | `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa` | `san_add` | Service layer pemformat matriks 12 bulan *side-by-side* (Tahun Lalu vs Tahun Berjalan). Kompatibel PHP 5.6. |
| 2 | **Laporan Penjualan Matrix (DDD)** | `application/modules/laporan/template/laporan_penjualan_kompare.html` | `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa` | `san_add` | Template shell halaman laporan perbandingan order penjualan per salesman. |
| 3 | **Laporan Penjualan Matrix (DDD)** | `application/modules/laporan/views/laporan_penjualan_matrix.php` | `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa` | `san_add` | View tabel DataTables matriks penjualan bulanan *side-by-side*. |
| 4 | **Laporan Penjualan Matrix (DDD)** | `application/modules/laporan/views/modal_detail_transaksi_seller.php` | `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa` | `san_add` | View modal *drill-down* detail transaksi per salesman. |
| 5 | **Penjualan - Close/Fulfillment SO (`19822`)** | `application/modules/penjualan/models/Mdls/MdlPenjualanTransaksiData.php` | `san_sarana` | `san_add`, `san_ppu`, `san_sdl`, `san_tsa` | Model *lookup* transaksi penjualan yang dipanggil oleh `receiptElements` (`transaksiDatas`) pada konfigurasi transaksi `19822` di `penjualan/config/coTransaksiUi.php`. |
| 6 | **Penerimaan - Komponen Pembayaran** | `application/modules/penerimaan/models/Coms/ComRekeningPembantuTransaksiPembayaran.php` | `san_sarana`, `san_sdl`, `san_tsa` | `san_add`, `san_ppu` | Model komponen mutasi `pembayaran_pembantu_transaksi_cache` untuk eksekusi `loadByModules => true` di modul `penerimaan` (identik dengan versi di `pembayaran/models/Coms/`). |
| 7 | **Penerimaan - Komponen Pembayaran** | `application/modules/penerimaan/models/Coms/ComRekeningTransaksiDataPembayaran.php` | `san_sarana`, `san_sdl`, `san_tsa` | `san_add`, `san_ppu` | Model komponen mutasi rekening data pembayaran di modul `penerimaan`. |
| 8 | **Penerimaan - Komponen Pembayaran** | `application/modules/penerimaan/models/Coms/ComRekeningTransaksiDataPembayaranCache.php` | `san_sarana`, `san_sdl`, `san_tsa` | `san_add`, `san_ppu` | Model komponen cache data pembayaran di modul `penerimaan`. |
| 9 | **Penerimaan - Komponen Pembayaran** | `application/modules/penerimaan/models/Coms/ComTransaksiDataPembayaran.php` | `san_sarana`, `san_sdl`, `san_tsa` | `san_add`, `san_ppu` | Model komponen update data transaksi pembayaran di modul `penerimaan`. |
| 10 | **Statik - Modal Hak Akses Employee** | `application/modules/statik/views/form_employee_permission_body.php` | `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa` | `san_add` | View *server-side rendering* tabel hak akses employee (3 tab + badge counter + tombol *copy login ID* di `san_sarana`). |
| 11 | **Model Produk (Eksperimen/Orphan)** | `application/models/Mdls/MdlProdukDeltaSync.php` | `san_add`, `san_ppu` | `san_sarana`, `san_sdl`, `san_tsa` | **File Orphan/Berbahaya:** Mendeklarasikan `class MdlProduk extends MdlMother` (nama class bentrok dengan `MdlProduk.php`), 0 referensi di seluruh codebase, dan berisi logika *hash sync* lama sebelum digantikan fitur *Self-Healing DC* di `MdlProduk.php`. |

---

## 3. Matriks 2: Perbedaan Logika Signifikan pada File yang Ada di Kelima Subsidiary

Dari seluruh file yang memiliki perbedaan hash di kelima subsidiary, setelah dilakukan *semantic & token-level diff* (mengabaikan perbedaan spasi/indentasi/baris kosong), berikut adalah matriks perbedaan logika yang ditemukan:

### A. Perbedaan Fungsional, Fitur Baru, dan Bugfix

| No | Modul / Fitur | File yang Berbeda | Perbandingan Varian & Analisis Logika |
| :-: | :--- | :--- | :--- |
| 1 | **Penjualan: Close / Fulfillment Sales Order (`19822` & `19822g`) & Multi-Table Registry** | - `application/config/heTransaksi_ui.php`<br>- `application/config/heTransaksi_misc.php`<br>- `application/libraries/CounterNumber.php`<br>- `application/helpers/he_accounting_helper.php`<br>- `application/modules/penjualan/config/coTransaksiCore.php`<br>- `application/modules/penjualan/config/coTransaksiLayout.php`<br>- `application/modules/penjualan/config/coTransaksiUi.php`<br>- `application/modules/penjualan/controllers/Create.php`<br>- `application/modules/penjualan/controllers/FollowUp.php` | - **`san_sarana` (Paling Maju namun Mengandung Bug Debug):** Telah mengimplementasikan konfigurasi penuh transaksi `19822`/`19822g`, `postProcessor`, perbaikan nama tabel `penjualan_transaksi` & `penjualan_transaksi_data` (menggantikan `transaksi` & `transaksi_data` yang error SQL), memperbaiki typo filter `qty-saldo>0` dan `qty_saldi>0` menjadi `qty_saldo>0`, serta menyesuaikan pembacaan/penulisan registry dengan struktur multi-tabel (`main_entries`, `items`..`items10_sum`) sesuai `MdlPenjualanTransaksi::lookUpDataRegistries()`.<br>- **Cacat di `san_sarana` yang Wajib Diperbaiki Saat Merge:**<br>  1. Di `FollowUp.php:L11481`, validasi hak akses grup (`allowedGroups`) untuk tombol `xShipmentConfig` di-comment dan di-hardcode `$allowed = true;` (*authorization bypass*).<br>  2. Di `FollowUp.php:L5647 & L5653`, kondisi `if` memeriksa `$_SESSION[$cCode]['items6_sum']` dan `items7`, tetapi `foreach` me-loop `$_SESSION[$cCode]['tableIn_items6_sum']` dan `tableIn_items7` (*undefined index bug*).<br>  3. Banyak fungsi debug (`arrPrint($dSpec)`, `cekBiru`, `cekUngu`, `cekMErah`, `cekLime`) masih aktif di `Create.php` dan `FollowUp.php`.<br>  4. Di `Create.php`, penyimpanan `$tr->writeDataRegistries($insertID, $baseRegistries)` dihapus saat diganti `writeDetailMainEntries`/`writeDetailItemsEntries`, padahal idealnya keduanya atau struktur tabel modul dijaga konsisten. |
| 2 | **Laporan: PenjualanCompare (DDD Refactoring)** | - `application/modules/laporan/controllers/PenjualanCompare.php` | - **`san_ppu`, `san_sarana`, `san_sdl`, `san_tsa`:** Sudah di-refactor ke arsitektur DDD (441 baris) menggunakan `MdlRawPenjualan`, `MonthlyMatrixFormatter`, dan template `laporan_penjualan_kompare.html` dengan filter tahun & status gudang (Semua/Domestik/Export).<br>- **`san_add`:** Masih menggunakan controller monolitik lama (1.840 baris) dengan tahun *hardcoded* `$req_thn = "2022"` dan view `laporan_compare`. |
| 3 | **Statik & Master Employee: Validasi Username AJAX & Modal Permission** | - `application/models/Mdls/MdlEmployee.php`<br>- `application/modules/statik/controllers/Setting.php`<br>- `application/modules/statik/views/setting.php`<br>- `application/modules/statik/views/form_employee_permission_access.php`<br>- `application/modules/statik/views/form_employee_permission_body.php` | - **`MdlEmployee.php`:** `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa` sudah memiliki `urlTrigger => "statik/Data/cekUsernameAjax"` dan `eventTrigger` `onchange` untuk validasi ketersediaan Login ID secara *real-time* (method `cekUsernameAjax` sebenarnya sudah ada di `statik/controllers/Data.php` kelima subsidiary, namun belum terpasang di `MdlEmployee.php` milik `san_add`).<br>- **`Setting.php` & `form_employee_permission_body.php`:** `san_sarana` paling lengkap karena mengirimkan `employee_login_name` dan memiliki fitur *click-to-copy* ID Login (`@nama_login`) dengan *fallback* clipboard.<br>- **`setting.php` & `form_employee_permission_access.php`:** `san_ppu` dan `san_sarana` sudah merapikan fungsi JS `showEmployeePermission()` menggunakan `top.BootstrapDialog.show` (`employee_permission_view`), sedangkan `san_add` masih memanggil `#employeePermissionModal` lama di `setting.php` (meskipun di `data.php` sudah memakai `BootstrapDialog`). |
| 4 | **Penjualan & Pembelian: Integrasi `LockerTransaksi` & CRM Lock** | - `application/modules/penjualan/controllers/_shoppingCart.php`<br>- `application/modules/pembelian/controllers/Create_total.php`<br>- `application/libraries/Transaksional.php` | - **`_shoppingCart.php` (`reset`):** `san_add` dan `san_sdl` sudah menggunakan library `LockerTransaksi` (`inspectTransaksi` & `releaseTransaksiCrm` dalam transaksi DB). Sebaliknya `san_ppu`, `san_sarana`, `san_tsa` masih memakai `MdlLockerTransaksi` langsung dan mengakses `$ltTmp[0]->oleh_id` tanpa cek `count($ltTmp) > 0` (berisiko *fatal/notice error* saat array kosong).<br>- **`pembelian/controllers/Create_total.php`:** `san_ppu` sudah memisahkan method `syncLockerTransaksi()` dengan library `LockerTransaksi`, sedangkan 4 subsidiary lain masih memanggil `MdlLockerTransaksi->execLocker()` secara langsung.<br>- **`Transaksional.php`:** `san_sarana` dan `san_sdl` memiliki method tambahan `callCrmAutoSalesOrder()`. |
| 5 | **Penjualan & Distribusi: Cetakan (`Printing.php`, `printing_san.php`) & E-Signature** | - `application/modules/penjualan/controllers/Printing.php`<br>- `application/modules/penjualan/views/printing_san.php`<br>- `application/modules/distribusifg_non_paket/views/printing.php`<br>- `application/modules/distribusi/controllers/FollowUp.php`<br>- `application/modules/distribusi/controllers/anu.php` | - **`penjualan/controllers/Printing.php`:**<br>  1. `san_add`, `san_ppu`, `san_sdl` memiliki bugfix lookup `produk_nama`, `produk_kode`, dan `no_part` dari tabel `produk` (edited by glg 2025-01-21) yang **hilang** di `san_sarana` dan `san_tsa`.<br>  2. `san_add`, `san_ppu`, `san_sdl`, `san_tsa` memiliki bug `arrPrint($fixedElements);` yang belum di-comment pada baris 4482 (di `san_sarana` sudah di-comment).<br>  3. `san_sarana` men-comment `"companyProfile" => $arrCompanyProfile` pada baris 4816 sehingga profil perusahaan tidak terkirim ke view `printing`.<br>- **`printing_san.php` & `distribusifg_non_paket/views/printing.php`:**Fitur `render_esignature_img(...)` sudah diterapkan di 4 subsidiary, namun **hilang** di `san_sarana` (pada `penjualan/views/printing_san.php`) dan **hilang** di `san_sdl` (pada `distribusifg_non_paket/views/printing.php`).<br>- **`distribusi/controllers/FollowUp.php`:** `san_add`, `san_sdl`, `san_tsa` sudah memakai struktur `$elementMerge = $repv_element + $aSpec + blobDecode($aSpec["contents"])` pada `writeMainElements`, sedangkan `san_ppu` dan `san_sarana` masih memakai array statis lama (namun terbalik di `anu.php`). |
| 6 | **Kebocoran Debug (`mati_disini`, `matiHEre`, `arrPrint`) & UI Modal** | - `application/controllers/CliTransaksi.php`<br>- `application/modules/penjualan/controllers/Transaksi.php`<br>- `application/modules/penjualan/controllers/Create.php`<br>- `application/modules/penjualan/controllers/_processSelectProduct.php`<br>- `application/modules/pembelian/models/Coms/ComTransaksiDataPembelian.php`<br>- `application/modules/penjualan/template/history.html`<br>- `application/modules/penjualan/template/transaksi_index.html`<br>- `assets/custom/JS.js` | - **`CliTransaksi.php:L359` (`san_ppu`):** `mati_disini("BELUM COMMIT MODE DEBUG, AUTO PO BERHASIL...");` masih aktif (tidak di-comment), menyebabkan cron Auto-PO berhenti sebelum commit di `san_ppu`.<br>- **`penjualan/controllers/Transaksi.php:L4028 & L4053` (`san_sarana`):** `arrPrint($liststep);` aktif (bocor di UI), namun memiliki tambahan filter bagus `$tr->addFilter($activeTabel["main"] . ".jenis_master='" . $jenisTr . "'");`.<br>- **`penjualan/controllers/Create.php:L18076`:** `matiHEre(__LINE__);` aktif sebelum `mati_disini_original($xxx);` di `san_add`, `san_ppu`, `san_sarana`, `san_sdl` (sudah diperbaiki/di-comment di `san_tsa`).<br>- **`penjualan/controllers/_processSelectProduct.php:L5814` (`san_sarana`):** Mengubah `if ($item_jenis == "item_komposit")` menjadi `if ($item_jenis == "paket")`, dan di baris 5821 terdapat typo query `$kk->addFilter("produk_id=$pid'");` (tanda petik tunggal tidak berpasangan di kelima subsidiary!).<br>- **`ComTransaksiDataPembelian.php:L260`:** `cekBiru($this->db->last_query());` aktif di `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa` (di-comment di `san_add`).<br>- **`penjualan/template/history.html` & `transaksi_index.html`:** Typo class Bootstrap `hhidden-xs` / `hhidden-sm` (di `san_sdl` `transaksi_index.html` sudah diperbaiki menjadi `hidden-sm hidden-xs`, dan di `san_add`/`san_ppu`/`san_sdl`/`san_tsa` `history.html` sudah `hidden-xs`).<br>- **`assets/custom/JS.js:L638` (`san_ppu`):** Mengubah modal `backdrop: 'static', keyboard: false` agar modal tidak tertutup tidak sengaja. |

### B. File yang Berbeda Hanya Karena Konfigurasi Cabang / Whitespace (Tidak Mengandung Perbedaan Logika Bisnis)

1. **Konfigurasi Unik Subsidiary (WAJIB DIPERTAHANKAN / DILARANG DITIMPA):**
   - `application/config/database.php` (berbeda nama database: `run_san_add`, `run_san_ppu`, `run_san_sarana`, `run_san_sdl`, `run_san_tsa`).
   - `application/helpers/he_url_helper.php` (berbeda konstanta `ADM_LOCAL_DOMAIN` per cabang; catatan: `local_version()` di `san_ppu` bernilai `"1.0101.2026.Corp"`, sedangkan di 4 cabang lain `"1.0101.2022.Corp"`).
   - `application/controllers/_tray.php` (berbeda path log `/var/www/san_[cabang]/logs/profile.txt`).
   - `index.php` (hanya berbeda *comment/uncomment* IP lokal `192.168.5.1` / `192.168.5.3` pada array `$arrIp`).
   - `favicon.ico`, `public/images/profiles/*`, `assets/images/*` (logo dan ikon identitas masing-masing subsidiary).
2. **File yang Identik di Kelima Subsidiary:**
   - `application/config/autoload.php` (100% identik di 5 subsidiary).
   - `application/config/routes.php` (100% identik di 5 subsidiary).
   - `application/config/config.php` (100% identik di 5 subsidiary, menggunakan `$_SERVER['HTTP_HOST']` dinamis).
3. **File yang Berbeda Murni karena Whitespace / Formatting / Komentar:**
   - `application/controllers/Welcome.php`, `application/controllers/RunRugilaba.php`, `application/controllers/eusvc/Customers.php`, `application/controllers/eusvc/Webhook.php`
   - `application/models/MdlTransaksiCrm.php`, `application/models/Mdls/MdlCompany.php`, `application/models/Mdls/MdlCustomer.php`, `application/models/Mdls/MdlProduk.php`
   - `application/views/welcome.php`, `application/template/home.html`
   - `application/helpers/he_access_right_helper.php`, `application/helpers/he_menu_helper.php`, `application/helpers/he_misc_helper.php`
   - `application/config/heDataBehaviour.php`, `application/config/heTransaksi_layout.php`, `application/config/heWebs.php`
   - `application/modules/distribusi/controllers/Printing.php`
   - `application/modules/pembelian/controllers/API/ModulConnect.php`, `application/modules/pembelian/controllers/CliTransaksi.php`, `application/modules/pembelian/models/Coms/ComTransaksiDataPembelianBridging.php`, `application/modules/pembelian/views/transaksi.php`
   - `application/modules/penerimaan/config/coTransaksiCore.php`
   - `application/modules/penjualan/controllers/API/ModulConnect.php`, `application/modules/penjualan/models/Coms/ComTransaksiDataPenjualanBridging.php`, `application/modules/penjualan/models/MdlPenjualanTransaksi.php`, `application/modules/penjualan/views/history.php`, `application/modules/penjualan/views/printing.php`, `application/modules/penjualan/views/transaksi.php`
   - `application/modules/statik/controllers/Data.php`, `application/modules/statik/views/data.php`
   - `application/modules/tools/controllers/ResetorTransaksi.php`, `application/modules/tools/controllers/Tool.php`

---

## 4. Audit Kompatibilitas PHP 5.6 & Temuan *Hardcoded ID*

### A. Pelanggaran / Risiko Kompatibilitas PHP 5.6
1. **`catch (\Throwable $e)` Tanpa `catch (Exception $e)`:**
   - **Lokasi:** `application/modules/penjualan/controllers/CustomerApprovalApi.php` (baris 566, method `approveBatchPendingCustomers`) di kelima subsidiary.
   - **Risiko di PHP 5.6:** Interface `\Throwable` baru diperkenalkan di PHP 7.0. Di PHP 5.6, class `Exception` **tidak** mengimplementasikan `\Throwable`. Akibatnya, setiap `Exception` yang dilempar di dalam blok `try` tidak akan tertangkap oleh `catch (\Throwable $e)` dan menyebabkan *Uncaught Exception Fatal Error*. Wajib ditambahkan/diubah menjadi `catch (Exception $e)`.

### B. Temuan *Hardcoded ID* & Konstanta Lintas Cabang
1. **Konstanta `CB_ID_PUSAT` (`-1`):** Digunakan di `eusvc/Customers.php` (`$this->db->where("id <>", CB_ID_PUSAT);`) dan `penjualan/controllers/FollowUp.php`. Nilai `-1` bersifat standar sistem untuk kantor pusat di seluruh subsidiary.
2. **Hardcoded `$company = 100` di `application/libraries/CounterNumber.php` (baris 1158):** Digunakan sebagai prefix counter di kelima subsidiary.
3. **Hardcoded Rekening `1010030030` di `application/modules/tools/controllers/Tool.php` (baris 44879):** Digunakan pada tool diagnostik `$i->fetchBalances("1010030030")` (Intransit).
4. **Hardcoded Tahun `$req_thn = "2022"` di `san_add/application/modules/laporan/controllers/PenjualanCompare.php`:** Akan tereliminasi ketika `san_add` disetarakan ke versi DDD `PenjualanCompare.php` yang menggunakan tahun dinamis `dtimeNow('Y')`.
5. **Hardcoded Jenis Transaksi `1982` vs `19822` di `san_sarana/application/modules/penjualan/controllers/FollowUp.php` (baris 22788):**
   Pada pembuatan tombol `$xShipmentBtn_str`, tertulis `"targetUrl" => MODUL_PATH . $this->uri->segment(1) . "/preCancelPacking/$no/$jenisTr/1982/$currentStepNum"`. Penggunaan `1982` secara hardcoded berisiko salah sasaran apabila transaksi penjualan reguler menggunakan `19822` (seharusnya mengambil kode dari `$val['targetJenisTr']` atau konfigurasi `xShipmentConfig`).

---

## 5. Analisis Struktur Database & *Schema Drift* (MariaDB 10)

Berdasarkan analisis silang antara model-model aplikasi dan ke-5 file diff skema (`san_sarana_staging_v2_vs_run_san_[sub]_scheme_diff.sql`) yang ada di masing-masing folder:

| No | Kelompok Skema / Tabel | Status di File Diff & Kebutuhan Sinkronisasi (`_db_sync_scripts/sync_*.sql`) |
| :-: | :--- | :--- |
| 1 | **Tabel Antrean Sinkronisasi Katalog/Data Center (`sync_jobs` & `sync_migration_marker`)** | - Digunakan oleh `MdlSyncJob.php` dan `statik/controllers/Data.php`.<br>- `sync_jobs` **belum ada** di `run_san_sarana` (tercatat sebagai `CREATE TABLE` di diff `san_sarana`).<br>- `sync_migration_marker` **belum ada** di `run_san_add`, `run_san_sarana`, `run_san_sdl`.<br>- **Tindakan:** Sertakan `CREATE TABLE IF NOT EXISTS sync_jobs` dan `CREATE TABLE IF NOT EXISTS sync_migration_marker` di ke-5 script SQL. |
| 2 | **Tabel & Kolom Varian Produk (`var_*`, `fifo_avg_variant`, `stock_locker_variant`, `rek_cache_persediaan_produk_varian_fifo`, `variant_id`, `variant_sku`)** | - Terdapat 13 tabel baru terkait varian produk (`var_attributes`, `var_attribute_values`, `var_product_attributes`, `var_product_variants`, `var_product_variant_values`, `var_size_scales`, `var_size_scale_values`, `fifo_avg_variant`, `stock_locker_variant`, `stock_locker_mutasi_variant`, `penjualan_crm_variant_audit`, `penjualan_crm_variant_audit_detail`, `rek_cache_persediaan_produk_varian_fifo`).<br>- Tabel `rek_cache_persediaan_produk_varian_fifo` sudah ada di `run_san_sarana`, tetapi **belum ada** di `san_add`, `san_ppu`, `san_sdl`, `san_tsa`.<br>- Penambahan kolom `has_variants`, `variant_price_mode` pada tabel `produk`, serta kolom `variant_id` dan `variant_sku` pada tabel-tabel `distribusi_*`, `pembelian_*`, `penerimaan_*`, dan `penjualan_*` dibutuhkan di seluruh subsidiary. |
| 3 | **Tabel Modul Deviden (`deviden_*` - 40 tabel) & Log Payment Source (`transaksi_payment_source_log`)** | - Tercatat belum ada di kelima database `run_san_*` dibandingkan `san_sarana_staging_v2`.<br>- **Tindakan:** Sertakan sebagai `CREATE TABLE IF NOT EXISTS` yang idempoten. |
| 4 | **Kolom Baru pada Tabel Eksisting dari Model & Diff** | - `per_employee`: Kolom `referensi_crm_account` (`int(11) DEFAULT NULL`) digunakan di `MdlEmployee.php` & `statik/controllers/API/ModulConnect.php` -> wajib dipastikan via `ALTER TABLE per_employee ADD COLUMN IF NOT EXISTS referensi_crm_account ...`.<br>- `penjualan_transaksi_data_crm_bridge`: Penambahan kolom `last_update` (`datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP`).<br>- `pembelianjasa_transaksi_data_bridge`: Penambahan kolom `seller_dc_id` dan `seller_dc_nama`.<br>- `pembelianjasa_transaksi_data_items`, `pembelianjasa_transaksi_data_items9_sum`, `penerimaan_transaksi_data_items3_sum`: Penambahan kolom `cart_key`.<br>- `distribusi_transaksi_data_main`: Penambahan kolom `trash` (`tinyint(1) DEFAULT 0`).<br>- `penjualan_transaksi_data`: Penyesuaian tipe kolom `keterangan` menjadi `TEXT NULL` (di `san_sarana` masih tipe lama) dan penambahan `variant_id`, `variant_sku`.<br>- `penjualan_transaksi_data_bridge`: Penyesuaian `seller_nama` menjadi `varchar(255) NULL` (di `san_sdl` berbeda).<br>- **Pengecualian Keamanan:** Query `ALTER TABLE resources DROP FOREIGN KEY ...` dari file diff lama **tidak boleh** dimasukkan karena melanggar aturan non-destruktif dan berisiko gagal jika constraint tidak ada. |

---

## 6. Evaluasi Kritis Arsitektur (Critical Review Mode)

1. **Trade-off & Risiko:**
   - **Risiko *Blind Copy* dari `san_sarana` pada Modul Penjualan (`19822`):** Meskipun `san_sarana` memiliki implementasi fitur *Close/Fulfillment Sales Order* (`19822`) dan *multi-table registry* paling lengkap, menyalin `FollowUp.php` dan `Create.php` milik `san_sarana` secara utuh akan membawa 3 bug serius ke seluruh cabang: (1) bypass otorisasi `$allowed = true` pada tombol `xShipmentConfig`, (2) bug variabel `$_SESSION[$cCode]['tableIn_items6_sum']` & `tableIn_items7`, dan (3) puluhan output debug `arrPrint`/`cekBiru`/`cekMErah` yang merusak response HTTP/AJAX.
   - **Risiko Schema Sync Massal:** File `san_sarana_staging_v2_vs_run_san_*_scheme_diff.sql` yang ada di root masing-masing folder dihasilkan oleh generator diff otomatis yang menggunakan sintaks non-idempoten (`CREATE TABLE` tanpa `IF NOT EXISTS`, `ALTER TABLE ... ADD COLUMN` tanpa `IF NOT EXISTS`, serta `DROP FOREIGN KEY`). Jika dijalankan langsung di produksi MariaDB 10, script tersebut akan berhenti di tengah jalan jika salah satu kolom sudah ada.

2. **Alternatif Pendekatan:**
   - **Pendekatan A (Multi-Way Surgical Merge + Idempotent SQL Transform - Direkomendasikan):** Mengambil fitur `19822` dari `san_sarana`, namun membersihkan seluruh fungsi debug, mengembalikan loop validasi `allowedGroups`, memperbaiki referensi key sesi `items6_sum`/`items7`, serta tetap mempertahankan penulisan `$tr->writeDataRegistries()` berdampingan dengan multi-table detail entries agar kompatibilitas mundur (*backward compatibility*) terjaga. Untuk SQL, mentransformasi seluruh DDL menjadi `CREATE TABLE IF NOT EXISTS` dan `ALTER TABLE ... ADD COLUMN IF NOT EXISTS` (fitur native MariaDB 10.0.2+).
   - **Pendekatan B (Selective Feature Exclusion):** Menunda penyetaraan fitur `19822` dan hanya menyetarakan fitur Laporan Matrix, Statik/Permission, LockerTransaksi, dan Printing. Pendekatan ini lebih cepat, tetapi membuat 4 subsidiary lain tetap mengalami error SQL `Unknown table 'transaksi'` dan typo `qty-saldo>0` saat melakukan *Close/Fulfillment Sales Order*.

3. **Kritik Logika / Celah yang Ditemukan:**
   - **Celah SQL Injection / Query Error di `_processSelectProduct.php:L5821`:** Di kelima subsidiary terdapat baris `$kk->addFilter("produk_id=$pid'");` (tanda petik tunggal hanya di akhir tanpa petik pembuka). Jika blok komposit/paket tersebut tereksekusi, MariaDB akan langsung melempar *SQL Syntax Error*.
   - **File Berbahaya `MdlProdukDeltaSync.php` di `san_add` & `san_ppu`:** Menyimpan class bernama `MdlProduk` di dalam file `MdlProdukDeltaSync.php`. File ini tidak boleh disebarkan ke 3 subsidiary lain dan sebaiknya tidak dipakai karena kode *Self-Healing DC* di `MdlProduk.php` utama sudah jauh lebih mutakhir dan aman.

---

*(Dokumen ini akan dilengkapi dengan Rencana Perubahan Detail per Modul pada Fase 2 setelah hasil audit Fase 1 disetujui).*


---

# FASE 2: BLUEPRINT PENYETARAAN (SYNC PLAN & GOLDEN STANDARD)

- **Tanggal Penyusunan Blueprint:** 19 November 2026
- **Strategi Merge:** Opsi 1 (*Multi-Way Surgical Merge* — menggabungkan fitur terlengkap & bugfix terbaik lintas cabang, mengeliminasi *debug leak* & *authorization bypass*, serta menjaga 100% kompatibilitas PHP 5.6).

---

## 7. Daftar Checklist Modul Eksekusi (Fase 3)

Eksekusi pada Fase 3 dilakukan secara bertahap **satu modul dalam satu waktu**:

- [x] **MODUL 1:** Laporan Penjualan Matrix Side-by-Side (DDD Refactoring) — **Selesai**
- [x] **MODUL 2:** Statik, Master Employee, & Modal Hak Akses (`BootstrapDialog` + Copy Login ID + Validasi Username AJAX) — **Selesai**
- [x] **MODUL 3:** Penerimaan, Pembelian & Integrasi `LockerTransaksi` / CLI Auto-PO — **Selesai**
- [x] **MODUL 4:** Cetakan (`Printing`), E-Signature, Distribusi Elements, & Perbaikan Kompatibilitas PHP 5.6 / UI — **Selesai**
- [x] **MODUL 5:** Penjualan Close/Fulfillment Sales Order (`19822` & `19822g`), Multi-Table Registry, & Penyetaraan Skema Varian/Deviden — **Selesai**

---

## 8. Spesifikasi "Golden Standard" & Rencana Perubahan File per Modul

### MODUL 1: Laporan Penjualan Matrix Side-by-Side (DDD Refactoring)
- **Sumber Golden Standard:** `san_ppu` / `san_sarana` / `san_sdl` / `san_tsa` (keempatnya sudah identik).
- **Rincian Logika & Bugfix:**
  - Mengganti controller monolitik lama di `san_add` (1.840 baris, tahun hardcoded `2022`) dengan arsitektur DDD (441 baris) yang menggunakan `MdlRawPenjualan`, service `MonthlyMatrixFormatter`, filter tahun dinamis 5 tahun terakhir, dan filter status gudang (Semua / Domestik / Export).
- **Matriks Aksi File per Subsidiary:**

| Path File Relatif | `san_add` | `san_ppu` | `san_sarana` | `san_sdl` | `san_tsa` |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `application/libraries/laporan/MonthlyMatrixFormatter.php` | **CREATE** | Keep | Keep | Keep | Keep |
| `application/modules/laporan/template/laporan_penjualan_kompare.html` | **CREATE** | Keep | Keep | Keep | Keep |
| `application/modules/laporan/views/laporan_penjualan_matrix.php` | **CREATE** | Keep | Keep | Keep | Keep |
| `application/modules/laporan/views/modal_detail_transaksi_seller.php` | **CREATE** | Keep | Keep | Keep | Keep |
| `application/modules/laporan/controllers/PenjualanCompare.php` | **MERGE/UPDATE** | Keep | Keep | Keep | Keep |

- **Perubahan Skema Database:** Tidak ada penambahan tabel/kolom khusus (menggunakan tabel eksisting pada `MdlRawPenjualan`).

---

### MODUL 2: Statik, Master Employee, & Modal Hak Akses (`BootstrapDialog` + Copy Login ID + Validasi Username AJAX)
- **Sumber Golden Standard:**
  - `MdlEmployee.php`: `san_sarana` / `san_sdl` / `san_tsa` (memiliki `urlTrigger => "statik/Data/cekUsernameAjax"` & `eventTrigger` validasi ketersediaan username secara *real-time*).
  - `statik/controllers/Setting.php` & `statik/views/form_employee_permission_body.php`: `san_sarana` (menyertakan `employee_login_name` dan fitur *click-to-copy* `@nama_login` ke clipboard beserta fallback `document.execCommand('copy')`).
  - `statik/views/setting.php` & `statik/views/form_employee_permission_access.php`: `san_ppu` / `san_sarana` (merapikan `window.showEmployeePermission` agar memuat `statik/Setting/employee_permission_view/` via `top.BootstrapDialog.show` dan menghapus dead code `#employeePermissionModal`).
- **Catatan File Diabaikan:** `application/models/Mdls/MdlProdukDeltaSync.php` di `san_add` dan `san_ppu` **tidak disalin** ke subsidiary lain sesuai keputusan audit Fase 1.
- **Matriks Aksi File per Subsidiary:**

| Path File Relatif | `san_add` | `san_ppu` | `san_sarana` | `san_sdl` | `san_tsa` |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `application/models/Mdls/MdlEmployee.php` | **MERGE** | Keep | Keep | Keep | Keep |
| `application/modules/statik/controllers/Setting.php` | **MERGE** | **MERGE** | Keep | Keep | Keep |
| `application/modules/statik/views/form_employee_permission_body.php` | **CREATE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/modules/statik/views/form_employee_permission_access.php` | **MERGE** | Keep | Keep | Keep | Keep |
| `application/modules/statik/views/setting.php` | **MERGE** | Keep | Keep | **MERGE** | **MERGE** |

- **Perubahan Skema Database (`_db_sync_scripts/sync_*.sql`):**
  - `CREATE TABLE IF NOT EXISTS sync_jobs ...` (krusial untuk `san_sarana`, ditulis idempoten di ke-5 file).
  - `CREATE TABLE IF NOT EXISTS sync_migration_marker ...` (krusial untuk `san_add`, `san_sarana`, `san_sdl`, ditulis idempoten di ke-5 file).
  - `ALTER TABLE per_employee ADD COLUMN IF NOT EXISTS referensi_crm_account int(11) NULL DEFAULT 0;` (memastikan kolom referensi CRM pada `MdlEmployee` tersedia di ke-5 database).

---

### MODUL 3: Penerimaan, Pembelian & Integrasi `LockerTransaksi` / CLI Auto-PO
- **Sumber Golden Standard:**
  - `penerimaan/models/Coms/Com*Pembayaran*.php` (4 file): `san_sarana` / `san_sdl` / `san_tsa` (dibutuhkan saat modul `penerimaan` mengeksekusi komponen pembayaran dengan `loadByModules => true`).
  - `pembelian/controllers/Create_total.php`: `san_ppu` (menggunakan wrapper `syncLockerTransaksi()` via library `LockerTransaksi`).
  - `penjualan/controllers/_shoppingCart.php`: `san_add` / `san_sdl` (menggunakan `LockerTransaksi::inspectTransaksi()` & `releaseTransaksiCrm()` di dalam transaksi DB, mencegah bug *undefined offset* `$ltTmp[0]` saat me-reset cart CRM).
  - `application/libraries/Transaksional.php`: `san_sarana` / `san_sdl` (menambahkan method `callCrmAutoSalesOrder()`, dengan menonaktifkan debug `showLast_query("biru");`).
  - `application/controllers/CliTransaksi.php`: `san_add` / `san_sarana` / `san_sdl` / `san_tsa` (men-comment `mati_disini("BELUM COMMIT MODE DEBUG, AUTO PO BERHASIL...");` yang masih aktif di `san_ppu` baris 359).
  - `pembelian/models/Coms/ComTransaksiDataPembelian.php`: `san_add` (men-comment debug `cekBiru($this->db->last_query());` pada baris 260).
- **Matriks Aksi File per Subsidiary:**

| Path File Relatif | `san_add` | `san_ppu` | `san_sarana` | `san_sdl` | `san_tsa` |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `application/modules/penerimaan/models/Coms/ComRekeningPembantuTransaksiPembayaran.php` | **CREATE** | **CREATE** | Keep | Keep | Keep |
| `application/modules/penerimaan/models/Coms/ComRekeningTransaksiDataPembayaran.php` | **CREATE** | **CREATE** | Keep | Keep | Keep |
| `application/modules/penerimaan/models/Coms/ComRekeningTransaksiDataPembayaranCache.php` | **CREATE** | **CREATE** | Keep | Keep | Keep |
| `application/modules/penerimaan/models/Coms/ComTransaksiDataPembayaran.php` | **CREATE** | **CREATE** | Keep | Keep | Keep |
| `application/modules/pembelian/controllers/Create_total.php` | **MERGE** | Keep | **MERGE** | **MERGE** | **MERGE** |
| `application/modules/penjualan/controllers/_shoppingCart.php` | Keep | **MERGE** | **MERGE** | Keep | **MERGE** |
| `application/libraries/Transaksional.php` | **MERGE** | **MERGE** | **MERGE** *(clean debug)* | **MERGE** *(clean debug)* | **MERGE** |
| `application/controllers/CliTransaksi.php` | Keep | **MERGE** | Keep | Keep | Keep |
| `application/modules/pembelian/models/Coms/ComTransaksiDataPembelian.php` | Keep | **MERGE** | **MERGE** | **MERGE** | **MERGE** |

- **Perubahan Skema Database (`_db_sync_scripts/sync_*.sql`):**
  - `CREATE TABLE IF NOT EXISTS transaksi_payment_source_log ...`
  - `ALTER TABLE pembelianjasa_transaksi_data_bridge ADD COLUMN IF NOT EXISTS seller_dc_id int(11) NULL DEFAULT 0, ADD COLUMN IF NOT EXISTS seller_dc_nama varchar(32) NULL;`
  - `ALTER TABLE pembelianjasa_transaksi_data_items ADD COLUMN IF NOT EXISTS cart_key varchar(255) NULL;`
  - `ALTER TABLE pembelianjasa_transaksi_data_items9_sum ADD COLUMN IF NOT EXISTS cart_key varchar(255) NULL;`
  - `ALTER TABLE penerimaan_transaksi_data_items3_sum ADD COLUMN IF NOT EXISTS cart_key varchar(255) NULL DEFAULT '0';`

---

### MODUL 4: Cetakan (`Printing`), E-Signature, Distribusi Elements, & Perbaikan Kompatibilitas PHP 5.6 / UI
- **Sumber Golden Standard:**
  - `penjualan/controllers/Printing.php`: Multi-way merge — mengambil blok lookup `produk_nama`, `produk_kode`, `no_part` dari `san_add`/`san_ppu`/`san_sdl` (baris 3820-3836), men-comment debug `arrPrint($fixedElements)` seperti di `san_sarana` (baris 4482), dan memastikan `"companyProfile" => $arrCompanyProfile` tetap aktif (tidak ter-comment seperti di `san_sarana` baris 4816).
  - `penjualan/views/printing_san.php`: `san_add` / `san_ppu` / `san_sdl` / `san_tsa` (menggunakan `render_esignature_img(..., "penjualan")`).
  - `distribusifg_non_paket/views/printing.php`: `san_add` / `san_ppu` / `san_sarana` / `san_tsa` (menggunakan `render_esignature_img(..., "distribusi")`).
  - `distribusi/controllers/FollowUp.php` & `distribusi/controllers/anu.php`: Penyeragaman `writeMainElements` dengan struktur `$elementMerge = $repv_element + $aSpec + blobDecode($aSpec["contents"])`.
  - `penjualan/controllers/CustomerApprovalApi.php`: Mengubah `} catch (\Throwable $e) {` pada baris 566 menjadi `} catch (Exception $e) {` agar 100% bekerja di PHP 5.6.
  - `penjualan/controllers/_processSelectProduct.php`: Mengubah baris 5814 menjadi `if ($item_jenis == "item_komposit" || $item_jenis == "paket")` dan memperbaiki bug petik tunggal pada baris 5821 menjadi `$kk->addFilter("produk_id='$pid'");`.
  - `penjualan/controllers/Transaksi.php`: Menambahkan filter `$tr->addFilter($activeTabel["main"] . ".jenis_master='" . $jenisTr . "'");` dari `san_sarana` ke 4 subsidiary lain, serta menonaktifkan debug `arrPrint($liststep);` di `san_sarana`.
  - `penjualan/template/history.html` & `penjualan/template/transaksi_index.html`: Memperbaiki typo class Bootstrap `hhidden-xs` / `hhidden-sm` menjadi `hidden-xs` / `hidden-sm`.
  - `assets/custom/JS.js`: Menyetarakan `backdrop: 'static', keyboard: false` dari `san_ppu`.
- **Matriks Aksi File per Subsidiary:**

| Path File Relatif | `san_add` | `san_ppu` | `san_sarana` | `san_sdl` | `san_tsa` |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `application/modules/penjualan/controllers/Printing.php` | **MERGE** | **MERGE** | **MERGE** | **MERGE** | **MERGE** |
| `application/modules/penjualan/views/printing_san.php` | Keep | Keep | **MERGE** | Keep | Keep |
| `application/modules/distribusifg_non_paket/views/printing.php` | Keep | Keep | Keep | **MERGE** | Keep |
| `application/modules/distribusi/controllers/FollowUp.php` | Keep | **MERGE** | **MERGE** | Keep | Keep |
| `application/modules/distribusi/controllers/anu.php` | **MERGE** | Keep | Keep | **MERGE** | **MERGE** |
| `application/modules/penjualan/controllers/CustomerApprovalApi.php` | **MERGE** | **MERGE** | **MERGE** | **MERGE** | **MERGE** |
| `application/modules/penjualan/controllers/_processSelectProduct.php` | **MERGE** | **MERGE** | **MERGE** | **MERGE** | **MERGE** |
| `application/modules/penjualan/controllers/Transaksi.php` | **MERGE** | **MERGE** | **MERGE** | **MERGE** | **MERGE** |
| `application/modules/penjualan/template/history.html` | Keep | Keep | **MERGE** | Keep | Keep |
| `application/modules/penjualan/template/transaksi_index.html` | **MERGE** | **MERGE** | **MERGE** | Keep | **MERGE** |
| `assets/custom/JS.js` | **MERGE** | Keep | **MERGE** | **MERGE** | **MERGE** |

- **Perubahan Skema Database (`_db_sync_scripts/sync_*.sql`):**
  - `ALTER TABLE distribusi_transaksi_data_main ADD COLUMN IF NOT EXISTS trash tinyint(1) NULL DEFAULT 0;`
  - `ALTER TABLE penjualan_transaksi_data_crm_bridge ADD COLUMN IF NOT EXISTS last_update datetime NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;`

---

### MODUL 5: Penjualan Close/Fulfillment Sales Order (`19822` & `19822g`), Multi-Table Registry, & Skema Varian/Deviden
- **Sumber Golden Standard:**
  - Konfigurasi & Model `19822`/`19822g` dari `san_sarana` (`heTransaksi_ui.php`, `heTransaksi_misc.php`, `CounterNumber.php`, `he_accounting_helper.php`, `penjualan/config/coTransaksiCore.php`, `coTransaksiLayout.php`, `coTransaksiUi.php`, `MdlPenjualanTransaksiData.php`).
  - `penjualan/controllers/Create.php` & `penjualan/controllers/FollowUp.php`: Multi-way surgical merge dari `san_sarana` + `san_tsa` + `san_add`:
    1. Mengambil logika `19822`/`19822g`, perbaikan nama tabel `penjualan_transaksi` & `penjualan_transaksi_data`, perbaikan typo `qty_saldo>0`, dan pembacaan/penulisan multi-table registry dari `san_sarana`.
    2. **Fix Bug 1 (`FollowUp.php`):** Mengembalikan loop validasi `allowedGroups` pada tombol `xShipmentConfig` (menghapus bypass `$allowed = true;`).
    3. **Fix Bug 2 (`FollowUp.php`):** Memperbaiki `foreach ($_SESSION[$cCode]['tableIn_items6_sum'])` menjadi `$_SESSION[$cCode]['items6_sum']` dan `tableIn_items7` menjadi `items7`.
    4. **Fix Bug 3 (`Create.php` & `FollowUp.php`):** Mematikan semua fungsi debug (`arrPrint($dSpec)`, `cekBiru`, `cekUngu`, `cekMErah`, `cekLime`), menonaktifkan `matiHEre(__LINE__);` sebelum `mati_disini_original($xxx);` di `Create.php:L18076` (seperti di `san_tsa`), dan tetap mempertahankan pemanggilan `$tr->writeDataRegistries($insertID, $baseRegistries)` bersama dengan `writeDetailMainEntries`/`writeDetailItemsEntries`.
- **Matriks Aksi File per Subsidiary:**

| Path File Relatif | `san_add` | `san_ppu` | `san_sarana` | `san_sdl` | `san_tsa` |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `application/modules/penjualan/models/Mdls/MdlPenjualanTransaksiData.php` | **CREATE** | **CREATE** | Keep | **CREATE** | **CREATE** |
| `application/config/heTransaksi_ui.php` | **MERGE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/config/heTransaksi_misc.php` | **MERGE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/libraries/CounterNumber.php` | **MERGE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/helpers/he_accounting_helper.php` | **MERGE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/modules/penjualan/config/coTransaksiCore.php` | **MERGE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/modules/penjualan/config/coTransaksiLayout.php` | **MERGE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/modules/penjualan/config/coTransaksiUi.php` | **MERGE** | **MERGE** | Keep | **MERGE** | **MERGE** |
| `application/modules/penjualan/controllers/Create.php` | **MERGE** | **MERGE** | **MERGE** *(fix debug & registry)* | **MERGE** | **MERGE** |
| `application/modules/penjualan/controllers/FollowUp.php` | **MERGE** | **MERGE** | **MERGE** *(fix auth, loop, debug)* | **MERGE** | **MERGE** |

- **Perubahan Skema Database (`_db_sync_scripts/sync_*.sql`):**
  - Penambahan 13 tabel varian produk (`CREATE TABLE IF NOT EXISTS var_attributes`, `var_attribute_values`, `var_product_attributes`, `var_product_variants`, `var_product_variant_values`, `var_size_scales`, `var_size_scale_values`, `fifo_avg_variant`, `stock_locker_variant`, `stock_locker_mutasi_variant`, `penjualan_crm_variant_audit`, `penjualan_crm_variant_audit_detail`, `rek_cache_persediaan_produk_varian_fifo`).
  - Penambahan kolom `has_variants` & `variant_price_mode` pada tabel `produk`.
  - Penambahan kolom `variant_id`, `variant_sku`, dll. (`ADD COLUMN IF NOT EXISTS`) pada 54 tabel `penjualan_*`, `pembelian_*`, `distribusi_*`, dan `penerimaan_*`.
  - Penambahan 40 tabel `deviden_*` (`CREATE TABLE IF NOT EXISTS`).

---

## 9. Rancangan Detail Script Migrasi SQL per Subsidiary (`_db_sync_scripts/`)

Seluruh file SQL di bawah ini akan dibangun secara bertahap pada Fase 3 dengan aturan ketat MariaDB 10:
- **Zero Destructive Queries:** Tanpa `DROP TABLE`, `DROP COLUMN`, `DROP FOREIGN KEY`, `TRUNCATE`, atau `DELETE`.
- **100% Idempoten:** Menggunakan `CREATE TABLE IF NOT EXISTS`, `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`, dan `CREATE INDEX IF NOT EXISTS`.

| File Target SQL | Ringkasan Cakupan DDL Idempoten |
| :--- | :--- |
| `_db_sync_scripts/sync_san_add.sql` | - **Modul 2:** `CREATE TABLE IF NOT EXISTS sync_jobs`, `sync_migration_marker`; `ALTER TABLE per_employee ADD COLUMN IF NOT EXISTS referensi_crm_account`.<br>- **Modul 3:** `CREATE TABLE IF NOT EXISTS transaksi_payment_source_log`; `ALTER TABLE` penambahan `seller_dc_id`, `seller_dc_nama`, `cart_key` pada tabel `pembelianjasa_*` & `penerimaan_*`.<br>- **Modul 4:** `ALTER TABLE` penambahan `trash` pada `distribusi_transaksi_data_main` dan `last_update` pada `penjualan_transaksi_data_crm_bridge`.<br>- **Modul 5:** `CREATE TABLE IF NOT EXISTS` untuk 13 tabel varian (termasuk `rek_cache_persediaan_produk_varian_fifo`) & 40 tabel `deviden_*`; `ALTER TABLE ADD COLUMN IF NOT EXISTS` kolom varian pada `produk`, `penjualan_*`, `pembelian_*`, `distribusi_*`, `penerimaan_*`. |
| `_db_sync_scripts/sync_san_ppu.sql` | Identik secara idempoten dengan `sync_san_add.sql` (di `run_san_ppu`, `sync_jobs` dan `sync_migration_marker` sudah ada namun tetap ditulis dengan `CREATE TABLE IF NOT EXISTS`, sedangkan `rek_cache_persediaan_produk_varian_fifo` belum ada dan akan dibuat). |
| `_db_sync_scripts/sync_san_sarana.sql` | Identik secara idempoten dengan `sync_san_add.sql`, ditambah penyesuaian spesifik `run_san_sarana` (`CREATE TABLE IF NOT EXISTS sync_jobs` & `sync_migration_marker` yang belum ada di `san_sarana`, serta `ALTER TABLE penjualan_transaksi_data MODIFY COLUMN IF EXISTS keterangan text NULL`). |
| `_db_sync_scripts/sync_san_sdl.sql` | Identik secara idempoten dengan `sync_san_add.sql`, ditambah penyesuaian spesifik `run_san_sdl` (`ALTER TABLE penjualan_transaksi_data_bridge MODIFY COLUMN IF EXISTS seller_nama varchar(255) NULL`). |
| `_db_sync_scripts/sync_san_tsa.sql` | Identik secara idempoten dengan `sync_san_add.sql` (memastikan `rek_cache_persediaan_produk_varian_fifo`, 12 tabel varian lain, 40 tabel `deviden_*`, dan seluruh kolom baru tersinkronisasi). |
