# Sintesis Dokumen: Perpajakan, E-Faktur, Integrasi SSO, Session Takeover, Diskon Paket, dan Modul Sampah

**Job ID:** san-perpajakan
**Tanggal sintesis:** 2026-10-02
**Jumlah file sumber:** 12
**Basis dokumen:** BLUEPRINT modul taxes, spesifikasi & dokumentasi service `tax_gateway_service`, dua agent kepatuhan pajak (CTA/TAX), panduan dan ringkasan integrasi Microsoft SSO pada Rise CRM, mekanisme session takeover plus background checker, dokumentasi proporsi diskon/premi Sales Pre Order Packed (1582), blueprint konversi varian, dan blueprint sampah modul.

---

## 2. Ringkasan Eksekutif

Dua jalur pajak coexist dalam dokumentasi ini dan keduanya belum tersambung satu sama lain.

**Jalur A - Modul Taxes (internal ERP, CodeIgniter).** Berada di workspace `c:/xampp/htdocs/new_san_variant`. Menangani setor/kompensasi PPN kurang lebih bayar, penyetoran PPh 21/23/4(2), rekonsiliasi e-Faktur melalui `_processSelectNota.php`, dan jurnal tax settlement. Kunci jenis transaksi: `jenisTr` = `681` (pelunasan/setor PPN), `110` (pembayaran utang pajak PPh 21/23/4(2)), `5681` (rekonsiliasi PPN Masukkan dan Keluaran). Modul ini bekerja di dalam database ERP pada tabel `transaksi_values`, `transaksi_registry`, dan jurnal yang dihasilkan `ComJurnal`.

**Jalur B - Coretax Bridge Microservice (`tax_gateway_service`).** Microservice PHP terpisah sebagai middleware antara Core ERP dan sistem DJP Coretax. Menangani digital signing (PKCS#12), logika pajak per industri (retail, manufaktur bonded zone, jasa/konstruksi), idempotency guard, retry exponential backoff, dan circuit breaker. Empat endpoint: `POST /v1/tax/process`, `GET /v1/tax/status/{ref_no}`, `POST /v1/config/nitku`, `GET /v1/health`. Empat tabel inti: `tax_configs`, `tax_idempotency`, `tax_transactions`, `tax_queue`.

**Tidak ada satu pun dokumen sumber yang menjelaskan bagaimana Modul Taxes memanggil atau berbagi data dengan `tax_gateway_service`.** Ini gap arsitektural paling material: faktur pajak dicatat di dua tempat dengan dua model penomoran berbeda (NSFP di jalur A, `ref_no` plus `request_hash` di jalur B) dan tidak ada kontrak integrasi yang didokumentasikan.

**Integrasi SSO.** Rise CRM (CodeIgniter 4, workspace `w:\san_ibb_2jul`) memakai library Composer `stevenmaguire/oauth2-microsoft`, alur otorisasi Entra ID, dan auto-linking `microsoft_id` berdasarkan email. Auto-registration membuat akun berstatus `inactive` dengan `disable_login` = 0 sehingga wajib disetujui Administrator. Logika sesi memakai kolom `users.last_session_id`; session checker browser berdetak setiap 15 detik ke endpoint `signin/check_active_session`.

**Diskon paket (1582).** Transaksi Sales Pre Order Packed memakai dua tingkat baris: baris utama paket (`$_SESSION[$cCode]['items']`) dan baris komponen (`$_SESSION[$cCode]['items2']`). Alokasi diskon otomatis berbasis `persen_selisih` diganti menjadi alokasi manual tervalidasi dengan penguncian resiprokal, toleransi pembulatan 0.01, dan alat perataan selisih `autoAdjustRoundingAjax()`.

**Modul Sampah.** 17 folder backup (~1.039 file, ~144 MB) plus 17 file controller backup (~2,5 MB) dinyatakan aman dihapus karena tidak memiliki route, include, atau referensi config.

**Temuan berisiko tertinggi:** downgrade PHP dari 8.2+ typed ke 5.6; sertifikat P12 dan passphrase disimpan base64 tanpa enkripsi; tabel `coretax_sync_logs` yang diwajibkan agent TAX tidak ada dalam migration; session checker dilewati untuk `is_admin`, `is_multi_session`, dan `is_debuger`; dan Client Secret SSO dikirim lewat kanal manual ke programer.

---

## 3. Modul Taxes: Perpajakan & E-Faktur

### 3.1 Identitas Modul

| Atribut | Nilai |
|:--|:--|
| Nama modul | `taxes` |
| Workspace | `new_san_variant` |
| Standar | Single Variant Standard & Dual-Write Rollout |
| Tanggal analisis | 2026-07-29 |
| Pola kompleksitas | Transaksi Kompleks |
| Basis controller | `application/modules/taxes/controllers/Modul_Controller.php` |

Pola "Transaksi Kompleks" didefinisikan sebagai pengelolaan setor/kompensasi PPN Kurang Bayar (KB) atau Lebih Bayar (LB), penyetoran PPh 21/23/final, rekonsiliasi e-Faktur via `_processSelectNota`, serta Journal Tax Settlement.

### 3.2 Jenis Transaksi (`jenisTr`)

- `681` - Pelunasan / Setor Pajak PPN (VAT Payment)
- `110` - Pembayaran Utang Pajak PPh 21 / 23 / 4(2)
- `5681` - Rekonsiliasi PPN Masukkan & Keluaran

### 3.3 Konfigurasi Modul

`Modul_Controller::__construct()` memuat empat berkas konfigurasi, pola yang sama dipakai modul `konversi_varian`:

- `config/coTransaksiCore.php`
- `config/coTransaksiUi.php`
- `config/coTransaksiLayout.php`
- `config/coTransaksiValues.php`

### 3.4 Tax Invoice & e-Faktur Matcher

Entry point: `_processSelectNota.php` dengan pendamping `_processSelectProductPpn.php`.

- Input: Nomor Seri Faktur Pajak (NSFP), masa pajak, nominal PPN Masukkan, nominal PPN Keluaran.
- Logika: menyandingkan faktur pajak keluaran terhadap faktur pajak masukkan untuk menghitung PPN Kurang Bayar atau Lebih Bayar.
- Fungsi ini adalah pembeda utama modul `taxes` terhadap mockup global, karena mengupayakan pencocokan nomor seri faktur pajak dengan faktur komersial (Withholding & Netting Tax Manager).

Presisi pencatatan NTPN dan NSFP menjadi syarat pertama sebelum jurnal penyetoran dapat dieksekusi.

### 3.5 Penyetoran Pajak dan Jurnal Settlement

`Create.php` menyediakan `index()`, `preview()`, dan `save()` untuk draf voucher penyetoran pajak ke Kas Negara dengan pencatatan NTPN.

`FollowUp.php` menyediakan `doFollowup()` sebagai tahap execution tax payment, dengan tiga efek samping pada data:

1. **Tax Liability Settlement** - update saldo utang pajak pada tabel `transaksi_values`.
2. **Jurnal Penyetoran Pajak** - memanggil `ComJurnal` mencatat Utang PPN / Utang PPh pada sisi Debit dan Kas/Bank pada sisi Kredit.
3. **Registry Update** - log step registrasi pada tabel `transaksi_registry`.

Jurnal settlement ini adalah titik yang paling mudah ditinjau agent CTA karena dua sisi wajib seimbang tanpa jurnal orphan.

### 3.6 Struktur Controller Target

```
application/modules/taxes/
  config/
    coTransaksiCore.php
    coTransaksiUi.php
    coTransaksiLayout.php
    coTransaksiValues.php
  controllers/
    Modul_Controller.php        # Base controller
    Create.php                  # Form Tax Settlement Entry
    FollowUp.php                # Approval & Execution Payment
    Transaksi.php               # Tax Transaction List
    Taxes.php                   # Tax Engine Processor
    ActivityReport.php          # Laporan Setor Pajak
    History.php                 # Riwayat Penyetoran Pajak
    Printing.php                # Cetak Bukti Setor Pajak / BPN
    ViewDetails.php             # Modal Detail View
    _processSelectNota.php      # Tax Invoice Matcher
    _shoppingCart.php           # Cart Manager
  views/
    transaksi_modul.php
    shoppingCart.php
    printing.php
```

### 3.7 Panduan Developer dan Status

1. Gunakan Tax Invoice Matcher pada `_processSelectNota.php`; pastikan NTPN dan NSFP presisi.
2. Integrasikan `ComJurnal` pada `FollowUp.php` untuk eliminasi Utang PPN / Utang PPh dengan Kas/Bank.
3. Verifikasi PHP 5.6 dengan linting `C:\xampp\php\php.exe -l` dan perbarui `docs/uat-checklist.md`.

Status yang diklaim: pekerjaan selesai (Completed & Verified), blueprint `blueprint_taxes.md` dan `dev-jurnal.md` diterbitkan.

### 3.8 Keterkaitan dengan Sales Package 1582

Modul `taxes` tidak menyebut `jenisTr` 1582 secara langsung, sedangkan `proporsi_diskon.md` dan `penjualan_paked.md` menyebut Sales Pre Order Packed `1582` sebagai `jenisTr` milik modul `penjualan`. Konsekuensinya, alokasi diskon per komponen pada 1582 menentukan basis nilai yang kemudian menjadi dasar penghitungan PPN dan NSFP pada modul `taxes`, tetapi tidak ada dokumen yang mengaitkan kedua alur tersebut secara eksplisit.

---

## 4. Coretax Bridge Microservice (Spesifikasi & Dokumentasi Service)

### 4.1 Dua Versi Dokumen

- `TAX_GATEWAY_SPEC.md` - dokumen **spesifikasi**, judul resmi "Technical Specification: Coretax Bridge Microservice (Indonesia 2026)", 55 baris, tanpa tanggal.
- `TAX_GATEWAY_SERVICE_DOCUMENTATION.md` - dokumen **status implementasi**, tanggal dokumentasi 23 April 2026, 236 baris, secara eksplisit menyebut dirinya dibuat berdasarkan `TAX_GATEWAY_SPEC.md` dengan penyesuaian kompatibilitas legacy environment.

Dokumen implementasi memuat koreksi tidak langsung terhadap spesifikasi pada runtime: PHP 5.6, MariaDB/MySQL via PDO, Redis lewat extension phpredis, OpenSSL untuk PKCS#12 signature.

### 4.2 Stack Teknis

| Komponen | Spesifikasi | Implementasi |
|:--|:--|:--|
| Bahasa | PHP 8.2+ (Typed) | PHP 5.6 compatible |
| Database | MySQL/MariaDB (logs, idempotency) | MariaDB/MySQL (PDO) |
| Cache/Queue | Redis (background jobs, rate limiting) | Redis via phpredis untuk queue dan circuit breaker |
| Kripto | OpenSSL untuk P12 | OpenSSL untuk PKCS#12 signature |

### 4.3 Endpoint

1. `POST /v1/tax/process` - main entry point untuk ERP.
2. `GET /v1/tax/status/{ref_no}` - polling status.
3. `POST /v1/config/nitku` - mengelola data NITKU cabang.
4. `GET /v1/health` - cek koneksi Redis dan DJP Sandbox.

Empat endpoint ini identik antara spesifikasi dan status implementasi, sehingga kontrak eksternal tidak berubah.

### 4.4 Skema Database Empat Tabel Inti

**`tax_configs`** - konfigurasi pajak per company plus branch: NPWP perusahaan, branch code, NITKU, flag pemusatan PPN, sertifikat P12 (base64), passphrase sertifikat (base64), flags JSON (termasuk industry-specific flags). Spesifikasi menyebut sertifikat P12 "encrypted"; status implementasi menyatakan "stored base64 (belum encrypted-at-rest)".

**`tax_idempotency`** - pencegahan double filing: `request_hash` (unique), `ref_no`, status (`Processing` / `Success` / `Failed`), response body. Spesifikasi menyebut `request_hash` berperan sebagai `unique_key`.

**`tax_transactions`** - log utama seluruh tax filing: `ref_no` (unique), `request_hash`, `industry_type`, request body, response body, status, QR URL, attempts, last error. Spesifikasi menyebut kolom sebagai Request, Response, Status, QR_URL.

**`tax_queue`** - fallback queue bila Redis tidak tersedia: queue name, payload, attempt number, execute_after, status. Spesifikasi menyatakan `tax_queue` "Managed by Redis"; status implementasi melurusinya menjadi tabel fallback dengan Redis sebagai primer.

### 4.5 Core Engine

**Digital Signature Engine.** Spesifikasi menyebut class `SignatureService`. Implementasi memecahnya menjadi tiga class dalam namespace `TaxGateway\Security`:

- `TaxGateway\Security\SignatureService`
- `TaxGateway\Security\P12CertificateLoader`
- `TaxGateway\Security\SignatureHeaderInjector`

Mekanisme: baca `.p12` via `openssl_pkcs12_read`, sign payload JSON dengan SHA-256 via `openssl_sign`, injeksi signature ke header `X-DJP-Signature`.

**Idempotency Guard.** Middleware `TaxGateway\Http\Middleware\IdempotencyMiddleware`. Request hash = `sha1(raw_request_body)`. Aturan: reject duplikat dalam window 24 jam, hanya bila status existing `Success` atau `Processing`. Tabel pendukung `tax_idempotency`.

**Retry Policy.** Class `TaxGateway\Queue\RetryPolicy` dengan jadwal: Retry 1 = 30 detik, Retry 2 = 5 menit, Retry 3 = 30 menit.

**Queue Redis.** Queue utama adalah Redis list `tax_gateway:outgoing`; delay queue adalah Redis sorted set `tax_gateway:outgoing:delayed`; fallback ke tabel `tax_queue` bila Redis tidak tersedia.

**Circuit Breaker.** Class `TaxGateway\Queue\CircuitBreaker`. Bila DJP mengembalikan HTTP 503 sebanyak 5 kali, circuit dibuka 10 menit dan alert dikirim via `TaxGateway\Client\WebhookAlertClient`.

### 4.6 Tiga Modul Bisnis Kompleks

**Retail (`TaxGateway\Module\Retail\RetailTaxModule`).** Target 1.000+ outlet. Kompleksitas: NITKU Mapping dan VAT Centralization. Deteksi otomatis status "Pemusatan PPN" (centralized vs decentralized). Centralized: internal transfer menghasilkan VAT journal 0% tetapi tetap di-log untuk "Laporan Mutasi Barang". Decentralized: generate Faktur Pajak otomatis untuk setiap perpindahan antar cabang. Peak-hour handler: jam 07.00-10.00 diberi flag `high_concurrency` dan priority queue tinggi.

**Manufacturing (`TaxGateway\Module\Manufacturing\ManufacturingTaxModule`).** Target pabrik berorientasi ekspor yang berada pada Kawasan Berikat / Bonded Zone. Kompleksitas: PPN 07 (Fasilitas Tidak Dipungut). Validation engine untuk dokumen Bea Cukai (BC) tipe BC 2.3, BC 4.0, BC 2.7. Switch tax code dari `01` (standard) ke `07` (fasilitas) berdasarkan atribut "Destination Zone". Penambahan metadata payload `keterangan_bebas_pajak` otomatis saat tax code `07`.

**Services (`TaxGateway\Module\Services\ServicesTaxModule`).** Spesifikasi menamainya "Construction & Professional Services Module"; implementasi memakai path `Module\Services\ServicesTaxModule`. Kompleksitas: Withholding Tax PPh 23 dan PPh 4(2). Multi-tier: rate NPWP default 2%, rate Non-NPWP default 4%. Mode kalkulasi `gross_up` dan `nett`. Saat settlement: generate dokumen Bukti Potong (Bupot) per vendor item.

### 4.7 Struktur Folder Service

```
tax_gateway_service/
  config/
    .env.example
  migrations/
    20260423_000001_create_tax_configs.sql
    20260423_000002_create_tax_idempotency.sql
    20260423_000003_create_tax_transactions.sql
    20260423_000004_create_tax_queue.sql
  public/
    index.php
  scripts/
    migrate.php
    dispatch_worker.php
  src/
    Autoload.php
    Bootstrap/Application.php
    Client/
    Config/
    Controller/
    Database/
    Http/
    Module/
    Queue/
    Repository/
    Security/
    Service/
    Support/
  composer.json
  README.md
```

Tanggal migration `20260423` konsisten dengan tanggal dokumentasi 23 April 2026.

### 4.8 Komponen Kunci

- Bootstrap aplikasi: `src/Bootstrap/Application.php`
- Tax process service: `src/Service/TaxProcessService.php`
- Dispatch worker: `src/Service/TaxDispatchWorker.php`
- Health check: `src/Service/HealthCheckService.php`
- Tax controller: `src/Controller/TaxController.php`
- Config controller: `src/Controller/ConfigController.php`
- Health controller: `src/Controller/HealthController.php`

### 4.9 Alur Proses Utama

1. ERP mengirim request ke `POST /v1/tax/process`.
2. Middleware idempotency menghitung SHA-1 hash request body.
3. Service memvalidasi payload header dan detail transaksi.
4. Engine menjalankan modul sesuai `industry_type`.
5. Payload ditandatangani memakai sertifikat `.p12`.
6. Transaksi dicatat ke `tax_transactions` dengan status `Processing`.
7. Job dimasukkan ke Redis queue, atau fallback ke `tax_queue`.
8. Worker mengirim payload ke DJP, update status `Success`/`Failed`, atau menjadwalkan retry.

### 4.10 Cara Menjalankan

```bash
copy tax_gateway_service\config\.env.example tax_gateway_service\config\.env
php tax_gateway_service\scripts\migrate.php
php tax_gateway_service\scripts\dispatch_worker.php
```

Document root diarahkan ke `tax_gateway_service/public/index.php`.

### 4.11 Catatan Penting dan Rekomendasi Hardening

- Sertifikat dan passphrase saat ini disimpan base64, belum encrypted-at-rest.
- Worker saat ini fokus antrean Redis; fallback DB queue sudah disiapkan di level penyimpanan.
- Rekomendasi production hardening: encryption-at-rest untuk secret, dead-letter queue, monitoring metrics dan dashboard operasional, serta penguatan otorisasi endpoint berbasis role/permission.

Kekurangan yang belum diimplementasikan namun relevan: enkripsi-at-rest, dead-letter queue, dan otorisasi endpoint. Tidak ada satu pun sumber yang menyebutkan mekanisme authentication pada empat endpoint tersebut.

---

## 5. Integrasi Microsoft SSO pada CRM

### 5.1 Dua Dokumen, Dua Audiens

- `Panduan_Setting_Microsoft_SSO.md` - panduan non-teknis untuk Pemilik/Administrator, 5-10 menit pengerjaan, fokus pada App Registration di Microsoft Azure.
- `Ringkasan_Integrasi_SSO.md` - ringkasan teknis pekerjaan yang sudah selesai, fokus pada kode dan library yang terpasang.

Target sistem adalah **Rise CRM** berbasis CodeIgniter 4 di workspace `w:\san_ibb_2jul`.

### 5.2 Setup Azure App Registration (Non-Teknis)

**Tahap 1 - Pendaftaran aplikasi di `https://portal.azure.com/`** (akun admin Microsoft perusahaan): cari **App registrations** di bar pencarian, klik **+ New registration**, lalu isi formulir - **Name** (misal "CRM Perusahaan"); **Supported account types** = opsi teratas **Accounts in this organizational directory only** (membatasi login hanya untuk karyawan internal); **Redirect URI** platform **Web** berisi `https://[DOMAIN-CRM-ANDA]/signin/microsoft_callback` (contoh pada dokumen: `https://charly.mayagrahakencana.com/signin/microsoft_callback`). Klik tombol biru **Register**.

**Tahap 2 - Client ID:** pada halaman **Overview**, salin nilai **Application (client) ID**.

**Tahap 3 - Client Secret:** menu **Manage** lalu **Certificates & secrets**, tab **Client secrets**, klik **+ New client secret**, isi **Description** (misal "Kunci Login CRM") dan **Expires** = **730 days (24 months)**, klik **Add**. Kode pada kolom **Value** hanya ditampilkan satu kali; setelah refresh akan tersensor permanen dan kunci baru harus dibuat.

**Tahap 4 - Pemasangan:** berikan Client ID dan Client Secret kepada programer, atau masukkan langsung ke kolom Integrasi Login Microsoft pada menu **Settings** CRM.

Parameter yang dikonfigurasi: `Client ID`, `Client Secret`, `Redirect URI` platform Web, `Expires` 730 hari, tipe akun single-tenant.

### 5.3 Library dan Dependency

- Composer: `stevenmaguire/oauth2-microsoft`
- Fungsi: menangani pertukaran authorization code menjadi Access Token dan membaca profil akun Microsoft pengguna.

### 5.4 Komponen yang Diubah

- `signin_form.php` - tombol **Login with Microsoft** di halaman login, mengarah ke rute otorisasi Microsoft.
- `Signin.php` - pusat logika autentikasi.
- `Team_members.php` - tautan (link) dan pemutusan akun (Unlink) pada halaman profil anggota tim.

### 5.5 Tiga Skenario Autentikasi

**Pengguna lama.** Email yang dikirim Microsoft sudah terdaftar di CRM; sistem otomatis menautkan `microsoft_id` ke akun tersebut tanpa login manual.

**Pengguna baru.** Email belum ada di database; sistem menjalankan Auto-Registration. Akun baru tersimpan dengan status `inactive` dan `disable_login` = 0, sehingga wajib disetujui Administrator dan diubah ke status `active`.

**Perbaikan PHP 8.** Diperbaiki masalah Pass-by-Reference pada fungsi `$this->Users_model->ci_save()` yang memicu layar error saat update data karena aturan ketat PHP 8. Perbaikan serupa dilakukan pada `Team_members.php`.

### 5.6 Pesan Error Edukatif

Empat kategori penolakan dengan pesan berbahasa manusiawi:

| Kondisi | Pesan Inti |
|:--|:--|
| Akun belum disetujui | "Akun Anda saat ini berstatus Non-Aktif..." |
| Login ditangguhkan | "Akses masuk (login) Anda ditangguhkan. Silakan minta Administrator untuk menghilangkan centang 'Disable login'..." |
| Login berganda | "Akun Anda sedang aktif di perangkat atau peramban lain..." |
| Akun dihapus | "Akun Anda telah dihapus dari sistem." |

Pencarian alasan penolakan dilakukan secara spesifik ke database, bukan dari pesan error generik.

### 5.7 Kanal Penyerahan Kredensial

Tidak ada federasi atau key vault yang didokumentasikan. Client ID dan Client Secret harus di-paste secara manual melalui kanal non-teknis (Notepad lalu diberikan kepada programer, atau diketik langsung di halaman Settings). Client secret dengan masa berlaku 730 hari menjaga kredensial bernilai sangat sensitif hidup di satu file teks biasa selama hampir dua tahun.

### 5.8 Status Klaim

Dokumen menyatakan seluruh integrasi selesai 100% dan bebas error, dengan catatan dokumen ini dapat menjadi titik awal bila Microsoft Graph API berubah.

---

## 6. Session Takeover & Background Checker

### 6.1 Konteks

Aplikasi Rise CRM (CodeIgniter 4), workspace `w:\san_ibb_2jul`. Domain produksi yang dipakai pada trigger cron dan redirect URI SSO: `https://charly.mayagrahakencana.com`.

### 6.2 Akar Masalah Session Takeover

Gejala: pengguna login via Email dan Kata Sandi ketika akun sedang aktif di perangkat lain via SSO mengalami redirect loop dan selalu mendapat notifikasi kuning "Your account is being used on another device/browser. If this is not you, change your password immediately."

Analisis akar masalah:

1. Setiap halaman terlindungi (`dashboard/view`, `projects`, `tasks`) memuat `Security_Controller.php`.
2. `Security_Controller` membandingkan `session_id()` browser dengan kolom `last_session_id` pada tabel `users`.
3. Sebelumnya `Users_model::authenticate()` hanya memvalidasi kata sandi tanpa meng-update `last_session_id`.
4. Akibatnya setelah login sukses dan redirect ke `/dashboard/view`, `Security_Controller` mendapati session tidak cocok dengan `last_session_id` milik sesi SSO lama, sehingga pengguna langsung ditendang ke `signin?m=...`.

### 6.3 Solusi Takeover

Pada `w:\san_ibb_2jul\app\Models\Users_model.php`, saat verifikasi kata sandi berhasil:

```php
$current_session_id = session_id();
$this->db_builder->where('id', $user_info->id)->update([
    'last_session_id' => $current_session_id,
    'is_active'       => 1
]);
```

Efeknya: login Email/Password mengambil alih sesi aktif dari SSO tanpa loop.

### 6.4 Arsitektur Background Periodic Jobs

URL Trigger `https://charly.mayagrahakencana.com/cron`, dapat dipanggil via Linux Crontab dengan `wget -q -O- .../cron`. Controller `App\Controllers\Cron.php`, library utama `App\Libraries\Cron_job.php`.

**Tugas per jam (Hourly Jobs):** Email Piping via IMAP/Outlook IMAP yang mengonversikan email masuk menjadi Tiket Support; Sinkronisasi Google Calendar; tagihan dan beban berulang melalui `create_recurring_invoices()`, `create_recurring_expenses()`, `create_subscription_invoices()`, `create_recurring_tasks()`, `create_recurring_reminders()`; notifikasi email berupa pengingat sebelum dan sesudah jatuh tempo faktur serta pengingat deadline tugas proyek; Auto-Close Tiket.

**Tugas harian (Daily Jobs):** `remove_old_session_data()` membersihkan data sesi lama pada tabel `ci_sessions` untuk age lebih dari 7 hari; `run_lead_status_transition_workflow()` menjalankan alur otomatisasi dan pengingat follow-up prospek sales.

Dampak pajak yang tidak dibahas: `create_recurring_invoices()` dan `create_subscription_invoices()` menghasilkan faktur berulang tanpa satu pun hook terdokumentasi menuju `tax_gateway_service` atau pencatatan NSFP pada modul `taxes`.

### 6.5 Real-Time Background Session Checker

**Endpoint server** - `app/Controllers/Signin.php`, method `check_active_session()`:

- Ambil `login_user_id`; bila kosong return JSON `['signed_out' => true]`.
- Ambil `get_access_info($login_user_id)`.
- Bila `last_session_id` terisi, bandingkan `session_id()` dengan nilai tersimpan.
- Bypass penuh bila user `is_admin`, `is_multi_session`, atau `is_debuger`.
- Bila tidak cocok: `setForceLogin(true)`, `sign_out()`, return `['signed_out' => true]`.
- Bila cocok: return `['signed_out' => false]`.

**Skrip browser** - `app/Views/includes/custom_body_bottom.php`, heartbeat `setInterval(runSessionCheck, 15000)` dengan AJAX `cache: false` ke `get_uri('signin/check_active_session')`. Bila response `signed_out` bernilai benar, `window.location.href` diarahkan ke `signin?m=Your+account+is+being+used+on+another+device%2Fbrowser.+If+this+is+not+you%2C+change+your+password+immediately.` Logging console memakai prefix `[SESSION CHECKER]`.

### 6.6 Tiga File yang Dimodifikasi

1. `app/Models/Users_model.php` - update `last_session_id` dan `is_active` saat verifikasi password berhasil.
2. `app/Controllers/Signin.php` - endpoint AJAX `check_active_session()`.
3. `app/Views/includes/custom_body_bottom.php` - skrip session checker 15 detik dan perbaikan sintaks JS.

### 6.7 Prosedur Verifikasi

1. Login di Perangkat A, buka Console Browser (F12).
2. Amati log `[SESSION CHECKER] Initializing 15-second active session check loop...` dan heartbeat berulang per 15 detik.
3. Login dengan akun sama di Perangkat B.
4. Dalam maksimal 15 detik Perangkat A ter-kick out dan redirect ke halaman signin dengan pesan peringatan kuning.

---

## 7. Proporsi Diskon, Premi & Sales Package (1582)

### 7.1 Konteks

Transaksi **Sales Pre Order Packed (1582)** pada modul `penjualan`, halaman `penjualan/Create/index/1582`. Dua dokumen sumber: `proporsi_diskon.md` (analisis alur otomatis dan rencana edisi manual) dan `penjualan_paked.md` (kolom Price Bruto, kalkulasi diskon paket utama, dan pengaman batas diskon).

### 7.2 Struktur Data Dua Tingkat

| Tingkat | Kunci session | Isi |
|:--|:--|:--|
| Baris utama paket | `$_SESSION[$cCode]['items']` | paket dengan `subtotal`, `harga_ori`, `harga_disc`, `disc`, `disc_percent` |
| Baris komponen | `$_SESSION[$cCode]['items2']` | tiap komponen dengan `nett1`, `qty`, `disc`, `disc_percent`, `premi`, `premi_percent`, flag `is_edited` |

Kode transaksi `1582` di-expand dalam URL menjadi `penjualan/Create/index/1582`, sehingga segment `1582` adalah penanda tipe transaksi, bukan ID dokumen.

### 7.3 Alur Otomatis Semula

1. **Subtotal Netto Awal** = SUM(Harga Komponen `harga_komponen` x `qty_komponen`) pada variabel `$subtotal_nett1$`.
2. **Selisih Persentase** = (Harga Jual Paket `$subtotal$` / Total Netto Awal Komponen) - 1 pada variabel `$persen_selisih$`. Negatif berarti Diskon Paket (contoh -67.45%), positif berarti Premi Paket.
3. **Alokasi Otomatis** di backend `_processSelectProductPaket.php` menerapkan persentase selisih secara merata ke setiap komponen untuk menghasilkan `Price (Net)` (`nett1`) sehingga total seimbang dengan harga paket utama.

### 7.4 Rencana Edit Manual: Konfigurasi UI

Tombol konfigurasi baru `shoppingCartEditableFields2` pada `config/coTransaksiUi.php` modul `penjualan` untuk step 1:

```php
"shoppingCartEditableFields2" => array(
    1 => array(
        "disc_percent",
        "disc",
        "premi_percent",
        "premi",
        "nett1",
    ),
)
```

Kolom `nett1` (Price Net) direkomendasikan sebagai kolom universal karena otomatis mengevaluasi nilai di bawah bruto sebagai diskon dan di atas bruto sebagai premi.

### 7.5 Logika Resiprokal Lima Kolom

Semua kolom bersifat resiprokal satu sama lain, dipicu pada event keyup/change:

| Input | Perhitungan turunan | Reset lawannya |
|:--|:--|:--|
| `disc_percent` | `disc = (disc_percent / 100) x harga`; `nett1 = harga - disc` | `premi = 0`, `premi_percent = 0` |
| `disc` | `disc_percent = (disc / harga) x 100`; `nett1 = harga - disc` | `premi = 0`, `premi_percent = 0` |
| `premi_percent` | `premi = (premi_percent / 100) x harga`; `nett1 = harga + premi` | `disc = 0`, `disc_percent = 0` |
| `premi` | `premi_percent = (premi / harga) x 100`; `nett1 = harga + premi` | `disc = 0`, `disc_percent = 0` |
| `nett1`, kondisi A (`nett1 < harga`) | `disc = harga - nett1`; `disc_percent = (disc / harga) x 100` | `premi = 0`, `premi_percent = 0` |
| `nett1`, kondisi B (`nett1 >= harga`) | `premi = nett1 - harga`; `premi_percent = (premi / harga) x 100` | `disc = 0`, `disc_percent = 0` |

### 7.6 Validasi Ganda

**Client-side.** Menjumlahkan `SUM(Price Net_i x Qty_i)` secara real-time, membandingkan dengan Harga Jual Paket Utama, menampilkan peringatan merah dan men-disable tombol Save/Submit bila tidak seimbang.

**Server-side.** Di `Create.php` dan `FollowUp.php`, sebelum simpan ke MySQL atau lanjut ke approval:

```php
$cCode = $this->cCode;
$total_komponen = 0;
if (isset($_SESSION[$cCode]['items2'])) {
    foreach ($_SESSION[$cCode]['items2'] as $pID => $subItems) {
        foreach ($subItems as $komponen) {
            $total_komponen += ($komponen['nett1'] * $komponen['qty']);
        }
    }
}
$total_paket = 0;
if (isset($_SESSION[$cCode]['items'])) {
    foreach ($_SESSION[$cCode]['items'] as $itemUtama) {
        $total_paket += $itemUtama['subtotal'];
    }
}
if (abs($total_komponen - $total_paket) > 0.01) {
    echo "<script>alert('Validasi Gagal: ...'); history.back();</script>";
    exit();
}
```

Toleransi pembulatan desimal kecil: 0.01.

### 7.7 Lima Perbaikan Hasil Uji

**7.7.1 Bug persentase desimal awal (0.674 vs 67.4%).** `disc_percent` dan `premi_percent` pada blok inisiasi awal di `_processSelectProductPaket.php` tidak dikalikan 100 sehingga tersimpan sebagai pecahan desimal. Solusi: dikalikan 100 secara konsisten di semua blok alokasi persentase awal.

**7.7.2 Tombol Continue tidak terkunci (iframe scoping).** Peringatan merah muncul tetapi tombol **Continue SALES PRE ORDER PACKED** tetap aktif. Penyebab ganda: (1) JavaScript di `shoppingCart.php` menargetkan `#tic_lavant` yaitu `#tic_lanjut` pada level `top` parent window, padahal pada langkah paket tombol yang mengontrol kelanjutan adalah `#btnProcess`; (2) `#btnProcess` berupa tag jangkor `<a>`, bukan `<button>`, sehingga `.prop('disabled', true)` diabaikan. Solusi: JavaScript dibuat adaptif, menonaktifkan tombol pada level dokumen saat ini maupun level `top`; untuk `<a>` `#btnProcess` ditambahkan kelas Bootstrap `.disabled` plus CSS `pointer-events: none`.

**7.7.3 Saling mengunci diskon dan premi (mutual exclusion).** Fungsi JavaScript `toggleInputLocker` di `shoppingCart.php`: bila kolom diskon (`disc_percent`/`disc`) menerima fokus atau input, kolom premi pada baris sama di-set `0` dan `disabled`, dan sebaliknya. Inisialisasi ulang dilakukan saat halaman dimuat untuk mendeteksi kolom mana yang harus dikunci berdasarkan nilai yang sudah ada di session.

**7.7.4 Pengaman batas maksimum diskon.** Frontend: `onkeyup` pada input `disc` dibatasi tidak melebihi `harga_ori`; `disc_percent` dibatasi maksimal 100%. Backend: clamping di controller `recordItemColumn2` pada `_shoppingCart.php`; pada `penjualan_paked.md` disebut clamping 0 sampai 100 di `_processSelectProductPaket.php` sebelum kalkulasi.

**7.7.5 Penyesuaian pembulatan otomatis.** Tombol **"Sesuaikan Pembulatan Otomatis"** (istilah lain pada dokumen kedua: **"Sesuaikan Sisa Diskon Secara Otomatis"**) memanggil endpoint AJAX `autoAdjustRoundingAjax()` di `_shoppingCart.php`. Fungsi ini mendeteksi selisih total desimal, mendistribusikannya ke komponen pertama yang belum diedit manual, menghitung ulang total secara global via `ValueGate`, lalu me-reload cart. Peringatan merah hilang dan tombol continue aktif kembali.

Perlindungan data manual: saat user mengedit via `recordItemColumn2()`, sistem menandai komponen dengan flag `is_edited = true` di session. Saat perataan berjalan, sistem mencari komponen pertama dengan `is_edited != true` untuk menyerap selisih. Bila semua baris sudah diedit manual, selisih diletakkan pada baris komponen terakhir.

Penanganan race condition: klik tombol membatalkan request penyimpanan blur yang sedang berjalan sehingga `is_edited` gagal terkirim. Solusi: fungsi `autoAdjustRounding()` memakai pengecekan `$.active > 0` dengan penundaan rekursif 200 ms sebelum memicu perataan.

### 7.8 Price Bruto dan Akumulasi `harga_ori`

Kolom **Price (Bruto)** (`harga_ori`) pada baris utama paket dihitung dinamis dari akumulasi harga bruto komponen di `items2`, karena data itu tidak disimpan langsung di baris utama `items`.

Masalah yang diperbaiki:

- **Nilai 0** - session baris paket utama tidak memiliki properti `harga_ori`. Solusi: menambahkan akumulasi `harga_ori` dari `items2` pada loop formatting di `_shoppingCart.php` (fungsi `viewCart()`) dan `Create.php` (tiga loop pemrosesan `items`).
- **Salah hitung saat Disc (%) baris utama diubah** - JavaScript `shoppingCartKeyUpEvents` di `coTransaksiUi.php` memakai target `{harga}` (Harga Jual Paket) sebagai dasar perkalian persentase, sedangkan backend `_processSelectProductPaket.php` memakai `harga_orig`. Contoh numerik dari dokumen: input 10% diskon dari paket 20 juta menghasilkan netto 18 juta, tetapi setelah reload sistem menghitung diskon terhadap bruto 61 juta sehingga persentase berubah menjadi 70.7%. Solusi: keyup event diarahkan ke `{harga_ori}`; fungsi `select()` di `_processSelectProductPaket.php` menghitung total `harga_ori` komponen lebih dulu sebagai base price diskon sebelum menghitung Netto baru (`harga_disc`).

### 7.9 Sumber Selisih Pembulatan

Setiap komponen dihitung dengan fungsi global `pembulatanDiskon()` yang membuang angka desimal di belakang koma (integer floor). Akumulasi pemotongan desimal pada seluruh 10 komponen menimbulkan selisih total Rp 6 terhadap harga jual paket. Inilah akar penyebab tool `autoAdjustRoundingAjax()`.

### 7.10 Empat Berkas yang Terdampak

1. `config/coTransaksiUi.php` - kolom `harga_ori` sebelum `harga`; event `onkeyup` pada `disc_percent` dan `disc` memakai `{harga_ori}`; limit clamping.
2. `controllers/_shoppingCart.php` - pengisian dinamis `harga_ori`, `disc`, `disc_percent` di `viewCart()`; endpoint `autoAdjustRoundingAjax()`; clamping di `recordItemColumn2()`.
3. `controllers/Create.php` - pengisian dinamis `harga_ori`, `disc`, `disc_percent` pada tiga loop formatting data.
4. `controllers/_processSelectProductPaket.php` - pembaruan logika `disc_percent` pada method `select()` berbasis total `harga_ori` komponen plus pengaman batas desimal diskon.

---

## 8. Modul Sampah

### 8.1 Posisi Dokumen

`blueprint-sampah-modul.md` adalah bukti pembuangan Batch 1, dengan klaim setiap item sudah diverifikasi bebas route, bebas include/require, dan bebas referensi config. Workspace eksekusi: `W:\san_staging`.

### 8.2 A. Folder Backup - 17 Folder (~144 MB)

| Folder | File | Size | Bukti |
|:--|--:|--:|:--|
| `variant_cutover_backup/` | 70 | 9.7 MB | Tidak ada referensi di routes.php, config/*.php, heMenu, heNavigation |
| `pembelian_05mei2026/` | 79 | 11.4 MB | Sama |
| `pembelian_26apr2026/` | 78 | 11.4 MB | Sama |
| `pembelian_28apr2026/` | 74 | 8.6 MB | Sama |
| `kasOLD/` | 73 | 10.8 MB | Sama |
| `penerimaanOLD/` | 59 | 10.0 MB | Sama |
| `opname_v0/` | 57 | 10.6 MB | Sama |
| `opname_ori/` | 54 | 10.3 MB | Sama |
| `pindahgudang_/` | 58 | 7.8 MB | Sama |
| `pindahgudang_29apr2026/` | 65 | 10.3 MB | Sama |
| `pembelianimport_26apr2026/` | 74 | 9.4 MB | Sama |
| `taxes_24apr2026/` | 69 | 10.0 MB | Sama |
| `pembelianprojek__/` | 72 | 8.2 MB | Sama |
| `akunting_/` | 3 | 51 KB | Sama |
| `produksi_sebelum_geser_bom/` | 62 | 9.8 MB | Sama |
| `laporankeuangan_ori_sebelum_suport_neraca_adjustment/` | 7 | 2.6 MB | Sama |
| `laporankeuangan_sebelum_adj_20240118/` | 7 | 2.6 MB | Sama |

Total: ~1.039 file, ~144 MB. Catatan pada dokumen: `akunting_/` hanya 3 file (51 KB), kemungkinan stub atau sisa rename.

Relevansi pajak: folder `taxes_24apr2026/` berisi 69 file backup modul taxes bertanggal 24 April 2026, satu hari setelah tanggal dokumentasi `TAX_GATEWAY_SERVICE_DOCUMENTATION.md` (23 April 2026). Dokumen tidak menjelaskan hubungan temporally tersebut.

### 8.3 B. File Controller Backup - 17 File (~2.5 MB)

| File | Size | Bukti |
|:--|--:|:--|
| `Data_.php` | 82 KB | Tidak ada di routes.php/config. Nama class tidak match filename |
| `Data_korekiai.php` | 324 KB | Class `Data` duplikat `Data.php`; tidak dapat di-load CI karena filename != nama class |
| `Data_ori.php` | 263 KB | Tidak ada referensi di routes/config |
| `Ledger_ori.php` | 257 KB | Sama |
| `ReportORI.php` | 237 KB | Sama |
| `ReportModif.php` | 244 KB | Sama |
| `AutoLoanInterest_old_20200919.php` | 168 KB | Sama - nama mengandung "old" |
| `AutoLoanInterest_old_20200919 - Copy.php` | 168 KB | Sama - file copy |
| `AutoLoanInterest_sblm_update_30-08-2020.php` | 168 KB | Sama |
| `SetupLoanInterest_old_20200919.php` | 104 KB | Sama |
| `SetupLoanInterest_old_20200919 - Copy.php` | 104 KB | Sama |
| `RunRugilaba_bak.php` | 126 KB | Sama - "bak" = backup |
| `SetupDepresiasiTmp.php` | 149 KB | Sama - "Tmp" = temporary |
| `_tray_bak.php` | 57 KB | Sama |
| `Welcome_original.php` | 30 KB | Sama |
| `ProductPkgEditor1.php` | 17 KB | Class `ProductPkgEditor1`; tidak ada route |
| `arrayjs.js` | 70 KB | File JavaScript di folder controller - tidak dapat di-load CI |

### 8.4 C. File Sisa Lainnya

| Path | Size | Keterangan |
|:--|:--|:--|
| `application/modules/pembelian.rar` | ~3-5 MB (est) | File RAR di folder modules, bukan PHP |
| `application/controllers/nbproject/` | - | Folder project NetBeans |
| `application/modules/.idea/` | - | Folder project PHPStorm |
| `application/controllers/.idea/` | - | Folder project PHPStorm |

### 8.5 Rekomendasi dan Perintah Eksekusi

Empat rekomendasi: buang folder backup A dengan `Remove-Item -Recurse`; buang file controller B dengan `Remove-Item`; buang file sisa C (IDE artifacts); bersihkan `checklist-sampah-modul.md` setelah eksekusi.

Perintah PowerShell membangun array `$backupFolders` (17 path relatif `application\modules\...`) dan `$backupFiles` (17 path relatif `application\controllers\...`), lalu mengeksekusinya terhadap root `W:\san_staging`. Dua IDE artifact dihapus eksplisit: `W:\san_staging\application\controllers\nbproject` dan `W:\san_staging\application\modules\pembelian.rar`. Blok akhir menyebut pembaruan `AGENTS.md` secara manual via prompt.

### 8.6 Verifikasi Pasca-Eksekusi

Dua perintah `Select-String` menjadi gerbang verifikasi:

- `application\config\routes.php` dengan pattern `Data_|Data_korekiai|Data_ori|Ledger_ori|ReportORI|ReportModif`.
- `application\config` dengan pattern `variant_cutover_backup|pembelian_05mei2026|pembelian_26apr2026|kasOLD`.

Keterbatasan: verifikasi ini hanya menutup route dan config. Tidak ada pemeriksaan terhadap `heMenu`, `heNavigation`, autoload, atau data historis yang mungkin masih menunjuk folder terhapus, meski `heMenu` dan `heNavigation` justru disebut sebagai dasar bukti pada tabel bagian A.

### 8.7 Konteks Pendamping: Blueprint `konversi_varian`

Dokumen blueprint ketiga dengan templat identik (`Single Variant Standard & Dual-Write Rollout`, tanggal analisis 2026-07-29, workspace `new_san_variant`). Bukan sampah, tetapi relevan karena mengubah basis nilai persediaan yang menjadi sumber perhitungan PPN.

- `jenisTr` `881` - Konversi Varian Produk (misal Warna Merah XL menjadi Hitam L).
- `jenisTr` `7881` - Konversi Varian Supplies.
- `_processSelectProductConvertion.php` dan `_processSelectSuppliesConvertion.php` memetakan `variant_id_asal` dan `variant_id_tujuan` serta memasang lock state `hold` via `ComLockerStockDualWrite` / `ComLockerStockSuppliesDualWrite`.
- `FollowUp.php` `doFollowup()` memanggil `ComLockerStockDualWrite::pair()` untuk mengurangi stok `variant_id_asal` (`-active`) dan menambah stok `variant_id_tujuan` (`+active`); `ComLockerStockSuppliesDualWrite::pair()` untuk `7881`. Jurnal dicatat `ComJurnal` Persediaan Varian Target (D) vs Persediaan Varian Sumber (K), lalu log ke `transaksi_registry`.
- Tabel yang disentuh: `stock_locker_variant` dan `stock_locker_supplies_variant`.
- Cart key yang perlu diproses: `supplies:{id}:{variant_id}`.
- Verifikasi: linting `C:\xampp\php\php.exe -l` dan update `docs/uat-checklist.md`.

---

## 9. Peran Agent Compliance/Tax & Tax Integration

### 9.1 Dua Agent, Batas yang Saling Bertabrakan

| Aspek | `compliance_tax` (CTA) | `tax_integration` (TAX) |
|:--|:--|:--|
| Nama | compliance_tax | tax_integration |
| Kode identitas | CTA | TAX |
| Peran | Financial Compliance, IFRS/PSAK Expert, Tax Auditor | Tax Accountant & Coretax DJP Gateway Specialist |
| `enable_write_tools` | true | true |
| `enable_subagent_tools` | false | false |
| Fokus | Akuntansi, jurnal, pembulatan, PSAK/ISA | Rekonsiliasi, tarif, payload Coretax |
| Larangan kode | DILARANG menulis kode, hanya audit opinion | DILARANG menulis kode, hanya logika dan spesifikasi |

Keduanya menunjuk referensi proyek yang sama: `AGENTS.md` (konteks penuh proyek ERP) dan `KAMUS_TRANSAKSI.md` (kamus referensi kode tipe transaksi).

### 9.2 Agent CTA - Aturan Mutlak dan Checklist

Aturan mutlak: wajib memakai standar IFRS/PSAK, ISA, dan hukum positif yang berlaku; setiap klaim angka atau pasal wajib menyebutkan nama standar atau pasal secara spesifik; bila tidak yakin, dilarang menebak, dan cukup menyatakan "Data tidak tersedia" atau "Membutuhkan konfirmasi eksternal"; kritik wajib dibagi tiga kategori; wajib menolak dokumen bila kalkulasi pajak tidak akurat, pembulatan salah, jurnal tidak seimbang (Debit != Kredit), atau melanggar prinsip akuntansi.

Enam peran utama: audit arsitektur dan fungsionalitas fitur dari sisi kepatuhan akuntansi; validasi logika kalkulasi pajak (PPN 11%, PPh 21/22/23/25/29); verifikasi double-entry tiap jurnal; pemeriksaan kepatuhan PSAK; identifikasi risiko salah saji material; validasi aturan pembulatan pajak.

Checklist validasi wajib:

- Debit = Kredit (setiap jurnal)
- PPN dihitung dari DPP, bukan dari harga termasuk pajak (kecuali ditentukan lain)
- Pembulatan ke bawah untuk PPN (sesuai aturan DJP)
- PPh dipotong sesuai tarif pasal yang berlaku
- Mata uang konsisten (IDR, atau konversi kurs tengah BI jika valas)
- Tidak ada jurnal orphan

Standar referensi: PSAK 1 (Penyajian Laporan Keuangan), PSAK 2 (Laporan Arus Kas), PSAK 16 (Aset Tetap), PSAK 46 (Pajak Penghasilan), PSAK 65 (Laporan Keuangan Konsolidasian), PSAK 71 (Instrumen Keuangan), PSAK 72 (Pendapatan dari Kontrak dengan Pelanggan), UU HPP (Harmonisasi Peraturan Perpajakan), serta PMK terkait PPN, PPh, dan Faktur Pajak.

Format output `=== AUDIT COMPLIANCE ===` memuat MODUL, STANDAR REFERENSI, TEMUAN tiga kategori (KELEMAHAN LOGIKA, RISIKO KEPATUHAN HUKUM, CELAH SALAH SAJI), VERDICT (`LULUS` / `DITOLAK` / `PERLU REVISI`), dan CATATAN.

### 9.3 Agent TAX - Peran, Tarif, dan Integrasi Coretax

Aturan mutlak: semua angka pajak akurat hingga satuan rupiah terkecil; pembulatan PPN wajib ke bawah; Faktur Pajak wajib memenuhi syarat formal dan material sesuai PER-03/PJ/2022; selisih antara data ERP dan Coretax wajib dilaporkan sebelum batas waktu pelaporan SPT; dilarang menebak tarif; seluruh sinkronisasi wajib memakai idempotency key.

Enam peran utama: rekonsiliasi faktur pajak ERP internal versus Coretax DJP; validasi PPN (PPN Keluaran - PPN Masukkan = PPN Kurang/Lebih Bayar); validasi pemotongan PPh (Pasal 21, 22, 23, 25, 26, 29, 4(2)); deteksi anomali (faktur tidak dilaporkan, selisih DPP, duplikasi NSFP); penyusunan rekapitulasi bulanan/tahunan; perancangan logika sinkronisasi API/XML Coretax (payload, endpoint, response handling).

Format output `=== TAX RECONCILIATION ===` memuat MASA PAJAK, JENIS PAJAK, REKONSILIASI (ERP Internal / Coretax DJP / SELISIH beserta penyebab), ANOMALI TERDETEKSI, FAKTUR STATUS (Dilaporkan, Belum Dilaporkan, Batal, Pengganti), REKOMENDASI, dan BATAS WAKTU deadline pelaporan SPT.

**Tarif referensi (berlaku per 2025):**

| Pajak | Tarif |
|:--|:--|
| PPN | 11% dari DPP (UU HPP) |
| PPh 21 | Progresif 5% / 15% / 25% / 30% / 35%, PTKP sesuai PMK terbaru |
| PPh 22 | 0.25% - 7.5% tergantung jenis barang |
| PPh 23 | 2% (jasa) / 15% (dividen, bunga, royalti) |
| PPh 25 | Angsuran bulanan |
| PPh 4(2) | Final: 10% sewa tanah/bangunan, 0.5% UMKM, dan sejenisnya |
| PPh 29 | Kurang bayar tahunan |

**Spesifikasi integrasi Coretax DJP yang diwajibkan agent TAX:**

- Format: XML/JSON sesuai spesifikasi Coretax API
- Autentikasi: OAuth 2.0 / Certificate-based
- Idempotency: setiap request wajib memiliki unique idempotency key
- Retry: exponential backoff untuk failure handling
- Logging: seluruh request/response wajib dicatat di `coretax_sync_logs`

### 9.4 Rekonsiliasi terhadap Implementasi yang Ada

Pemetaan terhadap `tax_gateway_service`:

| Kewajiban agent TAX | Status di implementasi | Catatan |
|:--|:--|:--|
| Idempotency key per request | Terpenuhi sebagian | `IdempotencyMiddleware` memakai `sha1(raw_request_body)`, bukan key dari pemanggil |
| Logging di `coretax_sync_logs` | Tidak terpenuhi | Tabel tidak ada dalam 4 migration; log ditempatkan di `tax_transactions` dan `tax_idempotency` |
| Autentikasi OAuth 2.0 | Berbeda | Implementasi memakai PKCS#12 certificate signing dengan header `X-DJP-Signature` |
| Retry exponential backoff | Terpenuhi | `RetryPolicy` 30s / 5m / 30m |
| Rekonsiliasi PPN KB/LB | Tidak ada di service | Dilakukan di modul `taxes` via `_processSelectNota.php` (jenisTr 5681) |
| PPh 21, 22, 25, 26, 29 | Tidak ada | Hanya PPh 23 dan PPh 4(2) yang diimplementasikan di `ServicesTaxModule` |
| Deteksi duplikasi NSFP | Tidak ada | Deduplikasi berdasarkan `request_hash`, bukan nomor seri faktur pajak |

---

## 10. Temuan Lintas-Dokumen & Kontradiksi

### 10.1 Kontradiksi Teknis

**K1. Versi PHP.** `TAX_GATEWAY_SPEC.md` mewajibkan PHP 8.2+ (Typed); `TAX_GATEWAY_SERVICE_DOCUMENTATION.md` menyatakan implementasi disesuaikan ke PHP 5.6 compatible. Ada resolution yang terdokumentasikan, tetapi tanpa alasan teknis dan tanpa migration plan. Dampak: blueprint `taxes` justru memverifikasi PHP 5.6 lewat `C:\xampp\php\php.exe -l`, sehingga standar runtime yang dipatuhi adalah 5.6, bukan 8.2 yang diminta spesifikasi.

**K2. Status enkripsi sertifikat P12.** Spesifikasi menulis P12 certificates "encrypted"; dokumentasi implementasi mengakui "stored base64 (belum encrypted-at-rest)", termasuk passphrase. Kredensial tanda tangan legal tertinggi disimpan tanpa proteksi di tabel `tax_configs`.

**K3. Peran `tax_queue`.** Spesifikasi: "`tax_queue`: Managed by Redis"; dokumentasi: tabel database sebagai fallback saat Redis tidak tersedia. Dua sumber tidak sinkron tentang medium penyimpanan.

**K4. Nama modul Constructing vs Services.** Spesifikasi menyebut "Construction & Professional Services Module"; dokumentasi memakai path `Module\Services\ServicesTaxModule` dan label "Services Module". Tidak jelas apakah manufaktur bonded dan jasa konstruksi dipisah atau digabung.

**K5. Tabel `coretax_sync_logs` tidak pernah dibuat.** Agent TAX mewajibkan pencatatan seluruh request/response di `coretax_sync_logs`, namun migration `20260423_000001` sampai `20260423_000004` hanya membuat empat tabel lain.

**K6. Autentikasi Coretax tidak konsisten.** Agent TAX menetapkan OAuth 2.0 atau certificate-based; implementasi memilih jalur certificate PKCS#12 dengan header `X-DJP-Signature`, tanpa OAuth sama sekali.

**K7. Kredensial SSO di luar sistem.** Agent TAX dan CTA melarang menebak angka atau kode; namun kanal yang justru diwajibkan untuk Client ID dan Client Secret adalah procedure manual melalui Notepad atau pengetikan langsung ke halaman Settings, selama 730 hari.

### 10.2 Kontradiksi Workspace dan Path

**K8. Enam root workspace berbeda.**

| Root | Sumber |
|:--|:--|
| `c:/xampp/htdocs/new_san_variant` | `blueprint_taxes.md`, `blueprint_konversi_varian.md`, `06_compliance_tax.md`, `09_tax_integration.md` |
| `w:\san_ibb_2jul` | `SESSION_TAKEOVER_AND_BACKGROUND_CHECKER.md` (Rise CRM, CI4) |
| `z:/san_cik` | `proporsi_diskon.md` bagian 3 (link `_processSelectProductPaket.php`, `shoppingCart.php`, `_shoppingCart.php`) |
| `w:/san_cik` | `penjualan_paked.md` (path `coTransaksiUi.php`, `_shoppingCart.php`, `Create.php`, `_processSelectProductPaket.php`) |
| `W:\san_staging` | `blueprint-sampah-modul.md` |
| `W:\_md_result` | direktori keluaran sintesis |

**K9. Path file yang sama, root berbeda.** `proporsi_diskon.md` menautkan `application/modules/penjualan/controllers/_processSelectProductPaket.php` ke `z:/san_cik`, sedangkan `penjualan_paked.md` menautkan berkas identik ke `w:/san_cik`. Salah satu tautan pasti salah, atau keduanya menggambarkan checkout berbeda tanpa penandaan.

**K10. Hash file yang sama pada dua path.** `z:/san_cik/.../_shoppingCart.php` dan `w:/san_cik/.../_shoppingCart.php` muncul bersamaan dalam dua dokumen yang sama-sama mengklaim sudah diterapkan. Tidak ada penjelasan mengenai hubungan kedua checkout.

### 10.3 Kontradiksi Fungsional

**K11. Klaim 100% selesai versus bug yang terdokumentasi.** `Ringkasan_Integrasi_SSO.md` menyatakan integrasi selesai 100% dan bebas error. `SESSION_TAKEOVER_AND_BACKGROUND_CHECKER.md` mendokumentasikan redirect loop pada `Security_Controller` yang hanya muncul ketika interaksi SSO dan Email/Password bercampur. Status "bebas error" kemungkinan berlaku untuk skenario SSO tunggal, bukan campuran.

**K12. Saran ganti kata sandi pada akun tanpa kata sandi.** Pesan session takeover berbunyi "If this is not you, change your password immediately." Akun yang auto-registrasi via SSO tidak memiliki kata sandi CRM, sehingga instruksi tersebut tidak dapat dijalankan pengguna.

**K13. Pesan Disable Login untuk akun yang tidak punya login password.** `disable_login` = 0 pada auto-registration, dan pesan error mengarahkan pengguna untuk meminta Administrator menghapus centang "Disable login". Tidak dijelaskan bagaimana proses tersebut menghasilkan centang bagi akun SSO yang belum pernah login manual.

**K14. Bypass session checker.** `check_active_session()` melewati validasi bila user `is_admin`, `is_multi_session`, atau `is_debuger`. `is_debuger` mencurigakan sebagai bypass produksi karena ia adalah alat bantu debugging, bukan role bisnis. Selain itu, karena `Security_Controller` juga menerapkan check, tiga kelompok user ini tidak memiliki mekanisme realtime kick-out sama sekali.

**K15. PPN dan pembulatan diskon berbeda arah.** Agent TAX mensyaratkan pembulatan PPN ke bawah. Fungsi global `pembulatanDiskon()` membulatkan ke bawah (integer floor) untuk nilai diskon. Keduanya searah, tetapi diterapkan pada basis nilai yang berbeda: pembulatan diskon terjadi sebelum PPN dihitung pada baris komponen, sehingga PPN yang terpotong pembulatan diskon berpotensi berbeda dari pembulatan PPN standalone. Tidak ada penelaahan eksplisit.

**K16. `jenisTr` 1582 tidak muncul di modul taxes.** Modul `taxes` mendeklarasikan `681`, `110`, `5681`; modul `penjualan` memakai `1582` dan `konversi_varian` memakai `881` serta `7881`. File `KAMUS_TRANSAKSI.md` yang dirujuk agent CTA dan TAX tidak termasuk dalam 12 file sumber, sehingga kelengkapan peta tipe transaksi tidak dapat diverifikasi dari bahan yang ada.

**K17. Jalur pajak terpisah tanpa kontrak integrasi.** Modul `taxes` (NSFP, NTPN, jenisTr 5681) dan `tax_gateway_service` (`ref_no`, `request_hash`, `industry_type`) tidak memiliki satu pun dokumen yang menjelaskan pertukaran data. Missing design include skema mapping NITKU ke branch code internal, sumber `industry_type`, dan strategi rekonsiliasi bila satu jalur gagal.

**K18. Faktur berulang tanpa hook pajak.** Job cron `create_recurring_invoices()` dan `create_subscription_invoices()` berjalan setiap jam pada Rise CRM. Tidak ada dokumentasi yang menghubungkan output faktur tersebut ke pencatatan faktur pajak, NSFP, atau gateway.

### 10.4 Temuan Kualitas Dokumen

**K19. Artefak karakter CJK.** `blueprint-sampah-modul.md` pada paragraf verifikasi memuat rangkaian karakter CJK di tengah kalimat Indonesia, pada posisi seharusnya kata "tunjuk". Menandakan blend teks tanpa finalisasi.

**K20. Numerasi heading ganda.** `proporsi_diskon.md` memakai label "### Langkah 2.2" dua kali berturut-turut: yang pertama untuk logika resiprokal, yang kedua untuk penanganan input AJAX. Referensi silang antar heading menjadi ambigu.

**K21. Tanda baca dan simbol non-ASCII.** Beberapa dokumen memakai tanda hubung panjang dan emoji pada status. Untuk sintesis ini semua dinormalkan ke ASCII, namun normalisasi berarti informasi dekoratif tidak dibawa.

**K22. Typo pada nama simbol yang dirujuk.** `proporsi_diskon.md` menyebut target tombol `tic_lavant` di satu kalimat namun id yang disebut di bagian lain adalah `tic_lanjut`. Karena dokumen membahas bug tombol yang gagal terkunci, ketepatan nama selector menentukan apakah perbaikan dapat diterapkan ulang.

**K23. Verifikasi sampah belum menutup route alternatif.** Bukti penghapusan berbasis "tidak ada di routes.php" tidak tunggal. Folder diberi label "Sama" tanpa evidence per item, dan `arrayjs.js` serta `ProductPkgEditor1.php` punya bukti berbeda yang tidak dirinci.

**K24. Toleransi pembulatan tidak konsisten antar lapisan.** Validasi server memakai 0.01, tetapi toleransi client tidak diatur; `autoAdjustRoundingAjax()` menjadi satu-satunya komponen yang menyerap selisih desimal. Bila user berada di locale berbeda atau input berdesimal lebih dari dua digit, toleransi 0.01 tidak lagi memadai.

**K25. Pembulatan didorong ke satu komponen.** Bila seluruh baris sudah `is_edited`, sistem menaruh selisih pada baris terakhir. Komponen penanggung seluruh selisih dapat memiliki `nett1` yang tidak konsisten dengan input diskon/premi yang diketik user - risiko salah saji material pada disaggregasi harga paket.

### 10.5 Rekomendasi Tindakan

**Prioritas tinggi:** (1) migrasikan service ke PHP 8.2 typed sesuai spesifikasi, atau perbarui spesifikasi agar mengesahkan PHP 5.6 sebagai keputusan sadar; (2) terapkan encryption-at-rest untuk sertifikat P12 dan passphrase di `tax_configs`; (3) buat tabel `coretax_sync_logs` atau perbarui mandat agent TAX agar mencatat di `tax_transactions`; (4) susun dokumen kontrak integrasi modul `taxes` dengan `tax_gateway_service`; (5) pindahkan Client Secret SSO ke secret manager dan turunkan masa berlaku dari 730 hari.

**Prioritas menengah:** (6) batasi bypass `check_active_session()` pada role produksi saja; (7) ganti teks pesan session takeover agar tidak mengarahkan ganti kata sandi untuk akun SSO; (8) rekonsiliasi path `z:/san_cik` versus `w:/san_cik`; (9) tambahkan UAT case campuran SSO plus Email/Password pada checklist; (10) verifikasi ulang penghapusan modul sampah dengan `heMenu`, `heNavigation`, autoload, dan data historis.

**Prioritas rendah:** (11) perbaiki artefak karakter CJK dan duplikasi heading 2.2; (12) sinkronkan penamaan "Sesuaikan Pembulatan Otomatis" dengan "Sesuaikan Sisa Diskon Secara Otomatis"; (13) verifikasi ulang selector `tic_lanjut` dan `btnProcess` pada environment yang akan dipakai.

---

## 11. Lampiran: Daftar File Sumber

Jumlah file: 12. Ukuran adalah ukuran byte aktual file.

| Nama File | Ukuran | Topik H1 | Peran |
|:--|--:|:--|:--|
| `TAX_GATEWAY_SPEC.md` | 3.339 bytes (3,3 KB) | Technical Specification: Coretax Bridge Microservice (Indonesia 2026) | Dokumen BASE - spesifikasi teknis baku: stack PHP 8.2 typed, 4 tabel inti, 3 modul industri, digital signature, idempotency, retry, circuit breaker, 4 endpoint. Tidak bertanggal. |
| `TAX_GATEWAY_SERVICE_DOCUMENTATION.md` | 6.169 bytes (6,0 KB) | Tax Gateway Service Documentation | Dokumen STATUS IMPLEMENTASI bertanggal 23 April 2026. Merekam downgrade ke PHP 5.6, nama class konkret namespace `TaxGateway\*`, key Redis `tax_gateway:outgoing` dan `tax_gateway:outgoing:delayed`, skema kolom migration, 4 migration `20260423_000001`-`000004`, 8 langkah alur proses, dan daftar hardening yang belum dikerjakan. |
| `blueprint_taxes.md` | 4.662 bytes (4,6 KB) | BLUEPRINT CETAK BIRU MODUL: TAXES (PERPAJAKAN & E-FAKTUR) | Blueprint modul ERP `taxes`. Mendefinisikan `jenisTr` 681/110/5681, Tax Invoice Matcher `_processSelectNota.php`, jurnal settlement `FollowUp.php` via `ComJurnal`, struktur 12 controller, dan status selesai. Tanggal analisis 2026-07-29. |
| `06_compliance_tax.md` | 3.703 bytes (3,6 KB) | COMPLIANCE TAX AGENT (CTA) - Financial Compliance, IFRS/PSAK Expert, and Tax Auditor | Definisi agent CTA. Menetapkan skeptisisme wajib, larangan menebak, tiga kategori temuan, checklist pembulatan dan double-entry, 8 standar PSAK/UU HPP/PMK, format output `=== AUDIT COMPLIANCE ===` dengan verdict LULUS/DITOLAK/PERLU REVISI. |
| `09_tax_integration.md` | 3.370 bytes (3,3 KB) | ENTERPRISE TAX INTEGRATION AGENT (TAX) - Tax Accountant & Coretax DJP Gateway Specialist | Definisi agent TAX. Menyediakan 7 tarif pajak referensi per 2025 (PPN 11%, PPh 21/22/23/25/4(2)/29), syarat formal dan material Faktur Pajak PER-03/PJ/2022, format output `=== TAX RECONCILIATION ===`, dan lima syarat wajib integrasi Coretax termasuk tabel `coretax_sync_logs`. |
| `Panduan_Setting_Microsoft_SSO.md` | 3.863 bytes (3,8 KB) | Panduan Menghubungkan Login Microsoft ke CRM | Panduan non-teknis 4 tahap setup App Registration di Azure: tenant single, Redirect URI `https://[DOMAIN-CRM-ANDA]/signin/microsoft_callback`, Client ID dari Overview, Client Secret dengan Expires 730 days, lalu pemasangan lewat menu Settings CRM. |
| `Ringkasan_Integrasi_SSO.md` | 3.274 bytes (3,2 KB) | Ringkasan Integrasi Microsoft SSO pada Rise CRM | Ringkasan teknis hasil implementasi SSO: library `stevenmaguire/oauth2-microsoft`, tombol di `signin_form.php`, auto-linking `microsoft_id`, auto-registration status `inactive` dengan `disable_login` 0, perbaikan Pass-by-Reference PHP 8 pada `ci_save()`, 4 pesan error edukatif, link/unlink di `Team_members.php`, klaim status 100% selesai. |
| `SESSION_TAKEOVER_AND_BACKGROUND_CHECKER.md` | 6.845 bytes (6,7 KB) | Dokumentasi Teknis: Mekanisme Session Takeover (SSO vs Email/Password) & Real-Time Background Session Checker | Mekanisme sesi pada Rise CRM CI4 di `w:\san_ibb_2jul`: akar masalah redirect loop `last_session_id`, perbaikan di `Users_model::authenticate()`, endpoint `check_active_session()` dengan bypass 3 flag, heartbeat browser 15 detik di `custom_body_bottom.php`, plus 9 tugas cron (5 inti recurring, email piping, Google Calendar, auto-close tiket, 2 job harian). |
| `proporsi_diskon.md` | 10.938 bytes (10,7 KB) | Dokumentasi & Rencana Implementasi: Proporsi Diskon & Premi Komponen Paket (Sales Package) | Sumber TERBESAR. Analisis alur otomatis `$subtotal_nett1$` dan `$persen_selisih$`, konfigurasi `shoppingCartEditableFields2`, 5 skenario logika resiprokal kolom diskon/premi/nett1, AJAX ke `$_SESSION[$cCode]['items2']`, validasi client dan server dengan toleransi 0.01, serta 5 perbaikan (bug x100, iframe scoping `#btnProcess`, mutual exclusion, clamping, auto-adjust rounding dengan flag `is_edited` dan race fix `$.active`). |
| `penjualan_paked.md` | 4.956 bytes (4,8 KB) | Ringkasan Konteks: Kolom Price Bruto & Perhitungan Diskon Paket (Sales Package 1582) | Fokus kolom `harga_ori` (Price Bruto) dan diskon baris utama paket pada `jenisTr` 1582. Empat masalah: nilai `harga_ori` 0, salah hitung diskon akibat basis `{harga}` vs `harga_orig` (contoh 10% jadi 70.7%), selisih Rp 6 dari `pembulatanDiskon()` integer floor pada 10 komponen, dan clamping 0-100. Daftar 4 berkas terdampak. |
| `blueprint_konversi_varian.md` | 5.435 bytes (5,3 KB) | BLUEPRINT CETAK BIRU MODUL: KONVERSI VARIAN PRODUK & SUPPLIES | Blueprint modul `konversi_varian` dengan templat sama seperti `blueprint_taxes.md`. `jenisTr` 881 dan 7881, relasi `variant_id_asal`/`variant_id_tujuan`, dual-write stock via `ComLockerStockDualWrite::pair()` dan `ComLockerStockSuppliesDualWrite::pair()`, tabel `stock_locker_variant` dan `stock_locker_supplies_variant`, jurnal `ComJurnal`, cart key `supplies:{id}:{variant_id}`. |
| `blueprint-sampah-modul.md` | 6.071 bytes (5,9 KB) | Blueprint Sampah Modul - Batch 1 | Bukti penghapusan: 17 folder backup (~1.039 file, ~144 MB), 17 file controller backup (~2,5 MB) dengan ukuran per file, 4 artefak sisa (RAR dan folder IDE), array PowerShell atas 34 path terhadap `W:\san_staging`, serta 2 perintah `Select-String` verifikasi pascapenghapusan. |

**Total ukuran 12 file sumber:** 62.625 bytes (sekitar 61,2 KB).

**Distribusi peran dokumen:**

- Spesifikasi dan implementasi gateway pajak: 2 file (16,7% by count).
- Blueprint modul ERP: 3 file (taxes, konversi_varian, sampah).
- Agent kepatuhan pajak: 2 file (CTA, TAX).
- Integrasi SSO dan session management: 3 file.
- Transaksi 1582 dan diskon paket: 2 file.
