# 11 - Rekonsiliasi Bank, AR, dan Master Kontak

Dokumen sintesis cluster `ev-rekonsiliasi` (5 berkas sumber). Cakupan: arsitektur rekonsiliasi
penerimaan AR, konteks arsitektur master kontak & partner, laporan perbandingan COA, dashboard
graph, dan hasil analisis risiko query. Detail yang tidak tersedia pada sumber ditandai
"tidak dispesifikasikan di sumber".

Catatan keterbatasan awal: struktur dokumen konseptual menyebut bagian "Advance Bank &
Rekonsiliasi GRUP", namun berkas `ADVANCE_BANK_GRUP_RECONSILE.md` TIDAK termasuk dalam 5 berkas
cluster ini. Topik advance bank/rekonsiliasi GRUP hanya muncul sebagai rujukan pada
`CHECKPOINT_SESSION_SETTLEMENT.md` (cluster settlement, lihat dokumen 10 bagian 4). Bagian
tersebut di bawah disajikan sebagai keterbatasan sumber, bukan hasil sintesis penuh.

---

## 1. Ringkasan Eksekutif

- Sistem memisahkan piutang usaha (AR) ke dalam beberapa modul: Penerimaan, Kas,
  PenerimaanProjek, dan GL, dengan nomor rekening piutang `2010050` sebagai akun kunci.
- Standar akuntansi acuan: PSAK 72 / IFRS 15 (pendapatan dari kontrak pelanggan) dan
  ISA 500 (bukti audit), dengan penekanan pada jejak audit (`trash = 0`, `cancel_dtime`).
- Master kontak dikonsolidasikan ke basis PostgreSQL `everest_db` pada proyek Laravel
  (Y:\everest_re, PostgreSQL 16), dengan `master_kontak` berisi 5.232 baris dan tiga flag peran:
  `is_pelanggan`, `is_supplier`, `is_karyawan`.
- Perbandingan COA menemukan perbedaan antara basis `everest_10jul` dan laporan HTML, terutama
  pada format kode level 1-5.
- Dashboard Graph memakai `per_cabang` dengan pemetaan ID 1/33/34 ke indeks warna 100/101/102 dan
  filter periode 3/6/12 bulan (`v=Xm`).
- Hasil analisis query menemukan risiko pada `raw query` `indexing_main_values` dan minimnya
  penggunaan `SELECT ... FOR UPDATE` (hanya 2 dari 48 `trans_start()`).

---

## 2. Arsitektur Rekonsiliasi Penerimaan AR

Sumber: ARSITEKTUR_REKONSILIASI_PENERIMAAN_AR.md.

### 2.1 Modul terkait

| Modul | Peran dalam AR |
| :--- | :--- |
| Penerimaan | Penerimaan kas/bank dari pelanggan |
| Kas | Buku kas & arus kas harian |
| PenerimaanProjek | Penerimaan khusus proyek |
| GL (General Ledger) | Jurnal umum & buku besar |

### 2.2 Akun piutang

- Rekening piutang usaha: `2010050`.
- Angka `4467` muncul sebagai referensi rekening/nilai pada dokumen terkait; pastikan tidak
  tertukar dengan kode modul (pada dokumen 10, `4467` juga muncul pada sesi kasir 360).

### 2.3 Standar dan prinsip audit

- PSAK 72 / IFRS 15: pengakuan pendapatan dari kontrak dengan pelanggan.
- ISA 500: bukti audit yang cukup dan tepat.
- Jejak audit: filter `trash = 0` (hanya data aktif) dan kolom `cancel_dtime` (waktu pembatalan)
  untuk membedakan dokumen aktif vs dibatalkan.

### 2.4 Tujuan rekonsiliasi

Menyelaraskan catatan penerimaan AR internal dengan mutasi bank, mendeteksi selisih, dan
mengaitkan setiap penerimaan ke dokumen penjualan/piutang terkait.

Detail nama tabel dan kolom rekonsiliasi penerimaan tidak dispesifikasikan lebih rinci pada
berkas arsitektur yang tersedia.

### 2.5 Matriks Peran Modul Terhadap Siklus AR

Tabel berikut merangkum posisi tiap modul pada siklus dari penjualan hingga pelaporan. Kolom
"Objek utama" hanya memuat entitas yang disebut/diturunkan dari sumber.

| Tahap siklus | Modul pelaksana | Objek utama | Standar terkait |
| :--- | :--- | :--- | :--- |
| Terjadinya piutang | Penerimaan/Penjualan (`582`) | Dokumen penjualan | PSAK 72 / IFRS 15 |
| Penerimaan kas/bank | Penerimaan, Kas, PenerimaanProjek | Rekening piutang `2010050` | PSAK 72 / IFRS 15 |
| Pencatatan buku besar | GL | Jurnal umum | PSAK 1 (penyajian) |
| Pembuktian/audit | Lintas modul | `trash = 0`, `cancel_dtime` | ISA 500 |
| Rekonsiliasi bank | (terkait checkpoint 759) | `bankReconItemsBySlug`, `is_bank_checked` | ISA 500 |

Catatan: nama tabel dan relasi foreign key antar modul tidak dispesifikasikan di sumber.

### 2.6 Prinsip Jejak Audit yang Dapat Ditelusuri

- Setiap baris aktif harus memenuhi `trash = 0`; baris yang dibatalkan tidak dihapus fisik
  melainkan diberi `cancel_dtime` (soft cancel) untuk mempertahankan histori.
- Prinsip ini memungkinkan penelusuran kembali (trace-back) dari mutasi bank ke dokumen
  penerimaan, lalu ke dokumen penjualan, tanpa kehilangan data yang dibatalkan.
- Kombinasi filter aktif + kolom waktu pembatalan memenuhi kebutuhan ISA 500 akan bukti audit yang
  dapat diverifikasi.

### 2.7 Risiko yang Diidentifikasi dari Arsitektur

1. Bila modul Penerimaan, Kas, PenerimaanProjek, dan GL tidak berbagi satu sumber kebenaran
   (single source of truth) untuk piutang `2010050`, dapat timbul selisih saldo antar modul.
2. Bila `cancel_dtime` tidak konsisten diisi pada seluruh jalur pembatalan, jejak audit menjadi
   tidak lengkap.
3. Bila rekonsiliasi bank bergantung pada slug (`bankReconItemsBySlug`) tanpa validasi unik,
   item dapat dicocokkan ganda.

Detail mitigasi yang sudah diterapkan tidak dispesifikasikan di sumber.

---

## 3. Master Kontak & Partner

Sumber: transkrip_konteks_arsitektur_master_kontak_dan_partner_2026-09-08.md
(transkrip sesi 8 September 2026).

### 3.1 Stack dan lingkungan

| Item | Nilai |
| :--- | :--- |
| Basis data | PostgreSQL `everest_db` |
| Framework | Laravel 13 |
| Lokasi proyek | `Y:\everest_re` |
| Versi PostgreSQL | PostgreSQL 16 |

Catatan: ini berbeda dari stack ERP Everest utama (PHP 5.6/CI 3.1.8/MariaDB). Proyek
`everest_re` adalah sistem terpisah berbasis Laravel + PostgreSQL.

### 3.2 Tabel `master_kontak`

- Jumlah baris: `5.232`.
- Flag peran (boolean):
  - `is_pelanggan`: kontak berperan sebagai pelanggan.
  - `is_supplier`: kontak berperan sebagai supplier.
  - `is_karyawan`: kontak berperan sebagai karyawan.
- Contoh data: `PT. SANTINO`.

### 3.3 Konsolidasi peran

Desain tiga flag memungkinkan satu entitas kontak memiliki lebih dari satu peran (mis. supplier
sekaligus pelanggan), menggantikan pemisahan tabel pelanggan/supplier/karyawan pada basis lama.

Detail kolom lain (NPWP, alamat, kontak) tidak dispesifikasikan lebih rinci di sumber.

### 3.4 Matriks Kombinasi Flag Peran

Tabel berikut menunjukkan kombinasi flag yang secara logis mungkin. Nilai "Ya/Tidak" adalah
kombinasi yang diizinkan oleh desain tiga flag independen, bukan data aktual (data aktual tidak
dipisahkan per kombinasi di sumber).

| `is_pelanggan` | `is_supplier` | `is_karyawan` | Entitas |
| :--- | :--- | :--- | :--- |
| Ya | Tidak | Tidak | Pelanggan murni |
| Tidak | Ya | Tidak | Supplier murni |
| Tidak | Tidak | Ya | Karyawan murni |
| Ya | Ya | Tidak | Pelanggan sekaligus supplier |
| Ya | Tidak | Ya | Pelanggan sekaligus karyawan |
| Tidak | Ya | Ya | Supplier sekaligus karyawan |
| Ya | Ya | Ya | Entitas dengan tiga peran |

Implikasi: query pelanggan wajib menyaring `is_pelanggan` secara eksplisit; tidak boleh
mengasumsikan satu tabel hanya berisi satu jenis peran.

### 3.5 Konsekuensi Integrasi ke ERP Utama

- ERP utama memakai MariaDB/MySQL (`everest_*`), sedangkan `everest_re` memakai PostgreSQL 16.
  Integrasi data kontak/AR memerlukan lapisan sinkronisasi yang menangani perbedaan tipe
  (boolean vs tinyint, penamaan kolom, format tanggal).
- Karena master kontak ada di PostgreSQL, sedangkan modul pembelian/settlement ada di MariaDB,
  pemetaan ID kontak antar-sistem harus stabil (tidak boleh mengandalkan auto-increment mentah).
- Pola sinkronisasi (dual-write, CDC, atau ETL batch) tidak dispesifikasikan di sumber.

### 3.6 Contoh Data Rujukan

- `PT. SANTINO` disebut sebagai contoh entitas pada `master_kontak`.
- Status peran `PT. SANTINO` (pelanggan/supplier/karyawan) tidak dispesifikasikan di sumber.

---

## 4. Laporan Perbandingan COA

Sumber: coA_comparison_report.md.

### 4.1 Ruang lingkup

Membandingkan Chart of Accounts (COA) antara basis `everest_10jul` dan laporan HTML.

### 4.2 Format kode akun

- COA memakai format kode bertingkat (level) 1 sampai 5.
- Perbedaan ditemukan pada struktur/penomoran level kode antar sumber.
- Basis pembanding: `everest_10jul` vs laporan HTML.

### 4.3 Implikasi

- Perbedaan format kode level 1-5 berpotensi menyebabkan pemetaan akun (mapping jurnal) salah bila
  integrasi antar-sistem (ERP lama vs `everest_re`) tidak menormalkan kode akun.
- Rekomendasi: lakukan normalisasi dan pemetaan eksplisit sebelum migrasi/rekonsiliasi COA.

Detail daftar akun yang berbeda per level tidak diuraikan di sumber ini; berkas hanya
melaporkan adanya perbandingan dan ruang lingkupnya.

### 4.4 Struktur Level COA (Umum)

Karena sumber menyebut hierarki level 1-5, tabel berikut merangkum pemahaman umum hierarki akun
(deskripsi generik; nomor akun konkret tidak seluruhnya tersedia di sumber):

| Level | Peran tipikal | Contoh konkret dari sumber |
| :--- | :--- | :--- |
| 1 | Klasifikasi utama (aset, kewajiban, ekuitas, pendapatan, beban) | tidak dispesifikasikan |
| 2 | Kelompok akun | tidak dispesifikasikan |
| 3 | Sub-kelompok | tidak dispesifikasikan |
| 4 | Akun rinci | `2010050` (piutang usaha), `1010030010` (persediaan supplies) |
| 5 | Sub-akun / analitik | `2030060` (PPN non-gunggungan), `2030070` (PPN gunggungan) |

Catatan: nomor `1010030010`, `2030060`, dan `2030070` diambil dari dokumen 09 (AGENTS_SUPPLIES
dan modul taxes) sebagai contoh akun; penempatan levelnya di sini bersifat ilustratif dan tidak
dinyatakan eksplisit pada coA_comparison_report.md.

### 4.5 Risiko Perbedaan COA

1. Salah klasifikasi beban/pendapatan bila kode level 4-5 bergeser.
2. PPN salah akun (tertukar `2030060` vs `2030070`) bila pemisahan gunggungan tidak sejalan.
3. Laporan keuangan tidak dapat direkonsiliasi antar basis bila normalisasi tidak dilakukan.

---

## 5. Dashboard Graph

Sumber: README_DASHBOARD_GRAPH.md.

### 5.1 Komponen

| Komponen | Nama |
| :--- | :--- |
| Controller | `Graph.php` |
| View | `graph.php` |

### 5.2 Filter cabang (`per_cabang`)

- Parameter `per_cabang` memetakan ID cabang `1`, `33`, `34` ke indeks warna/seri `100`, `101`,
  `102`.
- Tujuan: membedakan seri data per cabang pada grafik.

### 5.3 Filter periode

- Filter periode 3/6/12 bulan memakai parameter `v=Xm` (mis. `v=3m`, `v=6m`, `v=12m`).
- Tanggal dasar grafik diambil dari `$get_date` dengan tanggal `01` (awal bulan).

### 5.4 Catatan

Detail query agregasi dan jenis grafik tidak dispesifikasikan lebih rinci pada sumber.

### 5.5 Matriks Parameter Dashboard

| Parameter | Nilai yang dikenal | Fungsi |
| :--- | :--- | :--- |
| `per_cabang` | `1`, `33`, `34` | Memilih cabang (dipetakan ke indeks `100`/`101`/`102`) |
| `v` | `3m`, `6m`, `12m` | Rentang periode grafik (3/6/12 bulan) |

Contoh URL (dibentuk dari pola parameter, bukan kutipan literal sumber):
`Graph/index?v=6m&per_cabang=33`.

### 5.6 Kemungkinan Dampak

- Pemetaan ID cabang `1/33/34` harus konsisten dengan tabel cabang global; bila ada penambahan
  cabang baru, pemetaan indeks warna/seri perlu diperluas agar seri tidak bertabrakan.
- Tanggal dasar `01` berarti grafik selalu dimulai pada awal bulan; perbandingan periode tidak
  tepat jika butuh rentang rolling harian.

Detail implementasi pemetaan warna tidak dispesifikasikan di sumber.

---

## 6. Hasil Analisis Risiko Query

Sumber: analysis_results.md.

### 6.1 Temuan utama

| Temuan | Detail |
| :--- | :--- |
| Tabel utama | `master_project` |
| `trans_start()` | 48 pemanggilan |
| `SELECT ... FOR UPDATE` | Hanya 2 pemakaian |
| Query berisiko | `indexing_main_values` (raw query) |

### 6.2 Interpretasi

- Rasio `SELECT ... FOR UPDATE` yang sangat rendah (2 dari 48 transaksi) mengindikasikan minimnya
  penguncian baris eksplisit, sehingga berpotensi menimbulkan race condition pada operasi
  bersamaan (mis. double save, material menggantung).
- `indexing_main_values` sebagai raw query berisiko terhadap SQL injection bila tidak memakai
  Query Binding, dan berisiko performa bila tidak SARGable/indexed.
- Temuan ini selaras dengan catatan AGENTS.md tentang pengecualian technical debt pada
  `UPDATE transaksi SET indexing_*` di modul `produksi` yang tidak boleh ditiru (dokumen 09
  bagian 12.1).

### 6.3 Dampak Bisnis per Temuan

| Temuan | Gejala berisiko | Dampak bisnis |
| :--- | :--- | :--- |
| Sedikit `FOR UPDATE` | Dua proses mengubah baris `master_project` bersamaan | Double entry, material menggantung, sisa anggaran salah |
| Raw query `indexing_main_values` | Input tidak disanitasi / full scan | SQL injection; query lambat saat data besar |
| Tabel `master_project` jadi pusat | Beban pada satu tabel besar | Lock contention, timeout, antrean transaksi |

### 6.4 Rekomendasi Teknis

1. Tambah `SELECT ... FOR UPDATE` pada jalur kritis yang mengubah `master_project` dan relasinya,
   mengikuti pola yang sudah dipakai pada dua tempat eksisting.
2. Ubah `indexing_main_values` menjadi Query Builder/Query Binding (atau minimal parameterisasi),
   dan pastikan kolom yang difilter berindeks (SARGable).
3. Audit 48 `trans_start()` untuk menandai transaksi yang menulis tanpa penguncian eksplisit.
4. Batasi jumlah kolom `indexing_*` yang di-update serentak untuk mengurangi beban tulis.

---

## 7. Keterbatasan Sumber: Advance Bank & Rekonsiliasi GRUP

- Berkas `ADVANCE_BANK_GRUP_RECONSILE.md` yang diharapkan memuat topik advance bank dan
  rekonsiliasi GRUP TIDAK ada dalam daftar 5 berkas cluster `ev-rekonsiliasi`.
- Referensi tidak langsung hanya ditemukan pada `CHECKPOINT_SESSION_SETTLEMENT.md` (cluster
  settlement), yang menyebut `759`, `bankReconItemsBySlug`, `is_bank_checked`, dan
  `my_cabang_nama()`.
- Karena itu, detail teknis advance bank (akun advance, alur, tabel) dan rekonsiliasi GRUP
  (konsolidasi antar-cabang/holding) tidak dapat disintesis dari cluster ini. Tulisan
  "tidak dispesifikasikan di sumber" berlaku untuk bagian ini.

### 7.1 Yang Dapat Disimpulkan (Terbatas)

| Aspek | Status |
| :--- | :--- |
| Alur settlement `759` | Disebut pada checkpoint |
| Fungsi `bankReconItemsBySlug` | Disebut sebagai pengambil item rekonsiliasi |
| Flag `is_bank_checked` | Disebut sebagai penanda verifikasi |
| Filter cabang `my_cabang_nama()` | Disebut sebagai helper konteks cabang |
| Akun advance bank | Tidak dispesifikasikan di sumber |
| Aturan rekonsiliasi GRUP | Tidak dispesifikasikan di sumber |
| Tabel/kolom pendukung | Tidak dispesifikasikan di sumber |

---

## 8. Temuan Lintas-Dokumen & Kontradiksi

1. Dua basis data berbeda: master kontak pada PostgreSQL `everest_db`/PostgreSQL 16 (Laravel 13,
   `Y:\everest_re`) vs ERP Everest utama pada MariaDB/MySQL (CI3, PHP 5.6). Ini bukan
   kontradiksi, melainkan dua sistem; namun integrasi data AR/kontak harus menangani perbedaan
   dialek SQL dan tipe data.
2. Format kode COA tidak seragam (level 1-5 antara `everest_10jul` dan laporan HTML); berpotensi
   memutus pemetaan akun pada jurnal GL dan modul taxes (dokumen 09 bagian 11).
3. Angka `4467` muncul pada transkrip master kontak dan rekonsiliasi AR dengan konteks berbeda
   (kode modul vs rekening). Perlu kehati-hatian.
4. Dashboard Graph memakai ID cabang `1/33/34` sedangkan dokumen lain memakai penomoran cabang
   berbeda; belum ada referensi silang pemetaan ID cabang global.
5. `indexing_main_values` sebagai raw query tercatat berisiko, selaras dengan catatan technical
   debt AGENTS.md pada `UPDATE transaksi SET indexing_*`; keduanya menunjuk ke area yang sama.
6. Topik advance bank/rekonsiliasi GRUP tidak dapat diverifikasi dari sumber, sementara
   checkpoint settlement (dokumen 10) mengasumsikan keberadaannya. Ini kesenjangan dokumen yang
   harus ditutup.
7. Rekening piutang `2010050` hanya muncul di berkas AR; tidak ada rujukan silang ke config
   transaksi (mis. `coTransaksiCore.php`) pada sumber, sehingga belum terbukti konsisten dengan
   mapping jurnal aktual.
8. Contoh akun level 4-5 (`1010030010`, `2030060`, `2030070`) berasal dari dokumen cluster lain;
   tidak ada konfirmasi bahwa laporan COA (`everest_10jul`/HTML) memuat nomor yang sama.

---

## 9. Rekomendasi Konvergensi

1. Normalisasi COA level 1-5 terlebih dahulu sebelum migrasi/rekonsiliasi, dengan pemetaan akun
   eksplisit antara ERP utama dan `everest_re`.
2. Terapkan satu sumber kebenaran untuk saldo piutang `2010050`; semua penerimaan (Penerimaan,
   Kas, PenerimaanProjek) menulis ke jalur jurnal yang sama.
3. Perkuat jejak audit: konsistenkan `trash = 0` dan `cancel_dtime` pada seluruh jalur
   pembatalan lintas modul.
4. Tingkatkan penguncian transaksi pada `master_project` (lihat bagian 6.4).
5. Lengkapi berkas `ADVANCE_BANK_GRUP_RECONSILE.md` dan tautkan eksplisit ke checkpoint `759`.
6. Satukan konvensi pemetaan ID cabang (dashboard vs modul lain) dalam satu tabel referensi.

---

## 10. Glosarium

| Istilah | Arti |
| :--- | :--- |
| AR | Accounts Receivable (piutang usaha) |
| GRN | Good Receipt Note (dokumen penerimaan barang) |
| COA | Chart of Accounts (bagan akun) |
| `everest_re` | Proyek Laravel 13 + PostgreSQL 16 di `Y:\everest_re` |
| `everest_10jul` | Basis MariaDB snapshot 10 Juli (pembanding COA) |
| `master_kontak` | Tabel kontak ePub 5.232 baris dengan tiga flag peran |
| PSAK 72 / IFRS 15 | Standar pengakuan pendapatan dari kontrak pelanggan |
| ISA 500 | Standar bukti audit |
| `bankReconItemsBySlug` | Pengambil item rekonsiliasi bank berdasarkan slug |
| `is_bank_checked` | Penanda item bank telah diverifikasi |
| `my_cabang_nama()` | Helper nama cabang aktif |
| `indexing_main_values` | Raw query berisiko pada `master_project` |
| `trans_start()` (48) | Titik transaksi DB; hanya 2 memakai `FOR UPDATE` |

---

## 11. Lampiran Daftar File Sumber

| No | Berkas | Fokus |
| --- | --- | --- |
| 1 | ARSITEKTUR_REKONSILIASI_PENERIMAAN_AR.md | Modul AR, rekening 2010050, PSAK 72/ISA 500 |
| 2 | transkrip_konteks_arsitektur_master_kontak_dan_partner_2026-09-08.md | master_kontak 5.232 baris, PostgreSQL, Laravel |
| 3 | coA_comparison_report.md | Perbandingan COA level 1-5 |
| 4 | README_DASHBOARD_GRAPH.md | Controller Graph.php, filter per_cabang, v=Xm |
| 5 | analysis_results.md | master_project, 48 trans_start, 2 FOR UPDATE, indexing_main_values |
