# Sintesis Modul Project, Invoice, dan Settlement - Everest ERP

Dokumen sintesis konsolidatif atas 25 file markdown sumber (job `ev-project`) yang mencakup domain Master Project (jenisTr 588), modul Amandemen Invoice / Clean Invoice, modul Settlement (jenisTr 758/759), standardisasi 3 kolom finansial, audit data proyek, serta UAT dan serah terima pekerjaan refactoring. Seluruh nama tabel, kolom, controller, template dokumen, nomor standar, angka, dan tanggal di bawah ini diambil apa adanya dari sumber;  bila sumber tidak menyebut suatu detail, hal itu dinyatakan eksplisit sebagai "tidak dispesifikasikan di sumber".

Konteks platform yang konsisten disebut di sumber: CodeIgniter 3.1.8 (HMVC Wiredesignz), target kompatibilitas sintaks PHP 5.6, database MariaDB dengan nama instance `run_everest_modul`, dan standar acuan ISO 9001:2015, ISO 27001:2022, ISO/IEC 25010:2011, COSO Internal Control, PSAK 1 dan PSAK 2, OWASP Top 10:2021, serta regulasi Indonesia (PER-03/PJ/2022, UU HPP, PPN/PPh).

---

## 2. Ringkasan Eksekutif

Dokumen kumpulan ini menggambarkan satu initiative besar: membuat modul proyek, invoice, dan settlement dapat diaudit, direplikasi, dan ditutup secara tertib tanpa merusak rantai dokumen hilir. Sembilan tema berulang:

1. **Amandemen tanpa merusak nilai.** Clean Invoice/Amandemen memakai pendekatan in-place update dengan jurnal delta, bukan void-and-reissue, karena membatalkan invoice di fase 5 akan menjatuhkan Surat Jalan, Packing, Picking, dan DO yang sudah ditandatangani secara fisik.
2. **Audit trail sebagai nyawa sistem.** Setiap perubahan invoice atau proyek harus menyimpan snapshot JSON sebelum overwrite. Sumber berbeda menyebut dua mekanisme: `transaksi_data_registry.registry_patch = amandemen_v1` (blueprint konseptual) dan tabel `transaksi_amandemen_history` (spesifikasi implementasi).
3. **Pajak sebagai gerbang keras.** Status e-Faktur `APPROVED_DJP` memaksa user  memilih antara berhenti atau menyerap selisih PPN ke akun Beban Penjualan Lainnya `601000036`; kenaikan omzet setelah faktur terbit selalu ditolak dengan instruksi Faktur Pengganti kode 011.
4. **Anti-fraud berlapis.** Kuota maksimal 2x amandemen dengan alasan "ISO 9001 Anti-Fraud", guard anti-overpayment terhadap `transaksi_dibayar`, guard anti-underreporting, dan role gate Supervisor/Manager Keuangan.
5. **Project punya lifecycle 5 step.** Pre-Quotation -> Quotation -> Started Project (Kickoff) -> Serah Terima Tahap 1 -> Serah Terima Tahap 2 (Closing), dengan `MasterData.php` sebagai facade yangChemistry mendelegasikan ke 4 engine HMVC.
6. **Data proyeksangat  dirty.** Audit 26 Agustus 2026 atas 253 proyek aktif menemukan 21 mismatch cabang, 60 faktur 7499 belum senilai kontrak dengan gap +/- Rp 6,03 miliar, 15 proyek tanpa SO/SPK, 21 proyek harga kontrak Rp 0, dan 4 proyek yang closing final namun masih aktif.
7. **Settlement gagal footing.** Modul 758 menyajikan total Rp 24.922.000 pada Tabel 1 dari tiga pos kas, tetapi rekapitulasi Tabel 2 hanya menampilkan Renos Rp 2.500.000 akibat bug reset array di dalam loop `_processSelectNota.php`.
8. **Tiga kolom finansial wajib.** HPP Modal, Harga Budget, dan Harga Jual Project harus konsisten muncul di Shopping Cart, FollowUp approval, dan MasterData RAB, dengan kolom DB baru `harga_budget DECIMAL(24,10) DEFAULT 0`.
9. **Kepatuhan harus diuji, bukan diasumsikan.** Dua dokumen UAT (Master Project dan 3 Kolom) disusun lengkap dengan matriks kasus dan berita acara, namun seluruh kolom hasil aktual masih kosong, artinya belum ada bukti sign-off.

## 3. Domain Project: Alur, Timeline dan Milestone

### 3.1 Peta Tabel Database yang Digunakan Modul Proyek

| Tabel | Peran | Kolom Kunci yang Disebut Sumber |
| --- | --- | --- |
| `transaksi` | Master seluruh riwayat transaksi (SO, SPK, Invoice Termin, Kuitansi) | `id` (PK, contoh `890738`), `jenis`/`jenis_master`, `nomer2`/`nomer`, `transaksi_nilai`, `transaksi_ppn`, `transaksi_net`, `id_master`/`id_top`, `ids_prev`/`ids_ref`/`ids_his`, `customers_nama`/`pihak_nama`, `oleh_nama`, `dtime` |
| `transaksi_payment_source` | Gateway relasi proyek dan tagihan | `transaksi_id`, `project_id`, `project_nama`, `jenis`, `target_jenis`, `nomer`, `tagihan`, `dpp_ppn`, `ppn`, `sisa`, `extern_id`, `extern_nama`, `label` |
| `project_produk` | Master header proyek fisik/kontrak | `id` (PK, contoh 46 = `PASADENA VILLAGE TAHAP 2`), `nama`, `transaksi_id`/`quot_id`/`project_start_id`, `persen_progress`, `nomor_kontrak`, `tanggal_kontrak`, `alamat`, `closing_status`, `cabang_id`, `customer_id`, `spek`, `harga`, `quot_nomer`, `project_start_nomer`, `status`, `trash` |
| `project_produk_items3` | Skema jadwal termin | `transaksi_id`/`nomer`, `nama` (misal `TERMIN 1`), `persen` (misal `70%`), `harga`/`jumlah` |
| `project_produk_items4` | Skema uang muka / DP | `transaksi_id`/`nomer`, `persen` (misal `30%`), `harga`/`jumlah`, `keterangan_dp` |
| `project_produk_items5` | Retensi dan garansi | `transaksi_id`/`nomer`, `persen` (`5%` atau `0%`), `tgl_akhir_garansi`, `keterangan_garansi` |
| `transaksi_data_registry` | Blob serialized/base64 registry | `transaksi_id`, `main`, `items5_sum`, `tableIn_master_values` |
| `project_komposisi` | Komposisi material per WO | ditambah `harga_budget` |
| `project_komposisi_workoder` | Komposisi per work order | ditambah `harga_budget` |
| `project_komposisi_sub_workoder` | Komposisi per sub-WO/fase | ditambah `harga_budget` |
| `project_komponen_biaya_details` | Rincian komponen biaya/jasa | ditambah `harga_budget` |
| `project_tasklist` / `project_tasklist_tambahan` | Tasklist utama dan tambahan | diakses via `MdlTasklistProject` dan `MdlTasklistProjectTambahan` |
| `stock_locker` | Stok fisik per gudang | `state = 'active'`, `jenis = 'produk'` |
| `_rek_pembantu_subcustomer_cache` | Cache buku besar pembantu | `rekening`, `extern2_id`, `periode`, `kredit_akhir`, `debit_akhir` |

### 3.2 Klasifikasi Jenis Transaksi (jenisTr)

| Kode | Makna | Perlakuan Nilai |
| --- | --- | --- |
| `588so` / `588spo` | Quotation Approval / SO Project | Header otorisasi; label "Nilai Total Kontrak Proyek"; dikecualikan dari total tagihan |
| `588st` | Start Project (SPK) | Header otorisasi; nilai = total proyek; dikecualikan dari total tagihan |
| `5882` | Realisasi pengeluaran material proyek | Dikurangi stok gudang dan memotong sisa alokasi WO |
| `4822` | Invoice tagihan reguler | Akumulasikan ke total tagihan |
| `7499` | Termin Invoice | Akumulasikan ke total tagihan |
| `749` | Kuitansi / A/R Receipt (RPC) | Akumulasikan ke total pembayaran diterima |
| `4467` / `583` | DP / Uang Muka | Akumulasikan ke total pembayaran diterima |
| `758` | Penerimaan Setoran Kas (settlement) | Modul `settlement`, target maker-checker |
| `759` | Penyetoran Kas / hutang setoran | Target KPI outstanding setoran |
| `4822` + `4822` pada URL cetak | Endpoint `invoicing/Printing/viewReceiptReg/4822/[nomor_invoice]` | Gunakan `?opsi_cetak=5` |
| `588` | Alias modul Master Project | Disebut pada judul UAT 3 Kolom |

### 3.3 Alur Timeline Proyek: 5 Fase Penelusuran Data

Modul laporan: `Printing::viewTimelinePdf`, contoh URL `/viewTimelinePdf/749/890738`.

| Fase | Nama | Metode | Hasil Khas |
| --- | --- | --- | --- |
| 1 | Parent Chain Discovery (Upward Traversal) | Telusuri `id_master`, `id_top`, `ids_prev`, `ids_his` pada `transaksi`; sanitasi hanya ID integer | Array `$parentChainIds`, contoh `[890738, 251011, 250977, 250925]` = Termin -> SPK -> SOA -> SO |
| 2 | Sibling & Receipt Discovery (Forward) | Query terindeks: `jenis = 7499` dengan `id_master IN (...)` atau `id_top IN (...)`; `jenis = 749/4467` untuk kuitansi | Kuitansi proyek lain otomatis diabaikan karena `id_master` tidak cocok |
| 3 | Enrichment Data Master | Query `project_produk` plus `items3/4/5` | Nama proyek, ID 46, `persen_progress` (contoh `100.0000000000%`), nomor kontrak, alamat, tabel skema DP/termin/retensi |
| 4 | Klasifikasi & Pemisahan | Header 588 dikecualikan; 7499/4822 dikalikan 1.11; kuitansi 749/4467/583 sudah incl. PPN | Menghindari double counting dan PPN berganda |
| 5 | Tabel Ringkasan | Rumus penjumlahan | Total tagihan, total PPN, total DPP, total pembayaran, sisa piutang |

Optimasi Phase 2 diklaim mencapai 8 ms. Peringatan salah hitung yang eksplisit:

- Dokumen `588st` bernilai Rp 214,6 juta tidak boleh dijumlah dengan DP Rp 64,3 juta dan Termin 1 Rp 150,2 juta, karena total menjadi Rp 429 juta (2x lipat).
- Kuitansi dari proyek lain milik pelanggan yang sama wajib disaring by `id_master`/`id_top`.
- Kuitansi RPC sudah incl. PPN sehingga tidak boleh dikalikan 1,11 lagi.

Rumus Phase 5:

```
Total Nilai Tagihan Invoice (Incl. PPN) = SUM(Nominal Invoice 7499)
Total PPN (11%)                          = SUM(PPN Invoice 7499)
Total Nilai DPP (Excl. PPN)              = Total Tagihan - Total PPN
Total Pembayaran Diterima                = SUM(Nominal Kuitansi 749/RPC)
Sisa Piutang / Kurang Bayar              = Total Tagihan - Total Pembayaran
```

### 3.4 Milestone: 5 Step Master Project (Status dan Aktor)

| Step | Nama | Aktor Utama / Hak Akses | Deskripsi Inti | Prasyarat | Output |
| --- | --- | --- | --- | --- | --- |
| 1 | Pre-Quotation | Sales (hak akses penjualan project) | Inisiasi data perencanaan awal project | - | Transaksi berstatus Step 1 |
| 2 | Quotation | SPV Sales Project (approval rencana project) | Pengecekan mendalam kelengkapan dokumen dan nominal awal | - | Naik status ke Step 2 |
| 3 | Started Project (Kickoff) | SPV Sales Project (approval & kickoff) | Penyusunan RAB pada domain project; distribusi material Gudang Pusat -> Gudang Cabang -> Pelaksana | RAB sesuai & tersimpan; administrasi uang muka selesai bila DP | Naik status ke Step 3 |
| 4 | Serah Terima Tahap 1 | SPV Sales Project (pengawasan lapangan) | Pembuatan SPK, distribusi material ke pelaksana, pengawasan waktu, QC setelah posting SPK, penanganan retur material sisa/rusak | Semua SPK lolos QC; semua biaya terposting; gudang sudah terima retur; semua tagihan/termin terbit | Naik status ke Step 4 |
| 5 | Serah Terima Tahap 2 (Finish Closing) | SPV atau Manager Project (closing project) | Penyelesaian retensi dan aspek finansial | Status retensi diperiksa; masa garansi berakhir; DP lunas, termin diterima, pencairan retensi masuk | Step 5, project Closed |

Mulai Step 3, satu controller khusus yaitu `MasterData.php` mengambil alih operasional dan menyediakan UI terpisah (Project Dashboard/Workspace).

### 3.5 Cakupan Fungsi `MasterData.php` dan Batas Baris Kode

| Domain Bounded Context | Fungsi (dengan nomor baris dari audit) | Engine Tujuan | Status |
| --- | --- | --- | --- |
| Work Order, RAB, BOM | `generatePreSPK()` (12342), `rebuildMasterKomposisi()` (5508), `rebuildMasterKomposisiSub()` (5630), `editBom()` (21708), `saveBom()` (21824), kalkulasi `jml * harga` di `index()` (1000-1100) | `ComProjectWorkOrderEngine.php` | Diekstraksi |
| Task & Execution Management | `taskList()` (6511), `daftar_tugas()` (11067), `penugasan()` (9411), `penugasan_tambahan()` (10266), `exe_activate_task()` (12702), `pre_activate_task()` (12806), `exeSubTasklist()` (19803), `exeSubTasklistQc()` (20976), `followupSubTasklist()` (21555) | `ComProjectExecutionEngine.php` | Diekstraksi |
| Auto Numbering | `numbering()` (13539), `numbering_new()` (13668), `test_number()` (13810) | `ComNumberingEngine.php` | Dialihkan |
| Core Data Manipulation | `addData()` (3224), `editProcess()` (13185), `delete()` (18674), `removeMaterialTask()` (12653), `cloneMasterWorkOrder()` (13871), `cloneMasterWorkOrderKomposisi()` | `ComProjectMutationEngine.php` (+ `ComProjectValidationEngine.php` untuk validasi) | Diekstraksi |
| Presentation & UI Routing (sisa) | `index()`, `index_old()`, `preview()`, `showSummaryProject()`, `showHalamanPelaksana()`, `ajaxTasklistTimeline()`, `showTeamWork()`, `renderProgressNama()`, `formHistory()` | Tetap di controller | Bertahan |

Blueprint alur project menyebut fungsi tambahan yang sudah tersedia: `authorizeBom()`, `ComProjectFinanceEngine.php` (agregasi biaya dan anggaran), `rebuildMasterKomposisi__`, `generatePreSPK_matikandulu`, `project_reg_snapshoot`, `print_tasklist`, `print_tasklist_tambahan`, `addTask_old`, `updateTask`, `editTask`, `reloadPaketInstalasiSPK`.

Vonis arsitektur: pemecahan 5 domain akan menurunkan `MasterData.php` dari 28.401 baris menjadi estimasi di bawah 2.000 baris. Pola delegasi yang dipakai: wrapper method `$this->NamaEngine->fungsi($this)` agar helper `$this->...` di controller tidak crash saat dipanggil dari Engine.

## 4. Invoice dan Clean Invoice

### 4.1 Masalah dan Solusi

Konteks bisnis: konsumen B2B Indonesia menolak dokumen Credit Note / Nota Retur saat terjadi perubahan harga atau pembatalan item di saat penagihan; mereka menuntut "Clean Invoice" tanpa coretan. Memo manajemendated 7 Agustus 2026 menegaskan proses transaksi Everest melewati lebih dari 5 fase (SO -> DO -> Surat Jalan -> Terima Barang -> Invoice), sehingga void di ujung tidak efisien dan merusak riwayat pengiriman.

Arsitektur terpilih: **In-Place Amandemen dengan Delta Adjustment** (juga disebut Amandemen Adendum).

Prinsipnya:

1. Preservasi nomor invoice asli, contoh `INV.1.171.81`.
2. Delta dihitung dari versi 1 ke versi 2 (qty/harga).
3. Jurnal balik hanya sebesar nilai selisih, bukan pembatalan penuh.
4. Audit snapshot serialize dan disimpan permanen sebelum modifikasi.

### 4.2 Blueprint Konseptual (Modul `application/modules/amandemen_invoice`)

Rencana teknis 5 tahap:

| Tahap | Isi |
| --- | --- |
| 1 | Controller Amandemen: Supervisor memanggil dokumen invoice terkunci, buka edit parsial |
| 2 | Helper/model snapshot: rangkum struktur transaksi kompleks menjadi JSON ke `transaksi_data_registry` |
| 3 | Logika jurnal selisih: hitung selisih harga lama vs baru, kirim ke tabel `accounting` |
| 4 | Logika stok retur: perintah ke modul gudang memasukkan kembali stok batal |
| 5 | Testing dan validasi DJP: pastikan sistem menolak invoice berstatus Sukses e-Faktur |

Gembok anti-fraud pada blueprint:

- **Gembok 1 - Otorisasi:** sub-modul terpisah, hanya role Supervisor atau Manager Keuangan.
- **Gembok 2 - Pajak (early validation di awal controller):**
  ```php
  if ($invoice['efaktur'] == 1 || $invoice['efaktur_status'] == 'APPROVED_DJP') {
      die("Gagal: Faktur Pajak sudah disetujui DJP. Amandemen Clean Invoice dilarang secara hukum. Silakan gunakan alur Retur Pajak/Faktur Pengganti.");
  }
  ```
- **Gembok 3 - Anti-repetisi:** satu invoice maksimal 1 atau 2 kali diamandemen.
- **Laporan audit khusus:** menu "Laporan Invoice Amandemen" untuk Direktur/Owner berisi riwayat overwrite, tanggal, dan User ID.

Contoh perhitungan pada blueprint: total turun dari Rp 35 juta menjadi Rp 30 juta, selisih Rp 5 juta. Jurnal Penyesuaian (Credit Note Internal) mengurangi Piutang Rp 5 juta dan mengurangi Pendapatan Rp 5 juta. Untuk stok, sistem memanggil modul Penerimaan Retur / `ComLockerStockDualWrite` secara otomatis menambah 2 PC batal ke kartu stok gudang asal.

Struktur audit yang diminta blueprint: `transaksi_id`, `registry_patch = amandemen_v1`, `main` (JSON lengkap sebelum diedit).

### 4.3 Matriks Risiko dan Kepatuhan (Laporan Eksekutif)

| Aspek | Potensi Risiko | Mitigasi Sistem |
| --- | --- | --- |
| Kepatuhan Pajak (DJP) | Clean Invoice setelah e-Faktur Approved menyebabkan PPN Keluaran vs PPN Masukan selisih; risiko denda | Lock System: blokir otomatis amandemen bila status e-Faktur Approved; perubahan wajib Nota Retur Pajak |
| Audit Trail (ISO 9001) | Overwrite menghapus bukti ketertelusuran, melanggar klausul Document Control | Shadow Registry: backup JSON lama ke `transaksi_data_registry` sebelum overwrite |
| Keamanan Internal (Fraud) | Kasir/Sales memanipulasi tagihan dan menggelapkan selisih tunai | Otorisasi Manager + pengurangan Qty memicu Jurnal Penyesuaian dan pengembalian stok parsial paksa |

Manfaat bisnis yang diklaim: penyelesaian piutang lebih cepat, kestabilan operasional gudang, dan keamanan audit 100% saat pemeriksaan pajak atau auditor eksternal meminta dump database.

### 4.4 Arsitektur Implementasi HMVC Modul Amandemen

```
application/
  models/Coms/ComAmandemenInvoice.php     # domain model: snapshot, kalkulasi, mutasi jurnal, audit trail
  modules/
    amandemen_invoice/
      controllers/Modul_Controller.php    # base controller
      controllers/Create.php              # form input revisi, drag & drop, live preview
      controllers/FollowUp.php            # gerbang validasi fail-fast & eksekusi ACID
      controllers/Report.php              # histori, audit trail, restore/rollback
      views/v_amandemen_form.php
      views/v_amandemen_report.php
      views/v_amandemen_selector.php      # modal picker item dari SPK/RAB
    invoicing/
      controllers/Printing.php            # pencetakan nota/invoice resmi
      views/printing.php                  # template render HTML, opsi 1 s/d 6
    penerimaanprojek/
      controllers/Transaksi.php           # viewResume, rekonsiliasi proyek, link buku besar
```

Alur end-to-end 6 tahap implementasi:

| Tahap | Nama | Detail |
| --- | --- | --- |
| 1 | Inisiasi (Create.php) | Endpoint `amandemen_invoice/Create/index/$invoice_id` membaca header `transaksi`, item fisik `transaksi_data` dan blob `transaksi_data_registry` (field `items5_sum` untuk project), status e-Faktur dari `transaksi_efaktur` |
| 2 | Gerbang validasi berlapis (FollowUp.php) | 4 lapis: input, status pajak, anti-underreporting, anti-overpayment |
| 3 | Eksekusi ACID (ComAmandemenInvoice.php) | `trans_start()` - `trans_complete()` dengan 6 langkah |
| 4 | Skema akuntansi penyerapan pajak | Jurnal 3 baris pada kasus faktur sudah Approved |
| 5 | Pencetakan invoice fisik | `invoicing/Printing/viewReceiptReg/4822/[nomor_invoice]?opsi_cetak=5` |
| 6 | Audit trail dan rollback (Report.php) | Riwayat di `transaksi_amandemen_history`, tombol "Pulihkan ke Versi Ini" |

### 4.5 Lapisan Validasi (Fail-Fast)

| Lapis | Nama | Kondisi Diuji | Tindakan Jika Gagal |
| --- | --- | --- | --- |
| 0 | Integritas Input | Tagihan baru harus positif (> Rp 0) | Ditolak seketika |
| 1 | Status Pajak (PER-03/PJ/2022) | Jika status `APPROVED_DJP`, user wajib mencentang persetujuan penyerapan pajak | Ditolak dengan instruksi Faktur Pengganti 011 |
| 1b | Anti-Underreporting Guard | Penyerapan pajak hanya boleh bila tagihan baru <= tagihan awal | Ditolak keras untuk mencegah pidana pajak kurang bayar |
| 2 | Anti-Overpayment Guard | Tagihan baru tidak boleh lebih kecil dari `transaksi_dibayar` | Ditolak agar tidak timbul lebih bayar liar tanpa retur kasir resmi |

### 4.6 Matriks Dampak Komponen Sebelum dan Sesudah Amandemen

| Komponen | Sebelum | Sesudah |
| --- | --- | --- |
| Katalog Produk Cetak | Daftar item lama | Daftar item baru (urutan dan harga baru) |
| Header Transaksi | `transaksi_nilai` lama | `transaksi_nilai` baru, sinkron dengan DP dan termin |
| Kartu Piutang (`transaksi_payment_source`) | Plafon dan sisa lama | `tagihan` baru, `tagihan_asal` tersimpan, `amandemen_nilai` tercatat |
| Realisasi Kontrak Proyek | Nilai kontrak awal | `project_produk.harga` tersinkronisasi otomatis |
| e-Faktur DJP | Approved DJP | Tetap sah/Approved, selisih diserap ke akun 601000036 |
| Jurnal Akuntansi | Jurnal asli invoice | Jurnal asli tetap ada + jurnal penyesuaian/storno resmi |
| Cetakan Nota Fisik | Cetakan versi lama | Cetakan mutakhir, Grand Total valid, Terbilang valid |

Sinkronisasi parent yang disebut dalam diagram eksekusi: Trx #7499, Proyek #235, dan Payment Source.

### 4.7 Angka Kunci Kasus Penyerapan Pajak

Komponen nilai dan komposisi jurnal penyesuaian pada kasus penyerapan pajak:

| Komponen / Akun | Kode | Nilai Awal | Nilai Amandemen atau Debit | Kredit |
| --- | --- | --- | --- | --- |
| DPP | - | Rp 4.655.000 | Rp 4.355.000 | - |
| PPN | - | Rp 512.050 | Rp 512.050 (tetap) | - |
| Grand Total | - | Rp 5.167.050 | Rp 4.834.050 | - |
| Selisih penurunan tagihan konsumen | - | - | - | Rp 333.000 |
| Piutang Dagang | 1010020010 | - | - | Rp 333.000 |
| Penjualan | 4010 | - | Rp 300.000 | - |
| Beban Penjualan Lainnya | 601000036 | - | Rp 33.000 | - |

TeksControllers Workflow menyebut PPN accounts `2030060` pada jalur prosedur normal (bukan penyerapan), serta reset antrean pajak 110r dan penonaktifan draft 110e pada `absorb_tax = FALSE`.

Fungsi pencetakan: `inWordInd` menerbitkan kalimat terbilang, contoh "Empat Juta Delapan Ratus Tiga Puluh Empat Ribu Lima Puluh Rupiah". Mekanisme fallback anti-nol untuk `grand_pembulatan`:

```
grand_total -> new_net3 -> piutang_dagang -> piutang_usaha -> (DPP + PPN)
```

Link audit ke buku besar: `Ledger/viewMoveDetails_1` dengan format `date2=YYYY-MM-DD` (tanpa residu `%20 00:00:00`).

Rollback hanya aman apabila belum ada penerimaan kasir yang mengunci transaksi.

## 5. Amandemen Invoice: Perbandingan Tiga Versi Dokumentasi

### 5.1 Perbandingan Langsung Ketiga Versi

| Dimensi | Petunjuk Pengembang (`WORKFLOW_AMANDEMEN_INVOICE_DEVELOPER.md`) | Panduan Pengguna (`WORKFLOW_AMANDEMEN_INVOICE_PENGGUNA.md`) | Panduan Lengkap Proyek (`PANDUAN_LENGKAP_AMANDEMEN_PROJECT.MD`) |
| --- | --- | --- | --- |
| Orientasi | Arsitektur HMVC CI3, gerbang validasi, akuntansi, pajak, sinkronisasi DB | Urutan tombol dan tampilan layar (UI), troubleshooting | Standar arsitektur data, versioning, ISO, PPN/PPh untuk trading dan instalasi AC |
| Skala | Satu invoice, kasus faktur Approved | Satu invoice, kasus UI | Proyek enterprise dengan RAB, SO, PO, subkontraktor |
| Lapisan teknis | Controller, View, Model, HMVC Engine | Frontend, banner, tombol, modal | Data model dan governance |
| Entry point | Endpoint `amandemen_invoice/Create/index/$invoice_id` | Tombol "Buat Amandemen Invoice" di pojok kanan atas | Tidak ada endpoint; berbasis konsep |
| Kontrol utama | Validasi backend 4 lapis, ACID, jurnal delta | Tombol warna dinamis, banner pajak, checkbox, live preview | Golden Rule: data Approved tidak boleh overwrite |
| Elemen UI | Textarea Notes Client dan Catatan Amandemen Internal | 3 panel: status pajak, kuota revisi, ringkasan proyek | Tidak spesifik |
| Output kunci | Cetak opsi 1-6, viewResume, audit trail | Banner hijau "Amandemen Berhasil Disimpan & Dibukukan!" | ERD skeleton dan klausul ISO |
| Fokus risiko | Delta accounting dan anti-fraud | Anti-lupa Notes Client, anti-overpayment | Anti-duplikasi, PPh split line items |
| Penomoran bagian | Tahap 1-6 | Langkah 1-8 plus FAQ 5 baris | 6 titik amandemen, 4 klausul audit trail |

### 5.2 Catatan Penting tentang Tiga Versi

- `WORKFLOW_AMANDEMEN_INVOICE.md` dan `WORKFLOW_AMANDEMEN_INVOICE_DEVELOPER.md` nyaris identik (14.479 vs 14.487 B); keduanya memakai judul yang sama "Alur Kerja Komprehensif Sistem Amandemen Invoice (Everest ERP) - Developer & Technical Architecture". Versi DEVELOPER memiliki satu baris `end` tambahan di dalam sequence diagram Tahap 3.
- Hanya `_PENGGUNA.md` yang benar-benar berbeda: seluruh kontennya adalah walkthrough UI, bukan spesifikasi backend.
- DEVELOPER menautkan ke `_PENGGUNA.md` sebagai panduan praktis operator; rujukan file berupa path `file:///w:/everest_11sept/application/modules/amandemen_invoice/`.

### 5.4 Enam Titik Amandemen Proyek (Versi Lengkap)

1. Amandemen RAB/WBS: perubahan spesifikasi unit AC (misal Split ke VRV/Central), volume pipa tembaga, material pendukung, revisi target profit margin.
2. Amandemen Sales Order dan Kontrak Kontraktor: nilai total kesepakatan, skema termin (DP, Progres, Testing Commissioning), klausul denda.
3. Amandemen Purchase Order Supplier: kuota inden, harga proyek dari prinsipal (Daikin, Panasonic, Sharp), substitusi tipe AC.
4. Amandemen Alokasi Barang Proyek (Stock Reservation): perpindahan hak alokasi unit antar-proyek atau pelepasan ke kanal retail.
5. Amandemen Kontrak Sub-Kontraktor: tarif teknisi luar per titik pasang, biaya bobokan dinding/plafon tak terduga, pergantian vendor instalasi.
6. Amandemen Jadwal Mobilisasi dan Milestone: penjadwalan ulang tanggal pengiriman unit dan instalasi agar selaras dengan progres fisik bangunan.

### 5.5 Golden Rule dan Document Life Cycle

Golden Rule: data berstatus Approved yang sudah melahirkan transaksi keuangan hilir (Faktur Pajak, Delivery Order) tidak boleh di-overwrite atau delete. Pendekatan: Document Versioning dan Delta Tracking.

| Tahap | Status Lama | Status Baru |
| --- | --- | --- |
| Awal | - | `Draft` |
| Disetujui | `Draft` | `Active / Approved v1.0` |
| Diajukan amandemen | `Active` | `Under Amendment` |
| Disetujui | `Active v1.0` | v1.0 menjadi `Superseded` (diarsipkan), v2.0 terbit `Active` |
| Ditolak | `Under Amendment` | kembali `Active v1.0` |

Komponen audit trail wajib dicatat setiap amandemen: (1) Timestamp presisi sampai detik; (2) User ID pembuat dan approver; (3) Delta Log nilai before/after kolom yang diubah; (4) Change Reason/Remarks wajib diisi.

### 5.6 ERD Skeleton Versi Lengkap

Tabel `projects`: `project_id` (PK UUID/Int), `project_code`, `current_version` (Decimal, contoh 2.0), `status` (enum: Draft, Active, Under Amendment, Closed), `total_amount`.

Tabel `project_amendments`: `amendment_id` (PK), `project_id` (FK ke projects), `version_number`, `amendment_status` (enum: Draft, Pending Approval, Approved, Rejected), `requested_by` (FK users), `approved_by` (FK users), `reason` (Text).

Tabel `project_amendment_details`: `detail_id` (PK), `amendment_id` (FK), `item_id` (FK ke items), `old_qty`, `new_qty`, `old_price`, `new_price`.

Catatan: implementasi aktual di dokumen lain memakai `project_produk`, bukan tabel `projects`, dan tidak menyebut `project_amendments` maupun `project_amendment_details`.

### 5.7 Kepatuhan ISO 9001:2015 dan Regulasi Pajak

| Klausul/Aturan | Isi |
| --- | --- |
| ISO 9001 klausul 8.2.4 | Perubahan tipe AC harus terdistribusi otomatis ke Modul Inventory Reservation dan Modul Procurement agar tidak salah order ke prinsipal |
| ISO 9001 klausul 7.5 | Setiap print-out dokumen proyek wajib memuat kode versi (misal `PRJ-2026-001 Rev 2.0`) agar tim lapangan tidak memakai dokumen kedaluwarsa |
| PPN - amandemen sebelum faktur terbit | Sesuaikan nilai penagihan termin berikutnya; tidak ada implikasi hukum perpajakan |
| PPN - nilai kontrak TURUN setelah faktur terbit | Sistem menyediakan fitur Nota Retur / Nota Pembatalan di Modul AR, dapat diekspor ke e-Faktur DJP |
| PPN - nilai kontrak NAIK setelah faktur terbit | Wajib Faktur Pajak Pengganti kode 011 atau faktur baru atas nilai selisih (addendum) |
| PPh - material | Unit AC dan pipa hanya dikenakan PPN |
| PPh - jasa | PPh Pasal 23 (2% jika ber-NPWP) ATAU PPh Final Jasa Konstruksi (sesuai klasifikasi SBU/NIB) |
| PPh - logika amandemen | Perubahan komponen biaya jasa subkontraktor memCalculation ulang potongan PPh pada draf Faktur Pajak/Bukti Potong agar SPT Masa PPh valid |

Klausul dan Detail. Contoh kode: `PRJ-2026-001 Rev 2.0`.

## 6. Settlement: Standarisasi PSAK/ISO dan KPI Summary

### 6.1 Latar Belakang Modul 758

URL gate: `settlement/FollowUp/followupPreview/758/[ID_REF]/2/1`. Fungsi: validasi otorisasi keuangan maker-checker saat petugas pusat (`c_finance`) menerima berkas setoran kas/bank yang diajukan penyetor cabang (`o_finance`).

Rujukan standar: PSAK 1 dan PSAK 2, ISO 9001:2015, ISO 27001:2022, COSO Internal Control.

Empat anomali yang ditemukan:

1. **Footing Discrepancy:** Tabel 1 (Rincian Nota) menunjukkan total Rp 24.922.000 dari tiga pos (Tunai Rp 2,442 jt, Rekening Bank Rp 19,98 jt, Renos Rp 2,5 jt). Tabel 2 (Rekapitulasi Akun) hanya mencantumkan 1 baris (Renos Rp 2.500.000) sementara totalnya tetap Rp 24.922.000. Selisih Rp 22,42 jt hilang dari rekap.
2. **Misleading Metadata:** header tulis "metode setoran tunai: Cash/Tunai" padahal >80% nilai berasal dari transfer bank.
3. **Format nomor rekening ambigu:** ditulis `6,583.797.888` menyerupai nominal rupiah.
4. **Tidak ada pratinjau jurnal berpasangan dan bukti lampiran fisik** untuk pencocokan mutasi rekening koran.

### 6.2 Root Cause Teknik

`_processSelectNota.php` baris 1225-1238 (workspace `z:/everest_9sep`): array `$items8_sum = array()` di-reset di dalam loop akun kas, dan `$_SESSION[$cCode]['items8_sum']` ditulis ulang tiap iterasi sehingga hanya akun terakhir (Renos) yang tersimpan.

Selain itu: nomor rekening diformat dengan `number_format()` menghasilkan koma uang; dan label `coTransaksiUi.php` untuk jenis 758 step 1 (`userGroup => "sys"`) belum terhubung ke kamus peran, memunculkan "HAK AKSES BELUM DIATUR".

Solusi: inisialisasi `$items8_sum` satu kali di luar loop, simpan setelah seluruh akun selesai diagregasi, dengan variabel `$totalPerAkun` dan `$sampleData`.

### 6.3 Matriks Kepatuhan (Compliance Matrix)

| Dimensi | Standar | Persyaratan | Kondisi Saat Ini | Solusi Blueprint |
| --- | --- | --- | --- | --- |
| Akuntansi | PSAK 1 & 2 | Faithful Representation & Completeness: total rekonsiliasi = rincian nota | Rekap hanya Rp 2,5 jt vs total Rp 24,92 jt (selisih Rp 22,42 jt) | Perbaikan grouping multi-akun tanpa overwrite |
| Akuntansi | PSAK 1 | Accrual & Dual-Entry Verification: jelas pos debit/kredit sebelum pengesahan | Otorisator hanya lihat angka nota | Panel pratinjau jurnal (Pre-Journal Preview) |
| Keamanan | ISO 27001 (A.12/A.14) | Data Processing Integrity: cegah transaksi data timpang | Render total Rp 24,92 jt tanpa peringatan | Integrity Assertion Guard |
| Mutu | ISO 9001 (klausul 5.3 & 7.5) | Roles, Authorities & Traceability | "HAK AKSES BELUM DIATUR" | Pemetaan grup `o_finance` (penyetor), `c_finance` (penerima) |
| COSO | Best Practice | Dual Verification & Fraud Prevention | Kasir pusat tak cepat lihat slip mutasi bank | Tombol preview lampiran bukti setor |
| UI/UX | Best Practice | Clarity & Consistency | Header tulis "Tunai", rekening berformat koma uang | Header dinamis, nomor rekening tanpa koma uang |

### 6.4 Komponen Solusi

| Komponen | Lokasi | Perubahan |
| --- | --- | --- |
| 4.1 Agregasi akun kas | `modules/settlement/controllers/_processSelectNota.php` | Inisialisasi `$items8_sum` sekali, simpan setelah loop selesai |
| 4.2 Header dinamis & tipografi | `settlement/controllers/FollowUp.php`, `coTransaksiLayout.php` | 100% kas fisik -> "Cash / Tunai"; 100% bank -> "Bank Transfer"; >1 akun -> "Multi-Akun / Campuran (Tunai, Bank, Marketplace)". Nomor rekening format bersih `6583797888` atau `658-379-7888` |
| 4.3 Pre-Journal Preview | View `transaksi.php` + `FollowUp.php` | Tabel akun debit/kredit sebelum tombol approve |
| 4.4 Lampiran bukti setor | nears header | Ikon/modal bukti transfer yang diunggah kasir cabang saat Step 1 |

Contoh pre-journal preview yang dirancang:

| Kode Akun | Nama Akun | Debet | Kredit |
| --- | --- | --- | --- |
| 11201-001 | Bank BCA Pusat | 19.980 | - |
| 11101-001 | Kas Operasional Pusat | 2.442 | - |
| 11305-001 | Escrow Renos | 2.500 | - |
| 11199-002 | Kas Transit Cab Pinang | - | 24.922 |
| TOTAL (BALANCE) | | 24.922 | 24.922 |

### 6.5 Pentahapan Implementasi Settlement

| Fase | Fokus | Item |
| --- | --- | --- |
| 1 | Perbaikan Kritis (Zero Tolerance & Data Integrity) | Perbaikan loop `items8_sum`, header dinamis metode setoran, bitesapan Footing Test: rekap = total nota |
| 2 | Kepatuhan Mutu & Operasional (ISO 9001) | Pemetaan kamus hak akses stepper, pembersihan tipografi nomor rekening, modal pratinjau bukti transfer |
| 3 | Standarisasi Akuntansi (PSAK) | Panel pratinjau jurnal berpasangan, standardisasi COA resmi |

Verifikasi TC-01 sampai TC-06: multi-akun menampilkan 3 baris; total Tabel 2 = Tabel 1 (Rp 24.922.000); header "Multi-Akun / Campuran"; rekening `6583797888`; transaksi tunggal 100% Tunai menghasilkan header "Cash / Tunai"; transaksi tunggal 100% Bank menghasilkan "Bank Transfer".

Status dokumen: Draf Blueprint, menunggu persetujuan eksekusi.

### 6.6 KPI Summary Cards (Reusable Widget)

Target: widget di dashboard `home/welcome` dan modul `settlement/Transaksi/index/758`. Sumber data: `transaksi_payment_source` dengan kriteria `target_jenis = '759'` dan `sisa > 0`.

Struktur komponen:

| File | Lokasi | Fungsi |
| --- | --- | --- |
| `ComKpiSettlement.php` | `application/models/Coms/` | Model bisnis global agregasi SQL |
| `v_kpi_settlement_cards.php` | `application/views/widgets/` | Template view reusable dengan parameter `$context` |
| `Home.php` | `modules/home/controllers/` | Render widget alert saat login |
| `Transaksi.php` | `modules/settlement/controllers/` | Render widget filter |

Method `getSummaryGlobal($cabangId = null)` menghitung: `total_nominal_outstanding` (SUM sisa), `total_penyetor_aktif` (COUNT DISTINCT extern_id), `total_nota_outstanding` (COUNT id), `total_overdue_count` (COUNT DISTINCT extern_id dengan `dtime < NOW() - 24 JAM`).

Method `getSummaryPerPenyetor($cabangId = null)` mengelompokkan per `extern_id`, `extern_nama`, `cabang_id`, `cabang_nama`, mengembalikan daftar: `total_sisa`, `jumlah_nota`, `min_dtime`, `max_aging_hours`, `status_aging` (`normal`/`warning`/`overdue`).

Contoh tampilan yang dirancang:

| Kartu | Nilai |
| --- | --- |
| Total Belum Disetor | Rp 45.200.000 (14 nota outstanding) |
| Penyetor Aktif | 3 personil (Cabang Surabaya, Bandung) |
| Overdue (> 24 Jam) | 1 personil (membutuhkan action) |

Rekap per penyetor (contoh): Widya (Bandung) Rp 17.580.000, 5 transaksi, Overdue 3 Hari; Indah (Surabaya) Rp 3.044.000, 3 transaksi, Normal 6 Jam; Sys Shadow (DC) Rp 4.000.000, 1 transaksi, Warning 28 Jam.

Aturan badge aging:

| Warna | Kondisi |
| --- | --- |
| Hijau (Normal) | Umur penahanan < 24 jam sejak `dtime` |
| Kuning (Warning) | 24 sampai 48 jam |
| Merah (Overdue) | > 48 jam (prioritas penagihan) |

Perilaku per context:

| Parameter | `home/welcome` | `settlement/758` |
| --- | --- | --- |
| Tujuan | Alert & Early Warning saat login | Filter & Eksekusi operasional |
| Lokasi | Atas/Mid dashboard | Atas zona "TRANSAKSI YANG PERLU ACTION" |
| Tombol | "Buka Setoran" (direct link) | "Filter Tabel" |
| Aksi | `location.href = base_url + 'settlement/Transaksi/index/758?extern_id=XXX'` | Trigger JS filter/AJAX reload tabel |

Standard coding: PHP 5.6 (dilarang `??`, `[]`, `fn() =>`), query wajib Query Builder atau Query Binding, Zero Placeholder (fungsi lengkap tanpa pemotongan).

## 7. Master Project dan Dashboard

### 7.1 Perbaikan Progress 151% dan Double Counting

Gejala (workspace `w:/everest_refaktor`, module `master_project`, `views/transaksi.php`):

| Cabang | Total Proyek | Selesai | Dalam Proses | Tertunda | Progress |
| --- | --- | --- | --- | --- | --- |
| Surabaya | 18 | 5 | 8 | 10 | 151% |
| Pinang | 151 | 97 | 29 | 53 | 86% |

Partisi tidak klop: 5+8+10 = 23 bukan 18 (Surabaya); 97+29+53 = 179 bukan 151 (Pining).

Akar masalah: tidak ada capping pada `parseFloat(project.persen_progress)` dan rata-rata; kondisi `delayed++` terpicu dua kali bila progress 0 dan deadline lewat; di DB ada `persen_progress` bernilai ratusan persen akibat pembagian biaya vs harga jual atau akumulasi inkremental berulang di `MasterData.php`.

Solusi Opsi A (frontend fix):

- Capping `Math.min(100, Math.max(0, rawProgress))` per proyek dan rata-rata.
- Partisi status mutually exclusive: Selesai = `progress >= 100`; Tertunda/Terlambat = `progress === 0 || isOverdue`; Dalam Proses = `progress > 0 && progress < 100 && !isOverdue`.

Hasil setelah fix: Surabaya konsisten **Total 18 = Selesai 13 + Proses 0 + Tertunda 5, Progress 72%**.

### 7.2 Ringkasan Tasklist Null (Backend)

Gejala: Login Surabaya (Nurul), kartu Ringkasan Tasklist menampilkan semua 0 (Total 0, Selesai 0, Proses 0, Terlambat 0, Tertunda 0, Batal 0, Progress 0%) padahal tabel Tasklist Menunggu QC berisi tugas aktif.

Akar masalah (`master_project/controllers/Transaksi.php` baris 4448-4486):

1. Query terkunci `employee_id = login['id']` via `$tmpTasklist->addFilter("employee_id=" . $this->session->login['id'])` dan `where("cabang_id", login['cabang_id'])`. Nurul adalah pembuat SPK/manajemen/PIC, bukan teknisi pelaksana di SPK.
2. Inkonsistensi scope: Ringkasan Proyek seluruh cabang (18 proyek) tapi Ringkasan Tasklist hardcode personal.
3. Pengabaian SPK tambahan: hanya membaca `MdlTasklistProject` (`project_tasklist`), mengabaikan `MdlTasklistProjectTambahan` (`project_tasklist_tambahan`).

Firm requirement dari user: jika login memiliki `o_project_spv` atau `c_holding` atau `c_owner` atau `o_project_mgr`, task list muncul untuk seluruh cabang; di luar itu hanya punya dia sendiri.

Implementasi: variabel `$isManagement` memanggil `in_array` untuk empat role tersebut. Cabang/manajemen mengambil `where("closing_status", 0)` + `where("cabang_id", ...)`  ->  `$activeProjectIds`, lalu `where_in("produk_id", $activeProjectIds)` + `status = 1` + `trash = 0` untuk kedua tasklist; results merge via `array_merge($arrTaskMain, $arrTaskTmb)`. Pelaksana: kunci `employee_id`, `where_in("id", $vTask)` bila ada, else `where("id", "-99999")`.

Verifikasi: login Nurul di Surabaya menampilkan 18 proyek dan tasklist terakumulasi; login teknisi biasa hanya data sendiri; tidak ada regresi pada tabel AJAX `#qcProject` dan `#undoneList`.

### 7.3 Duplikasi Terbit Project (Multi-Cabang)

Kasus: SO `588spo.1.1478.59` / `SO.PJ.1.1478.59`, project `MAGGIORE SIGNATURE EAST`, PO `PO260700049`, konsumen PT. PARAMOUNT ENTERPRISE INTERNATIONAL, CABANG PINANG.

| Kolom | Baris 1 (ID 143) | Baris 2 (ID 137) |
| --- | --- | --- |
| Waktu Create | 07 Aug 2026 14:30 | 07 Aug 2026 14:31 |
| Transaksi ID (Trid) | 0 (gantung) | 900,215 (terkunci ke Sales Order) |
| Nomer Order | Kosong / - | `SO.PJ.1.1478.59` |
| Status | Data Master Mandiri (Orphan Draft) | Data Project Resmi Terikat Transaksi |

Root cause: (1) Dual entry path - input via Master Data `Data/add/ProdukProject` pukul 14:30, lalu saat membuka SO Project `588spo` pukul 14:31 petugas meng-input ulang sehingga `ComProjectSales` mengikat Trid 900215. (2) `penjualanproject/config/coTransaksiUi.php` `selectorFilters` hanya `customer_id=pihakID` dan `transaksi_id=.0`, tanpa `cabang_id` sehingga berisiko kebocoran lintas cabang. (3) `MdlProdukProject` hanya validasi `nama` dan `kategori`, tanpa cek kombinasi `cabang_id + customer_id + spek`.

Solusi 4 langkah:

| Langkah | File | Tindakan |
| --- | --- | --- |
| 1 | `penjualanproject/config/coTransaksiUi.php` | Tambah filter `cabang_id=placeID` ke `selectorFilters` |
| 2 | `master_project/models/Mdls/MdlProdukProject.php` dan `application/models/Mdls/MdlProdukProject.php` | Tambah `checkDuplicateProject($cabangId, $customerId, $spek, $excludeId = 0)` dengan query `WHERE cabang_id = ? AND customer_id = ? AND spek = ? AND id != ? AND status = 1 AND trash = 0 LIMIT 1` |
| 3 | `application/models/Coms/ComProjectSales.php` | Penguncian baris `FOR UPDATE` dan update `transaksi_id`/`transaksi_no` dengan verifikasi `cabang_id`, Query Binding plus `trans_start()`/`trans_complete()` |
| 4 | `MdlProdukProject.php`, `coTransaksiUi.php` | Kunci bypass `cabang_id` di level Model (`addData` override); ganti operator `<>` menjadi `>` untuk menghindari Full Table Scan pada index MariaDB |

Status pelaksanaan: Tahap 1 data cleansing (nonaktifkan ID 143, operasional pada ID 137). Tahap 2 selesai: `cabang_id=placeID` terpasang di `penjualanproject` dan `master_project` coTransaksiUi; `protected $validateData = array("customer_id", "spek")` diaktifkan di `MdlProdukProject` memblokir submit ganda pada `Data::addProcess()`; `checkDuplicateProject()` dipasang pada `Create::save()` di kedua modul; `ComProdukProject::pair()` dan `ComProjectSales::cekPreValue()` disesuaikan agar eksekusi UPDATE bukan INSERT saat edit.

### 7.4 Optimasi `followupPreview` (Session-First dengan DB Fallback)

Rencana pada workspace `w:/everest_6sept`, `master_project/controllers/FollowUp.php`.

Fase 1 - di `followupPrePreview` (region "session swapper", sekitar baris 1770-1810) tambahkan:
```php
$_SESSION[$cCode]['_cache_tmpTr'] = serialize($tmpTr);
$_SESSION[$cCode]['_cache_signNumbers'] = $signNumbers;
```
`$tmpTr` berisi array of objects dari `lookupJoined()` sehingga perlu di-serialize.

Fase 2 - di `followupPreview`:

| Kode Target | Baris | Aksi |
| --- | --- | --- |
| `lookupJoined` | 1976-1982 | Baca dari `_cache_tmpTr`, fallback query dengan `addFilter("id in (...)")` + `addFilterJoin("sub_step_number='" . $currentStepNum . "'")` |
| `lookupSignaturesByMasterID` | 1984-2000 | Baca `_cache_signNumbers`, fallback query |
| `lookupMainValuesByTransID` + `lookupDetailValuesByTransID` | 2064-2081 | Baca `tableIn_master_values` dan `tableIn_detail_values`, fallback query |
| `lookupExtSteps` + `lookupPaymentSrcs` | 3562-3568 | Hapus query duplikat, pakai session yang sudah diisi PrePreview |

Fase 3 - hapus duplikat: dua pemanggilan identik `fillValues_he_value_builder` di sekitar baris 1934-1935 pada `followupPrePreview`.

Open questions: (1) apakah `followupPreview` pernah dipanggil langsung tanpa `followupPrePreview` (setelah `_followupLiveEdit`)?_asumsi bahwa session sudah ada. (2) Region DETAILS BOM baris 4683-5763 melakukan sekitar 15 query project-specific, apakah juga dioptimasi.

Verifikasi: redirect PrePreview->Preview; live edit (ubah qty, hapus item); akses langsung `followupPreview` via URL tanpa PrePreview (fallback DB); bandingkan waktu loading.

### 7.5 Audit Komprehensif Data Proyek (26 Agustus 2026)

Database `run_everest_modul`, tabel `project_produk`, `transaksi_payment_source`, `transaksi`. Populasi: 253 Proyek Aktif (`trash=0, status=1`) + 27 Proyek Terhapus = 280 total.

Distribusi 253 proyek aktif: Faktur 7499 Lengkap 165, Faktur 7499 Belum Lengkap 60, Tanpa TPS/Aktivitas Tagihan 28.

Matriks temuan:

| # | Dimensi | Jumlah | Severity |
| --- | --- | --- | --- |
| 1 | Cabang Mismatch (TPS vs project_produk) | 21 | MEDIUM |
| 2 | Proyek Terhapus (`trash=1`) | 27 | INFO |
| 3 | DP Request tapi Kasir Belum Terima | 0 | CLEAN |
| 4 | Faktur 7499 Belum Senilai Kontrak | 60 | MEDIUM |
| 5 | `closing_status > 0` | 107 | INFO |
| 6a | Tanpa SO/SPK (`quot_nomer` kosong) | 15 | HIGH |
| 6b | Harga Kontrak = Rp 0 | 21 | HIGH |
| 6c | SPK ada, SO kosong | 0 | CLEAN |
| 6d | Customer kosong/NULL | 0 | CLEAN |
| 6e | Customer multi-cabang | 2 | INFO |
| 6f | SO Nomer duplikat | 0 | CLEAN |
| 6g | Overpayment (Bayar > Tagihan) | 0 | CLEAN |

#### 7.5.1 Temuan 1: Mismatch Cabang (21 Proyek)

Pola: TPS mengandung baris `cabang_id = -1` (PUSAT/DC) bersama cabang yang benar, indikasi beberapa baris TPS diinput dari login PUSAT.

Rincian per proyek:

| Project ID | Nama | PP Cabang | TPS Cabang | Keterangan |
| --- | --- | --- | --- | --- |
| #1 | New Karelia Village | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #29 | HVAC GUMMY INSTALASI | 33 (Surabaya) | -1, 33 | TPS ada dari PUSAT |
| #58 | NEW ASTER - MATERIAL AC | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #60 | PASADENA CLASSIC TAMBAHAN | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #61 | WF-100119118 | 33 (Surabaya) | -1, 33 | TPS ada dari PUSAT |
| #62 | RO-100134593 | 33 (Surabaya) | -1, 33 | TPS ada dari PUSAT |
| #66 | NEW SAMARA VILLAGE | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #91 | Dominos Teluk Gong | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #102 | Hyelasmo PIK | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #116 | ASTER - UNIT | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #156 | Dominos Pamulang Part II | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #157 | Dominos Bellagio Jakpus | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #158 | LILY - MATERIAL | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #160 | CANNA - UNIT | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #161 | CANNA - MATERIAL | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #166 | Bpk Majid Punjabi | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #280 | Muhammad Fairuzaki | 1 (Pinang) | -1, 1 | TPS ada dari PUSAT |
| #281 | RUANG BROWNIES | 33 (Surabaya) | -1 | Hanya PUSAT (KRITIS) |
| #282 | VICTORIA CENTRAL DISTRICT | 1 (Pinang) | -1 | Hanya PUSAT (KRITIS) |
| #283 | AMARILLO VILLAGE | 1 (Pinang) | -1 | Hanya PUSAT (KRITIS) |
| #284 | CANNA - UNIT | 1 (Pinang) | -1 | Hanya PUSAT (KRITIS) |

Dampak kritis #281-284: jika kasir login di cabang manapun, proyek-proyek ini tidak terlihat di panel EPFC karena filter isolasi cabang.

#### 7.5.2 Temuan 2: Proyek Terhapus (27 Proyek)

Mayoritas proyek PT. Paramount Enterprise International yang digabung/digantikan proyek baru. Komposisi: 21 Paramount (Cabang 1), 2 Gereja Bernadeth (Cabang 1), 1 UPA Snack (Cabang 33), 3 lainnya (Cabang 1). Dari 27: 16 proyek placeholder/draft awal (harga 0), 5 pernah aktif dengan total Rp 2,45 juta.

Proyek terhapus dengan nilai kontrak lebih dari 0:

| Project ID | Nama | Customer | Harga | Oleh |
| --- | --- | --- | --- | --- |
| #5 | AMARILLO VILLAGE | Paramount | Rp 198.799.495 | Jessi |
| #18 | KARELIA VILLAGE | Paramount | Rp 30.948.069 | - |
| #20 | GEREJA BERNADETH - UNIT AC | Gereja Bernadeth | Rp 215.677.543 | - |
| #21 | GEREJA BERNADETH - MATERIAL | Gereja Bernadeth | Rp 222.157.757 | - |
| #22 | HAMPTON AVENUE | Paramount | Rp 1.914.837.287 | - |
| #24 | NORTH MALIBU | Paramount | Rp 108.990.630 | - |

Proyek-proyek ini sudah di-close dengan `closing_status = 99` sebelum dihapus, menandakan prosedur penutupan dijalankan.

#### 7.5.3 Temuan 4: Faktur 7499 Belum Senilai Kontrak (60 Proyek)

Klasifikasi: 0% (belum ada faktur) 17 proyek, 33,3% (baru termin 1) 25 proyek, 55-78% (termin lanjutan) 15 proyek, 83-99% (hampir selesai) 3 proyek.

Top 10 gap terbesar:

| # | Project ID | Nama | Kontrak | Faktur Terbit | % | Gap |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | #231 | GRAND PASADENA VILLAGE | Rp 2.893.310.335 | Rp 963.472.342 | 33.3% | Rp 1.929.837.993 |
| 2 | #196 | MATERA RESIDENCES THP 5-9 | Rp 2.488.958.172 | Rp 828.823.072 | 33.3% | Rp 1.660.135.100 |
| 3 | #102 | Hyelasmo PIK | Rp 489.833.918 | Rp 543.715.649 | 55.5% | Rp 435.952.189 |
| 4 | #140 | HAMPTON EAST | Rp 650.307.933 | Rp 216.552.542 | 33.3% | Rp 433.755.391 |
| 5 | #108 | HUDSON STUDIO LOFT | Rp 608.798.916 | Rp 202.730.039 | 33.3% | Rp 406.068.877 |
| 6 | #110 | MENTENG STUDIO LOFT | Rp 484.271.865 | Rp 161.262.532 | 33.3% | Rp 323.009.333 |
| 7 | #164 | MADISON GRANDE | Rp 341.296.362 | Rp 113.651.689 | 33.3% | Rp 227.644.673 |
| 8 | #152 | IL LAGO SQUARE | Rp 193.708.746 | Rp 0 | 0% | Rp 193.708.746 |
| 9 | #165 | MATERA LAKE SIDE VILLA | Rp 288.344.149 | Rp 96.018.602 | 33.3% | Rp 192.325.547 |
| 10 | #83 | BPK EMOT - MATERIAL & JASA | Rp 294.902.310 | Rp 103.201.695 | 35% | Rp 191.700.615 |

Catatan: proyek #102 Hyelasmo PIK menarik karena Faktur Terbit (Rp 543.715.649) sudah MELEBIHI nilai kontrak (Rp 489.833.918), sehingga gap yang ditampilkan tidak mengikuti pola "kontrak dikurangi faktur" seperti 9 baris lain.

Proyek 0% faktur (17 proyek): #152 IL LAGO SQUARE Rp 193.708.746; #236 MATERA LAKESIDE Rp 146.797.033; #148 LILY PETALS - MATERIAL Rp 101.537.345; #207 OT PANDAAN - MORNING GLORY Rp 80.000.000 (Surabaya); #248 PT. CS2 POLA SEHAT Rp 65.580.000; #177 IL LAGO STUDIO LOFT Rp 55.345.356; #178 GARDENIA - UNIT Rp 52.290.000; #141 NEW SAMARA VILLAGE Rp 26.499.948; #158 LILY - MATERIAL Rp 24.993.808; #179 GARDENIA - MATERIAL Rp 23.806.695; #195 CLUSTER BOHEMIA Rp 23.694.178; #234 MANJID - KERJA TAMBAH Rp 15.450.450; #139 BOSTON VILLAGE Rp 12.689.066; #244 BOSTON VILLAGE Rp 13.211.339; #126 CLUSTER BOHEMIA Rp 12.010.724; #153 FRESCO @TRIMEZIA Rp 11.997.089; #128 GARDENIA MATERIAL Rp 9.359.791.

#### 7.5.4 Temuan 5: `closing_status > 0` (107 Proyek)

Dua kelompok: `closing_status = 99` (CLOSED FINAL) 27 proyek; `closing_status = 1` (CLOSED NORMAL) 80 proyek.

Dari 27 proyek closing 99: 26 berada pada `trash=1, status=0` (dihapus setelah closing, prosedur benar), dan 1 berada pada `trash=0, status=1` (ANOMALI).

Anomali closing 99 tapi masih aktif:

| Project ID | Nama | Closed By | Closed Date |
| --- | --- | --- | --- |
| #8 | PASADENA GRAND RESIDENCES (TROPIS) | everest | 2024-10-31 17:12:15 |
| #9 | MENTENG VILLAGE | everest | 2024-10-31 17:13:06 |
| #11 | PASADENA GRAND RESIDENCES (CLASSIC) | everest | 2024-11-02 09:47:25 |
| #25 | NORTH MALIBU | sys_shadow | 2025-04-17 14:05:31 |

Toleransi: 80 proyek closing normal tetap `status=1` demi akses rekonsiliasi historis, dianggap normal.

#### 7.5.5 Temuan 6: Anomali Administrasi

6a - 15 proyek tanpa SO/SPK (`quot_nomer` dan `project_start_nomer` kosong), semua punya `harga = 0`: #175 Dominos Citra 2 (PT DOM PIZZA, Surabaya); #245 KRISTANTO - CITRA GARDEN 2 (Surabaya); #252 PT. BRATANATA (Surabaya); #255 LILY - UNIT (KSO Paramount Petals); #256 LILY - MATERIAL; #257 LILY - UNIT; #258 LILY - MATERIAL; #276 MAXIM SQUARE; #277 ALTADENA RESIDENCES; #279 PASADENA SQUARE NORTH - UNIT; #281 RUANG BROWNIES (PT Ultra Prima Abadi, Surabaya); #282 VICTORIA CENTRAL DISTRICT - THP 2; #283 AMARILLO VILLAGE; #284 CANNA - UNIT; #285 CANNA - MATERIAL.

6b - 6 proyek punya SO nomer tetapi `harga = 0` (dugaan SPK belum diapprove sehingga nilai belum ter-sync ke `project_produk.harga`): #193 APOTEK BERKAT - PESANGGRAHAN (`588so.1.3557.1`); #259 PASADENA SQUARE NORTH (`588so.1.1478.61`); #260 ALTADENA RESIDENCES PLUS (`588so.1.1478.60`); #261 MAGGIORE SIGNATURE EAST (`588so.1.1478.59`); #262 OMAHA VILLAGE (`588so.1.1478.58`); #263 MATERA RESIDENCES EXTANSION - JASA (`588so.1.1478.57`).

6e - Customer multi-cabang: #1778 BPK. KRISTANTO (2 proyek, cabang 1 dan 33); #2863 PT. DOM PIZZA INDONESIA (22 proyek, cabang 1 dan 33).

Kesehatan global: 165 sehat (faktur lengkap, closing 1, cabang konsisten), 60 dalam proses, 28 anomali, 27 terhapus.

#### 7.5.6 Rekomendasi Tindakan

Prioritas tinggi: (1) normalisasi `cabang_id` baris TPS untuk #281-284 atau update filter EPFC agar memperhitungkan `cabang_id = -1`; (2) evaluasi set `trash=1` atau reset `closing_status` untuk #8, #9, #11, #25.

Prioritas sedang: (3) konfirmasi 15 proyek tanpa SO/SPK; (4) periksa dan sync harga dari SPK untuk 6 proyek harga 0; (5) review 17 proyek 0% faktur.

Monitoring rutin: (6) 60 proyek gap tagihan +/- Rp 6,03 miliar dipantau lewat panel EPFC; (7) 21 mismatch cabang dipantau agar isolasi cabang EPFC akurat.

### 7.6 Audit AR: Kesesuaian Saldo DP Project vs GL 2010050

Tujuan: deteksi otomatis potensi kegagalan posting A/R Receipt (`749`) akibat mismatch antara Saldo Uang Muka Project di UI (`MdlPaymentUangMukaPpn`) dengan Saldo Riil Buku Besar rekening `2010050` (HUTANG KE KONSUMEN).

Query native menyatukan `transaksi_payment_source` (dengan `target_jenis = '749'`, `jenis = '7499'`, `sisa > 1000`) dengan subquery `_rek_pembantu_subcustomer_cache` pada `rekening = '2010050'` atau `extern2_id = '2010050060'`, `periode = 'forever'`, dikelompokkan per `extern_id`. 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`, `status_audit`.

Status `GAGAL_DEFISIT` bila `dpp_uang_muka_dibutuhkan > 0` dan `saldo_riil_gl_2010050 < dpp_uang_muka_dibutuhkan`, selain itu `AMAN`. Kolom view menampilkan tiga label: `PASTI GAGAL` (merah), `BERPOTENSI GAGAL` (kuning, bila saldo GL nol sementara DP positif), `AMAN` (hijau).

Komponen implementasi:

| Jenis | File | Catatan |
| --- | --- | --- |
| Model | `application/models/Coms/ComAuditArProjectDp.php` | Class `ComAuditArProjectDp extends CI_Model`, method `get_audit_report($cabang_id = null)` |
| Controller | `application/modules/penerimaan/controllers/AuditProject.php` | `extends Modul_Controller`, method `index()` |
| View | `application/modules/penerimaan/views/audit_project_view.php` | Tabel DataTables |

Standar kode: PHP 5.6, Query Binding (`$binds = array('749', '7499', 1000)`), docstring `[AGENT_LOG] ... LOG_EXPIRE: 2026-11-05` tanpa inline comment, jQuery 1.12.4, Bootstrap 3.4.1, DataTables 1.10.25 dengan `pageLength: 50`.

### 7.7 Audit Kritis `master_project`: Dekonstruksi God Object

Status audit: berbasis static analysis nama fungsi dan blok kode, tanpa asumsi. Temuan: `MasterData.php` menanggung minimal 5 bounded context sekaligus. Rincian fungsi per domain beserta nomor baris tercantum pada sub-babys 3.5.

Vonis per domain:

- Work Order/RAB/BOM wajib ekstraksi ke `ComProjectWorkOrderEngine.php`; selama `jml * harga` dihitung di Controller, RAB rentan salah saji.
- Task/Execution wajib ekstraksi ke `ComProjectExecutionEngine.php`; status `in progress/done/QC` harus diatur State Machine di Domain Layer, bukan `$this->db->update` mentah di Controller.
- Auto Numbering harus dipusatkan di `ComNumberingEngine.php` global agar pola penomoran seragam di seluruh ERP.
- Core Data Manipulation harus dipisah menjadi `ComProjectMutationEngine.php` dan `ComProjectValidationEngine.php`.
- Sisa yang boleh tinggal di Controller: Presentation & UI Routing.

## 8. Implementasi 3 Kolom Finansial

### 8.1 Definisi Tiga Pilar Angka

| Pilar | Definisi | Field Sumber |
| --- | --- | --- |
| HPP Modal | Modal pokok pengadaan dari supplier / master data | `hpp`, `hrg_hpp`, `hpp_supplier`, `nilai`, `anggaran` (untuk biaya) |
| Harga Budget | Plafon / batas maksimal anggaran belanja internal proyek | `harga_budget` (kolom baru) |
| Harga Jual Project | Harga penawaran / tagihan resmi ke Klien (RAB Klien) | `harga` |

Tujuan: konsistensi 3 pilar di seluruh siklus hidup modul Master Project (588).

### 8.2 Skema Database

Tambah kolom `harga_budget DECIMAL(24,10) DEFAULT 0` pada 4 tabel:

| Tabel | Model |
| --- | --- |
| `project_komposisi` | `MdlProjectKomposisi.php` (daftar di `$fields` dan `$listedFields`) |
| `project_komposisi_workoder` | `MdlProjectKomposisiWorkorder.php` (tambah juga di `lookUpKomposisiFase()`) |
| `project_komposisi_sub_workoder` | `MdlProjectKomposisiWorkorderSub.php` (tambah juga di `lookUpKomposisiFase()`) |
| `project_komponen_biaya_details` | `MdlProjectKomponenBiayaDetails.php` |

Workspace: `w:/everest_29agus`.

### 8.3 Fase 1 sampai 4

Fase 1 - Database & Model: `ALTER TABLE` 4 tabel, daftarkan `harga_budget` di model.

Fase 2 - Shopping Cart (Penawaran):

| File | Perubahan |
| --- | --- |
| `config/coTransaksiUi.php` (`shoppingCartNumFields2` & `shoppingCartEditableFields2`, material) | `jml` = "Jumlah" (editable), `hpp_supplier` = "HPP Modal" (read-only), `harga_budget` = "Harga Budget" (editable), `harga` = "Harga Jual Project" (editable), `subtotal` = "Subtotal" (read-only) |
| `coTransaksiUi.php` (`shoppingCartNumFields3` & `shoppingCartEditableFields3`, biaya) | `jml` = "Jumlah", `anggaran` = "HPP Biaya (Modal)" (read-only), `harga_budget` = "Budget Biaya", `harga` = "Harga Jual Project", `subtotal` = "Subtotal" |
| `coTransaksiUi.php` (`additionalRows`) | `total_anggaran` = "Total Modal / HPP Proyek", `total_budget` = "Total Budget Anggaran Proyek", `harga_non_ppn` = "Total Rincian Jual Barang", `harga_jual_project` = "Harga Kontrak Project (Excl.PPN)", `harga_jual_project_ppn` = "PPN (11%)", `harga_jual_project_nppn` = "GrandTotal", `perkiraan_rl_hpp` = "Estimasi Laba Kotor (Profit)", `perkiraan_rl_ang` = "Selisih Kontrak vs Rincian" |
| `_shoppingCart.php` dan `template/transaksi.html`, `views/shoppingCart.php` | Pastikan pembacaan dan penyimpanan `harga_budget` ke `$_SESSION[$cCode]['items2_sum']` dan `items3_sum` terjaga |

Fase 3 - FollowUp (Review & Approval):

| Komponen | Kolom |
| --- | --- |
| Ringkasan Eksekutif Atas | `No` / `Project Desc` / `Qty` / `Total HPP (Modal)` / `Total Budget` / `Total Jual Project` / `Estimasi Profit` / `Margin %` |
| Mini Table Material | `No` / `Material` / `UoM` / `HPP Modal` / `Harga Budget` / `Harga Jual` / `Qty` / `Total HPP` / `Total Jual` |
| Mini Table Biaya | `No` / `Jasa` / `Cat` / `UoM` / `Ket` / `HPP Biaya` / `Budget Biaya` / `Harga Jual` / `Qty` / `Total HPP` / `Total Jual` |
| Penyimpanan Transaksi Sah | Simpan `harga_budget` dari session ke `project_komposisi`, `project_komposisi_workoder`, `project_komposisi_sub_workoder` |

Fase 4 - MasterData (RAB Eksekusi): kolom `HPP Modal`, `Harga Budget`, `Harga Jual` pada tabel work order dan sub-fase; footer summary `Total HPP (Modal)`, `Total Budget`, `Total Jual (Excl. PPN)`, `Total Profit / Laba Kotor`, `Selisih Kontrak vs Rincian`; `_projectItemEditor.php` mendukung input `Harga Budget`.

### 8.4 Perhitungan Otomatis

```
Total HPP (Modal)         = SUM(HPP x Qty)
Total Budget Anggaran     = SUM(Budget x Qty)
Total Rincian Item (Jual) = SUM(Jual x Qty)
Estimasi Laba Kotor       = Total Jual - Total HPP
```

Proteksi: dialog konfirmasi SweetAlert warning bila `Harga Jual` < `HPP Modal` sebelum penyimpanan. Kompatibilitas: nilai `0` pada `Harga Budget` atau `Harga Jual` tetap tersimpan dan terhitung. Backward compatibility: proyek lama dengan `harga_budget` = 0 fallback menampilkan `harga` jual sebagai estimasi budget.

## 9. Audit dan Walkthrough

### 9.1 Rencana Implementasi Refactoring `penerimaanprojek`

Identitas dokumen: versi `1.0.0`, Client/Project `Everest 13agus` (`application/modules/penerimaanprojek`), tanggal `2026-08-14`, path `z:/everest_13agus`. Status: tidak ada perubahan kode dieksekusi sampai developer memberikan persetujuan eksplisit.

Dasar evaluasi: `AGENTS.md`, `global_rules.md`, standar multi-cabang `audit multi cabang.md`, ISO/IEC 25010, ISO/IEC 27001.

Matriks temuan audit:

| Kategori | Status | Deskripsi dan Lokasi | Risiko |
| --- | --- | --- | --- |
| SQL Injection & Raw Query | NON-COMPLIANT | `$_GET` dan raw string langsung ke SQL tanpa binding: `Transaksi.php:L4818-L4819`, `Transaksi.php:L4479`, `_processSelectNota.php:L165` | CRITICAL |
| Transaction Concurrency Locker | NON-COMPLIANT | Logika lock manual di `FollowUp.php:L1957-L1964` mengabaikan `cabang_id`, risiko false lock takeover antar cabang; `checkLockOrDie()` di `Modul_Controller.php:L75` tidak pernah dipanggil | HIGH |
| Primary Document Filter (`link_id = 0`) | NON-COMPLIANT | Filter di-comment out pada `ActivityReport.php:L7502`, `L9630`, `Transaksi.php:L1972`; menyebabkan data transaksi tampil ganda | HIGH |
| Scanner Session Stability (Mobile) | NON-COMPLIANT | Terdaftar di `AGENTS.md Sec 3.9.5` namun belum punya `followupDariHp()` dan redirect berantai | HIGH |
| Transaction Draft Pattern (MongoDB) | NON-COMPLIANT | `Modul_Controller.php` belum menyediakan `saveDraftAjax()` untuk auto-save draf ke NoSQL MongoDB | MEDIUM |
| Orphan / Shadow Code | NON-COMPLIANT | `__Create.php` (571 KB), `__FollowUp.php` (1.18 MB), `_coTransaksiCore.php` (152 KB), `Debug.php` (935 B) | MEDIUM |
| PHP 5.6 Compatibility | COMPLIANT | Tidak ditemukan sintaks modern incompatible (`??`, `fn()`, `[...]`) | PASS |
| 4 Config Wajib HMVC | COMPLIANT | `coTransaksiCore.php`, `coTransaksiUi.php`, `coTransaksiLayout.php`, `coTransaksiValues.php` lengkap | PASS |

Checklist perbaikan per fase:

| Kode | Fase | Isi |
| --- | --- | --- |
| SEC-01 | 1 | Eliminasi SQL Injection `Transaksi.php`: ganti `WHERE fulldate >= '$_GET[date1]'` dengan Query Builder; refactor `$q_unstarted` ke `$this->db->query($sql, array($externID))` |
| SEC-02 | 1 | Eliminasi SQL Injection `_processSelectNota.php`: `where("status='1' and trash='0' and produk_id='$id_project'...")` ke array Query Builder |
| SEC-03 | 1 | `Debug.php` **tetap dipertahankan** sesuai instruksi eksplisit pengguna |
| LOCK-01 | 1 | Integrasi `checkLockOrDie($jenisTr, $bookingNumber)` di `FollowUp.php`, `Create.php`, `_shoppingCart.php`; kunci komposit `cabang_id = my_cabang_id()`; aktifkan Ambil Alih Transaksi via `?forceRetakeLock=1` |
| FILT-01 | 1 | Aktifkan `$tr->addFilter("link_id='0'")` di `ActivityReport.php` L7502, L9630, L10773 dan `Transaksi.php:L1972` |
| MOB-01 | 2 | Implementasi `followupDariHp()` sesuai AGENTS.md Sec 3.9; redirect berantai via `location.href` (tanpa iframe) ke `createSimpleSessionLogin` -> `forceMobile` -> `followupPrePreview` |
| DRAFT-01 | 2 | `saveDraftAjax()` di `Modul_Controller.php` memakai library `Mongo_db`; cek otorisasi draf (`user_id === my_id()`) |
| SESS-01 | 2 | Preservasi `"main_elements"` saat transisi step di `FollowUp.php` |
| CLEAN-01 | 3 | Hapus/arsipkan `__Create.php`, `__FollowUp.php`, `_coTransaksiCore.php` |
| UI-01 | 3 | Standarisasi header tabel kas di `template/transaksi_payment.html` dengan 3 aktor wajib: `dibuat oleh`, `dibayar/diserahkan oleh`, `diterima oleh` (global_rules.md Sec 5) |

Verifikasi: `php -l` pada 4 controller; uji concurrency locker dengan 2 browser 2 cabang; uji SQL binding dengan filter tanggal berisi karakter petik tunggal; uji filter `link_id = 0` agar baris bayangan `link_id > 0` tidak muncul ganda.

Referensi: ISO/IEC 25010:2011; ISO/IEC 27001:2022; Fowler (2002) *Patterns of Enterprise Application Architecture*, Addison-Wesley, ISBN 978-0321127426; Schwartz, Zaitsev, Tkachenko (2012) *High Performance MySQL* 3rd ed., O'Reilly, ISBN 978-1449314286; OWASP Foundation (2021) *OWASP Top 10:2021 - A03 Injection*, DOI 10.13140/RG.2.2.24240.48644.

### 9.2 Walkthrough Hasil Eksekusi `penerimaanprojek`

Tanggal 2026-08-14. Seluruh tahapan sudah dieksekusi, PHP Lint clean.

| Komponen | File | Perubahan |
| --- | --- | --- |
| Base Controller & Locking | `Modul_Controller.php` | Perbaikan typo string error `$this->configValuesJenis`; `saveDraftAjax()` untuk auto-save MongoDB (AGENTS.md Sec 3.11); `checkLockOrDie()` mengunci komposit `cabang_id` dan mendukung retake lock `?forceRetakeLock=1` bila idle >= 5 menit |
| SQL Binding | `Transaksi.php`, `_processSelectNota.php` | `$q_unstarted` di `Transaksi.php:L4479` memakai placeholder `?` dan `$this->db->query($q_unstarted, array($externID))`; pencarian tanggal GET di `Transaksi.php:L4817` memakai `$this->db->where('fulldate >=', $_GET['date1'])`; kueri raw di `_processSelectNota.php:L165` memakai Query Builder array |
| Scanner & Lock | `FollowUp.php` | Penguncian `cabang_id = my_cabang_id()` mencegah False Lock Takeover; method `followupDariHp()` sesuai AGENTS.md Sec 3.9 |
| Clean Code | - | DELETED: `__Create.php`, `__FollowUp.php`, `_coTransaksiCore.php`. RETAINED: `Debug.php` (935 B) sesuai instruksi pengguna |

Hasil `php -l`: No syntax errors detected pada keempat file.

### 9.3 Walkthrough Refactoring `FollowUp.php` dan `MasterData.php`

**Shadow Verification di `FollowUp.php`:** injeksi pada akhir blok `// endregion locker transaksi` (sekitar baris 8580+), tepat sebelum penyimpanan entri utama `writeMainEntries`. Perbaikan bug lama: `ComLockerStockDualWrite` disesuaikan agar pada `shadow_mode = true` tidak mengeksekusi *explicit SQL ROLLBACK*, karena pemanggilan explicit ROLLBACK menghancurkan outer transaction CI3 yang didefinisikan di awal `doFollowup()`. Log hasil dicatat via `log_message()` dan tidak menggagalkan fungsi asli.

**Pecah God Object `MasterData.php`:** pemindahan 100% full chunk rewrite tanpa placeholder. Fungsi yang dipindah:

| Engine | Fungsi |
| --- | --- |
| `ComProjectWorkOrderEngine.php` | `rebuildMasterKomposisi`, `rebuildMasterKomposisiSub`, `rebuildMasterKomposisi__`, `generatePreSPK`, `generatePreSPK_matikandulu`, `editBom`, `saveBom`, `project_reg_snapshoot` |
| `ComProjectExecutionEngine.php` | `print_tasklist`, `print_tasklist_tambahan`, `addTask_old`, `updateTask`, `editTask`, `removeMaterialTask`, `reloadPaketInstalasiSPK` |
| `ComNumberingEngine.php` | Semua pemanggilan `$this->numbering()` dan `$this->numbering_new()` diarahkan ke `numberingEngine` |
| `ComProjectMutationEngine.php` | `addData`, `editProcess`, `delete`, `cloneMasterWorkOrder`, `cloneMasterWorkOrderKomposisi` |

Validasi: delegasi memakai pola injeksi Dependensi Controller `$this->NamaEngine->fungsi($this)` agar helper `$this->...` tidak crash; struktur CI3 tetap terawat dan fungsi legacy berjalan tanpa intervensi sintaks PHP 7+.

### 9.4 Walkthrough Fase 1 dan Fase 2: Konstanta Baku dan ComStockEngine

Status: selesai, 100% lulus unit test. Lingkungan CI 3.1.8 / PHP 5.6 Legacy Compatibility, workspace `w:/everest_10agus`, pengujian langsung ke `run_everest_modul`.

| Fase | File | Isi |
| --- | --- | --- |
| 1 | `application/config/everest_constants.php` (baru) | Kamus konstanta global elimina magic strings: `WH_STATUS_PUSAT_ID` (12), `WH_STATUS_CABANG_ID` (13), `CABANG_PUSAT_ID` (-1), `GUDANG_PUSAT_ID` (-1), `LOCKER_STATE_ACTIVE`, `LOCKER_STATE_HOLD`, `LOCKER_JENIS_PRODUK`, `PRODUK_KATEGORI_JASA_ID` (4) |
| 1 | `application/config/constants.php` | Mendaftarkan dan memuat `everest_constants.php` saat boot CI3 |
| 2 | `application/models/Coms/ComStockEngine.php` (baru) | Single Source of Truth kalkulasi persediaan: `isCenterWarehouse()`, `getPhysicalStock()` (dari `stock_locker`, `state = 'active'`, `jenis = 'produk'`), `getBookingStock()` (antrean booking SO aktif), `getIntransitStock()` (stok dalam perjalanan), `getStockStatus()` (menghasilkan `stok_fisik`, `stok_booking`, `stok_avail`, `sisa_siap_jual`, `is_minus`) |

Hasil unit test:

| Test | Entitas | Output Engine | Status |
| --- | --- | --- | --- |
| 1 | `SHARP 7BEY` (ID 964) ke Cabang Pinang (Status ID 13, Qty 1) | stok_fisik 3, sisa_siap_jual 2, is_minus false | PASSED |
| 2 | `SHARP 7BEY` (ID 964) ke Pusat/DC (Status ID 12, Qty 1) | stok_fisik 24, sisa_siap_jual 23, is_minus false | PASSED |
| 3 | `SHARP 5BMY2` (ID 24454) ke Cabang Pinang (Status ID 13, Qty 1) | stok_fisik 0, sisa_siap_jual -1, is_minus true | PASSED |
| 4 | `SHARP 5BMY2` (ID 24454) ke Pusat/DC (Status ID 12, Qty 1) | stok_fisik 21, sisa_siap_jual 20, is_minus false | PASSED |
| 5 | Produk Jasa (Kategori ID 4, Qty 5) | stok_fisik 0, is_jasa true, is_minus false | PASSED |

Fase 3 (rencana): menghubungkan controller `penjualan/_shoppingCart.php` dan `_processSelectProduct.php` ke `ComStockEngine` agar tidak lagi menghitung stok manual.

### 9.5 Dokumen Serah Terima: Validasi Closing Project

Masalah: penutupan proyek terblokir oleh selisih Rp 1 akibat pembulatan desimal.

Perbaikan: `application/modules/master_project/views/transaksi.php`, toleransi materialitas `$toleranceDpp = 100` pada logika penonaktifan tombol Terbitkan (DP, Termin, Retensi) di tiga lokasi: baris 6986, 9304, 11527.

```php
// SEBELUM
$btnDpDisabled = $dpReadyToBill > 0 ? "" : "disabled";
// SESUDAH
$btnDpDisabled = $dpReadyToBill > $toleranceDpp ? "" : "disabled";
```

Efek: sisa saldo di bawah Rp 100 membuat tombol `disabled`, sehingga validasi JavaScript `pendingTerbit` pada `getReconClosingIssue()` bernilai 0 dan closing tidak lagi terblokir.

Analisis akar konseptual (genesis): modul `penerimaanprojek` tidak menghitung atau membagi termin secara mandiri, hanya menyalin array `items3` dari registry transaksi induk (Sales Order). Ditemukan di `penerimaanprojek/controllers/_processSelectNota.php` baris 321:

```php
$_SESSION[$cCode]['items3'] = $items3Registries; // disalin dari registry induk
```

Sumber genesis adalah bagaimana nominal termin pertama kali dihitung dan disimpan ke registry di modul hulu (penjualan atau budgeting), yang saat ini menghitung per termin secara independen berdasarkan persentase mentah, bukan sisa akumulatif.

Rencana lanjutan: (1) telusuri penciptaan registry `items3` di hulu (kemungkinan `Create::save()` atau penentuan termin kontrak); (2) terapkan logika Termin Terakhir = Total Nilai Proyek - SUM(termin sebelumnya yang sudah bulat); (3) `round()` ke rupiah bulat sebelum disimpan ke `transaksi_registry`. Dokumen disimpan di folder Artifacts proyek.

### 9.6 Walkthrough: Strict Single-Contract pada Modul Penjualan

Target: misconceptions dualisme model lama,Livet unwarranted ISO 9001, ISO 27001, Clean Code, Roadmap Migrasi Modul Penjualan. Workspace `z:/everest_refaktor`.

Envelope `$customConfig` dikunci langsung per `$jenisTr` aktif (1-level array datar tanpa pembungkus `$jenisTr`), dengan keys: `configCore`, `configUi`, `configLayout`, `configValues`, `payment_source`, `validators`, `paramPatchers`, `paramForceFillers`, `transaksiMaintenance`, `transaksiMaintenanceMsg`, `transaksiMaintenanceStock`, `transaksiMaintenanceMsgStock`.

Penyesuaian domain service:

| Service | Baris | Perubahan |
| --- | --- | --- |
| `ComSalesOrderService.php` | 224-227 | Eliminasi pembacaan bertingkat `[$jenisTr]` dan fallback disk `loadConfigModulJenis_he_misc` |
| `ComSalesOrderService.php` | 446, 736-768 | Ekstrak `$preProcConfig`, `$detailComponents`, `$masterComponents`, `$postProcConfig` dari `$configCoreMaster`; alirkan `$customConfig` ke `ComTransactionPipelineEngine` |
| `ComSalesOrderFollowupService.php` | 126 `processSalesOrderFollowup` | Baca `$stepsConfig` dari `$customConfig['configUi']['steps']` (perbaiki bug lama `$customConfig['steps']`) |
| `ComSalesOrderFollowupService.php` | 356-363 `writeDataRegistries` | Hapus semua indeks `[$jenisTr]` pada `configLayout` dan `configCore` |
| `ComSalesOrderFollowupService.php` | 1537 dan 1575 `validateFollowupGuards` | Baca `steps` dan `autoOtorisasiSesiValidate` dari `$customConfig['configUi']` |
| `ComSalesOrderFollowupService.php` | 1627 `hydrateFollowupReferenceData` | Baca `tableIn` dari `$customConfig['configCore']['tableIn']['detailValues']` |
| `ComSalesOrderFollowupService.php` | 1739-1740 `buildDynamicAccountTables` | Baca `components` dari `$customConfig['configCore']['components'][$jenisTrTarget]` |
| `ComSalesOrderFollowupService.php` | 1842 `applyDppPembulatan` | Baca `valuePembulatan` dari `$customConfig['configCore']['valuePembulatan'][$stepNum]` |
| `ComSalesOrderFollowupService.php` | 1893-1895 | Inisialisasi `$configCoreJenis`, `$configUiJenis`, `$configValuesJenis` langsung dari `$customConfig` |
| `ComSalesOrderFollowupService.php` | 2190 dan 2207 `generateFollowupCounters` | Baca `formatNota` dan `counters` dari `$customConfig['configCore']` |
| `ComSalesOrderFollowupService.php` | 2771-2790 `postFinancialLedgerAndPaymentSources` | Baca `$configCoreMaster`, bersihkan hook debug `arrPrint` dan `matiHere` |

Refactoring Serial Number Extractor (stateless, pipeline-integrated):

| Extractor | Sumber Data | Result |
| --- | --- | --- |
| `PreProdukSerialNumberExtractor.php` | `items2` dan `items` diprioritaskan dari `$inParams`/`$inParams['payload']` | `$this->result = array('items3_sum' => $items3_sum)`; salinan ke `$_SESSION[$cCode]['items3_sum']` hanya fallback mirror |
| `PreProdukSerialNumberExtractorPaket.php` | `items7`, `items6`, `items` dari `$inParams`/`$inParams['payload']` | `$this->result = array('items8_sum' => $items8_sum)`; salinan ke `$_SESSION[$cCode]['items8_sum']` sebagai fallback mirror |

`ComTransactionPipelineEngine.php` dan `ComSalesOrderFollowupService.php` mengalirkan context payload (`payload`, `items`, `items2`, `items6`, `items7`, `customConfig`) ke `$subParams` preProcessor, dan memperbaiki penanganan hasil gate non-`main` dengan menyuntik langsung ke `$transactionPayload[$gateName]`.

ACID Transaction Protection & Standard DTO Failure Contract: `processSalesOrderFollowup()` dibungkus `try { ... } catch (Exception $e)`, integrasi `$this->db->trans_rollback()` otomatis, mengembalikan `array('status' => false, 'code' => 'ERR_FOLLOWUP_FAILED', 'message' => $e->getMessage())`. Breakpoint debug UAT pengguna pada baris 375 dan 397 tetap utuh.

Auto-Authorization Pipeline Contract Alignment (`ComAutoAuthorizationService.php`): aliran `$preProcCustomConfig` utuh ke `executePreProcessors()`; filter `$compValidators` dari `$customConfig['validators']`/`config_item('transaksi_value_required_components')` untuk mencegah entri Rp 0 masuk Buku Besar; kamus `$payConfigs` utuh dengan fallback `config_item('payment_source')`; sinkronisasi locker via `MdlLockerTransaksi->execLocker()`; Zero ACID Leak (tanpa `trans_start()` tersendiri).

Lapisan presentasi (`FollowUp.php`, `Create.php`): hilangkan `mati_disini()` pada cabang kegagalan, terapkan `swalAlert(error)` disertai paksa buka spinner `top.HoldOn.close()` agar UI tidak membeku.

Restorasi silsilah dokumen (audit forensik `z:/everest_29agus/application/modules/penjualan/controllers/FollowUp.php:L10940-L11300`):

- Pemulihan `id_top` transaksi akar: `$resolvedTopID = !empty($topID) ? $topID : (isset($orderHeader['id_top']) && !empty($orderHeader['id_top']) ? $orderHeader['id_top'] : $refId)`.
- Replacer silsilah audit (ISA 500 / ISO 27001): `inv` diisi nomor nota aktif; `ids_prev` & `ids_prev_intext` (serialized base64 array + representasi teks); `nomers_prev` & `nomers_prev_intext`; `jenises_prev` & `jenises_prev_intext`; `nomer_top2`; `ids_his`.
- Sinkronisasi state dokumen akar di `persistFollowupMasterAndSign()`: `next_step_code`, `next_step_label`, `next_group_code`, `next_step_num`, `step_current`, `partial`.

Hasil uji integritas AST: brace nesting 0 (seimbang) dan bracket/parentheses 100% seimbang pada `Create.php`, `FollowUp.php`, `ComSalesOrderService.php`, `ComSalesOrderFollowupService.php`, `ComAutoAuthorizationService.php`, `ComTransactionPipelineEngine.php`, `PreProdukSerialNumberExtractor.php`, `PreProdukSerialNumberExtractorPaket.php`.

## 10. UAT Master Project dan 3 Kolom Finansial

### 10.1 UAT Master Project (Golden Circle dan 5W+1H)

Tiga pilar yang diintegrasikan modul: Finansial (RAB, estimasi HPP, nilai kontrak, PPN, realisasi biaya), Operasional (WO, pembagian fase/area, pembagian tim, milestone/tasklist, QC), Logistik & Inventori (alokasi material, integrasi stok gudang, transaksi pengeluaran material `5882`).

Risiko yang dimitigasi: cost overrun, stock discrepancy dan over-allocation, konflik concurrency, akuntabilitas lapangan.

**WHY:** dianggap mutlak untuk memastikan akurasi dan mencegah 4 risiko di atas.
**HOW:** End-to-End Role-Based Testing dengan prinsip Validasi Awal (fail-fast), Penguncian Transaksi (`MdlLockerTransaksi`), Integritas Data Relasional (`MdlProdukProject` sinkron dengan `MdlProjectWorkOrder`, `MdlProjectKomposisi`, `MdlProjectKomponenBiayaDetailsRab`).
**WHERE:** server Staging/UAT terpisah dengan data master kloning. Pemetaan endpoint:

| Area | Controller |
| --- | --- |
| Master Proyek, Tim, WO, RAB, Tasklist | `master_project/controllers/MasterData.php` |
| Realisasi & Pengeluaran Material | `master_project/controllers/Create.php`, `_shoppingCart.php` |
| Approval & Otorisasi | `master_project/controllers/FollowUp.php` |
| Editor Item & Komponen Biaya | `_projectItemEditor.php`, `_processSelectBiaya.php` |
| Dashboard & Monitoring | `master_project/controllers/ViewDetails.php` |
| Cetak SPK / BAST | `master_project/controllers/Printing.php` |
| Laporan Aktivitas | `master_project/controllers/ActivityReport.php` |

**WHEN:** empat fase.

| Fase | Waktu | Aktivitas | Output |
| --- | --- | --- | --- |
| 1 Pre-UAT | H-2 s/d H-1 | Setup staging, pembersihan data sampah, akun tester per role, briefing skenario | Lingkungan dan data uji siap |
| 2 Eksekusi UAT | Hari H s/d H+2 | Pengujian end-to-end lintas departemen | Log temuan (Issue Tracker) |
| 3 Bug Triage & Fix | H+3 s/d H+4 | Perbaikan Blocker dan Major, re-test | Bug terverifikasi tuntas |
| 4 Sign-Off | H+5 | Evaluasi menyeluruh, Berita Acara, persetujuan rilis | Dokumen Sign-Off ditandatangani |

**WHO:** enam peran tester.

| Peran | Kode Hak Akses | Tanggung Jawab |
| --- | --- | --- |
| Project Manager / SPV | `o_project_spv` | Inisiasi proyek, menyusun RAB, membagi WO, menugaskan tim |
| Tim Pelaksana Lapangan | - | Log progres harian, laporan kendala tasklist |
| Quality Control (QC) | - | Inspeksi mutu, verifikasi checklist, approval Pass/Reject |
| Petugas Gudang | `o_gudang` | Transaksi pengeluaran material `5882`, verifikasi stok fisik |
| Finance / Akuntansi | `o_finance` | Akurasi PPN, HPP, estimasi laba kotor, verifikasi closing |
| QA / Test Coordinator | Developer / QA | Fasilitasi UAT, catat issue log, pandu skenario |

**WHAT:** tujuh skenario dengan total 20 kasus uji.

| Skenario | Komponen | Kasus Uji |
| --- | --- | --- |
| 1 Inisiasi Master Proyek dan Data Kontrak | `MasterData.php`, `MdlProdukProject` | 1.1 Input proyek baru, 1.2 Validasi field mandatori (fail-fast), 1.3 Edit data proyek |
| 2 Pembentukan Tim dan Teamwork | `MasterData.php`, `MdlTimWorkProject`, helper `he_project` | 2.1 Penunjukan SPV dan anggota, 2.2 Batasan hak akses user luar tim, 2.3 Pergantian anggota tim |
| 3 Struktur Work Order dan Ruangan/Area | `MasterData.php`, `MdlProjectWorkOrder`, `MdlProjectWorkOrderSub` | 3.1 Buat SPK/WO utama, 3.2 Buat Sub-WO/Room/Fase |
| 4 Komposisi Material dan Anggaran RAB | `MdlProjectKomposisi`, `MdlProjectKomponenBiayaDetailsRab` | 4.1 Alokasi material/barang, 4.2 Input komponen biaya, 4.3 Validasi kalkulasi Total RAB vs Nilai Kontrak vs HPP vs Margin |
| 5 Tasklist, Progres Fisik dan QC | `MdlTasklistProject`, `MdlTasklistProjectLog`, `MdlTasklistProjectQc` | 5.1 Buat milestone/tasklist (bobot 100%), 5.2 Update progres dan task log, 5.3 Verifikasi dan inspeksi QC (Pass/Reject) |
| 6 Realisasi Pengeluaran Material `5882` | `Create.php`, `_shoppingCart.php`, `_projectItemEditor.php`, `FollowUp.php` | 6.1 Tarik item alokasi WO, 6.2 Ambil sesuai kuota, 6.3 Uji melebihi kuota (ditolak), 6.4 Uji ketersediaan stok fisik (locker stock check) |
| 7 Cetak Dokumen, Dashboard, Closing | `Printing.php`, `ViewDetails.php`, `ActivityReport.php` | 7.1 Dashboard monitoring, 7.2 Cetak SPK/lembar kerja/BAST, 7.3 Closing proyek |

Edge case: (1) Uji penguncian transaksi ganda - dua user browser berbeda pada transaksi yang sama, user kedua dapat peringatan terkunci; (2) Uji pembatalan/void transaksi - stok gudang dan saldo sisa alokasi kembali utuh.

Format defect tracker: No, ID Kasus, Deskripsi Kendala, Langkah Reproduksi, Kategori Bug, Status, PIC Solusi. Kategori: Blocker (alur berhenti total, data rusak, error 500), Major (fitur utama tidak sesuai aturan tapi ada workaround), Minor (fungsional pendukung bermasalah), Cosmetic (tata letak, typo, warna UI).

Berita acara UAT memuat tiga pilihan hasil: DITERIMA TANPA CATATAN, DITERIMA DENGAN CATATAN, DITOLAK. Penandatangan: Project Manager/SPV, Petugas Gudang, Bagian Finance, Lead Developer, QA/Test Coordinator.

### 10.2 UAT 3 Kolom Finansial

Empat tahap pengujian, 14 kasus, seluruh kolom "Hasil Aktual" dan "Status" masih kosong (belum dieksekusi).

| Tahap | Kasus | Ringkasan |
| --- | --- | --- |
| 1 Penawaran / Shopping Cart | 1.1 | Tabel material menampilkan HPP Modal, Harga Budget, Harga Jual |
| | 1.2 | Tabel biaya menampilkan HPP Biaya, Budget Biaya, Harga Jual |
| | 1.3 | Live calculation footer real-time saat ubah Budget/Jual/Qty |
| | 1.4 | Proteksi Harga Jual < HPP Modal memunculkan SweetAlert warning |
| | 1.5 | Input angka 0 tetap tersimpan dan terhitung |
| 2 Review & Approval Kickoff | 2.1 | Ringkasan Eksekutif atas 8 kolom termasuk Margin % |
| | 2.2 | Mini table breakdown material dan jasa |
| | 2.3 | Footer box accordion 3 pilar |
| | 2.4 | Eksekusi approval dan persistensi `harga_budget` ke `project_komposisi`, `project_komposisi_workoder`, `project_komposisi_sub_workoder` |
| 3 Proyek Berjalan & Monitoring RAB | 3.1 | Tabel Ringkasan Anggaran: No, Rencana Kerja, Qty, Total HPP, Total Budget, Total Rincian, Nilai Kontrak |
| | 3.2 | Baris `Total Budget Anggaran:` pada footer berdampingan dengan Total Modal (HPP), Total Rincian Item (Jual), Nilai Kontrak Project |
| | 3.3 | Modal dialog item editor menyimpan field Harga Budget |
| 4 Integritas Data & Kompatibilitas | 4.1 | Kompatibilitas PHP 5.6 dan CI3, tanpa error/warning/blank page |
| | 4.2 | Backward compatibility proyek lama dengan fallback harga |

Lembar tanda tangan: Tester/QA, Product Owner/Estimator, Developer/Engineer, masing-masing dengan opsi Approved/Rejected.

## 11. Temuan Lintas-Dokumen dan Kontradiksi

| # | Temuan | Sumber Berbeda | Dampak / Catatan |
| --- | --- | --- | --- |
| 1 | Ukuran `MasterData.php` | `audit_report_master_project.md` menyebut 28.401 baris; `walkthrough_modul_project.md` menyebut "masif (21k baris)" | Ketidaksesuaian kuantitas baris; estimasi sisa < 2.000 baris tetap konsisten |
| 2 | Near-duplicate `WORKFLOW_AMANDEMEN_INVOICE.md` vs `_DEVELOPER.md` | Judul, arsitektur, dan seluruh konten identik (14.479 vs 14.487 B) | Versi DEVELOPER punya satu baris `end` tambahan di sequenceDiagram Tahap 3; indikasi file tidak dipelihara terpisah |
| 3 | Mekanisme snapshot audit amandemen | `BLUEPRINT_CLEAN_INVOICE.md`: `transaksi_data_registry` dengan `registry_patch = amandemen_v1`; Workflow: tabel `transaksi_amandemen_history` dengan snapshot biner utuh | Dua mekanisme berbeda; belum jelas apakah `transaksi_data_registry` masih dipakai atau diganti |
| 4 | Jumlah maksimum amandemen | Blueprint: "maksimal hanya boleh diamandemen 1 atau 2 kali"; Workflow & FAQ Pengguna: "Maksimal 2x" |ketidakjelasan 1x vs 2x; FAQ konsisten ke 2x |
| 5 | Sifat gate pajak | Blueprint: `die()` menolak seluruh amandemen bila `APPROVED_DJP`; Workflow: opsional, user dapat menyetujui penyerapan selisih (`absorb_tax = TRUE`) | Kontradiksi desain paling material: impide vs opsional |
| 6 | PPN pada kasus penyerapan | Workflow Tahap 4: PPN tetap Rp 512.050; Tahap 5: `ppn_out_bulat` = Rp 479.050 | Grand total Rp 4.834.050 = 4.355.000 + 479.050 konsisten dengan PPN baru, bukan PPN tetap. Narasi "PPN tetap" kontradiktif dengan key yang dicetak |
| 7 | Jenis transaksi invoice | `4822` dipakai pada timeline dan endpoint cetak `viewReceiptReg/4822/...`; `7499` dipakai sebagai Termin Invoice pada timeline dan audit | Keduanya dapat menunjuk invoice; sumber tidak menjelaskan pemetaan Singular-to-Singular secara tegas |
| 8 | Metrik SQL saldo GL | `AUDIT_AR_PROJECT_DP_CHECK.md`: query native `SUM(kredit - debet)`; model PHP `SUM(kredit_akhir - debit_akhir)` | Dua formula berbeda pada tabel yang sama (`_rek_pembantu_subcustomer_cache`); hasil bisa tidak sama |
| 9 | Lokasi modul audit AR | Controller `AuditProject.php` dan view `audit_project_view.php` ditempatkan di `modules/penerimaan/`, bukan `modules/penerimaanprojek/` | Inkonsisten dengan target modul yang diaudit; tidak dijelaskan sumber |
| 10 | Status `GAGAL_SALDO_NOL` | View memeriksa `status_audit == 'GAGAL_SALDO_NOL'`, namun query hanya menghasilkan `GAGAL_DEFISIT` dan `AMAN` | Cabang kondisi mati pada view |
| 11 | Ambang batas overdue KPI | `getSummaryGlobal`: `total_overdue_count` dengan `dtime < NOW() - 24 JAM`; badge aging: Overdue bila `> 48 jam`, Warning `24-48 jam` | Kartu "Overdue (> 24 Jam)" menghitung kondisi yang sama dengan Warning |
| 12 | Watermark Closing | Blueprint alur Step 5 menyebut pemeriksaan "Penerimaan Pencairan Retensi sudah masuk"; `project_produk_items5` menyimulasikan retensi/garansi dengan `tgl_akhir_garansi` | Sumber tidak menyatakan urutan Sequence Closing mana yang tegas antara retensi dan garansi |
| 13 | Skema versioning amandemen | `PANDUAN_LENGKAP_AMANDEMEN_PROJECT.MD` Destiny: tabel `projects`, `project_amendments`, `project_amendment_details` | Implementasi aktual memakai `project_produk` dan `project_komposisi*`; tabel versioning tidak ada jejak di kode nyata |
| 14 | Diff status proyek dashboard | Pra-fix Surabaya: Selesai 5, Proses 8, Tertunda 10 (total 23 dari 18). Post-fix: Selesai 13, Proses 0, Tertunda 5 (total 18). | Kenaikan Selesai 5 -> 13 cukup besar untuk hanya cared oleh capping dan partisi; sumber tidak menjelaskan apakah data DB juga diubah |
| 15 | Numerik gap faktur #102 | `audit_proyek_komprehensif.md` #102 Hyelasmo PIK: Kontrak Rp 489.833.918, Faktur Rp 543.715.649 (faktur > kontrak), Gap Rp 435.952.189 | Gap tidak sama dengan Kontrak - Faktur (bernilai negatif); kemungkinan basis perhitungan gap berbeda, tidak dijelaskan sumber |
| 16 | Lokasi baris SQL Injection | Rencana: `Transaksi.php:L4818-L4819`; Walkthrough: `Transaksi.php:L4817` | Selisih satu baris antara rencana dan hasil eksekusi |
| 17 | Cakupan penghapusan dead code | Rencana CLEAN-01 menghapus 3 file; Walkthrough mengonfirmasi 3 file DELETED dan `Debug.php` RETAINED | Konsisten. Namun rencana tetap mencatat `Debug.php` sebagai temuan MEDIUM ("berisiko keamanan") walau diminta dipertahankan |
| 18 | Link `FILT-01` di luar Component 3 | Rencana menyebut 4 lokasi filter (`L7502`, `L9630`, `L10773`, `Transaksi.php:L1972`) tetapi Component 3 hanya menyebut 3 lokasi | Cakupan tidak konsisten antar sub-bagian rencana |
| 19 | Status dokumen blueprint Settlement | `BLUEPRINT_STANDARISASI_SETTLEMENT_...` dan `BLUEPRINT_KPI_SETTLEMENT_SUMMARY` keduanya "Draf Blueprint (Menunggu Persetujuan Eksekusi)" | Belum ada bukti eksekusi atau hasil verifikasi TC-01..TC-06 |
| 20 | Status rencana 3 Kolom | `implementation_plan_3_kolom.md` adalah rencana (workspace `w:/everest_29agus`) tanpa walkthrough eksekusi | Tidak ada dokumen walkthrough setimbang untuk inisiatif 3 kolom |
| 21 | Hasil UAT belum terisi | Kedua dokumen UAT (Master Project dan 3 Kolom) seluruhnya `[ ]` | Belum ada bukti sign-off UAT untuk kedua fitur |
| 22 | Perbedaan workspace path | `w:/everest_11sept`, `w:/everest_13agus`, `w:/everest_refaktor`, `w:/everest_29agus`, `w:/everest_6sept`, `w:/everest_10agus`, `z:/everest_13agus`, `z:/everest_9sep`, `z:/everest_29agus` | Sembilan workspace berbeda ketiganya dokumentasi merujuk build yang mungkin tidak identik |
| 23 | Termin belum dibenahi di hulu | `dokumen_serah_terima.md`: toleransi Rp 100 sudah dipasang, tetapi genesis pembagian termin di hulu belum dibenahi | Transaksi baru masih berpotensi menghasilkan pecahan desimal |
| 24 | Istilah "akun 1010020010" vs Piutang Dagang | Workflow menyebut Piutang Dagang kode `1010020010` dan PPN `2030060`; settlement memakai kode akun berbeda (`11101-001` dst) | Dua chart of accounts berbeda (piutang usaha vs piutang konsumen); sumber tidak memetakan |
| 25 | Istilah PPh 2% | `PANDUAN_LENGKAP_AMANDEMEN_PROJECT.MD`: PPh Pasal 23 tarif 2% jika ber-NPWP | Angka 2% berasal dari sumber; tidak diverifikasi silang dengan dokumen lain |

## 12. Lampiran: Daftar File Sumber

| Nama File | Ukuran (B) | Topik H1 | Peran dalam Sintesis |
| --- | --- | --- | --- |
| BLUEPRINT_CLEAN_INVOICE.md | 6.097 | BLUEPRINT: Implementasi Modul "Clean Invoice" (Amandemen Transaksi) | Dasar arsitektur Clean Invoice: in-place amandemen, delta, snapshot registry, gembok anti-fraud, roadmap 5 tahap |
| EXECUTIVE_REPORT_CLEAN_INVOICE.md | 4.642 | EXECUTIVE REPORT: Penanganan "Clean Invoice" dan Strategi Kepatuhan Sistem | Memo manajemen 7 Agustus 2026: matriks risiko DJP/ISO 9001/Fraud dan 3 rekomendasi tindak lanjut |
| WORKFLOW_AMANDEMEN_INVOICE.md | 14.479 | Alur Kerja Komprehensif Sistem Amandemen Invoice (Everest ERP) - Developer and Technical Architecture | Spesifikasi implementasi lengkap: HMVC, 4 lapis validasi, ACID, matriks dampak |
| WORKFLOW_AMANDEMEN_INVOICE_DEVELOPER.md | 14.487 | Alur Kerja Komprehensif Sistem Amandemen Invoice (Everest ERP) - Developer and Technical Architecture | Near-duplicate dari file sebelumnya; dipakai sebagai sumber bandinganPetunjuk Pengembang |
| WORKFLOW_AMANDEMEN_INVOICE_PENGGUNA.md | 14.788 | Panduan Alur Kerja Amandemen Invoice (Berdasarkan Tampilan Antarmuka / UI) | Sumber Petunjuk Pengguna: tombol dinamis, banner pajak, kuota 2x, live preview, FAQ 5 baris |
| PANDUAN_LENGKAP_AMANDEMEN_PROJECT.MD | 7.480 | PANDUAN PENGEMBANGAN FITUR AMANDEMEN: MODUL MANAJEMEN PROYEK (TRADING and INSTALASI AC ENTERPRISE) | Sumber Panduan Lengkap: 6 titik amandemen, golden rule, document life cycle, ERD skeleton, ISO dan PPN/PPh |
| ALUR_KALKULASI_TIMELINE_PROJECT.md | 11.073 | ALUR KALKULASI dan PENELUSURAN DATA TIMELINE PROYEK | Pemetaan 6 tabel, klasifikasi jenisTr, 5 fase penelusuran data, rumus ringkasan, anti-double-counting |
| blueprint_alur_project.md | 5.964 | Blueprint Alur Bisnis Modul Master Project | Definisi 5 step lifecycle beserta aktor, prasyarat, output, dan cakupan `MasterData.php` |
| implementation_plan penerimaan projek.md | 14.940 | Analisis, Checklist dan Rencana Implementasi Refactoring Modul `penerimaanprojek` | Matriks temuan 8 kategori, checklist SEC/LOCK/FILT/MOB/DRAFT/SESS/CLEAN/UI, referensi standar |
| walkthrough penerimaan projek.md | 4.034 | Walkthrough: Hasil Eksekusi Refactoring Modul `penerimaanprojek` | Bukti eksekusi: file dihapus, `Debug.php` dipertahankan, PHP Lint clean |
| walkthrough_modul_project.md | 2.994 | Ringkasan Eksekusi: Refactoring `FollowUp.php` dan `MasterData.php` | Shadow verification pada `ComLockerStockDualWrite` dan pemecahan God Object ke 4 engine |
| audit_proyek_komprehensif.md | 15.026 | Laporan Audit Komprehensif - Project Produk Everest ERP | Audit data 280 proyek: mismatch cabang, gap faktur, closing anomali, harga 0, rekomendasi |
| audit_report_master_project.md | 4.332 | LAPORAN AUDIT KRITIS (REVISI DETAIL): Modul `master_project` | Vonis dekonstruksi 5 bounded context dengan nomor baris fungsi dan target engine |
| AUDIT_AR_PROJECT_DP_CHECK.md | 12.840 | DOKUMENTASI TEKNIS dan KODE AUDIT: PENGECEKAN KESESUAIAN SALDO DP PROJECT VS GL 2010050 | Query native, model `ComAuditArProjectDp`, controller `AuditProject`, view DataTables audit DP vs GL |
| KONTEKS_MASTER_PROJECT_DASHBOARD.md | 6.583 | DOKUMENTASI KONTEKS dan ANALISIS DASHBOARD MASTER PROJECT | Perbaikan progress 151% dan partisi status, null Ringkasan Tasklist, aturan role manajemen |
| dokumentasi_duplikasi_master_project.md | 6.240 | Dokumentasi Audit dan Solusi: Duplikasi Terbit Project (Multi-Cabang) | Kasus dual entry MAGGIORE SIGNATURE EAST, root cause, 4 langkah pencegahan duplikasi |
| implementation_plan_master_project_berat.md | 7.232 | Implementation Plan: Optimasi `followupPreview` - master_project | Strategi Session-First dengan DB Fallback, 5 target query duplikat, open questions |
| UAT_MASTER_PROJECT.md | 16.019 | PANDUAN PELAKSANAAN USER ACCEPTANCE TESTING (UAT) MODUL MASTER_PROJECT (METODE GOLDEN CIRCLE and 5W+1H) | Kerangka UAT lengkap: WHY/HOW/WHAT/WHO/WHEN/WHERE, 7 skenario, deliverable, berita acara |
| implementation_plan_3_kolom.md | 7.070 | Rencana Implementasi: 3 Kolom Finansial Wajib (HPP Modal, Harga Budget, Harga Jual Project) | Definisi 3 pilar, skema `harga_budget`, 4 fase implementasi, verifikasi |
| UAT_CHECKLIST_3_KOLOM_FINANSIAL.md | 6.062 | Dokumen Skenario dan Checklist UAT (User Acceptance Testing) | Matriks 14 kasus UAT 3 kolom di 4 tahap, belum ada hasil aktual |
| walkthrough_phase_1_2.md | 2.939 | LAPORAN IMPLEMENTASI FASE 1 dan FASE 2 | Kamus konstanta `everest_constants.php` dan `ComStockEngine`, 5 unit test PASSED |
| BLUEPRINT_STANDARISASI_SETTLEMENT_PSAK_ISO_BESTPRACTICE.md | 13.306 | BLUEPRINT LENGKAP: STANDARISASI MODUL SETTLEMENT (758 - PENERIMAAN SETORAN KAS) | 4 anomali settlement, root cause bug `items8_sum`, compliance matrix PSAK/ISO/COSO, TC-01..TC-06 |
| BLUEPRINT_KPI_SETTLEMENT_SUMMARY.md | 6.618 | BLUEPRINT LENGKAP: REUSABLE KPI SUMMARY CARDS (TOTAL + PER-PENYETOR) | Widget KPI outstanding setoran 759, model, view, badge aging, perilaku per context |
| dokumen_serah_terima.md | 3.631 | DOKUMEN SERAH TERIMA (HANDOVER) | Toleransi `$toleranceDpp = 100` pada tombol DP/Termin/Retensi, genesis pembagian termin, rencana lanjutan |
| walkthrough.md | 16.055 | Walkthrough: Penerapan Strict Single-Contract Konfigurasi Transaksi dan Zero-Overhead Memory | Refactoring konfigurasi 1-level, serial number extractor, ACID DTO, auto-authorization, restorasi silsilah ISA 500 |
