# 📘 PANDUAN KERJA OPERASIONAL: TAHAP 1 DOMAIN-DRIVEN REFACTORING
## Transformasi Controller Monolitik Menjadi Modular Domain Architecture
**Target Lingkungan:** CodeIgniter 3.1.8 / PHP 5.6 Legacy Compatibility  
**Rujukan Ilmiah:** 
* Eric Evans, *Domain-Driven Design* (Addison-Wesley, ISBN: `978-0321125217`)
* Martin Fowler, *Refactoring: Improving the Design of Existing Code* (ISBN: `978-0134757599`)
* Scott J. Ambler, *Refactoring Databases* (ISBN: `978-0321293534`)
* *Journal of Systems and Software* (Elsevier, DOI: [`10.1016/j.jss.2021.110968`](https://doi.org/10.1016/j.jss.2021.110968))

---

## 🎯 TUJUAN UTAMA TAHAP 1
1. Menghilangkan ketergantungan pada *Magic Strings* (`'pusat'`, `'center'`, `'dc'`).
2. Menghapus perhitungan rumus ganda di Controller, View, dan Helper.
3. Menjadikan Controller ramping (*Thin Controller* < 200 baris) yang hanya bertindak sebagai pengatur lalu lintas (*Router/Delegator*).
4. Mengisolasi seluruh akses data di balik **Model Domain (`Com*`)** sehingga tahap normalisasi database nantinya menjadi 100% aman dan bebas risiko.

---

```mermaid
graph TD
    subgraph "BAGIAN 1A: IDENTITAS ENTITAS"
        K["everest_constants.php<br>(Kamus ID & Status Baku)"]
    end

    subgraph "BAGIAN 1B: DOMAIN ENGINES (SINGLE SOURCE OF TRUTH)"
        K --> SE["ComStockEngine.php<br>(Fisik, Avail, Booking, Intransit)"]
        K --> PE["ComPricingEngine.php<br>(Diskon Bertingkat, DPP, PPN 11%)"]
        K --> AE["ComAccountingEngine.php<br>(Jurnal Otomatis, Debit=Kredit)"]
    end

    subgraph "BAGIAN 1C: THIN CONTROLLERS (PENYAMBUNGAN)"
        SE & PE & AE --> SC["_shoppingCart.php"]
        SE & PE & AE --> SP["_processSelectProduct.php"]
        SE & PE & AE --> SI["_selectorItem.php"]
        SE & PE & AE --> CR["Create.php & FollowUp.php"]
    end
```

---

## 📋 BAGIAN 1A: STANDARISASI KAMUS ID & KONSTANTA DOMAIN

### 1. Berkas Utama: [`application/config/everest_constants.php`](file:///w:/everest_10agus/application/config/everest_constants.php)
Seluruh identitas status, ID cabang khusus, dan tipe data **WAJIB** menggunakan konstanta baku.

```php
<?php
defined('BASEPATH') OR exit('No direct script access allowed');

// 1. Identitas Status Gudang (tabel: gudang_status)
defined('WH_STATUS_PUSAT_ID')  OR define('WH_STATUS_PUSAT_ID', 12);  // PUSAT / DC
defined('WH_STATUS_CABANG_ID') OR define('WH_STATUS_CABANG_ID', 13); // CABANG

// 2. Identitas Cabang & Gudang Pusat Default
defined('CABANG_PUSAT_ID') OR define('CABANG_PUSAT_ID', -1); // Cabang Pusat / DC
defined('GUDANG_PUSAT_ID') OR define('GUDANG_PUSAT_ID', -1); // Gudang Reguler Pusat

// 3. Tipe String Entitas Baku
defined('WH_TYPE_PUSAT')  OR define('WH_TYPE_PUSAT', 'pusat');
defined('WH_TYPE_CABANG') OR define('WH_TYPE_CABANG', 'cabang');
defined('WH_TYPE_CENTER') OR define('WH_TYPE_CENTER', 'center');
defined('WH_TYPE_DC')     OR define('WH_TYPE_DC', 'dc');

// 4. State & Jenis Stock Locker
defined('LOCKER_STATE_ACTIVE')  OR define('LOCKER_STATE_ACTIVE', 'active');
defined('LOCKER_STATE_HOLD')    OR define('LOCKER_STATE_HOLD', 'hold');
defined('LOCKER_JENIS_PRODUK')   OR define('LOCKER_JENIS_PRODUK', 'produk');
defined('LOCKER_JENIS_SUPPLIES') OR define('LOCKER_JENIS_SUPPLIES', 'supplies');
defined('LOCKER_JENIS_JASA')     OR define('LOCKER_JENIS_JASA', 'jasa');

// 5. Kategori Khusus Produk
defined('PRODUK_KATEGORI_JASA_ID') OR define('PRODUK_KATEGORI_JASA_ID', 4);
```

### 2. Aturan Larangan Keras (*Strict Rules*):
* ❌ **DILARANG** menulis `if ($jenis == "center")` atau `if ($status == "pusat")` di dalam controller baru.
* ✅ **WAJIB** menggunakan fungsi pembantu atau konstanta: `if ($warehouseStatusId == WH_STATUS_PUSAT_ID)`.

---

## ⚙️ BAGIAN 1B: MEMBANGUN DOMAIN ENGINES TERPUSAT (`Com*`)

Setiap kalkulasi bisnis wajib memiliki **Domain Engine** di `application/models/Coms/`.

### 1. Engine 1: `ComStockEngine.php` (Persediaan & Ketersediaan)
* **Lokasi:** [`application/models/Coms/ComStockEngine.php`](file:///w:/everest_10agus/application/models/Coms/ComStockEngine.php)
* **Fungsi Utama:**
  * `isCenterWarehouse($warehouseStatusId, $name, $type)`: Memvalidasi pusat vs cabang.
  * `getPhysicalStock($productId, $isPusat, $cabangId, $gudangId)`: Mengambil fisik aktif resmi.
  * `getBookingStock($productId, $warehouseStatusId, $cabangId)`: Mengambil antrean booking SO.
  * `getIntransitStock($productId, $isPusat, $cabangId)`: Mengambil stok dalam perjalanan ekspedisi.
  * `getStockStatus($productId, $warehouseStatusId, $cabangId, $cartQty, $kategoriId)`: Mengembalikan array terpadu:
    ```php
    array(
        'stok_fisik'       => 24.0,
        'stok_booking'     => 0.0,
        'stok_intransit'   => 0.0,
        'stok_avail'       => 24.0,
        'sisa_siap_jual'   => 23.0,
        'is_minus'         => false,
        'is_pusat'         => true,
        'is_jasa'          => false,
        'warehouse_status' => 'pusat'
    );
    ```

---

### 2. Engine 2: `ComPricingEngine.php` (Harga, Diskon & Pajak)
* **Lokasi Target:** `application/models/Coms/ComPricingEngine.php`
* **Tanggung Jawab:**
  * Menghitung Diskon Bertingkat: $\text{Harga} \times (1 - d_1) \times (1 - d_2) - d_{\text{nominal}}$.
  * Menghitung Dasar Pengenaan Pajak (DPP) dan PPN 11% Coretax DJP.
  * Menjamin presisi toleransi pembulatan 0 rupiah.

---

### 3. Engine 3: `ComAccountingEngine.php` (Jurnal Otomatis & GL)
* **Lokasi Target:** `application/models/Coms/ComAccountingEngine.php`
* **Tanggung Jawab:**
  * Menghasilkan pasangan Debit & Kredit yang seimbang (*balanced*).
  * Menjamin *Immutable Audit Trail* (tidak ada UPDATE/DELETE pada tabel mutasi keuangan aktif).

---

## ✂️ BAGIAN 1C: MENYAMBUNGKAN CONTROLLER KE ENGINE (*THIN CONTROLLER*)

### 1. Pola Transformasi Kode: Sebelum vs Sesudah

#### 🔴 SEBELUM (Pola Monolitik Rentan Bug di `_shoppingCart.php`):
```php
// KODE LAMA: 30 baris logika kotor di controller
$stok_booking = isset($tmp['stok_booking']) ? ($tmp['stok_booking'] * 1) : 0;
if ($sesMains['pihakMainJenis'] == "center") { // ← Magic string rentan salah
    $stokFisik = isset($tmp['stok_center']) ? ($tmp['stok_center'] * 1) : 0;
    $tmp['stok_ready_input'] = ($stokFisik - $stok_booking) - $itemJml;
} else {
    $stokFisik = isset($tmp['stok']) ? ($tmp['stok'] * 1) : 0;
    $tmp['stok_ready_input'] = ($stokFisik - $stok_booking) - $itemJml;
}
if ($tmp['stok_ready_input'] < 0) { ... }
```

#### 🟢 SESUDAH (Pola Bersih Delegasi ke `ComStockEngine`):
```php
// KODE BARU: 5 baris bersih & bebas bug
$this->load->model('Coms/ComStockEngine');
$stockStatus = $this->ComStockEngine->getStockStatus(
    $iSpec['id'], 
    isset($sesMains['gudang_status_id']) ? $sesMains['gudang_status_id'] : WH_STATUS_CABANG_ID, 
    my_cabang_id(), 
    isset($iSpec['jml']) ? $iSpec['jml'] : 0, 
    isset($tmp['kategori_id']) ? $tmp['kategori_id'] : null
);

$tmp['stok_ready_input'] = $stockStatus['sisa_siap_jual'];
$tmp['stok_ready']       = $stockStatus['sisa_siap_jual'];
$tmp['stok']             = $stockStatus['sisa_siap_jual'];
if ($stockStatus['is_minus']) {
    $arrProdukStokKurang[$iSpec['id']] = ...;
}
```

---

## 🚦 CHECKLIST STANDAR PENGERJAAN SETIAP SUB-MODUL (SOP)

Sebelum menyatakan 1 controller selesai di-refactor, ikuti 4 langkah verifikasi:

1. [ ] **Load Engine:** Panggil `$this->load->model('Coms/NamaEngine');`.
2. [ ] **Hapus Rumus Mentah:** Pastikan tidak ada operasi matematika manual (`-`, `+`, `*`, `%`) di controller.
3. [ ] **Hapus Kueri Database Mentah:** Controller tidak boleh lagi melakukan `$this->db->get('stock_locker')` secara langsung.
4. [ ] **Uji Regresi Otomatis (*Unit Test*):** Jalankan skrip pengujian (seperti `test_com_stock_engine.php`) untuk memastikan hasil kalkulasi 100% cocok dengan skenario:
   * Skenario Cabang (Pinang)
   * Skenario Pusat (DC)
   * Skenario Pengecualian Jasa
   * Skenario Stok Minus / Over-order