# Sintesis 16: Jurnal Pengembangan, Konteks Sesi, dan Transkrip Percakapan Lengkap

Subjudul: Rekonstruksi kronologi, keputusan teknis, dan kontinuitas pengetahuan lintas 10 dokumen workspace `san` beserta turunannya.

Dokumen ini menyatukan ulang 10 file sumber menjadi satu narasi teknis yang dapat dipakai sebagai rujukan handover. Fokusnya bukan menyalin isi berkas, melainkan merekonstruksi urutan kejadian, akar masalah, keputusan yang diambil, trade-off yang ditolak, dan gap yang masih terbuka.

Ruang lingkup yang di-cover:

1. Modul **konversi** (ERP manufacturing/conversion) dengan pipeline variant, locker dual-write, dan FIFO varian.
2. Modul **laporan penjualan** (report matrix Jan-Des) dan **dashboard** pada `san_29agus`.
3. Modul **Estimates/CRM** pada `san_ibb`: lock estimate, item custom, sprint plan enterprise.
4. **Timestamp-Based Delta Sync Produk** (holding versus cabang).
5. **Standar bahasa** sentence case pada dua language file.

## 1. Pendahuluan dan Ruang Lingkup

Kesepuluh sumber berasal dari beberapa workspace yang berubah nama dan peran sepanjang Mei hingga September 2026: `w:\san_staging`, `\\192.168.5.14\web\san_staging`, `w:\new_san_variant`, `w:\san_29agus`, `w:\san_add_29agus`, `w:\san_3sep`, `z:\san`, `w:\everest_29agus`, dan `x:\san_ibb` (termasuk snapshot `san_ibb_2jul`). Tidak ada peta workspace resmi di antara sumber, sehingga setiap entri kronologi selalu menyebut workspace tempat kejadiannya. Dua domain web juga muncul: `san.mayagrahakencana.com` (baca langsung dari `z:\san`) dan `demo.mayagrahakencana.com` (Data Center serta environment staging per-snapshot).

Metode sintesis: setiap klaim tekstual di dokumen ini ditelusuri ke entri jurnal, baris blueprint, atau nomor pesan transkrip. Angka finansial, nama berkas, nomor baris kode, dan nama method dipertahankan apa adanya. Ringkasan disusun dengan urutan kronologis, lalu dikelompokkan ulang menurut domain modul agar lebih mudah dibaca per topik.

## 2. Ringkasan Eksekutif

### 2.1 Empat garis waktu yang saling terkait

| Garis | Rentang | Workspace | Fokus |
|---|---|---|---|
| A. Konversi Variant | 2026-05-25 s/d 2026-06-26 | `w:\san_staging`, `w:\new_san_variant` | Integrasi variant ke pipeline konversi (locker dual-write, FIFO varian, selector, backfill) |
| B. Estimates/CRM | 2026-07-02 s/d 2026-07-14 | `w:\san_ibb` (`x:\san_ibb`) | Lock estimate, dropdown Group B, item custom pada penawaran |
| C. Reporting/Dashboard | 2026-09-01 s/d 2026-09-03 | `z:\san`, `w:\san_29agus`, `w:\san_3sep` | Laporan Order Penjualan (SO) bulanan, perbaikan export XLSX, live query dashboard |
| D. Sync Produk dan Bahasa | 2026-08-30 s/d tanpa tanggal | `san_29agus`, `san_add_29agus`, `x:\san_ibb` | Delta sync holding-cabang, review sentence case |

### 2.2 Temuan paling material

1. **Akar tunggal varian adalah session key.** Hampir semua bug konversi pada 2026-05-25 dan 2026-06-06 bermuara pada satu fakta: session `items` untuk produk varian memakai key `variant:{produk_id}:{variant_id}`, sedangkan kode lama mengasumsikan key = `produk_id`. Akibatnya agregasi menjadi silent (22 + 7 menjadi 29 per baris) dan `arrValidQtyReady` kosong sehingga muncul error 5049.
2. **Parent adalah aggregate.** Stok `stock_locker` (parent) harus selalu mencerminkan total seluruh `stock_locker_variant`. Co-update dibuat di 3 titik mutasi, lalu perlu hotfix tambahan karena akumulasi filter di `MdlMother::addFilter()`.
3. **Guard mutual exclusion sempat dikomentari.** Tiga guard di core pipeline (G1, G2, G3) ditulis lalu di-comment sehingga varian diproses komponen non-variant. Dikoreksi 2026-06-11 00:45.
4. **Silent failure lebih berbahaya dari fatal error.** Tombol "Kategori Produk" terlihat lancar namun angka pengelompokannya salah karena `LEFT JOIN produk ... AND __raw_rek_pembantu__4010.tipe_id = 1` tidak match baris dengan `tipe_id` bernilai 0 atau NULL.
5. **Snapshot cache versus ledger real-time.** Dashboard membaca `run_san_report.penjualan_order` (cache bulanan), laporan membaca `run_san_modul.__raw_rek_pembantu__4010` (ledger). Selisih YTD 2026 mencapai Rp 2.954.748.747 sebelum dashboard dialih ke live query.
6. **Template engine harus DDD-compliant.** Rancangan *generic engine* ditolak karena menghilangkan *ubiquitous language*. Disepakati pola CQRS Read-Model: query tetap di domain model, formatting matriks dipindah ke `MonthlyMatrixFormatter`.
7. **Disiplin environment ditegakkan setelah koreksi.** Sinkronisasi ke `z:\san` sempat dijalankan tanpa instruksi (2026-09-02 11:37), lalu dikoreksi menjadi protokol staging-first pada 11:39.

### 2.3 Mekanisme knowledge continuity

* **Dev journal bulanan** (`2026-05.md`, `2026-06.md`) dengan metadata wajib `actor / source / operator / session_tag / workspace / modul_area / ringkasan / files_changed / verifikasi`.
* **Protokol Session Checkpoint Auto-Sync** yang menyalin transkrip ke `TRANSKRIP_PERCAKAPAN_LENGKAP.md` di akhir setiap blok implementasi.
* **Guardrail di `AGENTS.md`**: Protokol Bug Berulang (instrument-first), Guardrail Eksekusi Default Global (DoD, prioritas P0-P2), Rule Override per Modul, Format Komunikasi (One-Screen Rule, Answer First, 3 blok, evidence inline).

## 3. Kronologi Aktivitas

| Tanggal | Sesi/Workspace | Topik | Hasil Utama | Sumber |
|---|---|---|---|---|
| 2026-05-25 19:05 | `w:\san_staging` / codex | Log harian tanpa Git hook | `AGENTS.md`, `docs/dev-journal/README.md`, `2026-05.md` terbentuk | 2026-05.md |
| 2026-05-25 19:21 | san_staging / codex | Shadow row `produk_id=0` di preview 1334 | Sanitasi registry key 0; skip loop bila `produk_id < 1` | 2026-05.md |
| 2026-05-25 19:26 | san_staging / codex | Hotfix varian shadow row | Filter invalid row hanya untuk `isVariantRow=false` | 2026-05.md |
| 2026-05-25 19:53 | san_staging / codex | Key varian saat revalidate items | Pakai `$xid` (session key), bukan key produk; cegah row bayangan `1743` dari `variant:1743:1` | 2026-05.md |
| 2026-05-25 20:09 | san_staging / codex | Key kolom insert locker varian | `varian_id/varian2_id` menjadi `variant_id/variant2_id`; hentikan error "Gagal update locker stock varian" | 2026-05.md |
| 2026-05-25 20:15 | san_staging / codex | Debug hardening locker variant | Perbaiki `variant_nama`/`variant2_nama`; log db error code, message, last query, identity | 2026-05.md |
| 2026-05-25 20:25 | san_staging / codex | Marker UI target dropdown | Prefix `[VAR]` pada opsi varian di `views/shoppingCart.php` | 2026-05.md |
| 2026-05-25 20:41 | san_staging / codex | Injeksi varian prioritas | `get_picker_rows(produk_id)` untuk produk aktif di cart agar overcoming limit query global | 2026-05.md |
| 2026-05-25 22:03 | san_staging / codex | Sinkronisasi qty source-target | Trigger `items2_sum` + `tableIn_detail2_sum` setelah `applyVariantIdentityToItem()`, sebelum ValueGate rebuild | 2026-05.md |
| 2026-05-25 22:21 | san_staging / codex | Mapping qty source varian di followup | Pakai `matchedValidKey`; kasus 22 + 7 tidak lagi tertimpa menjadi 29 | 2026-05.md |
| 2026-05-25 22:42 | san_staging / codex | Variant trap followup | Prefix log `[DBG-VTRAP]`, aktif via query `dbg_vtrap=1` | 2026-05.md |
| 2026-05-25 22:49 | san_staging / codex | Trap output hardening | Tulis ke file fisik `application/logs/variant-trap-YYYY-MM-DD.log` | 2026-05.md |
| 2026-05-25 22:58 | san_staging / codex | Fallback key validItems | Fallback ke key master hanya untuk non-varian; hentikan 22/7 menjadi 29/29 | 2026-05.md |
| 2026-05-25 23:06 | san_staging / codex | Keep variant rows | Marker fallback `__variant_keep__` memakai snapshot registry | 2026-05.md |
| 2026-05-25 23:14 | san_staging / codex | Guardrail bug berulang | Protokol instrument-first, stage patch, regression 4 skenario | 2026-05.md |
| 2026-05-25 23:26 | san_staging / codex | Personalisasi agents | Role, prinsip kerja, mekanisme respon, akses server | 2026-05.md |
| 2026-05-25 23:37 | san_staging / codex | Guardrail eksekusi global | DoD, prioritas P0-P2, bukti root cause, rule override per modul | 2026-05.md |
| 2026-05-25 23:44 | san_staging / vansgare | Ghost key guard doFollowup | Normalisasi gate session sebelum validate/write | 2026-05.md |
| 2026-05-25 23:49 | san_staging / codex | Format komunikasi | One-Screen Rule, Answer First, 3 blok, evidence inline | 2026-05.md |
| 2026-05-26 00:04 | san_staging / codex | Traceability jurnal | Metadata wajib actor/source/operator/session_tag/workspace | 2026-05.md |
| 2026-05-26 00:05 | san_staging / vansgare | Sub-postproc empty payload trap | Marker `dofollowup.subpostproc.*`, skip exec bila payload kosong | 2026-05.md |
| 2026-05-26 00:08 | san_staging / vansgare | Always-on entry trap | `dofollowup.entry` dan `dofollowup.subpostproc.entry` tanpa perlu `dbg_vtrap` | 2026-05.md |
| 2026-05-26 00:11 | san_staging / vansgare | Breadcrumb registry | Marker pada `post_validate`, `write_main`, `write_registry` | 2026-05.md |
| 2026-05-26 00:12 | san_staging / vansgare | Early checker trap | Marker `dofollowup.booking_check.*` dan `dofollowup.valid_qty.*` | 2026-05.md |
| 2026-05-26 00:15 | san_staging / vansgare | Preproc pair-exec trap | Marker `dofollowup.preproc.*` dan `dofollowup.preinject.*` | 2026-05.md |
| 2026-05-26 00:18 | san_staging / codex | Ghost key counter merge | Helper `applyCounterRowsToExistingGate()`, update-only-existing | 2026-05.md |
| 2026-05-26 10:30 | `\\192.168.5.14\web\san_staging` | Ghost key FIFO Average | `PreFifoAverageConvertionVarian.php` (baru), config `heTransaksi_core.php` | 2026-05.md |
| 2026-06-04 14:45 | `w:\san_staging` | Optimasi Ollama client agent | Context 4096, keep-alive 30 m, `qwen2.5-coder:7b`, smoke 1.68 dtk / load 389 ms | 2026-06.md |
| 2026-06-06 10:30 | san_staging | Reset cart varian lepaskan hold | `_shoppingCart.php::reset()` baris 2299-2409 | 2026-06.md |
| 2026-06-06 11:00 | san_staging | Enhance variant picker UI | Info bar master, filter SKU, warna stok, tfoot total | 2026-06.md |
| 2026-06-06 11:30 | san_staging | `tableIn_detail` variant fields | Literal `"cart_key"=>"cart_key"`; hapus 5 baris dari `tableIn_static`; typo `variant_labe` 19 lokasi | 2026-06.md |
| 2026-06-06 14:30 | san_staging | Error 5049 doFollowup varian | Session key `variant:{pid}:{vid}` pada baris 4976 dan 21067 | 2026-06.md |
| 2026-06-06 15:30 | san_staging | Rekening pembantu varian tidak nulis | `PreFifoProdukJadi::pair()` skip menjadi pass-through | 2026-06.md |
| 2026-06-07 10:00 | san_staging | Gap 3 komponen varian source | 1334 postProcessor: LockerStockVariant hold/moved + LockerStockMutasiVariant | 2026-06.md |
| 2026-06-07 11:00 | san_staging | Trace 15 skenario items gate | 13/15 PASS, 2/15 pre-existing; mismatch `qty` ke `jml`, `name` ke `nama` | 2026-06.md |
| 2026-06-10 23:00 | san_staging | Dual-locker co-update | Parent `stock_locker` ikut mutasi di 3 titik | 2026-06.md |
| 2026-06-10 23:45 | san_staging | Hotfix filter akumulasi parent | Fresh `new MdlLockerStock()` per query dan update | 2026-06.md |
| 2026-06-10 23:59 | san_staging | Guard cross-type conversion | 3 lapis: view filter, `recordPairedItem`, `recordPairedItemSatuan` | 2026-06.md |
| 2026-06-11 00:45 | san_staging | Fix 3 gap P0 core pipeline | G1 PreFifoProdukJadi, G2 ComLockerStock, G3 ComLockerStockMutasi | 2026-06.md |
| 2026-06-15 03:43 | `w:\san_staging` | Varian entries 2334/2336/2337 | `coTransaksiCore.php` +261 baris (total 8007), 33 variant entries | 2026-06.md |
| 2026-06-26 | `w:\new_san_variant` | Selector variant picker | GROUP BY produk_id, `has_variants > 0`, preLocker bypass, rewrite Backfilllockervariant | dev-jurnal.md |
| 2026-07-02 | `w:\san_ibb` | Desain item custom penawaran | Tabel `estimate_custom_items` + blokir SO bila `mapped_item_id IS NULL` | blueprint CRM |
| 2026-07-14 08:47 | `san_ibb_2jul` | Lock estimate, Group B, Detail Transaksi | `Estimates.php`, `estimates/view.php`, `estimates/details.php` | KONTEKS_SESI.md |
| 2026-08-30 | `san_29agus` + `san_add_29agus` | Timestamp-Based Delta Sync Produk | Endpoint `seeUpdatedSince`, antrean `sync_jobs`, live progress bar | KONTEKS handover |
| 2026-09-01 10:16 | `z:\san` | Error 1052 `dtime` ambiguous | Analisis rantai `Penjualan::so()` - `Bigdata` - `MdlTransaksi` | TRANSKRIP |
| 2026-09-01 10:37 | `z:\san` | Patch dinamis tanpa hardcode tabel | `$tbl_main . "." . $f` dari properti `tableNames[]` | TRANSKRIP |
| 2026-09-01 10:50 | `z:\san` | Patch 2 file | `MdlTransaksi.php` dan `Penjualan.php` (`date(transaksi.dtime)`) | TRANSKRIP |
| 2026-09-01 11:00 | `z:\san` | Kolom tanggal kosong | Ubah prioritas union array di `Bigdata.php` baris 220 | TRANSKRIP |
| 2026-09-01 11:28 | `z:\san` | Tambah kolom Sales ke export | `seller_nama` di `$aKoloms` dan header Excel | TRANSKRIP |
| 2026-09-01 11:34 | `z:\san` | Perbaikan buffer XLSX | `ob_clean()` setelah `writeToStdOut()` dihapus | TRANSKRIP |
| 2026-09-01 11:50 | `z:\san` | Validasi skema OpenXML | `type "text"` menjadi `"string"`, `<numFmts>`, `<workbookProtection/>` | TRANSKRIP |
| 2026-09-01 11:54 | `z:\san` | Peringatan extension mismatch DataTables | `fnExcelReport()` HTML-to-`.xls`; tidak diubah | TRANSKRIP |
| 2026-09-01 13:09 | `z:\san` ke `w:\san_29agus` | Pivot workspace | Semua link diarahkan ke `san_29agus` | TRANSKRIP |
| 2026-09-01 13:13 | `w:\san_29agus` | Dynamic column anti-ambiguous | Desain `prefixFieldSafely($table, $field)` dengan 4 guard | TRANSKRIP |
| 2026-09-01 14:56 | `w:\san_29agus` | Laporan Order Penjualan (SO) | `viewsobulananper()` dan `ceksobulanan()`, 6 dimensi subjek | TRANSKRIP |
| 2026-09-01 15:03 | `w:\san_29agus` | Implementasi 6 dimensi SO | `callSummaryKategoriProdukSoBulanan()`, `callSummaryTipePenjualanSoBulanan()` | TRANSKRIP |
| 2026-09-01 16:00 | `w:\san_29agus` | Tombol subject pink gagal | `$subjek == "salesman"` vs segmen URL `seller` | TRANSKRIP |
| 2026-09-01 16:55 | `w:\san_29agus` | Kategori gagal | 4 akar: debug output, JOIN `tipe_id=1`, model salah, header inkonsisten | TRANSKRIP |
| 2026-09-01 19:59 | `w:\san_29agus` | Implementasi perbaikan kategori | Percobaan `MdlProdukKategori`, debug dibersihkan | TRANSKRIP |
| 2026-09-01 20:06 | `w:\san_29agus` | Koreksi model | Kembali ke `MdlProduk` dan `$items->kategori_nama` | TRANSKRIP |
| 2026-09-01 20:13 | `w:\san_29agus` | Verifikasi SO per cabang | 10 cabang punya data; filter `my_cabang_id() != CB_ID_PUSAT` | TRANSKRIP |
| 2026-09-02 07:52 | `w:\san_29agus` | Dashboard YTD vs laporan | Selisih Rp 2.954.748.747 akibat cache `penjualan_order` | TRANSKRIP |
| 2026-09-02 08:11 | `w:\san_29agus` | Mekanisme sinkronisasi cache | `Outstanding/cekoutstandingseller?job=sync&date1=..&date2=..` | TRANSKRIP |
| 2026-09-02 08:23 | `w:\san_29agus` | Live query plus feature flag | `_get_order_ytd_live()` dan `?so_source=cache` | TRANSKRIP |
| 2026-09-02 09:01 | `san_29agus` vs `z:\san` | Sinkronisasi laporan | 6 file disinkronkan; `MdlRawPenjualan.php` tertinggal versi lama | TRANSKRIP |
| 2026-09-02 10:01 | `w:\san_29agus` | Ide template report engine | Rancangan awal `ComMonthlyReportEngine` schema-driven | TRANSKRIP |
| 2026-09-02 10:37 | `w:\san_29agus` | Uji DDD | Anemic Generic Trap versus CQRS Read-Model | TRANSKRIP |
| 2026-09-02 11:00 | `san_29agus` + `z:\san` | Blueprint reporting DDD | `BLUEPRINT_REPORTING_REFACTOR_DDD.md` | TRANSKRIP |
| 2026-09-02 11:27 | `san_29agus` + `z:\san` | Implementasi MonthlyMatrixFormatter | `application/libraries/laporan/MonthlyMatrixFormatter.php`, ~300 baris dipangkas | TRANSKRIP |
| 2026-09-02 11:39 | `w:\san_29agus` | Protokol staging vs produksi | Hanya `san_29agus` sampai instruksi deploy | TRANSKRIP |
| 2026-09-02 11:42 | `w:\san_29agus` | Refactor `cekpenjualanbulanan` | Service aktif pada kedua endpoint | TRANSKRIP |
| 2026-09-02 15:35 | `w:\san_29agus` | Dead code audit | 34 method menjadi 6 method mati dihapus, tersisa 28 aktif | TRANSKRIP |
| 2026-09-03 10:32 | `w:\san_29agus` | Audit `PenjualanCompare.php` | 3.651 baris, 2 menu, 140 debug print, duplikat `PenjualanCompare2.php` | TRANSKRIP |
| 2026-09-03 10:50 | `w:\san_29agus` | Refaktor `PenjualanCompare.php` | 3.652 menjadi 850 baris; hardcode 2022 dibiarkan | TRANSKRIP |
| 2026-09-03 11:41 | `w:\san_29agus` | Halaman tidak bisa dibuka | `sum_null` memicu `laporan/Crm/maintenance`; 4 method Side Table dipulihkan | TRANSKRIP |
| 2026-09-03 11:48 | `w:\san_29agus` | Error 503 `checkAndSyncBackground` | Method terhapus saat cleaning; dipulihkan | TRANSKRIP |
| 2026-09-03 13:34 | `w:\san_29agus` | Selisih total kategori | Rp 79.900.235.173 vs Rp 81.888.905.309 (selisih Rp 1.988.670.136) | TRANSKRIP |
| 2026-09-03 13:56 | `w:\san_29agus` | Pemisahan 2 baris kategori | `PROJECT` (tipe_id=2) dan `BELUM DISET KATEGORI` (kategori_id NULL/0) | TRANSKRIP |
| 2026-09-03 14:52 | `w:\san_29agus` | Error 500 kategori | Escape backtick merusak `GROUP BY CASE WHEN`; solusi `$escape = FALSE` | TRANSKRIP |
| 2026-09-03 15:41 | `w:\san_29agus` | Dashboard MTD vs laporan | Cache Rp 352.921.591 vs riil Rp 336.215.982 | TRANSKRIP |
| 2026-09-03 16:22 | `w:\san_3sep` | Cross-check workspace terbaru | Sinkron `MdlRawPenjualan.php` plus `_get_order_mtd_live()` | TRANSKRIP |
| Tanpa tanggal | `x:\san_ibb` | Sentence case review | 86 kandidat perubahan teks (40 ID, 46 EN), belum diterapkan | LANG review |

## 4. Jurnal Pengembangan Modul Konversi

### 4.1 2026-05-25: Hari pertama debugging session key varian

Sesi ini mengidentifikasi satu pola bug berulang: kode melakukan iterasi `$items` dengan asumsi key = `produk_id`, padahal varian memakai `variant:{produk_id}:{variant_id}`. Dampaknya berlipat pada tahap rebuild session:

* **Shadow row**: row dengan `produk_id=0` dan `nama=0` ikut masuk ke `validItems`. Guard: sanitasi registry key/id `0`, dan skip loop transaksi detail bila `produk_id < 1`.
* **Hotfix varian**: filter invalid row hanya aktif untuk non-varian (`isVariantRow=false`), agar row varian tidak ikut terhapus saat filtering.
* **Revalidate key**: `foreach ($items as $xid => $iSpec)` di `followupPrePreview` diubah memakai `$xid`. Ini mencegah row bayangan `1743` yang berasal dari `variant:1743:1`.
* **Agregasi salah**: kasus nyata 22 + 7 menjadi 29 per baris karena fallback ke key master produk. Diperbaiki dengan `matchedValidKey` dan marker `__variant_keep__`.
* **Locker variant rollback**: nama kolom insert salah (`varian_id` dan `varian2_id` versus `variant_id` dan `variant2_id`), memicu pesan "Gagal update locker stock varian". Diperbaiki 20:09; pada 20:15 disempurnakan untuk `variant_nama` dan `variant2_nama`, ditambah log detail (db error code, error message, last query, identity).

Peralihan dari debug by console ke debug by artifact file terjadi 22:42-22:49: trap ditulis ke `application/logs/variant-trap-YYYY-MM-DD.log` dengan fallback `docs/dev-journal/variant-trap-YYYY-MM-DD.log`, karena log CI tidak menampilkan entry.

### 4.2 2026-05-26: Ghost key di pipeline FIFO average

`PreFifoAverageConvertion` menyuntik key hantu ke session gate `items` saat memproses baris varian. Solusi mengikuti pola `lockerStock`:

* `PreFifoAverageConvertion` skip baris varian (`variant_id > 0`).
* `PreFifoAverageConvertionVarian` (file baru) menangani baris varian dengan key patcher `cart_key`, bukan `produk_id`.
* `application/config/heTransaksi_core.php`: static fields ditambah `variant_id` dan `cart_key`; entri Varian didaftarkan di module **334, 976, 881, 1334**.
* Module **7881** di-skip karena `resultParams`-nya masih di-comment.

Pada 2026-05-26 00:18, masalah serupa di `doFollowup` ditangani dengan helper `applyCounterRowsToExistingGate()`: merge CounterNumber hanya update baris yang sudah ada, tidak pernah membuat key baru; key tak dikenal dicatat sebagai `counter.skip_missing_key` saat debug aktif.

### 4.3 2026-06-06: Lima perbaikan inti varian

**4.3.1 Reset cart tidak melepas hold varian (`fix-reset-variant-locker`)**

`reset()` di `_shoppingCart.php` (baris 2299-2409) hanya menangani `MdlLockerStock` (non-varian). Akibatnya item varian yang di-hold menggantung di `stock_locker_variant` dan kolom `active` tidak kembali. Fix: branch varian memakai `MdlLockerStockVariant::cekLoker()` lalu release hold ke active; non-varian mendapat guard `isset()` untuk mencegah notice. Edge case cart campuran varian dan non-varian diverifikasi PASS.

**4.3.2 Peningkatan UI variant picker (`enhance-variant-picker-ui`)**

Berkas `application/modules/konversi/views/variant_picker.php` plus data tambahan dari `_selectorItem.php` (`productCode`, `productSatuan`, `totalStockAllVariant`). Fitur: info bar master produk, filter dan search SKU serta label varian (muncul otomatis bila varian lebih dari 5), warna peringatan stok (merah bila 0, oranye bila 5 atau kurang), indikator max stok "/N" di samping input qty, total row `tfoot` dengan live update qty request, dan CSS compact.

**4.3.3 `tableIn_detail` berisi literal nama field (`fix-tableIn-detail-variant-fields`)**

Gejala: session `tableIn_detail` berisi `"cart_key"=>"cart_key"` (nama field), bukan nilai asli. Root cause tiga lapis:

1. Lima variant field (`cart_key`, `variant_id`, `variant_sku`, `variant_label`, `variant_key`) terduplikasi di `tableIn` **dan** `tableIn_static`.
2. `tableIn_static` dijalankan setelah `tableIn` sehingga overwrite nilai benar dengan literal.
3. Typo `"variant_label" => "variant_labe"` (huruf `l` hilang) di **19 lokasi**.

Fix di `application/modules/konversi/config/coTransaksiCore.php`: hapus 5 baris variant field dari seluruh section (`detail`, `detail2`, `detail2_sum`, `rsltItems`) di `tableIn_static`, dan perbaiki 19 typo tersebut.

**4.3.4 Error 5049 doFollowup varian (`fix-dofollowup-variant-5049`)**

`doFollowup()` dan `doCancelPacking()` mengecek `isset($_SESSION[$cCode]['items'][$row->produk_id])`, hanya cocok untuk non-varian. Untuk varian, session key adalah `variant:{produk_id}:{variant_id}` sehingga cek selalu false, `$arrValidQtyReady` kosong, dan muncul pesan "Transaksi gagal disimpan karena sudah diotorisasi". Fix: generate `$sessionKey` berdasarkan `variant_id`. Lokasi: dua blok `foreach $tmpTr` pada baris 4976 dan 21067. Bug serupa ditemukan di `followupPreview()` (lookup `tableIn_detail_values` by `produk_id` tanpa variant awareness) dan **tidak** difix di sesi tersebut.

**4.3.5 Rekening pembantu varian tidak menulis (`fix-rekening-pembantu-varian-tidak-nulis`)**

Pipeline: `items` gate, `PreFifoProdukJadi` preProcessor, `rsltItems` gate, `RekeningPembantuProdukVarian`. `PreFifoProdukJadi::pair()` pada baris 189-193 melakukan `return true` tanpa set `$this->result` untuk semua item dengan `variant_id > 0`. Akibatnya `exec()` return null, `rsltItems` kosong untuk varian, dan komponen varian tidak punya input sehingga tidak menulis. Fix: ubah skip menjadi pass-through yang mengisi `$this->result` dari static params termasuk variant fields. Backward compatible karena non-varian tetap proses FIFO seperti biasa.

Catatan: `PreFifoAverageConvertion` baris 94-97 punya skip serupa pada gate `items` dan **tidak** difix karena `items` gate sudah terisi dari session; konsekuensinya hanya kehilangan update HPP FIFO untuk varian.

### 4.4 2026-06-07: Verifikasi 15 skenario items gate

Static analysis atas 15 kombinasi NV/V source pada pipeline preProcessor, items gate postProcessor, rsltItems, write DB.

| Temuan | Detail | Status |
|---|---|---|
| Pre-existing bug | Mismatch nama field `qty` ke `jml` dan `name` ke `nama` membuat semua LockerStock dan LockerStockVariant NO-OP (jumlah = 0). Mitigasi: locker diupdate dari shopping cart | gagal |
| Mutual exclusion | Terverifikasi pada 5 `Com` class, tidak ada double processing | PASS |
| Edge case S13/S14 | `cart_key = variant:X:Y` dengan `variant_id = 0` atau string, terjadi data loss pre-existing | gagal (pre-existing) |
| Skor akhir | 13 dari 15 skenario PASS, 2 gagal | 13/15 |

Dokumen output: `docs/15-skenario-verifikasi-konversi-items-gate.md`.

### 4.5 2026-06-07 s/d 2026-06-15: Melengkapi komponen varian

**2026-06-07 10:00** - tiga komponen varian untuk source items (gate `items`) yang sebelumnya hilang, ditambahkan di postProcessor **1334**, section detail, setelah `LockerStockMutasi` baris 654:

* `LockerStockVariant` (hold, -qty): release hold di `stock_locker_variant`.
* `LockerStockVariant` (moved, +qty): tulis `moved` di `stock_locker_variant`.
* `LockerStockMutasiVariant` (`qty_debet = -qty`): mutasi variant source items.

Mutual exclusion diverifikasi: `ComLockerStock.php:118-122` skip bila `variant_id > 0`; `ComLockerStockVariant.php:60-62` skip bila `variant_id < 1`. Sebelumnya hanya counterpart non-varian yang ada sehingga item varian dilewati tanpa alternatif dan `stock_locker_variant` tidak terupdate untuk source items (hanya target side `items2_sum` yang punya).

**2026-06-15 03:43** - pola yang sama diterapkan ke postProcessor **2334, 2336, 2337**:

| PostProcessor | Gate | Tambahan |
|---|---|---|
| 2334 | target `items2_sum` | +1 LockerStockVariant (active), +1 LockerStockMutasiVariant |
| 2334r | supplies-only | tidak berubah (2 entries, no variant needed) |
| 2336 main | source `items` | +2 LockerStockVariant (hold, converted), +1 LockerStockMutasiVariant |
| 2336r | source `items` | +2 LockerStockVariant (active, hold) |
| 2337 main | source `items` | +2 LockerStockVariant (hold, converted) |
| 2337r | source `items` | +2 LockerStockVariant (active, hold) |

Berkas `coTransaksiCore.php` bertambah **+261 baris** menjadi total **8007 baris**. Total variant entries naik dari sekitar **24 menjadi 33**. Steps 1334 dan 334 sudah lengkap sejak sesi sebelumnya. Entri supplies tidak mendapat pasangan varian, konsisten dengan existing.

### 4.6 2026-06-10 s/d 2026-06-11: Dual-locker co-update dan guard P0

Blueprint `blueprint-dual-locker-co-update-variant.md` mendokumentasikan masalah P0: tiga titik mutasi hanya menyentuh `stock_locker_variant`, sehingga parent `stock_locker` tetap utuh (stock overstatement) dan parent hold tidak pernah dikembalikan (locker leak permanen).

| No | Titik Mutasi | File:Line sebelum fix |
|---|---|---|
| 1 | `reserveVariantLockerForSelect()` | `_processSelectProductConvertion.php:363-481` |
| 2 | `releaseVariantLockerOnRemove()` | `_processSelectProductConvertion.php:483-539` |
| 3 | `reset()` variant branch | `_shoppingCart.php:2303-2370` |

Konsep: **parent adalah aggregate**. Parent hold disimpan sebagai satu row aggregate per `(produk_id, gudang_id, oleh_id, state='hold')`. Helper yang dirancang: `coUpdateParentLocker($identity, $jmlDelta, $produkRow)` dengan clamp `max(0, currentHold + jmlDelta)`; bila row tidak ada, insert baru.

Skenario Step 5 pada blueprint memperlihatkan edge case penting: pada iterasi A-M setelah A-L mengembalikan parent hold ke 0, delta negatif berikutnya harus tetap menaikkan parent active. Clamp hanya berlaku pada kolom hold, bukan pada kolom active.

Hotfix 23:45 - parent active tidak berkurang karena `MdlMother::addFilter()` meng-*append* ke `$this->filters`, dan `updateData()` menerapkan SEMUA akumulasi filter sebagai WHERE tambahan. Karena parent active dan parent hold di-query dengan satu instance `$parentLocker`, filter `state='hold'` menimpa `state='active'` di criteria array sehingga UPDATE tidak match row (0 affected rows). Fix: fresh instance `new MdlLockerStock()` untuk setiap cekLoker dan setiap updateData/addData, konsisten dengan pola existing di non-variant branch (`$c = new $mdlName()` baris 1631).

Cross-type guard 23:59 - tiga lapis agar source dan target konversi wajib setipe: (1) view filter `shoppingCart.php:469-471`, dropdown target hanya menampilkan opsi setipe, deteksi via prefix `variant:` pada `cart_key` dan `piID`; (2) `recordPairedItem()` baris 3252-3262 membandingkan `sourceVariantId > 0` dengan `pairSel['is_variant']`, reject via swalAlert bila berbeda; (3) `recordPairedItemSatuan()` baris 3483-3490 menolak sumber variant di mode satuan.

Matrix regression: varian ke varian PASS, non-varian ke non-varian PASS, varian ke non-varian REJECT, non-varian ke varian REJECT.

Fix P0 core pipeline 2026-06-11 00:45 - tiga guard variant yang **sudah ditulis lalu di-comment** sehingga varian diproses komponen non-variant:

| Gap | Berkas | Gejala | Fix |
|---|---|---|---|
| G1 | `PreFifoProdukJadi.php` (guard baris 78-119 di-comment) | Varian masuk FIFO parent, stok parent berkurang, stok varian tidak tersentuh | Skip `variant_id > 0` di inner loop `pSpec`; early return `$this->result = array()` bila semua item varian |
| G2 | `ComLockerStock.php` (guard baris 44-126 di-comment) | Varian nulis ke `stock_locker` parent sehingga parent stock double-count | Uncomment guard: `$normalParams` filter, `$this->inParams = $normalParams` |
| G3 | `ComLockerStockMutasi.php` (`continue;` baris 153 di-comment) | Varian nulis ke `stock_locker_mutasi` parent; `outParamsVarian` tidak dipersist sehingga `variantMutationCom` selalu null | Uncomment `continue;`, hapus debug `arrPrint` |

Status setelah fix: mutual exclusion dipulihkan, variant ke variant pipeline PASS dan non-varian ke non-varian pipeline PASS. **Belum ada regresi test di DB** pada sesi tersebut.

### 4.7 2026-06-26: Selector variant picker (dev-jurnal.md)

**A. Baris duplikat per varian.** Contoh: pencarian "b28" menampilkan "ALPEN B28D" dua baris (jumlah 220 dan 55) karena ada dua entry `stock_locker`. Root cause: `MdlLockerStock::lookupByKeyword()` query tanpa `GROUP BY produk_id`; `selector_uses_variant_rows()` hanya mengenali `MdlProduk` dan `MdlProduk2`, sehingga `selectorModel = "MdlLockerStock"` mengembalikan false dan `collapse_variant_rows_for_picker()` tidak pernah dipanggil; path variant terpisah `MdlProdukVarian->search_selector_rows()` **tidak bisa dipakai** karena method tersebut tidak ada di model.

Fix: rewrite `lookupByKeyword()` dengan `GROUP BY stock_locker.produk_id`, `SUM(jumlah)`, subquery `has_variants`, dan `ORDER BY has_variants DESC`. `get_selector_rows()` disederhanakan dan pemanggilan collapse dihapus karena `GROUP BY` sudah menangani di level SQL.

**B. Variant picker popup tidak muncul.** Subquery `has_variants` menghitung `COUNT(*)`, sehingga nilainya bisa 2, 3, 5, dan seterusnya; kode memakai `=== 1` (exact match) sehingga produk dengan lebih dari satu varian gagal match. Fix: ubah ke `> 0` di tiga lokasi, yaitu `collapse_variant_rows_for_picker()` baris 46, variant picker URL override di `selectItem()` baris 481, dan preLocker bypass di `selectItem()` baris 494.

**C. Produk varian stok 0 tidak muncul.** Blok `$preLocker` mengecek `$valLocker > 0` untuk semua produk sehingga produk master stok 0 langsung difilter keluar. Fix: bypass bila `has_variants > 0`; pemeriksaan stok per varian dipindahkan ke popup `variantPicker`.

**D. Backfill migration stok varian salah.** `Backfilllockervariant.php` mendistribusikan stok parent ke setiap entry variant. Contoh nyata: produk master stok 55 dengan empat varian membuat tiap varian mendapat 55 sehingga total 275 (seharusnya 55). Root cause: script memakai `$row->jumlah` (stok parent) untuk kedua entry, dan memakai `ComLockerStockDualWrite::pair()` yang menulis ulang ke parent sehingga menggandakan entry parent yang sudah ada. Rewrite final:

* Produk tanpa varian menjadi sentinel `variant_id = 1` dengan `jumlah = stok parent`.
* Produk dengan varian: setiap varian `jumlah = 0`, diisi lewat transaksi nyata.
* Insert langsung ke `stock_locker_variant` tanpa `ComLockerStockDualWrite::pair()`.
* Method `reset()` untuk truncate dan backfill ulang.

**E. Dual-Write atomik dan FIFO varian.** Sesi ini juga memindahkan seluruh mutasi stok ke `ComLockerStockDualWrite::pair()`, yaitu dual-write atomik ke `stock_locker` dan `stock_locker_variant` dalam satu transaksi database, dan mendaftarkan `FifoProdukJadiVarian` di `coTransaksiCore.php` pada empat entri transaksi tipe 1, sesudah `FifoProdukJadi`, dengan filter sentinel: `variant_id < 0` di-skip, `variant_id == 0` diubah menjadi `1`, `variant_id >= 1` diproses langsung.

Status UAT sesi dual-write: 0 mismatch antara parent `stock_locker` dan `stock_locker_variant`; printing nota konversi normal; aksi hold dan release loker saat memilih atau menghapus produk di keranjang bekerja benar.

### 4.8 Ringkasan berkas yang diubah pada sesi 2026-06-26

| No | Berkas | Aksi | Deskripsi |
|---|---|---|---|
| 1 | `application/models/Mdls/MdlLockerStock.php` | MODIFY | GROUP BY produk_id, SUM(jumlah), subquery has_variants |
| 2 | `application/modules/konversi/controllers/_selectorItem.php` | MODIFY | 1 baris per produk, `has_variants > 0`, preLocker bypass |
| 3 | `application/controllers/Backfilllockervariant.php` | REWRITE | Variant stok 0, sentinel = stok parent, tanpa DualWrite |
| 4 | `docs/blueprint-selector-variant-picker.md` | NEW | Blueprint untuk modul lain |

Catatan governance: dokumentasi `AGENT_GLOBAL` (blueprint produksi existing) **tidak** diperbarui untuk fitur variant agar tidak membingungkan agent lain yang bekerja di workspace produksi. Dokumen tersebut baru diperbarui setelah fitur variant di-merge ke production.

## 5. Delta Sync Produk dan Sinkronisasi Katalog

### 5.1 Latar belakang keputusan arsitektur

Dokumen `KONTEKS_DAN_HANDOVER_DELTA_SYNC_PRODUK.md` (30 Agustus 2026) merekam bahwa sinkronisasi produk lama memakai metode **monolitik blocking** (`syncApiData`) yang membandingkan hash string MD5 secara menyeluruh dalam satu request HTTP. Tiga kelemahan: (1) **risiko false mismatch**, perbedaan format desimal atau spasi membuat seluruh produk selalu terdeteksi berubah; (2) **risiko timeout**, bila banyak produk berubah maka request HTTP dan transaksi database di cabang freeze atau kena 504 Gateway Timeout; (3) **penyebutan domain**, klarifikasi bahwa SSOT untuk domain holding adalah konstanta `ADM_DOMAIN` di `application/helpers/he_url_helper.php`.

Keputusan yang disetujui (**Opsi B**): **Timestamp-Based Delta Sync** dengan endpoint baru di Holding (`seeUpdatedSince`) yang terintegrasi ke antrean asynchronous `sync_jobs` di Cabang, lengkap dengan Live Progress Bar.

### 5.2 Pemetaan lingkungan

| Peran | Path | Konstanta domain |
|---|---|---|
| Holding Company (pusat, API provider) | `W:\san_29agus` | `ADM_DOMAIN = https://demo.mayagrahakencana.com/san_29agus/` |
| Branch / Subsidiary (cabang, client sync) | `W:\san_add_29agus` | `ADM_LOCAL_DOMAIN = https://demo.mayagrahakencana.com/san_add_29agus/` |

### 5.3 Implementasi sisi Holding

Berkas `application/controllers/eusvc/Products.php`, endpoint baru `seeUpdatedSince_get()` dan `seeUpdatedSince_post()`. Menerima parameter `since` (timestamp) dan `cabang_id`, memanfaatkan kolom timestamp otomatis MariaDB: `produk.dtime` (`ON UPDATE current_timestamp()`) dan `price.last_update` (datetime, `ON UPDATE current_timestamp()`).

```sql
SELECT p.id, p.kode, p.nama, p.status, p.trash,
       GREATEST(IFNULL(p.dtime, '2000-01-01 00:00:00'),
                IFNULL(MAX(h.last_update), '2000-01-01 00:00:00')) as last_modified
FROM produk p
LEFT JOIN price h ON h.produk_id = p.id AND h.cabang_id = ? AND h.trash = 0
WHERE (? IS NULL OR ? = '' OR p.dtime > ? OR h.last_update > ?)
GROUP BY p.id
ORDER BY last_modified ASC
```

Response JSON berisi daftar ID produk yang berubah, `jml_total`, dan `server_time` holding. Backward compatibility dijaga 100 persen: `seeItemAll`, `seeItemByIds`, `seeItemHashes`, `seePrices`, dan endpoint lama lain tidak berubah sama sekali.

### 5.4 Implementasi sisi Cabang

Model `application/models/Mdls/MdlProduk.php`: `getLastSuccessfulSyncTime()` membaca `server_time` holding dari job berstatus `finished` di tabel `sync_jobs`; `fetchApiProductsBatch($options, $limit, $cursor, $probeOnly)` menembak `ADM_DOMAIN . "eusvc/Products/seeUpdatedSince"` untuk mengambil workload delta per batch dan cursor, dengan fallback otomatis ke `seeItemHashes` bila endpoint timestamp tidak tersedia; `processApiProductChunk($chunk, $options)` mengambil detail produk via `POST seeItemByIds`, upsert ke tabel `produk`, hitung SKU otomatis, upsert relasi `price` dengan `my_cabang_id()`; `syncApiData()` (legacy/on-demand) dipertahankan untuk sinkronisasi instan per item, misalnya dari `_processSelectProduct.php`. Teks hardcode domain lama diganti konstanta `ADM_DOMAIN`.

Controller `application/modules/statik/controllers/Data.php`: whitelist model diperluas untuk mengizinkan `MdlProduk` bersama `MdlCustomer` pada `sync_job_start()` dan `sync_job_process()`; dynamic handler mendeteksi `$fetchMethod` (`fetchApiProductsBatch` atau `fetchApiCustomersBatch`) dan `$processMethod` (`processApiProductChunk` atau `processApiCustomerChunk`); tombol sinkronisasi pada tabel Master Data Produk otomatis beralih ke tombol `Syncron Now` dengan animasi progress bar polling.

### 5.5 Hasil verifikasi

| Komponen | Parameter uji | Hasil | Status |
|---|---|---|---|
| Endpoint Holding `seeUpdatedSince` | `since = 2026-08-29 00:00:00` | HTTP 200, 3 produk terupdate, `server_time: 2026-08-30 12:31:48` | PASS |
| Detail batch fetch `seeItemByIds` | `ids = 38,366` | HTTP 200, master produk dan harga tier lengkap | PASS |
| PHP lint | `Products.php`, `MdlProduk.php`, `Data.php` | 0 syntax errors | PASS |

### 5.6 Handover delta sync (TODO sesi berikutnya)

1. Verifikasi lewat browser: buka menu Master Produk di `san_add_29agus`, klik **Syncron Now**, amati animasi progress bar polling hingga selesai, lalu klik kedua dan pastikan notifikasi "Data sudah mutakhir (0 item perubahan)" muncul dalam waktu kurang dari 1 detik.
2. Uji edge case: ubah harga di holding tanpa mengubah produk (harus terdeteksi di cabang); ubah `trash = 1` di holding (produk di cabang harus ikut nonaktif).
3. Replikasi opsional ke master data lain seperti Supplier dan Kategori.

## 6. Context Sesi dan Handover

### 6.1 Estimates / CRM (KONTEKS_SESI.md, 2026-07-14 08:47 WIB, workspace `san_ibb_2jul`)

Tiga fitur berstatus **Selesai**.

**1. Lock Estimate.** Saat estimate sedang diedit orang lain, semua tombol aksi dimatikan dan hanya tombol "Minta Ambil Alih" yang aktif. `app/Controllers/Estimates.php` mengirim cek lock state `is_currently_locked` ke view; `app/Views/estimates/view.php` berisi script untuk disable semua tombol aksi saat locked.

**2. Dropdown Group B dengan alamat lengkap.** Field pada form Sunting Estimate (Customer Details, Billing Details, Delivery Details) sebelumnya hanya menampilkan nama atau alias, sekarang format `Nama (Alamat Lengkap)`. Method `get_dynamic_model_options()` melakukan dua query ke API Data Center untuk tiga model:

| Model | Field nama/alias | Field alamat |
|---|---|---|
| `MdlCustomerAddress` | `alias` atau `nama` | `alamat` |
| `MdlCustomerBillAddress` | `alias` atau `nama` | `alamat` |
| `MdlCustomer_and_pre` | `alias` atau `nama` | `alamat_1` |

Base URL API Data Center: `https://demo.mayagrahakencana.com/san_28jun/`; endpoint `eusvc/Transactions/getModelOptions?...`.

**3. Card "Detail Transaksi" di sidebar kanan.** Menampilkan seluruh field `transaction_options` dengan nilai ter-resolve. Implementasi di `Estimates.php::view($estimate_id)` menambahkan blok setelah baris `$view_data["signature"] = $this->_getCustomSigner($estimate_id);`. Alur: decode JSON `transaction_options`, fetch `eusvc/Transactions/getUiElements/582`, lalu untuk tiap key dua query `getModelOptions` (nama dan alamat), menghasilkan array `transaction_options_resolved`. View `app/Views/estimates/details.php` merender card setelah card status bar (`col-md-3`) dengan heading "DETAIL TRANSAKSI" dan aksen border-left `#357ffa`.

TODO tersisa: verifikasi tampilan di browser dengan data real, pertimbangkan caching agar tidak membebani Data Center, uji performa bila `transaction_options` berisi banyak field.

Info teknis: DB `192.168.5.10`, database `ibb_6jul`, prefix `rise_`; UI Elements ID `582`; kolom `transaction_options` di tabel `rise_estimates` berformat JSON; lock system di tabel `rise_estimate_edit_counter` dengan kolom `session_edit`, `session_edit_user`, `booking_dtime`.

### 6.2 Item custom pada penawaran (blueprint_CRM_point1_buat_baru_estimates.md, 2026-07-02)

Permintaan: sales dapat menambah produk ad-hoc tanpa merujuk produk di Data Center (`items`). Di akhir siklus, item ad-hoc **wajib** di-mapping ke produk riil sebelum konversi menjadi Sales Order.

| Aspek | Keputusan |
|---|---|
| Penyimpanan | Tabel baru `estimate_custom_items`, terpisah dari `items` |
| Eksklusivitas | Terikat ke satu `estimate_id`, tidak reusable antar penawaran |
| Field input | `item_name`, `unit`, `rate`, `description` - semuanya tidak mandatory |
| Mapping | `mapped_item_id` (FK ke `items`), `mapped_by`, `mapped_at` |
| Blokir SO | Jika ada baris dengan `mapped_item_id IS NULL`, konversi ditolak |
| Hak akses mapping | Mengikuti hak akses penawaran saat ini, tidak ada perubahan role |
| Modifikasi `estimate_items` | Tidak diperlukan, JOIN via `estimate_id` cukup |
| Urutan item | Diatur via kolom `sort_order` |
| Audit trail | Soft delete plus full timestamp siapa buat, edit, hapus |
| Alur ERP saat Won | Ditunda, dibahas terpisah |

Skema tabel: kolom utama `id`, `estimate_id`; data produk custom `item_name` VARCHAR(255), `unit` VARCHAR(50), `rate` DECIMAL(15,2), `description` TEXT; relasi `mapped_item_id`, `mapped_by`, `mapped_at`; audit `created_by`, `created_at`, `updated_by`, `updated_at`, `deleted_by`, `deleted_at`, `is_deleted`; urutan `sort_order` INT default 0. Indeks: `idx_estimate_id` dan `idx_mapped_item_id`. Engine InnoDB, charset utf8mb4.

Pendekatan rendering: `UNION ALL` antara `estimate_items` (item_type `regular`) dan `estimate_custom_items` (item_type `custom`, `is_deleted = 0`), `ORDER BY sort_order ASC`. Kolom `item_type` dipakai View/Controller untuk membedakan rendering item reguler dan custom, misalnya menampilkan badge "Custom" atau tombol "Mapping ke Produk Riil".

Blokir konversi ke Sales Order dijalankan sebelum proses konversi:

```sql
SELECT COUNT(*) FROM estimate_custom_items
WHERE estimate_id = <estimate_id>
  AND mapped_item_id IS NULL
  AND is_deleted = 0
```

Jika hasil lebih dari 0, konversi dibatalkan dengan notifikasi berisi daftar item yang belum di-mapping. Komponen terdampak: `app/Views/estimates/item_modal_form.php`, `Estimates.php::save_item`, fungsi konversi ke SO di `Estimates.php`, `app/Models/Estimate_items_model.php`, serta view mapping baru. Status: **belum diimplementasikan**, dokumen ini murni catatan hasil diskusi desain.

### 6.3 Sprint plan enterprise Estimates (ESTIMATES_ENTERPRISE_SPRINT_PLAN.md)

Delivery objective: membangun reporting enterprise untuk modul Estimates dengan KPI seragam lintas role, pivot multi dimensi siap audit, traceability endpoint dan query ke setiap angka dashboard, serta UAT dan security pass sebagai release gate.

| Sprint | Durasi | Fokus | Exit criteria inti |
|---|---|---|---|
| 0 | 1 minggu | Discovery, KPI lock, data mapping | KPI tidak ambigu, semua owner menyetujui blueprint |
| 1 | 2 minggu | KPI core, pivot dasar, security baseline | KPI sesuai formula, tidak ada defect P0 security |
| 2 | 2 minggu | Pivot per role, export, reconciliation | Parent-child total konsisten di drill-down, export parity pass |
| 3 | 2 minggu | Audit/activity board, hardening performance | p95 sesuai SLA, rekonsiliasi delta <= tolerance |
| 4 | 1 minggu | UAT final, sign-off, go-live prep | UAT KPI/security 100%, tidak ada P0/P1 open |

KPI Sprint 1 mencakup count, value, accepted rate, dan aging 3+/7+. Pivot dasar Sprint 1 adalah Owner x Month x Status dengan role access baseline Direksi/BO/SO. Sprint 3 menambah activity audit board (event_type, activity_code, actor), reconciliation automation (UI versus DB), serta tuning performance.

Capacity minimum: Product Owner 30%, Tech Lead 40%, Backend Dev 100%, Frontend Dev 80%, BI Analyst 80%, QA 80%, Sales Ops SME 30%. Risk register lima baris: KPI ambiguity antar tim, mismatch angka UI versus DB, performance drop saat filter kompleks, access control leak, dan scope creep. Go-live checklist lima item. Hypercare dua minggu dengan reconciliation report harian, defect triage harian, business review 3x per minggu, dan KPI drift review mingguan. Success metrics: adoption minimal 80%, draft aging 7+ turun minimal 30% per kuartal, accepted rate naik minimal 10% per kuartal, rekonsiliasi mismatch di bawah 0.5% stabil 4 minggu.

## 7. Transkrip Percakapan Lengkap: Ringkasan Topik dan Keputusan

Berkas `TRANSKRIP_PERCAKAPAN_LENGKAP.md` berisi **147 pesan** dalam rentang **2026-09-01 10:16** sampai **2026-09-03 16:22** WIB, didukung Protokol Session Checkpoint Auto-Sync yang menyalin transkrip ke file markdown di akhir setiap blok implementasi.

### 7.1 Pivot workspace (2026-09-01 13:09)

Sesi dimulai di `z:\san`, lalu seluruh link file dialihkan ke `w:\san_29agus`. Berkas yang disebutkan setelah pivot: `application/modules/laporan/controllers/Penjualan.php`, `application/controllers/ExcelWriter.php`, `application/libraries/Excel.php`, `application/models/MdlTransaksi.php`, dan `application/libraries/Bigdata.php`.

### 7.2 Topik A: Error 1052 `Column 'dtime' in field list is ambiguous`

**Analisis (Pesan 3-4).** Rantai panggilan: `Penjualan::so()` baris 660 memanggil `Bigdata::callBdProdukNonAkunting()` baris 204, yang memanggil `MdlTransaksi::lookupTransaksiDataRegistries()` baris 3672. Field list `$field_main` berisi nama kolom tanpa alias tabel (`dtime`, `id`, `jenis`), sehingga CI3 Query Builder menghasilkan `SELECT ... dtime ... FROM transaksi JOIN transaksi_data_registry`.

Tiga hipotesis mengapa dulunya baik-baik saja: (1) penambahan kolom `dtime` di `transaksi_data_registry`; (2) perpindahan alur pengambilan data ke library `Bigdata`; (3) inisiasi filter tanggal URL `?1=1&date1=2026-09-01&date2=2026-09-01` yang menyisipkan `date(dtime)` ke klausa WHERE.

**Opsi solusi (Pesan 5-6).** Opsi 1, prefix di level model `MdlTransaksi.php`, menyelesaikan field list secara permanen untuk semua pemanggil (`ActivityReport.php` dan `Bigdata.php`), tetapi belum menutup WHERE dan ORDER BY. Opsi 2, hanya di controller, memiliki **kelemahan fatal** karena tidak menghentikan MySQL error 1052. Opsi 3, defensive multi-layer di tiga titik (model, `Bigdata.php` baris 187 dan 199, `Penjualan.php` baris 631-632), awalnya direkomendasikan.

**Keputusan (Pesan 7-8).** User menyetujui Opsi 1 dengan syarat **tanpa hardcode nama tabel**. Rancangan: ambil `$tbl_main = $this->tableNames['main']` dan `$tbl_slave = $this->tableNames['dataRegistry']`, filter `blockFields` lebih dulu via `array_diff`, lalu prefix tiap field. Penting: nama property pada object hasil query tetap tanpa prefix (`$row->dtime`, `$row->main`), sehingga pemroses di controller tidak terganggu.

**Insiden (Pesan 11-14).** User melaporkan "belum berhasil". Ternyata file `MdlTransaksi.php` ter-overwrite kembali karena tab terbuka di IDE dan autosave. Selain itu `Penjualan.php` sempat salah diubah menjadi `date(transaksi_data_registry.dtime)` yang memicu *Unknown column*. Diperbaiki menjadi `date(transaksi.dtime)`. Rekomendasi operasional: reload tab editor dari disk.

**Dampak lanjutan (Pesan 17-20).** Setelah ambiguitas hilang, kolom tanggal tampil kosong. Root cause di `Bigdata.php` baris 214-223: operator array union `+` memprioritaskan array kiri, dan blob `$mains` (dari `transaksi_data_registry.main`) punya key `dtime` bernilai kosong atau NULL karena nilai riil dibentuk database saat INSERT. Nilai riil ada di `$trSpeks[$trId]`. Fix: ubah prioritas menjadi `$item + (array)$trSpeks[$trId] + $mains + (array)$prSpeks[$produk_id]`, sehingga `$item` (prioritas 1) menjaga `qty`, `harga`, `diskon`, `sub_nett1` per baris, dan `$trSpeks[$trId]` (prioritas 2) menyediakan `dtime`, `nomer`, `nomer_top`, `cabang_nama`, `customers_nama`, `seller_nama`.

### 7.3 Topik B: Tombol Export APP SO dan kolom Sales

**Konteks tombol (Pesan 21-22).** "APP SO" adalah **Approved Sales Order** pada modul transaksi `582`, yaitu nomor SOA yang telah disetujui atau diotorisasi pada langkah ke-2. Tombol dikonfigurasi di `application/config/heTransaksi_layout.php` baris 8164-8169 lewat `customButton` (`2 => array(1 => array("label" => "Export APP SO", "target" => "ExcelWriter/exp/"))`). Endpoint yang dipanggil: `base_url() . "ExcelWriter/exp/582so?date1=2026-08-02&date2=2026-09-01"`.

Perbedaan penting: tombol **Download Excel** (abu-abu) adalah fitur *client-side* DataTables yang hanya mengekspor baris dan kolom yang terlihat di layar; tombol **Export APP SO** adalah fitur *server-side* (`ExcelWriter::exp()` baris 301) yang menghasilkan laporan lengkap per item, termasuk harga, diskon, PPN, netto, dan detail wilayah customer.

**Perubahan (Pesan 23-26).** `seller_nama` ditambahkan ke `$aKoloms` baris 332-337, dan kolom header "Sales" ditambahkan pada baris 474-477, setelah kolom Kota/Customer dan sebelum kolom "Person" (`oleh_nama`). Zero extra query karena `seller_nama` sudah tersedia di query utama tabel `transaksi`.

### 7.4 Topik C: Peringatan "We found a problem with some content" pada file .xlsx

**Tahap 1 (Pesan 27-32).** Hipotesis awal: `ob_clean()` pada `application/libraries/Excel.php` baris 147-152 dipanggil **setelah** `$writer->writeToStdOut()`, sehingga byte penutup arsip ZIP (*End of Central Directory Record*) ikut terhapus dan Excel memunculkan dialog recovery. Fix: pindahkan pembersihan buffer ke sebelum header dengan guard defensif `if (ob_get_level() > 0) { ob_end_clean(); }`, kemudian `header(...)`, lalu `$writer->writeToStdOut();` dan `exit(0);` tanpa `ob_clean()` lagi.

**Tahap 2 (Pesan 33-36).** Peringatan belum hilang. Akar masalah sebenarnya di level skema XML `xl/styles.xml`: kolom `trash_4` berlabel "STATUS" memakai `"type" => "text"` yang tidak valid di OpenXML, menghasilkan `<numFmt numFmtId="164" formatCode="text" />`. Empat perbaikan: (1) `ExcelWriter.php` baris 507-510, `"text"` menjadi `"string"`; (2) `xlsxwriter.class.php` baris 875, map `'text'` ke `'@'` di `numberFormatStandardized()`; (3) `xlsxwriter.class.php` baris 525-535, bungkus penulisan `<numFmts>` dengan `!empty($this->number_formats)` agar tag `<numFmts count="0">` tidak ditulis; (4) `xlsxwriter.class.php` baris 706, hapus tag kosong `<workbookProtection/>` dari `workbook.xml`, yang memicu kegagalan validasi skema pada Office 2016/2019/2021/365.

**Tahap 3 (Pesan 37-39).** Peringatan berbeda muncul pada tombol Download Excel DataTables: `The file format and extension of 'download (1).xls' don't match`. Penyebabnya fungsi `fnExcelReport(id_table_tujuan)` di `application/template/history.html` baris 564-595 yang menggunakan teknik HTML-to-XLS string (`window.open('data:application/vnd.ms-excel,' + encodeURIComponent(tab_text))`). Browser menamai file `download (1).xls` padahal isinya teks HTML. **Keputusan: tidak diubah**; alternatif yang ditawarkan SheetJS (`xlsx.full.min.js`), ekspor CSV, atau pengarahan ke backend export.

### 7.5 Topik D: Dynamic column anti-ambiguous

**Pertanyaan (Pesan 44).** Apakah penambahan kolom bisa menjadi variabel dinamis sehingga tidak menimbulkan bug ambiguous column?

**Risiko yang diidentifikasi (Pesan 45).** Nama kolom umum di hampir semua tabel: `id`, `dtime`, `trash`, `cabang_id`, `oleh_id`, `oleh_nama`. Tiga jebakan: `SELECT *` atau `SELECT t.*, r.*` menyukutkan silent overwrite karena kolom bernama sama saling menimpa di array PHP; cek metadata otomatis lewat `SHOW COLUMNS` menambah beban server dan latensi; dan hanya mengamankan SELECT lupa WHERE karena controller tetap mengirim `date(dtime)>=`.

**Solusi defensif (Pesan 46-47).** Helper `prefixFieldSafely($table, $field)` dengan empat guard: (1) sudah ada titik, biarkan; (2) mengandung `(` atau `)`, biarkan sebagai fungsi SQL; (3) mengandung ` AS `, prefix hanya kolom sumber; (4) kolom murni, prefix. Lokasi penerapan: **hanya** method multi-tabel atau JOIN (`lookupTransaksiDataRegistries()`, `lookupDataRegistries()`); method single-table (`lookupAll()`, `lookupByCondition()`) tidak diubah demi zero blast radius. Status: **diskusi desain, belum diimplementasikan**.

### 7.6 Topik E: Laporan Order Penjualan (SO) bulanan

**Konteks analisis halaman (Pesan 49).** URL `demo.mayagrahakencana.com/san_29agus/laporan/Penjualan/viewpenjualanbulananper/seller`. Judul: "Laporan Penjualan Per Salesman (Year To Date) Meliputi Data Penjualan Local, Export Dan Projek [NETTO]". Periode YTD 2026 rentang `01/01/2026 s/d 01/09/2026`, sesi cabang Jakarta. Tab PILIH SUBJEK tersedia untuk `Cabang`, `Salesman` (aktif), `Customer`, `Produk`, `Kategori Produk`, dan `Tipe Penjualan`.

**Anomali data yang ditemukan dan disimpan:** `Adiwirya Hadisaputra` muncul dua baris, PID `77` (Jan, Mar, Apr, Jun, Jul) dan PID `171` (Mei, 7.782 unit atau Rp 4,16 M); `Oscar` terpecah dua baris, PID `925` dengan nama `Oscar` dan PID `134` dengan nama `oscar` huruf kecil; baris teratas omzet terbesar dipegang PID `745` (`Uring Jkt`) dengan total belasan miliar, karena agregasi mengelompokkan berdasarkan `oleh_id` dan `oleh_nama` (user penginput), bukan `seller_id` (salesman riil).

**Rancangan (Pesan 51-52).** Perbandingan sumber data: laporan penjualan existing memakai `582spd`, `382spd`, `982` untuk realisasi dan pengiriman; laporan SO baru memakai `582so`, `382so`, `588so` untuk pesanan masuk. User menyetujui **Opsi 1: dedicated method baru** dengan alasan zero blast radius terhadap `viewpenjualanbulanan()` dan `cekpenjualanbulanan()`.

**Implementasi (Pesan 55).** `application/models/Mdls/MdlRawPenjualan.php` mendapat method baru `callSummaryKategoriProdukSoBulanan()` dan `callSummaryTipePenjualanSoBulanan()`, enam dimensi subjek didukung (Salesman, Customer, Produk, Cabang, Kategori, Tipe Penjualan). `application/modules/laporan/views/laporan_periode.php` mendukung `$link_perper` dinamis dari controller sehingga tombol pergantian subjek mengarah ke endpoint `ceksobulanan`. `application/modules/laporan/controllers/Penjualan.php` menambah `viewsobulananper()` sebagai kontainer antarmuka dan `ceksobulanan()` sebagai endpoint AJAX yang memproses matriks Jan-Des, menghitung `unit` dan `nilai` Rupiah, mengelompokkan salesman berdasarkan `seller_id`. URL akses: `.../laporan/Penjualan/viewsobulananper/{seller|customer|produk|cabang|kategori|tipe}`. Jaminan: laporan penjualan existing di `viewpenjualanbulananper/seller` tetap utuh.

**Bug tombol subject (Pesan 56-57).** Tombol Salesman tidak menyala pink karena view mengecek `$subjek == "salesman"` sedangkan segmen URL adalah `seller`. Fix di `laporan_periode.php` baris 1896 dan 2647:

```php
$btn_seller = isset($subjek) && ($subjek == "salesman" || $subjek == "seller") ? "pilih-btn" : "subj-btn";
```

**Bug Kategori Produk (Pesan 58-71).** Empat akar masalah: (1) *output debug* merusak AJAX DataTables, `cekHere("$subjek_0")` di `Penjualan.php` baris 4202, `showLast_query("kuning")` baris 4228, dan `showLast_query("biru")` di `MdlRawPenjualan.php` baris 291 mengotori `div#sum_satu` sebelum elemen `<table>` sehingga JavaScript DataTables crash; (2) *JOIN condition* gagal, `MdlRawPenjualan::callJoinSummary()` memakai `LEFT JOIN produk ON produk.id = ...produk_id AND ...tipe_id = 1`, sementara banyak baris `tipe_id` bernilai 0, NULL, atau kosong sehingga `kategori_id` menjadi NULL dan transaksi masuk kategori `Undefine`; (3) salah model, controller memanggil `MdlProduk` (ribuan SKU) dan mengisi `$src_produks[$item->kategori_id] = (array)$item`, sehingga label kategori tertimpa nama produk terakhir yang dibaca; (4) inkonsistensi header, kategori memakai key `kategori_nama` sedangkan dimensi lain memakai `id` dan `nama`.

**Debat penting (Pesan 62-65).** User bertanya "kenyataannya mengapa diklik data lancar-lancar saja?" dan kemudian "Apakah Anda benar-benar setuju, atau hanya menghindari konflik?". Assistant mengakui analisis sebelumnya terlalu fokus pada edge-case backend, lalu menegaskan ada **silent failure**: tabel tampil dan HTTP 200, tetapi pengelompokan omzet per kategori tidak akurat secara akuntansi, disertai boros memori karena menarik ribuan produk ke RAM.

**Riwayat koreksi (Pesan 68-71).** Percobaan memindahkan ke `MdlProdukKategori` menghasilkan *Fatal error: Call to undefined method MdlProdukKategori::callSpecs()*. Final: kembali ke `MdlProduk` yang memang menyediakan `callSpecs()`, akses `$items->merek_nama` diganti menjadi `$items->kategori_nama`, `masterHeaders` kembali ke key `kategori_nama`, dan marker `$src_produks[0]["kategori_nama"] = "undefine"` dipasang sesuai pola laporan penjualan existing.

### 7.7 Topik F: Verifikasi cakupan cabang

**Pertanyaan (Pesan 72).** "verifikasi apakah benar yang ada so hanya cabang jakarta saja?" **Jawaban: TIDAK BENAR.** Data riil SO tahun 2026 di database `run_san_modul`:

| Cabang ID | Nama Cabang | Jml Transaksi SO 2026 | Total Nilai SO 2026 |
|---:|---|---:|---:|
| 1 | Jakarta | 544 | Rp 64.057.304.575 |
| 31 | Balikpapan | 414 | Rp 17.618.510.317 |
| 27 | Medan | 131 | Rp 9.161.070.860 |
| 32 | Palembang | 215 | Rp 5.158.451.491 |
| 33 | Bali | 11 | Rp 3.610.292.724 |
| 21 | Surabaya | 151 | Rp 3.388.839.189 |
| 28 | PekanBaru | 54 | Rp 1.959.124.367 |
| 30 | Banjarmasin | 89 | Rp 1.743.624.010 |
| 26 | Semarang | 57 | Rp 1.700.193.452 |
| 34 | Makassar | 37 | Rp 459.673.327 |

Nilai 0 di cabang lain adalah efek otorisasi, bukan data hilang. Kode filter di `Penjualan.php`:

```php
if (my_cabang_id() != CB_ID_PUSAT) {
    $this->db->where("__raw_rek_pembantu__4010.cabang_id", my_cabang_id());
}
```

Login PUSAT dengan `CB_ID_PUSAT = -1` membuka seluruh baris cabang.

### 7.8 Topik G: Dashboard versus laporan (cache versus ledger)

**Gejala (Pesan 74-76).** Nilai YTD dashboard berbeda dari laporan, sementara MTD justru sama. Dashboard di `/dashboard/Graph/viewSummary_2`; kotak `(B) ORDER` memanggil `get_z_sales_cache()` dan `MdlReporting::getSaldoBawahTahun('2026')` yang membaca `run_san_report.penjualan_order`. Laporan SO membaca `run_san_modul.__raw_rek_pembantu__4010` secara real-time.

| Bulan | Dashboard cache | Laporan SO raw | Selisih |
|---|---:|---:|---:|
| 01 Jan | 11.048.503.968 | 11.165.440.932 | +116.936.964 |
| 02 Feb | 6.422.734.078 | 6.453.274.618 | +30.540.540 |
| 03 Mar | 3.891.191.900 | 3.891.191.900 | 0 (sama) |
| 04 Apr | 9.453.129.793 | 9.471.366.415 | +18.236.622 |
| 05 Mei | 13.805.677.382 | 13.790.506.301 | -15.171.081 |
| 06 Jun | 4.385.379.334 | 5.702.222.514 | +1.316.843.180 |
| 07 Jul | 10.718.776.075 | 12.182.168.324 | +1.463.392.249 |
| 08 Agu | 18.872.548.050 | 18.896.518.323 | +23.970.273 |
| 09 Sep (MTD) | 197.205.404 | 197.205.404 | 0 (sama) |
| **TOTAL YTD** | **78.795.145.984** | **81.749.894.731** | **+2.954.748.747** |

**Penjelasan.** Tabel `penjualan_order` adalah cache agregasi historis. Transaksi susulan pada Juni dan Juli, termasuk SO Project `588so` dan penyesuaian reject `582sorj`, diinput, diedit, atau diberi tanggal *backdate* **setelah** snapshot bulanan dikunci, sehingga tidak masuk cache.

**Mekanisme sinkronisasi cache (Pesan 79-81).** Dikonfirmasi bahwa link `/laporan/Outstanding/cekOutstandingSeller?job=sync&date1=...&date2=...` adalah handler resmi. Di `application/modules/laporan/controllers/Outstanding.php` baris 3132:

```php
$allow_write_penjualan_order = (PHP_SAPI == "cli") || (isset($_GET['job']) && $_GET['job'] == "sync");
```

Jika true, instantiate `MdlReporting`, `setTableName("penjualan_order")`, set fields, lalu per baris memanggil `$rp->writePenjualanOrder()` untuk menulis ulang cache bulan tersebut.

**Tiga opsi solusi (Pesan 82-83).** Opsi 1 Direct Live Query mengagregasi langsung dari `__raw_rek_pembantu__4010`: 100 persen identik real-time, tanpa dependency cache, benchmark 0.12 detik (121 ms), kekurangan perlu index `(year(dtime), jenis)` bila volume mencapai jutaan baris. Opsi 2 Scheduled Auto-Sync dengan cron periodik tidak mengubah arsitektur dashboard, tetapi tetap ada delay dan tidak real-time. Opsi 3 Dual-Write atau Hook meng-update `penjualan_order` saat 582so, 588so, 582sorj disimpan; cache selalu segar, tetapi sangat rapuh, menyentuh banyak modul, dan koreksi DB langsung tetap meleset.

**Keputusan (Pesan 84-87).** User menyetujui Opsi 1 dengan tambahan: **buat metode switching agar bisa berganti dengan cepat ke metode lama**. Diimplementasikan pada `application/modules/dashboard/controllers/Graph.php`. Method terisolasi `_get_order_ytd_live($thn_ini, $cabang_id)` menghitung mutasi SO netto (`582so`, `382so`, `588so` dikurangi reject `582sorj`, `382sorj`, `588sorj`) langsung dari `__raw_rek_pembantu__4010`, dengan dukungan hak akses multi-cabang. Feature flag di `callSummary()` dan `callSummary_now()`:

```php
$so_source_mode = "live";
if (isset($_GET['so_source']) && in_array($_GET['so_source'], array('cache', 'live'))) {
    $so_source_mode = $_GET['so_source'];
}
if ($so_source_mode == "live") {
    $src_datas->netto_ytd = $this->_get_order_ytd_live($thn_ini, $cabang_id);
} else {
    // METODE LAMA (Tabel penjualan_order)
    $src_datas->netto_ytd = $srcs_thn['now_saldo_order_netto_all'] * 1;
}
```

Nilai setelah fix: live **Rp 81.749.894.731** (Pusat) atau **Rp 54.755.368.287** (Jakarta); fallback cache **Rp 78.795.145.984**.

### 7.9 Topik H: Sinkronisasi antar workspace

**Kritik user (Pesan 88).** "cek ulang apakah laporan yang sebelumnya kita buat di san_29agus sudah sama dengan di workspace san? karena navigasi kategori belum jalan seperti di san_29agus". **Temuan:** `MdlRawPenjualan.php` di `z:\san` masih versi lama tanpa `callSummaryKategoriProdukSoBulanan()` dan `callSummaryTipePenjualanSoBulanan()`. Setelah sinkronisasi, enam berkas dinyatakan identik: `MdlRawPenjualan.php`, `Penjualan.php`, `laporan_periode.php`, `Graph.php`, `MdlProduk.php`, dan `MdlProdukKategori.php`.

**Koreksi proses (Pesan 102-105).** User protes "kenapa anda juga melakukan di z:\san?". Jawaban assistant: domain `san.mayagrahakencana.com` membaca source langsung dari `z:\san`. Protokol final yang disepakati: (1) fase development dan uji coba hanya di `w:\san_29agus`, dengan `z:\san` tidak disentuh; (2) fase rilis, sinkronisasi ke `z:\san` hanya atas instruksi eksplisit seperti "sinkronkan ke z:\san" atau "deploy ke san".

### 7.10 Topik I: Template report engine dan DDD

**Ide awal (Pesan 90-91).** Pola laporan matriks Jan-Des dengan switcher enam subjek memiliki struktur 85 persen identik. Rancangan awal: library `ComMonthlyReportEngine` schema-driven di `application/models/Coms/` atau `application/libraries/`, dengan konfigurasi sekitar 20 baris (`title`, `subjek`, `raw_table`, `jenis_kredit`, `jenis_debet`, `year`, `cabang_id`, `link_perper`) yang otomatis menjalankan Auto-Query Builder, Auto-Matrix Formatter, Auto-Master Header, dan Auto-DataTables Switcher Rendering. Estimasi penghematan: 500 lebih baris kode duplikat per controller menjadi sekitar 20-30 baris konfigurasi.

**Uji DDD (Pesan 92-93).** Assistant mengakui jebakan "Over-Generalization / Anemic Generic Trap". Kehilangan *Ubiquitous Language* jika istilah `data_plus`, `data_minus`, dan `subjek_1` menghapus makna bisnis (Domain Knowledge Erosion). *Domain Logic Leakage* jika validasi, diskon khusus, atau aturan pembatalan nota dipaksa masuk template generik sehingga melanggar *Bounded Context*.

**Kesimpulan: pola CQRS Read-Model selaras 100 persen.** Domain Layer (write side) memegang aturan bisnis murni; Matrix Reporting Engine berada di Read-Side atau Projection Layer sebagai *Presentation Service*, bukan *Domain Engine*. Solusi: engine wajib menyediakan custom callback atau modifier agar logika unik bisa di-inject tanpa merusak kerangka template, dan harus ditulis 100 persen kompatibel PHP 5.6 tanpa fitur PHP 7+.

| Aspek | Rencana Awal (Full Generic Engine) | Rencana Akhir (CQRS Formatter) |
|---|---|---|
| Pembagian tugas | Satu engine mengambil SQL Query, Join, Agregasi, dan Tampilan | Domain Model menyiapkan query; Service Library menata matriks 12 bulan |
| Penyusunan SQL | Otomatis di library bersama | Tetap di model modul (`MdlRawPenjualan`, `MdlRawPembelian`) |
| Ubiquitous Language | Hilang | Terjaga 100 persen |
| Logika khusus | Kaku dan rapuh | Fleksibel di model domain sendiri |
| Peran template | God Object | Projection Formatter |

**Blueprint (Pesan 96).** `BLUEPRINT_REPORTING_REFACTOR_DDD.md` dibuat di `w:\san_29agus` dan disinkronkan ke `z:\san`. Isinya: prinsip arsitektur; kontrak data antar lapisan (`subjek_id`, `thn`, `bln`, `sum_qty_kredit`, `sum_qty_debet`, `sum_kredit`, `sum_debet`, `sum_hpp`); spesifikasi kode `MonthlyMatrixFormatter.php` kompatibel PHP 5.6; contoh implementasi memangkas sekitar 500 baris menjadi 30 baris; roadmap tiga fase non-breaking.

**Implementasi (Pesan 98-101).** Checklist kesiapan: folder `application/libraries/laporan/` sudah tersedia; enam method query SO di `MdlRawPenjualan` lengkap di kedua workspace; kontrak view `laporan_periode.php` terpetakan (`src_harians`, `src_margins`, `src_qty`, `sumbulanan`, `subjekYgTerlibats`, tombol `$btn_*`); arsitektur dirancang murni array kompatibel CI 3.1.8. Hasil: `MonthlyMatrixFormatter.php` dibuat, `ceksobulanan()` dipangkas sekitar 300 baris *switch-case* duplikat sehingga setiap `case` hanya memilih method domain query dan model master lalu mendelegasikan formatting ke `$this->monthlymatrixformatter->formatMonthlyData()`. Pesan 106-107 meneruskan penerapan pada `cekpenjualanbulanan()`.

### 7.11 Topik J: Dead code dan refaktor controller

**Audit `Penjualan.php` (Pesan 108-111).** Static analysis atas 34 method dengan 3.258 berkas aplikasi dan konfigurasi menu `heMenu.php`. Enam method mati yang tidak pernah dipanggil: `so2`, `soindek`, `sosales`, `produkpercustomer`, `viewisipenjualanbulananper`, dan `test`. Setelah dibuang tersisa 28 method aktif dan lint PHP lolos.

**Audit `PenjualanCompare.php` (Pesan 112-113).** 3.651 baris, memetakan dua menu (`vieworderpenjualan` dan `viewepenjualan`), 140 titik debug print, potensi celah hardcode tahun 2022 pada prototipe awal, serta file duplikat `PenjualanCompare2.php`.

**Keputusan (Pesan 114-119).** User memilih Opsi 2, refaktorisasi menyeluruh berbasis DDD, lalu hapus file tidak terpakai. Namun hardcode "2022" **dibiarkan** atas permintaan eksplisit: "untuk bagian hardcode 2022 kita biarkan saja sebelum tahu persis, mengapa/alasan apa, dalam koding kok ditulis semacam itu". Penjelasan: nilai `2022` berasal dari prototipe awal versi 1 (`cekSellerBl` dan `cekSellerOrderBl`) pada tahun 2022, sedangkan versi 2 yang aktif dipanggil view (`cekSellerBl2` dan `cekSellerOrderBl2`) sudah memakai parameter tahun dinamis `isset($_GET['thn']) ? $_GET['thn'] : dtimeNow('Y')`. Hasil: 3.652 baris menjadi 850 baris bersih, 140 debug print dihapus, `PenjualanCompare2.php` dihapus, lint PHP lolos.

**Regresi halaman (Pesan 120-121).** Halaman tidak bisa dibuka. Penyebab: pada `viewepenjualan()` dan `vieworderpenjualan()`, parameter `sum_null` sebelumnya tidak sengaja aktif memanggil `laporan/Crm/maintenance` sehingga view ter-override halaman maintenance. Method pelengkap `viewepenjualanside`, `cekSellerBl2Side`, `vieworderpenjualanside`, dan `cekSellerOrderBl2Side` (yang dipanggil tombol navigasi "Side Table") dipulihkan.

**Regresi 503 (Pesan 122-123).** `/checkAndSyncBackground?thn=2026` mengembalikan 503 karena `checkAndSyncBackground()` dan `doSync()` terhapus saat pembersihan controller, padahal template `laporan_compare.php` memanggilnya lewat AJAX background. Kedua method dipulihkan dan respon kembali HTTP 200 JSON.

**Pelajaran.** Aggressive dead-code removal pada controller besar dengan banyak entry point non-menu (AJAX, side table, background sync) menghasilkan regresi. Static analysis harus mempertimbangkan template view dan endpoint dinamis, bukan hanya `heMenu.php`.

### 7.12 Topik K: Rekonsiliasi total kategori

**Gejala (Pesan 124-125).** Total kategori Rp 79.900.235.173 berbeda dari subjek lain Rp 81.888.905.309. Selisih **Rp 1.988.670.136** berasal dari transaksi SO Project (tabel `produk_project`) yang belum punya relasi kategori (`kategori_id = NULL`). Sumber: user menyebutkan total 79.900.235.173 sebagai penjualan produk reguler ber-kategori.

**Alternatif solusi (Pesan 127).** Tiga opsi dievaluasi: Grouping Fallback (Opsi A), Filter Segmentasi UI (Opsi B), dan Normalisasi Database (Opsi C).

**Keputusan (Pesan 130-133).** User mengusulkan pemisahan menjadi dua baris. Diterapkan di `MdlRawPenjualan.php` pada tiga method: `callJoinSummary()`, `callSummaryKategoriProdukSoBulanan()`, dan `callSummaryKategoriProdukBulanan()`. Baris `PROJECT` untuk `tipe_id = 2` dengan nilai Rp 34,39 Miliar; baris `BELUM DISET KATEGORI` untuk `kategori_id IS NULL OR 0` dengan nilai Rp 26,6 Juta. Total rekonsiliasi berhasil mencapai Rp 81.888.905.309.

**Regresi 500 (Pesan 134-135).** CI3 Active Record secara default meng-escape ekspresi `group_by()` menggunakan backtick, sehingga query `CASE WHEN` rusak menjadi ``GROUP BY `CASE WHEN...` `` dan menghasilkan syntax error MySQL. Solusi: gunakan alias `kategori_id` yang sudah didefinisikan di SELECT dan set parameter `$escape = FALSE` pada `$this->db->select()` serta `$this->db->group_by()`. Pipeline `MonthlyMatrixFormatter` diuji berhasil tanpa error.

### 7.13 Topik L: Rekonsiliasi tiga titik

**Temuan (Pesan 137).** Di `Graph.php` `viewSummary_2`, nilai YTD sudah memakai real-time `_get_order_ytd_live`, tetapi MTD masih membaca snapshot cache `penjualan_order` (Rp 352.921.591). Nilai real-time pada `__raw_rek_pembantu__4010` untuk SO Netto September 2026 adalah **Rp 336.215.982** (Gross Rp 401.080.851 dikurangi Reject Rp 64.864.869). Diusulkan penambahan `_get_order_mtd_live()` pada `Graph.php`.

**Koreksi assistant (Pesan 140).** User mengoreksi dengan kalimat "anda salah baca, laporan outstanding kita lihat di kolom new order netto value nilainya 352 juta juga". Awalnya assistant menduga akumulasi bergerak salesman Shafana Robbayati (Rp 31.902.231 versus riil Rp 15.196.622, selisih Rp 16.705.609), tetapi koreksi user menunjukkan kolom New Order Netto Value pada Laporan Outstanding memang 352 juta.

**Konfirmasi akhir (Pesan 143).** Ketiga titik, yaitu Dashboard MTD, Laporan SO Bulanan, dan Laporan Outstanding New Order Netto, seharusnya 100 persen selaras di angka riil **Rp 336.215.982**. Angka Rp 352.921.591 adalah akumulasi berjenjang SPO plus SO pada cache Laporan Outstanding.

**Eksekusi lintas workspace (Pesan 144-147).** Cross-check `san_29agus` terhadap `san_3sep`: sinkronisasi `MdlRawPenjualan.php` ke `w:\san_3sep` dan penerapan `_get_order_mtd_live()` pada `Graph.php` di kedua workspace. Hasil verifikasi linter PHP dan runtime query: **SO MTD = Rp 336.215.982**, **SO YTD = Rp 81.888.905.309**.

## 8. Standar Penulisan Bahasa (Sentence Case Review)

### 8.1 Status

Berkas `LANG_SENTENCE_CASE_REVIEW.md` adalah **draft**. Pernyataan eksplisit di baris 3: "Belum ada perubahan pada file sumber. Dokumen ini hanya untuk review usulan perubahan teks ke sentence case." Total kandidat: **86**.

| Berkas | Jumlah kandidat |
|---|---|
| `x:\san_ibb\app\Language\Indonesian\custom_lang.php` | 40 |
| `x:\san_ibb\app\Language\english\custom_lang.php` | 46 |

### 8.2 Pola perubahan yang diusulkan

1. **Import dan upload data.** `import_summary`: "Ringkasan Import" menjadi "Ringkasan import"; `import_failed`: "Import Gagal" menjadi "Import gagal"; `import_result`: "Hasil Import" menjadi "Hasil import"; `import_validation_failed`: "Validasi Data Gagal" menjadi "Validasi data gagal"; `import_completed_with_issues`: "Import Selesai dengan Kendala" menjadi "Import selesai dengan kendala"; `import_rejected_details`: "Detail Data yang Ditolak:" menjadi "Detail data yang ditolak:". Termasuk `import_duplicate_modal_ok`: `OK` menjadi `Ok` (baris 131 ID, 397 EN).
2. **Excel menjadi excel.** `excel` ditulis lowercase karena dianggap nama format umum: `import_duplicate_excel_modal_title`: "Data duplikat di Excel" menjadi "Data duplikat di excel"; `import_duplicate_excel_modal_details_label`: "Daftar data duplikat (Excel):" menjadi "... (excel):"; `import_sample_note`: "download ulang sample Excel" menjadi "sample excel".
3. **Status CRM Lead.** `Lost`, `Branch Manager`, `Nanti`, `Konfirmasi`, dan `Approve` menjadi lowercase bila berada di tengah kalimat. Contoh: `lead_status_lost_request_title`: "Ajukan status Lost" menjadi "Ajukan status lost"; `lead_status_lost_requires_approval`: "Perubahan ke status Lost harus disetujui oleh Branch Manager." menjadi "... disetujui oleh branch manager."; `lead_workflow_note_required_later_label`: "Catatan (wajib saat Nanti)" menjadi "Catatan (wajib saat nanti)". Placeholder `{0}` pada `lead_status_lost_requires_approval_by` dipertahankan.
4. **Hak akses dan label UI.** `can_import_clients`: "Dapat iImport klien" menjadi "Dapat iimport klien" (ID baris 322); `upload_image_template`: "Unggah Template" menjadi "Unggah template"; `setting_print`: "Setting Print" menjadi "Setting print"; `estimate_number`: "Nomer Penawaran" menjadi "Nomer penawaran"; `text_lampiran_photo_print`: "Lampirkan Photo saat Print" menjadi "Lampirkan photo saat print".

### 8.3 Catatan metodologis

* Setiap kandidat diberi **nomor baris persis** pada berkas sumber sehingga dapat diverifikasi.
* Usulan mencakup string HTML inline, misalnya `lead_status_history_legend_snoozed` yang memuat `<span class="legend-badge legend-delayed">Ditunda</span>`; hanya teks di dalam kutip yang diturunkan, tag HTML-nya tidak diubah.
* Ada kandidat yang konsisten secara linguistik tetapi berisiko: menurunkan huruf pertama setelah titik dalam string satu kalimat panjang, misalnya `import_duplicate_db_modal_message` yang berbunyi "Data yang tidak valid tidak akan disimpan. Hanya data valid yang akan disimpan." menjadi "... akan disimpan. hanya data valid ...". Ini perlu tinjauan native speaker sebelum diterapkan.

## 9. Temuan Lintas-Dokumen, Kontradiksi, dan Tindak Lanjut

### 9.1 Kontradiksi yang terdokumentasi eksplisit

| No | Tematik | Versi A | Versi B | Sumber |
|---:|---|---|---|---|
| 1 | Model kategori laporan | `MdlProdukKategori` (lebih hemat memori) | `MdlProduk` karena fatal error `callSpecs()` undefined | TRANSKRIP 67 vs 69-71 |
| 2 | Prefiks `dtime` di `Penjualan.php` | `date(transaksi_data_registry.dtime)` | `date(transaksi.dtime)` | TRANSKRIP 12 vs 16 |
| 3 | Source of truth angka dashboard | Cache `penjualan_order` = Rp 78.795.145.984 | Raw `__raw_rek_pembantu__4010` = Rp 81.749.894.731 (02 Sep) lalu Rp 81.888.905.309 (03 Sep) | TRANSKRIP 76 vs 87 vs 147 |
| 4 | Angka MTD September | Cache Rp 352.921.591 (dashboard dan Outstanding) | Riil Rp 336.215.982 | TRANSKRIP 137, 140, 143 |
| 5 | Angka total kategori | Rp 79.900.235.173 | Rp 81.888.905.309 setelah pemisahan PROJECT | TRANSKRIP 125 vs 133 |
| 6 | Workspace aktif | Fokus hanya `san_29agus` (Pesan 40) | Sync ke `z:\san` tetap dijalankan (Pesan 89-101) sebelum koreksi protokol | TRANSKRIP 40 vs 101 vs 104 |

### 9.2 Inkonsistensi dan gap antar dokumen

1. **Nomor total YTD berubah dalam dua hari.** TRANSKRIP Pesan 87 mencatat Rp 81.749.894.731, sedangkan Pesan 147 pada 2026-09-03 mencatat Rp 81.888.905.309 untuk parameter yang sama (SO YTD 2026). Kemungkinan besar ada mutasi SO baru pada 3 September, tetapi dokumen tidak menjelaskan secara eksplisit. **Tidak boleh dianggap kontradiksi tanpa verifikasi DB.**
2. **Skema tabel berbeda antara domain.** Tabel `__raw_rek_pembantu__4010` memakai kolom `qty` dan `nilai`, sedangkan tabel `transaksi` memakai `dtime` dan `nomer`. Keduanya dipakai pada sesi berbeda dan tidak pernah dipetakan secara eksplisit dalam satu dokumen.
3. **Pre-existing bug masih terbuka.** Dua gap dari 2026-06-07 dicatat pre-existing dan tidak diperbaiki: (a) mismatch nama field `qty` ke `jml` dan `name` ke `nama` pada komponen LockerStock; (b) data loss pada edge case S13/S14 dengan `cart_key = variant:X:Y` dan `variant_id` bernilai 0 atau string. Selain itu `followupPreview()` di `FollowUp.php` (lookup `tableIn_detail_values` by `produk_id` tanpa variant awareness) dicatat belum difix pada 2026-06-06 dan tidak ada entri lanjutan yang menutupnya.
4. **Dokumen rujukan lintas-workspace belum tersedia dalam sumber.** `dev-jurnal.md` merujuk `docs/blueprint-selector-variant-picker.md`, `docs/blueprint-progress-tracker.md`, dan `AGENT_GLOBAL`. `2026-06.md` merujuk `docs/15-skenario-verifikasi-konversi-items-gate.md`. TRANSKRIP merujuk `BLUEPRINT_REPORTING_REFACTOR_DDD.md` dan `application/libraries/laporan/MonthlyMatrixFormatter.php`. Tidak satu pun berkas tersebut termasuk dalam 10 file sumber sintesis ini, sehingga status terkini mereka tidak terverifikasi.
5. **Path berubah-ubah antar entri.** Workspace yang muncul: `w:\san_staging`, `\\192.168.5.14\web\san_staging`, `w:\new_san_variant`, `w:\san_29agus`, `w:\san_add_29agus`, `w:\san_3sep`, `z:\san`, `w:\everest_29agus`, `x:\san_ibb`, `san_ibb_2jul`, plus domain `san.mayagrahakencana.com` dan `demo.mayagrahakencana.com`. `san_ibb` dan `san_ibb_2jul` menunjuk snapshot berbeda. Tidak ada peta workspace resmi dalam sumber.
6. **Baseline 2022 di `PenjualanCompare.php` dipertahankan.** Ini keputusan sadar, bukan kelalaian, dan dicatat eksplisit: versi 1 adalah prototipe tahun 2022 dan masih memakai konstanta, sedangkan versi 2 sudah dinamis. Dead-code removal tidak boleh menghapus versi 1 sebelum alasan bisnisnya jelas.
7. **Relasi `viewSummary_2` dengan `callSummary()`.** Pesan 87 menyebut feature flag dipasang pada `callSummary()` **dan** `callSummary_now()`, sementara Pesan 76 dan 137 menyebut endpoint `viewSummary_2()`. Hubungan ketiganya tidak dijelaskan; perlu konfirmasi apakah `viewSummary_2()` memanggil salah satu dari dua method tersebut.
8. **Uji database pada fix P0 2026-06-11 belum pernah dikonfirmasi.** Entri jurnal menyatakan "Belum ada regresi test di DB (perlu konfirmasi user untuk smoke test)". Tidak ada entri sesudahnya yang menutup gap ini, sementara fix 2026-06-15 menambahkan 261 baris konfigurasi baru di atas pipeline yang sama.

### 9.3 Pola rekurensi yang layak dicatat

* **Silent failure lebih berbahaya dari fatal error.** Muncul dua kali: agregasi qty varian 22 + 7 menjadi 29 per baris tanpa error; pengelompokan kategori salah tetapi tabel tetap tampil.
* **Overwrite oleh editor IDE.** Perubahan pada `MdlTransaksi.php` hilang karena tab terbuka dan autosave. Rekomendasi yang muncul: reload tab dari disk sebelum melanjutkan.
* **Aggressive cleanup tanpa peta entry point.** Penghapusan enam method mati di `Penjualan.php` aman, tetapi refaktor `PenjualanCompare.php` menghapus `checkAndSyncBackground()` dan `doSync()` yang dipanggil AJAX dari template view sehingga menyebabkan 503.
* **Escaping default CodeIgniter Active Record.** `group_by('CASE WHEN ...')` di-escape dengan backtick sehingga SQL rusak; solusi `$escape = FALSE` plus alias kolom.
* **Dokumentasi yang tertinggal di produksi.** `AGENT_GLOBAL` sengaja tidak diperbarui untuk fitur variant demi mencegah agent lain bingung. Keputusan sadar yang harus dihormati saat handover.
* **Konfirmasi eksplisit sebelum eksekusi.** Pada seluruh blok perubahan kode besar dalam transkrip, assistant selalu disajikan opsi dan trade-off lebih dulu, dan user memberi persetujuan eksplisit ("setuju") sebelum eksekusi.

### 9.4 Rekomendasi tindak lanjut

1. **Tutup pre-existing bug konversi.** Dua gap dari 2026-06-07 (mismatch `qty` ke `jml`, edge case S13/S14) dan satu gap dari 2026-06-06 (`followupPreview()` variant-unaware) belum pernah ditutup. Buat entri jurnal eksplisit ketika ditutup.
2. **Verifikasi angka YTD di database.** Selisih Rp 81.749.894.731 terhadap Rp 81.888.905.309 pada parameter yang sama perlu klarifikasi sebelum dipakai sebagai baseline.
3. **Dokumentasikan peta workspace.** Tambahkan satu dokumen yang memetakan `san_staging`, `new_san_variant`, `san_29agus`, `san_add_29agus`, `san_3sep`, `z:\san`, dan `san_ibb` ke peran, domain, dan status sinkronisasinya.
4. **Konfirmasi `_get_order_mtd_live()` di `san_3sep`.** Metadata terakhir menyebut sinkronisasi sudah dieksekusi; perlu konfirmasi bahwa ketiga titik (dashboard MTD, laporan SO, laporan Outstanding) kini menunjukkan Rp 336.215.982.
5. **Petakan entry point sebelum dead-code removal.** Untuk controller besar dengan template AJAX (`PenjualanCompare.php`, `Penjualan.php`), inventarisasi panggilan dari view, JavaScript, dan CLI sebelum menghapus method.
6. **Tinjau kandidat sentence case berisiko.** String satu kalimat panjang yang menurunkan huruf setelah titik perlu tinjauan native speaker sebelum diterapkan ke 86 key.

## 10. Lampiran: Daftar File Sumber

| Nama File | Ukuran (byte) | Topik H1 | Peran |
|---|---:|---|---|
| `dev-jurnal.md` | 11.427 | `# Jurnal Pengembangan (Dev-Journal) - Modul Konversi` | Jurnal sesi konversi 2026-06-26: dual-write `ComLockerStockDualWrite`, FIFO varian, lima bug selector variant picker, rewrite `Backfilllockervariant.php`, status UAT |
| `2026-05.md` | 15.622 | `# Journal 2026-05` | Dev journal Mei, 23 entri: debugging session key varian di `FollowUp.php`, ghost key FIFO average, guardrail `AGENTS.md` |
| `2026-06.md` | 18.500 | `# Dev Journal 2026-06` | Dev journal Juni, 11 entri: reset varian, variant picker UI, `tableIn_detail`, error 5049, dual-locker co-update, guard P0 core pipeline, variant entries 2334/2336/2337 |
| `KONTEKS_SESI.md` | 7.419 | `# Konteks Sesi - san_ibb_2jul` | Handover fitur Estimates/CRM: lock estimate, dropdown Group B dengan alamat, card Detail Transaksi, info DB `ibb_6jul` dan UI Elements 582 |
| `KONTEKS_DAN_HANDOVER_DELTA_SYNC_PRODUK.md` | 5.691 | `# KONTEKS & HANDOVER TEKNIS: TIMESTAMP-BASED DELTA SYNC PRODUK` | Handover delta sync produk holding-cabang: endpoint `seeUpdatedSince`, model batch fetch, live progress bar, tiga test PASS |
| `TRANSKRIP_PERCAKAPAN_LENGKAP.md` | 151.350 | `# Transkrip Percakapan Lengkap Sesi` | Sumber terbesar, 147 pesan 2026-09-01 s/d 2026-09-03: error 1052, export XLSX, Laporan SO, rekonsiliasi dashboard, template DDD, dead code, rekonsiliasi kategori |
| `blueprint_CRM_point1_buat_baru_estimates.md` | 6.145 | `# Blueprint: Fitur "Buat Baru" pada Penawaran (Estimates)` | Desain item ad-hoc pada penawaran: tabel `estimate_custom_items`, lifecycle mapping, blokir konversi SO. Belum diimplementasikan |
| `ESTIMATES_ENTERPRISE_SPRINT_PLAN.md` | 4.770 | `# Estimates Enterprise Sprint Plan` | Sprint plan 0-4 untuk reporting enterprise Estimates: KPI, pivot per role, audit board, UAT, go-live checklist, risk register, hypercare |
| `blueprint-dual-locker-co-update-variant.md` | 8.968 | `# Blueprint: Dual-Locker Co-Update untuk Variant (Parent + Variant)` | Desain P0: tiga titik mutasi, konsep parent aggregate, helper `coUpdateParentLocker()`, lima skenario step, sembilan skenario regression |
| `LANG_SENTENCE_CASE_REVIEW.md` | 11.838 | `# Language Sentence Case Review (Draft)` | Review usulan sentence case pada dua language file `x:\san_ibb`: 40 kandidat ID dan 46 kandidat EN. Belum diterapkan |

Total ukuran sumber: 241.330 byte dari 10 file.
