# Sintesis Modul Penjualan, Sales Order, dan Retur Everest ERP

## Pipeline Transaksi 5822, Status Pembayaran Revert SO, Retur 9822, Migrasi Laravel, dan Switch Pelaksana SPK

Dokumen ini adalah sintesis dari 12 berkas sumber pada folder `W:\_md_result\file_md_everest\` yang menyasar satu tema: bagaimana modul penjualan Everest ERP bekerja dari input Sales Order sampai retur, bagaimana status pembayaran direpresentasikan, dan bagaimana arsitekturnya akan dipindahkan dari CodeIgniter 3 menuju Laravel.

| Atribut | Nilai |
| :--- | :--- |
| Root code CI3 | `W:\everest_refaktor\` (juga dirujuk `z:\everest_refaktor\`, `z:\everest_11sept\`, `z:\everest_29agus\`, `z:\everest_17jul\`, `w:\everest_10agus\`) |
| Root target Laravel | `Y:\everest_re\Modules\` |
| Modul CI3 / Laravel | `application/modules/penjualan/` -> `Modules/Penjualan/app/` |
| Platform | PHP 5.6 + CodeIgniter 3.1.8 (HMVC) -> PHP 8.4 + Laravel 13 |
| Basis data | MySQL (CI3) -> PostgreSQL 16 (Laravel) |
| Standar kepatuhan | ISO 9001, ISO 27001, PSAK 14, PSAK 23, PSAK 72, IFRS, Coretax DJP, ISO/IEC 25010 |
| Dokumen sumber | 12 berkas, total 122.587 byte |
| Rentang tanggal sumber | 23 Juli 2026 s.d. 8 September 2026 |

---

## 1. Ringkasan Eksekutif

Lima benang merah merangkum seluruh 12 dokumen sumber:

1. **Pipeline penjualan CI3 sudah ter-dekomposisi secara konseptual.** Arus eksekusi follow-up `5822spo` -> `5822so` melewati 15 tahap yang dipetakan lengkap: guard validasi, hydrasi induk, kalkulasi DPP/PPN, pre-processor, counter, replacer, transaksi ACID, snapshot 49-key, mesin GL, alokasi payment source, post-processor, sinkron eksternal, lalu commit. Tanggung jawab dibagi dua: `ComSalesOrderFollowupService` (aturan bisnis) dan `ComTransactionPipelineEngine` (mesin keuangan, 993 baris).

2. **Bug status pembayaran adalah kebocoran filter, bukan masalah akuntansi.** Kasus customer THEDY (transaksi `5822spo.1.4905.10`) menampilkan badge LUNAS padahal tidak pernah membayar. Empat celah penyebabnya: kueri controller tidak membaca kolom `returned`, helper `fin_evaluate_payment_status()` hanya mengecek `sisa <= 0`, rantai transaksi tidak memfilter `trash_4 = 0`, dan `viewResumeDetails()` mengirim seluruh ID history termasuk faktur yang sudah reject. Mekanisme pengisian `returned` sendiri dinyatakan benar secara akuntansi dan tidak boleh diubah.

3. **Retur penjualan 9822 memiliki dua bug konkret yang belum ditutup.** Pertama, pemetaan data di `_processSelectNotaItem.php` baris 380 memanggil `$row->$src2` padahal atribut produk berada pada `$rows` (MdlProduk), sehingga SKU dan PRODUCT CODE bernilai 0 serta UOM `n/a`. Kedua, `parseAndApplyFilters()` di `ComItemQueryService.php` baris 153-171 tidak mengenal operator SQL `<>`, sehingga filter protektif `trash_4<>.1` terpotong menjadi `trash_4 < '>.1'` dan INVALID.

4. **Migrasi ke Laravel disepakati dengan pola DDD Pragmatis, bukan copy-paste.** Larangan eksplisit: jangan memindahkan 50+ model COM dan array konfigurasi 10.724 baris `coTransaksiCore.php` mentah ke Laravel. Yang dipindahkan adalah aturan bisnis murni yang diangkot ke Aggregate Roots, Pipes, Domain Services, dan Domain Events. Total 11 pipe pada alur pembuatan pesanan dan 3 pipe pada alur pengiriman, di atas `Illuminate\Pipeline\Pipeline` dengan DTO `SalesOrderContext`.

5. **Dua topik operasional terisolasi namun penting.** Modul penyerahan produk hadiah memakai pola 3 transaksi (penerima -> tagihan pajak -> penyerahan) dengan prinsip "paralel dalam keberadaan, serial dalam eksekusi", sedangkan switch pelaksana SPK memakai gate `progress_id = 3` plus fail-fast bila `terbayar > 0`. Keduanya punya matriks pembatalan berjenjang yang糟糕 jika diabaikan.

---

## 2. Pipeline Transaksi Penjualan (SO -> DO -> Invoice -> Retur)

### 2.1 Peta dokumen dan kode jenisTr

Kode `jenisTr` adalah kunci routing dan penentuan entitas hukum. Peta lengkap yang muncul di dokumen sumber:

| Kode | Nama Dokumen | Peran dalam Pipeline | Sumber |
| :--- | :--- | :--- | :--- |
| `5822spo` | Pre-Order Penjualan | Step 1; dokumen awal, bisa direvisi menjadi `5822spoe` | KONTEKS_STATUS_PEMBAYARAN_REVERT_SO |
| `5822so` | Sales Order | Step 2; nomor nota `5822so.1.16.2`, memotong `valid_qty` induk | SALES_ORDER_FLOWCHART |
| `5822pkd` | Pre-Packing | Step 3; persiapan kemas gudang | KONTEKS_STATUS_PEMBAYARAN_REVERT_SO |
| `5822spd` | Packing List / Surat Jalan | Step 4; memotong stok fisik, menerbitkan piutang | KONTEKS_STATUS_PEMBAYARAN_REVERT_SO |
| `5822spoe` | Revisi Pre-Order | Dokumen revisi, `trash_4 = 0` | KONTEKS_STATUS_PEMBAYARAN_REVERT_SO |
| `4822` | Invoicing / Faktur | Connector transaction, `jenis_master = '110'` | implementation_plan_invoice_items5 |
| `4822rj` | Retur Jurnal Penjualan | Membalik jurnal penjualan saat pembatalan | KONTEKS_STATUS_PEMBAYARAN_REVERT_SO |
| `5822sorj` | Retur Sales Order | Dokumen retur SO | KONTEKS_STATUS_PEMBAYARAN_REVERT_SO |
| `5822pkdrj` | Retur Pre-Packing | Dokumen retur packing | KONTEKS_STATUS_PEMBAYARAN_REVERT_SO |
| `9822` | Retur Penjualan (selector) | Step 1 `RETURN REQUEST`, target step `9822r` | transkrip_konteks_penjualan_dan_retur |
| `5823` | POS Kasir | Transaksi retail dengan pembayaran kasir | transkrip_konteks_penjualan_dan_retur |
| `4464` | Penerimaan Penjualan Tunai Kasir | Deteksi `$hasCashPayment` | KONTEKS_STATUS_VIEW_RESUME_PENJUALAN |
| `749` | A/R Receipt | Deteksi `$hasArPayment` | KONTEKS_STATUS_VIEW_RESUME_PENJUALAN |
| `1749`, `2749`, `7499` | Kode penerimaan lain | Harus ikut didukung agar lookup A/R tidak terlewat | optimasi_view_resume |
| `110` | Faktur / Invoice | `jenis_master = '110'` pada optimasi lookup faktur | optimasi_view_resume |
| `7499` | Penerimaan Project (termin) | Master yang spawn `4822` saat invoice terbit | implementation_plan_invoice_items5 |
| `3674` | Tagihan Biaya Subkon | Diterbitkan saat switch SPK ke vendor | SKENARIO_UAT_SWITCH_PELAKSANA_SPK |
| `9911` | Pembatalan Resmi | Contra journal pembalik utang vendor | SKENARIO_UAT_SWITCH_PELAKSANA_SPK |

Kode generik lain yang disebut sebagai pemakai counter: `582` (SO generik), `466` (PO), `334` (Kas), `663` (Mutasi).

### 2.2 Alur dokumen tekstual

```
[INPUT SPK/SPO]
     |
     v
5822spo  (Pre-Order, step 1) .........--> 5822spoe (revisi)
     |  otorisasi supervisor; state 'hold' bila masalah kredit/stok
     v
5822so   (Sales Order, step 2) ....... counter 5822so.1.16.2
     |  potong valid_qty pada transaksi_data induk; stok terkunci LockerStock
     v
5822pkd  (Pre-Packing, step 3) ...... gate check pembayaran kasir
     |
     v
5822spd  (Packing List / Surat Jalan, step 4) --> potong stok fisik
     |     publishes piutang dagang
     v
4822    (Faktur / Invoicing, jenis_master 110)
     |     post: 4822rj / 5822pkdrj / 5822sorj (cascade retur)
     +--> 749  A/R Receipt  (pelunasan piutang)
     +--> 4464 Penerimaan Tunai Kasir

RETRACT PATH (revert ke SO):
5822spd / 5822pkd / 5822so dibatalkan  ->  trash_4 = 1
     -> 4822rj, 5822pkdrj, 5822sorj terbit
     -> returned = tagihan pada payment_source
     -> dokumen baru 5822so (5822so.1.4905.12) menjadi dokumen aktif
```

### 2.3 Tabel status dan flag basis data

| Flag / Kolom | Nilai | Makna | Tabel |
| :--- | :--- | :--- | :--- |
| `trash` | `0` | Soft delete standar, dokumen masih hidup | `transaksi` |
| `trash` | `1` | Soft delete, dieliminasi dari rantai aktif | `transaksi` |
| `trash_4` | `0` | Dokumen valid, boleh masuk rantai aktif | `transaksi` |
| `trash_4` | `1` | Dokumen dibatalkan/reject oleh alur revisi | `transaksi` |
| `status` | `1` | Dokumen SO aktif pada kasus THEDY | `transaksi` |
| `status_edit` | `1` | Dokumen pernah diedit (baris kuning pada history) | `transaksi` |
| `status_4` | `3` | Status pembatalan pada tagihan 3674 yang dibatalkan | `transaksi` |
| `tagihan` | rupiah | Nilai piutang yang timbul | `transaksi_payment_source` |
| `terbayar` | rupiah | Uang masuk riil dari kasir / A/R | `transaksi_payment_source` |
| `returned` | rupiah | Nilai pembatalan; diisi penuh saat packing list dibatalkan | `transaksi_payment_source` |
| `sisa` | rupiah | Sisa piutang = `tagihan - terbayar - returned` | `transaksi_payment_source` |
| `dihapus` | `0` | Penanda record piutang tidak dihapus | `transaksi_payment_source` |
| `valid_qty` | desimal | Kuantitas valid; dipotong saat follow-up memproses item | `transaksi_data` |
| `link_id` | `0` | Transaksi master; `> 0` berarti child sign | `transaksi` |
| `id_top` / `id_master` | bigint | Silsilah rantai; dasar penelusuran `fin_get_payment_status` | `transaksi` |
| `ids_his` | blob | History tracking antar step, dibaca `History.php` | `transaksi` |
| `reference_id` / `reference_nomer` | - | Rujukan antar 7499 dan 4822 | `transaksi` |
| `cancel_dtime` / `cancel_name` | - | Waktu dan petugas pembatalan | `transaksi` |
| `dtime` | datetime | Waktu transaksi | `transaksi` |

### 2.4 Rantai transaksi kasus THEDY (referensi konkret)

Rantai ini menjadi basis kasus uji status pembayaran dan harus dipahami utuh:

| ID | Nomor | Jenis | `trash` | `trash_4` | Keterangan |
| :--- | :--- | :--- | :--: | :--: | :--- |
| 955840 | `5822spo.1.4905.10` | `5822spo` | 0 | 0 | Pre-Order awal, `status_edit = 1` (baris kuning) |
| 955858 | `5822so.1.4905.11` | `5822so` | 0 | 1 | SO awal, dibatalkan/reject |
| 956288 | `5822pkd.1.4905.10` | `5822pkd` | 0 | 1 | Pre-Packing, dibatalkan/reject |
| 956290 | `5822spd.1.4905.10` | `5822spd` | 0 | 1 | Packing List/Invoice, dibatalkan/reject |
| 956379 | `4822rj.1.4905.1` | `4822rj` | 0 | 1 | Retur jurnal penjualan |
| 956381 | `5822pkdrj.1.4905.1` | `5822pkdrj` | 0 | 1 | Retur pre-packing |
| 956397 | `5822sorj.1.4905.2` | `5822sorj` | 0 | 1 | Retur sales order |
| 956421 | `5822spoe.1.4905.5` | `5822spoe` | 0 | 0 | Dokumen revisi pre-order |
| 956442 | `5822so.1.4905.12` | `5822so` | 0 | 0 | **Dokumen operasional aktif saat ini**, `status = 1` |

Kartu piutang pada `transaksi_payment_source` untuk ID 956290: `tagihan = 44.400.000,00`, `terbayar = 0,00`, `returned = 44.400.000,00`, `sisa = 0,00`, `dihapus = 0`. Customer THEDY, Cabang Pinang.

---

## 3. Sales Order Flowchart

### 3.1 Route dan entry point

```
GET /penjualan/FollowUp/doFollowup/{jenisTr}/{refId}/{stepTarget}/{stepCurr}
  -> FollowUp.php
  -> ComSalesOrderFollowupService::processSalesOrderFollowup(...)
  -> ComTransactionPipelineEngine
  -> Database CI3
```

Bentuk respons sukses yang dikembalikan ke controller adalah array status terstandardisasi `[status: true, nomer: 5822so...]`, lalu controller me-render preview atau redirect.

### 3.2 Lima belas tahap eksekusi

| Fase | Tahap | Fungsi / kelas | Detail eksekusi |
| :--- | :--: | :--- | :--- |
| 1 | 1 | `validateFollowupGuards` | cek maintenance cabang; cek state transaksi locker, `state == 'hold'` --> tolak |
| 1 | 2 | `hydrateFollowupReferenceData` | load dokumen induk SPO; ambil metadata otorisasi / next step |
| 2 | 3 | `buildDynamicAccountTables` | mapping rekening perkiraan GL |
| 2 | 4 | `applyDppPembulatan` & `calcPricing` | subtotal, diskon, DPP, PPN; pembulatan standar akuntansi |
| 2 | 5 | `executeFollowupPreProcessors` | custom pre-processor; `he_value_builder` |
| 2 | 6 | `generateFollowupCounters` | CustomCounter -> `5822so.1.16.2`; Global Counter -> `5822so.20260817.1.16.2.22486` |
| 2 | 7 | Master Replacers & unpaid calc | array group `masterReplacers` dan `addValues`; hitung tagihan, terbayar, sisa |
| 3 | 8 | `writeMainEntries` | `INSERT INTO transaksi`; menghasilkan `$insertID` |
| 3 | 9 | `persistFollowupMasterAndSign` | `writeMainEntries_entryPoint`; `INSERT transaksi_sign`; `writeMainValues` (grand_total, tagihan, dpp, ppn); `writeMainFields`; `writeMainElements`; `ids_his` blob history per-step; `writeDueDate`; `indexing_main_values` |
| 3 | 10 | `persistFollowupDetailItems` | `INSERT transaksi_data`; `writeDetailValues` (`$insertID` & `$epID`); potong `valid_qty` pada item SPO induk; `INSERT items_child` & `items_child_seri`; update `indexing_details` & `indexing_detail_values` |
| 4 | 11 | 49-Key Data Registries Snapshot | `$tr->writeDataRegistries($insertID, $baseRegistries)`; freeze snapshot keranjang, layout receipt, dan config |
| 5 | 12a | `executeSubComponents` | komponen GL level rincian item |
| 5 | 12b | `executeMainComponents` | posting jurnal GL buku besar; double entry Debit = Kredit |
| 5 | 12c | `processPaymentSources` | alokasi `payment_source` multi-valas dan pajak; `payment_antiSource` & uang muka; rekaman `MdlTransaksiLaporan` |
| 5 | 12d | `executePostProcessors` | post-processor detail; post-processor sub_detail (LockerStock); post-processor master |
| 6 | 13 | `syncFollowupExternalServices` | `MdlLockerTransaksi::execLocker()`; validasi `CB_ID_PUSAT` via `cabangValidator`; replikasi cabang via `connectTo` |
| 6 | 14-15 | ACID commit | `trans_complete()`; validasi `trans_status()` --> sukses atau rollback otomatis |

### 3.3 Struktur 49-Key Immutable Data Registries

Snapshot di tabel registry membekukan kondisi utuh keranjang belanja dan layout saat transaksi disetujui. Daftar lengkap key (jumlah diverifikasi: 49):

`main`, `items`, `items2`, `items2_sum`, `itemSrc`, `itemSrc_sum`, `items3`, `items3_sum`, `items4`, `items4_sum`, `items5_sum`, `items6_sum`, `items6`, `items7`, `items7_sum`, `items8_sum`, `items9_sum`, `items10_sum`, `items_noapprove`, `rsltItems`, `rsltItems2`, `rsltItems3`, `tableIn_master`, `tableIn_detail`, `tableIn_detail2_sum`, `tableIn_detail_rsltItems`, `tableIn_detail_rsltItems2`, `tableIn_master_values`, `tableIn_detail_values`, `tableIn_detail_values_rsltItems`, `tableIn_detail_values_rsltItems2`, `tableIn_detail_values2_sum`, `main_add_values`, `main_add_fields`, `main_elements`, `main_inputs`, `main_inputs_orig`, `receiptDetailFields`, `receiptSumFields`, `receiptDetailFields2`, `receiptSumFields2`, `receiptDetailSrcFields`, `jurnal_index`, `preProcessor`, `postProcessor`, `revert`, `items_komposisi`, `componentsBuilder`, `jurnalItems`.

Delapan key terakhir tidak bersumber dari payload transaksi melainkan dari konfigurasi: `receiptDetailFields`, `receiptSumFields`, `receiptDetailFields2`, `receiptSumFields2`, dan `receiptDetailSrcFields` berasal dari `$customConfig['configLayout'][$jenisTr][...][$stepNumTarget]`; `jurnal_index`, `preProcessor`, `postProcessor` berasal dari `$customConfig['configCore'][$jenisTr][...][$stepCodeTarget]`.

### 3.4 Relasi entitas persistence

```
TRANSAKSI ||--o{ TRANSAKSI_DATA               : memiliki rincian barang
TRANSAKSI ||--o{ TRANSAKSI_SIGN               : log audit otorisasi
TRANSAKSI ||--o{ TRANSAKSI_REGISTRIES         : snapshot konfigurasi
TRANSAKSI ||--o{ PAYMENT_SOURCE               : alokasi tagihan/pajak
TRANSAKSI ||--o{ TRANSAKSI_LAPORAN            : mutasi laporan
TRANSAKSI_DATA ||--o{ TRANSAKSI_DATA_VALUES   : nilai item (harga, subtotal)
TRANSAKSI_DATA ||--o{ TRANSAKSI_DATA_CHILD    : sub-item racikan/komposisi
TRANSAKSI_DATA ||--o{ TRANSAKSI_DATA_CHILD_SERI : nomor seri
```

Kolom kunci `transaksi`: `id`, `id_master`, `id_top`, `nomer`, `nomer2`, `transaksi_jenis`, `transaksi_nilai`, `dtime`, `ids_his`, `indexing_main_values`, `indexing_details`, `indexing_detail_values`. Kolom kunci `transaksi_data`: `id`, `transaksi_id`, `produk_id`, `valid_qty`, `produk_ord_jml`, `produk_ord_hrg`, `sub_step_code`. Kolom kunci `payment_source`: `id`, `transaksi_id`, `jenis`, `target_jenis`, `tagihan`, `terbayar`, `sisa`, `dpp_ppn`, `ppn`.

### 3.5 Aturan kepatuhan pipeline

1. **ACID Transaction Guarantee** - seluruh mutasi keuangan dibungkus `trans_start()` / `trans_complete()`; kegagalan sub-komponen memicu rollback menyeluruh.
2. **Immutable Audit Trail** - dilarang `UPDATE`/`DELETE` pada mutasi buku besar; perubahan step dicatat append-only pada `transaksi_sign`, `ids_his`, dan snapshot `transaksi_registries`.
3. **Zero Inline Comments** - dokumentasi peran agen diisolasi pada docstring `/** [AGENT_LOG] ... [/AGENT_LOG] */` sebelum fungsi.

---

## 4. Migrasi Penjualan ke Laravel (arsitektur & konteks)

### 4.1 Kompas evolusi sistem

```
TAHAP 0: Controller-Centrik (Legacy As-Is CI3)
  Mega-controllers 4.500-22.000 baris, $_SESSION sprawl, transport DOM iframe
        |
        v
TAHAP 1: Service & Pipeline di CI3  -- SELESAI 100%
  Thin Controller, DTO eksplisit, Centralized Engines (Com*), Pipeline Engine,
  silsilah data (id_top, ids_prev, inv), AST balance = 0, Paritas 100% (z:\everest_29agus)
        |
        v
TAHAP 2: Migrasi ke Laravel 13 DDD Pragmatis  -- TOPIK DOKUMEN INI
  Aggregate Roots, Native Pipelines, Database Locks, JSONB Snapshots, Domain Events
```

### 4.2 Definisi DDD Pragmatis

Larangan keras: **dilarang** copy-paste mentah 50+ model COM dan array konfigurasi 10.724 baris `coTransaksiCore.php` ke Laravel. Itu adalah anti-pattern "membangun CI3 di dalam tubuh Laravel". Yang disepakati: ekstrak 100% aturan bisnis CI3 (rumus diskon, PPN Coretax floor, validasi stok, serial number, silsilah `id_top`), tampung di Aggregate Roots, Domain Services, Pipes, Form Requests, Domain Events, dan-learn Penjualan dilarang menulis langsung ke tabel jurnal GL atau mutasi stok fisik; komunikasi lewat Domain Events atau Service Contract.

### 4.3 Penempatan service menurut bounded context

| Service | Hakikat bisnis | Penempatan sah | Alasan |
| :--- | :--- | :--- | :--- |
| `NumberingCounterService` | Generator nomor nota atomik (`counters_custom_number`) | `Modules/Core` (Shared Kernel) | Dipakai 40+ modul transaksi (SO 582, PO 466, Kas 334, Mutasi 663); di Penjualan memicu inverted coupling |
| `StockEngine` | Saldo fisik gudang, booking, batas minus | `Modules/Inventory` (Supporting) | Otoritas mutlak fisikal; Penjualan hanya konsumen query via `StockAvailabilityInterface` |
| `SerialNumberValidator` | Status keberadaan nomor seri/IMEI di rak | `Modules/Inventory` (Supporting) | Serial number adalah unit inventaris; Penjualan hanya validasi status `AVAILABLE` |
| `SalesPricingEngine` | Matriks harga jual, diskon tier, PPN floor | `Modules/Penjualan` (Core) | Murni aturan komersial; tidak boleh dinamai generic "Pricing" agar rancu dengan Purchasing Cost |
| Jurnal Posting | Pembukuan berpasangan (GL, COA) | `Modules/Akuntansi` (Fase 7) | Modul operasional dilarang menyentuh tabel jurnal; Penjualan hanya memancarkan Domain Events |

Rujukan teori yang diadopsi: Eric Evans *Domain-Driven Design* Bab 14 (Shared Kernel, Anti-Corruption Layer); Vaughn Vernon Bab 2 (Core/Supporting/Generic Subdomain); standar SAP S/4HANA (SD vs MM-IM via ATP, penomoran di SAP Basis via NRIV); Odoo (`sale`/`purchase` bergantung `stock`, sequence di `base`); ISO/IEC 25010 sub-klausul 4.3.1 Modularity dan 4.3.2 Reusability.

### 4.4 Pemetaan alur multi-step 5822 ke entitas relasional

| Step | Kode | Entitas Laravel | Transisi status | Peran |
| :--- | :--- | :--- | :--- | :--- |
| 1 & 2 | `5822spo`, `5822so` | `SalesOrder` | `draft` -> `confirmed` | Aggregate Root pesanan |
| 3 & 4 | `5822pkd`, `5822spd` | `SalesDelivery` | - | Surat jalan, memotong stok fisik |
| Faktur | `4822` | `SalesInvoice` | - | Memunculkan piutang dagang dan faktur komersial/pajak |

### 4.5 Sebelas pipe pembuatan pesanan

```
 1. ValidateCustomerCreditPipe     cek plafon kredit & piutang macet
 2. ValidateStockAvailabilityPipe  query stok ke Modules/Inventory
 3. ExtractSerialNumbersPipe       validasi SN ke Modules/Inventory
 4. RecapitulateOrderValuesPipe    panggil TransactionValueBuilder::ns
 5. CalculatePricingAndTaxPipe     panggil SalesPricingEngine PPN Floor
 6. GenerateOrderNumberPipe        atomic lock di Modules/Core
 7. PersistSalesOrderPipe          simpan sales_orders & items dalam TX
 8. ApplyDownPaymentPipe           alokasi DP jika ada
 9. FreezeSnapshotJsonbPipe        simpan snapshot payload JSONB
10. BindSerialNumbersPipe          ikat nomor seri ke pesanan
11. DispatchDomainEventsPipe       lepas Event SalesOrderConfirmed
```

Tiga pipe pengiriman: `VerifyPaymentGatePipe` (kunci kasir tunai vs kredit), `DeductPhysicalStockPipe`, `PersistDeliveryOrderPipe`.

### 4.6 Struktur target di `Y:\everest_re\Modules\Penjualan`

```
Modules/Penjualan/app/
  Domain/
    Contexts/  SalesOrderContext.php (DTO input & lifecycle) | SalesDeliveryContext.php
    Models/    SalesOrder.php (AR pesanan) | SalesOrderItem.php | SalesDelivery.php (AR DO/SJ)
               SalesDeliveryItem.php | SalesInvoice.php (AR faktur) | SalesInvoiceItem.php
    Pipelines/
      Order/   ValidateCustomerCreditPipe.php | ValidateStockAvailabilityPipe.php
               ExtractSerialNumbersPipe.php | CalculatePricingAndTaxPipe.php
               GenerateOrderNumberPipe.php (Atomic Lock Counter) | PersistSalesOrderPipe.php
               FreezeSnapshotJsonbPipe.php
      Delivery/ VerifyPaymentGatePipe.php (kunci kasir tunai vs kredit)
               DeductPhysicalStockPipe.php | PersistDeliveryOrderPipe.php
    Services/  PricingEngine.php (diskon bertingkat + PPN 11% Coretax floor)
               StockEngine.php | SerialNumberValidator.php
               NumberingCounterService.php (paritas counters_custom_number + lock)
               SalesOrderService.php | SalesDeliveryService.php | SalesInvoiceService.php
  Events/      SalesOrderConfirmed.php | DeliveryDispatched.php (trigger auto invoice & tax standby)
               SalesInvoiceIssued.php
  Listeners/   AutoGenerateInvoiceListener.php | RegisterTaxStandbyListener.php
```

### 4.7 Konvensi porting `he_value_builder`

Fakta penting: `he_value_builder_helper.php` (7.053 baris) **bukan** domain pricing, melainkan Jembatan Rekapitulasi Transaksi Universal yang menghubungkan baris rincian (`items`, `items2`, `rsltItems`) dengan header master (`main`), dengan mengevaluasi ekspresi matematika melalui `he_value_maker_helper.php` fungsi `makeValue`.

Karena Laravel menghilangkan `$_SESSION` sepenuhnya dan menggantinya dengan DTO `SalesOrderContext`, **hanya** varian non-session yang dimigrasikan:

1. `resetValues_he_value_builder_ns($tr, $configCoreJenis, $sessionData)` - baris 4940
2. `fillValues_he_value_builder_ns($tr, $fromStep, $intoStep, $configCoreJenis, $configUiJenis, $configValuesJenis, $ppnFactor, $sessionData)` - baris 4956

Keduanya dienkapsulasi pada `Modules/Core/app/Domain/Services/TransactionValueBuilder.php`. Evaluator formula string diekstrak ke `Modules/Core/app/Domain/Services/ValueMakerService.php` (porting `makeValue` + `FieldCalculator`). Hasil: seluruh rumus rekapitulasi (Value Gates, Recap Items -> Main, Value Builders, Value Spreaders, TableIn mapping) berjalan in-memory tanpa session web browser.

### 4.8 Keputusan domain lain yang dibekukan

- **Counter:** struktur `counters_custom_number`, `counters_custom_content`, `counters_number` dipertahankan 100% tanpa mengubah tabel; format `base64_encode(serialize(...))` dipertahankan agar kompatibel bolak-balik; format `stepCode|placeID|customerID|dtime` menghasilkan string identik dengan CI3; pembacaan baris memakai `lockForUpdate()` di dalam `DB::transaction()` untuk mencegah nomor kembar saat lonjakan multi-kasir.
- **Otorisasi sebagian (SO confirmation):** sisa barang punya dua opsi -- Tutup Sisa (`qty_closed`, booking dilepas, tidak akan pernah dikirim) atau Outstanding/Backorder (`qty_outstanding`, masuk daftar kebutuhan restok).
- **Payment Gatekeeper sebelum packing:** penjualan tunai wajib sudah diterima kasir (proses kemas terkunci bila belum); penjualan kredit memvalidasi plafon dan piutang jatuh tempo.
- **Trigger faktur otomatis:** `SalesInvoice` ter-trigger saat barang dikeluarkan gudang, memenuhi PSAK 72 dan kesetaraan tanggal Faktur Komersial = Tanggal Pelepasan Kendali Barang = Tanggal Faktur Pajak Coretax.
- **Tax Standby:** retail B2C/POS standby sebagai Faktur Pajak Gunggung; grosir B2B standby sebagai Faktur Pajak Standar Coretax lengkap dengan NPWP/NIK 16 digit, alamat, DPP, dan PPN 11% pembulatan ke bawah (floor).
- **Partial delivery:** `sales_order_items` mencatat akumulasi `qty_terkirim`; 10 unit dikirim 6 unit -> status `partially_shipped`, sisa 4 unit tetap terbuka untuk Surat Jalan berikutnya.
- **State freeze:** kolom native JSONB PostgreSQL 16 pada header `sales_orders` dan `sales_invoices` membekukan harga satuan, nama produk saat transaksi, dan tarif PPN.

### 4.9 Definition of Done migrasi

1. **Zero Math Tolerance** - nilai akhir, DPP, PPN 11% Coretax wajib 0 rupiah selisih terhadap formula CI3.
2. **ACID Transaction Guaranteed** - seluruh penulisan dibungkus `DB::transaction()` dengan pessimistic locking pada nomor nota dan stok.
3. **Immutable Audit Trail** - setiap transaksi membekukan payload historis ke JSONB `snapshot_payload`.
4. **Decoupled Architecture** - Penjualan tanpa relasi atau penulisan langsung ke jurnal Akuntansi maupun mutasi stok fisik.

---

## 5. View Resume & Payment Revert

### 5.1 Peta komponen

| Komponen | Berkas | Fungsi / Baris | Peran |
| :--- | :--- | :--- | :--- |
| Modal Resume Controller | `application/modules/penjualan/controllers/Transaksi.php` | `viewResumeDetails()` ~ baris 8540-9300 | Menarik riwayat entry points, menghitung status pembayaran, me-render modal |
| Listing History Controller | `application/modules/penjualan/controllers/History.php` | `viewHistory__()` ~ baris 2850-3250 | Menampilkan kolom `status_bayar` pada daftar penjualan |
| SOT Finansial Helper | `application/helpers/he_finansial_helper.php` | `fin_get_payment_status()`, `fin_evaluate_payment_status()` | Single Source of Truth piutang dari `transaksi_payment_source` |

### 5.2 Alur pengumpulan data di `viewResumeDetails($masterID)`

```
viewResumeDetails($masterID)
   +--> lookupEntryPoints()    -> tabel transaksi via masterID ($trOrigIDs)
   +--> lookupSignatures()     -> tabel signatures
   +--> Query Kasir (4464)     -> penerimaan penjualan tunai kasir
   v
Filter Status Dokumen:
   - cek trash_4 == 1 (reject)
   - deteksi $hasInvoice      (spd/INV)
   - deteksi $hasPackingList  (pkd/spd)
   - deteksi $hasCashPayment  (kasir, jenis 4464)
   - deteksi $hasArPayment    (A/R Receipt)
   v
Kompilasi ID Transaksi ($searchIDs)
   v
fin_get_payment_status($searchIDs, 1000.0, true)
   v
Evaluasi status & pemilihan badge ($paymentBadge)
   v
Render header resume + tabel history entry points
```

### 5.3 Rumus dan logika status di `fin_evaluate_payment_status`

Rumus dasar: `Sisa = Tagihan - Terbayar - Returned`.

| Status | Syarat |
| :--- | :--- |
| `is_lunas` = true | `totTerbayar > 0` DAN `totTagihan > 0` DAN (`totSisa <= 0` ATAU `totSisa <= toleransi`) |
| `is_cicilan` = true | `totTerbayar > 0` DAN `totTagihan > 0` DAN `totSisa > toleransi` |
| `is_dp` = true | `totTerbayar > 0` DAN `totTagihan == 0` (DP saat masih tahap SO) |
| `is_batal` = true | `totReturned >= totTagihan` ATAU (`totReturned > 0` DAN `totSisa <= 0`) |
| `BELUM_LUNAS` | kondisi default lainnya |

Sanitasi rantai pada `fin_get_payment_status`: saat `$autoResolveChain = true`, helper menelusuri rantai via `id_top` dan `id_master`. Bila rantai terbukti punya dokumen aktif (`trash = 0 AND trash_4 = 0`), semua transaksi dengan `trash_4 = 1` atau `trash = 1` dieliminasi dari `$cleanIDs`. Namun bila user sengaja memeriksa dokumen batal murni (tanpa dokumen aktif di rantainya), ID tidak dibuang agar helper tetap dapat menetapkan status `BATAL`.

### 5.4 Matriks hierarki badge (urutan prioritas ketat)

| Prioritas | Kondisi | Badge | Makna |
| :--: | :--- | :--- | :--- |
| 1 | `is_lunas` & `$hasCashPayment` | `[hijau] LUNAS (Tunai Kasir)` | Lunas via kasir POS / penerimaan kas |
| 2 | `is_lunas` & `$hasArPayment` | `[hijau] LUNAS (Melalui A/R Receipt)` | Lunas via modul pelunasan piutang |
| 3 | `is_lunas` | `[hijau] LUNAS` | Lunas umum |
| 4 | `is_cicilan` | `[oranye] PELUNASAN SEBAGIAN (Terbayar: Rp ... / Sisa: Rp ...)` | Pembayaran parsial dengan faktur aktif |
| 5 | `is_batal` & `!$hasInvoice && !$hasPackingList` | `[kuning] BELUM MENERIMA PELUNASAN (Tahap Pesanan SO)` | **Kasus revert SO:** faktur lama batal, alur kembali ke SO aktif |
| 6 | `is_batal` (lainnya) | `[putih] BELUM MENERIMA PELUNASAN (Faktur Batal/Retur)` | Dokumen target memang dibatalkan |
| 7 | `jenisMasterTrans == '5823'` | `[kuning] BELUM MENERIMA PELUNASAN (Menunggu pembayaran Cash)` | Kasir POS belum dibayar |
| 8 | `$hasInvoice == true` | `[kuning] BELUM MENERIMA PELUNASAN (Invoice Belum Lunas)` | Faktur terbit, belum dilunasi |
| 9 | `$hasPackingList == true` | `[kuning] BELUM MENERIMA PELUNASAN (Barang Sudah Dikirim)` | Barang keluar, invoice belum terbit |
| 10 | tidak ada tagihan tapi ada uang masuk / `is_dp` | `[oranye] UANG MUKA / DP DITERIMA (Rp ...)` | DP di tahap SO |
| 11 | default operasional | `[kuning] BELUM MENERIMA PELUNASAN (Tahap Pesanan SO)` | Masih tahap Sales Order awal |

### 5.5 Empat celah dan perbaikannya

| # | Celah | Gejala | Perbaikan |
| :--: | :--- | :--- | :--- |
| 1 | Kueri controller buta terhadap kolom `returned` | `History.php` hanya `SELECT transaksi_id, tagihan, terbayar, sisa`; `sisa = 0` disimpulkan LUNAS | Ambil juga kolom `returned`, teruskan ke perhitungan status |
| 2 | Syarat pelunasan helper terlalu longgar | Kondisi lama `if ($totSisa <= 0.0 \|\| ($totTerbayar > 0.0 && $totSisa <= $tol))` | Diubah menjadi `if ($totTerbayar > 0.0 && ($totSisa <= 0.0 \|\| $totSisa <= $tol))`; kondisi `terbayar == 0 && sisa == 0` menetapkan status `BATAL` dengan badge `BATAL/RETUR` |
| 3 | Kueri rantai mengabaikan `trash_4` | Hanya `where("trash", 0)`; faktur mati 956290 tetap terhubung ke SO baru 956442 | Tambah `where("trash_4", 0)` pada `$chainTrans`, `$qChain`, dan `$qSiblings` |
| 4 | Modal resume mengirim seluruh riwayat | `$searchIDs = array(955840, 955858, 956288, 956290, 956442)` sehingga ID faktur reject ikut terkirim | Dokumen dengan `trash_4 == 1` atau terdaftar di `$epDetail` tidak lagi mengaktifkan `$hasInvoice`/`$hasPackingList`; teks `LUNAS (Melalui A/R Receipt)` hanya tampil bila `$hasArPayment == true` |

Hasil yang tercatat: baris `5822spo.1.4905.10` pada tabel histori berubah dari LUNAS menjadi BELUM LUNAS.

### 5.6 Penyempurnaan lanjutan `viewResumeDetails`

Filter `$searchIDs` hanya berisi ID aktif sebelum memanggil `fin_get_payment_status`:

```php
if (sizeof($searchIDs) > 0) {
    $qActiveIds = $this->db->select("id")->from("transaksi")
        ->where_in("id", $searchIDs)->where("trash", 0)->where("trash_4", 0)->get()->result();
    $cleanActiveSearchIDs = array();
    if (sizeof($qActiveIds) > 0) {
        foreach ($qActiveIds as $actRow) { $cleanActiveSearchIDs[] = intval($actRow->id); }
    }
    $searchIDs = $cleanActiveSearchIDs;
}
```

### 5.7 Sinkronisasi dengan `History.php`

1. Kueri `$chainTrans` memfilter `trash = 0 AND trash_4 = 0`.
2. Array `$activeChainIDs` dibentuk dari hasil kueri tersebut.
3. Saat membaca `ids_his`, nilai `trID` hanya dimasukkan bila ada di `$activeChainIDs`:

```php
if (in_array($trHistID, $activeChainIDs)) {
    $allPayTransIDs[] = $trHistID;
    $arrAllRowStepIDs[$hRow->id][] = $trHistID;
}
```

### 5.8 Optimasi performa viewResume (dari 25 detik)

**Titik 1 - N+1 query pada loop registry.** Sebelum: di dalam loop `$tmpEP` setiap baris dengan `deskripsi` non-kosong memanggil `$tr->lookupDataRegistriesByMasterID($row->link_id)->result()`. Sesudah: kumpulkan seluruh `link_id` ke `$batchLinkIds`, jalankan `array_unique`, lalu satu query CI3 Query Builder `select("transaksi_id, main")->from("transaksi_registry")->where_in("transaksi_id", $batchLinkIds)`. Hasilnya dipetakan ke `$registryMap[$transaksi_id]` di memori PHP dan dibaca `blobDecode($registryMap[$row->link_id]->main)` di dalam loop.

**Titik 2 - Query relasi A/R.** Diganti dari `lookupJoined_OLD()` yang melakukan `SELECT *` pada tabel `transaksi_data` (jutaan baris) dengan select projection 14 kolom (`transaksi_id`, `jenis`, `cabang_id`, `id_master`, `counters`, `step_number`, `jenis_master`, `cabang_nama`, `jenis_label`, `dtime`, `nomer`, `oleh_nama`, `deskripsi`, `link_id`), join `transaksi_data`, filter `transaksi.jenis IN ('749','1749','2749','7499')`, `transaksi_data.produk_id IN (...)`, serta `transaksi_data.trash = 0` dan `transaksi.trash = 0`.

**Titik 3 - Query relasi faktur.** Select projection 20 kolom (14 kolom sebelumnya ditambah `efaktur_dtime`, `efaktur`, `gunggungan_mode`, `trash_4`, `cancel_dtime`, `cancel_transaksi_nomer`, `cancel_name`), filter `transaksi.jenis_master = '110'`, `transaksi_data.produk_id IN (...)`, plus kedua filter trash.

**Pencegahan bug tambahan:** (a) `addFilter("transaksi_id in (...)")` berisiko gagal karena keterbatasan parser filter string internal model, solusinya Query Builder langsung dari controller; (b) duplikasi `link_id` antar entry point diatasi `array_unique`; (c) beban indeks dijaga lewat `where_in("transaksi_data.produk_id", ...)` agar tidak full table scan; (d) `viewResume()` pada modul `penerimaan` lambat karena filter `transaksi_no = '$no'` pada tabel `jurnal` yang millions baris tanpa indeks memadai, diubah ke `transaksi_id = '$transaksiID'` yang punya Foreign Key Index sehingga di bawah 10 ms dan total muat 1-2 detik.

### 5.9 Aturan tidak boleh dilanggar

- **Jangan pernah menghapus filter `trash_4 = 0`** - `trash = 1` adalah soft delete standar, `trash_4 = 1` adalah penanda dokumen dibatalkan/reject oleh alur revisi.
- **Jangan mengubah mekanisme pengisian `returned`** - pengisian `returned = tagihan` saat packing list/faktur dibatalkan adalah mekanisme baku agar kartu piutang tidak menagih piutang fiktif. Dilarang hard delete.
- **Multi-invoice** - satu SO dipecah menjadi beberapa packing list akan menghasilkan beberapa baris `transaksi_payment_source`; helper sudah mendukung penjumlahan multi-baris via `foreach ($paymentData as $item)`.
- **Refund DP** - bila transaksi di tahap SO yang sudah menerima DP dibatalkan total, modul kas/bank wajib mencatat pengurangan saldo kas agar tidak ada saldo mengambang.
- **Kompatibilitas PHP 5.6** - gunakan `array()`, `isset() ? :`, tanpa `??` dan tanpa short array syntax.

---

## 6. Retur Penjualan & UX Produk Hadiah

### 6.1 Audit selektor retur 9822

**Konteks tangkapan layar:** URL `demo.mayagrahakencana.com/everest_4sep/penjualan/Create/index/9822?gr=cGVuanVhbGFu`, pelanggan `VIVI ELECTRINDO`, Step 1 `RETURN REQUEST` dengan target `9822r`. Daftar dokumen menampilkan riwayat nota `5822SPD.1.17.1` (2024-01-10 09:17:34) sampai `5822SPD.1.17.9` (2024-02-06 09:55:03).

**Nilai pada keranjang belanja:** produk `PANASONIC CS/CU-YN12WKJ 1 outdoor 1 indoor`, qty 5 unit, harga satuan Rp 4.144.144,14, grand total Rp 22.750.000,25. **Anomali:** SKU = 0, PRODUCT CODE = 0, UOM = `n/a`.

**Konfigurasi `selectorFilters` untuk 9822 di `coTransaksiUi.php`:**

```php
"selectorFilters" => array(
    "returned=.0", "jenis=.5822spd", "customers_id=pihakID",
    "trash_4<>.1",   // proteksi agar nota yang direject tidak muncul
    "cabang_id=placeID",
),
```

**Akar masalah 1 - pemetaan data di `_processSelectNotaItem.php` baris 380:**

```php
foreach ($fieldSrcs as $key2 => $src2) {
    if (is_array($src2) && sizeof($src2) > 0) { /* ... */ }
    else { $tmp[$key2] = makeValue($src2, $tmp, $tmp, $row->$src2); }  // BUG DI SINI
}
```

`$row` adalah objek dari `MdlNotaItem` (`transaksi` JOIN `transaksi_data`) yang **tidak punya** kolom `kode`, `barcode`, maupun `satuan`. Atribut produk sebenarnya ada pada `$rows` dari `MdlProduk` yang dimuat di baris 201-206 (`$tmpBD = $bd->lookupByID($id)->result(); $rows = $tmpBD[0];`). Karena kode memanggil `$row->$src2`, nilai properti `null` dan `makeValue()` fallback ke `0`. Rencana perbaikan pada baris 379-382:

```php
$valSource = isset($rows->$src2) ? $rows->$src2 : (isset($row->$src2) ? $row->$src2 : 0);
$tmp[$key2] = makeValue($src2, $tmp, $tmp, $valSource);
```

**Akar masalah 2 - parser operator `<>` di `ComItemQueryService.php` baris 153-171.** Fungsi `parseAndApplyFilters()` hanya mengenali `>=`, `<=`, `!=`, `>`, `<`, `=`. Ekspresi `"trash_4<>.1"` mengandung tanda `<` sehingga dicocokkan sebagai operator `<`, menghasilkan `$column = 'trash_4'`, `$operator = '<'`, `$valExpr = '>.1'`, dan query SQL tidak valid `trash_4 < '>.1'`. Perbaikan: tambahkan deteksi `<>` di urutan teratas sebelum pemeriksaan `<` dan `>`.

**Akar masalah 3 - disonansi label selektor.** `"selectorLabel" => "item"` padahal pengguna sebenarnya memilih Nomor Dokumen Surat Pengantar/Shipment `5822SPD`. Rekomendasi backlog: ubah menjadi `"delivery note"` atau `"nota pengiriman"`, dan evaluasi filter batas umur nota (misal 30-90 hari terakhir) untuk mencegah penarikan faktur lampau tanpa otorisasi manajerial.

### 6.2 Risiko kepatuhan pada retur lintas tahun

1. **Perpajakan** - PMK No. 65/PMK.03/2010 jo. PER-03/PJ/2022 dan UU HPP. Nota asal bertanggal Januari 2024 sudah dilaporkan pada SPT Masa PPN 2024 dan SPT Tahunan Badan 2024 yang sudah ditutup. Retur lintas tahun tanpa validasi cut-off berisiko SP2DK dan penolakan sinkronisasi faktur retur di Coretax DJP.
2. **Akuntansi persediaan** - PSAK 14 / IAS 2. Mengakui retur 5 unit AC Panasonic ke persediaan dengan nilai historis penuh Rp 22,75 juta tanpa evaluasi kondisi fisik dan allowance for inventory write-down berisiko overstated assets.
3. **Operasional fisik** - karena SKU bernilai 0 dan serial number tidak terkunci, unit AC split berisiko diterima tidak lengkap atau tertukar seri fisiknya.

### 6.3 Validasi stok minus dan aturan Takeaway

**Stok minus.** Gejala: saat item keranjang mengalami stok minus pada transaksi tunai (`5822` atau `5823`), tombol simpan `disabled`, tetapi checkbox `#tic_lanjut` ("Tic untuk menyimpan/melanjutkan proses") tetap dapat dicentang sehingga tombol submit aktif kembali dan stok minus lolos. Akar masalah: `_shoppingCart.php` fungsi `customerInfo()` yang dipanggil via AJAX merender ulang footer form dan menghapus atribut `disabled` dari `#tic_lanjut` tanpa memeriksa variabel global `hasStockMinus`; tidak ada early validation di level domain service.

Solusi yang diterapkan: (1) frontend pada `transaksi.html` dan `transaksi_pos.html` menambahkan pengecekan `window.hasStockMinus` atau `top.hasStockMinus`; bila terdeteksi stok minus, `#tic_lanjut` dipaksa `disabled = true` dan `checked = false`. (2) backend `ComSalesOrderValidationService.php` mengintegrasikan `ComStockEngine` untuk mengevaluasi `shoppingCartStokKurang` sebelum disimpan; transaksi ditolak di backend bila kuantitas melebihi saldo fisik riil dikurangi booking locker (Mandatory Rule #4 Anti-Overselling).

**Takeaway.** Gejala: memilih metode pengiriman Takeaway (Ambil Sendiri, opsi 2) tetap memunculkan popup pemblokir "Detail Pengiriman wajib dipilih!". Akar masalah: di `coTransaksiUi.php` pada transaksi `5822` (baris ~2422) dan `5823` (baris ~11054), array pilihan `shippingMethod` indeks `2` mengikutsertakan `deliveryDetails` dalam sub-elemen wajib. Solusi: hapus referensi `deliveryDetails` dari sub-elemen opsi `2` untuk kedua transaksi. Keempat berkas tervalidasi dengan `php -l`.

### 6.4 Arsitektur 3 transaksi modul penyerahan produk hadiah

Konteks: perusahaan memberi hadiah berupa barang fisik berdasarkan KPI non-bisnis; sebelum diserahkan, penerima wajib melunasi tagihan pajak yang dipungut perusahaan.

```
                  (a) Penentuan Penerima Hadiah   <- titik referensi tunggal
                          [Modul Mandiri]
                         /            \
              referensi/              \referensi
               v                      v
   (b) Tagihan Pajak            (c) Penyerahan Hadiah
       [Modul Piutang]             [modul distribusi]
                |                        ^
                |   HARUS LUNAS DULU      |
                +------------------------+
```

Prinsipnya: **paralel dalam keberadaan, serial dalam eksekusi.** Ketiga transaksi dibuat bersamaan namun eksekusi berurutan. Tiga alasan pemisahan: jeda waktu nyata (customer butuh berhari-hari), modul berbeda, dan referensi bersih (semua merujuk ke (a), tidak circular). Proteksi yang sudah ada: teks italic di kolom Action, tombol `disabled` saat pajak belum bayar, gate check server-side real-time ke modul piutang sebelum proses distribusi, dan anti double-processing via `ComLockerTransaksi`.

### 6.5 Matriks pembatalan produk hadiah

| Tahap saat batal | (a) Penentuan | (b) Tagihan Pajak | (c) Penyerahan | Kompleksitas |
| :--- | :--- | :--- | :--- | :--- |
| Baru (a) dibuat | Cancel | Cancel (belum dikirim) | Cancel (belum jalan) | Rendah |
| (b) terbit, belum dibayar | Cancel | Cancel tagihan | Cancel (gate check blokir) | Rendah |
| (b) pajak sudah LUNAS | Cancel | Perlu transaksi pengembalian pajak | Cancel (belum jalan) | Sedang |
| (c) hadiah sudah diserahkan | Cancel | Pengembalian pajak | Retur barang ke stok | Tinggi |

Aturan: pembatalan selalu dimulai dari (a) dan cascade ke (b) dan (c); bila (b) sudah lunas wajib buat transaksi pengembalian pajak; bila (c) sudah selesai wajib proses retur barang ke gudang via modul penerimaan.

### 6.6 Lima perbaikan UX produk hadiah

| # | Perbaikan | Prioritas | Effort | Detail teknis |
| :--: | :--- | :--- | :--- | :--- |
| 1 | Badge warna status pajak | Tinggi | Rendah | `.badge-pajak-belum` background `#e74c3c`; `.badge-pajak-lunas` background `#27ae60`; teks putih, `font-weight: bold`, `font-size: 11px`, `padding: 2px 8px`, `border-radius: 3px`, `display: inline-block` |
| 2 | Pindah info pajak dari kolom Action ke kolom Status | Tinggi | Rendah | Staff terbiasa membaca kolom Action sebagai tempat klik; badge dipindah ke kolom Status dengan Next Step "Menunggu Pelunasan Pajak" |
| 3 | Progress bar 3 langkah | Sedang | Sedang | `1 REQUEST HADIAH -> 2 PELUNASAN PAJAK -> 3 PENYERAHAN HADIAH`; hijau `#27ae60` selesai, kuning `#f39c12` menunggu, abu-abu `#95a5a6` terkunci |
| 4 | Tooltip pada tombol disabled | Sedang | Rendah | `title="Tidak bisa memproses penyerahan - Pajak belum dilunasi"` dengan `cursor: not-allowed; opacity: 0.5` |
| 5 | Info tagihan di kolom Keterangan | Rendah | Sedang | Tampilkan `Pajak: Rp 500.000`, `Status: Belum Lunas`, `Jatuh Tempo: 30 Jul 2025` |

Rekomendasi eksekusi: kerjakan #1 dan #2 lebih dahulu karena effort rendah dan dampak paling besar. Catatan teknis: PHP 5.6 + CodeIgniter 3.1.8 (HMVC), vanilla CSS tanpa dependency tambahan, layout tabel di `coTransaksiLayout.php`, gate check berupa validasi status pajak di awal proses `FollowUp`, controller penyerahan hadiah di `application/modules/[modul_hadiah]/controllers/`.

---

## 7. Switch Pelaksana SPK & Skenario UAT

### 7.1 Ruang lingkup

Cakupan UAT: Master Proyek (`master_project`), Biaya Subkon (`AutoPostingBiaya`), Pembatalan Resmi (`9911`), serta Kasir & Pembayaran. Metode Golden Circle (WHY-HOW-WHAT) plus matriks 5W+1H, versi dokumen 3.0.

### 7.2 Mekanisme kontrol

1. **Early Validation Engine** - membaca `progress_id` di `project_tasklist`. `progress_id = 3` (Sudah QC) mengaktifkan protokol finansial; `progress_id != 3` (Belum QC) hanya memperbarui entitas pelaksana.
2. **Strict Cashier Lock** - sebelum tagihan lama dibatalkan, sistem memeriksa kolom `terbayar` pada `transaksi_payment_source`. Bila `terbayar > 0`, eksekusi fail-fast exit dengan respons JSON `status: 0`.
3. **Pembalikan resmi buku besar** - pembatalan tidak dilakukan dengan hard delete, melainkan menerbitkan dokumen `9911` yang membuat contra journal untuk menolkan saldo utang vendor.
4. **Automated Posting Engine** - bila SPK Sudah QC dialihkan ke vendor, sistem memanggil `AutoPostingBiaya::post` dengan kode transaksi `3674`, memetakan rincian komponen biaya jasa dari master komposisi SPK.

### 7.3 Rantai pengujian

Internal (`Nurul`) -> External (`AGRES INFO TEKNOLOGI`) -> External (`AGUS SULAIMAN EFFENDI`) -> Internal (`Nurman`).

**Kondisi A - SPK SUDAH QC (dampak buku besar):**

| # | Skenario | Ekspektasi sistem |
| :--: | :--- | :--- |
| 1 | Internal (Nurul) -> External (AGRES) | `type_pelaksana` = `22`, `employee_nama` = `AGRES INFO TEKNOLOGI`; terbit transaksi `3674` atas nama AGRES; jurnal Debet Beban Subkon Proyek / Kredit Utang Usaha Vendor; `post_biaya_id` terisi ID `3674` |
| 2 | External (AGRES) -> External (AGUS) | Jalur negatif: bila `terbayar > 0`, tolak dengan pesan "Pergantian ke Vendor Baru ditolak! Tagihan vendor sebelumnya (AGRES) sudah dibayarkan oleh kasir..." Jalur normal: terbit `9911` merujuk tagihan AGRES, contra journal pembalik, transaksi `3674` AGRES ditandai `trash_4 = 1` dan `status_4 = 3`, terbit `3674` baru atas nama AGUS SULAIMAN, `post_biaya_id` berganti |
| 3 | External (AGUS) -> Internal (Nurman) | Jalur negatif bila `terbayar > 0` (tagihan AGUS). Jalur normal: `9911` terbit, jurnal utang AGUS menjadi saldo Rp 0, `type_pelaksana` = `11`, `employee_nama` = `Nurman`, `post_biaya_id` di-reset ke 0, TIDAK ADA tagihan `3674` baru |

**Kondisi B - SPK BELUM QC (administratif penugasan):**

| # | Skenario | Ekspektasi sistem |
| :--: | :--- | :--- |
| 1 | Internal (Nurul) -> External (AGRES) | `type_pelaksana` = `22`; tidak ada `3674` maupun `9911` |
| 2 | External (AGRES) -> External (AGUS) | Pelaksana langsung berganti; tidak ada `9911`; AGRES bersih tanpa jejak utang |
| 3 | External (AGUS) -> Internal (Nurman) + QC Pass | `type_pelaksana` = `11`; saat tombol QC Pass ditekan, `progress_id` = `3`; sistem mendeteksi `type_pelaksana = 11` sehingga `AutoPostingBiaya` TIDAK memposting `3674` |

### 7.4 Panduan audit database

| Parameter kunci | Tabel target | Kriteria pass |
| :--- | :--- | :--- |
| Identitas pelaksana SPK | `project_tasklist` | `type_pelaksana` = `11` (Karyawan) atau `22` (Vendor); `employee_nama` sesuai aktor aktif |
| Penerbitan tagihan | `transaksi` | Baris baru saat switch ke vendor dengan `jenis = '3674'`, `referensi_nomer` = no SPK, `trash_4 = 0` |
| Pembatalan tagihan | `transaksi` | Baris baru `jenis = '9911'`, `referensi_id` = ID `3674` lama, `keterangan` memuat alasan alih pelaksana |
| Pengembalian jurnal | `jurnal` | Baris `9911` memiliki posisi debit dan kredit yang membalik persis saldo tagihan `3674` lama |
| Proteksi kasir | `transaksi_payment_source` | Bila `terbayar > 0` query blokir berjalan; bila batal resmi, `sisa = 0`, `lunas = 0`, terisi `cancel_dtime` dan `cancel_name` |
| Audit trail | `project_tasklist_log` | Setiap perubahan tercatat dengan `type = 'SWITCH_PELAKSANA'` memuat nama pelaksana lama dan baru |

### 7.5 Lembar checklist UAT

| No | Kode | Deskripsi | Hasil |
| :--: | :--- | :--- | :--- |
| 1 | `UAT-QC-S1` | Sudah QC: Nurul -> AGRES, terbit tagihan 3674 | Pass |
| 2 | `UAT-QC-S2` | Sudah QC: AGRES -> AGUS, batal 9911 dan terbit 3674 baru | Pass |
| 3 | `UAT-QC-S2-NEG` | Sudah QC: tolak ganti vendor bila tagihan AGRES sudah dibayar kasir | Pass |
| 4 | `UAT-QC-S3` | Sudah QC: AGUS -> Nurman, batal 9911 dan nihil tagihan | Pass |
| 5 | `UAT-QC-S3-NEG` | Sudah QC: tolak alih ke internal bila tagihan AGUS sudah dibayar kasir | Pass |
| 6 | `UAT-NOQC-S1` | Belum QC: Nurul -> AGRES, update administratif saja | Pass |
| 7 | `UAT-NOQC-S2` | Belum QC: AGRES -> AGUS, update administratif saja | Pass |
| 8 | `UAT-NOQC-S3` | Belum QC: AGUS -> Nurman plus verifikasi lulus QC tanpa tagihan | Pass |

Sign-off memerlukan tiga pihak: Project Manager, Lead QA/QC Proyek, dan Finance & Accounting.

---

## 8. Invoice Items & Pemulihan Sum

### 8.1 Ruang lingkup dan temuan data

Tool diagnostik untuk invoice `transaksi_jenis = '4822'` yang diterbitkan dari modul `PenerimaanProject`. Saat `7499` (termin proyek) terbit, ia otomatis menerbitkan `4822` sebagai connector transaction. Keduanya menyimpan `items5_sum` di `transaksi_data_registry`, dan keduanya kosong pada 189 invoice. Target utama adalah `4822`; `7499` diperbaiki bersamaan (dual-sync).

| Metrik (database `run_everest_modul`) | Nilai |
| :--- | ---: |
| Total invoice `7499` (`link_id = 0`, `trash = 0`, nilai > 0) | 344 |
| Total `4822` terhubung ke `7499` via `reference_id` | 344 |
| **4822 dengan `items5_sum` kosong** | **189** |
| 4822 dengan `items5_sum` terisi | 155 |

Rantai transaksi: `7499` (`link_id = 0` master, `link_id > 0` child sign) --spawns--> `4822` (`reference_id = 7499.id`, `reference_nomer = 7499.nomer`).

### 8.2 Akar masalah dan dampak

- Saat `Create.php` menyimpan `7499`, `items5_sum` kosong karena user tidak mencentang Work Order di `selectWorkOrder()` atau validasi belum diterapkan.
- Baris 3790 menyalin `items5_sum` dari sesi `7499` ke sesi `4822`; jika sumber kosong, hasilnya juga kosong.
- Dampak: cetakan invoice `4822` kosong karena tabel rincian pekerjaan tidak muncul; `project_tasklist` tetap `debet = 0`, `sisa` penuh, `invoiced` kosong seolah proyek belum pernah ditagih; rekonsiliasi audit antara invoice kasir dan progres fisik lapangan tidak terhubung.

### 8.3 Komponen tool di `Tool.php`

Lokasi: `application/controllers/Tool.php`. Method baru: `repairInvoiceItems5SumProject()` (estimasi 600-800 baris). Pendaftaran menu di `Tool::index()` dengan label `"perbaikan invoice 4822 invoicing (items5_sum kosong)"`.

Alur kerja: scan seluruh `4822` yang terhubung ke `7499` -> cek `items5_sum` kosong -> trace `reference_id` ke `7499` -> decode `registry.main` 7499 untuk memperoleh `projectID` -> query `project_tasklist WHERE produk_id = projectID` -> jumlah task menentukan jalur: 1 task atau multi-task exact match berarti auto-fix rekonstruksi; multi-task tanpa match berarti pemilihan manual via UI. Setelah itu write `items5_sum` ke registry `4822`, registry `7499`, child sign `4822` dan `7499`, lalu update `project_tasklist`: `debet`, `sisa`, `invoiced`, `inv_trx_id`.

**Executive KPI Cards:** total invoice `4822` terhubung `7499`, total anomali (`items5_sum` kosong dan nilai > 0), total nominal terdampak, invoice siap auto-fix, invoice sudah normal.

**Tabel diagnostik (10 kolom):** ID 4822, No. 4822, ID 7499, No. 7499, Customer, Proyek, Nilai Invoice (DPP), Status `items5_sum` 4822 (badge `KOSONG` merah atau `TERISI (N task)` hijau), Status `items5_sum` 7499, Tasklist Info (jumlah task + nilai total + match indicator), Aksi.

**Tombol aksi:** `[Perbaiki 1-Click]` (single task atau exact match, langsung rekonstruksi ke 4822 + 7499 + child signs + project_tasklist), `[Pilih Task Manual]` (modal interaktif multi-task), `[Cek Print 4822]` (link ke `invoicing/Printing/cetakNota/{id_4822}`), `[Cek Print 7499]` (link ke `penerimaanprojek/Printing/cetakNota/{id_7499}`), serta `[Perbaiki Semua Auto-Fix Sekaligus]` untuk batch operation dalam satu siklus DB aman.

### 8.4 Struktur data `items5_sum`

```php
$items5_sum[$task->id] = array(
    'id' => $task->id, 'no_spk' => $task->no_spk, 'nama' => $task->nama,
    'produk_id' => $task->produk_id, 'produk_nama' => $task->produk_nama,
    'nilai_sub_fase' => $task->nilai_sub_fase, 'persen_sub' => $task->persen_sub,
    'debet' => $nominalBilled, 'sisa' => max(0, $task->nilai_sub_fase - $nominalBilled),
    'invoiced' => $invoiceNomer, 'inv_trx_id' => $invoiceId, 'inv_dtime' => $invoiceDtime,
    'bahan_baku' => $arrBahanBaku, 'kelebihan' => $arrKelebihan,
    'customerID' => $invoiceCustomerId, 'customerName' => $invoiceCustomerName,
    'jenisTr' => '7499',
);
```

**Lima titik penulisan (dual-sync):** (1) `transaksi_data_registry.items5_sum` untuk `4822` master (`link_id = 0`) sebagai **PRIMARY TARGET**; (2) untuk `4822` child (`link_id = master4822ID`); (3) untuk `7499` master (`link_id = 0`); (4) untuk `7499` child (`link_id = master7499ID`); (5) `project_tasklist` - update `debet`, `sisa`, `invoiced`, `inv_trx_id`.

**Logika pencocokan task ke invoice:**

| Skenario | Kondisi | Aksi |
| :--- | :--- | :--- |
| Single Task | Proyek hanya punya 1 task di `project_tasklist` | Auto-fix, alokasikan seluruh nilai invoice ke task tersebut |
| Exact Match | Proyek punya >= 1 task, salah satu `nilai_sub_fase` = `transaksi_nilai` | Auto-fix ke task yang match |
| Multi Task No Match | Lebih dari 1 task dan tidak ada exact match | Butuh pemilihan manual via UI |

**Keamanan dan pengujian:** setiap perbaikan dibungkus `trans_start()` / `trans_complete()` dengan CI3 Query Builder dan parameter binding; sintaks PHP 5.6 (`array()`, tanpa `[]`, `??`, atau spread operator); uji nyata pada sampel `4822.1.171.87 / Project 300` dan `4822.1.171.85 / Project 292`, lalu verifikasi cetakan nota 4822 dan 7499 serta isi `project_tasklist`.

---

## 9. Roadmap Modul Penjualan

### 9.1 Anatomi masalah saat ini

```
application/modules/penjualan/controllers/
  _shoppingCart.php           4.500+ baris  hitung stok, diskon, render HTML, validasi sesi (tumpang tindih)
  _processSelectProduct.php     700+ baris  cek harga, hold locker, hitung booking (duplikasi rumus)
  _selectorItem.php             600+ baris  query stok modal picker (duplikasi rumus)
  _processPihakMain.php         800+ baris  pemilihan DC vs Cabang (magic strings 'pusat'/'center')
  Create.php                  22.500+ baris  simpan draf, validasi, posting transaksi, JSON blob parser
  FollowUp.php                12.000+ baris  approval alur SPO -> SO -> PKD -> SPD -> Invoice
  Transaksi.php               14.000+ baris  query list transaksi, filter link_id = 0
```

Target: menurunkan kompleksitas controller dari 22.000 baris menjadi thin controllers terisolasi dengan MTTR < 15 menit, metode Strangler Fig Pattern.

### 9.2 Lima fase roadmap

| Fase | Fokus | Rentang | Status |
| :--: | :--- | :--- | :--- |
| 1 | Integrasi `ComStockEngine` (keranjang & selector) | 2026-08-16 s.d. 2026-08-20 | done |
| 2 | Sentralisasi `ComPricingEngine` (diskon & pajak) | 2026-08-21 s.d. 2026-08-26 | active |
| 3 | Standarisasi Customer & Gudang (Party Service) | 2026-08-27 s.d. 2026-08-31 | rencana |
| 4 | Dekomposisi `Create.php` & `FollowUp.php` | 2026-09-01 s.d. 2026-09-10 | rencana |
| 5 | Modernisasi UI Transport (Iframe to JSON API) | 2026-09-11 s.d. 2026-09-18 | rencana |

**Fase 1 - `ComStockEngine`.** Refactor `_shoppingCart.php` mengganti kalkulasi manual `($stokFisik - $stok_booking) - $itemJml` dengan `$this->ComStockEngine->getStockStatus()`; `_processSelectProduct.php` diarahkan membaca antrean booking dan hold stok ke `ComStockEngine`; `_selectorItem.php` mengarahkan badge stok di pop-up modal pencarian produk ke `ComStockEngine`. Hasil: tidak ada perbedaan angka antara Laporan Stok, Modal Selector, dan Keranjang Belanja; masalah switching stok Cabang vs DC tuntas di jenis penjualan `582`, `5822`, `5823`, `583`, `585`.

**Fase 2 - `ComPricingEngine`.** Membangun `application/models/Coms/ComPricingEngine.php`, mengintegrasikan matrix harga (Customer Price, Reseller Price, Project Price) dan kalkulasi diskon bertingkat (Diskon 1 + Diskon 2 + Diskon Tambahan), menjamin kalkulasi DPP dan PPN 11% presisi 0 rupiah sesuai regulasi Coretax DJP.

**Fase 3 - `ComPartyWarehouseService`.** Membangun `application/models/Coms/ComPartyWarehouseService.php`, membakukan penentuan gudang pengirim dengan konstanta `WH_STATUS_PUSAT_ID` (12) dan `WH_STATUS_CABANG_ID` (13), dan mengunci konsistensi array sesi `$_SESSION[$cCode]['main']` serta `main_elements` agar tidak hilang saat transisi antar-halaman. Hasil: tidak ada silent bug akibat variasi string `pusat`, `center`, `dc`.

**Fase 4 - `ComSalesOrderService`.** Membangun `application/models/Coms/ComSalesOrderService.php` dan memisahkan alur menjadi sub-fungsi mandiri: `validateOrder(CartDTO $cart)`, `reserveStockLocker(CartDTO $cart)`, `persistTransactionHeader(TransactionDTO $trx)`, `persistTransactionItems(array $items)`, `triggerAutoJournal(TransactionDTO $trx)`. `Create.php` dan `FollowUp.php` menjadi router pendek (< 200 baris).

**Fase 5 - Transport UI.** Mengubah submit tombol dari eksekusi iframe ke Fetch/AJAX dengan respons JSON terstruktur `{ "status": "success", "transaction_id": 15822, "nomer": "5822spo.1.10.123", "redirect_url": "/penjualan/FollowUp/index/5822/..." }`, serta memasang logging trace eksekusi transaksi penjualan untuk deteksi error instan (< 5 menit).

### 9.3 Tiga gerbang kualitas

1. **Automated Unit Regression Test** - seluruh perhitungan angka wajib 100% lolos toleransi 0 rupiah / 0 unit selisih.
2. **ACID Transaction Integrity** - kueri mutasi tetap dilindungi `trans_start()` dan `trans_complete()`.
3. **Defensive Programming Check** - kompatibel 100% dengan PHP 5.6 (`array()`, `isset()`), bebas undefined property/index warnings.

---

## 10. Temuan Lintas-Dokumen & Kontradiksi

### 10.1 Kontradiksi penamaan

| Aspek | Varian A | Varian B | Catatan |
| :--- | :--- | :--- | :--- |
| Tabel registry snapshot | `transaksi_registries` (SALES_ORDER_FLOWCHART) | `transaksi_registry` (optimasi_view_resume) | Salah satu atau keduanya bentuk legacy; optimasi memakai nama jamak dalam bentuk tunggal |
| Tabel payment source | `payment_source` (diagram flowchart) | `transaksi_payment_source` (konteks revert, UAT SPK) | Query production yang dirujuk kode adalah `transaksi_payment_source` |
| Tabel registry items5_sum | `transaksi_data_registry` (implementation plan) | `transaksi_registries` / `transaksi_registry` | Butuh konfirmasi nama fisik sebelum menulis tool |
| Pricing engine | `ComPricingEngine.php` (roadmap CI3) | `SalesPricingEngine.php` (sesi 2 Laravel) vs `PricingEngine.php` (struktur folder) | Sesi 2 menolak nama generic "Pricing"; struktur folder masih memakainya |
| Stock engine | `ComStockEngine.php` (CI3) dan `StockEngine.php` di `Modules/Penjualan/app/Domain/Services` (transkrip Laravel) | Wajib `Modules/Inventory` + `StockAvailabilityInterface` (sesi 2) | Struktur folder bertentangan dengan keputusan bounded context |
| Service follow-up | `ComSalesOrderFollowupService` (CI3) | `SalesOrderFollowupService` (Milestone 2 Laravel) | Pola prefix `Com` hilang pada naming Laravel, perlu konvensi final |
| Baris Create.php | "22.000 baris" (target utama) | "22.500+ baris" (anatomi masalah) | Selisih 500 baris; angka 22.500 lebih konsisten dengan anatomi |

### 10.2 Kontradiksi dan ketidakkonsistenan faktual

1. **Jumlah pipeline.** `transkrip_arsitektur_migrasi_penjualan_sesi_2` menulis judul "Transformasi 7 Tahapan Pipeline", tetapi diagram menampilkan 11 pipe pembuatan pesanan dan 3 pipe pengiriman. Folder target juga hanya memuat 7 file pipe Order dan 3 file pipe Delivery. Pipe nomor 4 (`RecapitulateOrderValuesPipe`), 8 (`ApplyDownPaymentPipe`), 10 (`BindSerialNumbersPipe`), dan 11 (`DispatchDomainEventsPipe`) tidak punya file di struktur folder.
2. **Jumlah kapabilitas.** Ringkasan eksekutif sesi 2 menyebut "7 kapabilitas domain CI3 yang sempat terlewat", sedangkan Bagian 6 menyebut "Seluruh 10 kapabilitas modul Penjualan CI3 telah terinventarisasi". Angka 7 mencakup Storno/Reversal, Stepping Follow-Up, Undone Queue, Auto-Authorization, Payment Source & DP, Bundling Serial Number, dan Printing Engine.
3. **Nama fungsi view resume.** `optimasi_view_resume` memakai `viewResume()`; `KONTEKS_STATUS_VIEW_RESUME_PENJUALAN` memakai `viewResumeDetails()`. Kemungkinan dua fungsi berbeda pada `Transaksi.php` yang sama, namun tidak dijelaskan.
4. **Arah default badge.** `KONTEKS_STATUS_PEMBAYARAN_REVERT_SO` menyebut helper menghasilkan `is_batal = true` yang "mencegat alur sebelum sistem dapat menetapkan badge yang semestinya", sedangkan `KONTEKS_STATUS_VIEW_RESUME_PENJUALAN` subsequently mendeklarasikan prioritas 5 dan 6 yang justru menangkap `is_batal` untuk badge revert SO. Keduanya konsisten bila dibaca sebagai urutan perbaikan bertahap, bukan kontradiksi.
5. **Jalur root proyek berbeda.** Root code CI3 disebut bergantian `W:\everest_refaktor\`, `z:\everest_refaktor\`, `z:\everest_11sept\`, `z:\everest_29agus\`, `z:\everest_17jul\`, dan `w:\everest_10agus\`. Untuk implementasi, satu root kanonik harus ditetapkan.
6. **Sumber konfigurasi.** `roadmap_modul_penjualan` menyebut `coTransaksiCore.php` 10.724 baris; `transkrip_konteks_migrasi_penjualan_laravel` menyebut array konfigurasi 10.724 baris sebagai satu file. Perlu dipastikan apakah 10.724 adalah jumlah baris file atau jumlah baris array.
7. **Dua dokumen 8 September 2026 dengan topik sama.** `transkrip_arsitektur_migrasi_penjualan_sesi_2` menstatuskan dirinya FINAL dan berisi keputusan lanjutan (bounded context, DTO, 11 pipe), sementara `transkrip_konteks_migrasi_penjualan_laravel` lebih awal berisi struktur folder 7+3 pipe. Sesi 2 adalah dokumen lebih mutakhir dan seharusnya menjadi acuan.
8. **Target platform.** Klaim "Laravel 13" dan "PHP 8.4 (Strict Typing, DI Container, Constructor Property Promotion)" pada dokumen Laravel, sementara semua dokumen CI3 mengunci kompatibilitas PHP 5.6. Kedua batasan tidak dapat berlaku bersamaan dalam satu basis kode.
9. **Efektivitas cache registry pada view resume.** Pengoptimalan 5.8 memindahkan pembacaan registry ke dalam satu query `IN` dengan map memori, namun cache tersebut hanya lahir dalam satu request HTTP dan tidak persisted antar request, sehingga pada dokumen berentry point banyak(nilainya masih diambil ulang tiap pembukaan modal.

### 10.3 Temuan yang belum tertutup

| Temuan | Status | Berkas target |
| :--- | :--- | :--- |
| SKU / PRODUCT CODE = 0 dan UOM `n/a` pada keranjang retur | Backlog | `application/modules/penjualan/controllers/_processSelectNotaItem.php` baris 379-382 |
| Parser SQL `<>` tidak dikenali di `ComItemQueryService.php` | Backlog | `application/models/Coms/ComItemQueryService.php` `parseAndApplyFilters()` baris ~153 |
| Label selektor 9822 masih `"item"` | Backlog | `application/modules/penjualan/config/coTransaksiUi.php` (konfigurasi 9822) |
| Filter batas umur nota retur belum ada | Backlog (evaluasi bisnis) | `selectorFilters` konfigurasi 9822 |
| 189 invoice 4822 dengan `items5_sum` kosong | Rencana implementasi | `application/controllers/Tool.php` |
| Lima perbaikan UX produk hadiah | Belum dikerjakan (prioritas tinggi #1 dan #2) | Config modul hadiah + `coTransaksiLayout.php` |
| Pipe 4/8/10/11 belum punya file di struktur Laravel | Rencana | `Modules/Penjualan/app/Domain/Pipelines/Order/` |
| Fase 3-5 roadmap CI3 | Belum mulai | `ComPartyWarehouseService.php`, `Create.php`, `FollowUp.php` |

---

## 11. Lampiran: Daftar File Sumber

| Nama File | Ukuran | Topik H1 | Peran |
| :--- | ---: | :--- | :--- |
| `SALES_ORDER_FLOWCHART.md` | 9.760 byte | Diagram Alur & Flowchart Lengkap Transaksi Follow-Up Sales Order | Sumber diagram alur 15 tahap, sequence diagram interaksi objek, state diagram siklus hidup SPO/SO, dan ER diagram entitas persistence. Menetapkan domain service `ComSalesOrderFollowupService` dan `ComTransactionPipelineEngine` |
| `SALES_ORDER_FOLLOWUP_TRANSACTION_PIPELINE.md` | 11.960 byte | Arsitektur & Spesifikasi Pipeline Transaksi Follow-Up Sales Order (CI3 Edition) | Sumber teknis terdalam: diagram 5 layer, matriks transformasi state data A-J, daftar lengkap 49-key registry, serta standar kepatuhan ACID, audit trail, dan zero inline comments |
| `roadmap_modul_penjualan.md` | 6.424 byte | ROADMAP REFACTORING & MIGRASI MODUL PENJUALAN | Sumber anatomi masalah 7 controller dan matriks 5 fase Strangler Fig, termasuk quality gates, konstanta gudang, dan bentuk respons JSON modernisasi transport |
| `KONTEKS_STATUS_PEMBAYARAN_REVERT_SO.md` | 8.496 byte | KONTEKS ARSITEKTUR & ANALISIS BUG: STATUS PEMBAYARAN PADA ALUR TRANSAKSI BATAL / REVERT KE SO | Sumber kasus THEDY, tabel rantai 9 transaksi, mekanisme akuntansi kolom `returned`, empat celah sistem, dan rincian perbaikan pada helper serta dua controller |
| `KONTEKS_STATUS_VIEW_RESUME_PENJUALAN.md` | 9.620 byte | KONTEKS ARSITEKTUR & ALUR LOGIKA: STATUS PEMBAYARAN VIEW RESUME PENJUALAN | Sumber SSOT `fin_evaluate_payment_status`, matriks 11 prioritas badge modal resume, sinkronisasi dengan `History.php`, dan checklist pemeliharaan untuk pengembang |
| `optimasi_view_resume.md` | 7.885 byte | Rencana Optimasi Performa viewResume | Sumber tiga titik optimasi query (batch registry, projection A/R, projection faktur) plus empat analisis pencegahan bug termasuk migrasi filter jurnal ke `transaksi_id` |
| `transkrip_konteks_penjualan_dan_retur_2026-09-05.md` | 12.133 byte | Transkrip Konteks & Riwayat Percakapan Refactoring Everest ERP | Sumber audit retur 9822 (SKU 0, parser `<>`), kasus VIVI ELECTRINDO dengan angka konkret, risiko pajak dan PSAK 14, perbaikan Takeaway dan guard stok minus, serta daftar backlog sesi berikutnya |
| `transkrip_arsitektur_migrasi_penjualan_sesi_2_2026-09-08.md` | 14.817 byte | TRANSKRIP ARSITEKTUR & MASTER BLUEPRINT MIGRASI PENJUALAN (SESI 2) | Sumber keputusan bounded context, tabel penempatan lima service, context map enam layer, 11 pipe, konvensi porting `he_value_builder`, dan tiga milestone rilis |
| `transkrip_konteks_migrasi_penjualan_laravel_2026-09-08.md` | 12.164 byte | TRANSKRIP KONTEKS & CETAK BIRU ARSITEKTUR MIGRASI PENJUALAN | Sumber kompas evolusi tahap 0-2, definisi DDD Pragmatis, pemetaan step ke entitas, struktur folder lengkap, keputusan gatekeeper, faktur otomatis, tax standby, partial delivery, dan state freeze |
| `penyerahan_produk_hadiah_ux.md` | 9.239 byte | Modul Penyerahan Produk Hadiah - Arsitektur & Perbaikan UX | Sumber arsitektur 3 transaksi hadiah, matriks pembatalan berjenjang, dan lima perbaikan UX dengan kode CSS dan HTML konkret |
| `implementation_plan_invoice_items5_sum_recovery.md` | 6.943 byte | Rencana Implementasi: Tool Perbaikan Invoice 4822 (Invoicing) & 7499 - Items5_sum Kosong | Sumber metrik audit 189 dari 344, flowchart tool `repairInvoiceItems5SumProject()`, struktur `items5_sum`, lima titik dual-sync, logika pencocokan task, dan prosedur validasi keamanan |
| `SKENARIO_UAT_SWITCH_PELAKSANA_SPK.md` | 19.244 byte | DOKUMEN UAT BERBASIS GOLDEN CIRCLE & METODE 5W + 1H - PENGALIHAN PELAKSANA SPK (INTERNAL VS EXTERNAL VENDOR) | Sumber skenario UAT 8 kasus, mekanisme gate `progress_id = 3`, fail-fast `terbayar > 0`, dokumen `9911` dan `3674`, matriks audit database, dan lembar sign-off |

Total: 12 berkas, 122.587 byte.