# 09 - Infrastruktur, DevOps, dan Operasional ERP Everest

Dokumen sintesis untuk cluster `ev-infra` (23 berkas sumber). Cakupan: topologi server,
monitoring, backup & disaster recovery, Redis cache, Git best practice, verifikasi CronTray,
arsitektur distribusi, standar UI (Transaction Inspector, Mobile Scanner, ALUR UI, DataTable),
PPN/PPh21 & modul Taxes, dokumen peran agen, serta konteks pengembangan dan jurnal dev.
Seluruh isi dirangkum ulang dari berkas sumber; detail yang tidak ada pada sumber ditandai
secara eksplisit sebagai "tidak dispesifikasikan di sumber".

---

## 1. Ringkasan Eksekutif

- Sistem ERP Everest berjalan pada stack PHP 5.6 + CodeIgniter 3.1.8 HMVC (Wiredesignz MX v5.5,
  `subclass_prefix: MY_`), database relasional MySQL/MariaDB, ditambah NoSQL MongoDB untuk draf
  dan log audit. Rujuk AGENTS.md.
- Terdapat dua domain infrastruktur yang saling tumpang tindih di dokumen: (a) domain backup/DB
  pada rentang `192.168.5.x`, dan (b) domain produksi/monitoring pada rentang `192.168.11.x`.
  Penomoran ini tidak konsisten antar dokumen (lihat bagian 14).
- Standar kepatuhan yang diklaim berulang: ISO/IEC 27001 (keamanan & audit logging),
  ISO 9001:2015 (mutu & ketertelusuran), ISO 22301 (kelangsungan bisnis), serta PSAK/IFRS.
- Tema rekayasa utama: zero-downtime deployment, graceful degradation, guardrail integritas data,
  concurrency control (locker), dan penolakan technical debt.

---

## 2. Topologi & Server (Rekonsiliasi Lintas Dokumen)

Bagian ini menggabungkan peran server dari beberapa berkas. Karena sumber memakai penomoran IP
yang berbeda, tabel dipisah per dokumen asal.

### 2.1 Topologi Backup (panduan_backup_dan_restore_mariabackup.md)

| Peran Server | IP / Host | OS / Spesifikasi | Fungsi |
| :--- | :--- | :--- | :--- |
| Server 1: Produksi DB | `192.168.5.14` | MariaDB 10.3.39 (Debian/Linux) | 90 database ERP Everest, 446 GB mentah |
| Server 2: Backup Engine | `192.168.5.10` (`root@erp`) | AlmaLinux, 24 Cores, 78 GB RAM | Kompresi ZSTD 16-thread & SSH stream |
| Server 3: Storage Vault | `192.168.5.15` (`opc windows`) | Windows Server, Shared CIFS 4.1 TB | Arsip `gfs_database_backup` & checksum |

### 2.2 Topologi Monitoring (monitoring_server_setup_sop.md)

| Peran | Host | Keterangan |
| :--- | :--- | :--- |
| Server Produksi ERP | `rita` = `192.168.11.100` | AlmaLinux 8, Apache httpd, PHP-FPM (Remi php56) |
| Server Monitoring | `192.168.5.10` Ubuntu 22.04 | Prometheus + Grafana via Docker Compose |
| Router diizinkan | `192.168.11.2` | Akses port 9100/9117/9253 |
| Contoh IP di template | `192.168.5.14`, `192.168.5.50` | Placeholder pada contoh konfigurasi |

### 2.3 Topologi High Availability (kebijakan_backup_dan_pemulihan_bencana.md)

| Node | IP | Konfigurasi |
| :--- | :--- | :--- |
| Master DB | `192.168.11.100` | `server-id = 100`, `gtid_domain_id = 1`, `binlog_format = ROW` |
| Replica DB | `192.168.11.101` | `server-id = 101`, `gtid_domain_id = 1`, `read_only = 1` |

Automatic failover menggunakan Virtual IP / Keepalived / HAProxy; target RTO failover < 5 detik.

### 2.4 Server Redis (plan_redis_cache.md)

- OS: AlmaLinux 8; Redis 7.2 LTS (EOL Desember 2029).
- RAM: 80 GB; CPU: Intel Xeon E5-2620 @ 2.00GHz (24 Cores); disk SAS mekanis.
- Jaringan private LAN, latensi < 1ms dari server utama.
- Server DB eksisting yang menjadi konteks: RAM 377 GB, DB 800 GB, 10 aplikasi, high concurrency,
  `query_cache_type = 0`, `innodb_buffer_pool_size = 160G` dengan `16 instances`.

---

## 3. Monitoring Server Setup SOP

Sumber: monitoring_server_setup_sop.md. Target OS AlmaLinux 8 (RHEL-family), Apache httpd
VirtualHost, PHP-FPM. Standar: ISO 27001 (Audit Logging & System Monitoring), Zero-Downtime.

### 3.1 Arsitektur tarik metrik

- Server produksi mengekspos endpoint status Apache/PHP-FPM dan tiga exporter:
  - `node_exporter` port `9100` (CPU, RAM, disk, jaringan).
  - `apache_exporter` port `9117`.
  - `php-fpm_exporter` port `9253`.
- Server monitoring menjalankan Prometheus (port `9090`), Grafana (port `3000`), Alertmanager
  (Telegram/Email). Scrape interval `10s`, evaluation interval `10s`.

### 3.2 Bagian 1 - Setup server produksi

1. Aktifkan status Apache: buat `/etc/httpd/conf.d/status.conf` dengan `ExtendedStatus On` dan
   blok `<Location /server-status>` (`SetHandler server-status`, `Require local`, opsi
   `Require ip 192.168.5.0/24`). Pada VirtualHost ber-`ProxyPass` ke PHP-FPM wajib menambah
   `ProxyPass /server-status !` sebelum ProxyPass PHP. Uji dengan `apachectl configtest`
   (harus "Syntax OK") lalu `apachectl graceful`; verifikasi `curl http://127.0.0.1/server-status?auto`.
2. Aktifkan status PHP-FPM di `/etc/php-fpm.d/www.conf`: `pm.status_path = /status` dan
   `ping.path = /ping`. Uji sintaks `/opt/remi/php56/root/usr/sbin/php-fpm -t`, lalu
   `systemctl reload php56-php-fpm`.
3. Pasang tiga exporter (versi pada dokumen):
   - `node_exporter` v1.8.1 (`node_exporter-1.8.1.linux-amd64.tar.gz`), user sistem
     `node_exporter` dengan `/bin/false`, ExecStart `--web.listen-address=:9100`.
   - `apache_exporter` v1.0.8, ExecStart `--scrape_uri="http://127.0.0.1/server-status?auto"`
     `--telemetry.address=:9117`.
   - `php-fpm_exporter` v2.2.0, ExecStart
     `--phpfpm.scrape-uri="unix:///run/php-fpm/www.sock;/status" --web.listen-address=:9253`.
4. Firewall firewalld: Opsi A (disarankan) rich-rule per source IP mis. `192.168.5.50` untuk
   port 9100/9117/9253; Opsi B buka `{9100,9117,9253}/tcp` untuk LAN.

### 3.3 Bagian 2 - Setup server monitoring (Docker)

Instalasi Docker Engine + Compose Plugin disediakan untuk Ubuntu 22.04/24.04, AlmaLinux/RHEL 8,
dan Debian 12. `docker-compose.yml` memuat service `prometheus` (image `prom/prometheus:latest`,
port `9090:9090`, volume `./prometheus.yml:/etc/prometheus/prometheus.yml`) dan `grafana`
(image `grafana/grafana:latest`, port `3000:3000`, env `GF_SECURITY_ADMIN_PASSWORD`).
`prometheus.yml` mendefinisikan job `almalinux_os` (`:9100`), `almalinux_apache` (`:9117`),
`almalinux_php_fpm` (`:9253`) dengan target placeholder `IP_ALMALINUX_PRODUKSI`
(contoh `192.168.5.14`).

### 3.4 Bagian 3 - Dashboard Grafana

- Buka `http://IP_SERVER_MONITORING:3000`, login `admin`.
- Data source Prometheus URL `http://prometheus:9090`.
- Import Dashboard ID: `15033` (PHP-FPM), `3894` (Apache Web Server), `1860` (Node Exporter Full).

### 3.5 Bagian 4 - Metrik kritis

- `phpfpm_listen_queue > 0` (kritis: transaksi mengantre karena worker FPM sibuk).
- `phpfpm_max_children_reached > 0` (peringatan: `pm.max_children` menyentuh batas).
- `apache_workers{state="busy"} / total > 85%` (waspada).
- `node_load1 / count(node_cpu_seconds_total{mode="idle"}) > 1.5` (CPU overload).

### 3.6 Bagian 5 - Status pekerjaan (update 22 Agustus 2026)

Server Monitoring Ubuntu 22.04 `192.168.5.10`:
- Docker Engine SELESAI; `docker-compose.yml` di `~/monitoring/docker-compose.yml`;
  `prometheus.yml` target `192.168.11.100` (rita).
- Container `prometheus_erp` LIVE port `9090`; `grafana_erp` LIVE port `3006`
  login `admin/ERP_Monitor_2026!`.
- Dashboard `1860` LIVE; `3894` dan `15033` PENDING menunggu exporter aktif.
- Firewall rule `192.168.11.2` SELESAI.

Server Produksi ERP AlmaLinux 8 (`rita` `192.168.11.100`):
- Binary `node_exporter`, `apache_exporter`, `php-fpm_exporter` SELESAI di `/usr/local/bin/`.
- Systemd `node_exporter.service` running port 9100; `apache_exporter.service` dan
  `php-fpm_exporter.service` file dibuat tetapi BELUM di-start.
- `pm.status_path = /status` SELESAI; `/etc/httpd/conf.d/status.conf` SELESAI.
- `apachectl graceful` dan `systemctl reload php56-php-fpm` PENDING (tunggu off-peak).
- Pre-flight check PASSED pada 22 Agustus 2026 pukul 16:54 WIB.

Empat langkah eksekusi malam: (1) `apachectl graceful` + `curl .../server-status?auto`,
(2) reload PHP-FPM + cek socket status, (3) start kedua exporter, (4) verifikasi
`curl localhost:9117/metrics` dan `curl localhost:9253/metrics`, lalu import dashboard `3894`
dan `15033` di `http://192.168.5.10:3006`.

Catatan: path socket PHP-FPM berbeda antar bagian dokumen: bagian instalasi memakai
`/run/php-fpm/www.sock`, sedangkan bagian verifikasi memakai
`/var/opt/remi/php56/run/php-fpm/www.sock`. Lihat bagian 14.

---

## 4. Kebijakan Backup & Pemulihan Bencana (DRP)

Sumber: kebijakan_backup_dan_pemulihan_bencana.md. Versi dokumen 1.0, status Draft.
Standar acuan: ISO/IEC 27001:2022 (Klausul A.8.13 Information Backup) dan ISO 22301:2019.

### 4.1 Ruang lingkup data (Hybrid Data Store)

1. Relational Database MariaDB/MySQL: entitas `transaksi`, `transaksi_values`, `transaksi_data`,
   `transaksi_data_values`, `transaksi_sign`, `transaksi_extstep`, `transaksi_data_registry`,
   `MdlLockerTransaksi`, master data, dan GL Jurnal.
2. NoSQL MongoDB: draf belanja sementara (`saveDraftAjax`) dan log audit dinamis
   (`ComTransaksi_log_mongo`).
3. Storage File System `uploads/`: lampiran nota, kuitansi, bukti transfer, scan sertifikat.

### 4.2 Target RPO & RTO

| Metrik | Definisi | Target |
| :--- | :--- | :--- |
| RPO | Batas kehilangan data yang ditoleransi | <= 5 menit (Binary Log Streaming / Oplog Tail) |
| RTO | Batas downtime pemulihan | <= 60 menit (Automated DR Script) |

### 4.3 Jadwal backup per komponen

- MariaDB/MySQL:
  - Full Database Dump harian pukul 00:00 WIB memakai `mariadb-backup` atau
    `mysqldump --single-transaction --quick`; kompresi dienkripsi AES-256.
  - PITR kontinu: `log_bin` aktif dengan `binlog_format = ROW`; binary log disinkronkan ke
    server backup tiap 5 menit untuk RPO <= 5 menit.
- MongoDB: dump harian pukul 01:00 WIB
  `mongodump --gzip --archive=/backup/mongo_$(date +%Y%m%d).gz`; opsi oplog tailing untuk
  Replica Set.
- Uploads: `rsync -avz --delete /var/www/everest/uploads/ /backup/uploads/` atau replikasi
  S3-compatible.

### 4.4 Arsitektur proteksi 3-Tier (Gold Standard)

- Tier 1: MariaBackup GFS Physical Baseline (Full 1x/minggu + Incremental 1x/hari pukul 02:00 WIB).
- Tier 2: BINLOG Archiving PITR (merekam query detik demi detik, klaim RPO 0).
- Tier 3: Replikasi Master-Replica (automatic failover RTO 5 detik).

Rasional frekuensi: Incremental MariaBackup TIDAK dijalankan per jam karena akan menciptakan
144 berkas incremental per minggu dan memperlambat restore (RTO membengkak). GFS dijalankan
1x sehari pukul 02:00 WIB sebagai Physical Baseline.

### 4.5 Prosedur pemulihan bencana (4 langkah)

1. Isolasi & deklarasi bencana: hentikan akses pengguna, catat timestamp insiden.
2. Restore MariaDB:
   `mariadb-backup --prepare --target-dir=/backup/mariadb/full_latest` lalu `--copy-back`;
   replay binlog:
   `mysqlbinlog --stop-datetime="2026-07-24 19:00:00" /backup/binlogs/binlog.000* | mysql -u root -p`.
3. Restore MongoDB (`mongorestore --gzip --archive=/backup/mongo/mongo_latest.gz`) dan uploads
   (`rsync -avz /backup/uploads/ /var/www/everest/uploads/`).
4. Verifikasi: cek konsistensi saldo GL vs Kartu Stok `LockerStock`, lepas hold locker
   menggantung, buka akses.

### 4.6 Pengujian & audit

- Disaster Recovery Drill minimal 1x setiap 6 bulan ke Staging/Sandbox.
- Verifikasi hash `sha256sum` setiap berkas backup.
- Aturan 3-2-1: 3 salinan, 2 media berbeda (Local SSD + Local NAS), 1 salinan offsite
  (Cloud/Remote DC).

---

## 5. Panduan Backup & Restore MariaBackup (GFS Stream ZSTD)

Sumber: panduan_backup_dan_restore_mariabackup.md. Standar ISO 27001 & ISO 22301.

### 5.1 Alur skrip `backup_mariabackup_gfs.sh`

1. Cronjob 02:00 WIB.
2. Baca konfigurasi `/etc/backup_config/backup.ini` (parameter `db_host`, `db_user`, `db_pass`,
   `remote_ip`, `remote_pass`; dibaca dengan `grep`/`cut`, berkas `chmod 600`).
3. Penguncian `flock -n 200` pada `/var/run/backup_mariabackup.lock` (exit 1 jika overlap).
4. Cek auto-mount CIFS `//192.168.5.15/` ke `/mnt/storage_vault`.
5. Pre-flight SSH `ssh -q -o ConnectTimeout=5 root@"$DB_HOST" exit` (fail-fast).
6. Skenario GFS: Full bila hari Minggu (`DAY_OF_WEEK = 7`) atau LSN belum ada; Incremental
   Senin-Sabtu memakai `--incremental-lsn`.
7. Ekstraksi checkpoint LSN presisi (menghilangkan selisih 9 byte checkpoint InnoDB).
8. Hitung checksum SHA256, transfer ke Windows Vault 4.1 TB, verifikasi, hapus berkas transit.

Prinsip: MariaBackup GFS harian = Physical Baseline (RTO cepat, cukup menempel 1-6 file
incremental). BINLOG per jam/real-time = untuk RPO = 0 (Zero Data Loss). BINLOG diputar via
`mysqlbinlog` setelah restore fisik.

### 5.2 Prosedur restore bare-metal ke server pengganti

- Langkah 0: install `mariadb-server mariadb-backup zstd cifs-utils curl`; mount CIFS
  `//192.168.5.15/gfs_database_backup /mnt/storage_vault -o username=sos,password=NetworkMGK,vers=3.0`.
- Langkah 1: salin Full + Incremental + `.sha256` dari vault ke `/backup_restore/vault_download`.
  Contoh berkas: `full_2026-07-26.mbstream.zst`, `inc_2026-07-27_040508.mbstream.zst`,
  `inc_2026-07-28_213032.mbstream.zst`.
- Langkah 2: `sha256sum -c *.sha256`.
- Langkah 3: dekompresi `zstd -d -c ... | mbstream -x -C ...` ke
  `/backup_restore/extracted/full|inc1|inc2`.
- Langkah 4 (ATURAN EMAS): Full & Inc1 memakai `--apply-log-only`; Inc terakhir LEPAS
  `--apply-log-only`.
- Langkah 5: `systemctl stop mariadb`; `rm -rf /var/lib/mysql/*`;
  `mariabackup --copy-back`; `chown -R mysql:mysql /var/lib/mysql`; `chmod 755`;
  `systemctl start mariadb`.
- Langkah 6: verifikasi `mysqladmin ping` serta `SHOW DATABASES; USE run_san_ibb; SHOW TABLES;`
  lalu bersihkan `/backup_restore`.

### 5.3 Checklist pemeliharaan

- Crontab: `0 2 * * * /home/sos/backup_mariabackup_gfs.sh >> /backupDB/logs/cron_execution.log 2>&1`.
- Log harian: `cat /backupDB/logs/backup_$(date +%Y-%m-%d).log`.
- Kapasitas: `df -h /mnt/storage_vault`.

---

## 6. Redis Cache Plan (Centralized Caching, Cache-Aside)

Sumber: plan_redis_cache.md. Status rekomendasi arsitektur produksi.

### 6.1 Keputusan menonaktifkan Query Cache MariaDB

Alasan teknis penolakan `query_cache_type = 0`:
1. Global lock contention: satu global lock; tiap tulis menginvalidasi cache tabel terkait,
   memicu antrean dan risiko freeze pada 10 aplikasi.
2. Skalabilitas multi-core buruk (core memperebutkan lock yang sama).
3. `innodb_buffer_pool_size = 160G` dengan `16 instances` sudah optimal.

Solusi: Dedicated Redis Server terpisah, metode Cache-Aside (Lazy Loading).

### 6.2 Instalasi & optimasi

- Redis 7.2 LTS via Remi repo:
  `dnf update -y`; `dnf module reset redis -y`; `dnf module enable redis:remi-7.2 -y`;
  `dnf install redis -y`.
- Kernel: `vm.overcommit_memory = 1` di `/etc/sysctl.conf`; disable THP
  (`echo never > /sys/kernel/mm/transparent_hugepage/enabled`, permanen via `/etc/rc.local`).

### 6.3 Konfigurasi produksi `/etc/redis/redis.conf` (poin kunci)

- Jaringan: `bind 0.0.0.0`, `protected-mode yes`, `port 6379`, `tcp-backlog 511`,
  `timeout 0`, `tcp-keepalive 300`.
- Umum: `daemonize yes`, `databases 16`.
- Snapshot (optimasi SAS): `save 900 1`, `save 3600 10000`,
  `stop-writes-on-bgsave-error no`, `rdbcompression yes`, `rdbchecksum yes`,
  `dbfilename dump.rdb`, `dir /var/lib/redis`.
- Replikasi: `replica-serve-stale-data yes`, `replica-read-only yes`,
  `repl-diskless-sync yes`, `repl-diskless-sync-delay 5`, `replica-priority 100`.
- Keamanan: `requirepass PasswordRahasiaRedisAnda123!` (wajib diganti).
- Memori: `maxmemory 30gb`, `maxmemory-policy allkeys-lru`.
- Optimasi SAS: `appendonly no`, `no-appendfsync-on-rewrite yes`.
- Threading: `io-threads 6`, `io-threads-do-reads yes`.
- Aktifkan: `systemctl enable redis && systemctl restart redis`.

### 6.4 Firewall

Port `6379` diisolasi per source IP server aplikasi:
`firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="10.0.0.4" port port="6379" protocol="tcp" accept'`
lalu `firewall-cmd --reload`.

### 6.5 Integrasi aplikasi CI3

- `application/config/redis.php`: `socket_type = 'tcp'`, `host = '10.0.0.5'` (IP privat Redis),
  `password`, `port 6379`, `timeout 1.5`.
- Failover wajib: `$this->load->driver('cache', array('adapter' => 'redis', 'backup' => 'dummy'))`.
  Bila Redis down, adapter `dummy` mengembalikan FALSE sehingga aplikasi membaca MariaDB tanpa
  crash. Contoh `Laporan::omset_2026()` dengan `$cacheKey = 'key_query_laporan_omset_2026'`
  dan `save(..., 3600)`.
- Prasyarat server aplikasi: `sudo yum install php56-php-pecl-redis -y`.

Catatan AGENTS.md menambahkan: timeout maksimal 1.5 detik, prefix otomatis
`[ENVIRONMENT]:[NAMA_DATABASE]:`, domain `demo.mayagrahakencana.com` dipaksa
`ENVIRONMENT = development`, dan pola nama key `deleter_status_[MdlName]_[ID]`,
`locker_status_[MdlName]_[ID]`, `lookup_all_[MdlName]`, `[nama_data]_[USER_ID]`.

---

## 7. Panduan Git Best Practice (Multi-Client)

Sumber: PANDUAN_GIT_BEST_PRACTICE.md, dibuat 03 September 2026, khusus sandbox `W:\chepy\`.

- Filosofi: hindari pola `everest_lama/everest_baru/everest_final_bismillah.zip`; gunakan satu
  folder + folder rahasia `.git` yang menyimpan diff, bukan salinan penuh.
- Tiga zona Git: Working Directory, Staging Area (Index), Local Repository, ditambah Remote.
- Arsitektur Multi-Repo Mandiri: tiap folder client punya `.git` sendiri
  (`everest`, `san`, `majumapan`, `sumber_boga`, `teguh`, `run_jodomart`, `san_add`, `san_ppu`,
  `san_sarana`, `san_sdl`, `san_tsa`).
- `.gitignore` standar CI3: abaikan `/application/logs/*`, `/logs/*`, `*.log`, `/uploads/*`,
  `/assets/uploads/*`, `*.bak*`, `*.tmp`, `*.rar`, `*.zip`, `*.7z`, `*.sql`, `*.tar.gz`,
  `.idea/`, `.vscode/`, `Thumbs.db`, `Desktop.ini`.
- Catatan kredensial: `application/config/database.php` sandbox mengarah ke `192.168.5.14`;
  hati-hati agar tidak menimpa setelan produksi `192.168.11.100`.
- Alur harian: `git status` -> edit -> `git diff` -> `git add <file>` / `git add .` ->
  `git commit -m "..."`.
- Rollback: `git checkout -- <file>` / `git restore <file>`; `git reset HEAD` /
  `git restore --staged .`; `git reset --soft HEAD~1`; `git reset --hard HEAD~1` (hati-hati).
- Branching: `git checkout -b fitur-diskon-baru`, `git merge`, `git branch -D` bila gagal.
- Konvensi commit: `[FEAT]`, `[FIX]`, `[REFACTOR]`, `[CONFIG]`, `[CHORE]`.
- Pantangan: jangan commit dump SQL > 50 MB, folder log/session, pesan commit tidak bermakna,
  atau `git reset --hard` tanpa kesadaran penuh.

---

## 8. Verifikasi CronTray (CentOS 7, PHP 5.6)

Sumber: PANDUAN_VERIFIKASI_CRONTRAY_CENTOS7.md.

### 8.1 Arsitektur

| Komponen | Peran |
| :--- | :--- |
| `CronTray.php` | Controller orkestrator regenerasi cache tray; murni DML (Active Version Pointer) + `session_write_close()` (zero-downtime) |
| `he_tray_helper.php` | Helper pembaca cache tray dengan filter `batch_id = active_batch` |
| `sys_cache_tray_version` | Tabel pointer ID batch aktif (`active_batch`), update atomik < 1 ms |
| Tabel cache | `sys_cache_tray_transaksi`, `sys_cache_tray_duedate`, `sys_cache_tray_payment` |

### 8.2 Skema database (jalankan 1 kali)

- `sys_cache_tray_version`: kolom `id` (PK), `active_batch`, `updated_at`; seed `(1, 0, NOW())`.
- `sys_cache_tray_transaksi`: kolom `batch_id`, `cabang_id`, `cabang2_id`, `jenis_master`,
  `next_step_num`, `next_step_code`, `next_substep_num`, `jenis_label`, `oleh_id`, `qty`;
  indeks `idx_batch`, `idx_cabang`, `idx_cabang2`, `idx_jenis_master`,
  `idx_batch_cabang_jenis`.
- `sys_cache_tray_duedate`: `batch_id`, `cabang_id`, `dtime`, `due_date`, `customers_id`;
  indeks `idx_batch`, `idx_cabang`, `idx_customer`.
- `sys_cache_tray_payment`: `batch_id`, `cabang_id`, `target_jenis`, `extern_id`, `sisa`;
  indeks `idx_batch`, `idx_cabang`, `idx_target_jenis`, `idx_extern`.
- Indeks optimasi tambahan (disarankan):
  - `transaksi_due_date`: `idx_due_status_trash` (`status`, `trash`, `due_date`, `customers_id`, `cabang_id`).
  - `transaksi_data` (1.7+ juta baris): covering index
    `idx_tray_undone_fast` (`trash`, `sub_step_number`, `valid_qty`, `transaksi_id`, `next_substep_num`).

### 8.3 Verifikasi & eksekusi

- Lint: `php -l application/controllers/CronTray.php` dan
  `php -l application/helpers/he_tray_helper.php` (harus "No syntax errors detected").
- CLI: `php index.php CronTray setup_tables` (1x), `php index.php CronTray generate_cache`
  (ekspektasi output "Active Batch ... ~15-20 detik"), `php index.php CronTray check_db_stats`
  (menampilkan step 110: Prepare E-Faktur `601` + Entry E-Faktur `39` = `640`).
- HTTP: `curl -i "http://127.0.0.1/everest_13agus/CronTray/generate_cache?secure_key=cron_tray_cache_123"`
  (respon 15-20 detik tanpa memblokir tab lain).
- Crontab tiap 5 menit:
  `*/5 * * * * /usr/bin/php /path/to/everest_13agus/index.php CronTray generate_cache >> /path/to/everest_13agus/logs/cron_tray.log 2>&1`.
- Troubleshooting: `SHOW FULL PROCESSLIST;`, `tail -n 50 logs/cron_tray.log`,
  `tail -n 50 /var/log/httpd/error_log`, `tail -n 50 /var/log/php-fpm/www-error.log`.

Catatan: dokumen ini menyasar CentOS 7 sedangkan dokumen monitoring menyasar AlmaLinux 8.
Keduanya memakai PHP 5.6; path web root contoh `everest_13agus`.

---

## 9. Arsitektur Sistem Distribusi & Logistik

Sumber: Dokumen Arsitektur Sistem Distrib.md. Dua metode pemenuhan stok:

### 9.1 Alur Regular (melalui DC fisik)

PO Regular -> Supplier kirim ke DC -> Cek fisik & QC di DC -> (lolos) Inbound & Put-Away ke rak
DC -> Alokasi stok & picking -> DC kirim ke cabang -> Cabang terima & update stok.
Bila tidak lolos QC: Retur ke supplier dari DC.

### 9.2 Alur Direct Shipping (otomatisasi virtual)

PO Direct -> Supplier kirim ke cabang -> Cabang terima & cek fisik -> (lolos) Cabang klik
"Konfirmasi" di POS -> TRIGGER OTOMATIS: (1) Good Receipt Virtual di DC, (2) Transfer Order
Virtual ke Cabang -> Stok cabang otomatis aktif. Bila tidak lolos: cabang tolak/retur di tempat.

### 9.3 Skema master data

- `ms_supplier`: `supplier_id` (PK), `supplier_name`, `city`,
  `default_delivery_type` ENUM('REGULAR','DIRECT').
- `ms_warehouse_branch`: `location_id` (PK), `location_name`,
  `location_type` ENUM('DC','BRANCH'), `city`.
- `ms_product`: `sku` (PK), `product_name`, `is_direct_allow` (BOOLEAN).

### 9.4 Skema transaksi

- `tr_po_header`: `po_number` (PK), `supplier_id` (FK), `po_type` ENUM('REGULAR','DIRECT'),
  `dest_location_id` (FK), `po_status` ENUM('DRAFT','APPROVED','SHIPPED','CLOSED').
- `tr_po_detail`: `po_number` (FK), `sku` (FK), `qty_ordered`, `price`.
- `tr_good_receipt`: `gr_number` (PK), `po_number` (FK), `location_id` (FK), `received_date`,
  `received_by` (nama user atau 'SYSTEM_AUTO').
- `tr_inter_transfer`: `transfer_number` (PK), `from_location_id`, `to_location_id`,
  `transfer_status` ENUM('PENDING','IN_TRANSIT','COMPLETED'), `is_virtual` (TRUE untuk direct).

### 9.5 Matriks logika kartu stok

| Skenario | Dokumen Awal | Inbound | Outbound | Kartu Stok DC | Kartu Stok Cabang |
| :--- | :--- | :--- | :--- | :--- | :--- |
| Regular | PO REGULAR, Dest DC_01 | User DC klik Good Receipt | User DC buat Transfer Order | + saat GR; - saat kirim | + saat fisik tiba |
| Direct | PO DIRECT, Dest BR_SBY | Otomatis (Virtual GR ke DC) saat cabang terima | Otomatis (Virtual Transfer) detik sama | + dan - di detik sama (saldo fisik tetap 0) | + sesuai konfirmasi cabang |

### 9.6 Trigger direct shipping (pseudo-code)

`on_cabang_receive_direct_po(po_number, cabang_id, item_list)`:
buat GR virtual (`received_by = 'SYSTEM_AUTO'`) -> stok DC bertambah -> buat transfer virtual
`is_virtual = TRUE`, `transfer_status = 'COMPLETED'` -> potong DC & tambah cabang per item ->
`UPDATE tr_po_header SET po_status = 'CLOSED'`.

### 9.7 Reverse logistics

- Retur jalur regular: barang rusak saat unloading di DC ditolak, buat Berita Acara, potong item
  pada `tr_good_receipt` sebelum masuk rak.
- Retur jalur direct: staf cabang input jumlah Diterima (Baik) dan Ditolak (Rusak); trigger hanya
  memproses kuantitas baik; barang ditolak diterbitkan `Claim Ticket` ke supplier atas nama DC,
  fisik dibawa kembali armada supplier.

---

## 10. Standar UI / UX

### 10.1 Universal Transaction Inspector (360 derajat)

Sumber: BLUEPRINT_UNIVERSAL_TRANSACTION_INSPECTOR.md. Standar: PSAK 72/IFRS 15, PSAK 1,
Prinsip Storno, ISO 27001 (A.12.4), ISO 9001:2015 (8.5.2).

- Masalah as-is `viewResume`: blind spot keuangan, teks "- no journal affected by this
  transaction -" padahal ada DP/jurnal, sulit melacak reversal/ganti relasi.
- Four Pillars Engine:
  1. Document Hierarchy Resolver (Pre-Order, PO/SO, GRN/DO, Rejection, Return).
  2. Financial & Settlement Aggregator (DP awal, alokasi DP, ganti relasi DP, pembayaran kas direct).
  3. Ledger & Audit Reversal Inspector (jurnal GL, buku besar pembantu, log reversal/storno).
  4. Universal Inspector UI Renderer (modal 4 tab: Overview Matrix, Rantai Dokumen, Mutasi Keuangan, Jurnal & Reversal).
- Contoh kasus `PO.FG.-1.3308`: DP dibayar Rp 687.487.700; alokasi PM.FG.-1.21.335 Rp 38.946.600;
  ganti relasi Rp 662.211.000 ke `PO.FG.-1.3392`; reversal PM pada 02 Sep 2026.
- Komponen kode (HMVC CI3): `application/libraries/ComTransactionInspector.php`,
  `application/helpers/he_inspector_helper.php` (`render_inspector_link`),
  `application/controllers/UniversalInspector.php`
  (`UniversalInspector/getInspectorData/$nomer`),
  `application/views/inspector/v_universal_inspector_modal.php`.
- Kompatibilitas: PHP 5.6 (hindari `??`, `[]`, `fn()`), MX v5.5, Query Binding.

### 10.2 UI/UX Mobile Scanner

Sumber: BLUEPRINT_UIUX_MOBILE_SCANNER.md. Standar: ISO 9241-110, ISO 9241-210 & Fitts's Law,
WCAG 2.1 Level AA. Ukuran elemen interaktif minimal 48px-52px; rasio kontras minimal 4.5:1
(> 7:1 untuk elemen kritis).

- Modul target: `pindahgudang` (modul acuan), `penjualan`, `distribusifg`,
  `distribusifgproject`, `pembelian`, `pembelianfgproject`, `konversi`.
- Komponen: Scanner Input Bar (input barcode tinggi 52px, font 20px, focus glow,
  checkbox multi 22px x 22px); Header transaksi dark navy `#1E293B` dengan scoped CSS
  `.header-dark-custom` (link `#38BDF8`, nomor `#F8FAFC`); Petunjuk pemindaian accordion
  (`#FEFCE8`); Legenda stok solid chips `#DC2626` (Stok Kosong), `#D97706` (Stok Kurang),
  `#16A34A` (Stok Cukup), font-weight 800.
- Lokasi: View `application/modules/[modul]/views/followUp.php`, Controller
  `application/modules/[modul]/controllers/FollowUp.php` (method `shopingCart()`).
- Checklist: patuh PHP 5.6, cegah alarm fatigue, legend tebal, tinggi input >= 52px,
  kontras >= 4.5:1, zero placeholder rule.

### 10.3 ALUR UI Modul Penjualan

Sumber: ALUR_UI.md. Modul `penjualan`, template `template/transaksi_nosalesman.html`,
model produk `MdlProduk2`/`MdlHargaProduk2`, model customer `MdlCustomer`.

Kode transaksi:
- `582`: Penjualan Reguler FG - Salesman Mode.
- `5822`: Penjualan Reguler FG - Sales Support / Admin Mode.
- `5823`: Penjualan Reguler FG - Direct Counter Mode.
- `1582`: Penjualan Special Order / Overseas Order.

Pohon transaksi:
- 582: `582spo` (Pre-Order) -> `582so` (SO Disetujui) -> `582pkd` (Packing) -> `582spd`
  (Shipped/Surat Jalan) -> `582` (Invoice Final); cabang reject `582sorj`, `582pkdrj`.
- 5822: `5822spo` -> `5822so` -> `5822pkd` -> `5822spd`.
- 5823: `5823spo` -> `5823so` (instant approve) -> `5823spd` (Direct Pickup/Cash).
- 1582: `1582spo` -> `1582so` (SO disetujui Director) -> `1582spd` (Shipped Direct).

Elemen utama (`elements`): `paymentMethod` (radio, `MdlPaymentMethod`, validasi
`kreditLimitValidate`), `shippingMethod` (radio: Dikirim via Kurir / Diambil Sendiri),
`dueDate`, `keterangan`. Elemen relasional (`relativeElements`): `cash_account`
(`MdlBankAccount_cash_and_in`, wajib bila `paymentMethod` = cash/cia), `pengirim_id`
(`MdlPengirim`, wajib bila `shippingMethod` = dikirim).

Peran per kode: 582 `o_seller` -> `o_seller_spv` -> `o_gudang`; 5822 `o_seller` ->
`o_seller_spv` -> `o_gudang`; 5823 `o_seller` -> `o_seller_spv`/`o_gudang`; 1582 `o_export` ->
`c_holding`. Status warna: Pending `#dd3300`, Approved `#ff7700`, Packed/Shipped `#009900`.

### 10.4 Optimasi DataTable Reload pada Opname Approval

Sumber: implementation_plan_ui_dataTable_loading.md. Konteks: halaman approval opname step 1
`*ro` dan step 2 final. Saat checklist serial atau perubahan `qty_opname`/`harga`,
`tableOpname.ajax.reload(null, false)` dipanggil; DataTable `serverSide: true` memicu
`fetchCartDataTable()` (~800 baris logika, baca sesi, batch query
`_rek_pembantu_produk_perserial_cache`, hitung IRA score, selisih, 20+ summary metrics).

Dampak: flicker, input focus hilang, checkbox reset, beban server.

Analisis: serial checklist BISA dihilangkan (DOM-only). Response `updateSerial()` mengembalikan
`{status, id, sku, serial, state}`, dan frontend sudah styling lokal + `updateWadah()`.
Qty/Price change BISA dihilangkan; `updateItemFieldOpname(silent=1)` sudah mengembalikan
`{status, id, selisih, qty_debet, qty_kredit, subtotal}`.

Rencana perubahan: perkaya `updateSerial()` (`_followupLiveEdit.php` baris 2119-2121, tambah
`serial_mismatch_count`, `serial_total_sku`, `items5_checked_for_pid`, +50 baris); perkaya
`updateItemFieldOpname()` (baris 1159-1171, +25 baris, `total_harga_master`,
`total_debet_sum`, `total_kredit_sum`, `total_subtotal_sum`, `has_serial`, `jml_serial`);
frontend `transaksi.php` baris 4469-4477 (hapus reload serial, tambah
`updateSerialComplianceSummary`), baris 4707-4714 & 4745-4752 (hapus reload, tambah
`updateRowFromSilentResponse`); safety periodic background sync 60 detik dengan flag
`hasLocalChanges`. Open questions: interval 60/30/120 detik, update badge count instan,
filter `serial_mismatch` tetap reload.

---

## 11. PPN/PPh21 dan Modul Taxes

### 11.1 Perbaikan Bug Terbit DP (implementation_plan_termin.md)

Modul `penerimaanprojek`.

- Kesalahan pembulatan Rp 1: saat Termin 70% dibayar `5.546.959`, sisa plafon riil `$sisaDpp`
  = `2.377.267`; DP 30% murni dari `7.924.226` = `2.377.267,8` dibulatkan `2.377.268`.
  Solusi Residual Plug Pattern di `views/shoppingCart.php` baris 440-448:
  `if ($dpReadyToBill > $sisaDpp) { $dpReadyToBill = $sisaDpp; }`.
- Kesalahan indikator status WO di `controllers/_shoppingCart.php` baris 531-542: kode lama
  `else if ($debetNominal > 0)` salah karena debetTermin `5.546.959 > 0`. Solusi memeriksa
  `dp_terpakai`/`debet_dp` spesifik.
- Norma PPN 12% UU HPP di `config/coTransaksiCore.php` baris 1514-1517:
  `dpp_pengganti = dpp_ppn*(11/12)`, `dpp_pengganti_factor = 11/12`,
  `ppn = (12/100)*dpp_pengganti`.
- Referensi: Romney & Steinbart (2018) ISBN 978-0134472010; Resmi (2024) ISBN
  978-623-181-042-4; Gunadi & Rahayu (2022) DOI 10.31092/jips.v4i2.1645.

### 11.2 PPh 21 UU HPP Skema Berjenjang (modul biaya)

Sumber: BLUEPRINT_PPH21_UU_HPP.md.

- Masalah: opsi ID 78 dan 79 tidak menampilkan data karena belum terdaftar di
  `autoSelectPPh['tipe_biaya']` pada `coTransaksiUi.php`. Solusi: daftarkan ID 78 & 79 secara
  terisolasi tanpa mengganggu ID eksisting 72, 73, 74, 77.
- Kolom: `BIAYA CASHBACK` (bruto/pre-tax) dan `JUMLAH DISERAHKAN KE PENERIMA` (neto/post-tax).
  Khusus 78/79: neto = bruto - PPh 21.
- Kalkulasi dari TOTAL CART (bukan per item).
- Opsi 78 (omset < 50M, fasilitas diskon 50%): layer efektif 2,5% (0-60 jt), 7,5%
  (>60-250 jt), 12,5% (>250-500 jt), 15% (>500 jt-5 M), 17,5% (>5 M). Simulasi cart Rp 80 jt:
  PPh Rp 3.000.000 (efektif 3,75%), diserahkan Rp 77.000.000.
- Opsi 79 (omset > 50M, tanpa fasilitas): 5%, 15%, 25%, 30%, 35%. Simulasi cart Rp 80 jt:
  PPh Rp 6.000.000 (efektif 7,5%), diserahkan Rp 74.000.000. Catatan: teks sumber menulis
  "Omset diatas 50M tidak mendapat fasilitas", konsisten dengan label ID 79.
- Komponen: `application/modules/biaya/config/coTransaksiUi.php`,
  `application/helpers/he_pph21_progresif_helper.php`
  (`hitung_pph21_progresif_uuhpp($bruto, $has_fasilitas)`),
  `_shoppingCart.php` (akumulasi bruto cart, panggil helper, susun `$html_rincian_pph21_progresif`),
  `views/shoppingCart.php` (render rincian hanya bila variabel tidak kosong). Rincian hanya
  aktif untuk ID 78 & 79; selain itu 100% hidden.

### 11.3 Modul Taxes PPN Keluaran (jenisTr 110)

Sumber: FINAL_implementation_plan_ppn_masukan_modul_taxes.md dan
implementation_plan_ppn_masukan_modul_taxes.md.

Arsitektur tab saat ini (4 tab):
| # | Tab | Step/URL | Sumber Data |
| :--- | :--- | :--- | :--- |
| 1 | PREPARE E-FAKTUR | `?step=1` | `viewUndoneItemsIndex2()` - PHP pagination (array_chunk) |
| 2 | PREPARE GUNGGUNGAN | `?step=pre_gunggungan` | `viewGunggunganIndex()` - DataTable server-side JSON |
| 3 | ENTRY E-FAKTUR | `?step=2` | `viewUndoneItemsIndex2()` |
| 4 | OTORISASI E-FAKTUR | `?step=3` | `viewUndoneItemsIndex2()` |

Masalah utama: dua tab membingungkan; endpoint `viewGunggunganIndex()` mengeksekusi
`SELECT ... FROM transaksi ...` TANPA `LIMIT`/`OFFSET` lalu memotong manual dengan
`array_chunk()` sehingga menarik puluhan ribu baris ke RAM.

Keputusan desain penggabungan: kolom gabungan `shortHistoryFields` + `shortHistoryFields2`;
baris NPWP vs Non-NPWP dibedakan warna (aksen amber + badge "NON-NPWP / GUNGGUNGAN");
Opsi C (tombol aksi individual untuk semua baris + checkbox multi-select gunggungan hanya
untuk baris non-NPWP); 3 tombol filter (Semua/NPWP/Gunggungan) dengan badge; floating box
`#floating-box` "PPN GUNGGUNGAN" dipertahankan. Optimasi: true SQL `LIMIT`/`OFFSET` +
`COUNT(DISTINCT transaksi.id)`, filter level DB `WHERE IFNULL(per_customers.npwp,'') <> ''`
(NPWP) dan `= ''` (gunggungan).

Pemicu pemisahan di `coTransaksiUi.php` baris 1415-1418 (`filterCustomerNpwp`) dan baris
600-618 (`gunggungFields`). Peringatan penting: `coTransaksiCore.php` memisahkan mapping
jurnal `new_grand_ppn_gunggungan` (akun `2030070`) dan `new_grand_ppn_non_gunggungan`
(akun `2030060`); penggabungan tab TIDAK BOLEH menghapus pembedaan saat proses follow-up.
Alur `Transaksi::index()` baris 6327-6420, `viewUndoneItemsIndex2()` baris 2966,
`viewGunggunganIndex()` baris 7755-8539. File terdampak: controller `Transaksi.php`,
view `transaksi.php`, template `transaksi_index.html`, config `coTransaksiUi.php`.

Catatan koordinasi: sumber menyebut modul `taxes` sebagai "PPN MASUKAN" pada judul file,
tetapi isi menyatakan jenisTr `110` = E-Faktur PPN Keluaran. Lihat bagian 14.

---

## 12. Dokumen Peran Agen (AGENTS)

### 12.1 AGENTS.md (aturan global)

- Konteks teknologi terverifikasi: PHP 5.6; CI 3.1.8 (`CI_VERSION` di `system/core/CodeIgniter.php`);
  Wiredesignz MX v5.5 (`application/third_party/MX/`, prefix `MY_`); MySQL/MariaDB Query Builder;
  MongoDB via `application/libraries/Mongo_db.php`; PHPExcel (bukan PhpSpreadsheet); CI Curl
  (Philip Sturgeon). Larangan: namespace PSR-4, Composer autoloader untuk class bisnis, sintaks CI4.
- Struktur HMVC: `core/` (MY_Loader, MY_Router), `config/`, `controllers/`, `helpers/`
  (`he_*_helper.php`), `libraries/`, `models/Coms/` (prefix `Com*` extends `CI_Model`),
  `modules/[nama_modul]/config/` (`coTransaksiCore.php`, `coTransaksiUi.php`,
  `coTransaksiLayout.php`, `coTransaksiValues.php`), `modules/[nama_modul]/controllers/`
  (`Modul_Controller.php`, `_shoppingCart.php`, `_processSelect*.php`, `_selectorItem.php`,
  `_processPihak*.php`, `Create.php`, `FollowUp.php`, `ActivityReport.php`,
  `Printing.php`, `Transaksi.php`).
- Hierarki controller: `CI_Controller` -> `MX_Controller` -> `Modul_Controller` ->
  sub-controller.
- Aturan kode: query wajib Query Binding/Query Builder (pengecualian technical debt
  `UPDATE transaksi SET indexing_*` di modul `produksi`, jangan ditiru); dual-write stock
  locker WAJIB lewat `ComLockerStockDualWrite`; helper prefix `he_`; transaksi DB pakai
  `trans_start()`/`trans_complete()`; PHP 5.6 compatibility; early validation;
  sesi mobile scanner (tanpa iframe, redirect berantai `followupDariHp` ->
  `createSimpleSessionLogin` -> `forceMobile` -> `followupPrePreview`); locker transaksi
  (hold `state='hold'`, `jumlah='1'`; ambil alih bila idle >= 5 menit; lepas saat logout
  `normalisasiStok(true)`); draf MongoDB (`Modul_Controller::saveDraftAjax()`, key `user_id`
  + `session_code`, cleanup > 24 jam); SARGability & indexing; presisi finansial
  `DECIMAL(15,2)` + BC Math (`bcadd`, `bcsub`, `bcmul`, `bcdiv`, `bccomp`); caching Redis.
- Modul terdampak aturan scanner: `distribusifg`, `distribusifg_non_paket`,
  `distribusifgproject`, `distribusijasa`, `distribusisupplies`,
  `distribusisuppliesproject`, `penerimaan`, `penerimaanprojek`, `inputstok`, `inputstokunit`.

### 12.2 AGENTS_BIAYA.md (modul biaya)

- Arsitektur berbasis metadata & konfigurasi; base controller
  `application/modules/biaya/controllers/Modul_Controller.php` memuat 4 config.
- Katalog jenisTr: `2676`/`676` (Biaya Produksi, COA `6020`), `7762`/`2762` (Pembiayaan
  Supplies, `FifoAverageSupplies`), `677`/`2677` (Biaya Usaha Cabang), `1677` (Biaya Usaha
  Pusat), `1674`/`11674` (Reimburse Kas Kecil), `21674` (Reimburse Eksternal), `7674`
  (Pengisian Kembali Kas Kecil), `675`/`2675` (Mutasi Kas), `1675`/`4675` (Mutasi Bank),
  `762` (Biaya Gaji/Payroll), `9982`-`9985` (Pelunasan Nota Hutang: Kas/Bank/Deposit/Giro),
  `9922` (Pelunasan Nota Piutang), `119` (Biaya Penyusutan), `742`/`743` (Selisih Stock
  Opname), `2674`/`3674` (Mutasi Kas Kecil Antar Cabang), `6677`/`16677` (Cashback Penjualan).
- Tabel: `transaksi`, `transaksi_values`, `transaksi_data`, `transaksi_data_values`,
  `transaksi_sign`, `transaksi_extstep`, `transaksi_data_registry` (sebelumnya
  `transaksi_registry`).
- Locker `MdlLockerTransaksi`: entri kunci `state='hold'`, `jumlah='1'`; ambil alih bila idle
  >= 5 menit (`?forceRetakeLock=1`); pembersihan saat logout `normalisasiStok(true)`.
- Cashback: `cash` (kas/Credit Note, debet `6010` cabang / `6140` project),
  `barang` (valas/emas, `MdlCurrency`), `produk` (`MdlProduk`, potong persediaan).
- RelativeElements mendukung Expression DSL, mis.
  `"freelancerOption == 1 && selectMetodcasback == 3"`, dievaluasi `he_element_helper.php`.

### 12.3 AGENTS_SUPPLIES.md (protokol gatekeeper supplies)

- Aturan mutlak untuk modul Supplies. Teknologi sama (PHP 5.6, CI 3.1.8 HMVC).
- Library valuasi: `ComRekeningPembantuSupplies` serta `FifoAverageSupplies`/`FifoSupplies`.
- Locker supplies: `ComLockerStockSupplies` (hold/distribute) dan
  `ComLockerStockMutasiSupplies` (mutasi antar gudang/cabang); JANGAN campur dengan locker FG.
- COA persediaan supplies valid: `1010030010`. Dilarang bypass direct update saldo.
- Validasi stok `qty > 0` wajib sebelum `trans_start()`. Pada config transaksi supplies
  (`pindahgudang`, `distribusisupplies`, `distribusisuppliesproject`, `opname`) WAJIB memakai
  `"comName" => "FifoAverageSupplies"` atau `"FifoAverageSuppliesOpname"`; DILARANG memakai
  `"comName" => "FifoAverage"` (milik FG, menarik saldo akun `1010030030` yang menyebabkan
  nilai rata-rata 0 / error di bawah 1).

---

## 13. Konteks Pengembangan & Jurnal Dev

### 13.1 DEVELOPMENT_CONTEXT.md - Struktur Rak Gudang per Cabang

- Tabel baru di `everest_6jul`: `gudang_ruang`, `gudang_lorong`, `gudang_rak`,
  `produk_rak_relasi` (pemetaan lokasi penyimpanan produk + kapasitas maksimal).
- Model CI3 extends `MdlMother`: `MdlGudangRuang.php`, `MdlGudangLorong.php`,
  `MdlGudangRak.php`, `MdlProdukRakRelasi.php`.
- Isolasi cabang: `defaultValue => ".my_cabang_id"`; dropdown difilter `referenceFilter`
  berdasarkan `my_cabang_id`.
- Shadow Fields: `paramSyncNamaNama()` untuk sinkronisasi nama.
- Next steps: registrasi menu UI controller; integrasi mutasi stok ke `produk_rak_relasi`;
  user flow testing Cabang A vs B.

### 13.2 dev-jurnal.md - ringkasan per tanggal

15 Juli 2026 - Perbaikan kalkulasi Qty Digunakan pada SPK:
- Masalah: item "BRACKET HODA" tampil 51 unit padahal seharusnya 81 unit (dari total 141 B.O.M).
- Akar: `getRekapKomposisi()` membaca tabel progress `project_sub_tasklist_komposisi` yang baru
  terisi saat SPK selesai, bukan tabel penugasan `project_komposisi_sub_workoder`.
- Solusi: ubah sumber ke `project_komposisi_sub_workoder` filter `jenis_transaksi = 'sub_wo'`;
  return tetap dari tabel progress. File: `MdlProdukProject.php`, `MasterData.php`
  (baris 787 & 9288; `selectItem()` case `produk_paket`).

15 Juli 2026 - Pencegahan Dobel Save (Double Entry) SPK & Tambahan Biaya:
- Akar: tidak ada lock/race condition check; frontend tombol belum disable.
- Solusi: Row Locking `FOR UPDATE` + validasi record identik dalam 10 detik; disable tombol.

15 Juli 2026 - Perbaikan Bug Material Menggantung & Race Condition Pembatalan SPK:
- Akar: `pembatalanTasklist()` tidak men-trash data `sub_wo`; tidak ada row lock.
- Solusi: `SELECT id FROM project_produk WHERE id = ? FOR UPDATE` (MasterData.php baris 22838)
  dan trash `$subwo_id` (baris 22913). Perbaikan formula sisa di `MdlProdukProject.php`;
  progress bar di `views/data.php` memakai `(Total Alokasi / Komposisi) * 100` dengan
  `round($persen, 1)`. Bisnis final: `Sisa = Komposisi - Digunakan` tanpa parameter `Return`.

15 Juli 2026 - Normalisasi Data Progres Legacy > 100%:
- Contoh Project 140, 145, 146 mencapai 300%. Akar: pembatalan SPK lampau tidak mengurangi
  `harga_progress`/`persen_progress` di `project_produk`.
- Solusi: hapus hardcode `$produk_id = 92;` dan `die("MATI DULU BELUM COMMIT");` di
  `normalisasiProgressProject()`; jalankan `run_normalization.php`. Hasil: 116 project
  dikoreksi; Project 140 turun dari 100.68% ke 43.18%.

16 Juli 2026 - Penyelarasan Sisa Anggaran & Pencegahan Refund Return pada SPK:
- Masalah: sisa material BRACKET HODA Project 179 tampil 6 di overview vs -3 di modal;
  return menambah kembali `qty_saldo` Master RAB.
- Solusi: JS modal `saldo = b.qty_saldo*1` (tidak kurangi `jml_return`); footer total
  `total_qty += bom*1`; komentari blok refund di `exeSubTasklist()`; ganti cURL loopback
  dengan library lokal `SuppliesReturnService` dan `FgReturnService` (baris 20617, 24863);
  refaktor `postLateReturn()` dan `tool_createReturnBySPK()`.

---

## 14. Temuan Lintas-Dokumen & Kontradiksi

1. Alamat IP `192.168.5.10` dipakai ganda: "Server 2: Backup Engine" (`root@erp`) pada dokumen
   backup, dan "Server Monitoring Ubuntu 22.04" pada dokumen monitoring. Perlu klarifikasi
   apakah host yang sama menjalankan dua peran atau terjadi kesalahan penomoran.
2. Dua rentang IP berbeda: backup/DB memakai `192.168.5.x` (`.14`, `.10`, `.15`) sedangkan
   produksi/HA/monitoring memakai `192.168.11.x` (`.100`, `.101`). Dokumen backup bahkan
   menulis Server Produksi DB = `192.168.5.14`, sementara DRP HA menulis Master DB =
   `192.168.11.100`.
3. Jadwal backup tidak konsisten: kebijakan_backup menulis Full Dump harian pukul 00:00 WIB dan
   MongoDB 01:00 WIB; panduan_mariabackup menulis cron pukul 02:00 WIB dengan Full mingguan
   (Minggu) dan Incremental Senin-Sabtu.
4. Klaim RPO/RTO berbeda: kebijakan_backup menargetkan RPO <= 5 menit dan RTO <= 60 menit
   (otomatis); panduan_mariabackup mengklaim RPO = 0 (Zero Data Loss via binlog) dengan restore
   bare-metal manual ber-LSN.
5. Metode proteksi berkas berbeda: kebijakan_backup menyebut enkripsi AES-256; panduan_mariabackup
   memakai kompresi ZSTD + checksum SHA256 tanpa menyebut AES.
6. Definisi "3-Tier" berbeda makna: pada kebijakan_backup, 3-Tier = MariaBackup GFS / BINLOG /
   Replication; pada panduan_mariabackup, "3-TIER ARCHITECTURE" = tiga peran server.
7. Port Grafana: SOP utama menulis port `3000` dan password `admin_password_kuat_disini`;
   checklist status pekerjaan menulis port `3006` dan login `admin/ERP_Monitor_2026!`.
8. Target scrape: template `prometheus.yml` memakai `IP_ALMALINUX_PRODUKSI` (contoh
   `192.168.5.14`), sedangkan checklist aktual memakai `192.168.11.100` (rita). Firewall rule
   menyebut source `192.168.11.2` dan contoh `192.168.5.50`.
9. Path socket PHP-FPM: bagian instalasi `unix:///run/php-fpm/www.sock`, bagian verifikasi
   `curl --unix-socket /var/opt/remi/php56/run/php-fpm/www.sock`. Keduanya tidak dapat benar
   bersamaan kecuali ada symlink.
10. Redis: teks menyebut RAM server 80 GB namun `maxmemory 30gb` ("alokasi tahap awal"), dan
    server DB dikontekstualkan RAM 377 GB / 800 GB pada paragraf latar belakang. Tidak ada
    kontradiksi keras, tetapi angka RAM 377 GB vs 80 GB membingungkan bila tidak dibaca cermat.
11. Judul berkas `FINAL_implementation_plan_ppn_masukan_modul_taxes.md` menyebut "PPN Masukan",
    sedangkan isi menyatakan jenisTr `110` = E-Faktur PPN Keluaran. Istilah masukan/keluaran
    tertukar pada penamaan berkas.
12. PPN: implementation_plan_termin.md menegakkan "Norma Tarif Resmi 12% UU HPP" dengan DPP
    nilai lain 11/12, sementara banyak dokumen lain (mis. RAB, ALUR UI, UAT) masih menyebut
    PPN 11%. Ini konsisten dengan mekanisme DPP nilai lain (efektif 11%), namun rawan salah
    tafsir bila tidak dijelaskan.
13. AGENTS_BIAYA.md menyebut maskot/warna operasional lama `w:/everest_17jun` sedangkan dokumen
    lain menyebut `everest_29agus`, `everest_6sept`, `everest_16sep`, `everest_26sep`,
    `everest_6jul`, `everest_6agus`. Bukan kontradiksi, melainkan snapshot workspace berbeda.
14. Modul biaya: dokumen blueprint PPh21 merujuk `z:/everest_6agus`, sedangkan AGENTS_BIAYA
    merujuk `w:/everest_17jun`; nomor versi workspace tidak seragam.
15. Universal Transaction Inspector mengklaim menghapus teks "- no journal affected -",
    sedangkan modul taxes/PPN justru menjadi sumber banyak jurnal; belum ada bukti integrasi
    antar-dokumen (Inspector vs Taxes) di sumber.
16. Alur UI penjualan mencantumkan PPN 11% pada pengisian keranjang, sedangkan norma PPN UU HPP
    terbaru adalah 12% dengan DPP nilai lain. Perlu penyeragaman label.

---

## 15. Lampiran Daftar File Sumber

| No | Berkas | Fokus |
| --- | --- | --- |
| 1 | monitoring_server_setup_sop.md | SOP setup Prometheus/Grafana/exporters |
| 2 | kebijakan_backup_dan_pemulihan_bencana.md | Kebijakan backup, RPO/RTO, DRP, HA |
| 3 | panduan_backup_dan_restore_mariabackup.md | Skrip GFS ZSTD & restore bare-metal |
| 4 | plan_redis_cache.md | Dedicated Redis cache-aside & failover |
| 5 | PANDUAN_GIT_BEST_PRACTICE.md | Git multi-repo sandbox `W:\chepy` |
| 6 | PANDUAN_VERIFIKASI_CRONTRAY_CENTOS7.md | Skema & verifikasi CronTray |
| 7 | Dokumen Arsitektur Sistem Distrib.md | Distribusi regular vs direct shipping |
| 8 | BLUEPRINT_EDIT_SETTING_RAB.md | Amandemen RAB 7 tahap, async impacts |
| 9 | BLUEPRINT_UNIVERSAL_TRANSACTION_INSPECTOR.md | Inspector transaksi 360 derajat |
| 10 | BLUEPRINT_UIUX_MOBILE_SCANNER.md | Standar UI scanner mobile |
| 11 | ALUR_UI.md | Alur UI modul penjualan 582/5822/5823/1582 |
| 12 | KONTEKS_ANALISA_SELECTOR_967.md | Perbaikan selector retur 967 & memory leak |
| 13 | implementation_plan_ui_dataTable_loading.md | Optimasi reload DataTable opname |
| 14 | implementation_plan_termin.md | Bug terbit DP & norma PPN 12% |
| 15 | DRAFT_SESI_PENERIMAAN_KASIR_360.md | Sesi penerimaan 749, customer 360 |
| 16 | BLUEPRINT_PPH21_UU_HPP.md | PPh 21 berjenjang modul biaya |
| 17 | FINAL_implementation_plan_ppn_masukan_modul_taxes.md | Penggabungan tab taxes jenisTr 110 |
| 18 | implementation_plan_ppn_masukan_modul_taxes.md | Analisis tab taxes NPWP vs gunggungan |
| 19 | AGENTS_BIAYA.md | Panduan agen modul biaya |
| 20 | AGENTS_SUPPLIES.md | Protokol gatekeeper supplies |
| 21 | AGENTS.md | Aturan global proyek ERP Everest |
| 22 | DEVELOPMENT_CONTEXT.md | Struktur rak gudang per cabang |
| 23 | dev-jurnal.md | Jurnal perbaikan 15-16 Juli 2026 |

Catatan: KONTEKS_ANALISA_SELECTOR_967.md dan BLUEPRINT_EDIT_SETTING_RAB.md memuat detail
tabel/kolom penting yang juga disinggung di dokumen lain; ringkasannya disebar pada bagian
RAB (bagian 10 dokumen lain) dan modul pembelian (dokumen 12). KONTEKS_ANALISA_SELECTOR_967
menyebut transaksi `967` (Return Pembelian Produk @Pusat) dengan `jenis = '467'`,
`suppliers_id = '345'`, tabel `MdlNotaItem.php`, `_selectorItem.php` baris 244-295, filter
`returned = '0'`, dan error memory `10485760000 bytes`.
