# Sintesis Modul Stok Opname, Arsitektur RabbitMQ, dan AutoPurchase FG/Project

## Dokumen konsolidasi lintas-berkas untuk ERP Everest (CodeIgniter 3 HMVC, PHP 5.6) dari 17 dokumen sumber

Dokumen ini menggabungkan dan mengelaborasi seluruh isi 17 berkas sumber menjadi satu narasi teknis. Fokusnya tiga pilar: (a) modul Stok Opname beserta metodologi UAT 5W+1H, (b) arsitektur asynchronous message queue berbasis RabbitMQ untuk memindahkan penjurnalan dan mutasi kartu stok keluar dari siklus HTTP, serta (c) fitur AutoPurchase Finished Goods (FG) Proyek yang menghubungkan modul `master_project` dengan modul `pembelianfgproject`. Ditambahkan pembahasan tray notifikasi, backorder multi-entitas, rekonsiliasi uang muka, dan switch pelaksana SPK sebagai konteks yang berbagi komponen dasar.

Semua detail teknis (nama exchange, nama queue, nama tabel, nama kolom, nomor baris fungsi, kode transaksi, nomor COA) diambil apa adanya dari dokumen sumber. Setiap poin tanpa dasar sumber ditandai eksplisit pada bagian 10 agar tidak terjadi perubahan makna.

---

## 1. Ringkasan Eksekutif

### 1.1 Inti Masalah

Modul Stok Opname bermuara pada langkah **Approve 2** (`1119ro` -> `1119`). Pada langkah tersebut, controller `FollowUp.php` (1.37 MB) menjalankan seluruh beban secara sinkron di dalam satu siklus HTTP request: menghitung mutasi saldo stok dan HPP untuk ribuan produk, membuka transaksi database lewat `$this->db->trans_start()` yang dapat berjalan ratusan detik, menulis `jurnal`, `rekening`, dan `rekening_pembantu_produk`, serta memvalidasi neraca secara sinkron melalui `validateJurnal()` dan `validateAllBalances()`.

| Dampak | Gejala |
|--------|--------|
| HTTP timeout | Nginx/Apache memutus koneksi (Error 504/502) sebelum kalkulasi selesai |
| Deadlock | MySQL Error 1213/1205; transaksi database menggantung mengunci tabel persediaan sehingga kasir toko lain macet |
| Data pincang | User menutup browser di tengah proses loading; sebagian data masuk, sebagian gagal |

### 1.2 Tiga Solusi dalam Paket Dokumen

| Area | Ringkasan | Status pada sumber |
|------|-----------|--------------------|
| Stok Opname | Modul lengkap 23 controller + 5 config, alur download Excel -> isi fisik -> upload -> execute -> approval 2 tahap -> jurnal | Aktif, dengan saklar RabbitMQ **dimatikan** |
| RabbitMQ | Migrasi step Approve 2 ke pola publish/worker dengan staging table, chunking 200 item, DLQ, dan shadow table | Desain lengkap, **belum diaktifkan** (`opname_use_rabbitmq = false`) |
| AutoPurchase | Wadah `project_purchase_pool` terbentuk saat Kickoff Project, ditarik ke PO `1466` via Direct Inline UI, sinkron HPP balik + audit trail | Fase 1-5 selesai, 7 berkas berstatus SELESAI |

### 1.3 Angka Kunci

| Metrik | Nilai |
|--------|-------|
| Controller modul opname | 23 file (`FollowUp.php` terbesar, 1.37 MB) |
| Config modul opname | 5 file (4 wajib + 1 backup) |
| Batch insert detail opname | 500 item per batch |
| Batas ukuran file upload | 1 MB (`max_size = 1024` KB) |
| Riwayat download ditampilkan | 10 baris terakhir |
| Auto-refresh dashboard opname | 60 detik (`header("refresh:60")`) |
| Chunking worker RabbitMQ | 200 item per transaksi DB |
| QoS prefetch | 1 pesan |
| Rata-rata item detail per dokumen | 4,8 baris |
| Selisih badge tray | 2.958 vs 612 |
| Ambang konfirmasi e-Form PDF | selisih > 50 unit |
| Total test case UAT | 33 (5W1H) / 40 (checklist) |

---

## 2. Modul Stok Opname (5W+1H) dan Peta Commonplace

### 2.1 Definisi dan Matriks Jenis Barang

Modul `opname` adalah **Physical Inventory Count**: menghitung fisik persediaan, membandingkannya dengan stok buku, lalu mencatat selisihnya sebagai adjustment di jurnal akuntansi.

| Jenis | Kode Transaksi (Pusat) | Kode Transaksi (Cabang) | COA Rekening |
|-------|------------------------|-------------------------|--------------|
| Produk | `1119` | `2229` | `1010030030` (Persediaan Produk) |
| Supplies | `1118` | `2228` | `1010030010` (Persediaan Supplies) |
| Produk Rakitan | `5559` | `5559` | `1010030070` (Persediaan Produk Rakitan) |

`AGENTS_OPNAME.md` mengartikan `1119` untuk Gudang Good/PUSAT DC dan `2229` untuk Gudang Project, sedangkan `analisa_modul_opname.md` memetakan `2229` sebagai kode cabang untuk Produk. Lihat Temuan K-07.

### 2.2 Ringkasan 5W+1H

| Dimensi | Isi |
|---------|-----|
| **What** | Penghitungan fisik, cetak workbook Excel berstok buku, input stok riil, upload, hitung selisih, posting jurnal adjustment |
| **Who** | Petugas Gudang (`c_gudang`) untuk step 1 dan input data; Supervisor/Manager role `c_holding` untuk Authorization 1 dan 2; Akuntan sebagai cross-check jurnal |
| **When** | Saat membuka halaman index (validasi transaksi gantung), saat download Excel pertama kali untuk sebuah gudang, saat upload file terisi, dan saat approval bertingkat |
| **Where** | `opname/Opname/index/Produk`, `opname/Opname/view/Produk`, `opname/Opname/doPrint/Produk`, `opname/Opname/doUpload/Produk`, `opname/Opname/executeOpname/Produk`, `opname/FollowUp/doFollowup/1119/...` |
| **Why** | Selisih lebih berarti ada stok belum tercatat (Laba Lain-lain); selisih kurang berarti ada stok hilang (Kerugian). Salah kalkulasi berdampak langsung ke laporan keuangan |
| **How** | Download Excel -> isi kolom "stok riil" offline -> upload -> executeOpname -> approval 2 tahap -> mutasi stok + jurnal pada step final |

### 2.3 Approval Chain untuk Produk Pusat `1119`

| Step | Label | Source -> Target | User Group | State |
|------|-------|------------------|------------|-------|
| 1 | STOCK OPNAME | `""` -> `1119r` | `c_gudang` | Pending Approval 1 (merah) |
| 2 | AUTHORIZATION 1 | `1119r` -> `1119ro` | `c_holding` | Pending Approval 2 (oranye) |
| 3 | AUTHORIZATION 2 | `1119ro` -> `1119` | `c_holding` | Complete (hijau) |

Endpoint: `FollowUp.php::doFollowup()`.

### 2.4 Komponen Akuntansi pada Step Final

Jurnal dan rekening pada level master (menurut `analisa_modul_opname.md`):

| COA | Nama | Arah | Sumber Nilai |
|-----|------|------|--------------|
| `1010030030` | Persediaan Produk | Debet | Selisih lebih (`qty_debet` x hpp) |
| `7010150` | Laba Lain-lain | Debet | Selisih lebih (opname > stok buku) |
| `1010030030` | Persediaan Produk | Kredit | Selisih kurang (`qty_kredit` x `hpp_avg`) |
| `7020020` | Kerugian | Kredit | Selisih kurang (stok buku > opname) |

Rekening pembantu pada level detail: `RekeningPembantuProduk` (mutasi stok per produk), `RekeningPembantuLRLainlain` (detail laba lain-lain opname), `RekeningPembantuKerugian` (detail kerugian opname).

Selisih kurang dihitung preprocessor `FifoAverageOpname` dengan konfigurasi `coTransaksiCore.php` baris 38: `"kredit" => "hpp_avg*qty_kredit"`.

### 2.5 PreProcessor dan PostProcessor

| Tahap | Step | Component | Fungsi |
|-------|------|-----------|--------|
| PreProcessor | `1119ro` (Step 2) | `ProdukSerialNumberExtractorOpname` | Ekstrak serial number produk |
| PreProcessor | `1119` (Step 3) | `ProdukSerialNumberExtractorOpname` | Ekstrak serial number final |
| PreProcessor | `1119` (Step 3) | `FifoAverageOpname` | Hitung HPP Average untuk kredit |
| PostProcessor | `1119ro` (Step 2) | `Opname` + `OpnameData` | Update data opname ke dashboard |
| PostProcessor | `1119` (Step 3) | `Opname` + `OpnameData` | Finalisasi data opname |

### 2.6 Rumus Kalkulasi (Value Gates)

```
Selisih Stok:
  qty_debet  = max(qty_opname - stok_buku, 0)   // stok riil > stok buku -> LEBIH
  qty_kredit = max(stok_buku - qty_opname, 0)   // stok buku > stok riil -> KURANG

Nilai Transaksi:
  debet  = hpp     x qty_debet     // nilai persediaan yang masuk
  kredit = hpp_avg x qty_kredit    // nilai persediaan yang keluar (FIFO Average)

PPV (Purchase Price Variance):
  hpp_nppv       = hpp x ppv_index__nilai
  debet_hpp_nppv = hpp_nppv x qty_debet
  ppv_riil        = hpp_nppv - hpp
  debet_ppv_riil  = ppv_riil x qty_debet
```

### 2.7 Peta Commonplace: Komponen Bersama Lintas-Dokumen

| Komponen | Lokasi | Peran bersama |
|----------|--------|---------------|
| `Modul_Controller.php` | `modules/opname/controllers/` | Base controller HMVC `extends MX_Controller`, load 4 config wajib; menyediakan `configUi`, `configCore`, `configLayout`, `configValues`, `jenisTr`, `cCode`, `mongoTableList`, `allSteps`, `ppnFactor` |
| `coTransaksiCore.php` | `modules/opname/config/` | Gateway mapping, components (Jurnal, Rekening, FIFO), pre/postProcessor; baris 10 = saklar `opname_use_rabbitmq`; baris 38 = `"kredit" => "hpp_avg*qty_kredit"` |
| `FollowUp.php` | `modules/opname/controllers/` | Approval chain opname (1.37 MB); titik publish RabbitMQ; titik sinkronisasi pool dan HPP AutoPurchase |
| `Opname.php` | `modules/opname/controllers/` | Alur utama: `index`, `view`, `doPrint`, `doUpload`, `executeOpname`, dashboard |
| `Excel.php` | `application/libraries/` | Wrapper PHPExcel; `writeToFileCustom()`; `writer()` dengan `ob_clean()` + `flush()` |
| `Rabbitmq_publisher.php` | `application/libraries/` | Publish pesan persistent ke exchange |
| `MdlDashboardOpname.php` | `application/models/Mdls/` | Sesi aktif opname (`status = 1`, `confirm_id = 0`) |
| `MdlDashboardOpnameData.php` | `application/models/Mdls/` | Log item detail pada `dashboard_opname_data` |
| `MdlProduk2.php` | `application/models/Mdls/` | `callSpecs()` baris 332 mengaktifkan `merek_nama`; juga registrasi `allow_autopurchase` |
| `MdlProjectHppHistory.php` | `application/models/Mdls/` | Audit trail perubahan HPP proyek |
| `MdlActivityLog.php` | `application/models/Mdls/` | Log keuangan (tabel `log`) saat void biaya `3674` |
| `locker_stock` / `locker_stock_mutasi` | Database | Kartu stok fisik; di-row-lock saat worker memproses chunk |
| `transaksi_payment_source` | Database | Sumber DP/uang muka dan audit A/R Receipt `749` |
| `he_tray_helper.php` | `application/helpers/` | Business logic tray: agregasi cache, evaluasi wewenang Todo vs Undone |
| `CronTray.php` | `application/controllers/` | Generator cache tray (baris 74-85 = query agregasi bermasalah) |
| `he_format_helper.php` | `application/helpers/` | `formatField()` dengan static caching untuk mencegah timeout FastCGI 60 detik |
| `he_access_right_helper.php` | `application/helpers/` | `alowedAccess()` untuk hak akses tray dan followup |

### 2.8 Struktur 23 Controller

| File | Ukuran | Peran |
|------|--------|-------|
| `Modul_Controller.php` | 4.6 KB | Base controller HMVC |
| `Opname.php` | 370 KB | Controller utama, `extends CI_Controller` (bukan `Modul_Controller`) |
| `Create.php` | 541 KB | Pembuatan transaksi opname (draft) |
| `FollowUp.php` | 1.37 MB | Follow-up / approval (terbesar) |
| `_shoppingCart.php` | 339 KB | Manajemen shopping cart item opname |
| `_processSelectProduct.php` | 95 KB | Proses seleksi produk |
| `Transaksi.php` | 282 KB | Daftar transaksi opname |
| `Printing.php` | 353 KB | Cetak dokumen opname |
| `ActivityReport.php` | 499 KB | Laporan aktivitas opname |
| `History.php` | 67 KB | Riwayat opname |
| `_followupLiveEdit.php` | 117 KB | Live edit saat followup |
| `_selectorItem.php` | 25 KB | Picker produk/item |
| `_selectorITEM.php` | 18 KB | Picker pihak (cabang) |
| `_selectorPihakMain.php` | 23 KB | Picker pihak utama |
| `_processPihak.php` | 36 KB | Proses pihak |
| `_processPihakMain.php` | 12 KB | Proses pihak utama |
| `Create_total.php` | 285 KB | Varian Create dengan total |
| `ViewDetails.php` | 28 KB | Detail view transaksi |
| `Pembelian.php` | 29 KB | Pembelian terkait opname |
| `Debug.php` | 935 B | Debugging |
| `__Create.php` | 543 KB | Backup Create |
| `__FollowUp.php` | 1.34 MB | Backup FollowUp |

Catatan arsitektural: `Opname.php` meng-`extends CI_Controller` langsung, berbeda dari controller lain yang semuanya `extends Modul_Controller`. Akibatnya `Opname.php` tidak otomatis memiliki `configLayout`, `configValues`, `mongoTableList`, `allSteps`, dan `ppnFactor`.

### 2.9 Lima Config Modul

| File | Ukuran | Isi |
|------|--------|-----|
| `coTransaksiCore.php` | 248 KB | Gateway mapping, components, pre/postProcessor |
| `coTransaksiUi.php` | 351 KB | Step definitions, UI labels, selector config, form fields |
| `coTransaksiLayout.php` | 124 KB | Kolom tabel, rendering layout |
| `coTransaksiValues.php` | 116 KB | Value mapping, aturan kalkulasi |
| `_coTransaksiCore.php` | 168 KB | Backup versi lama |

### 2.10 Fungsi Kunci di `Opname.php` dan Nomor Baris

| Fungsi | Baris | Deskripsi |
|--------|-------|-----------|
| `index()` | 182 | Halaman utama; cek transaksi gantung via `Transaksional::callTransaksiBeforeOpname` |
| `view()` | 315 | Tampilan detail per jenis; pilih kategori, gudang, download |
| `doPrint()` | 1150 | Download Excel; XLSX dengan stok buku, kolom stok riil, serial number, log `dashboard_opname` |
| `doUpload()` | 1923 | Upload Excel; simpan file + trigger `executeOpname` |
| `executeOpname()` | 2026 | Parse XLSX, hitung selisih, bangun session transaksi |
| `executeOpname__()` | 3878 | Versi lama (deprecated) |
| `executeOpnameSupplies()` | 5539 | Executor khusus supplies |
| `midValidate()` | 7080 | Validasi tengah (shopping cart fields) |
| `unionValidate()` | 7257 | Validasi union |
| `syncSatuan()` | 7327 | Sinkronisasi satuan |
| `cekOpnameAktive()` | 7491 | Cek sesi opname aktif |
| `viewOpnameAktive()` | 7525 | Dashboard monitoring, auto-refresh 60 detik |
| `viewOpnameData()` | 7655 | View detail data opname |
| `doConfirmOpname()` | 7749 | Konfirmasi seluruh opname selesai |
| `historyDownloadOpname()` | 7793 | Riwayat download, limit 10 |
| `reDownloadXls()` | 7813 | Re-download file Excel dari history |

### 2.11 Tabel Database yang Terlibat

| Tabel | Fungsi |
|-------|--------|
| `dashboard_opname` | Header sesi opname (siapa download, upload, acc, status) |
| `dashboard_opname_data` | Detail per produk per sesi (stok buku, stok opname, selisih) |
| `opname_xls` | Log file Excel (`file_name`, `full_path`, `oleh_id`, `jenis_tr`, `jenis_produk`) |
| `transaksi` | Tabel transaksi utama (semua jenis) |
| `transaksi_data` | Detail item transaksi |
| `_rek_pembantu_produk_cache` | Cache stok produk per gudang per cabang |
| `_rek_pembantu_supplies_cache` | Cache stok supplies |
| `_rek_pembantu_produk_perserial_cache` | Cache serial number produk |
| `harga_produk` | Master harga (HPP) |

Query validasi stok buku (TC-2.2):

```sql
SELECT extern_id, qty_debet FROM _rek_pembantu_produk_cache
WHERE periode = 'forever' AND rekening = '1010030030'
  AND gudang_id = X AND cabang_id = Y
```

Query validasi hasil upload (TC-4.4):

```sql
SELECT produk_id, jml_stok_buku, jml_stok_opname
FROM dashboard_opname_data WHERE dashboard_opname_id = X
```

MongoDB collections via `$this->mongoTableList`: `transaksi`, `transaksi_values`, `transaksi_data`, `transaksi_data_values`, `transaksi_sign`, `transaksi_extstep`, `transaksi_registry`.

### 2.12 Migrasi Pengelompokan: Kategori ke Merek Produk (Condition B)

- **Model baru Merek (`MdlMerek`)**: field query `merek_nama` diaktifkan kembali di `MdlProduk2::callSpecs()` baris 332; target folder instansiasi `$fo` diganti dari `MdlFolderProduk` ke `MdlMerek`.
- **Query monitoring sesi**: query `$gudangCategoriesMap` (deteksi status "Sedang Dihitung") dan `$sum_produkCb` (counter jumlah item) kini melacak `p.merek_id`, di-alias menjadi `folders` untuk kompatibilitas data.
- **Filter SQL download**: filter di `doPrint()` memakai `merek_id in ...`.
- **Perekaman histori sesi**: `merek_nama` disimpan ke kolom `kategori_nama` pada `dashboard_opname_data` agar pemisahan file ZIP re-download terbagi per merek.
- **Label modal dinamis**: judul menjadi "Pilih Merek Produk" untuk parameter produk.
- Badge jumlah item diposisikan absolute overlay di kanan label checkbox; badge "Sedang Dihitung" memakai padding-right 140px saat aktif dan 45px saat normal; label panjang dipotong satu baris dengan CSS ellipsis dan atribut `title` untuk tooltip.

Catatan migrasi: sesi opname aktif lama yang tercatat dengan ID Kategori harus diselesaikan/dihapus, karena sistem baru mendeteksi sesi aktif berdasarkan ID Merek.

### 2.13 Fitur e-Form PDF Interaktif

| Aspek | Detail |
|-------|--------|
| Output | PDF interaktif dengan form field input quantity fisik + script validasi JS (Acrobat JS) |
| Validasi 1 | Hanya menerima angka bulat positif |
| Validasi 2 | Konfirmasi pop-up jika selisih stok buku vs stok fisik lebih besar dari 50 unit |
| Parser | `doUploadPdf()` menerima PDF terisi user, memparsing via CLI tool `pdftk`, menyusun file Excel sementara, mencatat ke database, meneruskan ke engine opname default |
| Redownload | `eDownloadXls()` dan `eDownloadEformPdf()` mendukung pemecahan per Merek ke satu `.zip` |
| Direktori ZIP | `sys_get_temp_dir()` untuk menghindari permission error pada server CentOS |

### 2.14 History, Redownload, dan Proteksi Ganda

- Tabel riwayat dibatasi **10 baris terakhir**; sisanya disembunyikan dengan tombol "Muat Semuanya" (transisi halus).
- Tautan unduh ulang Excel dan PDF mengikuti opsi format Single vs ZIP secara real-time via JS.
- Proteksi download ganda: radio button gudang yang sudah punya sesi aktif menjadi `disabled` dengan pesan "data opname sudah didownload oleh [nama] jam [waktu]". Jika semua gudang ter-download, tombol download utama `disabled` dengan pesan "Sesi opname sedang berlangsung, sudah tidak bisa download. Silahkan lihat History download jika akan download ulang".
- Query proteksi: `jml_upload == 1` pada baris 2194.

### 2.15 Lima Optimasi yang Telah Diterapkan

| No | Masalah | Solusi | Dampak |
|----|---------|--------|--------|
| A | HTTP 503 saat modal approval dengan 2.200+ item (Timeout FastCGI 60 detik) | Eager loading `FieldCalculator` keluar dari loop di `FollowUp::followupPreview()`; `static` pada `formatField()`, `formatField_he_format()`, `formatField_he_format_json()` | Config `heTransaksi_ui` + `MataUang` dimuat 1 kali, bukan 22.000+ kali |
| B | Progress baris "PUSAT (DC)" menampilkan `69 / 80` padahal target 69 kategori | Ubah `$totalCats` di `viewOpnameAktive()` agar join ke `dashboard_opname_data` | Penyebut dinamis mengikuti jumlah kategori target sesi berjalan |
| C | Upload Excel ribuan data memakan waktu hingga menit | Bungkus loop update query dalam satu `trans_start()` / `trans_complete()` pada `Opname::executeOpname()` | Peningkatan 90%+, dari menit menjadi 1-2 detik |
| D | Excel rusak saat diunduh (open_basedir dan write permission CentOS `/tmp`) | Target folder temp PHPExcel dipindah dari `sys_get_temp_dir()` ke `FCPATH . 'uploads/'`; tambah `ob_clean()` + `flush()` sebelum header di `writer()` | Berkas XLSX tidak korup |
| E | Layout modal | Cabang dan Gudang dipindah ke atas modal; Mrek di bawahnya dengan `display: none`; jQuery `.slideDown(300)` di callback `onGudangSelect()` | Merek terbuka otomatis saat gudang dipilih |

### 2.16 Aturan Coding Wajib untuk Pengembang Subsequent

1. **Kompatibilitas PHP 5.6**: dilarang memakai Null Coalescing Operator (`??`), Short Array Syntax (`[]`), Arrow Functions (`fn()`), spread operator (`...`). Gunakan `isset($x) ? $x : $default` dan struktur `array()`.
2. **Zero placeholders**: dilarang menyembunyikan kode ada dengan `// ...` atau `/* existing code */`. Fungsi yang diubah wajib ditulis utuh dari `{` sampai `}`.
3. **Keamanan upload**: verifikasi MIME-Type biner asli dan acak nama berkas (ISO 27001).
4. **Transaction wrapper**: gunakan `$this->db->trans_start()` / `trans_complete()`. Jangan memakai raw `BEGIN`/`COMMIT`/`ROLLBACK`.

---

## 3. Arsitektur RabbitMQ untuk Opname (Exchange, Queue, Consumer, Payload)

### 3.1 Model.incarnate: Synchronous Fat Controller ke Asynchronous Message Queue

Migrasi memindahkan empat beban pada step Approve 2 keluar dari HTTP request ke worker CLI: (1) menghitung mutasi saldo stok dan HPP untuk ribuan produk, (2) membuka transaksi database yang berlangsung hingga ratusan detik, (3) menulis `jurnal`, `rekening`, `rekening_pembantu_produk`, (4) memvalidasi neraca.

### 3.2 Tiga Zona Terisolasi

| Zona | Isi | Target |
|------|-----|--------|
| Zona 1 - HTTP Browser | `FollowUp.php` -> `doFollowup()`, simpan `transaksi` dan `transaksi_data`, tulis `so_headers_staging` dan `so_items_staging`, publish via `Rabbitmq_publisher.php` | Kurang dari 1 detik, respon 200 OK |
| Zona 2 - RabbitMQ Broker (192.168.5.14:5672) | Exchange direct durable, main queue durable, DLX, DLQ | Buffer pesan persistent |
| Zona 3 - Worker Engine Daemon (`rabbit_server`) | `OpnameWorker.php` CLI daemon, idempotency check, chunking 200 item, row-locking, commit, ACK/NACK | Pemrosesan aman di latar belakang |

### 3.3 Topologi RabbitMQ - Set A (`ARSITEKTUR_RABBITMQ_OPNAME.md`)

| Parameter | Nilai |
|-----------|-------|
| Host / Port | `192.168.5.14` / `5672` |
| Virtual Host | `/inventory` (terisolasi dari lalu lintas CRM/Sales) |
| Exchange | `inventory.opname.x` (tipe `direct`, durable) |
| Routing Key | `opname.submitted` |
| Main Queue | `inventory.opname.process.q` (durable: true) |
| Dead Letter Exchange (DLX) | `inventory.opname.dlx` (tipe `direct`, durable) |
| Dead Letter Routing Key | `opname.failed` |
| Dead Letter Queue (DLQ) | `inventory.opname.failed.q` (durable: true) |
| Quality of Service | `prefetch_count = 1` |

### 3.4 Topologi RabbitMQ - Set B (`WORKFLOW_RABBITMQ.md`)

| Parameter | Nilai |
|-----------|-------|
| Exchange | `everest.jobs.x` |
| Routing Key | `job.process` |
| Main Queue | `everest.jobs.q` (prefetch count = 1) |
| DLX | `everest.jobs.dlx` |
| DLQ | `everest.jobs.failed.dlq` |
| Shadow Table | `rabbit_publish_shadow` (kolom `publish_status`, `worker_status`, `worker_at`) |
| Consumer | `Worker start everest` |
| CLI Core | `opname/Cli/process_journal` |

Kedua set nama ini tidak identik dan tidak dijelaskan sebagai dua environment berbeda. Lihat Temuan K-01.

### 3.5 Consumer dan Mekanisme Kerja

Set A: `OpnameWorker.php` (CLI daemon, di `W:\rabbit_server`):

```bash
cd W:\rabbit_server
php index.php OpnameWorker start
```

Daemon berjalan di background, mengambil pesan satu per satu (prefetch = 1), mencatat log ke console serta file log sistem.

Set B: worker memanggil CLI berikut sebelum eksekusi:

```bash
/opt/remi/php56/.../php index.php opname/Cli/process_journal 940795
```

CLI membaca nilai selisih fisik vs sistem dari `transaksi_values`, membersihkan baris sampah lama untuk `nomer_nota` yang sama, lalu `trans_start()` -> tulis GL Summary ke `jurnal` (WIB) -> `trans_complete()`. Worker membaca JSON `{"status":"success","code":200,"message":"..."}`.

### 3.6 Payload Pesan

Set A: `transaksi_id`, `booking_number`.
Set B: `transaksi_id`, `shadow_id` (nilai balik dari insert `rabbit_publish_shadow`), `nota` (nomor nota).
Properti AMQP: persistent message, publish ke exchange dengan explicit routing key.

### 3.7 Skema Database Staging pada Database `run_everest_modul`

Tiga tabel berikut berfungsi sebagai **Transactional Buffer** antara browser dan worker.

**`so_headers_staging`** (ringkasan dokumen): `id` (PK auto increment), `transaksi_id` (ID induk, indexed unique), `booking_number` (kode sesi), `nomer_nota` (nomor nota resmi), `cabang_id` dan `gudang_id` (lokasi gudang fisik), `jenis_transaksi` (default `'1119'`), `status` (`PENDING` -> `PROCESSING` -> `COMPLETED`/`FAILED`), `retry_count`, `total_items`, `payload_checksum` (MD5), `created_at`, `updated_at`.

**`so_items_staging`** (rincian per barang): `id` (PK), `header_staging_id`, `transaksi_id`, `produk_id`, `produk_nama`, `qty_sistem` (stok sistem), `qty_fisik` (hasil hitung fisik), `qty_debet` (selisih lebih), `qty_kredit` (selisih kurang), `hpp_satuan`, `nilai_total`, `serial_numbers_json`, `status` (`PENDING`/`PROCESSED`/`FAILED`).

**`so_audit_logs`** (audit ISO 27001): `id` (PK), `header_staging_id`, `transaksi_id`, `event_type` (`SUBMITTED`, `WORKER_START`, `CHUNK_DONE`, `COMPLETED`, `DLQ_FAILED`), `actor_type` (`USER` atau `SYSTEM_WORKER`), `actor_id`, `details`, `created_at`.

### 3.8 Alur Eksekusi Worker per Chunk

1. Idempotency check: apakah status sudah `COMPLETED`.
2. Update `so_headers_staging` -> `PROCESSING`.
3. Loop per batch 200 item (mencegah OOM dan lock hang): `trans_start()` -> row-locking inventory -> posting akuntansi dan kartu stok -> `trans_complete()` -> catat log audit chunk done.
4. Posting per item: (a) jurnal dan rekening GL, (b) `rekening_pembantu_produk`, (c) update `locker_stock` mutasi, (d) generate serial number baru.
5. Finalisasi: `transaksi status_next = complete`, `so_headers_staging status = COMPLETED`, catat ke `so_audit_logs`.
6. `basic_ack` (pesan dihapus dari queue). Jika gagal transaksi DB: `basic_nack` sehingga pesan masuk DLQ.

### 3.9 Row-Level Locking

```sql
SELECT id, jumlah FROM locker_stock
WHERE cabang_id = ? AND gudang_id = ? AND produk_id = ? AND state = 'active'
FOR UPDATE;
```

Tujuan: mencegah tabrakan saldo jika kasir POS menjual barang yang sedang disesuaikan.

### 3.10 Aturan Jurnal Worker (menurut `ARSITEKTUR_RABBITMQ_OPNAME.md`)

**Selisih Lebih (+)**: Debet `1010030030` (Persediaan Produk), Kredit `7010150` (Laba Selisih Persediaan); kartu stok bertambah pada `locker_stock` dan `locker_stock_mutasi`; record debet di `rekening_pembantu_produk`.

**Selisih Kurang (-)**: Debet `7020020` (Beban/Kerugian Selisih Persediaan), Kredit `1010030030`; kartu stok berkurang pada `locker_stock` dan `locker_stock_mutasi`; record kredit di `rekening_pembantu_produk`.

Aturan ini **berbeda arah** dari `analisa_modul_opname.md` dan checklist UAT 9.4. Lihat Temuan K-02 (paling kritis).

### 3.11 Perbandingan Sebelum dan Sesudah

| Parameter | Sebelum (Synchronous HTTP) | Sesudah (RabbitMQ Asynchronous) |
|-----------|----------------------------|----------------------------------|
| Waktu tunggu browser | 30 s/d 180 detik (sering freeze/timeout) | Kurang dari 1 detik |
| Beban memori HTTP | Rawan Out-Of-Memory (lebih dari 128 MB per request) | Sangat ringan (hanya simpan staging) |
| Risiko deadlock (1213) | Tinggi sekali (lock tabel puluhan detik) | Nol / rendah (chunking 200 item) |
| Ketahanan data mati lampu | Rawan rusak jika browser ditutup paksa | Aman 100% (queue durable + manual ACK) |
| Skalabilitas | Tidak bisa menangani opname multi-cabang serentak | Sangat siap (antrean terjadwal rapi) |

### 3.12 Status Aktualisasi

`analisa_modul_opname.md` mencatat saklar di `coTransaksiCore.php` baris 10:

```php
$config['opname_use_rabbitmq'] = false; // MATI - proses sinkron
```

Blueprint RabbitMQ masih pada tahap desain; jalur produksi masih sinkron. Lihat Temuan K-03.

---

## 4. Tray dan Notifikasi (Analisis, Solusi, Enhanced Audit)

### 4.1 Problem Statement

Terdapat ketidaksinkronan angka antara counter badge notifikasi pada menu samping/sidebar kiri dengan total penjumlahan badge pada tab action step di halaman utama.

Kasus konkret pada modul Taxes, transaksi jenis `110` (E-Faktur PPN Keluaran):

| Lokasi | Tab / Badge | Angka |
|--------|-------------|-------|
| Halaman utama `taxes/Transaksi/index/110` | Tab 1 PREPARE E-FAKTUR | 289 |
| Halaman utama | Tab 2 PREPARE GUNGGUNGAN | 296 |
| Halaman utama | Tab 3 ENTRY E-FAKTUR | 27 |
| Halaman utama | **Total dokumen transaksi riil** | **612** |
| Menu samping kiri | Badge "E-Faktur Ppn Keluaran" | **2.958** |

### 4.2 Arsitektur Komponen Tray Pasca Refactor

```
[Cron / Background Worker]
        |
        v
   CronTray.php ---> Tabel cache agregasi:
                       - sys_cache_tray_transaksi
                       - sys_cache_tray_duedate
                       - sys_cache_tray_payment
        |
        v
[Client Polling Request: _tray]
        |
        v
   _tray.php (Controller Orkestrator)
        |
        v
   he_tray_helper.php (Business Logic) ---> Ambil agregasi dari cache
                                           Evaluasi wewenang (Todo vs Undone)
        |
        v
   js_tray.php (View Component) ---> Update DOM / Badge di browser client
```

### 4.3 Akar Masalah Teknis

**A. Relasi header vs detail**: `transaksi` (`t`) adalah header dokumen; `transaksi_data` (`d`) adalah detail baris per transaksi (relasi 1 to Many).

**B. Kesalahan agregasi di `CronTray.php` baris 74-85**:

```sql
INSERT INTO sys_cache_tray_transaksi
  (cabang_id, cabang2_id, jenis_master, next_step_num, next_step_code,
   next_substep_num, jenis_label, oleh_id, qty)
SELECT
    t.cabang_id, t.cabang2_id, t.jenis_master, t.next_step_num, t.next_step_code,
    d.next_substep_num, t.jenis_label, t.oleh_id, COUNT(1) as qty
FROM transaksi t
JOIN transaksi_data d ON d.transaksi_id = t.id
WHERE t.status = '1' AND t.trash = '0' AND t.link_id = '0'
  AND d.trash = '0' AND d.sub_step_number > 0 AND d.valid_qty > 0
GROUP BY t.cabang_id, t.cabang2_id, t.jenis_master, t.next_step_num,
         t.next_step_code, d.next_substep_num, t.jenis_label, t.oleh_id
```

Pemicu: `COUNT(1) as qty` saat JOIN ke `transaksi_data`. Karena satu dokumen memiliki rata-rata 4,8 baris item, `COUNT(1)` menghitung total baris item detail (2.958), bukan jumlah dokumen.

**C. Efek berantai di `he_tray_helper.php` baris 102-145**:

```php
$qty = isset($row->qty) ? (int)$row->qty : 1;
...
for ($it = 0; $it < $qty; $it++) {
    $todoTrans[] = 1;
    $subTodoTrans[$jenisTr][] = 1;
    $subTodoTransName[$jenisTr][] = $row->jenis_label;
}
```

Helper mengulang penambahan elemen array 2.958 kali, sehingga badge menampilkan total baris item, bukan jumlah dokumen.

### 4.4 Perbandingan Logika Versi Lama vs Refactor

| Fitur / Logika | `_tray_old.php` (Sebelum) | `_tray.php` + `he_tray_helper.php` (Sesudah) | Status |
|----------------|---------------------------|---------------------------------------------|--------|
| Evaluasi wewenang | `alowedAccess()` dan fallback ke `membership` user | `alowedAccess()` dan fallback ke `membership` user | AS-IS (identik) |
| Pemisahan Todo dan Undone | `subTodoTrans` jika berhak followup; `subUndoneTrans` jika pending | Sama | AS-IS (identik) |
| Relasi pasangan (`pairChild`) | Menambah `subUndoneTransEx` ke transaksi terkait | Sama | AS-IS (identik) |
| Integrasi piutang dan jatuh tempo | Gabung `extraSrc` dari sumber pembayaran | Gabung `extraSrc` dari tabel cache payment | AS-IS (identik) |
| Unit perhitungan transaksi | `GROUP BY transaksi_id` -> jumlah dokumen | `COUNT(1)` -> jumlah baris item | **Perlu fix agregasi** |

### 4.5 Solusi

```diff
-   d.next_substep_num, t.jenis_label, t.oleh_id, COUNT(1) as qty
+   d.next_substep_num, t.jenis_label, t.oleh_id, COUNT(DISTINCT t.id) as qty
```

Regenerasi cache:

```bash
php index.php CronTray generate_cache
```

atau via URL: `http://<domain>/CronTray/generate_cache?secure_key=cron_tray_cache_123`

Hasil setelah perbaikan: (1) `$row->qty` pada `sys_cache_tray_transaksi` menyimpan jumlah dokumen unik; (2) badge jenis `110` berubah dari **2.958** menjadi **612**; (3) total badge menu kiri konsisten 100% dengan penjumlahan tab step action (289 + 296 + 27 = 612).

### 4.6 Enhanced Audit: `_tray_enchanced.php` (Skor Akhir 3.5/10)

| Aspek | Skor | Vonis dan Bukti |
|-------|------|-----------------|
| Arsitektur dan MVC | 4/10 | Controller tercemar tugas View: HTML disusun di baris 130 dan 219 (`_calculateTransaksi`) lewat string `<span class='...'></span>`, class CSS `bg-danger` di baris 296. `_calculateTransaksi()` adalah God Method lebih dari 250 baris yang memvalidasi access right, menghitung due date, mencari notifikasi, mengecek request code sekaligus |
| Kualitas kode | 3/10 | Typo bawaan (`enchanced` vs `enhanced`); `foreach` di dalam `foreach` dengan `if-else` bersarang hingga 5 level; magic numbers baris 228 `$excluded = array("464")` (ToGo tidak diperbaiki) dan baris 282 `$tr->addFilter("sisa>1000")`; variabel tidak representatif (`$lls`, `$o`, `$tr`, `$tmpTr`, `$tmpTmp`); inkonsistensi state global: session CI dipakai bersama raw `$_SESSION['undoneQty']` |
| Performa database | 2/10 | Dosa besar N+1 query: `_calculateDataProposals()` mengeksekusi `lookupAll()` di dalam loop; `_recordActiveIP()` menjalankan SELECT lalu UPDATE/INSERT di dalam loop grup |
| Keamanan | 5/10 | Spoofing `HTTP_HOST`: fitur dimatikan jika mendeteksi string "demo" dari `$_SERVER['HTTP_HOST']`; seharusnya environment variables. Kesalahan IP: memakai `$_SERVER['REMOTE_ADDR']`, di belakang Load Balancer hanya mencatat IP proxy; seharusnya `$this->input->ip_address()` |

### 4.7 Analisis Fungsi Turunan

| Fungsi | File | Skor | Temuan |
|--------|------|------|--------|
| `loadConfigUiModul()` | `he_misc_helper.php` | 2/10 (Performa dan Kode Mati) | Memanggil `$CI->load->config(...)` di dalam perulangan ratusan kali (Disk I/O berulang). Ada `matiHere();` dan deklarasi variabel di luar logika return |
| `alowedAccess()` | `he_access_right_helper.php` | 4/10 (Hardcoding Aturan Bisnis) | Logika `step > 1` untuk hak hapus/reject; berbahaya jika modul berbeda alur. Dipanggil di dalam god-method berat dengan query dinamis per pengecekan (hidden N+1) |
| `replaceSession()` | `he_session_replacer_helper.php` | 6/10 (Dapat Dimaafkan, Menyesatkan) | Tidak mengganti session sama sekali, hanya mengembalikan array filter. Sebaiknya `getBranchFilterByRole()` |

### 4.8 Tuntutan Perbaikan Struktural

1. Pecah `_calculateTransaksi()` ke helper atau service layer agar controller ramping.
2. Hapus HTML dari controller; pindahkan ke View/JavaScript.
3. Hancurkan N+1 query dengan batch processing.
4. Hentikan I/O file dalam loop pada `loadConfigUiModul()`; gunakan compiled cache.
5. Cabut hardcode hak akses; definisikan ruleset `allowReject` dan `allowDelete` di `coTransaksiUi` tiap modul.

---

## 5. AutoPurchase (FG dan Project): Alur, Inline Variant, Implementasi, Walkthrough

### 5.1 Prinsip Desain

| Parameter | Keputusan | Rationale |
|-----------|-----------|-----------|
| Tahap pemicu | Kickoff Project (Step 3: Started Project) di `master_project` `FollowUp.php` | Komposisi RAB sudah 100% terkunci (zero risk of wrong specification) |
| Lingkup barang | Hanya Finished Goods (FG), `jenis = 'produk'` | Supplies dan biaya via alur non-autopurchase |
| Metode seleksi | Opsi 3 (Hybrid Inheritance) | Default `allow_autopurchase` dari Master Produk, diwariskan ke RAB, dapat di-toggle di UI RAB |
| Sumber data | Tabel `project_komposisi` (agregat total) | Total kuantitas bersih per barang tanpa duplikasi baris akibat pemecahan fase/work order |
| Modul target | `pembelianfgproject`, Trjenis `1466` (Pre-PO `1466r`) | Hasil trigger berupa wadah Purchase Requisition (PR) / Pool Kebutuhan Belanja Project |
| Parameter project | `master_project` Trjenis `588`, Kickoff `588st` | Disimpan pada `project_start_id` dan `project_start_nomer` |

Separation of Concerns: Tim Estimator/PM di `master_project` hanya menentukan komposisi barang dan jumlah kebutuhan teknis tanpa menentukan supplier. Tim Purchasing di `pembelianfgproject` berwenang penuh memilih supplier, bernegosiasi harga beli aktual, dan memecah pembelian ke beberapa vendor. Tim Purchasing tidak perlu mengetik ulang nama barang, kode, satuan, dan jumlah kebutuhan proyek.

### 5.2 Alur End-to-End

```
Kickoff Project (master_project / 588)
   -> Insert Batch (status 'OPEN') ke project_purchase_pool
   -> User buat Pre-PO (1466r)
   -> Buka panel Inline "DAFTAR KEBUTUHAN PROJECT (Autopurchase Pool)"
   -> [+] pada baris produk (auto-assign & konfirmasi supplier)
   -> Item masuk Shopping Cart (bind project_purchase_pool_id)
   -> Simpan Draft Pre-PO (1466r) -> Approval PO (1466)
   -> Update qty_po, qty_sisa, status di pool
   -> Sync HPP balik + audit trail ke project_hpp_history
   -> Penerimaan Barang / GRN (1467) -> Stok masuk ke Gudang Project
```

### 5.3 Kolom `allow_autopurchase`

```sql
ALTER TABLE `produk`
  ADD COLUMN `allow_autopurchase` TINYINT(1) NOT NULL DEFAULT 0
  COMMENT '0 = Manual Purchase, 1 = Auto Purchase Project';

ALTER TABLE `project_komposisi`
  ADD COLUMN `allow_autopurchase` TINYINT(1) NOT NULL DEFAULT 0
  COMMENT 'Flag inheritance dari master produk';

ALTER TABLE `project_komposisi_workoder`
  ADD COLUMN `allow_autopurchase` TINYINT(1) NOT NULL DEFAULT 0;

ALTER TABLE `project_komposisi_workoder_sub`
  ADD COLUMN `allow_autopurchase` TINYINT(1) NOT NULL DEFAULT 0;
```

Perbedaan penamaan tabel anak antara dua dokumen: `project_komposisi_workoder_sub` vs `project_komposisi_sub_workoder`. Lihat Temuan K-08.

### 5.4 DDL Tabel Wadah `project_purchase_pool`

```sql
CREATE TABLE IF NOT EXISTS `project_purchase_pool` (
  `id` INT(11) UNSIGNED NOT NULL AUTO_INCREMENT,
  `project_id` INT(11) NOT NULL COMMENT 'Relasi ke project_produk.id',
  `project_nama` VARCHAR(255) NOT NULL,
  `project_start_id` INT(11) DEFAULT 0 COMMENT 'ID transaksi Kickoff 588st',
  `project_start_nomer` VARCHAR(100) DEFAULT NULL,
  `cabang_id` INT(11) NOT NULL,
  `produk_id` INT(11) NOT NULL COMMENT 'ID barang FG (produk_dasar_id)',
  `produk_kode` VARCHAR(100) DEFAULT NULL,
  `produk_nama` VARCHAR(255) NOT NULL,
  `satuan_nama` VARCHAR(50) DEFAULT NULL,
  `qty_kebutuhan` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT 'Qty total dari project_komposisi',
  `qty_po` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT 'Qty yang sudah dibuatkan PO',
  `qty_sisa` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT 'qty_kebutuhan - qty_po',
  `est_harga_beli` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT 'Estimasi HPP/Nilai dari RAB',
  `status` ENUM('OPEN','PARTIAL','CLOSED','CANCELLED') NOT NULL DEFAULT 'OPEN',
  `created_dtime` DATETIME NOT NULL,
  `created_by_id` INT(11) NOT NULL,
  `created_by_nama` VARCHAR(100) NOT NULL,
  `last_updated_dtime` DATETIME DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_project_id` (`project_id`),
  KEY `idx_produk_id` (`produk_id`),
  KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
```

Status per item: `OPEN` (belum dipesan), `PARTIAL` (dipesan sebagian), `CLOSED` (tuntas), `CANCELLED` (dibatalkan dari UI).

### 5.5 Trigger Kickoff (`FollowUp.php`, `case 3:`)

Idempotency lock: `$existingPoolCount` dihitung dengan `project_id = $idTargetProject` dan `status <> 'CANCELLED'`. Jika 0, query:

```sql
SELECT pk.*, pr.kode as produk_kode, pr.nama as produk_nama, pr.satuan as satuan_nama
FROM project_komposisi pk
JOIN produk pr ON pk.produk_dasar_id = pr.id
WHERE pk.produk_id = '$idTargetProject'
  AND pk.jenis = 'produk'      -- Hanya FG
  AND pk.allow_autopurchase = 1 -- Hanya yang diizinkan
  AND pk.status = '1'
  AND pk.trash = '0'
```

Untuk setiap item dengan `qty_kebutuhan > 0`, di-`insert_batch` dengan `qty_po = 0.00`, `qty_sisa = qty_kebutuhan`, `est_harga_beli = (float)$rowItem->nilai`, `status = "OPEN"`, serta metadata creator (`created_by_id`, `created_by_nama`, `created_dtime`, `last_updated_dtime`).

### 5.6 Inline UI Variant versus Modal

| Aspek | Blueprint V1 (modal) | Blueprint V2 (Direct Inline UI) |
|-------|----------------------|----------------------------------|
| Lokasi picker | Pop-up modal `_selectorProjectPool.php` | Inline di `Create/index/1466` pada `col-md-12` di `transaksi.html` via tag `{project_pool_inline}` |
| Posisi | Di luar area form | Di bawah tombol hijau "Continue PRE PURCHASE ORDER (project)" dan di atas area merah "TRANSAKSI YANG PERLU ACTION" |
| View | - | `views/transaksi.php` dan `views/transaksi_modul.php` memuat skrip `loadProjectPoolInline()` dan `addPoolItemToCart()` |
| Query | - | API `getProjectPoolItemsAjax()` di `_shoppingCart.php` |

### 5.7 Sebelas Kolom Tabel Inline

1. **ID Pool** (`id`) - primary key unik record pool.
2. **Proyek dan No. Kontrak** - nama proyek dan nomor kontrak.
3. **Kode dan Nama Produk + Tag Supplier** - identitas barang FG plus supplier rekomendasi RAB.
4. **Qty RAB** - jumlah kebutuhan total hasil Kickoff.
5. **Qty PO** - jumlah yang sudah dibuatkan PO.
6. **Qty Sisa** - `qty_kebutuhan - qty_po`.
7. **Stok Project DC** - stok fisik aktif dari `stock_locker` pada gudang internal berkategori "gudang project" (`supplier_id = 0` atau `NULL`).
8. **Stok Project Supplier** - stok fisik aktif dari `stock_locker` pada gudang transit terikat `supplier_id` terkait dan berkategori "project".
9. **Status** - badge `OPEN` / `PARTIAL`.
10. **Action Direct** - input `Qty Order`, tombol hijau `[+]` (tambah ke cart), tombol merah hapus (set pool `status = 'CANCELLED'`).
11. **Clear Filter** - tombol silang reset dropdown Filter Proyek ke "Semua Proyek Aktif" dan mengosongkan kotak pencarian.

Smart Quantity Formatting: Qty RAB, Qty PO, Qty Sisa, dan isi input field diformat bulat bersih tanpa akhiran `.00` (contoh `23 Unit`, bukan `23.00`). Pecahan desimal non-nol seperti `2.5` tetap dipertahankan.

### 5.8 Dual-Match Supplier Querying

```sql
SELECT project_purchase_pool.*
FROM project_purchase_pool
LEFT JOIN produk_per_supplier
  ON (produk_per_supplier.produk_id = project_purchase_pool.produk_id)
WHERE project_purchase_pool.status IN ('OPEN', 'PARTIAL')
  AND project_purchase_pool.qty_sisa > 0
  AND (
      '$supplierId' <= 0
      OR project_purchase_pool.supplier_id = '$supplierId'
      OR produk_per_supplier.suppliers_id = '$supplierId'
  )
GROUP BY project_purchase_pool.id
ORDER BY project_purchase_pool.id ASC
```

Saat Supplier Header belum dipilih (`supplier_id = 0`), seluruh produk kebutuhan proyek terbuka ditampilkan. Begitu supplier dipilih, tabel tersaring presisi hanya barang berelasi.

### 5.9 Auto-Assign Header Supplier dan Konfirmasi Wajib

- Jika `supplier_id` header masih 0 saat tombol `[+]` diklik: sistem membaca `supplier_id` dan `supplier_nama` dari `project_purchase_pool`, memasang `$_SESSION[$cCode]['main']['pihakID']` dan `pihakName`, serta memasukkan item ke keranjang.
- Jika header aktif berisi vendor berbeda: sistem wajib memunculkan dialog "Header transaksi saat ini ditujukan untuk Supplier lain. Apakah Anda ingin mengganti Supplier Header menjadi [PT PANASONIC GOBEL INDONESIA] untuk membuat PO ini?". Jika OK, request dikirim dengan `force_supplier_id=1`; jika Batal, aksi dibatalkan tanpa mengubah data.
- Aturan bisnis dasar: **1 PO = 1 Supplier**.

### 5.10 Hook Sinkronisasi Real-Time

1. Controller `_processPihak.php`: method `select()` dan `remove()` memicu `if (top.loadProjectPoolInline) { top.loadProjectPoolInline(); }`.
2. View `shoppingCart.php`: hook `top.loadProjectPoolInline()` saat shopping cart dimuat ulang (`viewCart`).
3. Perilaku: pilih Supplier A -> tabel ter-filter; hapus Supplier (tombol X) -> tabel kembali menampilkan seluruh produk kebutuhan proyek.

### 5.11 Metadata di Shopping Cart (`_TR_1466r`)

```php
$cartItem = array(
    "produk_id"                => $row->produk_id,
    "nama"                     => $row->produk_nama,
    "satuan"                   => $row->satuan_nama,
    "qty"                      => $qtyOrder,
    "harga"                    => $hargaBeliSupplier,
    "project_purchase_pool_id" => $row->id,          // Link ke pool
    "project_id"               => $row->project_id,  // Link ke project
    "project_nama"             => $row->project_nama,
);
```

### 5.12 Alokasi Parsial (Split Order ke Beberapa Vendor)

Barang butuh 10 Pcs: PO ke Supplier A beli 6 Pcs -> `qty_po = 6`, `qty_sisa = 4`, `status = 'PARTIAL'`. PO ke Supplier B beli 4 Pcs -> `qty_po = 10`, `qty_sisa = 0`, `status = 'CLOSED'`.

### 5.13 Sinkronisasi Backend Saat PO Disetujui

Terdapat di `FollowUp.php` modul `pembelianfgproject` (`case 1` / `case 2` pada blueprint V1):

```php
foreach ($itemsPO as $item) {
    if (isset($item['project_purchase_pool_id']) && $item['project_purchase_pool_id'] > 0) {
        $poolID = $item['project_purchase_pool_id'];
        $qtyOrdered = (float)$item['qty'];

        $pool = $this->db->get_where("project_purchase_pool", array("id" => $poolID))->row();
        if (!empty($pool)) {
            $newQtyPo = (float)$pool->qty_po + $qtyOrdered;
            $newQtySisa = (float)$pool->qty_kebutuhan - $newQtyPo;
            $newStatus = ($newQtySisa <= 0) ? 'CLOSED' : 'PARTIAL';

            $this->db->where("id", $poolID);
            $this->db->update("project_purchase_pool", array(
                "qty_po"             => $newQtyPo,
                "qty_sisa"           => ($newQtySisa > 0 ? $newQtySisa : 0),
                "status"             => $newStatus,
                "last_updated_dtime" => date("Y-m-d H:i:s")
            ));
        }
    }
}
```

### 5.14 Sinkronisasi HPP Balik dan Audit Trail

1. `harga_beli_supplier` yang disepakati menjadi HPP Aktual.
2. Diperbarui pada `project_komposisi_workoder` (level workorder/ruangan/fase) dan `project_komposisi` (rekap proyek): `hpp = $hargaBeliSupplier`, `subtotal_hpp = jml * $hargaBeliSupplier`.
3. `project_produk.harga_hpp_so` direkalkulasi dinamis.
4. Insert `project_hpp_history` via `MdlProjectHppHistory`:

```php
$this->load->model('Mdls/MdlProjectHppHistory');
$hppHistory = new MdlProjectHppHistory();

$hppHistory->recordHistory(array(
    'project_id'          => $projectId,
    'project_nama'        => $projectNama,
    'workorder_id'        => $workorderId,
    'komposisi_id'        => $komposisiId,
    'produk_id'           => $produkId,
    'produk_kode'         => $produkKode,
    'produk_nama'         => $produkNama,
    'hpp_lama'            => $hppLama,          // e.g. 0 atau HPP Estimasi RAB
    'hpp_baru'            => $hargaBeliFinal,   // e.g. Harga PO Supplier
    'sumber_perubahan'    => 'PO_PEMBELIAN_1466',
    'ref_transaksi_nomer' => $nomorPO,
    'oleh_id'             => my_id(),
    'oleh_nama'           => my_name(),
    'dtime'               => date('Y-m-d H:i:s')
));
```

Manfaat: pelacakan Purchase Price Variance, akuntabilitas keuangan (siapa, kapan, nomor PO), dan integritas laba rugi saat Closing Step 5.

### 5.15 Reversal Handler (Pembatalan / PO Reject / Void)

Jika PO dibatalkan sebelum GRN (`1467`): kurangi kembali `qty_po` sebesar `qty` yang dibatalkan; kembalikan `qty_sisa = qty_kebutuhan - qty_po`; rollback status pool dari `CLOSED` menjadi `PARTIAL` atau `OPEN`.

### 5.16 Walkthrough Implementasi per Fase

| Fase | Cakupan | Berkas/Database |
|------|---------|-----------------|
| 1 | Fondasi database dan model | Kolom `allow_autopurchase` pada `produk`, `project_komposisi`, `project_komposisi_workoder`, `project_komposisi_sub_workoder`; tabel `project_purchase_pool`; model `MdlProduk.php`, `MdlProjectKomposisi.php`, `MdlProjectKomposisiWorkorder.php`, `MdlProjectKomposisiWorkorderSub.php`, `MdlProjectPurchasePool.php` |
| 2 | Pewarisan nilai dan manajemen RAB | `master_project/controllers/MasterData.php`: `addData()` membaca default `allow_autopurchase` dari master `produk`; `rebuildMasterKomposisi()` dan `rebuildMasterKomposisiSub()` menyinkronkan flag ke `project_komposisi`; `toggleAutopurchaseKomposisi()` untuk toggle AJAX on-the-fly |
| 3 | Trigger Kickoff | `master_project/controllers/FollowUp.php` pada `case 3:` dengan idempotency lock |
| 4 | Monitoring pengadaan di detail project | `MasterData::showPurchasePoolStatus($project_id)` baris 28574: metrik Total Item Kebutuhan, Total Item Sudah PO, Total Item Pending, Persentase Realisasi; tabel rinci Kode Barang, Nama Barang FG, Satuan, Qty RAB, Qty PO, Qty Sisa, Status Badge, Estimasi Biaya Satuan, Subtotal. View `views/data.php` baris 3020 menambah `<div id="project_purchase_pool_container">` dan loader AJAX `$('#project_purchase_pool_container').load(...)` |
| 5 | Resend / Sinkron Autopurchase (self-healing) | `MasterData::resendAutopurchasePool($project_id)` menyisipkan hanya item baru (differential sync) tanpa mengganggu item PO berjalan. Tombol `<i class="fa fa-paper-plane"></i> Resend / Sinkron Autopurchase` di action bar, tombol interaktif pada Empty State Box, dialog SweetAlert, auto-reload via `loadPurchasePoolStatus()` |

### 5.17 Hasil Verifikasi Walkthrough

```
=== MEMULAI TEST SIMULASI END-TO-END AUTOPURCHASE FG PROJECT ===
[OK] Mock data project_komposisi berhasil dibuat.
[HASIL RUN 1] SUCCESS_INSERTED_1
Jumlah record di project_purchase_pool: 1
  -> Barang: FG Boleh Autopurchase | Qty: 5.00 | Status: OPEN
[TEST PASS] Filter seleksi 100% Benar: Hanya FG dengan allow_autopurchase=1 yang masuk!
[HASIL RUN 2 - IDEMPOTENCY CHECK] SKIPPED_ALREADY_EXISTS
[TEST PASS] Idempotency Protection 100% Berfungsi: Double trigger tidak membuat data ganda!
[OK] Mock data test berhasil dibersihkan.
=== TEST SIMULASI SELESAI DENGAN SUKSES ===
```

| Kasus Uji | Ekspektasi | Hasil Aktual | Status |
|-----------|------------|--------------|--------|
| FG dengan `allow_autopurchase = 1` | Masuk ke `project_purchase_pool` | Masuk (status `OPEN`) | PASS |
| FG dengan `allow_autopurchase = 0` | Tidak masuk ke pool | Diabaikan | PASS |
| Supplies / Biaya / Jasa | Tidak masuk ke pool | Diabaikan | PASS |
| Double Kickoff / Re-run | Tidak membuat duplikasi pool | Terproteksi (`SKIPPED`) | PASS |
| Monitoring Pengadaan UI | Widget render metrik dan tabel status | Siap dan terhubung AJAX | PASS |
| Sintaks PHP 5.6 | Lolos linter PHP 5.6 | `php -l` No errors | PASS |

### 5.18 Roadmap Enam Fase (Blueprint V1)

| Fase | Cakupan | Target File |
|------|---------|-------------|
| 1 | UI Selector Project Pool | `modules/pembelianfgproject/controllers/_selectorItem.php`, `_selectorProjectPool.php` |
| 2 | Shopping Cart Integration (binding `project_purchase_pool_id`, `project_id` di sesi cart `1466r`) | `_processSelectProduct.php`, `_shoppingCart.php` |
| 3 | Sinkronisasi dan Pool Consumption (`qty_po`, `qty_sisa`, `status` saat PO `1466` disahkan) | `FollowUp.php` |
| 4 | Sync HPP Balik dan Audit Trail | `FollowUp.php` |
| 5 | Reversal Handler | `FollowUp.php` |
| 6 | Uji End-to-End (Kickoff -> Tarik ke PO -> Approval -> Cek Status Pool -> Verifikasi Audit Trail) | Script pengujian |

### 5.19 Status Implementasi Per Berkas (Blueprint V2)

| Berkas | Penyesuaian | Status |
|--------|-------------|--------|
| `template/transaksi.html` | Tag `{project_pool_inline}` pada `col-md-12` | SELESAI |
| `controllers/_shoppingCart.php` | API `getProjectPoolItemsAjax()`, dual-match query, format Qty bulat bersih | SELESAI |
| `controllers/_processPihak.php` | Logic `select()` dan `remove()` plus hook reload real-time | SELESAI |
| `controllers/_processSelectProduct.php` | Auto-Assign Header Supplier dari `project_purchase_pool` | SELESAI |
| `views/shoppingCart.php` | Event hook `loadProjectPoolInline()` saat reloaded | SELESAI |
| `views/transaksi.php` | Skrip `loadProjectPoolInline()` dan `addPoolItemToCart()` dengan konfirmasi wajib | SELESAI |
| `views/transaksi_modul.php` | Penyelarasan kedua skrip di atas | SELESAI |

---

## 6. Backorder dan Multi Cabang

### 6.1 Backorder: Control Tower Multi-Enterprise

Modul ini berfungsi sebagai **Control Tower** terpusat untuk memantau, mengelola, dan mengeksekusi pemenuhan pesanan tertunda lintas entitas bisnis (subsidiari), gudang global, dan mitra logistik pihak ketiga (3PL), dengan prinsip data atomik agar kalkulasi alokasi inventaris real-time.

Skema kolom tabel utama (1NF, dilarang menyimpan agregat atau data logistik kompleks dalam BLOB pada tabel operasional inti):

| Kolom | Tipe | Keterangan |
|-------|------|------------|
| `order_id` | VARCHAR | Kunci utama / nomor dokumen Sales Order |
| `product_sku` | VARCHAR | Kode unik produk (struktur terkecil) |
| `enterprise_entity_id` | VARCHAR | Kode perusahaan anak yang memesan |
| `qty_ordered` | INT | Total kuantitas dipesan pelanggan |
| `qty_backordered` | INT | Kuantitas macet (kurang) |
| `sla_tier` | ENUM | `TIER_1_PLATINUM`, `TIER_2_GOLD`, `TIER_3_NORMAL` |
| `required_delivery_date` | DATE | Batas akhir pengiriman sesuai kontrak |

Komponen UI: **Card Metrics Global Enterprise KPIs** (Total Backorder Value, Impacted Enterprise Entities, Aging Backorder Average, Revenue at Risk) dengan drill-down per entitas hukum; serta **Smart Allocation Matrix** yang mendukung grouping berbasis `product_sku` bila produk sama ada di kode pesanan berbeda.

Contoh baris matriks dari sumber:

| SKU | Kode Pesanan | Entitas | Qty Ordered / Backordered | Rekomendasi | Qty Available | Status |
|-----|-------------|----------|---------------------------|--------------|---------------|--------|
| `PROD-CHIP-V2` (Chip Semikonduktor) | `ORD-9921` | PT Elektronika Global | 10.000 / 5.000 | Inter-company Transfer: ambil surplus stok dari Subsidiary Tech Corp di Johor (MY), SLA Critical (Tier-1) | 7.500 unit (Johor Hub) | `PENDING_APPROVAL` |
| `PROD-CHIP-V2` | `ORD-9925` | PT Otomotif Perkasa | 3.000 / 3.000 | Supplier Drop-ship Direct dari pabrik vendor di Shanghai, SLA Normal (Tier-2) | 3.000 unit (Pabrik Vendor) | `IN_PROGRESS_API` |
| `PROD-TURB-X1` (Komponen Turbin) | `ORD-8830` | PT Energi Maju | 150 / 150 | Production Re-prioritization Batch #402 di Pabrik Utama Bandung, naik 2 hari | 150 unit (Sched. Batch) | `APPROVED_MES` |

Logika bisnis:

1. **Alokasi berbasis prioritas SLA** (dilarang FIFO murni): (a) `sla_tier = 'TIER_1_PLATINUM'` dengan penalti tertinggi, (b) `aging_backorder` terlama, (c) kedekatan geografis lokasi stok cadangan dengan lokasi pelanggan.
2. **Automated Intercompany Billing**: saat Inter-company Transfer dieksekusi, sistem menerbitkan Intercompany Purchase Order dari entitas pemesan ke penyedia stok, mengunci kuantitas pada gudang penyedia (Anti-Cannibalization), dan memakai skema Transfer Pricing terindeks di ERP utama.
3. **Partial Fulfillment**: jika `Qty Available (Source)` < `qty_backordered`, sistem menawarkan Split Shipment; pengiriman parsial hanya diizinkan bila minimal 30% dari total pesanan.

Pipeline integrasi: ERP Core (SAP/Oracle) untuk status Sales Order dan struktur organisasi; WMS untuk `Qty Available` akurat per gudang fisik dan 3PL; MES untuk instruksi re-prioritas jadwal produksi.

### 6.2 Multi Cabang: Audit Isolasi Identitas

Penggunaan ID sederhana (misalnya `produk_id` saja) tanpa context scoping ID (`cabang_id`, `gudang_id`) berpotensi tinggi memicu data leakage antar-cabang atau false validation (seperti kasus stok booking).

| # | Kategori ID | Model Terdampak | Composite Key Wajib | Risiko |
|---|-------------|-----------------|--------------------|--------|
| 1 | Persediaan dan Stok | `MdlLockerStock`, `MdlLockerStockBooking`, `MdlFifoProdukJadi`, `MdlFifoSupplies`, `MdlStockCache` | `cabang_id + gudang_id + produk_id (+ state)` | Stok booking antar-cabang tergabung bila query hanya GROUP BY `produk_id`, `gudang_status_id` tanpa `cabang_id`. HPP FIFO mismatch: pengeluaran HPP saat simpan invoice/penjualan bisa memotong batch FIFO cabang lain bila `MdlFifoProdukJadi` tidak mengunci `cabang_id = my_cabang_id()` dan `gudang_id = my_gudang_id()` |
| 2 | Pengunci Transaksi | `MdlLockerTransaksi`, `ComLockerTransaksi`, `ComLockerTransaksiMain` | `cabang_id + gudang_id + jenis_tr + booking_number/transaksi_id + oleh_id` | **RESOLVED**: composite index `idx_locker_isolation` (`cabang_id`, `gudang_id`, `jenis`, `state`, `transaksi_id`, `oleh_id`) sudah di `trigger.sql`; scoping penuh pada query update dan `FOR UPDATE`; `execLocker()` sudah mengunci `cabang_id` pengguna aktif |
| 3 | Master Harga dan Diskon | `MdlHargaProduk`, `MdlDiskonPenjualan`, `MdlDiskonCustomer`, `MdlHargaProdukPerSupplier` | `cabang_id + produk_id (+ customer_level_id)` | Harga jual di Cabang Jakarta dan Surabaya bisa berbeda. Kueri harga pada modal selector (`_processSelectProduct.php`) wajib mengunci `cabang_id = my_cabang_id()` agar tidak mengambil harga reguler cabang lain |
| 4 | Penomoran Dokumen | `MdlNumbering`, konfigurasi `counter_global` | `_company_cabangID_jenisTr + dtime` | Penomoran faktur/SO harus mandiri per cabang. Bila `MdlNumbering` hanya membaca `jenis_tr`, nomor urut faktur Cabang A bentrok (duplicate index key) dengan Cabang B |
| 5 | Sesi Mobile / Scanner | Sesi `$_SESSION['login']` via `followupDariHp()` | `cabang_id + gudang_id + jenis = 'scaner' + oleh_id` | Sesuai `AGENTS.md` Seksi 3.9, saat scanner/tablet inisiasi sesi via `createSimpleSessionLogin`, `cabang_id` dan `gudang_id` wajib disertakan eksplisit agar aktivitas scan terasosiasi ke gudang fisik cabang yang tepat |

### 6.3 Relevansi Multi Cabang terhadap Opname

- Validasi jenis transaksi per cabang: user pusat (`cabang_id = -1`) memakai `jenis_tr = 1119`, user cabang (selain -1) memakai `2229` (TC-1.3).
- Stok buku pada Excel diambil dari `_rek_pembantu_*_cache` yang harus ter-scope `gudang_id` dan `cabang_id` (TC-2.2).
- Worker RabbitMQ melakukan row-lock `locker_stock` dengan predicate `cabang_id + gudang_id + produk_id + state = 'active'`, sejalan dengan kebijakan isolasi identitas.

---

## 7. Advance Bank dan Rekonsiliasi GRUP

### 7.1 Catatan Cakupan Sumber

Tidak ada dokumen sumber yang secara khusus membahas **Advance Bank** atau **rekonsiliasi GRUP (group consolidation)**. Sumber terdekat adalah `AUDIT_AR_PROJECT_DP_CHECK.md`, yang mengaudit kecocokan saldo **DP (uang muka) Proyek** di UI terhadap saldo riil buku besar rekening `2010050` HUTANG KE KONSUMEN, dan mendeteksi potensi kegagalan transaksi **A/R Receipt `749`**. Bagian ini hanya menyajikan mekanisme rekonsiliasi yang benar-benar ada di sumber; tidak ada detail advance bank yang dikarang.

### 7.2 Tujuan dan Parameter Audit

Tujuan: mendeteksi otomatis potensi kegagalan transaksi A/R Receipt (`749`) akibat mismatch antara Saldo Uang Muka Project di UI (model `MdlPaymentUangMukaPpn`, sisa + `ppn_sisa`) dan Saldo Riil Buku Besar `2010050`.

| Parameter | Nilai |
|-----------|-------|
| Tabel sumber invoice | `transaksi_payment_source` (alias `t_inv`) |
| Tabel sumber DP | `transaksi_payment_source` (alias `t_dp`), `label = 'uang muka konsumen'`, `sisa > 0` |
| Sumber GL | `_rek_pembantu_subcustomer_cache`, `rekening = '2010050'` atau `extern2_id = '2010050060'`, `periode = 'forever'` |
| Filter target | `target_jenis = '749'`, `jenis = '7499'`, `sisa > 1000` |
| Urutan | `ORDER BY t_inv.cabang_id ASC, t_inv.extern_nama ASC` |
| Status audit | `GAGAL_DEFISIT` bila `t_dp.sisa > 0` dan `saldo_gl < t_dp.sisa`; selain itu `AMAN` |

Kolom output: `payment_source_id`, `cabang_id`, `nomer_nota`, `invoice_transaksi_id`, `customer_id`, `customer_nama`, `project_id`, `project_nama`, `sisa_tagihan_nota`, `dp_transaksi_id`, `dpp_uang_muka_dibutuhkan`, `ppn_uang_muka`, `total_uang_muka_ui`, `saldo_riil_gl_2010050`, `selisih_defisit` (`saldo_gl - t_dp.sisa`), `status_audit`.

### 7.3 Standar Kode dan Komponen Implementasi

- Framework: CodeIgniter 3.1.8 + Wiredesignz HMVC (PHP 5.6 Compatible).
- Compliance: ISO 9001 (Mutu dan Dokumentasi), ISO 27001 (Security dan Audit Trail), OWASP Top 10 dengan strict database query binding dan CI Query Builder.
- Docstring: tag `/** [AGENT_LOG] ... [/AGENT_LOG] */` di atas class/method, tanpa inline comment. Contoh metadata: `ROLE: Software Engineer Agent`, `LOG_EXPIRE: 2026-11-05`.

| Komponen | Lokasi | Peran |
|----------|--------|-------|
| Model | `application/models/Coms/ComAuditArProjectDp.php` | `get_audit_report($cabang_id = null)` dengan `$binds = array('749', '7499', 1000)` plus bind opsional `cabang_id` |
| Controller | `application/modules/penerimaan/controllers/AuditProject.php` | `extends Modul_Controller`; `index()` membaca `$_GET['cabang_id']` dengan cast `(int)`, memuat view |
| View | `application/modules/penerimaan/views/audit_project_view.php` | DataTables (Bootstrap 3.4.1, DataTables 1.10.25, jQuery 1.12.4), `pageLength: 50` |

Kolom tabel view: No, Cabang, Nama Konsumen, PID, Nomer Nota, Nama Project, Sisa Tagihan Nota, Saldo DP Project (UI), Saldo Riil GL 2010050, Status Audit. Kelas CSS: `status-aman` (label "AMAN"), `status-gagal` (label "PASTI GAGAL"), `status-potensi` (label "BERPOTENSI GAGAL").

### 7.4 Alur Kerja Rekonsiliasi yang Disarankan

1. Jalankan `ComAuditArProjectDp::get_audit_report()` per cabang (opsional tanpa filter untuk view global).
2. Filter baris dengan `status_audit = 'GAGAL_DEFISIT'` sebagai daftar prioritas rekonsiliasi.
3. Cocokkan `dp_transaksi_id` pada `transaksi_payment_source` dengan dokumen jurnal pembayarannya di `2010050` / `2010050060`.
4. Tahan (hold) posting A/R Receipt `749` untuk customer/project berstatus `GAGAL_DEFISIT` sampai selisih teratasi.
5. Catat setiap penyesuaian pada tabel `log` (`MdlActivityLog`).

### 7.5 Ketidaksesuaian Sumber yang Perlu Dikoreksi

- Query SQL di dokumen memakai `SUM(kredit - debet)`; kode CI3 model memakai `SUM(kredit_akhir - debet_akhir)` pada tabel yang sama. Lihat Temuan K-05.
- View mengekewsulkan status `GAGAL_SALDO_NOL` yang tidak pernah dihasilkan query. Lihat Temuan K-06.

---

## 8. Pelaksana SPK: Internal versus Eksternal

### 8.1 Ruang Lingkup

Fitur untuk mengubah tipe pelaksana (**INTERNAL** <> **EXTERNAL**) lewat klik pada badge, dilengkapi modal pop-up, auto-check biaya aktif (transaksi `3674`), opsi pembatalan/void otomatis, dan dual audit trail logging. Berlaku di modul `master_project`.

### 8.2 Alur Kerja

1. Klik badge tipe pelaksana (hijau INTERNAL atau oranye EXTERNAL), buka modal Switch Pelaksana.
2. AJAX check: ambil data SPK, karyawan, vendor, dan cek biaya aktif `3674`.
3. **INTERNAL -> EXTERNAL**: pilih vendor, Simpan, update `tasklist_project` ke Type 22 dan vendor. Jika SPK sudah QC, auto-trigger `AutoPostingBiaya` untuk menerbitkan `3674` vendor baru. Jika belum QC, biaya terbit saat QC nanti.
4. **EXTERNAL -> INTERNAL**: pilih karyawan. Tanpa biaya `3674` aktif, Simpan langsung. Jika ada biaya aktif, tampilkan panel biaya (No. Nota, Nominal, Status Pembayaran) dengan checkbox "Batalkan/Void Biaya Vendor ini otomatis". Klik Simpan -> void `3674` (`trash_4 = 1`, `status_4 = 3`), reset `post_biaya_id` di `tasklist_project`, update ke Type 11 dan karyawan.
5. Catat dual audit trail: `project_tasklist_log` (Timeline SPK) dan `log` (Activity Log Keuangan jika ada void). Tutup modal dan refresh DataTable.

### 8.3 Kebijakan Pembatalan Biaya yang Sudah Terbayar

Jika biaya vendor `3674` terdeteksi sudah memiliki pembayaran riil dari kasir/bank (`nilai_bayar > 0`), sistem **TIDAK AKAN** membatalkan otomatis untuk menghindari ketidaksesuaian saldo kas fisik. Modal menampilkan peringatan bahwa biaya sudah dicairkan dan meminta koordinasi dengan kasir/keuangan. Jika `nilai_bayar == 0` (pending atau hutang belum dibayar), void dapat dilakukan otomatis 100%.

### 8.4 Backend: `MasterData.php`

**`checkPelaksanaBiayaAjax()`**: menerima `no_spk` via GET/POST; mengambil `type_pelaksana`, `employee_id`, `employee_nama`, `progress_id`, `produk_id`; query transaksi biaya aktif di `transaksi` dengan `referensi_nomer = $no_spk`, `jenis IN ('3674r', '3674')`, `trash_4 = 0`; mengambil karyawan aktif (`MdlEmployee_all` filter `allow_project = 1`) dan vendor aktif (`MdlSupplier`); mengembalikan JSON terstruktur berisi status biaya, rincian pembayaran, dan daftar opsi pelaksana.

**`saveSwitchPelaksanaAjax()`**: menerima `no_spk`, `new_type`, `pelaksana_id`, `pelaksana_nama`, `void_biaya` (0/1); seluruh proses dibungkus `trans_start()` / `trans_complete()`.
- External -> Internal: jika `void_biaya == 1`, update `3674r`/`3674` (`trash_4 = 1`, `status_4 = 3`), tulis log ke `MdlActivityLog` (tabel `log`), reset `post_biaya_id = 0` dan `post_biaya_no = NULL`; update `type_pelaksana = 11`, `employee_id`, `employee_nama`.
- Internal -> External: update `type_pelaksana = 22`, `employee_id`, `employee_nama`; reset `post_biaya_id = 0`; jika `progress_id == 3` (sudah QC), otomatis memanggil `AutoPostingBiaya` untuk menerbitkan tagihan vendor `3674` baru.
- Dual audit logging: `project_tasklist_log` via `MdlTasklistProjectLog` dengan tipe `'SWITCH_PELAKSANA'`; `log` via `MdlActivityLog` jika ada void.

Metadata datatable (`action` array di `showHalamanPelaksana`): setiap baris membawa `_no_spk`, `_tasklist_id`, `_type_pelaksana`, `_employee_id`, `_employee_nama`, `_progress_id`.

### 8.5 Frontend

**`views/data.php`**: badge di kolom pelaksana (target 8) dibuat clickable dengan `cursor: pointer`, tooltip "Klik untuk ubah pelaksana/tipe", trigger `onclick="openModalSwitchPelaksana(this)"`. Modal Bootstrap AdminLTE `#modalSwitchPelaksana` berisi radio Tipe Pelaksana, dropdown dinamis (Karyawan atau Vendor), container status biaya, tombol Batal dan Simpan. Handler: `openModalSwitchPelaksana(el)` memanggil AJAX; dynamic form switcher menyesuaikan dropdown dan panel biaya saat radio diganti; `submitSwitchPelaksana()` mengirim via AJAX, menampilkan SweetAlert, dan me-reload DataTables.

**`template/tasklist_update.html`**: badge di header QC modal pada baris `#tipe_pelaksana_badge` dibuat clickable agar tipe pelaksana dapat diubah dari dalam modal QC.

### 8.6 Verifikasi

```powershell
C:\xampp\php\php.exe -l application/modules/master_project/controllers/MasterData.php
C:\xampp\php\php.exe -l application/modules/master_project/views/data.php
```

| Skenario | Langkah | Verifikasi |
|----------|---------|------------|
| 1. INTERNAL -> EXTERNAL | Klik badge hijau, ganti radio ke External, pilih vendor, Simpan | Badge menjadi orange "PIHAK KE-3 / VENDOR / SUBKON"; `project_tasklist_log` mencatat riwayat |
| 2. EXTERNAL -> INTERNAL tanpa biaya | Klik badge orange tanpa biaya, pilih Internal, pilih karyawan, Simpan | Badge hijau INTERNAL tanpa error |
| 3. EXTERNAL -> INTERNAL dengan biaya aktif | Klik badge orange dengan `3674` pending | Modal menampilkan peringatan kuning berisi No. Nota dan nominal; checkbox pembatalan muncul; setelah Simpan, `trash_4 = 1` dan riwayat tercatat di `log` serta `project_tasklist_log` |

---

## 9. Checklist dan UAT Opname

### 9.1 Dua Kerangka UAT

| Dokumen | Kerangka | Jumlah TC | Cakupan |
|---------|----------|-----------|---------|
| `uat_modul_opname_5w1h.md` | 5W+1H per test case (What, Who, When, Where, Why, How) | 33 | 9 area dengan tabel dimensi dan kriteria PASS/FAIL |
| `checklist_uat_opname.md` | Checklist tabular dengan kolom Status, Legenda, Ringkasan Hasil, Keputusan UAT | 40 | 9 area, menambah 6 pemeriksaan database yang tidak ada di 5W1H |

Keduanya memakai Environment **everest_26sep**.

### 9.2 Ringkasan Sembilan Area UAT

| Area | UAT 5W1H | Checklist | Kriteria inti |
|------|----------|-----------|--------------|
| 1. Index dan pra-opname | TC-1.1 s.d. 1.3 | 1.1 s.d. 1.3 | Cek transaksi gantung; index normal; kode transaksi per cabang |
| 2. Download Excel | TC-2.1 s.d. 2.5 | 2.1 s.d. 2.6 | Download .xlsx, stok buku akurat, serial terisi, proteksi ganda, log `dashboard_opname` |
| 3. Upload Excel | TC-3.1 s.d. 3.3 | 3.1 s.d. 3.4 | Upload valid, tolak format salah, tolak lebih dari 1 MB, log `opname_xls` |
| 4. Execute opname | TC-4.1 s.d. 4.6 | 4.1 s.d. 4.8 | Selisih lebih/kurang/tanpa selisih, update dashboard, parsing serial, transaksi terbentuk |
| 5. Approval chain | TC-5.1 s.d. 5.4 | 5.1 s.d. 5.4 | Authorization 1, Authorization 2 final, edit qty, revert |
| 6. Dashboard monitoring | TC-6.1 s.d. 6.2 | 6.1 s.d. 6.2 | Status real-time, konfirmasi selesai |
| 7. History dan re-download | TC-7.1 s.d. 7.2 | 7.1 s.d. 7.2 | History 10 terakhir, re-download XLSX |
| 8. Edge case dan keamanan | TC-8.1 s.d. 8.5 | 8.1 s.d. 8.5 | Session expired, file bukan template, `gudang_id` tidak match, HPP nol, concurrent upload |
| 9. Validasi jurnal akuntansi | TC-9.1 s.d. 9.3 | 9.1 s.d. 9.6 | Jurnal balance, rekening pembantu termutasi, HPP average, COA terbentuk, rek pembantu laba, rek pembantu kerugian |

### 9.3 Kriteria PASS Kritis

**Download Excel (TC-2.1)** PASS bila SEMUA terpenuhi: file `.xlsx` terdownload; kolom cID, gID, jenis, pID, sku, produk, indoor, outdoor, kategori, supplier, stok (buku), stok riil, serial number tersedia; kolom "stok riil" kosong; kolom "stok (buku)" berisi angka sistem; kolom "serial number" terisi jika produk punya serial; record `dashboard_opname` ter-insert; record `dashboard_opname_data` ter-insert batch per 500.

**Selisih lebih (TC-4.1)**: buku = 10, riil = 15 -> `qty_debet = 5`, `qty_kredit = 0`, `debet = hpp x 5`.
**Selisih kurang (TC-4.2)**: buku = 10, riil = 7 -> `qty_kredit = 3`, `qty_debet = 0`, `kredit = hpp_avg x 3`.
**Tanpa selisih (TC-4.3)**: `qty_debet = 0`, `qty_kredit = 0`, tidak ada mutasi stok atau jurnal.

**Authorization 1 (TC-5.1)**: status `1119r` -> `1119ro`; preprocessor `ProdukSerialNumberExtractorOpname` berjalan; postprocessor `Opname` + `OpnameData` berjalan; state label "pending approval 2" oranye.

**Authorization 2 final (TC-5.2)** - step paling kritis: status -> `1119` (Complete, hijau); jurnal debet COA `1010030030` + `7010150` (selisih lebih); jurnal kredit COA `1010030030` + `7020020` (selisih kurang); `qty_debet` bertambah pada rekening pembantu produk untuk produk masuk, `qty_kredit` bertambah untuk produk keluar; `Rek Pembantu LR Lain-lain` mencatat detail laba opname; `Rek Pembantu Kerugian` mencatat detail kerugian opname; `FifoAverageOpname` menghitung `hpp_avg` untuk kredit.

**Jurnal balance (TC-9.1)**: `SUM(debet) = SUM(kredit)`. Gagal = **CRITICAL BUG**.
**Rekening pembantu (TC-9.2)**: saldo baru = saldo lama + `qty_debet` - `qty_kredit` per produk.
**HPP average (TC-9.3)**: kredit = `hpp_avg x qty_kredit`, bukan hpp terakhir (config `coTransaksiCore.php` baris 38).

### 9.4 Prioritas dan Ringkasan Hasil

| Area | Total TC | High | Medium | Low |
|------|----------|------|--------|-----|
| 1. Index dan pra-opname | 3 | 2 | 1 | 0 |
| 2. Download Excel | 6 | 3 | 2 | 1 |
| 3. Upload Excel | 4 | 2 | 1 | 1 |
| 4. Execute opname | 8 | 3 | 5 | 0 |
| 5. Approval chain | 4 | 2 | 2 | 0 |
| 6. Dashboard | 2 | 0 | 2 | 0 |
| 7. History | 2 | 0 | 0 | 2 |
| 8. Edge cases | 5 | 2 | 3 | 0 |
| 9. Jurnal akuntansi | 6 | 6 | 0 | 0 |
| **TOTAL** | **40** | **20** | **16** | **4** |

Legenda: merah = Prioritas High (wajib test), kuning = Medium, hijau = Low, centang = Pass, silang = Fail, panah = Skip (perlu alasan). Empat belas test case pada versi 5W1H berkaitan langsung dengan integritas data, kalkulasi nilai, dan jurnal akuntansi.

Keputusan UAT: **LULUS** (semua High PASS, tidak ada Fail di area kritikal); **LULUS BERSYARAT** (ada Fail medium/low dengan catatan perbaikan); **TIDAK LULUS** (ada Fail High, perlu perbaikan sebelum go-live).

### 9.5 Temuan Kode yang Wajib Diverifikasi

Validasi di `executeOpname()` baris 2204-2212:

```php
if ($db_cabang_id != $dt_gdid) { }
elseif ($db_jenis != $dt_jenis) { }
```

Blok `if-elseif` kosong tanpa penanganan error eksplisit. Jika data tidak match (misalnya `gID` diubah dari gudang A ke B), proses diam-diam lanjut tanpa peringatan. TC-8.3 wajib dijalankan khusus untuk memverifikasi perilaku aktual.

Selain itu, `doUpload()` menerima `xlsx`, `csv`, `xls`, `ods` dan menolak format lain dengan pesan "format file yang diupload harus berextensi xlsx". Namun `executeOpname()` hanya memproses XLSX (parser `PHPExcel_Reader_Excel2007`) dan menolak yang lain dengan pesan "hanya menghandel file XLSX". Ini gap antara format yang diterima upload dan yang bisa diproses (TC-4.6).

---

## 10. Temuan Lintas-Dokumen dan Kontradiksi

Setiap temuan berikut adalah hasil perbandingan langsung antar dokumen sumber, bukan dugaan.

### K-01: Dua Set Nama Topologi RabbitMQ yang Berbeda (Tinggi)

| Set | Exchange | Routing Key | Main Queue | DLX | DLQ | VHost |
|-----|----------|-------------|------------|-----|-----|-------|
| `ARSITEKTUR_RABBITMQ_OPNAME.md` | `inventory.opname.x` | `opname.submitted` | `inventory.opname.process.q` | `inventory.opname.dlx` | `inventory.opname.failed.q` | `/inventory` |
| `WORKFLOW_RABBITMQ.md` | `everest.jobs.x` | `job.process` | `everest.jobs.q` | `everest.jobs.dlx` | `everest.jobs.failed.dlq` | tidak disebut |

Tidak ada penjelasan bahwa ini dua environment berbeda. Mekanisme monitoring juga berbeda: set A memakai staging table (`so_headers_staging`), set B memakai shadow table (`rabbit_publish_shadow`). Consumer juga berbeda (`OpnameWorker.php` vs `Worker.php`). Perlu pasti konfigurasi yang dipakai produksi sebelum go-live.

### K-02: Arah Jurnal Selisih Lebih yang Bertentangan (KRITIS)

| Sumber | Selisih Lebih | Selisih Kurang |
|--------|---------------|----------------|
| `analisa_modul_opname.md` tabel 4.2 | Debet `1010030030` **dan** Debet `7010150` | Kredit `1010030030` **dan** Kredit `7020020` |
| `checklist_uat_opname.md` 9.4 | `1010030030` (D) **+** `7010150` (D) | `1010030030` (-K) **+** `7020020` (K) |
| `ARSITEKTUR_RABBITMQ_OPNAME.md` bagian 6 | Debet `1010030030`, **Kredit** `7010150` | Debet `7020020`, **Kredit** `1010030030` |
| `WORKFLOW_RABBITMQ.md` zona 4 | Kredit Persediaan `1010030030`, **Kredit** Laba Selisih `7010150` | **Debet** Rugi Selisih `7020020` |

Varian 1 dan 2 bukan jurnal double-entry yang balance: dua baris debet tanpa pasangan kredit pada level COA. Varian 3 dan 4 merupakan jurnal double-entry yang benar secara akuntansi. Dampak: kalau UAT 9.1 (`SUM(debet) = SUM(kredit)`) dijalankan terhadap implementasi yang mengikuti varian 1/2, hasilnya tidak akan balance. Harus diklarifikasi tim akuntansi sebelum go-live.

### K-03: Arsitektur RabbitMQ Masih Nonaktif

`coTransaksiCore.php` baris 10: `$config['opname_use_rabbitmq'] = false;` dengan komentar "MATI - proses sinkron". Blueprint, staging table, dan worker daemon belum dipakai di jalur produksi.

### K-04: Format File Upload vs File yang Diproses

`doUpload()` menerima `xlsx`, `csv`, `xls`, `ods`; `executeOpname()` hanya memproses XLSX. Ada dua lapis validasi yang tidak konsisten.

### K-05: Agregat GL pada Audit DP Berbeda Antara Dokumen dan Kode

Query SQL dokumen memakai `SUM(kredit - debet)`; kode CI3 model memakai `SUM(kredit_akhir - debet_akhir)`, keduanya pada `_rek_pembantu_subcustomer_cache`. Perlu dipastikan nama kolom yang benar-benar ada.

### K-06: Status `GAGAL_SALDO_NOL` Tidak Dihasilkan Query

View `audit_project_view.php` memeriksa `status_audit == 'GAGAL_SALDO_NOL'` untuk label "PASTI GAGAL", tetapi `CASE WHEN` hanya menghasilkan `GAGAL_DEFISIT` atau `AMAN`. Percabangan tersebut kode mati.

### K-07: Arti Kode `2229` Berbeda

`analisa_modul_opname.md` memetakan `2229` sebagai kode transaksi Produk Cabang (COA `1010030030`); `AGENTS_OPNAME.md` memetakan `2229` untuk Gudang Project. Keduanya menyebut `1119` untuk Gudang Good/PUSAT DC. TC-1.3 hanya konsisten dengan versi pertama.

### K-08: Nama Tabel Anaknya Tidak Konsisten

`project_komposisi_workoder_sub` (implementation plan) vs `project_komposisi_sub_workoder` (walkthrough). Keduanya membuat kolom `allow_autopurchase`. Verifikasi nama tabel sebelum menjalankan ALTER TABLE.

### K-09: Nama Status Pool Tidak Konsisten di Diagram

Sequence diagram menuliskan status `WAITING_PO` dan `CLOSED / IN_PO`, sedangkan kode `insert_batch` memakai `status = "OPEN"` dan DDL Mendefinisikan ENUM `('OPEN','PARTIAL','CLOSED','CANCELLED')`. Kode dan DDL konsisten; kedua diagram tidak.

### K-10: Strategi Folder Temporer Berlawanan

`AGENTS_OPNAME.md` (everest_20jul) menyatakan target temp PHPExcel dipindah dari `sys_get_temp_dir()` ke `FCPATH . 'uploads/'` karena open_basedir dan write permission CentOS. `rangkuman_stok_opname_merek.md` (everest_17jul) justru menyebut `sys_get_temp_dir()` untuk kompresi ZIP guna menghindari permission error. Dua workspace, dua strategi berbeda; harus dipilih satu dan konsisten termasuk pada jalur ZIP.

### K-11: Jumlah Test Case Berbeda

UAT 5W1H berisi 33 test case; checklist berisi 40. Yang hanya ada di checklist: 2.6 (log `dashboard_opname`), 3.4 (log `opname_xls`), 4.5-4.7 (tiga parsing serial terpisah), 4.8 (transaksi opname terbentuk), 9.4 (COA terbentuk benar), 9.5 (rek pembantu laba lain-lain), 9.6 (rek pembantu kerugian). Gunakan checklist untuk cakupan memotensi.

### K-12: PPV Hilang di Aturan Jurnal Worker

`analisa_modul_opname.md` mendefinisikan PPV (`hpp_nppv = hpp x ppv_index__nilai`, `debet_ppv_riil = ppv_riil x qty_debet`). Aturan jurnal worker di `ARSITEKTUR_RABBITMQ_OPNAME.md` tidak memuat komponen PPV sama sekali. Migrasi keworker berisiko menghilangkan pencatatan PPV pada opname.

### K-13: Basis Data Staging Berbeda

`ARSITEKTUR_RABBITMQ_OPNAME.md` menempatkan staging di database `run_everest_modul` dengan `so_headers_staging`, `so_items_staging`, `so_audit_logs`. `WORKFLOW_RABBITMQ.md` menempatkan tabel audit di database yang sama dengan `rabbit_publish_shadow`. Dua mekanisme paralel tanpa dokumentasi mana yang authoritative.

### K-14: Jumlah Workspace Berbeda pada Sumber

Dokumen sumber merujuk pada `everest_17jul`, `everest_20jul`, `everest_26sep`, `everest_29agus`, `everest_11sept`, serta `z:\everest_29agus`. Nomor baris fungsi (misalnya `doPrint()` baris 1150) hanya valid untuk satu versi; semua temuan berbasis nomor baris harus diverifikasi terhadap codebase target.

### K-15: Cakupan Laporan yang Tidak Tercakup Sumber

Bagian 7 (Advance Bank dan Rekonsiliasi GRUP) tidak memiliki dokumen sumber khusus; isinya diturunkan dari audit DP/GL `2010050`. Rincian advance bank (jurnal uang muka, nomor rekening, bank rekon) tidak ada dalam paket sumber dan tidak dikarang.

### K-16: Typo pada Nama Controller Tray

`_tray_enchanced.php`; penulisan benar adalah `enhanced`. Karena nama class dan file menyatu, memperbaiki typo memerlukan rename file agar autoloader tetap bekerja.

### K-17: Typo pada Nama Controller di Lampiran

Daftar controller pada `analisa_modul_opname.md` memuat `_selectorPihak.php` (18 KB) sebagai picker pihak; penulisan yang konsisten adalah `_selectorPihak.php` (bukan `_selectorITEM.php`).

---

## 11. Lampiran: Daftar File Sumber

| Nama File | Ukuran | Topik H1 | Peran |
|-----------|--------|----------|-------|
| AGENTS_OPNAME.md | 5.695 bytes | Panduan dan Blueprint Modul Stok Opname (AGENTS_OPNAME) | Panduan wajib untuk AI Agent: struktur berkas, lima optimasi historis (503 timeout, akurasi dashboard, kecepatan executeOpname, Excel korup, UI/UX), dan empat instruksi kritis (PHP 5.6, zero placeholder, keamanan upload, transaction wrapper) |
| analisa_modul_opname.md | 16.743 bytes | Analisa Modul Opname (Stock Opname) | Analisis utama: matriks jenis dan COA, 23 controller, 5 config, alur proses, approval chain, value gates, tabel DB, fungsi kunci bernomor baris, fitur khusus, hierarki controller |
| ARSITEKTUR_RABBITMQ_OPNAME.md | 10.302 bytes | Blueprint dan Bagan Arsitektur: Asynchronous Stock Opname dengan RabbitMQ | Blueprint RabbitMQ set A: topologi `inventory.opname.*`, tiga zona, sequence diagram, DDL tiga tabel staging, aturan jurnal worker, perbandingan teknis, cara menjalankan daemon |
| audit multi cabang.md | 3.421 bytes | (tanpa H1; paragraf pembuka "Hasil Review dan Audit Arsitektur Identitas") | Audit isolasi identitas lima kategori ID untuk multi cabang dan multi gudang, composite key wajib, status RESOLVED pada transaction concurrency locker |
| AUDIT_AR_PROJECT_DP_CHECK.md | 12.840 bytes | Dokumentasi Teknis dan Kode Audit: Pengecekan Kesesuaian Saldo DP Project vs GL 2010050 | Query SQL audit, model `ComAuditArProjectDp`, controller `AuditProject`, view DataTables; standar ISO 9001 dan 27001 dengan query binding |
| audit_tray_enchanced.md | 5.672 bytes | Laporan Audit dan Scoring: `_tray_enchanced.php` | Vonis audit dengan skor per aspek (MVC 4/10, clean code 3/10, performa 2/10, keamanan 5/10, total 3.5/10), analisis tiga fungsi turunan, lima tuntutan perbaikan |
| backorder.md | 5.292 bytes | Blueprint Spesifikasi Fungsional: Multi-Enterprise Backorder Management Cockpit | Spesifikasi control tower backorder: skema kolom 1NF, KPI cards, Smart Allocation Matrix, logika alokasi SLA-driven, automated intercompany billing, partial fulfillment, pipeline SAP/WMS/MES |
| blueprint_autopurchase_pembelianfgproject.md | 8.697 bytes | Blueprint Arsitektur: Integrasi Autopurchase FG Project ke `pembelianfgproject` (1466) | Blueprint v1 AutoPurchase: separation of concerns, diagram alur, `_selectorProjectPool.php`, alokasi parsial, metadata cart, sinkronisasi pool, reversal, sinkron HPP dengan `project_hpp_history`, roadmap enam fase |
| blueprint_autopurchase_pembelianfgproject_v2_inline.md | 15.826 bytes | Blueprint Arsitektur Revisi: Integrasi Autopurchase FG Project Inline UI (`pembelianfgproject` / 1466) | Blueprint v2 Direct Inline UI: tata letak `col-md-12`, sebelas kolom tabel, dual-match supplier query, auto-assign header supplier, konfirmasi wajib pergantian vendor, hook real-time, status implementasi tujuh berkas SELESAI |
| checklist_uat_opname.md | 10.630 bytes | Checklist UAT - Modul Opname | Checklist 40 test case dengan legenda, kolom status, ringkasan hasil per area, dan formulir keputusan UAT |
| DOC_ANALISIS_DAN_SOLUSI_TRAY_NOTIFICATION.md | 5.460 bytes | Dokumentasi Teknis: Analisis dan Solusi Perhitungan Notifikasi Badge Tray | Kasus ketidaksinkronan badge 2.958 vs 612, arsitektur tray pasca refactor, root cause `COUNT(1)` di `CronTray.php`, tabel perbandingan lama vs baru, solusi `COUNT(DISTINCT t.id)` dan regenerasi cache |
| implementation_plan_autopurchase.md | 10.181 bytes | Blueprint dan Rancangan Final: Autopurchase FG Project (Modul `master_project`) | Rancangan desain: prinsip desain, sequence diagram, DDL `allow_autopurchase` dan `project_purchase_pool`, trigger `case 3:` di `FollowUp.php`, rencana verifikasi empat skenario |
| implementation_plan_internal_to_external_pelaksana_spk.md | 8.017 bytes | Rencana Implementasi: Fitur Switch Pelaksana dan Auto-Void Biaya Aktif (Modul Master Project) | Rencana switch INTERNAL/EXTERNAL: diagram alur, kebijakan biaya terbayar, dua method AJAX, dual audit trail, view dan modal, tiga skenario verifikasi |
| rangkuman_stok_opname_merek.md | 5.622 bytes | Rangkuman Perkembangan Modifikasi Modul Stok Opname (everest_17jul) | Rangkuman e-Form PDF interaktif, transisi Kategori ke Merek (`MdlMerek`), UI modal dan CSS badge serta ellipsis, optimasi history download dan ZIP, daftar berkas dimodifikasi, catatan pengujian lanjutan |
| uat_modul_opname_5w1h.md | 26.595 bytes | UAT Modul Opname - Metode 5W+1H | UAT 33 test case berformat What/Who/When/Where/Why/How dengan kriteria PASS/FAIL, sembilan area, checklist ringkasan prioritas, catatan temuan kode baris 2204-2212 |
| walkthrough_autopurchase.md | 5.869 bytes | Walkthrough: Implementasi Autopurchase FG Project (`master_project`) | Walkthrough lima fase (database dan model, pewarisan RAB, trigger kickoff, monitoring widget, resend/sinkron) plus hasil simulasi end-to-end enam kasus uji |
| WORKFLOW_RABBITMQ.md | 5.809 bytes | Bagan Workflow RabbitMQ: Asynchronous Stock Opname | Workflow RabbitMQ set B: topologi `everest.jobs.*`, shadow table `rabbit_publish_shadow`, lima zona, sequence diagram, penjelasan load decoupling, lokasi berkas |

### 11.1 Peta Keterkaitan Antar-Dokumen

| Tema | Dokumen Utama | Dokumen Pendukung |
|------|---------------|-------------------|
| Struktur dan alur opname | `analisa_modul_opname.md` | `uat_modul_opname_5w1h.md`, `AGENTS_OPNAME.md`, `rangkuman_stok_opname_merek.md` |
| UAT | `uat_modul_opname_5w1h.md` | `checklist_uat_opname.md` |
| RabbitMQ | `ARSITEKTUR_RABBITMQ_OPNAME.md` | `WORKFLOW_RABBITMQ.md`, `analisa_modul_opname.md` (saklar config) |
| AutoPurchase | `implementation_plan_autopurchase.md`, `blueprint_autopurchase_pembelianfgproject.md` | `blueprint_autopurchase_pembelianfgproject_v2_inline.md`, `walkthrough_autopurchase.md` |
| AutoPurchase dan Executor SPK | kedua blueprint AutoPurchase | `implementation_plan_internal_to_external_pelaksana_spk.md` |
| Tray notifikasi | `DOC_ANALISIS_DAN_SOLUSI_TRAY_NOTIFICATION.md` | `audit_tray_enchanced.md` |
| Multi cabang | `audit multi cabang.md` | `analisa_modul_opname.md` (TC-1.3), `ARSITEKTUR_RABBITMQ_OPNAME.md` (row lock) |
| Rekonsiliasi uang muka | `AUDIT_AR_PROJECT_DP_CHECK.md` | Tidak ada dokumen lain yang addressing |
| Backorder | `backorder.md` | Independen dari paket opname; berbagi konsep SLA tier dan multi-entitas |

### 11.2 Rekomendasi Urutan Eksekusi

1. Klarifikasi Temuan K-02 (arah jurnal) bersama tim akuntansi sebelum menjalankan TC-9.1.
2. Pastikan K-01 (topologi RabbitMQ) dan K-13 (tabel staging) memakai konfigurasi yang sama di produksi.
3. Tutup celah validasi `executeOpname()` baris 2204-2212 dan selaraskan format upload versus proses.
4. Verifikasi K-04, K-05, K-08, K-09, dan K-10 langsung ke codebase target.
5. Jalankan 20 test case prioritas High pada checklist UAT, khususnya area 9 (jurnal akuntansi) yang seluruhnya High.
6. Jalankan `php index.php CronTray generate_cache` setelah patch `COUNT(DISTINCT t.id)` agar badge tray konsisten.
7. Aktifkan `opname_use_rabbitmq` hanya setelah K-12 (komponen PPV) dipastikan terpelihara pada aturan jurnal worker.
