# EKOSISTEM AI AGENT: PROTOKOL, GERBANG AGENT, DAN ATURAN TIM ERP MULTI-AGEN
**Dokumen sintesis konsolidatif 30 sumber markdown**
**Objek:** Enterprise ERP Legacy CodeIgniter 3 - Single Variant Standard Migration
**Ruang lingkup:** Gatekeeper, Scope Lock, 11 subagent, gerbang kerja wajib, standar komunikasi, checklist rollout
**Sifat dokumen:** Acuan referensi tunggal. Setiap butir diturunkan langsung dari berkas sumber; tidak ada aturan, nama file, atau nama skill yang disintesis tanpa rujukan.

## 1. Ringkasan Eksekutif
Ekosistem ini adalah lingkungan kerja AI multi-agen untuk sebuah ERP legacy (PHP 5.6 / CodeIgniter 3.1.8) dengan 11 subagent yang terbagi menjadi dua lapisan: **Orchestration Layer** (MOD, PLN, EXE, TEC) dan **Domain Specialist Layer** (PO, CTA, ARC, TRS, TAX, SWE, QA). Pintu masuk tunggal adalah Moderator (MOD); seluruh komunikasi eksternal melewati MOD.

Tiga lapisan aturan yang saling menumpuk:

1. **Lapisan identitas dan gerbang (gatekeeper):** MOD/PLN/EXE wajib mengetahui nomor Agent (1 sampai 7), lalu wilayah kerjanya dikunci permanen. Modul di luar jatah disebut `CRITICAL VIOLATION`. Ada **Identity Shift Protocol**: perpindahan peran hanya sah setelah izin User.
2. **Lapisan kode mutlak:** setiap operasi tulis keuangan wajib ACID (`trans_start` / `trans_complete`), wajib Query Builder atau Binding Query, wajib komentar `[ROLE]` / `[PURPOSE]` / `[COMPLIANCE]`, dan dilarang `UPDATE` / `DELETE` pada tabel mutasi keuangan (harus jurnal storno `INSERT`).
3. **Lapisan rollout varian:** Feature Flag `singleVariantStandard` **wajib tetap `enabled => false`** sampai rollout diverifikasi. Dual-write stok wajib lewat satu entry point: `ComLockerStockDualWrite::pair()`. Ada 19-20 invariant yang disebut "20 Pattern Rules" untuk mencegah regresi (transaksi split, error 5180, modal menempel, nota cetak 0, stok locker mismatch).

Lima pilar kebutuhan bisnis yang wajib dipenuhi bersama seluruh agen: Daily Operational Accounting; Financial Analysis and Reporting; Verification and Banking Integration; Corporate Tax Compliance; Governance and Internal Audit (audit-ready lewat Immutable Audit Log).

Status dokumen sumber saling bertentangan pada beberapa titik kritis: nilai sentinel `variant_id` (-1 vs 1), path workspace (5 varian), direktori rules (`.agents` vs `.workflow`), dan status feature flag (tetap `false` vs "sudah aktif"). Semua kontradiksi diinventarisasi pada Bagian 11 dan harus diputuskan sebelum eksekusi lanjut.

## 2. Protokol Gerbang Agent & Alur Kerja Wajib
### 2.1 Gerbang 1 - Verifikasi Identitas (Langkah 1, blocking)
Prosedur ini mensyaratkan penghentian total. Sumber: `AGENTS.md`.

1. Periksa apakah prompt instruksi menyebut nomor Agent tertentu (Agent 1 sampai 6).
2. Jika tidak ada deklarasi jelas: **WAJIB BERHENTI SEKARANG**.
3. Tanyakan langsung ke User: "Sesuai protokol AGENTS.md, kita akan bertindak sebagai Agent ke-berapa untuk sesi ini?"
4. Tidak ada modifikasi file apa pun sampai User memberikan angka Agent (1 sampai 6).

### 2.2 Gerbang 2 - Scope Lock / Kunci Wilayah Kerja (Langkah 2)
Setelah nomor Agent diketahui, wilayah kerja **dikunci permanen untuk sesi ini**:

| Agent | Modul Miliknya | Catatan |
|:-----:|----------------|---------|
| 1 | `konversi`, `konversi_varian` | Konversi stok + varian |
| 2 | `pembelian`, `pembelianimport`, `biaya` | Pembelian + biaya supplies |
| 3 | `penjualan`, `penjualanproject` | Penjualan barang + project |
| 4 | `pindahgudang`, `opname` | Transfer gudang + opname |
| 5 | `distribusifg`, `distribusiproduksi`, `distribusisupplies` | Distribusi FG, produksi, supplies |
| 6 | `produksi`, `produksiproses`, `adjustment` | Produksi + adjustment |
| 7 | `pembatalan` | Boleh melakukan semua yang dilakukan Agent 1-6, dan boleh keluar dari modul Agent 1-6 **sesuai perintah** |

Aturan scope: hanya boleh memodifikasi file di `application/modules/[nama_modul_anda]/`. Modul `konversi` boleh dibaca **hanya sebagai referensi, DILARANG diubah**. Menyentuh folder modul di luar jatah = **CRITICAL VIOLATION**.

### 2.3 Gerbang 3 - Baca UAT Checklist (Langkah 3, WAJIB sebelum kerja)
1. Baca `docs/uat-checklist.md` memakai tool `view_file`.
2. Cari section modul berdasarkan nomor Agent.
3. Identifikasi item berstatus `X` (belum) atau magnifier (perlu verifikasi) - itu tugas Anda.
4. Pahami item berstatus `Y` (sudah) - **JANGAN ulangi** pekerjaan yang sudah selesai.
5. Setelah memahami posisi, baru mulai mengerjakan tugas.

Contoh deklarasi yang diharapkan:
> "Saya sudah membaca UAT Checklist. Modul [nama_modul] status: Dual-Write Y, Feature Flag X, Variant Picker X. Saya akan mengerjakan Feature Flag dan Variant Picker."

### 2.4 Gerbang 4 - Update UAT Checklist (Langkah 4, WAJIB setelah selesai)
| Dari | Ke | Kapan |
|------|----|-------|
| `X` | `Y` | Sudah selesai dan terverifikasi (`php -l` lolos, kode benar) |
| `X` | magnifier | Sudah dikerjakan tapi perlu verifikasi manual / UAT |
| magnifier | `Y` | Sudah diverifikasi |

Contoh baris update: `| 3.1 | coTransaksiCore.php: Feature flag singleVariantStandard | Y | Ditambahkan 2026-07-04 |`

Kapan update: setiap kali selesai 1 item (jangan menumpuk di akhir sesi), sebelum mengakhiri sesi (final sync), dan sebelum pergeseran identitas. **JANGAN mengubah status item milik Agent lain** kecuali mendapat izin pergeseran identitas.

### 2.5 Gerbang 5 - Protokol Pergeseran Identitas (Identity Shift)
1. Wajib meminta izin ke User: "Tugas Agent ke-XX sudah selesai 100%. Mohon konfirmasi apakah saya diizinkan bergeser bertindak sebagai Agent ke-YY?"
2. Setelah disetujui, wajib mendeklarasikan identitas baru di pesan berikutnya **sebelum** menyentuh modul baru.
3. Update UAT Checklist modul lama sebelum pindah.

### 2.6 Gerbang 6 - Pemeriksaan Backward Compatibility (Langkah 6)
Setiap analisis, penulisan kode, atau pengujian yang butuh verifikasi kompatibilitas ke belakang **wajib aktif membandingkan** berkas yang bersangkutan dengan salinan asli:

- **Direktori Referensi Produksi:** `W:\new_original_indosan_for_variant/`

Pahami perbedaan struktur session, model, dan alur data orisinal sebelum memodifikasi kode.

### 2.7 Gerbang 7 - Aturan Setiap Menulis/Editing Kode (Langkah 7)
- Selalu meninggalkan catatan saat menambahkan fungsi, menambah baris kode, mengedit baris kode, atau memperbaiki mekanisme panjang. Inti: **setiap yang berubah harus ada keterangan mengapa diubah dan kapan diubah**.
- Agent berlaku sebagai hakim, dan selalu menerapkan ISO serta best practice saat menganalisa, membuat mekanisme panjang, dan memperbaiki kode.

### 2.8 Gerbang 8 - Audit 3-Layer (WAJIB pada setiap review kode)
| Layer | Objek | Metode | Ambang |
|-------|-------|--------|--------|
| Layer 1 | Static Code Analysis | Sintaks PHP, RBAC Security `?o=`, guard `isset()`, PSAK 14 / IFRS | Wajib 100% lolos |
| Layer 2 | DB Schema Verification | `$this->db->list_tables()` dan `$this->db->list_fields()` sebelum menyimpulkan kueri JOIN | Mencegah MySQL Error 1146 |
| Layer 3 | Empirical DOM and Performance | Estimasi DOM nodes = N_produk x N_kolom x N_cabang | Jika > 3.000 nodes, WAJIB Server-Side 2-Pass Slicing Pagination Engine, default 50 row per halaman, respon < 1 detik |

Aturan turunan Layer 3:

- **WYSIWYCS (What You See Is What You Can Search):** seluruh kolom metadata yang tampil di tabel UI (`produk_kategori`, `folder_produk`, `p.label`, `p.jenis`, SKU Varian) wajib didukung kueri SQL multi-field (`WHERE` + `LEFT JOIN`) agar pencarian non-produk 100% cocok.
- **Single Variant Stock Aggregation Integrity:** seluruh pembacaan stok Katalog wajib mengintegrasikan `stock_locker_variant` (via `he_fetch_katalog_stock_variant()`) di samping `stock_locker`.
- **Single UI Search Bar Architecture:** pada halaman yang sudah punya Search Bar Global Server-Side, DataTables JS wajib `searching: false` dan `dom: 'lBrtip'`.

### 2.9 Gerbang 9 - Struktur Respon Wajib (Kesimpulan dan Status Eksekusi Terbuka)
- **WAJIB menyertakan KESIMPULAN** di bagian akhir setiap respon.
- **TIDAK BOLEH ambigu:** Agent wajib memisahkan secara eksplisit daftar pekerjaan **SUDAH SELESAI DIEKSEKUSI dan DIVERIFIKASI** (disertai bukti syntax test atau file diff) dari daftar pekerjaan **BELUM DIEKSEKUSI** (masih analisis atau dokumen roadmap).
- Tujuannya: User mengetahui posisi fisik kode saat ini tanpa salah paham.

### 2.10 Gerbang 10 - Aturan File Sampah (Garbage Files)
JANGAN pernah memodifikasi file sampah. Ciri: dua garis bawah di depan atau belakang nama file sebelum ekstensi `.php` (contoh `__FollowUp.php`, `FollowUp__.php`), juga pola `*_OLD.php`. Jika ragu apakah boleh diedit, **wajib mengajukan pertanyaan ke User** sebelum perubahan apa pun.

## 3. Konteks Teknologi Terverifikasi
### 3.1 Stack Inti (Diverifikasi dari Codebase, Bukan Asumsi)
| Komponen | Nilai atau Lokasi |
|----------|------------------|
| Bahasa utama | PHP 5.6. **Hanya PHP, JANGAN Python untuk logika bisnis** |
| Framework | CodeIgniter **3.1.8** (`CI_VERSION = '3.1.8'` di `system/core/CodeIgniter.php`) |
| HMVC Extension | Wiredesignz MX **v5.5** (`application/third_party/MX/`), `subclass_prefix: MY_` |
| Database relasional | MySQL / MariaDB via `$this->db->...` CI Query Builder |
| Database NoSQL | MongoDB via library `application/libraries/Mongo_db.php` |
| Library pihak ketiga | PHPExcel (bukan PhpSpreadsheet), CodeIgniter Curl (Philip Sturgeon), Mongo_db, Layout |
| Runtime server | CentOS 7, MariaDB 10 |
| Dilarang | Namespace PHP (PSR-4), Composer autoloader untuk class bisnis, sintaks CI4 (`app/Controllers/`, `Services::`) |

### 3.2 Struktur Folder HMVC
```text
application/
|-- core/              # MY_Loader.php, MY_Router.php (extend MX)
|-- config/            # config.php, database.php, routes.php
|-- controllers/       # Controller non-modul
|-- helpers/           # he_*_helper.php (custom helpers)
|-- libraries/         # Library custom (Layout, Curl, Mongo_db, PHPExcel, dll)
|-- models/
|   `-- Coms/          # Model bisnis - prefix Com* (extends CI_Model)
|-- modules/
|   `-- [nama_modul]/
|       |-- config/    # coTransaksiCore.php, coTransaksiUi.php, coTransaksiLayout.php, coTransaksiValues.php
|       `-- controllers/
|           |-- Modul_Controller.php   # Base controller modul (extends MX_Controller)
|           |-- _shoppingCart.php      # Cart management + stock locker hold/active
|           |-- _processSelect*.php    # Add/edit/remove item + hold stock
|           |-- _selectorItem.php      # Product/supplies picker modal
|           |-- Create.php             # Create transaction (draft)
|           |-- FollowUp.php           # Approval / follow-up
|           `-- ...
|-- third_party/MX/    # Wiredesignz HMVC
`-- views/
```

Controller hierarchy: `CI_Controller` -> `MX_Controller` -> `Modul_Controller` -> `_shoppingCart`, `_processSelect*`, `Create`, `FollowUp`, dan seterusnya.

### 3.3 Konvensi Penamaan File Controller per Modul
| Prefix | Peran |
|--------|-------|
| `Modul_Controller.php` | Base controller - session validation, load 4 config |
| `_shoppingCart.php` | Cart management + stock locker hold/active |
| `_processSelect*.php` | Add/edit/remove item + hold stock (produk, supplies, jasa, biaya) |
| `_selectorItem.php` | Product/supplies picker modal |
| `_processPihak*.php` | Party (customer/supplier) selector |
| `Create.php` | Create transaction (draft) |
| `FollowUp.php` / `__FollowUp.php` | Approval / follow-up |
| `ActivityReport.php` | Transaction report |
| `Printing.php` | Print document |
| `Transaksi.php` | Transaction list |

### 3.4 Empat Config Wajib per Modul
| File | Isi |
|------|-----|
| `coTransaksiCore.php` | Gateway mapping, component (`Com*`) registration, FIFO, feature flag |
| `coTransaksiUi.php` | Step definitions, UI labels, form fields, handler keys |
| `coTransaksiLayout.php` | Table columns, layout rendering, `receiptDetailFields` |
| `coTransaksiValues.php` | Value mapping, calculation rules |

### 3.5 Aturan Coding Teknis
**Keamanan:** semua query WAJIB Query Binding (`$this->db->query($sql, $binds)`) atau Query Builder (`$this->db->where()->get()`). Dilarang query mentah tanpa binding. Pengecualian existing: beberapa `UPDATE transaksi SET indexing_*` di modul `produksi` memakai raw string untuk JSON blob - ini technical debt, **jangan ditiru**.
**Model Pattern:** prefix `Com*` extends `CI_Model` di `application/models/Coms/`. Load dengan `$this->load->model("Coms/ComLockerStockDualWrite");` lalu `$dw = new ComLockerStockDualWrite();`
**Helper Pattern:** prefix `he_` di `application/helpers/`. Load dengan `$this->load->helper("he_url");` (tanpa ekstensi `_helper`). Helper pairs di `application/helpers/Pairs/` format `he_cek_*_helper.php`, `he_pair_*_helper.php`. Penamaan file WAJIB berakhiran `_helper.php`.
**Transaksi Database:** selalu `trans_start()` / `trans_complete()` untuk operasi multi-query. DILARANG manual `BEGIN` / `COMMIT` / `ROLLBACK`.
**Kompatibilitas PHP 5.6 - DILARANG dipakai:** spread operator `...`, null coalescing `??`, anonymous classes, return type declarations, scalar type hints, `match` expression, named arguments. Pengganti wajib: `isset($x) ? $x : $default` (bukan `??`); `array()` syntax (bukan `[]` short array, meski kode baru sudah memakai - tetap `array()` untuk konsistensi); `function($x) { ... }` untuk closure (bukan arrow function `fn($x) =>`).
**Komunikasi kode:** komentar berbahasa Indonesia pada logika kompleks; langsung ke kode, jangan penjelasan teori panjang. Jika instruksi kurang jelas atau berpotensi merusak struktur database, tanyakan dulu sebelum menulis kode.
**Aturan PPN Factor (Session Login Fallback):** DILARANG mematikan aplikasi dengan `matiHEre("undefine ppn factor...")` atau `matiHere("gagal menghitung ppn...")`. Jika `$_SESSION[$cCode]["main"]["ppnFactor"]` kosong, wajib fallback ke `$_SESSION['login']['ppnFactor']` atau helper `my_ppn_factor()`, lalu simpan balik ke sesi cart.
**Aturan Otorisasi dan FollowUp (Unconditional Valid Qty Acceptance):** di seluruh `FollowUp.php`, DILARANG membatasi pengisian `$arrValidQtyReady[]` dengan `if ($hasInSession)`. Setiap baris dari DB dengan `valid_qty > 0` atau `effectiveValidQty > 0` **wajib** masuk `$arrValidQtyReady[]` secara unconditional untuk menjamin backward compatibility transaksi lama.
**Verifikasi Process Handler via `coTransaksiUi.php` (DILARANG mengasumsikan nama selector):** jangan pernah mengasumsikan semua modul memakai `_processSelectProduct.php`. Setiap modul mengonfigurasi handler di kunci `shoppingCartHandler`, `processHandler`, `selectorHandler`, atau `itemHandler`. Contoh nyata: `_processSelectSupplies`, `_processSelectJasa`, `_processSelectBiaya`, `_processSelectNotaItem`, `_processSelectAsset`, `_processSelectValas`.

### 3.6 Standar Refactoring: Thin Controller - Fat Service
| Nomor | Aturan |
|:-----:|--------|
| 4.1 | Method `private` yang hanya menghasilkan string HTML WAJIB diekstraksi ke Helper modul: `application/modules/[nama_modul]/helpers/he_[nama_modul]_ui_helper.php`, fungsi ber-prefix global (contoh `he_pembelian_ui_buildAddPihakButton()`) |
| 4.2 | Method public > 200 baris di Controller WAJIB diekstrak ke Library/Service: `application/modules/[nama_modul]/libraries/Lib[NamaModul][NamaController][Domain].php` (contoh `LibPembelianCreateSave.php`, `LibPembelianFollowUpRevert.php`) |
| 4.3 | Method > 2.000 baris -> 1 file Library per method. Domain < 2.000 baris boleh digabung. **Maks per file Library sekitar 5.000-8.000 baris** |
| 4.4 | Safe refactoring: suntik instance Controller (`$this->libpembeliancreatesave->processSave($this);`), tangkap sebagai `$c`, lalu regex replace literal `$this->` menjadi `$c->` agar dependensi CI (`$c->db`, `$c->session`) tetap jalan |
| 4.5 | Dokumentasi: Library wajib DocBlock lengkap (nama, deskripsi, `@param`, `@return`, asal usul) plus inline comment; Controller wajib **komentar Tombstone** yang menyebut nama method asli dan lokasi file Library tujuan. Blueprint per modul di `application/modules/[nama_modul]/docs/refactoring/` |
| 4.6 | Setiap Library baru wajib punya script test sederhana (file PHP mandiri) untuk memastikan tidak ada Fatal Error |
| 4.7 | Referensi: SOLID/SRP, Clean Code (Robert C. Martin), ISO/IEC 25010 Maintainability (Modularity, Analysability, Modifiability atau change locality, Reusability) |
| 4.8 | Workflow doc wajib di `docs/refactoring/workflow_[nama_modul].md`: Mermaid diagram alir, rincian langkah (Aktor `userGroup`, interaksi UI, logika sistem dan DB, dampak persediaan), cross-reference log aktivitas ke tabel `log` |
| 4.9 | UAT plan wajib di `docs/refactoring/uat_[nama_modul].md`: Automated Self-UAT (skrip PHP CLI) dan Manual Human UAT (pre-requisite `userGroup`, test case dengan data produk dan supplier riil aktif, expected result) |

### 3.7 Pengamanan Kritis Transaksi Locker (Titik Domino)
Pergerakan `stock_locker` dan `stock_locker_variant` pada `variantPicker()`, `shoppingcart->remove()`, dan `shoppingcart->reset()` adalah **titik kritis** penentu keberhasilan transaksi:

1. **Selector dan variantPicker:** pengurangan `active` dan penambahan `hold` wajib dibungkus `trans_start`/`trans_complete` dan didelegasikan mutlak melalui `ComLockerStockDualWrite` dengan variant ID presisi dari dropdown picker.
2. **shoppingCart->remove():** saat menghapus item tunggal, stok `hold` terkait wajib dirilis ke `active` via `ComLockerStockDualWrite` **sebelum** data session dihapus, untuk mencegah hold menggantung (stale).
3. **shoppingCart->reset():** rilis `hold` ke `active` dilakukan massal dalam transaksi DB, dan item session wajib dibersihkan dari nilai `<= 0` agar pre-processor FIFO tidak mengolah cache kosong.

### 3.8 "20 Pattern Rules" - Invariant Migrasi Single Variant Standard
Judul dokumen menyebut 20 aturan, namun hanya 19 nomor yang dienumerasi (lihat Kontradiksi K-5).

**Grup 5.1 - Database dan Config Mappings:**
1. `tableIn.detail` Mapping (`coTransaksiCore.php`): ganti `"produk_id" => "id"` menjadi `"produk_id" => "produk_id"` (numeric); wajib daftarkan `"valid_qty" => "jml"`, `"variant_id" => "variant_id"`, `"variant_nama" => "variant_nama"`, `"variant_label" => "variant_label"`.
2. Preview Table Headers (`coTransaksiLayout.php`): tambah `"variant_label" => "Varian / SKU"` persis di sebelah kanan `"produk_nama"` pada `receiptDetailFields`.
3. Cart Form Fields (`coTransaksiUi.php`): taruh `"variant_label" => "Varian / SKU"` di `shoppingCartFields` persis di sebelah kanan `"nama"`.
**Grup 5.2 - Operations Database dan WHERE Clause:**
4. **Klausa `WHERE` pada `$tru->updateData()` (CRITICAL, p Transactions split):** WAJIB memakai integer numeric `$realPid` (`(int)$dSpec['produk_id']`). DILARANG memakai string cart key `$iID` (`"variant:34:2048"`), karena MariaDB me-cast ke integer `0` (`34 = 0` -> FALSE), menyebabkan `0 rows affected`, `valid_qty` tidak berkurang, transaksi split.
5. **Candidate Key Matching di FollowUp:** pencarian `items`, `$validItems`, `extractedItems` di `followupPrePreview()`, `followupPreview()`, `doFollowup()` WAJIB mengecek kandidat berurutan: `$xid`, `$vKey` (`variant:produk_id:variant_id`), `$pId` (numeric), `(string)$pId`.
6. **Recovery Fallback Transaksi Lama:** jika `WHERE valid_qty > 0` mengembalikan 0 baris pada transaksi lama, wajib fallback pemulihan kuantitas dari `produk_ord_jml`.
7. **Resolusi Dynamic Variant Label:** jika `variant_label` kosong atau `'0'`, gunakan `resolveVariantLabelName($variantId)` untuk lookup SKU dari `var_product_variants`. Untuk item non-varian (`variant_id <= 1`) paksa `variant_label = ''` agar tidak tampil angka `'0'`.
**Grup 5.3 - Komparasi Staging dan Management Session Modal:**
8. **Parsing ID Numeric pada `itemStaging`:** wajib me-parse string cart key untuk mengambil numeric `produk_id` saat query `MdlProduk`, lalu memetakan hasilnya kembali ke cart key.
9. **Filter Baris Kosong dan Bypass Variant Item:** tambah filter `if ($rawKey === '' || $rawKey === '0' || $pId < 1) continue;` dan `if ($vId > 1) continue;`.
10. **Reset Session `tmpItems` dan Modal Auto-Close:** inisialisasi `$_SESSION[$cCode]['tmpItems'] = array();` di awal perulangan `itemStaging`; pada `updateItems()` jika `tmpItems` kosong, eksekusi `top.BootstrapDialog.closeAll()` dan arahkan `top.location.href` ke `followupPreview`; pada `doUpdateApproval()` bersihkan `tmpItems` dan tutup modal.
**Grup 5.4 - Stock Locker Dual-Write, Helper Cart Key, Normalisasi:**
11. **Stock Locker Write:** seluruh penulisan stok produk WAJIB via `ComLockerStockDualWrite::pair()`. Filter locker wajib menyertakan `addFilter("variant_id=" . $variantId)`.
12. **Cart Key Helper:** resolver cart key pada `he_[modul]_cart_key_helper.php` WAJIB mendukung parser regex string `variant:X:Y` tanpa direct `(int)$produkId`.
13. **Normalisasi Locker Stok Per-Row Direct Release (`Locker::normalisasiStok()`):** WAJIB pembersihan langsung per-ID primary key (`updateData(array("id" => $row->id), array("jumlah" => 0))`), lalu kembalikan kuantitas ke `active`. Ini mencegah jebakan `LIMIT 1` pada `findPreRow()` di `ComLockerStock` yang memicu error `code: 169` bila ada split rows.
14. **Pemetaan `lockerCheck` di `coTransaksiUi.php`:** fitur `lockerCheck` HANYA AKTIF (`"enabled" => true`) pada modul yang memindahkan, memotong, atau mengonversi stok (`pindahgudang`, `distribusifg`, `distribusisupplies`, `konversi`, `konversi_varian`, `biaya`, `requeststok`). Modul Pembelian Produk (`466`, `467`, `967`, `968`) dan Penjualan bernilai `"enabled" => false` atau `array()`.
15. **Arsitektur Buku Pembantu Varian:** `FifoProdukJadiVarian` melacak mutasi stok fisik dan HPP varian; `RekeningPembantuProduk` (tabel `_rek_pembantu_produk_cache`) mencatat saldo nilai di level produk induk; `RekeningPembantuProdukVarian` (tabel `_rek_pembantu_produk_varian_cache`) mencatat saldo per-SKU atau Variant ID (`extern2_id`).
16. **Pencegahan Kontaminasi Price Last Purchase:** `cekPriceProdukLastPurchase()` di `he_cek_price_produk_last_purchase_helper.php` WAJIB menyaring dan menolak entri `price_last_purchase` dengan `produk_id <= 0`. Tanpa saringan ini, `$result[0]` menyimpan harga lepas produk dan SELURUH PRODUK DI KERANJANG terkontaminasi harga 15.000.000.
17. **Pemetaan `shoppingCartFieldSrc`:** array WAJIB memetakan `"variant_label" => "variant_label"`, BUKAN `"variant_label" => "Varian / SKU"`. Pemetaan ke string label membuat `_shoppingCart.php` mencari key salah dan merender angka `0`.
18. **Standar Sintaks JS Selector untuk Variant ID (pencegahan error Sizzle `unsupported pseudo`):** untuk ID berformat `variant:X:Y`, DILARANG `$('#prefix_' + id)`. Gunakan Attribute Equals Selector `$('[id="prefix_' + id + '"]')` atau `$(document.getElementById('prefix_' + id))` agar titik dua tidak dievaluasi sebagai pseudo-class.
19. **Standar Validasi dan Referensi Terverifikasi (pencegahan halusinasi):** setiap pendapat teknis, usulan arsitektur, rekomendasi algoritma, atau penjelasan teori WAJIB berlandaskan sumber riil - artikel jurnal bereputasi dengan **DOI valid** atau buku referensi dengan **ISBN terdaftar**. DILARANG keras menyampaikan opini tanpa referensi, halusinasi teori, atau referensi fiktif.

### 3.9 Traffic Log Priority (Urutan Penanganan Bug dan UAT)
| Prioritas | Modul | Hits | Persentase |
|:---------:|-------|-----:|:----------:|
| 1 | `penjualan` dan `penjualanproject` | 11.750 | 45,4% |
| 2 | `pembelian` dan `pembelianimport` | 7.733 | 29,9% |
| 3 | `distribusifg` | 2.345 | 9,1% |
| 4 | `opname` | 626 | 2,4% |
| 5 | `konversi` dan `konversi_varian` | 512 | 2,0% |
| 6 | `distribusisupplies` | 290 | 1,1% |
| 7 | `produksi` | 276 | 1,1% |
| 8 | `distribusiproduksi` | 264 | 1,0% |
| 9 | `pindahgudang` | 57 | 0,2% |
| 10 | `adjustment` | 9 | 0,03% |

### 3.10 Pipeline Session dan Tabel Stok (Arsitektur 2-Level Dual-Write)
```text
stock_locker (PRODUCT LEVEL)          stock_locker_variant (VARIANT LEVEL)
  -> total per produk, untuk laporan   -> per variant, untuk transaksi
  -> 36 modul non-inventory baca ini   -> 19 modul inventory nulis di sini
  -> TETAP NULIS (dual-write)          -> TETAP NULIS (dual-write)
```

**Masalah baseline:** `ComLockerStockDualWrite` bernama "DualWrite" tapi hanya menulis ke 1 tabel (`stock_locker_variant`). Tulis ke `stock_locker` terjadi terpisah, dipanggil langsung dari controller, bukan dari wrapper.
**Target yang benar:** `ComLockerStockDualWrite::pair()` harus panggil `ComLockerStock::pair()` plus `ComLockerStockVariant::pair()`; `ComLockerStock::pair()` harus HAPUS skip `variant_id > 0` sehingga semua item ditulis sebagai parent; semua write stok lewat `ComLockerStockDualWrite`, tidak boleh bypass.
**Status sementara:** Agent tetap pakai `ComLockerStockDualWrite::pair()` (nulis ke `stock_locker_variant`), DAN memastikan `ComLockerStock::pair()` juga dipanggil terpisah sampai refactor selesai.
**Query verifikasi 0 mismatch** (expected 0 rows):

```sql
SELECT sl.produk_id, sl.cabang_id, sl.gudang_id, sl.state,
       SUM(sl.jumlah) AS parent, COALESCE(SUM(slv.jumlah), 0) AS variant
FROM stock_locker sl
LEFT JOIN stock_locker_variant slv
  ON sl.produk_id = slv.produk_id AND sl.cabang_id = slv.cabang_id
 AND sl.gudang_id = slv.gudang_id AND sl.state = slv.state
WHERE sl.jenis = 'produk'
GROUP BY sl.produk_id, sl.cabang_id, sl.gudang_id, sl.state
HAVING parent != variant;
```

### 3.11 FIFO Dual-Write - Modul Konversi sebagai Template
- `ComFifoProdukJadiVarian.php` - sentinel fix: `variant_id=0` menjadi `1`, skip `variant_id < 0`.
- Terdaftar di `konversi/config/coTransaksiCore.php` (4 Type 1 entries) dan `_coTransaksiCore.php` (4 entries).

Cara register di modul lain: tambah `FifoProdukJadiVarian` di `coTransaksiCore.php` setelah setiap `FifoProdukJadi` Type 1 yang punya `produk_id`, `unit`, `hpp`, `jml_nilai` di static, dengan static tambahan `variant_id`, `variant_nama`, `variant2_id`, `variant2_nama`, dan gate yang sama dengan parent. Field varian boleh tidak ada di gate karena akan auto sentinel.

Peringatan: **Hindari `replaceAll` untuk rsltItems FIFO** - variant yang baru didaftarkan juga memiliki `srcRawGateName => "rsltItems"` di closing-nya, menyebabkan `replaceAll` kaskade (variant ganda). `items2_sum` FIFO aman untuk `replaceAll`.

Filter sentinel di `ComFifoProdukJadiVarian::pair()`: `variant_id < 0` -> skip; `variant_id == 0` -> ubah jadi 1 (sentinel), proses; `variant_id >= 1` -> proses langsung.

## 4. Tabel Peran dan Tanggung Jawab (10+ Role)
| Peran | Kode | Tanggung Jawab | Aturan Kunci | Dokumen Sumber |
|-------|:----:|----------------|---------------|----------------|
| **Moderator (Pintu Gerbang)** | MOD | Menerima permintaan User, mengklarifikasi kebutuhan (maks 2 pertanyaan), menentukan routing ke PLN atau langsung EXE, menyampaikan laporan akhir. User HANYA berinteraksi dengan MOD | Tidak menjalankan kode atau perintah shell; tidak mengedit file kode sumber (hanya `workflow/*.md` dan `workflow/inter-log.txt`); HANYA SATU code block per output; code block plaintext murni tanpa nested; destruktif -> STATUS: perlu-konfirmasi | `01_moderator.md`, `moderator.md` |
| **Planner (Perencana dan Prompt Creator)** | PLN | Memahami instruksi MOD, baca/analisis kode relevan (JANGAN edit), menentukan sub-agent, menyusun rencana eksekusi berurutan, memanggil EXE, mereview laporan EXE | Tidak mengedit file kode sumber; tidak improvisasi di luar instruksi MOD; output akhir SATU code block berisi instruksi spesifik (nama file, nama fungsi, urutan langkah, batasan); dilarang menyertakan kode implementasi lengkap kecuali contoh singkat | `02_planner.md`, `planner.md` |
| **Executor (Eksekutor dan Pelapor)** | EXE | Mengeksekusi instruksi teknis: edit kode, jalankan shell, build/lint/test, buat laporan. Satu-satunya agent yang boleh edit file dan jalankan perintah (dalam model `/mod`) | Wajib verifikasi (build/lint/test, `php -l`, console check Playwright); aksi destruktif tidak disebut eksplisit -> HENTIKAN, STATUS: perlu-konfirmasi; error -> HENTIKAN, STATUS: gagal; tidak berimprovisasi di luar instruksi PLN | `03_executor.md`, `executor.md` |
| **Technical (Analisis Kode dan Bug)** | TEC | Analisis kode sumber ERP (CI3, PHP 5.6), deteksi bug teknis (SQL injection, XSS, CSRF, query error, N+1 query), optimasi query MariaDB, refactor modul lama | Jangan improvisasi di luar instruksi EXE; semua komunikasi dicatat ke `workflow/inter-log.txt`; audit memakai OWASP Top 10, wajib CI3 Query Builder tanpa raw query, ACID compliance, Immutable Audit Trail; honor flag `enable_subagent_tools` | `04_technical.md`, `technical.md` |
| **Product Owner and Business Analyst** | PO | Menerjemahkan kebutuhan bisnis akuntansi menjadi User Stories dan PRD; menetapkan Acceptance Criteria terukur; mengidentifikasi risiko bisnis dan dependensi antar modul | DILARANG menulis kode (PHP/JS/SQL) - arahkan ke SWE; DILARANG keputusan arsitektur (itu ARC); DILARANG menentukan logika pajak (itu CTA); setiap fitur akuntansi wajib mengikuti siklus Journaling -> Ledger -> Trial Balance -> Financial Statement; wajib rujuk ISO 9001:2015; maksimal 2 pertanyaan | `05_product_owner.md`, `AGENTS.md` Sec. 2.1 |
| **Compliance Tax (Auditor IFRS/PSAK dan Pajak)** | CTA | Audit rencana arsitektur dan fungsionalitas fitur dari sisi kepatuhan akuntansi; validasi kalkulasi pajak (PPN 11%, PPh 21/22/23/25/29); verifikasi Double-Entry; deteksi material misstatement | SANGAT SKEPTIS; wajib menyebut nama standar atau pasal spesifik; DILARANG KERAS menebak - jawab "Data tidak tersedia" atau "Membutuhkan konfirmasi eksternal"; WAJIB menolak (reject) bila kalkulasi pajak tidak akurat, pembulatan salah, jurnal tidak seimbang, atau pelanggaran GAAP; kritik dibagi tiga kategori | `06_compliance_tax.md`, `AGENTS.md` Sec. 2.2 |
| **Lead Architect (Security Officer ISO 27001)** | ARC | Rancang skema database (ERD, normalisasi, indexing), design patterns MVC CI3, struktur API response, mekanisme keamanan (enkripsi, RBAC, session management), review arsitektur agent lain | Tabel mutasi finansial WAJIB Immutable Audit Log (append-only, tanpa UPDATE/DELETE); data sensitif WAJIB AES-256 via CI3 Encryption Library; akses WAJIB RBAC; merancang BUKAN mengimplementasikan; DILARANG menyetujui arsitektur dengan raw query tanpa binding | `07_lead_architect.md`, `AGENTS.md` Sec. 2.3 |
| **Treasury and Settlement Specialist** | TRS | Validasi voucher pembayaran sebelum dilepas ke bank; pencocokan mutasi rekening koran dengan AR/AP internal; identifikasi outstanding items; susun Laporan Arus Kas (metode langsung dan tidak langsung); AR/AP Aging Report; deteksi anomali pembayaran (duplikasi, pembayaran ganda, selisih kurs) | Rekonsiliasi WAJIB zero difference, toleransi 0 rupiah; laporan arus kas WAJIB format PSAK 2; aging wajib bucket 30/60/90/120+ hari; DILARANG menyetujui voucher tanpa validasi lengkap; DILARANG menulis kode | `08_treasury.md`, `AGENTS.md` Sec. 2.4 |
| **Enterprise Tax Integration (Coretax DJP)** | TAX | Rekonsiliasi faktur pajak ERP versus Coretax DJP; validasi PPN (Keluaran dikurangi Masukan = Kurang/Lebih Bayar); validasi pemotongan PPh Pasal 21/22/23/25/26/29/4(2); deteksi anomali (faktur tidak dilaporkan, selisih DPP, duplikasi NSFP); rancang logika sinkronisasi API/XML Coretax | Angka pajak akurat hingga satuan rupiah terkecil; pembulatan PPN ke bawah sesuai aturan DJP; Faktur Pajak wajib formal-material sesuai **PER-03/PJ/2022**; DILARANG menebak tarif; sinkronisasi WAJIB idempotency key, retry exponential backoff, logging ke `coretax_sync_logs`; autentikasi OAuth 2.0 atau certificate-based | `09_tax_integration.md`, `AGENTS.md` Sec. 2.5 |
| **Software Engineer (CI3 Expert)** | SWE | Menulis kode Controller, Model, Library, Helper CI3 yang bersih, aman, efisien; error handling ketat untuk transaksi finansial; optimasi query bebas N+1; patuh OWASP Top 10. **Satu-satunya domain specialist yang BOLEH menulis kode implementasi** | Inline documentation `[ROLE]`/`[PURPOSE]`/`[COMPLIANCE]` WAJIB; DB transactions WAJIB; Immutable Audit Trail (DILARANG `update()` atau `delete()` pada tabel mutasi keuangan, koreksi via storno `insert()`); Anti SQL-Injection; verifikasi `php -l [file]` setelah setiap perubahan; tunduk Scope Lock AGENTS.md (Agent 1-7) | `10_software_engineer.md`, `AGENTS.md` Sec. 2.6 |
| **QA Audit (ISO Software Auditor)** | QA | Uji kode statis dan dinamis, unit testing, verifikasi hasil akhir memenuhi ISO/IEC 25010, uji kepatuhan pajak, audit internal. **Gerbang terakhir** | Sandbox CI (PHPUnit atau CIUnit); MENOLAK kode bila code coverage di bawah 90%, ada celah keamanan dari linter, atau pengujian angka finansial meleset melampaui **toleransi 0 rupiah** | `AGENTS.md` Sec. 2.7, `ecosystem_status.md` (dokumen rules `11_qa_audit.md` ada di direktori namun TIDAK termasuk 30 sumber sintesis ini) |
| **Senior ERP Developer (Legacy Specialist)** | - | Agen coding ERP Enterprise; fokus integritas data bisnis (Stok, Accounting, Audit) dan stabilitas; ditugaskan ke rollout 19 modul inventory | BACKWARD COMPATIBILITY (dilarang PHP di atas 5.6); KONSISTENSI (PascalCase class, camelCase method, PSR-12 hanya file baru); DATA INTEGRITY (transaksi DB wajib multi-step, cek status dokumen sebelum eksekusi); ADD ONLY (jangan hapus `rsltItems`, `LockerStock`, `FifoProdukJadi`); CLEAN (jangan baca/ubah `__*`, `*_OLD`, `trash`) | `_tmp_agents.md` |
| **Foundation (Layer Dasar)** | foundation | Prioritas P0, WAJIB selesai sebelum agent lain mulai; estimasi 1-2 minggu. Membuat Helper `he_variant_unifier_helper.php`, view `stock_unified`, Feature Flag `singleVariantStandard`, middleware `normalizeSessionKeys()` | DILARANG ubah template atau view; DILARANG ubah controller selain `Modul_Controller`; DILARANG hapus tabel - hanya buat view; rollback = set `singleVariantStandard.enabled = false` | `ai-agent-rules-foundation.md` |

## 5. Standar Komunikasi dan Gaya Menjawab
### 5.1 Bahasa dan Gaya
- **Bahasa utama:** Bahasa Indonesia yang jelas, profesional, dan langsung pada intinya untuk penjelasan logika dan diskusi.
- **Ringkas dan padat:** hindari penjelasan teori pemrograman panjang lebar kecuali diminta. Fokus solusi teknis langsung.
- **Nada per role:** Bahasa Indonesia, santai tapi tetap teknis dan padat (klausul eksplisit di `moderator.md`, `planner.md`, `executor.md`).
- **Format berkas:** wajib menyertakan tautan clickable dengan path relatif untuk setiap berkas yang dibuat atau dimodifikasi, contoh `[README.md](README.md)`.
- **Gaya penulisan kode:** sertakan komentar berbahasa Indonesia pada baris kode yang kompleks atau memerlukan perhatian khusus.
- Jika instruksi kurang jelas atau berpotensi merusak struktur database, **tanyakan dulu sebelum menulis kode**.

### 5.2 Format Pesan dan Laporan (WAJIB)
Format pesan ke `workflow/inter-log.txt`:

```text
=== PESAN ===
TIMESTAMP: YYYY-MM-DD HH:MM:SS
DARI: MOD
UNTUK: [PLN/EXE]
STATUS: [baru / selesai / perlu-konfirmasi / gagal]
ISI: [ringkasan pesan dan payload]
=== END ===
```

Format laporan EXE ke PLN:

```text
=== LAPORAN ===
TIMESTAMP: YYYY-MM-DD HH:MM:SS
DARI: EXE
UNTUK: PLN/MOD
STATUS: [selesai / sebagian / gagal / perlu-konfirmasi]
DIUBAH: [daftar file yang diubah]
HASIL: [1-2 kalimat ringkas hasil eksekusi]
VERIFIKASI: [apa yang dijalankan dan hasilnya]
CATATAN: [opsional]
=== END ===
```

Format LAPORAN ke MOD (masalah kritis):

```text
=== LAPORAN ===
TIMESTAMP: YYYY-MM-DD HH:MM:SS
DARI: EXE
UNTUK: MOD
STATUS: [gagal / perlu-konfirmasi]
MASALAH: [jelas dan singkat apa masalahnya]
YANG SUDAH DICOBA: [langkah yang sudah dilakukan]
YANG DIBUTUHKAN: [bantuan atau keputusan apa yang diperlukan dari MOD]
=== END ===
```

### 5.3 Kode Identitas di Awal Setiap Output
Setiap output code block WAJIB diawali kode identitas dan pengingat baca-ulang:

```text
> DARI MOD untuk PLN   -> instruksi untuk Planner
> DARI MOD untuk EXE   -> instruksi untuk Executor
> DARI PLN untuk EXE   -> instruksi untuk Executor
> DARI PLN untuk MOD   -> protes atau koreksi ke Moderator
> DARI EXE untuk PLN   -> laporan untuk Planner
> DARI EXE untuk MOD   -> laporan langsung ke Moderator
> [PENTING] SEBELUM MEMPROSES atau EKSEKUSI: Baca ulang [planner|executor|moderator].md terlebih dahulu!
```

### 5.4 Aturan Code Block (Anti-Parsing-Failure)
- **HANYA SATU code block di akhir output**, tidak ada teks lain di luar itu kecuali maksimal 1 kalimat pembuka super singkat (boleh dihilangkan).
- **WAJIB: SEMUA TEKS instruksi harus DI DALAM code block.** Penjelasan ke user boleh di luar, tapi instruksi ke agent lain harus 100% dalam code block. Tujuannya menghindari masalah parsing dari sistem OpenCode.
- **WAJIB: code block harus PLAINTEXT murni.** Tidak boleh ada nested code block. Semua teks polos tanpa formatting markdown, agar tidak keluar dari code block saat copy-paste.
- **Jangan sertakan kode implementasi** di prompt untuk Planner atau Executor kecuali benar-benar perlu sebagai contoh singkat (maks beberapa baris). Executor yang menulis kodenya sendiri; PLN hanya memberi spesifikasi, bukan jawaban jadi.

### 5.5 Instruksi Langsung ke User (Di Luar Code Block)
Diizinkan HANYA untuk hal yang benar-benar tidak bisa dilakukan AI: menjalankan SQL query di Supabase atau database; deploy ke server; konfigurasi API keys atau environment variables; akses dashboard admin yang butuh login; install dependency yang butuh akses root atau sudo; operasi manual di OS yang tidak bisa dijalankan via shell.

Format: tulis DI LUAR code block (sebelum atau sesudah), Bahasa Indonesia jelas dan singkat, sebutkan PERSIS apa yang harus dilakukan user. **Jangan gunakan jalur ini untuk menghindari tugas yang sebenarnya bisa dilakukan AI.**

### 5.6 Review Laporan (Planner)
1. Cek apakah laporan sesuai instruksi yang diberikan.
2. Sesuai dan tidak ada masalah -> konfirmasi singkat 1-2 kalimat, tanpa code block baru.
3. Ada yang kurang -> keluarkan LAGI satu code block berisi prompt revisi.
4. STATUS perlu-konfirmasi -> **jangan diam-diam menyetujui atau menolak atas nama user**; sampaikan ke user apa yang diminta izinnya, agar user yang putuskan.
5. Penanda "kegagalan ke-N berturut-turut" pada instruksi serupa -> **berhenti sejenak**, evaluasi apakah pendekatan dari awal salah arah, pertimbangkan penyampaian ke user untuk perubahan strategi, bukan sekadar mencoba lagi dengan variasi kecil.
6. Jangan mengedit file sendiri; tetap delegasikan lewat prompt baru ke EXE atau protes ke MOD.

### 5.7 Output Format Domain Specialist
| Role | Format |
|------|--------|
| PO | `=== PRD ===` berisi MODUL, USER STORY, ACCEPTANCE CRITERIA, SIKLUS AKUNTANSI, COMPLIANCE, DEPENDENSI, RISIKO BISNIS |
| CTA | `=== AUDIT COMPLIANCE ===` berisi TEMUAN (Kelemahan Logika, Risiko Kepatuhan Hukum, Celah Salah Saji), VERDICT (LULUS, DITOLAK, PERLU REVISI), CATATAN |
| ARC | `=== ARCHITECTURE DECISION ===` berisi KEPUTUSAN, KONTEKS, DESAIN (DATABASE, PATTERN, API, KEAMANAN), COMPLIANCE, RISIKO |
| TRS | `=== TREASURY REPORT ===` berisi TIPE, PERIODE, DATA, SELISIH, OUTSTANDING ITEMS, ANOMALI, REKOMENDASI |
| TAX | `=== TAX RECONCILIATION ===` berisi MASA PAJAK, JENIS PAJAK, REKONSILIASI (ERP versus Coretax), ANOMALI, FAKTUR STATUS, REKOMENDASI, BATAS WAKTU |
| SWE | `=== SWE REPORT ===` berisi FILE, PERUBAHAN, ALASAN, VERIFIKASI (`php -l`), COMPLIANCE |

## 6. Aturan Kerja Tim dan Pembelajaran Pasangan
### 6.1 Task Claim Protocol
- Claim dulu di jurnal **sebelum** edit. Format: `CLAIM: [modul] - [nama] - [YYYY-MM-DD HH:mm]`
- Selesaikan 1 modul tuntas, baru claim berikutnya.
- Jangan edit 2 modul partial - bikin tracking kacau.

### 6.2 Dependency Order
Kerjakan sesuai urutan transaksi bisnis: `Purchasing -> Konversi -> Penjualan -> Inventory -> Produksi`. Modul hulu selesai dulu sebelum hilir.

### 6.3 Quality Gate (Wajib Sebelum Mark Done)
- [ ] Feature flag tetap `enabled => false` - jangan diubah
- [ ] Syntax PHP lolos: `php -l file.php`
- [ ] `rsltItems2` gateway ditambah, `rsltItems` lama TIDAK dihapus
- [ ] Variant components ditambah (FifoProdukJadiVarian, LockerStockVariant, dan sejenisnya)
- [ ] Jurnal entry ditulis

### 6.4 Komunikasi Harian
Harian: 1 baris di jurnal - "modul X: ADD variant components - selesai". Error atau tersangkut: tulis di jurnal dengan detail, lalu tunggu konfirmasi. Minimal update 1x sehari, meskipun belum selesai.

### 6.5 Rollback Safety
Sebelum edit file besar, backup dulu dengan `cp coTransaksiCore.php coTransaksiCore.php.bak.$(date +%Y%m%d)`. Kalau setelah patch error, restore backup dan catat di jurnal. Jangan patch ulang file yang sama tanpa backup baru.

### 6.6 Batasan Mutlak Tim (Jangan Dilanggar)
1. Jangan hapus `rsltItems` - masih dipakai backward compat.
2. Jangan ubah feature flag dari `false` ke `true`.
3. Jangan edit `Modul_Controller.php` tanpa koordinasi - itu file bersama.
4. Jangan edit Foundation helper tanpa koordinasi.

### 6.7 Prinsip Kerja (_tmp_agents.md)
1. **BACKWARD COMPATIBILITY:** dilarang PHP di atas 5.6 (no arrow functions, null coalescing, scalar type hints).
2. **KONSISTENSI:** PascalCase class, camelCase method. PSR-12 hanya untuk file baru.
3. **DATA INTEGRITY:** wajib database transaction untuk multi-step. Cek status dokumen sebelum eksekusi.
4. **ADD ONLY:** jangan hapus `rsltItems`, `LockerStock`, `FifoProdukJadi` - hanya TAMBAH komponen variant.
5. **CLEAN:** jangan baca atau ubah file prefiks `__`, akhiran `_OLD`, atau folder `trash`.

### 6.8 Klasifikasi Modul
**In Scope (19 modul inventory, termasuk openbalance):**
| Agent | Modul | Dependency |
|-------|-------|------------|
| 1 | konversi | konversi_varian |
| 2 | pembelian | pembelianimport, pembelianjasa, pembelianprojek |
| 3 | penjualan | penjualanproject |
| 4 | pindahgudang | opname |
| 4b | openbalance | (stok awal) |
| 5 | distribusifg | distribusiproduksi, distribusisupplies, distribusijasa |
| 6 | produksi | produksiproses, adjustment, asetmanagement |
**Out of Scope (36 modul - jangan disentuh):** akunting, akunting_, api, asetmanagement, banking, biaya, dashboard, deviden, distribusijasa, kas, kasOLD, laporan, laporankeuangan, laporankeuangan_ori, laporankeuangan_sebelum_adj, pembatalan, pembayaran, penerimaan, penerimaanOLD, penerimaanprojek, penjualanproject, pettycast, pindahgudang_, produksi_sebelum_geser_bom, requeststok, saham, taxes, taxes_24apr2026, tools, valas, webservice, addons, laporankeuangan_sebelum_adj_20240118

### 6.9 Verifikasi Minimal (WAJIB sebelum mark done)
1. `php -l application/modules/[modul]/controllers/FollowUp.php` -> syntax OK
2. `rsltItems` masih ada (tidak terhapus)
3. Komponen variant sudah ditambah di config (`coTransaksiCore.php`: 3 comNames varian + feature flag)
4. Normalisasi session **otomatis** via `MdlMother::__construct()` - **0 perubahan di controller**
5. Test: varian ke varian, non ke non, varian ke non, non ke varian
6. Jurnal di-update

### 6.10 Pelajaran Integrasi Antar-Modul (Lesson Learned)
- Saat memindahkan fitur antar modul (misal dari pembelian ke penjualan), **JANGAN hanya menyalin** controller dan view (`coTransaksiUi.php`, `_selectorItem.php`). SELALU pastikan model data di modul tujuan (misal `MdlProduk2`) memiliki skema data dan field komputasi yang persis sama dengan model sumber (misal `MdlProdukPerSupplier`). Kegagalan ini menyebabkan **silent failure** pada fitur seperti `variantPicker` karena properti `has_variants` tidak tersedia.
- **Resolusi Cabang pada Variant Picker:** saat mengambil stok di `variantPicker()`, SELALU utamakan cabang dan gudang transaksi aktif dari session (`$_SESSION[...]['main']['placeID']` atau `cabangID` dan `gudangID`) sebelum fallback ke `->session->login['cabang_id']`.
- **Sanitasi String Key Varian (pencegahan `produk_id = 0`):** payload item berformat string `variant:PID:VID` (misal `variant:1773:5`) HARUS diekstrak menjadi `produk_id` numerik (1773) dan `variant_id` (5) sebelum ditulis ke tabel database atau diproses komponen parent (misal `ComFifoProdukJadi`). Mengabaikan ekstrak ini menyebabkan MySQL me-cast string `variant:` menjadi 0.

### 6.11 Standar Referensi Domain
| Agent | Standar |
|:-----:|---------|
| PO | ISO 9001:2015; siklus Journal Entry -> General Ledger -> Trial Balance -> Financial Statement; Double-Entry (Debit = Kredit); prinsip materialitas dan konservatisme |
| CTA | PSAK 1 (Penyajian Laporan Keuangan), PSAK 2 (Laporan Arus Kas), PSAK 16 (Aset Tetap), PSAK 46 (Pajak Penghasilan), PSAK 65 (Laporan Keuangan Konsolidasian), PSAK 71 (Instrumen Keuangan), PSAK 72 (Pendapatan dari Kontrak dengan Pelanggan), UU HPP, PMK terkait PPN/PPh/Faktur Pajak, standar audit ISA |
| ARC | ISO 27001:2022, ISO/IEC 25010:2023, OWASP Top 10, CI3 Best Practices |
| TRS | PSAK 2, PSAK 71 (Expected Credit Loss untuk AR), bucket aging 30/60/90/120+ hari |
| TAX | PER-03/PJ/2022; PPN 11% dari DPP (UU HPP); PPh 21 progresif 5/15/25/30/35%; PPh 22 0,25%-7,5%; PPh 23 2% (jasa) dan 15% (dividen, bunga, royalti); PPh 25 angsuran bulanan; PPh 4(2) final 10% sewa tanah/bangunan dan 0,5% UMKM; PPh 29 kurang bayar tahunan |
| SWE | OWASP Top 10, Clean Code, SOLID, ISO/IEC 25010 |
| QA | ISO/IEC 25010; code coverage threshold 90%; toleransi numerik 0 rupiah |

### 6.12 Checklist Validasi Wajib CTA
Debit = Kredit untuk setiap jurnal; PPN dihitung dari DPP, bukan dari harga termasuk pajak (kecuali ditentukan lain); pembulatan ke bawah untuk PPN sesuai aturan DJP; PPh dipotong sesuai tarif pasal yang berlaku; mata uang konsisten (IDR, atau konversi kurs tengah BI jika valas); tidak ada jurnal orphan tanpa pasangan debit/kredit.

### 6.13 Checklist Validasi Voucher TRS
Nomor PO atau invoice cocok; jumlah sesuai dengan faktur; pajak PPN/PPh sudah diperhitungkan; otorisasi level sesuai amount threshold; tidak ada duplikasi pembayaran; rekening tujuan terverifikasi.

### 6.14 Prinsip Arsitektur Wajib (ARC)
1. **Immutable Audit Log:** tabel mutasi finansial = append-only. Koreksi via jurnal storno (INSERT baru).
2. **ACID Compliance:** semua write operation keuangan dalam `trans_start()` dan `trans_complete()`.
3. **No Raw Query:** wajib CI3 Query Builder atau Parameter Binding.
4. **Separation of Concerns:** Controller tipis, Model tebal, Library untuk logika bisnis kompleks.
5. **Idempotency:** operasi API harus idempotent (UID atau idempotency key).
6. **Backward Compatibility:** perubahan tidak boleh merusak fungsionalitas lama.

### 6.15 Aturan Kerja Modul (Rollout)
Claim dan kerjakan modul sesuai assignment agent. Selesaikan 1 modul tuntas sebelum pindah ke modul berikutnya. Jangan ubah modul di luar assignment tanpa koordinasi. Jangan ubah `Modul_Controller.php` untuk rollout modul; normalisasi session ditangani foundation atau `MdlMother`. `FollowUp.php` umumnya 0 perubahan untuk Single Variant Standard, kecuali audit menemukan write stok produk manual yang wajib dual-write. Feature flag `singleVariantStandard.enabled` tetap `false` sampai rollout diverifikasi.

## 7. Ekosistem Antigravity (11 Agents) dan Status
### 7.1 Arsitektur Dua Lapis
```mermaid
flowchart TB
    subgraph ORCH["ORCHESTRATION LAYER"]
        direction LR
        MOD["MOD - Moderator"]
        PLN["PLN - Planner"]
        EXE["EXE - Executor"]
        TEC["TEC - Technical"]
        MOD --> PLN --> EXE --> TEC
        TEC --> EXE
    end

    subgraph DOMAIN["DOMAIN SPECIALIST LAYER"]
        direction LR
        PO["PO - Product Owner"]
        CTA["CTA - Compliance Tax"]
        ARC["ARC - Lead Architect"]
        TRS["TRS - Treasury"]
        TAX["TAX - Tax Integration"]
        SWE["SWE - Software Engineer"]
        QA["QA - QA Audit"]
    end

    USER["User"] --> MOD
    EXE --> PO & CTA & ARC & TRS & TAX & SWE & QA
    PLN --> PO & CTA & ARC
    MOD --> USER
```

### 7.2 Registry Lengkap - 11 Subagent Aktif
| # | Kode | TypeName | Role | Tulis Kode? | Jalankan Shell? | Standar Utama |
|:-:|:----:|----------|------|:-----------:|:---------------:|---------------|
| 1 | MOD | `moderator` | Pintu Gerbang dan Router | Tidak | Tidak | - |
| 2 | PLN | `planner` | Perencana dan Prompt Creator | Tidak | Tidak | - |
| 3 | EXE | `executor` | Eksekutor dan Pelapor | Ya | Ya | - |
| 4 | TEC | `technical` | Analisis Kode dan Bug | Ya | Ya | OWASP Top 10 |
| 5 | PO | `product_owner` | Product Owner dan Business Analyst | Tidak | Tidak | ISO 9001 |
| 6 | CTA | `compliance_tax` | Compliance, IFRS/PSAK dan Tax Auditor | Tidak | Tidak | IFRS/PSAK, ISA |
| 7 | ARC | `lead_architect` | Software Architect dan Security Officer | Tidak | Tidak | ISO 27001, ISO 25010 |
| 8 | TRS | `treasury` | Treasury dan Supplier Reconciliation | Tidak | Tidak | PSAK 2, PSAK 71 |
| 9 | TAX | `tax_integration` | Tax Accountant dan Coretax DJP | Tidak | Tidak | UU HPP, PER-03/PJ |
| 10 | SWE | `software_engineer` | Enterprise Software Engineer CI3 | Ya | Tidak | OWASP, Clean Code |
| 11 | QA | `qa_audit` | QA Engineer dan ISO Auditor | Ya | Tidak | ISO/IEC 25010 |

Aturan Emas: hanya EXE, TEC, SWE, dan QA yang boleh menulis kode atau menjalankan perintah shell. Agent lain hanya memberikan analisis, spesifikasi, atau audit. SWE tetap tunduk pada Scope Lock AGENTS.md, sehingga instruksi ke SWE wajib menyebutkan nomor Agent dan modul target.

### 7.3 Routing Rules (dari MOD)
| Jenis Permintaan | Pipeline |
|-------------------|----------|
| Bug teknis atau debugging | MOD -> PLN -> EXE -> TEC -> (CTA jika perlu) |
| Audit keamanan | MOD -> PLN -> EXE -> TEC -> ARC |
| Kepatuhan akuntansi atau pajak | MOD -> PLN -> CTA -> EXE -> TAX |
| Arus kas atau rekonsiliasi | MOD -> PLN -> EXE -> TRS |
| Integrasi Coretax DJP | MOD -> PLN -> EXE -> TAX -> CTA |
| Fitur bisnis baru | MOD -> PLN -> PO -> ARC -> EXE -> SWE -> QA |
| Redesign arsitektur | MOD -> PLN -> ARC -> EXE -> SWE -> QA |
| Code review dan QA | MOD -> PLN -> EXE -> QA -> CTA |

Routing rules versi `01_moderator.md` berbeda dan menyebut role `business` serta `integrator` yang tidak terdaftar (lihat Kontradiksi K-3): bug teknis -> PLN -> EXE -> technical -> compliance -> integrator; audit keamanan -> PLN -> EXE -> compliance -> technical -> integrator; pajak atau regulasi bisnis -> PLN -> EXE -> business -> compliance -> integrator; rencana modernisasi -> PLN -> integrator -> EXE -> technical/compliance/business; instruksi kritis atau berisiko hukum -> eskalasi langsung ke MOD dengan STATUS perlu-konfirmasi.

### 7.4 Cara Memanggil Agent
**Via pipeline otomatis:** ketik `/mod` lalu jelaskan task; MOD melakukan routing otomatis.
**Via `invoke_subagent` langsung:** `product_owner` -> PO, `compliance_tax` -> CTA, `lead_architect` -> ARC, `treasury` -> TRS, `tax_integration` -> TAX, `software_engineer` -> SWE, `qa_audit` -> QA.
**Cara MOD memanggil PLN (WAJIB):** `TypeName: self`, `Role: Planner`, `Prompt`: "Kamu adalah PLANNER (PLN). WAJIB baca file `.agents/rules/planner.md` terlebih dahulu. Tugasmu adalah: [spesifikasi teknis dari user]. Susun rencana, lalu gunakan `invoke_subagent` untuk memanggil Executor."
**Cara PLN memanggil EXE (WAJIB):** `TypeName: self`, `Role: Executor`, `Prompt`: "Kamu adalah EXECUTOR (EXE). WAJIB baca file `.agents/rules/executor.md` terlebih dahulu. Instruksemu: [instruksi teknis sangat spesifik, nama file, fungsi, perubahan]. Kerjakan dan laporkan hasilnya kepadaku."
**Format rencana multi-agent (PLN):**

```text
target_module: [nama modul ERP]
priority: [tinggi / sedang / rendah]
subagents_sequence: [technical -> compliance -> business -> integrator]
notes: [catatan singkat]
```

### 7.5 Struktur File Ekosistem (Setelah Setup)
```text
project-root/
|-- package.json           # Dependencies
|-- .gitignore
|-- README.md
|-- workflow/
|   `-- check-console.mjs  # Browser verification script
`-- .agents/
    |-- config.json        # Config Antigravity
    |-- rules/             # Role rules
    |   |-- moderator.md
    |   |-- planner.md
    |   `-- executor.md
    `-- skills/            # Command skills
        `-- mod-command/
            `-- SKILL.md   # Skill untuk men-trigger /mod
```

### 7.6 Prasyarat, Instalasi, dan Environment Verifikasi
**Prasyarat:** Node.js **v18+**, Antigravity sudah terinstall.
**Perintah setup sekali pakai (copy-paste ke AI assistant):** "Tolong setup ekosistem Antigravity dari folder ANTIGRAVITY ini. Pindahkan folder `.agents/`, `workflow/`, dan `package.json` ke root proyek. Hapus folder `ANTIGRAVITY` setelahnya, lalu verifikasi struktur foldernya." Dilanjutkan: "pastikan Anda (AI) siap menggunakan tool invoke_subagent untuk mengaktifkan otomatisasi Moderator, Planner, dan Executor."
**Playwright (setup sekali di awal proyek, jika belum ada):** `npm install -D playwright && npx playwright install chromium`
**Console check (WAJIB jika perubahan menyentuh kode browser):** `node workflow/check-console.mjs http://127.0.0.1:5500`. Script membuka URL di headless Chromium via Playwright, menangkap `console.log/warn/error`, `pageerror`, dan `requestfailed`, menulis ke `console-check.log` di root proyek, serta mencetak ke terminal. Exit code 0 kalau bersih, 1 kalau ada error atau pageerror. Kalau error terdeteksi, **JANGAN tulis STATUS selesai**; turunkan ke STATUS sebagian atau gagal. Kalau dev server belum jalan, jalankan dulu di background sebelum memanggil script.

### 7.7 Context Compaction Recovery dan Troubleshooting
**Trigger keywords:** `mod`, `kamu moderator`, `ingat role`, `wake up`. Aturan: baca ulang file role Anda di SETIAP giliran, tanpa kecuali, jangan pernah berasumsi sudah ingat. Aturan ini terutama berlaku setelah context compaction atau summarization, ketika detail peran bisa buyar.
**Troubleshooting `/mod` tidak merespon:** (1) pastikan folder `.agents/` sudah di root, bukan di dalam `ANTIGRAVITY/`, karena Antigravity hanya membaca `.agents` di root; (2) restart atau segarkan jendela chat Antigravity agar skills dimuat ulang.
**Troubleshooting "agen lupa role":** ketik `mod` atau `wake up` ke chat; agent membaca ulang aturan utamanya dari `.agents/rules/moderator.md`.
**Arsitektur native:** berbeda dari sistem yang bergantung pada file teks log manual, sistem ini memanfaatkan alat native Antigravity yaitu `invoke_subagent` untuk menjalankan delegasi tugas sepenuhnya di background.

### 7.8 Status Rollout Dual-Write (10 Modul Inventory Core)
| Module | `_shoppingCart` reset() | `_processSelect*` select/remove/edit/cancel | FollowUp |
|--------|-------------------------|--------------------------------------------------|----------|
| penjualan | DualWrite | DualWrite (4 files, 15 blocks) | semua di-comment |
| pembelian | DualWrite | DualWrite (4 files, 11 blocks) | semua di-comment |
| pindahgudang | DualWrite | DualWrite (3 files, 7 blocks) | semua di-comment |
| opname | DualWrite | DualWrite (1 file, 4 blocks) | semua di-comment |
| distribusifg | DualWrite | DualWrite (3 files, 11 blocks) | semua di-comment |
| distribusiproduksi | DualWrite | DualWrite (3 files, 11 blocks) | semua di-comment |
| produksi | DualWrite | DualWrite (4 files, 14 blocks) | semua di-comment |
| produksiproses | DualWrite | DualWrite (4 files, 14 blocks) | semua di-comment |
| konversi_varian | DualWrite | DualWrite (5 files, 17 blocks) | semua di-comment |
| adjustment | DualWrite | DualWrite (1 file, 2 blocks) | semua di-comment |
| konversi (done earlier) | DualWrite | DualWrite (1 file) | semua di-comment |

Total: sekitar 100+ blok locker manual diganti dengan `ComLockerStockDualWrite::pair()`.

File `konversi` yang sudah memakai `ComLockerStockDualWrite`: `_processSelectProductConvertion.php` (`select()`, `reserveVariantLockerForSelect()`, `releaseVariantLockerOnRemove()`), `_shoppingCart.php` (`reset()` variant path dan non-variant path), `_selectorItem.php` (`variantPicker()` fallback sentinel).

Catatan: semua `_processSelectSupplies*.php` dilewati karena memakai `MdlLockerStockSupplies`, bukan produk. `FollowUp` dan `__FollowUp`: semua locker operation sudah di-comment-out sejak awal, sehingga tidak perlu diubah.

### 7.9 Empat Pattern Perbaikan Wajib di Modul Lain
| Pattern | Lokasi | Yang Diganti |
|---------|--------|---------------|
| Pattern 1 | `_shoppingCart.php` pada `reset()` | Blok `cekLoker(..., "hold")` plus `updateData` jumlah 0 plus `updateData` active, diganti `ComLockerStockDualWrite::pair()` dengan dua row static (state `hold` jumlah negatif, state `active` jumlah positif) di dalam `trans_start` dan `trans_complete` |
| Pattern 2 | `_processSelect*.php` saat add item | Blok `trans_start` plus `updateData` active decrease plus `updateData` atau `addData` hold, diganti `ComLockerStockDualWrite::pair()` |
| Pattern 3 | `__FollowUp.php` dan `FollowUp.php` approval release | Sama seperti Pattern 1: cari `cekLoker("hold")` plus `updateData` plus `addData` untuk hold dan active, ganti dengan `ComLockerStockDualWrite::pair()` |
| Pattern 4 | Method reserve atau release khusus (misal `reserveVariantLockerForSelect`) | Identifikasi via `MdlLockerStockVariant` plus `updateData` atau `addData` untuk state `hold` atau `active` |

## 8. Prompt Kit dan Rollout Agent
### 8.1 Prompt Rollout Agent (modul yang ditugaskan)
**Role:** agen coding untuk sistem ERP Enterprise (PHP 5.6, CI3, MariaDB 10).
**Workspace:** `\\192.168.5.14\web\new_san_variant`
**Cara kerja, 5 langkah wajib:**
1. **Baca BLUEPRINT** - `docs/blueprint-konverter-multi-variant.md` (FULL). Section 1-2 (visi dan scope), Section 8 (checklist rollout per modul: config + controller/UI), Section 14 (Controller dan UI requirements), Lampiran (config file list).
2. **Baca AGENTS.md** - pahami arsitektur, aturan, assignment.
3. **Baca `.ai-agent-rules.md`** di folder modul Anda - tugas spesifik dan file target.
4. **Baca REFERENSI `konversi` yang sudah selesai:** `application/modules/konversi/config/coTransaksiCore.php` (pola config), `application/modules/konversi/controllers/_selectorItem.php` (variant picker), `application/modules/konversi/controllers/_processSelectProductConvertion.php` (add to cart + dual-write), `application/modules/konversi/controllers/_shoppingCart.php` (cart display), `application/modules/konversi/views/variant_picker.php` (modal UI).
5. **KERJAKAN** perubahan: **Config** `coTransaksiCore.php` untuk feature flag plus 3 variant comNames plus `rsltItems2` plus `afterPreProcessorInjector2`; **Controller** `_selectorItem.php` untuk variant picker, `_processSelect*.php` untuk `variant_id` dan `cart_key`, `_shoppingCart.php` untuk display; **View** `variant_picker.php` copy dari konversi.
**Aturan mutlak:** jangan hapus `rsltItems`, `LockerStock`, `FifoProdukJadi` - TETAP ADA. Jangan ubah `Modul_Controller.php` (0 perubahan, auto-normalize via `MdlMother`). Jangan tinggalkan `arrPrint*` atau `cek*` aktif. Dual-write ke `stock_locker` plus `stock_locker_variant` (semua `variant_id` termasuk -1). Mapping wajib `"variant_id" => "variant_id"`, `"variant_nama" => "variant_nama"`, `"cart_key" => "cart_key"`.
**Verifikasi:** `php -l` semua file; `rsltItems` masih ada; Feature flag terpasang; tidak ada debug call aktif.

### 8.2 Feature Flag (Tidak Boleh Diubah)
```php
'singleVariantStandard' => array(
    'enabled' => false,    // JANGAN set ke true
    'defaultVariantId' => -1,
    'forceKeyNormalization' => true,
),
```

### 8.3 Prompt Kit Migrasi Produk Varian (Chat Baru)
**Konteks organisasi:** Holding `san` dan `san_ibb` (CRM). Subsidiary `san_add`, `san_ppu`, `san_sarana`, `san_sdl`, `san_tsa`. Konvensi folder clone atau snapshot: `san_<subsidiary>_<snapshot>`, contoh `san_sarana_8apr`.
**Dokumen referensi wajib (nomor 0 sampai 6):** `application/CHEATSHEET_MIGRASI_VARIAN.md`; `application/PLAN_MIGRASI_VARIAN_HOLDING_SUBSIDIARY.md`; `application/modules/distribusi/PLAN_MIGRASI_VARIAN.md`; `application/sql/variant_migration_phase1/README.md`; `application/sql/variant_migration_phase1/precheck.sql`; `application/sql/variant_migration_phase1/migrate_variant_foundation.sql`; `application/sql/variant_migration_phase1/postcheck.sql`.
**Aturan eksekusi di chat baru:** (1) selalu sebut workspace aktif di baris awal prompt; (2) selalu minta agent berhenti sebelum langkah berisiko seperti DDL atau patch massal sampai User approve; (3) larangan analisis file: jangan baca atau ubah controller `__*`, jangan baca atau ubah `*_OLD.php`, jangan gunakan folder `trash`; (4) prioritas: integritas data transaksi, stok, accounting, approval, laporan, audit.
**Tahap A (DB Foundation Only):** jalankan `precheck.sql` dan tampilkan ringkasan MISSING atau EXISTS; berhenti dan minta approval sebelum `migrate_variant_foundation.sql`; jangan patch file PHP pada tahap ini; pastikan database target benar sebelum execute.
**Tahap A2 (Setelah Approval DDL):** jalankan `migrate_variant_foundation.sql`, lalu `postcheck.sql`, laporkan objek yang masih MISSING, nilai `missing_total`, dan status siap atau tidak siap lanjut patch PHP. Jangan lanjut sebelum konfirmasi.
**Tahap B (Patch Shared Layer PHP), hanya jika `missing_total = 0`:** `application/helpers/Pairs/he_cek_stock_produk_locker_helper.php`; `application/models/Mdls/MdlProdukVarian.php`; tambah model varian jika belum ada (`MdlLockerStockVarian.php`, `MdlLockerStockMutasiVarian.php`, `MdlFifoProdukJadiVarian.php`); tambah coms varian jika belum ada (`ComLockerStockVarian.php`, `ComFifoProdukJadiVarian.php`, `ComRekeningPembantuProdukVarian.php`). Aturan: PHP 5.6 compatible only; jangan ubah logic non-varian; sebelum edit beri analisis singkat (tujuan, akar masalah, file, dampak, risiko, solusi); setelah edit jelaskan file yang berubah dan risiko kompatibilitas.
**Tahap C (Patch Modul Fase-1), urutan `pembelian -> distribusi -> penjualan`:** untuk tiap modul, port config varian (`coTransaksiCore`, `coTransaksiValues`), port flow controller varian (`_selectorItem.php`, `_processSelectProduct.php`, `_shoppingCart.php`, `FollowUp.php`, `Printing.php` jika ada gap), hardening model transaksi (`MdlPembelianTransaksi`, `MdlDistribusiTransaksi`, `MdlPenjualanTransaksi`), jaga fallback non-varian tetap aman. Perubahan bertahap per modul dengan checkpoint test; jangan lanjut modul berikutnya sebelum ringkasan modul saat ini selesai.
**Tahap D (QA dan Validasi Audit):** create transaksi non-varian; create transaksi varian multi-line; alur Save -> FollowUp -> Approve -> Print; verifikasi DB (`*_transaksi_data*` terisi `variant_*` konsisten, `stock_locker_variant` dan `stock_locker_mutasi_variant` konsisten, `_rek_pembantu_produk_varian*` konsisten, `rek_cache_persediaan_produk_varian_fifo` konsisten); verifikasi UI preview versus data DB versus nota print. Output wajib: temuan bug dengan file dan line, risiko residual, **status GO atau HOLD**.
**Tahap E (Hotfix Cepat):** identifikasi akar masalah dari log atau error message; tentukan apakah masalah di schema DB, config mapping, flow session atau cart_key, model transaksi, atau posting coms; patch minimal (minimal invasive); pastikan non-varian tidak terdampak. Batasan: jangan refactor besar, fokus stabilisasi production.
**Tahap F (Copy ke Subsidiary Berikutnya):** validasi artefak SQL dan plan tersedia; jalankan `precheck.sql`; laporkan delta schema dan config dibanding instance sebelumnya; minta approval sebelum migrate DB.
**Catatan operasional:** untuk PowerShell, eksekusi SQL via `mysql ... --execute="source <file.sql>"`. Jalankan DDL saat maintenance window. Simpan hasil precheck dan postcheck per instance sebagai bukti audit.

### 8.4 Foundation Layer (P0, WAJIB Selesai Sebelum Agent Lain)
| File Output | Isi |
|-------------|-----|
| `application/helpers/he_variant_unifier_helper.php` | `resolveVariantId()`, `normalizeSessionKeys()`, `getUnifiedStock()` |
| `database/migrations/XXX_create_view_stock_unified.sql` | View `stock_unified` |
| `application/modules/konversi/config/coTransaksiCore.php` | Feature flag `singleVariantStandard` |
| `application/modules/konversi/controllers/Modul_Controller.php` | Middleware `normalizeSessionKeys()` |

Konstanta global: `VARIANT_DEFAULT_ID = -1`, `VARIANT_DEFAULT_LABEL = "Default"`. Logika `resolveVariantId($produkId, $variantId)`: bila `(int)$variantId > 0` kembalikan `(int)$variantId`, selain itu kembalikan `VARIANT_DEFAULT_ID`. Fungsi `normalizeSessionKeys(&$session, $cCode)` membangun ulang indeks `items` dengan key `variant:PID:VID` dan menyetel `variant_id` serta `cart_key` pada tiap spec.

**Verifikasi foundation:** `resolveVariantId(1743, 0)` menghasilkan -1; `resolveVariantId(1743, 15)` menghasilkan 15; session key `"1743"` menjadi `"variant:1743:-1"` setelah normalizer.
**Rollback:** set `singleVariantStandard.enabled = false` di config.
**Implementasi aktual (`_tmp_agents.md`):** auto-normalize dipindah ke `MdlMother::__construct()` di `application/models/Mdls/MdlMother.php` (otomatis, 0 panggilan manual). Helper berada di `application/helpers/he_variant_unifier.php`. View SQL di `docs/sql/001_create_view_stock_unified.sql`. Enam model varian (Coms dan Mdls) perlu di-copy dari `san_staging` karena belum ada di workspace baru.

### 8.5 Blueprint Konverter Multi-Variant (Arsitektur Target)
**Workspace acuan:** `w:/san_staging/application/modules/konversi`. **Acuan standar:** ISO/IEC 25010, SAP LO-VC, SAP Movement Types 561/562/701/702, ISO 8000, ISO 9001:2015, ISO 27001:2022, ISO 28000:2007.
**Prinsip dasar:** SETIAP PRODUK ADALAH VARIAN. Produk tanpa varian eksplisit otomatis memiliki 1 varian default dengan `variant_id = -1`.
**Target bisnis:** (1) semua produk memiliki `variant_id`, tidak ada `variant_id = 0` sebagai pengecualian; (2) session key seragam `variant:{produk_id}:{variant_id}` untuk semua item; (3) satu tabel stok `stock_locker_variant` menggantikan `stock_locker` plus `stock_locker_variant`; (4) satu jalur processing `rsltItems2` menggantikan `rsltItems` plus `rsltItems2`; (5) backward compatibility, flow existing tetap jalan selama masa migrasi.
**Baseline masalah (root cause):** dual session key (`"1743"` versus `"variant:1743:15"`); ghost key harus dibersihkan di `FollowUp.php:281-284`; dual processing pipeline (`rsltItems` plus `rsltItems2`, logika berulang di `FollowUp.php:1448-1523`); dual stock table; dual HPP injector (`afterPreProcessorInjector` plus `afterPreProcessorInjector2`).
**Opsi implementasi:** Opsi A (Recommended) Default Variant Generator plus Migrasi Bertahap dengan view `stock_unified` - tidak perlu migrasi data sekaligus, backward compatible, risiko rollback rendah,namun perlu view database dan kode legacy tetap dipertahankan selama transisi. Opsi B Rewrite Total Session Contract - bersih tanpa utang teknis, namun risiko sangat tinggi karena banyak file berubah dan UAT regression wajib mencakup semua skenario.
**Strategi migrasi lintas modul:** Fase 1 Foundation 2-3 minggu; Fase 2 Pilot `konversi` plus `variant_cutover` 1-2 minggu; Fase 3 Rollout modul stok bertahap 4-6 minggu (Pembelian, Penjualan, Penerimaan, Distribusi, Produksi, dan sisa sekitar 15 modul); Fase 4 Cleanup 1-2 minggu. Total estimasi sekitar 100+ file berubah, 8-12 minggu, kode dibersihkan sekitar 763 baris.
**Skenario test wajib T1 sampai T5:** non ke non, non ke varian, varian ke non, varian ke varian, multi source satu parent. Edge case E1 sampai E5: produk tanpa varian di DB, stok lama di `stock_locker`, key session lama, varian dengan stok 0, dan rollback ke session lama.
**Rollback plan:** session error setelah normalizer -> matikan `normalizeSessionKeys()` via feature flag; stok tidak balance -> matikan view `stock_unified` dan aktifkan ulang query `stock_locker`; key format bentrok -> aktifkan `buildVariantKeyCandidate()` sebagai fallback; approval gagal -> kembalikan `afterPreProcessorInjector` plus `rsltItems`.
**ISO/IEC 25010 checklist:** FS-01 Functional Completeness (cek 50 produk random), FS-02 Functional Correctness (`sum qty source = sum qty target`, uji T1-T5), RL-03 Fault Tolerance (inject session corrupt), MN-01 Modularity (code review), MN-02 Reusability (dokumentasi API), SE-01 Data Integrity (debug trap log).

### 8.6 Blueprint UAT Fix `konversi` (Selector dan ShoppingCart Support Varian)
**Workflow transaksi:** 2 step sesuai `coTransaksiUi.php` - Step 1 `request` (pengajuan konversi, jenis `1334` pusat dan `334` cabang), Step 2 `approve` (persetujuan dan eksekusi konversi). Skenario M1-M4 adalah mode konversi (varian atau non-varian), bukan jumlah step workflow.
**Baseline masalah terdokumentasi, 10 poin dengan line reference:** (1) flag `variant_mode_enabled` masih `false` untuk `1334` dan `334` di `coTransaksiUi.php:15` dan `:1155`; (2) `selectorViewedFields` belum memuat `has_variants` di `coTransaksiUi.php:78` dan `:1215`, dan `_selectorItem.php:323` belum punya branch badge varian; (3) belum ada endpoint `variantPicker` di `konversi` karena view `_selector.php:44` dan `:81` hanya membuka modal jika `socketURL` terisi; (4) enum `item_type` tidak sinkron - resolver di `Modul_Controller.php:109` membaca `variant`, sedangkan `_processSelectProductConvertion.php:32` dan `:54` mengisi `varian`; (5) dropdown paired target `selItems` dibangun dari `MdlProduk2` saja di `coTransaksiUi.php:234` dan `_shoppingCart.php:1902`; (6) shadow-state `items_source` dan `items_target` bercampur dengan `items`; (7) flow remove dan edit masih identity produk parent di `_processSelectProductConvertion.php:874` dan `:891`; (8) kontrak render source versus warning target belum tegas di `shoppingCart.php:517`; (9) state messaging empty source versus empty target belum dipisah; (10) perbedaan layer shoppingcart versus sub-postProcessor, di mana pada step `request` (`1334r`, `334r`) komponen `LockerStockVariant` memang belum terdaftar sehingga row varian bisa ikut diproses `ComLockerStock` parent dan memicu error stok parent hold atau active.
**Kontrak render source-first (WAJIB):** jika `items` berisi minimal 1 row, tabel source WAJIB tetap tampil. Warning target tidak boleh menggantikan atau menutupi tabel source. Empty state wajib dipisah: empty source menampilkan pesan belum pilih item source; source ada tapi target kosong menampilkan warning pairing target per row. Styling warning target hanya di section target, bukan global cart container. `pairedItemNoTarget` tidak boleh memicu fallback "cart kosong total".
**Guard minimum postProcessor:** `ComLockerStock` skip row varian; `ComLockerStockVariant` skip row non-varian (`variant_id < 1`); untuk payload legacy, `cart_key=variant:{pid}:{vid}` dianggap varian walau `variant_id` belum terisi. Step `request` tidak otomatis menambah stok target; eksekusi stok target utama terjadi saat `approve`.
**Acceptance parameters P-00 sampai P-13:** Source Visibility Guard, Selector Marker, Click Behavior Non-Varian, Click Behavior Varian, Session Equality, `items2` Equality, Dropdown Target Equality, Validator Integrity, No Regression M4, State Messaging Split, Same Master Multi-Variant Source, Session Lifecycle Integrity, PostProcessor Routing Integrity, No Shadow Row in FollowUp Preview.
**UAT matrix:** M1 varian ke varian, M2 non ke varian, M3 varian ke non, M4 non ke non, plus negatif (qty 0, stok kurang, variant tidak sesuai parent, source tanpa target) dan concurrency (2 user edit source sama).
**Risiko dan mitigasi:** perubahan key session memutus flow legacy (mitigasi: non-varian tetap key native, rollout bertahap di `1334` dulu); remove atau release salah locker untuk varian (mitigasi: parser identity plus branch release ke locker varian jika `variant_id > 0`); dropdown union membuat payload ambigu (mitigasi: value wajib key session row, bukan label atau nama polos).
**Urutan eksekusi:** Fase A Selector marker plus variantPicker modal; Fase B Session contract canonical plus normalizer enum `item_type`; Fase C Shoppingcart dropdown union plus writer `items2` dan `items2_sum`; Fase D Validator hardening plus UAT matrix plus evidence. Guard: perbaikan source-first render dijalankan sebelum optimasi UX target lain.

### 8.7 Blueprint Perancangan dan Validasi Sistem AI
**Kelayakan:** 9/10. Mengunci risiko halusinasi AI menggunakan kombinasi Alignment dan pengujian Three-Way Matching. Direkomendasikan jalur **Human-in-the-Loop (HITL)** sebagai katup pengaman jika validasi otomatis AI mendeteksi kegagalan data.
**AI Alignment Guidelines (System Prompt untuk mengunci konsistensi):** (1) Aturan Persona - sistem AI Auditor Data yang kaku, skeptis, berbasis data, tanpa kalimat basa-basi; (2) Aturan Toleransi Angka - tidak boleh pembulatan mandiri pada angka desimal, `1500.50` tidak sama dengan `1501`; (3) Aturan Penolakan - jika kolom wajib seperti Transaction ID kosong atau tidak terbaca, AI WAJIB mengeluarkan respon `REJECT`; (4) Batasan Pengetahuan - jangan berasumsi atau menebak data yang tidak tertulis pada konteks input.
**Three-Way Matching (3WM):** Dokumen A (sumber eksternal, hasil ekstraksi AI), Dokumen B (sumber internal, data referensi DB), Dokumen C (aturan bisnis, limitasi transaksi). Matriks kelulusan: nilai finansial atau jumlah di A sama dengan B; identitas penjual atau pembeli di A sama dengan B; spesifikasi item sesuai batasan di C. Sistem dinyatakan lolos jika seluruh indikator TRUE.
**Kamus data:** `source_document` (PDF atau File, dokumen mentah eksternal), `internal_reference_db` (JSON atau Table, data pembanding), `status_verifikasi` (String, output `VALID` atau `REJECT`), `catatan_anomali` (Text atau String, alasan spesifik jika `REJECT`).
**Kasus uji riil:** Kasus 1 Happy Path `TX-2026-0001` dengan Nota INV-777 atas nama Ahmad Rp150.000 dan sisa limit Rp500.000 menghasilkan `APPROVED` dengan sisa limit baru Rp350.000. Kasus 2 Edge Case `TX-2026-0002` dengan Nota INV-778 Rp600.000 melampaui limit Rp500.000 menghasilkan `REJECT` dengan alasan total transaksi melebihi limit. Istilah "Seeds Number" hanya dipakai internal kode untuk mengunci tingkat keacakan kreativitas AI.
**Jalur Human-in-the-Loop:** sistem otomatis menghentikan proses otomatisasi sesaat; data dikirim ke dasbor antrean peninjauan manual tim; manusia melakukan verifikasi visual ulang dalam waktu maksimal yang ditentukan; jika kesalahan disebabkan AI yang salah membaca data, lakukan pembaruan instruksi pada Bagian AI Alignment.

### 8.8 Jurnal Agent 7 Rollout (Tanggal 2026-07-23)
**Modul terdampak:** `pindahgudang`, `opname`, `distribusifg`, `distribusiproduksi`, `produksiproses`, `adjustment`, `konversi_varian`, `pembatalan`.
**Daftar perubahan, 5 titik:** (1) `config/coTransaksiCore.php` - menyalin struktur `FifoProdukJadi` menjadi `FifoProdukJadiVarian` dan menginjeksi `variant_id`, `variant_nama`, `variant2_id`, `variant2_nama` pada block `rsltItems`; (2) `config/coTransaksiUi.php` - menginjeksi `"variant_label" => "Varian / SKU"` pada `$config['shoppingCartFields']`; (3) `controllers/_shoppingCart.php` - mapping `variant_id` dan `variant_label` dari item session ke array `$tmp`; (4) `controllers/Create.php` - ekstraksi `variant_id` dengan default 1 dan `variant_nama` dari loop `$_SESSION[$cCode]['items']`; (5) `controllers/FollowUp.php` - ekstraksi `variant_id` dengan default 1 dan `variant_nama` dari database row saat mapping item detail ke `$items`.
**Hasil audit:** pengujian syntax keseluruhan dengan `php -l` dijamin 100% OK. Skrip audit `check_flag_fifo.ps1` memperlihatkan bahwa semua flag `singleVariantStandard` aktif dan deteksi awal array FIFO sudah masuk; jumlah regex hit di PowerShell mungkin terlihat tidak seimbang secara sintaks sempit, tetapi logika injeksi parse PHP memastikan block tersisip valid. Kompatibilitas `MdlMother.php` terjaga karena injeksi ID diproses eksplisit di controller tanpa memaksa mutasi `normalizeSessionKeys` di seluruh gerbang global. Status: 100% Selesai.

## 9. Laporan Outstanding, Timeline Hold, dan Master Checklist Rollout
### 9.1 Master Global Checklist - Status Keseluruhan
**Tanggal update terakhir:** 2026-07-27. **Pelaksana:** Agent 7 (Gatekeeper dan Scope Crossing). **Status Keseluruhan:** 100% SELESAI dan DIVERIFIKASI (0 HUTANG).

Cakupan: (1) Rollout Single Variant Standard pada 10 Modul Inventory Core; (2) Penanganan dan eliminasi 22 Pattern Bug Systemic; (3) Penyesuaian UI, cetakan nota, dan laporan modul non-inventory; (4) Penyesuaian controller di luar HMVC modules; (5) Protokol keamanan, gatekeeper, dan penguncian session.

### 9.2 Matriks Pattern Bug Systemic (Bug 1A sampai 5I)
Dokumen mengklaim 22 pattern, namun hanya 20 ter-enumerate (lihat Kontradiksi K-6).

**Kelompok 1 - Form Input dan Shopping Cart (Session dan Subtotal):** Bug 1A (String CartKey sebagai `produk_id`) - ganti `"produk_id" => $id` menjadi `"produk_id" => $produkId` numeric di **275 process controllers** agar MariaDB tidak me-cast string menjadi `0`. Bug 1B (Cart Key Helper Integer Casting) - tambah regex parser untuk string `variant:X:Y` di `he_pembelian_cart_key_helper.php`. Bug 1C (Mis-timing Perhitungan Subtotal) - pindahkan loop update `$_GET['harga']` ke bagian paling atas sebelum kalkulasi `subtotal`.
**Kelompok 2 - Preview dan Simpan Transaksi (`coTransaksiCore.php`):** Bug 2A (Database Column Mapping) - ganti `"produk_id" => "id"` menjadi `"produk_id" => "produk_id"` pada `tableIn.detail` di seluruh 10 modul inventory. Bug 2B (Field Varian dan `valid_qty`) - daftarkan `"valid_qty" => "jml"`, `"variant_id"`, `"variant_nama"`, `"variant_label"` pada `tableIn.detail`.
**Kelompok 3 - Stock Locker dan Normalisasi Library (`Locker.php`):** Bug 3A (Locker Filter tanpa `variant_id`) - gunakan `$produkId` numeric dan `$c->addFilter("variant_id=" . $variantId)` via `ComLockerStockDualWrite`. Bug 3B (Undef Variable `$iSpec` di `_shoppingCart.php:reset()`) - ganti `$iSpec` menjadi `$item`. Bug 3C (Error Code 169 pada Normalisasi Stok) - ubah `Locker::normalisasiStok()` di `application/libraries/Locker.php` agar me-release `stock_locker` dan `stock_locker_variant` secara independent. Bug 3D (Per-Row Direct Release untuk Split Hold Rows) - zero-kan (`jumlah = 0`) setiap ID baris `hold` menggantung secara presisi per-ID primary key.
**Kelompok 4 - Cetak Nota Transaksi (`Printing.php` dan view `printing.php`):** Bug 4A (Registry Variant Key Mismatch dan Column Fallback) - tambah resolusi key otomatis `variant:X:Y` dan fallback ke `$row->produk_ord_hrg` serta `$row->produk_ord_jml`. Bug 4B (Pengindeksan Overwrite Row dan `array_filter` destruktif) - ganti pengindeksan `$rawItems` dengan `$rowIdx++` dan hapus `array_filter()` di view.
**Kelompok 5 - Alur Approval dan Multi-Step (`FollowUp.php` dan `doFollowup`):** Bug 5A (Multi-Key Matching dan Fallback) - isi `$validItems` dengan dual-key (`$xid`, `$vKey`, `$pId`) dan fallback qty transaksi lama. Bug 5B (Error Code 5180 di `doFollowup()`) - gunakan kandidat key varian untuk memeriksa ketersediaan session. Bug 5C (Transaksi Split, `valid_qty` PRE PO tidak berkurang) - perbaiki klausa `WHERE produk_id = $realPid` di seluruh **34 controller `FollowUp.php`**. Bug 5D (Dynamic Variant Label Fallback) - tambah `resolveVariantLabelName($variantId)` pada `he_variant_unifier_helper.php`. Bug 5E (Overwriting dan posisi kolom `variant_label`) - amankan `$iSpec['variant_label']` dan tempatkan kolom `Varian / SKU` di sebelah kanan `Descriptions` pada `coTransaksiUi.php`. Bug 5F (Kolom Varian di `receiptDetailFields`) - tambah `"variant_label" => "Varian / SKU"` pada `coTransaksiLayout.php`. Bug 5G (False-Positive Modal Perubahan Data Produk pada `itemStaging`) - parse string cart key di `FollowUp.php` menjadi numeric `produk_id` saat query ke `MdlProduk`. Bug 5H (Baris kosong "Produk: Nama (PID: )") - tambah filter `if ($rawKey === '' || $rawKey === '0' || $pId < 1) { continue; }`. Bug 5I (Session `tmpItems` menggantung dan modal BootstrapDialog) - amankan perbandingan varian dan auto-closing BootstrapDialog.

### 9.3 Penyesuaian UI, Cetakan, dan Modul Non-Inventory
**Cetakan dokumen nota** (unique row key plus badge varian `<span class='badge bg-blue'>`): `requeststok`, `penerimaan`, `penerimaanprojek`, `pembatalan`, `pembelianprojek`, `penjualanproject`.
**Modul laporan** (`application/modules/laporan/`), auto load `he_variant_unifier` helper: `Penjualan.php`, `Pembelian.php`, `Persediaan.php`, `Produksi.php`.
**Controller di luar modul (`application/controllers/`):**
| File | Perubahan |
|------|-----------|
| `Addons/ViewDetails.php` | Hover QTip Unique Row Key dan Variant Badge Resolution (PASS 35/35 controllers) |
| `Katalog.php` | Visual Catalog dan Fallback Variant SKU Keyword Search (`var_product_variants` lookup) |
| `Data.php` | Datatable Master Data Viewer dan Variant Generator Relation (`MdlProdukVarian`, `MdlSuppliesVarian`) |
| `addons/controllers/Qr.php` | Cetakan Barcode dan QR Code SKU Varian (`doPrint()` lookup `var_product_variants`) |
| `Spread.php` | Spreadsheet Matriks Harga Varian Per Cabang (relasi `hargaProduk`) |
| `Ledger.php` | Ledger Mutasi Stok Finished Goods (`viewMovementGroup` dual-write) |
| `ProductEditor.php` | Form Pengeditan Atribut Varian Produk |
| `VendorPrice.php` | Pengaturan Harga Supplier Per Varian |
| `SuppliesVariantSettings.php` | Pengaturan Varian Supplies |

### 9.4 Rencana dan Status Verifikasi Akhir
1. **Syntax Check PHP:** 100% Pass, 0 errors pada 275 process controllers, 35 ViewDetails, 6 Printing, dan 11 non-module controllers.
2. **Database Integrity Audit:** Clean 0 ghost rows (`produk_id = 0`) pada `transaksi_data`.
3. **Dual-Write Stock Locker Audit:** `stock_locker` dan `stock_locker_variant` 100% sinkron.

### 9.5 Dokumen Panduan dan Dashboard UAT User
`docs/panduan-uat-manual-user.md` adalah panduan pengujian lapangan kasus per kasus (22 bug cases), step per step (10 modul inventory), dan skenario per skenario (controller non-modul). `docs/panduan-uat-manual-user.html` adalah dashboard UAT interaktif berbasis LocalStorage dengan simpan otomatis, export dan import JSON, serta cetak laporan PDF. `docs/arsitektur-database-variant-visual.html` memvisualisasikan ERD Parent-Child, alur Dual-Write Stock Locker, Sentinel Stock Rule, dan simulator generator Cart Key. `docs/arsitektur-supplies-variant-visual.html` memvisualisasikan ERD `produk_supplies`, `var_supplies_variants`, `stock_locker_supplies_variant`, dan handler `_processSelectSupplies`. `docs/blueprint-varians-supplies-dan-produksi-bom.md` merancang varian supplies dan arsitektur Inherit-or-Override BOM manufaktur bervarian. `docs/blueprint-varians-supplies-dan-produksi-visual.html` adalah dashboard visual dan simulator penarikan otomatis formula bahan baku dan penolong bervarian. `docs/master-blueprint-design-variant-erp.md` adalah master design terpadu yang menyatukan Varian Produk Utama, Varian Supplies, dan Multi-Variant BOM Produksi.

### 9.6 Timeline Hold dan Kontrak Hold/Release
**Definisi state locker:** `active` adalah stok tersedia, `hold` adalah stok dikunci sementara oleh cart.
**Aturan hold release (Titik Domino, Bagian 3.7):** selector dan variantPicker, `shoppingcart->remove()`, dan `shoppingcart->reset()` adalah titik kritis penentu keberhasilan transaksi. Rilis hold WAJIB lewat `ComLockerStockDualWrite` di dalam transaksi DB, dan pada `remove()` harus terjadi SEBELUM data session dihapus. Pada `reset()`, item session dengan kuantitas `<= 0` wajib dibersihkan agar pre-processor FIFO tidak mengolah cache kosong yang dapat memblokir submit transaksi.
**Normalisasi saat login atau logout:** `Locker::normalisasiStok()` me-release stok `hold` menggantung secara per-row, bukan `LIMIT 1`, untuk menghindari error `code: 169` akibat split rows, lalu mengembalikan kuantitas ke `active` pada `ComLockerStock` atau `ComLockerStockVariant`.
**Otorisasi dan FollowUp:** `$arrValidQtyReady[]` diisi unconditional untuk setiap baris dengan `valid_qty > 0`, demi backward compatibility transaksi lama. Prinsipnya: item dari database harus selalu diproses, bukan hanya item yang masih ada di session browser.
**Lock Release Approval:** pola pada `__FollowUp.php` dan `FollowUp.php` sama dengan Pattern 1, yaitu `cekLocker("hold")` diganti `ComLockerStockDualWrite::pair()`.
**Referensi Status Traffic Log:** urutan penanganan bug mengikuti frekuensi lalu-lintas riil (Bagian 3.9), dengan `penjualan` sebagai prioritas utama pada 45,4% dari total hits.

### 9.7 Laporan Outstanding by Salesman (Versi Packinglist)
Dokumen ini menjelaskan arsitektur Laporan Order Backlog pada aplikasi `san_cik`, yang menghubungkan kinerja operasional penjualan dengan proyeksi pendapatan. **Peta komponen:** Controller `application/modules/laporan/controllers/Outstanding.php`; Library `application/libraries/laporan/DataOutstanding.php` (method `callPerSeller`); View `application/modules/laporan/views/outstanding.php`; MongoDB caching layer koleksi `outstanding_seller_blnan`.

**Struktur format mutasi (roll-forward schedule):** `Saldo Akhir = Saldo Awal + Penambahan Periode Berjalan - Pengurangan Periode Berjalan`.
**Kolom dan variabel kunci:** `prev_kredit_all` (outstanding periode lalu = Lokal + Project + Export), `now_saldo_order_all` (SO baru periode berjalan), `now_saldo_reject_582spd` (order ditolak), `now_saldo_closed_582spd` (order ditutup tanpa kirim), `now_batal_nilai_9912` (pembatalan order), `now_return_nilai_982` (retur order), `now_saldo_order_netto_all` (order baru bersih = New Order - Reject - Close), `now_saldo_kirim_all_new` (alokasi kirim ke order baru, capped sebesar order netto), `now_saldo_kirim_all_old` (alokasi kirim ke tunggakan lama), `now_saldo_kirim_all` (packing list value = Lokal + Project + Export), `now_saldo_kirim_netto_all` (Netto PL = Packing List - Cancel - Return), `last_kredit_all` (Outstanding Akhir = Prev Outstanding + New Order Netto - Netto PL).
**Logika distribusi pengiriman (FIFO):** Skenario A, jika `NEW ORDER NETTO VALUE >= Total Packing List Value` maka seluruh pengiriman ke order baru dan `LAST NETTO PL = 0`. Skenario B, jika `NEW ORDER NETTO VALUE < Total Packing List Value` dengan nilai order netto lebih besar dari 0, maka `NEW NETTO PL = NEW ORDER NETTO VALUE` dan `LAST NETTO PL = Total PL - NEW ORDER NETTO VALUE`. Skenario C, jika `NEW ORDER NETTO VALUE <= 0` maka `NEW NETTO PL = 0` dan `LAST NETTO PL = Total PL`.
**Catatan koreksi bug:** sebelumnya sistem menggunakan nilai order kotor `now_saldo_order_all` sebagai batas atas alokasi pengiriman baru; ini salah karena pengiriman bisa dialokasikan pada pesanan yang sudah ditolak. Koreksi diterapkan dengan memakai `now_saldo_order_netto_all`.
**Keselarasan standar keuangan:** laporan ini secara substansi adalah Laporan Order Backlog, bukan Laporan Piutang Usaha, karena angka outstanding merepresentasi nilai komitmen pengiriman dan belum menjadi tagihan yang dicatat pada Buku Besar. Menurut PSAK 72, pembuatan Sales Order adalah komitmen sehingga tidak dicatat sebagai Pendapatan, sedangkan nilai pengiriman bersih `now_saldo_kirim_netto_all` merupakan titik pemicu yang paling selaras dengan pengakuan pendapatan saat kendali atas barang berpindah ke pelanggan. Prinsip batas waktu (cut-off) menuntut status transaksi dikunci akurat pada batas akhir periode. Nilai Retur menambah kembali Outstanding Akhir karena perusahaan masih berutang barang pengganti; jika pelanggan membatalkan pesanan secara final, transaksi Return harus diikuti transaksi penyesuaian agar Outstanding Akhir kembali dinetralkan.

## 10. Review Bahasa dan Standar Sentence Case
### 10.1 Status Review
Dokumen review (`LANG_SENTENCE_CASE_REVIEW.md`) berstatus **Draft**. Belum ada perubahan pada file sumber; dokumen ini hanya berisi usulan perubahan teks ke sentence case.

**Total kandidat: 86** (40 Bahasa Indonesia ditambah 46 English).

### 10.2 Prinsip Transformasi yang Digunakan
| Kaidah | Contoh Transformasi |
|--------|---------------------|
| Huruf besar hanya di awal kalimat, bukan Title Case | "Import Selesai dengan Kendala" menjadi "Import selesai dengan kendala" |
| Kata umum turun ke huruf kecil | "Detail Data yang Ditolak:" menjadi "Detail data yang ditolak:" |
| Istilah teknis ikut diturunkan | "file Excel" menjadi "file excel"; "iImport klien" menjadi "iimport klien" |
| Label tombol diseragamkan | "OK" menjadi "Ok" |
| Proper noun jabatan diseragamkan | "Branch Manager" menjadi "branch manager" |
| Status-flow diseragamkan | "Lost" menjadi "lost"; "Nanti" menjadi "nanti"; "Konfirmasi" menjadi "konfirmasi" |
| Awal kalimat setelah titik tetap huruf besar | "...upload ulang. submit dinonaktifkan sampai semua error diperbaiki." |
| Kata serapan dibakukan | "Unggah Template" menjadi "Unggah template" |

### 10.3 Sebaran Kandidat
| File Sumber | Jumlah Kandidat | Fokus |
|-------------|----------------:|-------|
| `x:\san_ibb\app\Language\Indonesian\custom_lang.php` | 40 | Pesan import dan Excel, duplicate data, lead status workflow, estimate |
| `x:\san_ibb\app\Language\english\custom_lang.php` | 46 | Cermin dari versi Indonesia dengan pola identik |

Kunci yang paling banyak terdampak: `import_*` (12 kunci per bahasa), `lead_status_lost_*` (5 kunci), `lead_workflow_note_*` (5 kunci), `lead_status_history_legend_*` (3 kunci), serta `upload_image_template`, `text_lampiran_photo_print`, `setting_print`, `print_estimate_letterhead`.

**Catatan risiko:** steady-state transformasi membuat "submit dinonaktifkan", "hanya data valid", "pilih satu baris", dan "ubah data agar dapat disimpan" menjadi huruf kecil setelah titik. Secara gramatikal Bahasa Indonesia ini benar, tetapi perlu proofreading UI karena mengubah posisi kapital di tengah pesan panjang. Kunci `lead_workflow_note_optional_help` ("Catatan opsional untuk progres masuk. Catatan akan direkam ke history.") merupakan contoh paling jelas atas risiko ini.

## 11. Temuan Lintas-Dokumen dan Kontradiksi
| ID | Topik | Sumber A | Sumber B | Temuan dan Dampak |
|:--:|-------|----------|----------|-------------------|
| K-1 | Nilai sentinel `variant_id` | `AGENTS.md` bagian Dual-Write Rollout dan `master-global-checklist-variant.md`: non-varian `variant_id=0` diubah jadi sentinel `1`; item varian bawaan atau tunggal memakai `variant_id = 1` | `_tmp_agents.md`, `ai-agent-rules-foundation.md`, `blueprint-konverter-multi-variant.md`: `VARIANT_DEFAULT_ID = -1` dan `defaultVariantId => -1` | **Kontradiksi keras.** Dua nilai sentinel berbeda, yaitu 1 dan -1. Dampak: data yang ditulis dengan -1 tidak akan terbaca oleh filter sentinel `variant_id=0 -> 1`, dan sebaliknya. Harus diputuskan seragam sebelum rollout lanjut. |
| K-2 | Status Feature Flag | `AGENTS.md`, `team-rules.md`, `prompt-rollout-agent.md`: `singleVariantStandard.enabled` **tetap `false`** sampai rollout diverifikasi | `agent-7-rollout.md` (2026-07-23): "semua flag `singleVariantStandard` telah aktif" | **Kontradiksi keras.** Jurnal Agent 7 menyatakan flag aktif, sementara tiga dokumen aturan melarang perubahan ke `true`. Perlu klarifikasi apakah "aktif" berarti terpasang di config atau benar-benar `enabled => true`. |
| K-3 | Routing Rules MOD | `ecosystem_status.md`: 8 pipeline yang konsisten dengan 11 agent | `01_moderator.md`: 5 routing rules yang menyebut role `business` dan `integrator` yang tidak ada di registry 11 agent | **Kontradiksi.** Role `business` dan `integrator` tidak terdaftar, kemungkinan sisa draft. Routing table resmi yang dipakai adalah versi `ecosystem_status.md`. |
| K-4 | Siapa boleh menulis kode | `01_moderator.md` dan `03_executor.md`: EXE satu-satunya agent yang BOLEH mengedit file dan menjalankan perintah | `ecosystem_status.md`: kolom "Tulis Kode?" bernilai Ya untuk EXE, TEC, SWE, QA. `ANTIGRAVITY_README.md` menyebut hanya 3 role (MOD, PLN, EXE) | **Kontradiksi.** Tiga model berbeda: (a) EXE saja, (b) EXE plus TEC plus SWE plus QA, (c) hanya 3 role tanpa domain specialist. Perlu menetapkan satu model dan menulisnya konsisten di semua rules file. |
| K-5 | Jumlah "20 Pattern Rules" | `AGENTS.md` judul bagian 5: "20 Pattern Rules" | Enumerasi hanya 19 nomor (5.1 nomor 1-3, 5.2 nomor 4-7, 5.3 nomor 8-10, 5.4 nomor 11-19) | **Ketidaksesuaian jumlah.** Satu aturan hilang atau salah nomor. |
| K-6 | Jumlah "22 Pattern Bug Systemic" | `master-global-checklist-variant.md`: "22 Pattern Bug Systemic (Bug 1A s.d. 5I)" | Enumerasi aktual: 1A-1C (3) + 2A-2B (2) + 3A-3D (4) + 4A-4B (2) + 5A-5I (9) = **20 item** | **Ketidaksesuaian jumlah.** 20 ter-enumerate tetapi diklaim 22. |
| K-7 | Cleanup `rsltItems` dan tabel stok | `blueprint-konverter-multi-variant.md` bagian 4.3-4.4: `rsltItems` DIHAPUS, `stock_locker` DIHAPUS, `stock_locker_mutasi` DIHAPUS; Fase 4 Cleanup dijadwalkan | `team-rules.md`, `_tmp_agents.md`, `prompt-rollout-agent.md`: "Jangan hapus `rsltItems`", "Dual-write permanen - tidak ada cleanup", "ADD ONLY" | **Kontradiksi strategi paling berbahaya.** Blueprint merencanakan penghapusan total, sedangkan aturan tim melarang penghapusan dan menyatakan dual-write permanen. Fase 4 Cleanup tidak boleh dijalankan tanpa keputusan arsitektur eksplisit. |
| K-8 | Path workspace | Role files 01 sampai 10 dan `AGENTS.md`: `c:\xampp\htdocs\new_san_variant` | `_tmp_agents.md`: `w:/new_san_variant`. `ai-agent-rules-foundation.md` dan `prompt-rollout-agent.md`: `\\192.168.5.14\web\new_san_variant`. `blueprint-konverter-multi-variant.md`: `w:/san_staging/...`. `AGENS_LAPORAN_OUTSTANDING.md`: `w:/san_cik` | **Lima workspace berbeda.** Salah pilih path menyebabkan perubahan diterapkan ke instance yang salah. Perlu konfirmasi instance aktif sebelum eksekusi. |
| K-9 | Direktori rules | `01_moderator.md`, `02_planner.md`, `03_executor.md`, `04_technical.md`: `.agents/rules/moderator.md` dan `.agents/config.json` | `moderator.md`, `planner.md`, `executor.md`, `technical.md`, `ANTIGRAVITY_README.md`: `.workflow/moderator.md` dan `.workflow/check-console.mjs` | **Kontradiksi path.** Dua layout berbeda, yaitu `.agents` dan `.workflow`. `ANTIGRAVITY_README.md` menyatakan `.agents` di root adalah yang dibaca Antigravity. |
| K-10 | Path console check | `03_executor.md`, `01_moderator.md`, `ANTIGRAVITY_README.md`: `workflow/check-console.mjs` | `executor.md`: `.workflow/check-console.mjs` | Ikut dari K-9. Perlu path kanonik tunggal. |
| K-11 | Flag `enable_subagent_tools` TEC | `04_technical.md` frontmatter: `enable_subagent_tools: false` | `technical.md` mendokumentasikan protokol `invoke_subagent` technical ke compliance dengan contoh nyata `REQ-002` | **Kontradiksi konfigurasi.** Frontmatter melarang subagent call, sedangkan body dokumen mengamanatkan pemanggilannya. |
| K-12 | Lokasi normalizer session | `ai-agent-rules-foundation.md` dan `blueprint-konverter-multi-variant.md`: normalizer di `Modul_Controller::__construct()` | `_tmp_agents.md` dan `prompt-rollout-agent.md`: auto-normalize di `MdlMother::__construct()` dengan **0 perubahan di `Modul_Controller.php`** | **Perbedaan implementasi.** Foundation design doc tidak tercermin pada implementasi aktual. `blueprint-konverter-multi-variant.md` bagian 7.3 masih menyebut "Tambah `normalizeSessionKeys()` di `Modul_Controller.php`". |
| K-13 | Lokasi file helper dan view | `ai-agent-rules-foundation.md` dan `blueprint-konverter-multi-variant.md` bagian 7.1: `helpers/he_variant_unifier.php` serta `database/migrations/XXX_create_view_stock_unified.sql` | `_tmp_agents.md`: `application/helpers/he_variant_unifier.php` serta `docs/sql/001_create_view_stock_unified.sql` | **Perbedaan path** antara dokumen desain dan implementasi aktual. |
| K-14 | Host pustaka aturan global | `global_rules.md` bagian 3 Doc-Sync: root pustaka terpusat `W:\AGENT_GLOBAL` dengan path relatif `clients/everest/...` | `AGENTS.md` bagian 3.7: root `W:\AGENT_GLOBAL` atau `\\192.168.168.14\web\AGENT_GLOBAL` | **Host tidak konsisten:** workspace berada di `192.168.5.14` sedangkan AGENT_GLOBAL di `192.168.168.14`. Perlu verifikasi network path. |
| K-15 | Versi PHP | `AGENTS.md` bagian 1: PHP 5.6 | `04_technical.md`: "CI3, PHP 5.6+" | Inkonsistensi redaksi. Tanda `5.6+` bisa dibaca sebagai izin PHP 7 atau 8 yang **dilarang keras** oleh `AGENTS.md` bagian 3.6. |
| K-16 | Cakupan multi-client | `AGENTS.md` Langkah 6: referensi backward-compat `W:\new_original_indosan_for_variant/` | Global rules mencakup PT. Everest, PT. INDOSAN, POS Sumber Boga, Maju Mapan, Jodomart.id | Path referensi spesifik satu client sementara aturan global dispatch untuk multi-client. Perlu klarifikasi apakah migrasi varian hanya untuk INDOSAN. |
| K-17 | Penomoran bagian AGENTS.md | `AGENTS.md` bagian 3.9, 3.10, 3.11, dan 3.12 | Letaknya muncul **setelah** bagian 5.5 sehingga urutan dokumen tidak ascending | **Struktur dokumen rusak.** Pembacaan kronologis akan melewati bagian 3.9 (Struktur Respon Wajib) yang merupakan gerbang wajib. |
| K-18 | Typo nama tabel pada prompt | `PROMPT_MIGRASI_VARIAN.md` Tahap D: `stock_locker_varian`, `_rek_pembantu_produk_varian*`, `rek_cache_persediaan_produk_varian_fifo` | Seluruh dokumen lain: `stock_locker_variant`, `_rek_pembantu_produk_varian_cache`, `stock_locker_mutasi_variant` | **Typo berulang di prompt template.** Jika prompt ini dipakai apa adanya, query verifikasi akan salah nama tabel. |
| K-19 | Berkas rules QA tidak termasuk | `ecosystem_status.md` mendaftarkan 11 subagent termasuk `qa_audit` | Berkas `11_qa_audit.md` ada di direktori sumber tetapi **tidak ada** dalam daftar 30 file sintesis ini | Cakupan sintesis 30 file tidak memuat rules detail QA. Aturan QA hanya bisa diambil dari `AGENTS.md` bagian 2.7. |
| K-20 | Klaim status 100 persen | `master-global-checklist-variant.md`: "100% SELESAI dan DIVERIFIKASI (0 HUTANG)" | `AGENTS.md` masih memuat 20 invariant dan gate aktif; `blueprint-uat-fix-konversi-selector-shoppingcart-varian.md` bagian 11 masih "Urutan Eksekusi Setelah Blueprint Disetujui" (Fase A-D belum eksekusi) | **Status rollout tidak seragam antar dokumen.** Master checklist mengklaim tuntas, blueprint UAT masih fase perencanaan. |
| K-21 | Scope modul `biaya` | `AGENTS.md` Invariant 14 dan tabel agent: `biaya` masuk scope Agent 2 dan `lockerCheck` enabled di `biaya` | `_tmp_agents.md` out-of-scope module list memuat `biaya` | Modul `biaya` masuk scope Agent 2 di AGENTS.md tetapi out-of-scope di `_tmp_agents.md`. |
| K-22 | Modul `konversi` baca-saja | `AGENTS.md` Scope Rules: modul `konversi` boleh dibaca hanya sebagai referensi, DILARANG diubah | AGENTS.md sendiri menugaskan Agent 1 untuk `konversi` dan `konversi_varian` | Aturan baca-saja berlaku untuk Agent 2 sampai 7. Perlu ditegaskan karena ambigu secara tekstual. |
| K-23 | Taksonomi masalah session | `AGENTS.md` Invariant 9 dan Bug 5H memakai istilah ghost key dan baris kosong "Produk: Nama (PID: )" | `blueprint-uat-fix-...` bagian 3.6 dan 3.10 memakai istilah **shadow-state** (`items_source`, `items_target`) | Dua taksonomi berbeda untuk masalah yang sama (dual-session-key versus shadow-state). Sebaiknya disatukan agar pelacakan bug tidak terpecah. |
| K-24 | Standar output | `moderator.md` dan `planner.md` versi panjang: "HANYA SATU code block", "WAJIB SEMUA TEKS DALAM code block", tanpa nested code block | `01_moderator.md`, `02_planner.md`, `04_technical.md` versi pendek: format `=== LAPORAN ===` plaintext tanpa aturan code block | **Dua standar output berbeda.** Versi panjang dengan blok `> DARI X untuk Y` lebih ketat dan perlu diadopsi sebagai kanonik. |

### 11.1 Rekomendasi Prioritas
1. **Putuskan sentinel `variant_id` (K-1)** - berdampak pada seluruh tulis stok.
2. **Putuskan strategi cleanup (K-7)** - menentukan apakah Fase 4 Blueprint dijalankan atau dibatalkan permanen.
3. **Konfirmasi instance dan workspace aktif (K-8)** - mencegah perubahan pada instance yang salah.
4. **Selaraskan status feature flag (K-2) dan status rollout (K-20)** - agar gerbang mark done bermakna.
5. **Tetapkan layout kanonik (`.agents` versus `.workflow`) dan standar output (K-9, K-10, K-24)** - memengaruhi autentikasi dan parsing.
6. **Perbaiki penomoran dan typo (K-5, K-6, K-18)** - murah, mencegah salah rujukan.

## 12. Lampiran: Daftar File Sumber (30 Berkas)
| # | Nama File | Ukuran (bytes) | Topik H1 | Peran |
|:-:|-----------|---------------:|----------|-------|
| 1 | `AGENTS.md` | 59.987 | PROTOKOL GERBANG AGENT (GATEKEEPER dan SCOPE LOCKING) | Konfigurasi inti: Gatekeeper, Scope Lock, 7 langkah workflow wajib, 5 pilar bisnis, 20 invariant, aturan coding global, traffic log priority, audit 3-layer |
| 2 | `_tmp_agents.md` | 4.490 | ROLE: Senior ERP Developer (Legacy Specialist) | Prompt peran senior ERP dev: klasifikasi 19 in-scope dan 36 out-of-scope modul, 5 prinsip kerja, 6 larangan mutlak, verifikasi minimal 6 butir |
| 3 | `01_moderator.md` | 3.556 | MODERATOR (MOD) - Pintu Gerbang Ekosistem | Rules ringkas MOD: 5 routing rules, cara memanggil PLN via `invoke_subagent`, sistem log `inter-log.txt`, context compaction recovery |
| 4 | `02_planner.md` | 2.652 | PLANNER (PLN) - Perencana dan Prompt Creator | Rules ringkas PLN: cara memanggil EXE, format rencana multi-agent, review laporan 3 langkah |
| 5 | `03_executor.md` | 3.102 | EXECUTOR (EXE) - Eksekutor dan Pelapor | Rules ringkas EXE: verifikasi wajib 3 jenis, format `=== LAPORAN ===`, guardrail, 5 aturan kode CI3 |
| 6 | `04_technical.md` | 1.970 | TECHNICAL AGENT - Analisis Kode dan Bug | Rules ringkas TEC: analisis kode, deteksi 5 kelas bug, optimasi MariaDB, standar OWASP Top 10, frontmatter `enable_subagent_tools: false` |
| 7 | `05_product_owner.md` | 2.943 | PRODUCT OWNER AGENT (PO) | Rules PO: User Stories, format `=== PRD ===`, Acceptance Criteria, siklus akuntansi, ISO 9001:2015, 4 larangan |
| 8 | `06_compliance_tax.md` | 3.703 | COMPLIANCE TAX AGENT (CTA) | Rules CTA: sifat skeptis, tiga kategori kritik, verdict, checklist validasi 6 butir, daftar PSAK 1 sampai 72 |
| 9 | `07_lead_architect.md` | 3.631 | LEAD ARCHITECT AGENT (ARC) | Rules ARC: skema DB, struktur API, AES-256, RBAC, immutable audit log, format ADR, 6 prinsip arsitektur wajib |
| 10 | `08_treasury.md` | 2.861 | TREASURY and SETTLEMENT SPECIALIST AGENT (TRS) | Rules TRS: validasi voucher 6 butir, rekonsiliasi bank statement, PSAK 2 cash flow, AR/AP aging, toleransi 0 rupiah |
| 11 | `09_tax_integration.md` | 3.370 | ENTERPRISE TAX INTEGRATION AGENT (TAX) | Rules TAX: rekonsiliasi Coretax DJP, tarif pajak 2025, PER-03/PJ/2022, OAuth 2.0, idempotency key, tabel `coretax_sync_logs` |
| 12 | `10_software_engineer.md` | 3.868 | SOFTWARE ENGINEER AGENT (SWE) | Rules SWE: 6 aturan mutlak, inline docs, DB transactions, immutable audit trail, anti SQLi, N+1 prevention, pola kode, format SWE REPORT |
| 13 | `moderator.md` | 6.229 | MODERATOR - Inisiasi dan Ecosystem Manager | Rules MOD panjang: baca ulang tiap giliran, fleksibilitas komunikasi, kode identitas, aturan code block, 6 kategori instruksi ke user |
| 14 | `planner.md` | 8.264 | PLANNER - Perencana dan Prompt Creator | Rules PLN panjang: format output akhir, review laporan 6 aturan termasuk deteksi kegagalan berulang, pengingat mutual antar sesi |
| 15 | `executor.md` | 9.832 | EXECUTOR - Eksekutor dan Pelapor | Rules EXE panjang: guardrail aksi berisiko, scope discipline, error handling, verifikasi Playwright, checkpoint git, 2 format laporan |
| 16 | `technical.md` | 2.670 | TECHNICAL AGENT - Analisis Kode dan Bug | Rules TEC panjang: protokol `invoke_subagent` technical ke compliance, contoh nyata `inter-log.txt` dan laporan `REQ-002` |
| 17 | `global_rules.md` | 2.662 | GLOBAL_RULES: Aturan dan Protokol Umum AI Agent / Developer | Standar komunikasi 4 butir, keamanan database, Data Loss Prevention, protokol Doc-Sync multi-client (Everest dan Indosan) |
| 18 | `ai-agent-rules-foundation.md` | 2.262 | AI Agent Rules - Foundation Layer (Single Variant Standard) | Agent foundation P0: 4 file output, kode wajib helper `resolveVariantId` dan `normalizeSessionKeys`, 3 verifikasi, rollback |
| 19 | `team-rules.md` | 1.783 | Aturan Kerja Tim - Single Variant Standard Migration | Task claim, dependency order, quality gate 5 butir, komunikasi harian, rollback safety, batasan mutlak 4 butir, tooling |
| 20 | `ecosystem_status.md` | 4.995 | Ekosistem Antigravity - Full Architecture (11 Agents) | Arsitektur 2 layer dengan Mermaid, registry 11 subagent, 8 routing rules, cara memanggil agent, aturan emas penulisan kode |
| 21 | `ANTIGRAVITY_README.md` | 3.513 | ANTIGRAVITY - Workflow Otomatis MOD-PLN-EXE | Setup native subagent, prasyarat Node.js v18+, quick setup, struktur file `.agents` dan `workflow`, console check, troubleshooting |
| 22 | `agent-7-rollout.md` | 2.118 | Jurnal Pengembangan - Agent 7 Rollout Single Variant Standard | Jurnal 2026-07-23: 8 modul terdampak, 5 titik perubahan file, hasil audit `php -l` 100% dan `check_flag_fifo.ps1` |
| 23 | `prompt-rollout-agent.md` | 2.151 | PROMPT ROLLOUT - Single Variant Standard Migration | Prompt siap pakai: 5 langkah kerja (blueprint, AGENTS.md, rules modul, referensi konversi, eksekusi), 5 aturan mutlak, 4 verifikasi |
| 24 | `PROMPT_MIGRASI_VARIAN.md` | 6.747 | Prompt Kit Migrasi Produk Varian (Chat Baru) | Konteks organisasi holding dan 5 subsidiary, 7 dokumen referensi, Tahap A, A2, B, C, D, E, F dengan gate approval, catatan operasional SQL |
| 25 | `AGENS_LAPORAN_OUTSTANDING.md` | 8.680 | Blueprint Laporan Outstanding by Salesman (Versi Packinglist) | Arsitektur laporan order backlog: peta komponen 4 file, alur MongoDB, 15 definisi kolom, logika FIFO new versus last netto, PSAK 72, cut-off, perlakuan retur |
| 26 | `master-global-checklist-variant.md` | 11.273 | Master Global Checklist and Progress Audit - Single Variant Standard Rollout | Status 10 modul, matriks 20 pattern bug (1A-5I), penyesuaian UI dan 9 controller non-modul, verifikasi akhir, 7 dokumen dashboard UAT |
| 27 | `blueprint-ai-problem-solving.md` | 6.530 | BLUEPRINT PERANCANGAN DAN VALIDASI SISTEM AI | Framework AI: flowchart Mermaid, 4 AI alignment guidelines, Three-Way Matching, kamus data, 2 kasus uji riil, jalur Human-in-the-Loop |
| 28 | `LANG_SENTENCE_CASE_REVIEW.md` | 11.838 | Language Sentence Case Review (Draft) | Draft review 86 kandidat sentence case di `custom_lang.php` Indonesia (40) dan English (46), tabel line, key, current, proposed |
| 29 | `blueprint-konverter-multi-variant.md` | 18.793 | BLUEPRINT: KONVERTER MULTI-VARIANT - SINGLE STANDARD VARIANT ARCHITECTURE | Arsitektur target: sentinel -1, session key seragam, pipeline tunggal, view `stock_unified`, Opsi A dan B, UAT T1-T5 dan E1-E5, rollback plan, 4 fase migrasi, ISO 25010 checklist |
| 30 | `blueprint-uat-fix-konversi-selector-shoppingcart-varian.md` | 22.936 | BLUEPRINT UAT FIX `konversi`: Selector and ShoppingCart Support Varian | 10 baseline masalah dengan line reference, kontrak source-first, routing postProcessor per-row, 14 acceptance parameters P-00 sampai P-13, UAT matrix M1-M4, 4 fase eksekusi |
**Total ukuran 30 berkas sumber: 322.727 bytes.**

### 12.1 Rujukan Path Kunci yang Diberlakukan Kontrak
| Path atau Nama | Jenis | Peran |
|----------------|-------|-------|
| `docs/uat-checklist.md` | Dokumen | WAJIB baca sebelum kerja dan WAJIB update setelah selesai (Gerbang 3 dan 4) |
| `AGENT_GLOBAL/README.md` | Pustaka aturan | Aturan pengembangan global multi-client |
| `clients/everest/erp_web/modules/[nama_modul].md` | Dok klien | Target Doc-Sync PT. Everest |
| `clients/indosan/erp_web/modules/[nama_modul].md` | Dok klien | Target Doc-Sync PT. INDOSAN |
| `kamus_transaksi.md` | Kamus | Wajib diperbarui bila ada `jenisTr` baru |
| `application/modules/[nama_modul]/docs/dev-jurnal.md` | Jurnal lokal | Wajib update setiap sesi sebelum turn diselesaikan |
| `application/modules/[nama_modul]/docs/refactoring/workflow_[nama_modul].md` | Dok workflow | Wajib dibuat untuk modul baru (Mermaid + step + cross-reference log) |
| `application/modules/[nama_modul]/docs/refactoring/uat_[nama_modul].md` | Dok UAT | Wajib dibuat (Automated Self-UAT + Manual Human UAT) |
| `.agents/rules/moderator.md`, `planner.md`, `executor.md` | Rules | Dibaca ulang tiap giliran oleh agent tujuan |
| `.agents/skills/mod-command/SKILL.md` | Skill | Trigger perintah `/mod` |
| `workflow/inter-log.txt` | Log | Wajib untuk semua komunikasi antar role |
| `workflow/check-console.mjs` | Tool | Verifikasi browser headless via Playwright |
| `application/helpers/he_variant_unifier.php` | Helper | `resolveVariantId()`, `normalizeSessionKeys()`, `getUnifiedStock()` |
| `application/models/Mdls/MdlMother.php` | Model | Auto-normalize session di `__construct()` |
| `application/models/Coms/ComLockerStockDualWrite.php` | Com | SATU-SATUNYA entry point write stok |
| `application/libraries/Locker.php` | Library | `normalisasiStok()` per-row direct release |
| `application/modules/[modul]/.ai-agent-rules.md` | Rules modul | Tugas spesifik dan file target per modul |
| `docs/blueprint-konverter-multi-variant.md` | Blueprint | Acuan rollout |
| `docs/team-rules.md` | Aturan | Aturan kerja tim |
| `docs/dev-journal/blueprint-progress-tracker.md` | Tracker | Progress tracking rollout |
| `docs/dev-journal/2026-06.md` | Jurnal | Jurnal harian |
| `W:\new_original_indosan_for_variant/` | Backup | Referensi backward compatibility (Langkah 6) |
| `docs/sql/001_create_view_stock_unified.sql` | SQL | View `stock_unified` penjatu `stock_locker` dan `stock_locker_variant` |
| `application/sql/variant_migration_phase1/precheck.sql` | SQL | Gate sebelum migrasi DB subsidiary |
| `application/sql/variant_migration_phase1/migrate_variant_foundation.sql` | SQL | Migrasi DB butuh approval |
| `application/sql/variant_migration_phase1/postcheck.sql` | SQL | Gate `missing_total = 0` untuk lanjut Tahap B |
| `coretax_sync_logs` | Tabel | Log request dan response sinkronisasi Coretax DJP |
| `check_flag_fifo.ps1` | Skrip PowerShell | Audit flag `singleVariantStandard` dan deteksi awal array FIFO |
*Dokumen sintesis ini adalah referensi protokol tunggal untuk ekosistem AI agent pada proyek ERP Single Variant Standard. Seluruh aturan di atas wajib dibaca ulang sebelum setiap tindakan penulisan atau modifikasi file, khususnya oleh agent yang menerima tugas, sebelum menjalankan gate Gatekeeper (Bagian 2), Aturan Kode CI3 Mutlak (Bagian 3.5), dan Aturan Mutlak Tim (Bagian 6.6).*
