# Strategi UAT, Checklist, dan Evidence - Sintesis Dokumen UAT SAN ERP Varian

Dokumen sintesis ini menggabungkan seluruh artefak UAT yang tersimpan pada direktori `file_md_san` menjadi satu narasi metodologis yang utuh. Fokusnya adalah metodologi UAT, tata kelola evidence, dan temuan lintas dokumen. Sumber asli Server Area (SAN) Subscriber Entry ERP ini mencakup tiga lapis pekerjaan yang berbeda namun saling terkait: (1) pengujian penerimaan pengguna terhadap aplikasi varian, (2) prosedur audit dan aturan kerja penguji, serta (3) catatan perubahan kode hasil remediasi defect yang menjadi bahan uji regresi.

---

## 1. Ringkasan Eksekutif

Korpus 12 dokumen ini membentuk sebuah sistem UAT yang berkembang dari pengujian cepat menuju pengujian formal, dari cakupan luas menuju cakupan teknis mendalam, namun belum pernah ditutup dengan satu pun verdict formal.

Temuan utama:

1. **Belum ada satu pun verdict PASS/FAIL yang terisi di seluruh korpus.** Tujuh dokumen memberikan bentuk status PASS/FAIL secara eksplisit maupun implisit (UAT_CHECKLIST_PRODUKSI_776.md bagian 5, panduan-uat-manual-user.md lembar ringkasan, dan dokumen varian fase 1 secara implisit), dan seluruh kolom tersebut masih kosong. Checkbox `[ ] PASS [ ] FAIL` di dua dokumen utama tidak pernah dicentang. Dokumen quick check fase 1 dan fase 2 sama sekali tidak memiliki field status per skenario, hanya kriteria lulus naratif. Akibatnya UAT ini secara formal berstatus draf-baseline, bukan executed-and-signed.
2. **Cakupan eksekusi sangat tidak merata.** Hanya satu dokumen yang menandai langkah sebagai selesai, yaitu UAT_CHECKLIST_PRODUKSI_776.md: tiga grup prasyarat (1.1-1.3) seluruhnya `[x]`, TC-01 seluruhnya `[x]`, TC-02 seluruhnya `[x]`, dan TC-03 bertanda `[-]` (sebagian). Seluruh lima skenario quick check, enam kasus bug, tujuh skenario modul, enam skenario non-modul, sebelas titik trace, dan seluruh butir audit pascatransaksi pada bagian 4 belum dieksekusi atau tidak direkam.
3. **Terdapat dua basis UAT yang berjalan paralel tanpa traceability.** UAT aplikasi varian (purchase-to-sale, lockers, API bridge, rekening pembantu varian) berbasis April 2026 yang ditopang skrip `docs/sql/2026040*` dan `20260412`, serta UAT aplikasi produksi 776 berbasis September 2026 pada branch `z:/san_27sep/`. Keduanya memakai simbol yang sama (Fase 1, Fase 2, UAT Varian) sehingga pembaca awam mengira satu campaign tunggal, padahal ruang lingkup, environment, dan rite execution berbeda.
4. **Satu file menyesatkan: `uat-checklist.md` bukan checklist UAT sama sekali.** Isinya adalah log perubahan kode (change log) berupa 12 blok update bertanggal 2026-07-27 hingga 2026-08-04, berisi belasan item `[x]` seperti SQL Security Sanitization, Debug Output Cleanup, dan Variant Revert Item Matching. Justru file inilah yang merupakan bahan uji regresi paling kaya, bukan lembar UAT.
5. **Sertifikat evidence sudah dirumuskan tetapi nol evidence terlampir.** Tiga dokumen quick check menetapkan evidence minimum yang eksplisit (URL transaksi, nomor dokumen, screenshot, hasil query smoke-check, status akhir). Dua skrip smoke-check sudah ada (`docs/sql/20260409_phase1_uat_smoke.sql` dan `docs/sql/20260409_phase2_uat_smoke.sql`) dan satu skrip dengan parameter yang harus diisi manual (`docs/sql/20260412_rekening_varian_uat_smoke.sql` dengan `@TRX_ID`, `@PRODUK_ID`, `@VARIANT_ID`, `@REKENING`). Tidak ada satu pun hasil eksekusi skrip tersebut yang direkam di korpus.
6. **Metodologi matang, governance lemah.** `user_learning_rules.md` mendefinisikan protokol audit 4-lapis yang ketat (transaksi_data, buku pembantu, stok fisik, output UI), `spec-driven-testing.md` mendefinisikan siklus plan-generate-heal Playwright yang matang, dan `UAT_POINT_TO_POINT_TRACE.md` mendefinisikan trace sebelas titik lintas CRM-Subsidiary-Holding. Seluruh metodologi itu belum pernah diapungkan menjadi bukti.
7. **Jumlah kasus UAT yang didefinisikan di korpus: 80 unit uji**, terdiri atas 8 kasus produksi 776, 19 skenario manual user, 11 titik trace, 10 langkah quick check fase 1, 5 skenario quick check fase 2, 3 skenario rekening varian, dan 24 butuan matriks varian fase 1, ditambah lima skrip SQL dan satu paket dummy data.
8. **Risk baseline sangat konkret.** Dokumen varian fase 1 dan pedoman 776 menyinggung failure yang sudah pernah terjadi: ghost row `produk_id = 0` (Bug 1A), overwrite multi-varian (Bug 4A/4B), popup otorisasi false-positive (Bug 5G/5H), popup negative stock `-179` saat Clear Cart, SQL error 1064, dan pemakaian `array_key_exists` pada kolom yang salah. Ini adalah daftar minimal yang harus menjadi regression gate, dan saat ini belum ada gate otomatisnya.

---

## 2. Strategi dan Filosofi UAT

### 2.1. Golden Circle (Why - How - What)

#### Why: integritas stok dan akuntansi, bukan sekadar keamanan tampilan

Kewajiban yang paling sering disebut berulang di korpus adalah integritas akuntansi dan stok, bukan estetika UI:

- `user_learning_rules.md` bagian 6: pemisahan arsitektur akuntansi (RekeningPembantuProduk pada level master produk untuk PSAK 14/IFRS) dan layer operasional stok varian (`stock_locker_variant` plus `rek_cache_persediaan_produk_varian_fifo` untuk ISO 9001:2015 klausul 8.5.2 traceability).
- `user_learning_rules.md` bagian 1: reputasi klien adalah yang utama; dilarang mengklaim "Sudah Oke" hanya berdasarkan asumsi atau kode yang tampak sekilas benar, karena setiap klaim harus didukung bukti empiris data session, query database, dan pengujian sintaks.
- `UAT_CHECKLIST_PRODUKSI_776.md` bagian 4.2: uji pembukuan menuntut total Debet dan Kredit imbang dengan selisih Rp 0 pada akun `1010030050` (Persediaan Supplies Proses) dan `1010030010` (Persediaan Supplies).
- `uat-checklist.md` mengaitkan setiap remediasi kode ke standar: ISO 27001, UU ITE Pasal 30, ISA 500 Audit Log Integrity, PSAK 14, PSAK 72, PSAK 10, dan ISO 25010.

Golden Circle ini konsisten: Why-nya bersifat komparatif atau regulator, How-nya berupa audit berlapis dan gate varian, What-nya berupa checklist skenario yang terukur.

#### How: audit berlapis, gate varian, dan otomatisasi

Empat mekanisme How yang saling melengkapi:

1. Protokol audit 4-lapis simultan (lihat bagian 3.3) untuk membuktikan konsistensi UI, database, buku pembantu, dan stok fisik.
2. Gate varian di level kode dan database: `ComLockerStockDualWrite`, `MdlLockerStockVariant`, guard `jenis_locker`, ekstraksi cart key `variant:PID:VID`, dan penolakan ghost row di `MdlTransaksi::writeDetailEntries()`.
3. Point-to-point trace P00-P10 dengan token tunggal untuk mendeteksi titik putus.
4. Spec-driven testing Playwright (plan, generate, heal) sebagai regression gate otomatis.

#### What: artefak uji yang terdefinisi

Delapan puluh unit uji yang tersebar pada tujuh dokumen UAT (lihat bagian 4 dan 5), ditambah satu template CSV trace (`application/UAT_POINT_TO_POINT_TRACE_TEMPLATE.csv`), lima skrip SQL, satu paket dummy data UAT, dan satu lembar sign-off empat pihak.

### 2.2. 5W1H sebagai Kerangka Analisis

| Unsur | Pemetaan Konkret dari Sumber |
|---|---|
| Who (siapa) | UAT 776: Operator Produksi (`p_produksi`), Supervisor Produksi (`p_produksi_spv`), Tim Akuntansi dan Gudang. UAT varian fase 1: role input transaksi, role approval/followup, role akses printing/history. UAT manual user: User, Team QA, Tim Operasional, Penguji. Aktor teknis: Agent 7 (audit dan refactoring), Agent 5 (perbaikan distribusi), CLI `CliTransaksi` |
| What (apa) | Pengujian varian end-to-end (master, PO, GRN, invoice, print, QR), pengujian produksi 776 (assembling tiga tahap), trace integrasi CRM-Subsidiary-Holding sebelas titik, audit rekening pembantu varian, serta controller non-modul (`/Addons/ViewDetails`, `/Katalog/viewProduk`, `/Data/view/Produk`, `/addons/Qr/doPrint`, `/Spread/index/produk/cabang/hargaProduk`, `/Ledger/viewMovementGroup/fg`) |
| When (kapan) | Rilis UAT 776: 30 September 2026 di Staging/Development. Panduan manual: 2026-07-27. Basis skrip smoke-check varian: 2026-04-09 dan 2026-04-12. Remediasi kode terakhir: 2026-08-04. Urutan eksekusi 776: Step 1 `776r`, Step 2 `776a`, Step 3 `776`, lalu audit 4.1-4.3 |
| Where (di mana) | URL manual UAT: `https://192.168.5.33/new_san_variant/`. DB varian auto-sync: `192.168.5.10` (1.480 baris sentinel). Branch 776: `z:/san_27sep/`. Endpoint kunci: `/produksi/Create/index/776`, `/produksi/FollowUp/index/776`, `/pembelian/Create/index/466`, `/pembelian/FollowUp/index/466`, `/penjualan/Create/index/582`, `/pindahgudang/Create/index/585`, `/opname/Opname/viewOpnameAktive`, `/konversi/Create/index/1334` |
| Why (mengapa) | MemperRL protects integritas stok, akuntansi, dan audit trail (bagian 2.1) |
| How (bagaimana) | Protokol audit 4-lapis, spec-driven plan-generate-heal Playwright, point-to-point trace P00-P10, evidence minimum per skenario, dummy data seeding ber-marker `[UATV3_...]` |

### 2.3. Point-to-Point Trace sebagai Filosofi Temuan

`UAT_POINT_TO_POINT_TRACE.md` menetapkan filosofi paling eksplisit dalam korpus: menemukan titik putus proses secepat mungkin, bukan hanya tahu gagal di akhir. Prinsipnya adalah memakai token yang sama dari awal sampai akhir, yaitu `estimate_id`, `referensi_id`, `bridge_id`, `so_nomer`, `po_nomer`, `holding_so_nomer`, serta `variant_id`/`cart_key`. Setelah token terisi, langkah dijalankan berurutan dari P00 sampai P10, setiap step harus lulus sebelum lanjut, dan jika gagal dicatat di kolom "Putus di titik".

Berbeda dengan checklist yang bersifat semuanya lulus atau semuanya gagal, trace bersifat diagnostik: begitu satu titik putus, investigator langsung tahu subsistem mana yang harus dibedah. Aturan isolasi root cause memetakan setiap rentang titik ke fokus investigasi: P00-P01 ke CRM dan network webhook; P02-P05 ke intake subsidiary, preview, session, dan picker varian; P07-P08 ke bridge builder dan scheduler CLI subsidiary; P09 ke scheduler dedicated di holding; P10 ke callback endpoint dan mapping `referensi_id`.

### 2.4. Aturan Checkout UAT: Kapan Selesai

Belum ada satu dokumen pun yang menyatakan ambang kelulusan UAT secara eksplisit sebagai gerbang rilis. Yang ada adalah kriteria lulus yang tersebar:

- Quick check fase 1: jalur beli-terima-jual varian mode `GLOBAL` berjalan; jalur non-varian tidak regress; guard transisi legacy menahan aktivasi; tidak ada baris ambigu atau ghost.
- Quick check fase 2: tidak ada overwrite antar varian parent sama; tidak ada mismatch release locker saat reset cart; non-varian stabil; tidak ada error PHP atau DB di log.
- Rekening varian: mutasi `_rek_pembantu_produk_varian` terbentuk dengan pasangan `extern2_id=produk_id master` dan `extern_id=variant_id`; rollup `_rek_pembantu_produk` tetap hidup; non-varian tidak menghasilkan noise; net qty dan net nilai masuk akal.
- Varian fase 1: semua skenario non-varian lulus tanpa regresi; semua skenario varian lulus tanpa SQL error; selisih UI preview versus DB detail versus print = 0; tidak ada mismatch stok atau accounting.
- Point-to-point: semua P00-P10 lulus; `variant_id` dan `cart_key` konsisten dari preview-cart-transaksi-bridge; tidak ada SQL error, notice, atau warning di proses utama.

Rekomendasi turunan: gerbang rilis seharusnya mengikat lima kriteria ini dengan lembar sign-off bertanda tangan empat pihak yang sudah tersedia di `UAT_CHECKLIST_PRODUKSI_776.md` bagian 5.

---

## 3. Metodologi

### 3.1. Spec-driven Testing: Plan - Generate - Heal

`spec-driven-testing.md` mendefinisikan alur kerja end-to-end untuk menulis dan memelihara Playwright test memakai `playwright-cli`, dalam tiga seksi yang dapat dipakai independen.

**Plan.** Tujuan: menghasilkan file spec (misal `specs/<feature>.plan.md`) yang mengenumerate skenario. Prasyarat: workspace Playwright terpasang, yaitu ada `playwright.config.ts` atau `playwright.config.js` dan `npx --no-install playwright --version` berhasil; jika belum, jalankan `npm init playwright@latest`. Konsep kunci: seed test, yaitu test minimal yang mendaratkan halaman pada state awal setiap skenario (navigasi ke aplikasi, login, feature flag). `--debug=cli` berhenti di dalam seed, sehingga seed adalah titik awal setiap sesi planning dan generation. Seed minimal melakukan `page.goto`; seed yang diutamakan mendorong navigasi ke fixture agar test skenario dapat me-reuse-nya. Eksplorasi aplikasi dilakukan dengan menjalankan `npx playwright test tests/seed.spec.ts --debug=cli` di background lalu `playwright-cli attach tw-XXXX`, lalu `playwright-cli resume`, `playwright-cli snapshot`, `playwright-cli click e5`, `playwright-cli eval "location.href"`, dan `playwright-cli show --annotate`. Peta yang harus dibuat mencakup interactive surface, primary user journey, edge case (empty state, validation error, input sangat panjang, boundary value), persistence (reload, local/session storage, URL fragment), dan navigation (back/forward behaviour). Dua aturan penting: jangan membuka URL aplikasi langsung dengan playwright-cli, selalu lewat test agar custom setup ikut tertangkap; dan hentikan background test setelah selesai menjelajah.

Struktur spec file yang diwajibkan: judul, bagian `## Application Overview` satu paragraf, lalu `## Test Scenarios` dengan grup bernomor. Tiap grup menyebut `**Seed:** tests/seed.spec.ts`; tiap skenario memakai `#### 1.1. <kebab-case-scenario-name>` dengan baris `**File:**` dan langkah bernomor; tiap langkah berisi bullet `- expect:`. Pedoman: tiap skenario independen mulai dari fresh state seed dan tidak boleh di-chain; nama skenario kebab-case dan cocok dengan nama file; cakup happy path, edge case, validasi, negatif, dan persistence; tulis langkah di level user bukan level API; setiap bullet `expect:` menjadi assertion saat generation.

**Generate.** Input: file spec, target (satu skenario seperti `1.2`, satu grup, atau semua), dan seed file yang dibaca dari baris `**Seed:**`. Satu skenario diproses berurutan dan tidak paralel karena berbagi seed session: attach, resume, lalu jalankan langkah spec satu per satu dengan playwright-cli sambil memperlakukan spec sebagai rencana dan aplikasi live sebagai sumber kebenaran. Jika langkah vague atau bertentangan dengan perilaku aplikasi, spec diperbarui di tengah generation dan itu diharapkan terjadi. Tiap aksi playwright-cli mencetak kode Playwright TypeScript setara; untuk tiap bullet `expect:` tambahkan assertion eksplisit. Kode dikumpulkan dan ditulis ke path dari spec. Aturan: satu test per file; nama file, describe, dan test diambil verbatim dari spec tanpa ordinal; prefix tiap langkah dengan komentar `// N.`; import dari `./fixtures` bila ada. Penting: tutup sesi CLI dan hentikan background test sebelum pindah skenario. Untuk banyak skenario, lakukan loop dengan restart seed di antaranya sehingga tiap test mulai dari halaman bersih.

**Heal.** Jalankan `npx playwright test` penuh, catat daftar entri `<file>:<line>` yang gagal, dan proses satu per satu tanpa paralel karena shared state dan sesi CLI tunggal membuatnya rapuh. Debug: jalankan test tunggal yang gagal dengan `--debug=cli` di background, attach, lalu `playwright-cli snapshot` (apakah element berubah, berpindah, atau berganti nama), `playwright-cli console` (error sisi aplikasi), `playwright-cli network` (request gagal atau payload salah), dan `playwright-cli show --annotate`. Penyebab umum: selector drift, wrapper element baru, rename label atau ARIA, timing, assertion yang teksnya sudah diubah aplikasi, dan data uji yang bocor antar run. Fix diterapkan ke test file (locator, assertion, urutan langkah, atau input), lalu test tunggal dijalankan ulang sampai hijau. Larangan tegas: jangan pernah skip hooks atau menambah sleep sebagai fix, dan jangan pernah memakai `networkidle`.

Rekonsiliasi spec: jika fix murni teknis dan perilaku user-level masih cocok dengan aplikasi, spec tidak disentuh. Jika fix mengubah langkah, input, urutan, atau ekspektasi yang dideskripsikan spec, spec diperbarui dengan mempertahankan id skenario dan path file; hanya baris step dan expect yang berubah. Jika tidak jelas apakah perubahan aplikasi disengaja (spec basi) atau merupakan regresi (test benar, aplikasi salah), berhenti dan tanya user dengan menyebut id skenario, baris spec yang tidak lagi cocok, dan perilaku aplikasi yang diamati dengan menyalin cuplikan snapshot atau hasil konkret. Only after user menjawab, diperbarui spec (perubahan disengaja) atau test ditandai sebagai mencakup bug (regresi). Menyerah hanya sah bila penguji yakin test benar dan aplikasi salah serta pengguna telah mengonfirmasi itu bug; lalu test ditandai `test.fixme(...)` dengan komentar yang menunjuk keputusan pengguna atau tautan issue. Jangan pernah skip diam-diam.

Relevansi terhadap UAT manual: spec-driven testing menyiapkan regression gate yang hilang dari korpus UAT. Enam kasus bug yang ada di panduan manual saat ini hanya punya checkbox manual; idealnya dinaikkan menjadi Playwright scenario yang di-heal secara otomatis.

### 3.2. Evidence Template: Apa yang Wajib Dikumpulkan

Tiga dokumen quick check menetapkan standar evidence yang konsisten dan dapat dijadikan template tunggal korpus.

**Evidence minimum per skenario (quick check fase 1):**
1. URL transaksi yang diuji.
2. Nomor dokumen hasil simpan.
3. Screenshot preview, follow-up, dan invoice.
4. Hasil query smoke-check dari `docs/sql/20260409_phase1_uat_smoke.sql`.
5. Status akhir: `PASS` atau `FAIL`.

**Evidence yang disimpan (rekening varian fase 2):**
1. URL dokumen transaksi.
2. `transaksi_id` dan nomor dokumen.
3. Hasil query smoke-check.
4. Status `PASS`/`FAIL` per skenario.

**Evidence trace (point-to-point, via CSV):** kolom yang harus diisi adalah `status`, `actual_result`, `root_cause`, `next_action`, dan `evidence_link`. File template: `application/UAT_POINT_TO_POINT_TRACE_TEMPLATE.csv`, dibuka di Excel dengan filter kolom `status`.

Dari lima elemen evidence minimum tersebut, korpus sudah menyediakan dua artefaknya: URL (diketahui, misal `https://192.168.5.33/new_san_variant/`) dan nomor dokumen (format dan prefix sudah dijelaskan di panduan manual, misal `UATV3.<tag>.`), serta query smoke-check (tiga skrip SQL tersedia). Yang belum ada adalah screenshot, hasil query, dan status akhir, yaitu tiga elemen terakhir yang justru penentu sah atau tidaknya sebuah temuan.

**Evidence berbasis eksekusi (bukan sekadar screenshot).** `user_learning_rules.md` bagian 2 mengatur bahwa perintah "Cek Session" menuntut deep audit file session aktif di `C:/xampp/tmp/ci_session*`, sedangkan perintah "Jalankan CLI Transaksi" menuntut eksekusi langsung method `CliTransaksi::run_cliTransaksi()` via `c:\xampp\php\php.exe "c:\xampp\htdocs\new_san_variant\scratch\run_cli_via_argv.php"` dengan penyetelan `$_GET['tr_id']` bila ada transaksi spesifik, lalu melaporkan sub-komponen yang tereksekusi (`RekeningPembantuProdukRiil`, `ComJurnal`, `FifoProdukJadiVarian`), durasi eksekusi, dan status pemrosesan di database.

### 3.3. Protokol Audit dan Onboarding Penguji

**Protokol audit 4-lapis (wajib, simultan).** `user_learning_rules.md` bagian 5 melarang mengklaim hasil verifikasi hanya berdasarkan satu atau dua tabel. Setiap uji transaksi atau stok wajib melewati empat layer:

1. Layer 1, input detail transaksi: tabel `transaksi_data` (qty dan variant ID).
2. Layer 2, buku pembantu dan mutasi: tabel `_rek_pembantu_produk_cache` dan `__rek_pembantu_produk_riil__*` (saldo awal, mutasi GRN, saldo akhir).
3. Layer 3, stok fisik gudang: tabel `stock_locker_variant` dan `stock_locker` (active stock per variant dan per parent).
4. Layer 4, tampilan UI modal: output `variantPicker` di `_selectorItem.php`.

**Guardrail integritas varian yang wajib diuji ketahanannya:**

- Gate mapping `"extern_id" => "produk_id"` di seluruh `coTransaksiCore.php` (28+ modul). Dilarang `"extern_id" => "id"` karena pada fitur varian `$item['id']` berisi cart key `variant:PID:VID` yang akan di-typecast MariaDB menjadi `0` pada kolom `INT`.
- Ghost row prevention: `MdlTransaksi::writeDetailEntries()` wajib memasang guard filter yang menolak record dengan `produk_id = 0`, `barang_id = 0`, `qty = 0`, atau `nama = ''`; item kosong harus me-return `null` sehingga tidak ter-insert ke `transaksi_data`.
- Smart extraction cart key: ekstrak PID murni untuk `produk_id` dan VID murni untuk `variant_id` sebelum insert atau update, baik di `MdlTransaksi::writeDetailEntries()` maupun di `FollowUp.php`.
- `MdlLockerStockVariant::$tableName` wajib bernilai `stock_locker_variant`; filter query wajib mendukung kondisi `jenis_locker = 'stock' OR jenis_locker IS NULL OR jenis_locker = ''`.
- `ComLockerStockVariant` wajib mengisi `jenis_locker = 'stock'` untuk setiap baris stok varian baru; model stok wajib mengekstrak `variant_id` dari cart key bila tidak disertakan pada static config.
- Seluruh transaksi berdampak stok fisik (termasuk GRN `467`, mutasi, dan penjualan) wajib dikonfigurasi memakai `ComLockerStockDualWrite` dengan mapping eksplisit `variant_id` dan `variant2_id`; dilarang memakai `LockerStock` tunggal pada modul yang mendukung varian.
- Filter raw SQL berkurung atau ber-OR di `MdlMother::fetchCriteria()` harus dialokasikan ke `$this->criteria2` sebagai string raw murni, bukan di-explode tanda `=`; di `MdlMother::addData()` ekspresi tersebut wajib dilewati dengan `continue;`. Keduanya mencegah MariaDB Syntax Error 1064.
- `MdlLockerStockVariant::cekLoker()` wajib melakukan fallback lookup ke HQ atau Gudang Utama (`cabang_id = -1`, `gudang_id = -1`) bila stok varian tidak ditemukan pada cabang dan gudang spesifik login.
- Invarian akumulasi stok fisik: penerimaan GRN varian baru dilarang mengurangi stok master non-varian (`variant_id = 1`) yang sudah ada sebelumnya; rumus total akumulasi adalah saldo awal stok master ditambah penerimaan GRN varian baru.

**Onboarding dan persiapan environment.** Tiga checklist prasyarat harus dilewati sebelum test case pertama.

1. Prasyarat produksi 776: RBAC (User A memiliki grup `p_produksi`, User B memiliki grup `p_produksi_spv`, dan User A tidak boleh approve Step 2 maupun Step 3); master produk rakitan dan BOM (`MdlProdukRakitan`, komposisi bahan pada `MdlProdukKomposisi_and_cost` tipe `produk` dan `biaya` lengkap dengan kuantitas, nilai standar, dan mapping COA, tanpa komponen bernilai Rp 0); kesiapan saldo fisik gudang cabang (`MdlGudang`, catat saldo awal kartu stok bahan baku dan barang jadi sebelum UAT dimulai).
2. Prasyarat varian fase 1: SQL fase-2 bridge sudah dijalankan dan postcheck `missing_total = 0`; patch kode fase-1 sudah terpasang di holding dan subsidiary; data uji tersedia (produk non-varian, produk varian dengan minimal dua varian untuk produk yang sama, dan data CRM lama); user role uji tersedia (input transaksi, approval atau followup, akses printing atau history). Paket data dummy di `application/sql/variant_migration_phase3_uat_dummy/` dijalankan berurutan: `00_precheck_uat_dummy.sql`, `10_seed_crm_uat.sql`, `20_seed_holding_uat.sql`, `30_seed_subsidiary_uat.sql`, `90_verify_uat_dummy.sql`, lalu wajib cleanup dengan `99_cleanup_uat_dummy.sql`. Marker data dummy: `description` diawali `[UATV3_...]` dan nomor transaksi dummy diawali `UATV3.<tag>.`.
3. Prasyarat fase 1 quick check: migration kontrak varian transaksi sudah dijalankan; migration `variant_price_mode` sudah dijalankan; tabel stok varian (`stock_locker_varian` dan tabel support) sudah tersedia; guard aktivasi varian sudah aktif di `ProductVariantSettings`; scope harga fase 1 tetap `GLOBAL` karena mode `VARIANT` belum diaktifkan untuk transaksi. Prasyarat fase 2 quick check: tabel `stock_locker_varian`, `stock_locker_mutasi_varian`, dan `rek_cache_persediaan_produk_varian_fifo` tersedia; produk uji punya minimal dua varian aktif pada parent yang sama; saldo stok varian sudah ada dari cutover atau transaksi sebelumnya. Prasyarat rekening varian: tabel `_rek_pembantu_produk_varian_cache` dan `_rek_pembantu_produk_varian` tersedia; kontrak data varian transaksi sudah aktif (`variant_id`, `variant_label`, dan sejenisnya); sudah ada minimal satu transaksi varian untuk pembelian dan penjualan.

Bootstrap environment Playwright bila test otomatis dipakai: `npm init playwright@latest`, pastikan ada seed test, dan sediakan dokumen cross-reference yang dirujuk yaitu `playwright-tests.md`, `test-generation.md`, `request-mocking.md`, serta `session-management.md`. Keempat berkas tersebut tidak ada dalam korpus UAT dan merupakan gap dokumentasi.

---

## 4. Katalog Dokumen UAT yang Ada

| Nama File | Cakupan | Jumlah Case | Status |
|---|---|---|---|
| `uat-checklist.md` | Change log remediasi kode pada modul adjustment, produksiproses, produksi, distribusisupplies, distribusiproduksi, distribusifg, opname, pindahgudang, penjualanproject, penjualan, biaya, pembelianimport, pembelian, dan konversi, ditambah Katalog.php dan ViewDetails; bertanggal 2026-07-27 sampai 2026-08-04 | 0 kasus UAT (puluhan item remediasi bertanda `[x]`) | Selesai sebagai log; bukan lembar UAT |
| `UAT_CHECKLIST_PRODUKSI_776.md` | UAT modul produksi kode transaksi 776 (Product Assembling / Perakitan Produk) tiga tahap: 776r, 776a, 776 | 8 kasus (TC-01 sampai TC-08) + 3 grup prasyarat + audit 4.1-4.3 | TC-01 dan TC-02 dieksekusi; TC-03 parsial; sisanya belum; verdict kosong |
| `panduan-uat-manual-user.md` | Panduan pengujian lapangan varian ERP di `https://192.168.5.33/new_san_variant/`: kasus bug, modul inventory, dan controller non-modul | 19 skenario (6 kasus bug + 7 skenario modul + 6 endpoint non-modul) | Belum dieksekusi; verdict kosong |
| `UAT_POINT_TO_POINT_TRACE.md` | Trace point-to-point integrasi CRM ke Subsidiary ke Holding, 11 titik P00-P10 dengan query SQL per titik | 11 titik trace | Belum dieksekusi; kolom Putus di titik kosong |
| `UAT_CHECKLIST_VARIAN_FASE1.md` | UAT produk varian fase 1: matriks pembelian, distribusi, penjualan, API holding-subsidiary, dan validasi DB | 24 butuan uji (8+4+5+3+4) | Belum dieksekusi; postcheck `missing_total=0` disyaratkan |
| `phase1-uat-quick-check.md` | UAT cepat fase 1 varian: master, pembelian, GRN, penjualan, guard legacy, validasi stok | 10 langkah uji berurutan | Belum dieksekusi; tidak ada field status per langkah |
| `phase2-uat-quick-check.md` | UAT teknis fase 2 variant identity di followup, locker, dan cache | 5 skenario | Belum dieksekusi; tidak ada field status per skenario |
| `phase2-uat-rekening-varian-check.md` | UAT verifikasi posting accounting item varian di pembelian dan penjualan | 3 skenario + parameter skrip SQL | Belum dieksekusi; parameter skrip belum diisi |
| `spec-driven-testing.md` | Metodologi otomatisasi UAT: plan, generate, heal Playwright | 3 seksi (Plan, Generate, Heal) | Dokumen metodologi; bukan test case |
| `user_learning_rules.md` | Aturan kerja dan protokol audit penguji: integritas varian, cross-check 4-lapis, eksekusi CLI | 6 bagian aturan dengan 17 guardrail | Dokumen governance; bukan test case |
| `pedoman_as_is_lock.md` | Mode AS-IS LOCK untuk konversi HTML ke PDF tanpa refactor (1:1, stop bila ada beda) | 1 mode kerja | Dokumen prosedur |
| `eform.md` | Rangkuman diskusi pembatasan PDF untuk stock opname versus e-Form pajak; solusi PDF interaktif FDF/XFDF via `pdftk` | 1 alur kerja 5 langkah + 2 tantangan | Dokumen reference teknis |

Total kasus UAT yang terdefinisi: 8 + 19 + 11 + 24 + 10 + 5 + 3 = 80 butuan uji.

---

## 5. UAT Produksi, UAT Varian, dan UAT Quick Check Fase 1/2

### 5.1. UAT Produksi 776 (Product Assembling) - Status per Kasus

Basis: branch `z:/san_27sep/`, environment Staging atau Development Test Environment, rilis UAT 30 September 2026, akun Operator `p_produksi` dan Supervisor `p_produksi_spv`, kertas A4/F4. Legenda status: `[x]` selesai, `[-]` parsial, `[ ]` belum dieksekusi.

| ID | Skenario | Target Endpoint | Legenda | Status | Verdict |
|---|---|---|---|---|---|
| 1.1 | User dan Hak Akses (RBAC): A punya `p_produksi`, B punya `p_produksi_spv`, A tidak boleh approve Step 2 dan Step 3 | Konfigurasi user | `[x]` | Selesai | - |
| 1.2 | Master produk rakitan dan BOM: `MdlProdukRakitan`, komposisi `produk` dan `biaya` lengkap, tanpa komponen Rp 0 | Master produk | `[x]` | Selesai | - |
| 1.3 | Kesiapan saldo fisik dan gudang cabang, catat saldo awal kartu stok | `MdlGudang` | `[x]` | Selesai | - |
| TC-01 | Siklus lengkap assembling: Step 1 `776r` (5 unit), Step 2 `776a` otorisasi dan jurnal WIP, Step 3 `776` complete | `/produksi/Create/index/776` lalu `/produksi/FollowUp/index/776` | `[x]` semua langkah | Dieksekusi | Kosong |
| TC-02 | Negative: validasi ketiadaan stok bahan baku (butuh 100 unit, stok 10 unit), blokir Preview/Save, tidak ada data invalid tersimpan | `776r` | `[x]` | Dieksekusi | Kosong |
| TC-03 | Exception: edit permohonan sebelum otorisasi (2 unit menjadi 4 unit), alokasi bahan dan biaya dihitung ulang proporsional | `776re` | `[-]` | Parsial | Kosong |
| TC-04 | Exception: penolakan permohonan oleh Supervisor, transaksi digugurkan, tidak ada mutasi stok maupun jurnal | `776rrj` | `[ ]` | Belum | Kosong |
| TC-05 | Rollback: pembatalan atau revert pada tahap Step 2, jurnal WIP dibatalkan, tanpa saldo mengambang | `doRevert` atau Cancel | `[ ]` | Belum | Kosong |
| TC-06 (matriks) | Post-audit: verifikasi mutasi kartu stok FIFO bahan baku dan barang jadi | Kartu stok gudang | `[ ]` pada audit 4.1 | Belum | Kosong |
| TC-07 (matriks) | Post-audit: verifikasi jurnal umum akuntansi dan rekening pembantu | Buku jurnal (GL) | `[ ]` pada audit 4.2 | Belum | Kosong |
| TC-08 (matriks) | Output: cetak SPK, nota produksi final, dan QR barcode | `776r.html`, `776.html`, `print_barcode_produksi` | `[ ]` pada audit 4.3 | Belum | Kosong |
| TC-06 (seksi 3) | Proteksi pergantian produk rakitan dan pembersihan residu sesi: dialog konfirmasi ganti atau batal, tanpa ghost `costNilai_4`, total `harga_biaya` dan `subtotal` akurat | `/produksi/Create/index/776` | `[ ]` | Belum | Kosong |

Detail ekspektasi kunci TC-01 yang wajib diverifikasi saat audit:

- Step 2 (`776a`): engine FIFO `FifoAverageSuppliesAssembly` pada `coTransaksiCore.php#L82` memotong persediaan supplies aktif; jurnal WIP Debet `1010030050` (Persediaan Supplies Proses) dan Kredit `1010030010` (Persediaan Supplies).
- Step 3 (`776`): Debet akun Persediaan Barang Jadi sebesar Total HPP (Bahan plus Biaya BOM), Kredit `1010030050` untuk menutup Supplies Proses, serta Kredit Biaya Tenaga Kerja atau Overhead Pabrik sesuai COA; total Debet sama dengan Kredit dengan selisih Rp 0.
- Audit 4.1: saldo kartu stok bahan baku berkurang persis sebesar Qty Rakit dikali Konsumsi BOM per unit dan nomor referensi dokumen pengeluaran mengacu pada nomor transaksi produksi; kartu stok barang jadi bertambah sebesar kuantitas jadi dengan lokasi gudang penampung sesuai cabang atau gudang terpilih.
- Audit 4.3: SPK tercetak rapi pada A4/F4 dengan komponen bahan baku terbaca jelas; nota final memuat nomor bukti, tanda tangan atau nama otorisator, dan ringkasan kuantitas; barcode hasil scan sesuai ID atau kode unik produksi.

### 5.2. UAT Varian Fase 1 - Matriks Uji per Modul

Basis: SQL fase-2 bridge sudah dijalankan dengan postcheck `missing_total=0`, patch fase-1 terpasang di holding dan subsidiary, dummy data ber-marker `[UATV3_...]`. Seluruh 24 butuan berikut belum dieksekusi.

| Modul | No | Butuan Uji | Status |
|---|---|---|---|
| Pembelian | 1 | Selector produk non-varian, save, followup, print, berhasil | Belum |
| Pembelian | 2 | Selector varian via picker, multi-line produk sama beda varian, qty tersimpan per varian | Belum |
| Pembelian | 3 | Cart: ubah qty dan harga, reload cart, nilai tetap benar | Belum |
| Pembelian | 4 | Radio PPN default sesuai session, toggle PPN dan non-PPN memengaruhi summary dengan benar | Belum |
| Pembelian | 5 | Produk varian dengan harga lock: input harga terkunci, pesan alasan lock tampil jelas | Belum |
| Pembelian | 6 | Produk non-varian tetap bisa input harga sesuai policy existing | Belum |
| Pembelian | 7 | Jalur CLI Auto PO: payload CRM varian normal menghasilkan PO sukses; payload CRM legacy non-varian untuk produk yang kini varian ditahan atau staging | Belum |
| Pembelian | 8 | `pembelian_transaksi_bridge` dan `pembelian_transaksi_bridge_terima` menyimpan `variant_*` dan `cart_key` | Belum |
| Distribusi | 1 | Create distribusi non-varian, save, followup, approve, print sukses | Belum |
| Distribusi | 2 | Create distribusi varian multi-line untuk produk sama beda varian | Belum |
| Distribusi | 3 | Preview sebelum approve: qty tidak nol palsu, uom sesuai data, subtotal sesuai detail | Belum |
| Distribusi | 4 | Endpoint pending, ongoing, dan history (`Transaksi/viewUndoneItemsIndex`, `History/showData`, `Transaksi/viewKepoinItems`) menampilkan line varian lengkap, bukan satu baris | Belum |
| Penjualan | 1 | Create penjualan non-varian, save, followup, approve, print sukses | Belum |
| Penjualan | 2 | Create penjualan varian multi-line, preview dan followup tidak collapse | Belum |
| Penjualan | 3 | Preview popup: qty benar, subtotal benar, UoM benar atau fallback sesuai rule | Belum |
| Penjualan | 4 | `doFollowup` tidak false-positive "sudah diotorisasi" saat data valid | Belum |
| Penjualan | 5 | Printing receipt dan resume: tidak SQL error 1064, tidak notice undefined property, data nota tidak kosong | Belum |
| API Holding-Subsidiary | 1 | Holding API `api_getPackingList_get` mengembalikan `variant_id`, `variant_sku`, `variant_label`, `variant_key`, dan `cart_key` | Belum |
| API Holding-Subsidiary | 2 | Subsidiary menerima payload varian dan menulis detail bridge tanpa merge salah | Belum |
| API Holding-Subsidiary | 3 | Dedupe line item berbasis kombinasi aman `produk_id + variant_id + cart_key` | Belum |
| Validasi DB dan Audit | 1 | Tabel detail transaksi menyimpan `variant_*` dan `cart_key` sesuai line item | Belum |
| Validasi DB dan Audit | 2 | Stok locker dan mutasi varian konsisten dengan qty transaksi | Belum |
| Validasi DB dan Audit | 3 | Rekening pembantu varian dan FIFO varian konsisten dengan nilai transaksi | Belum |
| Validasi DB dan Audit | 4 | Tidak ada record half-written pada proses yang gagal | Belum |

### 5.3. UAT Quick Check Fase 1 - Status per Langkah

Basis: mode harga `GLOBAL`, guard aktivasi varian aktif, migration kontrak varian dan `variant_price_mode` sudah dijalankan. Sepuluh langkah berikut belum dieksekusi. Evidence minimum per langkah: URL transaksi, nomor dokumen, screenshot, hasil query smoke-check, status akhir.

| No | Langkah Uji | Status |
|---|---|---|
| 1 | Master non-varian: create, edit, save, lalu pastikan tetap bisa dipilih di transaksi | Belum |
| 2 | Master varian: create atribut, generate varian, save, lalu pastikan status varian aktif tersimpan | Belum |
| 3 | Pembelian non-varian: buat PO, simpan, cek preview dan invoice | Belum |
| 4 | Pembelian varian mode `GLOBAL`: pilih parent, isi qty per varian di picker, simpan PO | Belum |
| 5 | GRN varian dari PO: follow-up step 3 pada modul pembelian, pastikan qty per varian terbawa | Belum |
| 6 | Penjualan non-varian: transaksi normal, simpan, cetak invoice | Belum |
| 7 | Penjualan varian mode `GLOBAL`: pilih parent, isi qty per varian, simpan, cek invoice | Belum |
| 8 | Guard open-doc legacy: coba aktifkan varian pada produk yang masih punya dokumen legacy terbuka, harus ditolak | Belum |
| 9 | Guard parent-stock legacy: coba aktifkan varian pada produk dengan stok parent legacy belum selesai cutover, harus ditolak | Belum |
| 10 | Validasi stok varian: setelah GRN dan jual, cek mutasi stok bergerak pada variant yang benar | Belum |

Skrip smoke-check: `docs/sql/20260409_phase1_uat_smoke.sql`.

### 5.4. UAT Quick Check Fase 2 (Variant Identity) - Status per Skenario

Basis: tabel `stock_locker_varian`, `stock_locker_mutasi_varian`, dan `rek_cache_persediaan_produk_varian_fifo` tersedia; produk uji punya minimal dua varian aktif pada parent yang sama; saldo stok varian sudah ada. Lima skenario berikut belum dieksekusi.

| No | Skenario | Ekspektasi | Status |
|---|---|---|---|
| 1 | Followup penjualan multi-varian parent sama: dua baris varian berbeda pada parent yang sama | Tiap baris varian tetap terpisah, tidak merge atau overwrite | Belum |
| 2 | Push ke pre-purchase saat stok sebagian kurang: varian A cukup, varian B kurang | `pushToRequestPO` hanya terisi untuk varian yang kurang | Belum |
| 3 | Reset shopping cart pada pembelian dan penjualan | Saldo `hold` kembali ke `active` pada identity varian yang benar | Belum |
| 4 | Jalur non-varian: ulang skenario 1 sampai 3 untuk item non-varian | Flow lama tetap berjalan normal, tidak regress | Belum |
| 5 | Selector dan cart `requeststok`: parent membuka variant picker, isi qty per varian, edit dan hapus item varian | Tiap varian tetap baris terpisah; aksi edit atau hapus tidak memengaruhi varian lain pada parent yang sama | Belum |

Skrip smoke-check: `docs/sql/20260409_phase2_uat_smoke.sql`.

### 5.5. UAT Rekening Pembantu Varian (Fase 2 Accounting) - Status per Skenario

Basis: tabel `_rek_pembantu_produk_varian_cache` dan `_rek_pembantu_produk_varian` tersedia; kontrak data varian transaksi aktif; sudah ada minimal satu transaksi varian. Parameter skrip yang harus diisi: `@TRX_ID`, `@PRODUK_ID`, `@VARIANT_ID`, `@REKENING`. Skrip: `docs/sql/20260412_rekening_varian_uat_smoke.sql`.

| No | Skenario | Kriteria Lulus | Status |
|---|---|---|---|
| 1 | Pembelian varian sampai GRN; simpan nomor dokumen dan `transaksi_id` | Mutasi di `_rek_pembantu_produk_varian` dengan pasangan `extern2_id=produk_id master` dan `extern_id=variant_id`; mutasi di `_rek_pembantu_produk` untuk `extern_id=produk_id master` sehingga rollup tetap hidup | Belum |
| 2 | Penjualan varian tersimpan; simpan nomor dokumen dan `transaksi_id` | Idem, dengan net qty dan net nilai sesuai arah transaksi | Belum |
| 3 | Kontrol non-varian: satu transaksi non-varian | Tidak ada posting ke tabel rekening pembantu varian dan tidak ada mutasi noise dengan `extern_id=0` atau `variant_id` kosong | Belum |

---

## 6. UAT Point-to-Point Trace CRM ke Subsidiary ke Holding

Basis: template CSV `application/UAT_POINT_TO_POINT_TRACE_TEMPLATE.csv`. Prinsip: gunakan token yang sama dari awal sampai akhir, yaitu `estimate_id`, `referensi_id`, `bridge_id`, `so_nomer`, `po_nomer`, `holding_so_nomer`, serta `variant_id` dan `cart_key`. Aturan kerja: pilih satu transaksi uji tanpa mencampur transaksi lain, isi token di worksheet trace, jalankan step berurutan, setiap step harus lulus sebelum lanjut, dan jika gagal catat di kolom Putus di titik.

| Titik | Trigger | Expected | Verifikasi | Putus di Titik | Status |
|---|---|---|---|---|---|
| P00 | CRM approve estimate | Data order bridge CRM terbentuk untuk `estimate_id` dengan item count lebih besar dari 0 | Cek tabel bridge order di CRM untuk `estimate_id` | Tidak ada row bridge: masalah di generator order CRM | Belum |
| P01 | Setelah P00 sukses, webhook CRM menuju Subsidiary atau Holding | Endpoint target menerima payload `estimate_id` dan `referensi_id` | Cek log API receiver dan response HTTP 2xx | HTTP bukan 2xx atau timeout: masalah jaringan, auth, endpoint, atau payload mandatory kurang | Belum |
| P02 | Endpoint `receive_order` hit (bridge intake Subsidiary) | Tabel `penjualan_transaksi_data_crm_bridge` berisi master dan detail item untuk `estimate_id` atau `referensi_id` | SQL: `SELECT id, estimate_id, referensi_id, status, trash FROM penjualan_transaksi_data_crm_bridge WHERE estimate_id = ? OR referensi_id = ? ORDER BY id DESC` | Row tidak terbentuk: intake API tidak commit atau gagal validasi | Belum |
| P03 | Buka `Create/previewCrm/{user}/{estimate_id}` | Item tampil sesuai bridge, status customer dan pengiriman terbaca | UI tabel item dan ringkasan total muncul | UI kosong padahal P02 ada data: mapping query atau view preview bermasalah | Belum |
| P04 | Klik picker varian bila item perlu varian | Total qty split varian sama dengan qty item CRM; `variant_id` dan `cart_key` tersimpan | SQL: `SELECT id, estimate_id, produk_id, qty, variant_id, cart_key FROM penjualan_transaksi_data_crm_bridge WHERE estimate_id = ? ORDER BY id ASC` | Qty split tidak balance atau varian tidak tersimpan: masalah validator save split varian | Belum |
| P05 | Klik To Shopping Cart | Session cart terbentuk, `pihakMainExec` dan `cabang_pengiriman` terset | Cek halaman cart: item masuk benar, qty, uom, dan harga benar | Swal "Harap pilih cabang pengiriman" padahal sudah dipilih: mapping session pengiriman tidak terset | Belum |
| P06 | Save transaksi penjualan | Header dan detail transaksi terbentuk serta trace ke referensi bridge | SQL: `SELECT id, nomer, referensi_id, status, trash FROM penjualan_transaksi WHERE nomer = ? OR referensi_id = ? ORDER BY id DESC` | Save gagal karena auth, locker, atau stock: cek processor chain dan data otorisasi session | Belum |
| P07 | Save atau followup untuk tujuan `SAN` | Row bridge master dan detail terbentuk siap diproses CLI | SQL: `SELECT id, referensi_id, referensi_pengiriman, cli, status FROM penjualan_transaksi_data_bridge_master WHERE referensi_id = ? ORDER BY id DESC` | `referensi_pengiriman=0` atau row tidak ada: auto PO tidak akan jalan | Belum |
| P08 | Jalankan scheduler CLI | Flag `cli` berubah dari 0 menjadi 1 bila publish sukses | SQL: `SELECT id, referensi_id, cli, status, dtime_auto FROM penjualan_transaksi_data_bridge_master WHERE referensi_id = ? ORDER BY id DESC` | `cli` tetap 0: worker tidak jalan, response API gagal, atau payload ditolak | Belum |
| P09 | Setelah P08 publish sukses | Data masuk tabel bridge holding lalu terbentuk SO holding | Cek tabel bridge holding (`reseler_master_bridge` dan sejenisnya) serta nomor SO holding | Bridge ada tapi SO tidak terbentuk: scheduler holding atau mapping dedicated subsidiari bermasalah | Belum |
| P10 | Setelah SO holding berubah status menjadi processed, approved, atau cancelled | Endpoint callback subsidiary menerima event dan update status bridge | Cek log callback dan status final di tabel bridge subsidiary | Callback orphan atau `referensi_id` tidak ditemukan: mapping token lintas sistem tidak konsisten | Belum |

Rule isolasi root cause: P00-P01 gagal fokus pada CRM dan network webhook; P02-P05 gagal fokus pada Subsidiary intake, preview, session, dan picker varian; P07-P08 gagal fokus pada bridge builder dan scheduler CLI subsidiary; P09 gagal fokus pada scheduler dedicated di holding; P10 gagal fokus pada endpoint callback dan mapping `referensi_id`.

Checklist lulus satu skenario: semua P00 sampai P10 lulus; `variant_id` dan `cart_key` konsisten dari preview, cart, transaksi, sampai bridge; tidak ada SQL error, notice, atau warning di proses utama; data UI preview, DB detail, dan hasil print atau resume konsisten.

---

## 7. Panduan UAT Manual User dan Aturan Pembelajaran

### 7.1. Struktur Panduan Manual User

Target `https://192.168.5.33/new_san_variant/`, tanggal 2026-07-27, sasaran User, Team QA, dan Tim Operasional. Tersedia versi HTML interaktif di `docs/panduan-uat-manual-user.html` dengan centang progress yang tersimpan di LocalStorage. Tiga bagian menyusun panduan ini.

**Bagian 1: Kasus per Kasus Pengujian Bug Issue (enam kasus).**

| Kasus | Bug | Skenario | Ekspektasi Inti | Status |
|---|---|---|---|---|
| 1.1 | Bug 1A | Ghost row `produk_id = 0` di `transaksi_data`: tambah barang bervarian (`ALPEN B28D` Warna Merah ukuran XL) ke cart via `/pembelian/Create/index/466`, lalu simpan | Barang tersimpan dengan ID produk valid; tidak ada baris kosong `produk_id = 0` | Belum |
| 1.2 | Bug 1C | Perubahan harga di cart: ubah Harga Satuan dari Rp 100.000 menjadi Rp 120.000, tekan Enter atau blur | Subtotal item dan total transaksi ter-update presisi mengikuti harga baru | Belum |
| 1.3 | Bug 3C dan 3D | Rilis stok locker login/logout: tambah varian ke cart (state `hold`), logout tanpa menyimpan, login kembali | Tidak ada Error Code 169 atau alert "Stok tidak cukup"; stok rilis dari `hold` ke `active` | Belum |
| 1.4 | Bug 4A dan 4B | Overwrite multi-varian pada cetakan nota: 1 unit Merah-XL dan 1 unit Biru-L dari `ALPEN B28D`, cetak via `/Printing/viewProformaReceipt/...` | Seluruh varian tercetak lengkap, tidak ada baris hilang atau tertindih | Belum |
| 1.5 | Bug 5C | Penutupan transaksi split PRE PO: di `/pembelian/FollowUp/...`, approve PRE PO menjadi PO resmi | PRE PO tertutup dengan `valid_qty = 0` dan langsung hilang dari daftar menggantung; tidak ada transaksi ganda | Belum |
| 1.6 | Bug 5G dan 5H | Modal otorisasi merah `itemStaging` saat approval varian di Follow Up | Tidak muncul pesan "Sistem mendeteksi adanya perubahan pada data..."; tidak ada baris kosong `Produk: Nama (PID: )` | Belum |

**Bagian 2: Step-by-Step Modul Inventory Core (tujuh skenario, seluruhnya `[ ]`).**

- 2.1 Pembelian: buka `/pembelian/Create/index/466`, tambah barang varian, simpan Pre-PO; buka `/pembelian/FollowUp/index/466`, approve Pre-PO menjadi PO resmi; verifikasi barang PO terpotong atau terkunci pada stok locker varian.
- 2.2 Penjualan: buka `/penjualan/Create/index/582`, masukkan dua barang bervarian ke cart SO; simpan SO lalu approve Invoice di `/penjualan/FollowUp/index/582`; verifikasi stok fisik bervarian terpotong dari locker `active`.
- 2.3 Pindah Gudang: buka `/pindahgudang/Create/index/585`, pilih Gudang Asal dan Gudang Tujuan; masukkan barang bervarian lalu submit; buka akun Gudang Tujuan, terima pengiriman varian, verifikasi stok bertambah di gudang tujuan.
- 2.4 Stock Opname: buka `/opname/Opname/viewOpnameAktive`, buat sesi Opname baru; masukkan jumlah fisik bervarian (misal selisih +2 atau -1 unit); finalisasi dan verifikasi stok menyesuaikan hasil fisik.
- 2.5 Konversi: buka `/konversi/Create/index/1334` (modul `konversi` dan `konversi_varian`), masukkan barang bervarian sebagai Bahan Asal dan Hasil Konversi; approve konversi dan verifikasi bahan asal berkurang serta hasil konversi bertambah.
- 2.6 Distribusi (`distribusifg`, `distribusiproduksi`, `distribusisupplies`): buat dokumen distribusi bervarian dari Pusat ke Cabang; approve dan terima di Cabang; verifikasi pergerakan stok transit dan stok akhir cabang.
- 2.7 Produksi (`produksi` dan `produksiproses`): buka `/produksi/Create/index/584`, buat Perintah Produksi untuk produk bervarian; jalankan proses produksi dan selesaikan hasil; verifikasi finished goods bervarian bertambah di gudang FG.

**Bagian 3: Controller di Luar Modul (enam endpoint, seluruhnya `[ ]`).**

- 3.1 Hover QTip `/Addons/ViewDetails`: buka daftar transaksi `/pembelian/Transaksi/index/466`, arahkan kursor ke Nomor Nota Transaksi; QTip muncul cepat dan seluruh varian tampil dengan Badge Biru SKU/Varian, contoh `[B28D-WA1-UK12]`.
- 3.2 Pencarian SKU Katalog `/Katalog/viewProduk`: ketik Kode SKU Varian `B28D-WA1-UK12`; sistem menemukan dan menampilkan produk induk.
- 3.3 Master Data Viewer `/Data/view/Produk`: centang opsi "Memiliki Varian", pilih atribut Warna dan Ukuran, kombinasi varian ter-generate otomatis.
- 3.4 Cetak barcode dan QR `/addons/Qr/doPrint`: tentukan jumlah lembar; stiker menampilkan Label SKU Varian `[SKU-VARIAN]` dan barcode fisik varian.
- 3.5 Spreadsheet harga varian `/Spread/index/produk/cabang/hargaProduk`: matriks harga terbuka tanpa error dan harga jual atau beli per cabang tersimpan presisi.
- 3.6 Buku Besar mutasi FG `/Ledger/viewMovementGroup/fg`: riwayat mutasi masuk dan keluar tercatat presisi per varian.

Lembar ringkasanUAT user memuat tiga baris: Bug Issue Cases 6 kasus, Modul Inventory 7 modul, Non-Module Controller 6 endpoint. Ketiganya masih PASS/FAIL kosong dengan tanggal dan catatan kosong. Blok sign-off berisi Nama Penguji, Jabatan, dan Status Akhir UAT (DISETUJUI atau PERLU PERBAIKAN) yang semuanya kosong.

### 7.2. Aturan Kerja dan Pembelajaran Pasesan (`user_learning_rules.md`)

Prinsip utama: reputasi klien adalah yang utama. Dilarang mengklaim "Sudah Oke" hanya berdasarkan asumsi atau kode yang tampak sekilas benar, karena setiap klaim harus didukung bukti empiris data session, query database, dan pengujian sintaks. Jangan membaca data secara buta: setiap variabel di session dan database harus selalu dimaknai sesuai konteks bisnis dan posisi step-nya, dan peran harus dipahami (Pre-PO, PO Approval, GRN Gudang, Finance).

Perintah "Cek Session": lakukan deep audit dan joint analysis dengan mengekstrak serta membedah isi file session aktif di `C:/xampp/tmp/ci_session*`, lalu evaluasi backward compatibility dan keselarasan konteks posisi step UI dengan data backend.

Perintah "Jalankan CLI Transaksi": wajib langsung menjalankan method `CliTransaksi::run_cliTransaksi()`. Mekanisme eksekusi: jalankan skrip runner CLI via `c:\xampp\php\php.exe "c:\xampp\htdocs\new_san_variant\scratch\run_cli_via_argv.php"`; jika ada `tr_id` spesifik dari transaksi yang sedang diproses pengguna di UI, set parameter `$_GET['tr_id'] = $trId` untuk dry-run atau manual check; laporkan hasil eksekusi sub-komponen (`RekeningPembantuProdukRiil`, `ComJurnal`, `FifoProdukJadiVarian`), durasi eksekusi, dan status pemrosesan di database.

Guardrail integritas varian yang dirinci pada bagian 3.3 berlaku langsung sebagai prosedur pengujian: setiap aturan adalah sesuatu yang harus diuji ketahanannya, bukan sekadar diperiksa di atas kertas. Gate mapping `extern_id`, ghost row prevention, smart extraction cart key, target tabel `stock_locker_variant`, pengisian `jenis_locker`, konfigurasi dual-write, penanganan filter raw SQL di `fetchCriteria()` dan `addData()`, HQ fallback di `cekLoker()`, serta invarian akumulasi stok fisik, seluruhnya adalah kandidat test case yang belum-rise.

Pemisahan arsitektur akuntansi versus stok varian yang harus divalidasi silang saat UAT: Layer 1 akuntansi finishial (`RekeningPembantuProduk` dan `_rek_pembantu_produk_cache`) mengikhtisarkan saldo nilai rupiah dan HPP pada level master produk untuk PSAK 14 dan IFRS; Layer 2 operasional (`stock_locker_variant` dan `rek_cache_persediaan_produk_varian_fifo`) melacak kuantitas fisik dan HPP spesifik per variant ID untuk ISO 9001:2015 klausul 8.5.2 melalui `ComLockerStockDualWrite` dan `FifoProdukJadiVarian`. Pengujian harus membuktikan kedua layer bergerak konsisten, bukan hanya salah satunya.

### 7.3. Referensi Teknis Pendukung

`eform.md` memberi rasional teknis mengapa modul `opname` menolak PDF untuk import stock opname: PDF flat bersifat foto digital yang sulit dipetakan kolomnya (mana kolom Kode Barang dan mana kolom Jumlah Fisik), rawan salah baca karakter (angka 0 dibaca huruf O, angka 1 dibaca huruf l), dan tidak mendukung sinkronisasi real-time. Dokumen ini juga menjelaskan karakteristik sistem pajak yang menerima PDF melalui dua skema, yaitu PDF interaktif berupa Acrobat Form dengan kode tertanam dan fungsi PDF sebagai lampiran bukti pada e-Filing konvensional, serta solusi adopsi PDF interaktif FDF/XFDF via pustaka `pdftk` pada aplikasi PHP mandiri dengan syarat konsistensi nama field dan kebutuhan VPS karena `exec()` butuh akses penuh. Relevansi UAT: `uat-checklist.md` mencatat `opname` `Opname.php` `doUpload()` diperketat hanya menerima `.xlsx` dan `.xls` dengan deteksi MIME untuk menutup risiko Arbitrary File Upload dan Remote Code Execution (ISO 27001 Control A.8.28). Pilihan ini konsisten dengan rasional `eform.md` bagian 1 dan harus diuji sebagai negatif test: upload PDF harus ditolak.

`pedoman_as_is_lock.md` mendefinisikan mode AS-IS LOCK untuk konversi HTML ke PDF: terapkan persis 1:1, jangan optimasi, refactor, atau normalisasi, dan jika ada perbedaan sekecil apa pun maka STOP dan tanya dulu; output berupa blok final verbatim dan diff baris yang berubah. Prosedur ini harus dipatuhi saat memverifikasi output cetak (misalnya template `776r.html` dan `776.html` serta label SKU varian pada barcode) agar pengujian tidak memasked regresi tampilan.

---

## 8. Temuan Lintas-Dokumen dan Kontradiksi

### K-01. Verdict PASS/FAIL nol di seluruh korpus

Hanya dua dokumen yang punya field verdict eksplisit, yaitu `UAT_CHECKLIST_PRODUKSI_776.md` (delapan baris tabel bagian 5) dan `panduan-uat-manual-user.md` (tiga baris tabel ringkasan), dan semuanya kosong. Dokumen quick check fase 1, fase 2, dan rekening varian tidak punya field status sama sekali, hanya kriteria lulus naratif. Matriks varian fase 1 juga tanpa kolom status. Kesimpulan: belum ada bukti UAT yang sah. Yang lebih mutakhir adalah `uat-checklist.md` (Agustus 2026) yang menunjukkan remediasi kode masih berjalan pada 2026-08-04, sementara UAT yang belum diverifikasi/upload, sehingga risiko kebocoran tabel tinggi.

### K-02. Penyebutan jumlah kasus tidak konsisten

`panduan-uat-manual-user.md` menyebut "22 Bug Cases" di pengantar, dan checklist global yang dirujuk di `uat-checklist.md` juga menyebut "22 bug cases", padahal Bagian 1 hanya memuat enam kasus bernomor 1.1 sampai 1.6. Klaim "10 Modul Inventory Core" di judul Bagian 2, tetapi skenario yang dienumerate berjumlah tujuh (2.1 sampai 2.7) yang secara tidak langsung menutupi lebih dari sepuluh nama modul. Klaim "Semua P00..P10 lulus" pada checklist trace merujuk sepuluh titik, padahal definisinya P00 sampai P10 adalah sebelas titik. Verifikasi: angka turunan yang tidak dikoreksi. Yang perlu dipakai sebagai acuan adalah hitungan aktual per dokumen, yaitu enam kasus bug, tujuh skenario modul, enam endpoint, sebelas titik trace, karena dapat diverifikasi langsung dari isi.

### K-03. Istilah tabel stok varian tidak konsisten: `stock_locker_varian` versus `stock_locker_variant`

`phase1-uat-quick-check.md` dan `phase2-uat-quick-check.md` memakai `stock_locker_varian` dengan huruf v pada kata varian. Semua dokumen lain memakai `stock_locker_variant`: `user_learning_rules.md` bagian 4A, `uat-checklist.md` pada auto-sync 1.480 baris sentinel di tabel `stock_locker_variant`, dan `UAT_CHECKLIST_VARIAN_FASE1.md`. Yang lebih mutakhir dan otoritatif adalah `user_learning_rules.md` yang secara eksplisit menyatakan `MdlLockerStockVariant::$tableName` WAJIB ALWAYS bernilai `stock_locker_variant`. Konsekuensi: nama tabel pada quick check fase 1 dan fase 2 kemungkinan salah ketik, dan query smoke-check-nya perlu diverifikasi ulang terhadap skema DB aktual.

### K-04. Kode transaksi produksi ambigu antara 584 dan 776

`panduan-uat-manual-user.md` skenario 2.7 menyebut produksi memakai `/produksi/Create/index/584` dengan kode 584, sedangkan `UAT_CHECKLIST_PRODUKSI_776.md` menyatakan assembling adalah `/produksi/Create/index/776` dengan kode 776. Ini kemungkinan bukan kontradiksi melainkan dua jalur berbeda dalam modul yang sama, yaitu produksi reguler 584 dan product assembling 776; `uat-checklist.md` memang menyebut `doFollowup_776()` sebagai metode terpisah di `produksiproses`. Namun korpus tidak pernah menyatakan pemisahan ini secara eksplisit, sehingga ada risiko tumpang tindih cakupan pengujian produksi antara kedua dokumen. Yang lebih mutakhir adalah `UAT_CHECKLIST_PRODUKSI_776.md` (rilis 30 September 2026) yang memfokuskan 776, sedangkan dokumen manual (27 Juli 2026) menyebut 584 sebagai jalur produksi umum.

### K-05. Environment dan basis waktu berbeda antar dokumen

- `panduan-uat-manual-user.md`: URL `https://192.168.5.33/new_san_variant/`, tanggal 2026-07-27.
- `uat-checklist.md`: database `192.168.5.10`, update 2026-07-27 sampai 2026-08-04.
- `UAT_CHECKLIST_PRODUKSI_776.md`: branch `z:/san_27sep/`, environment Staging/Development, rilis 30 September 2026.
- Quick check dan varian fase 1: berbasis skrip April 2026 (`20260409`, `20260412`), tanpa environment eksplisit.

Empat basis waktu dan environment berbeda tanpa peta pengujian yang menunjukkan mana yang paling mutakhir. `uat-checklist.md` (Agustus 2026) adalah yang paling mutakhir untuk status kode; `UAT_CHECKLIST_PRODUKSI_776.md` (September 2026) paling mutakhir untuk skenario 776; quick check varian (April 2026) paling lama dan berisiko basi terhadap remediasi Agustus.

### K-06. Angka cakupan modul tidak konsisten

Bagian "Audit Dual-Write Stock Locker" di `uat-checklist.md` mengklaim "verified across all 10 inventory modules" lalu mencantumkan dua belas nama: pembelian, penjualan, konversi, pindahgudang, opname, distribusifg, distribusiproduksi, distribusisupplies, produksi, produksiproses, adjustment, dan pembatalan. Sementara itu `panduan-uat-manual-user.md` menyebut "10 modul inventory" padahal skenarionya tujuh. Scope yang disebut di `UAT_CHECKLIST_VARIAN_FASE1.md` hanya lima (pembelian, distribusi, penjualan, API bridge, printing). Cakupan modul lintas dokumen perlu diseragamkan sebelum UAT berikutnya.

### K-07. Trace P00-P10 disebut "10 titik" padahal berisi 11

`UAT_POINT_TO_POINT_TRACE.md` mendefinisikan P00 sampai P10, yaitu sebelas titik (P00, P01, P02, P03, P04, P05, P06, P07, P08, P09, P10). Angka sepuluh yang muncul pada beberapa rujukan adalah penghitungan yang salah. Verifikasi langsung isi dokumen (sebelas titik) lebih dapat diandalkan.

### K-08. Dua tabel bridge dengan fungsi berbeda belum dipetakan

P02 memverifikasi tabel `penjualan_transaksi_data_crm_bridge` untuk bridge intake CRM di Subsidiary, sedangkan P07 memverifikasi tabel `penjualan_transaksi_data_bridge_master` untuk bridge Subsidiary menuju auto PO ke Holding. Keduanya memang dua tabel berbeda dengan fungsi berbeda dan bukan kontradiksi, namun tidak ada satu dokumen pun yang memetakan relasi kedua tabel tersebut secara eksplisit, sehingga pembaca baru mudah salah menafsirkan.

### K-09. Strategi PDF stock opname: `eform.md` versus keputusan implementasi

`eform.md` membahas kemungkinan mengadopsi PDF interaktif (FDF/XFDF) untuk import stock opname. Namun keputusan implementasi yang tercatat di `uat-checklist.md` (modul `opname`, 2026-08-04) adalah memperketat `doUpload()` agar hanya menerima `.xlsx` dan `.xls`. Ini bukan kontradiksi, karena `eform.md` menyatakan solusi PDF adalah opsi yang sangat bisa diadopsi dan bukan kewajiban, tetapi harus dipastikan sebagai negatif test: upload PDF harus ditolak.

### K-10. Istilah "Fase 1" dan "Fase 2" dipakai untuk dua campaign berbeda

`UAT_CHECKLIST_VARIAN_FASE1.md` adalah fase 1 varian dengan cakupan bridge dan purchase-to-sale, sedangkan `phase1-uat-quick-check.md` adalah fase 1 varian dengan cakupan master, PO, GRN, dan guard legacy; keduanya kemungkinan fase 1 yang sama dilihat dari sudut berbeda. `phase2-uat-quick-check.md` adalah fase 2 variant identity di followup, locker, dan cache, sedangkan `phase2-uat-rekening-varian-check.md` adalah fase 2 accounting. Jadi Fase 1 dan Fase 2 masing-masing dipecah menjadi dua dokumen dengan sudut pandang berbeda (quick check versus matriks, identity versus accounting). Substansinya konsisten tetapi penamaannya membingungkan, dan kedua sumber kebenaran untuk fase 1 (`UAT_CHECKLIST_VARIAN_FASE1.md` yang merujuk trace, serta `phase1-uat-quick-check.md` yang merujuk `phase1_uat_smoke.sql`) tidak saling menunjuk.

### K-11. Skrip SQL referensi tidak ada dalam korpus

Seluruh quick check dan dokumen rekening varian merujuk skrip `docs/sql/20260409_phase1_uat_smoke.sql`, `docs/sql/20260409_phase2_uat_smoke.sql`, `docs/sql/20260412_rekening_varian_uat_smoke.sql`, serta `docs/sql/004_seed_stock_locker_variant_default.sql` dan `005_cutover_stock_migration.sql`. Tidak ada satu pun skrip yang terdapat dalam 12 dokumen korpus ini. Karena evidence minimum bergantung pada hasil query skrip tersebut, ketersediaan skrip adalah prasyarat mutlak; jika hilang, evidence quick check mustahil dipenuhi.

### K-12. `uat-checklist.md` adalah change log, bukan UAT checklist

Penamaan `uat-checklist.md` menyiratkan lembar UAT, padahal isinya murni log perubahan kode berupa 12 blok update Agent 5 dan Agent 7 pada Juli dan Agustus 2026. Justru dokumen inilah yang paling kaya akan bahan regresi. Solusi: ganti nama atau beri label tegas sebagai Change Log atau Baseline Remediasi (bukan lembar UAT) agar pembaca tidak salah menduga. Sebaliknya, dokumen `spec-driven-testing.md`, `user_learning_rules.md`, `pedoman_as_is_lock.md`, dan `eform.md` bukan UAT checklist meski track UAT menyiratkan semuanya adalah satu campaign, sehingga harus dipisahkan secara klasifikasi menjadi test plan, governance, dan reference.

### K-13. Cross-reference Playwright yang hilang

`spec-driven-testing.md` merujuk empat dokumen yang tidak ada dalam korpus, yaitu `playwright-tests.md`, `test-generation.md`, `request-mocking.md`, dan `session-management.md`. Tanpa berkas-berkas ini, alur plan-generate-heal tidak dapat dieksekusi utuh oleh penguji baru.

### K-14. Risiko kontaminasi dummy data bila cleanup tidak dijalankan

`UAT_CHECKLIST_VARIAN_FASE1.md` mewajibkan cleanup `99_cleanup_uat_dummy.sql` setelah UAT selesai, dengan marker `description` diawali `[UATV3_...]` dan nomor transaksi `UATV3.<tag>.`. Tidak ada dokumen lain yang menyatakan kapan UAT dianggap selesai sehingga cleanup wajib dieksekusi. Risiko: data dummy varian mencemari hasil audit stok dan rekening pembantu di environment yang sama dengan data uji lain, dengan konsekuensi langsung bagi integritas PSAK 14 yang menjadi tujuan UAT.

### K-15. Klaim "PHP Syntax OK" pada `uat-checklist.md` bukan bukti UAT

Hampir setiap item log mengklaim "PHP Syntax: OK" atau "Syntax: OK (N/N files verified)". Ini adalah verifikasi sintaks, bukan UAT fungsional. Klaim ini boleh menjadi prasyarat tetapi tidak boleh dihitung sebagai bukti UAT. Justru di sini terlihat pola yang harus dihindari: kode yang dianggap sudah benar disimpulkan dari lint dan sintaks saja, persis yang dilarang oleh `user_learning_rules.md` bagian 1.

### K-16. Judul TC-06 bentrok antara matriks, seksi how-to, dan tabel sign-off

`UAT_CHECKLIST_PRODUKSI_776.md` mendefinisikan TC-06 pada matriks skenario sebagai "Verifikasi Mutasi Kartu Stok (FIFO Bahan dan Barang Jadi)", tetapi seksi how-to bagian 3 memakai heading TC-06 untuk "Proteksi Pergantian Produk Rakitan dan Pembersihan Residu Sesi" yang tidak ada di matriks, sedangkan tabel sign-off bagian 5 memetakan TC-06 kembali ke "Audit Mutasi Stok Fisik FIFO" dan TC-07 ke "Audit Jurnal dan Keseimbangan Debet/Kredit" serta TC-08 ke "Audit Cetak Nota dan Scan QR Barcode". Akibatnya ada dua skenario berbeda yang sama-sama memakai label TC-06, dan skenario proteksi pergantian produk rakitan tidak memiliki baris sign-off sendiri. Rekomendasi:givnomor ulang skenario proteksi pergantian menjadi TC-09 atau dipindahkan ke seksi audit 4.

---

## 9. Lampiran: Daftar File Sumber

| Nama File | Ukuran (bytes) | Topik H1 | Peran |
|---|---|---|---|
| `uat-checklist.md` | 48308 | Tanpa H1;<H2> bertanggal "Update 2026-08-04 - Agent 7 ..." sampai "Update 2026-07-27 - Task 2: Multi-Variant BOM Produksi" | Change log remediasi kode lintas 14 modul ditambah Katalog dan ViewDetails; bahan baseline regresi, bukan lembar UAT; satu-satunya sumber evidence environment database `192.168.5.10` |
| `UAT_CHECKLIST_PRODUKSI_776.md` | 12157 | "CHECKLIST LENGKAP USER ACCEPTANCE TESTING (UAT)" dengan subjudul "MODUL PRODUKSI 776 (PRODUCT ASSEMBLING / PERAKITAN PRODUK)" | Test plan plus lembar hasil plus sign-off UAT produksi 776; satu-satunya dokumen dengan eksekusi checkbox dan delapan kasus TC; branch `z:/san_27sep/`, rilis 30 September 2026 |
| `panduan-uat-manual-user.md` | 9959 | "Panduan & Checklist Manual UAT User (Pengujian Varian ERP)" | Test plan lapangan manual varian: enam kasus bug, tujuh skenario modul, enam endpoint non-modul; URL `https://192.168.5.33/new_san_variant/`; tanggal 2026-07-27 |
| `UAT_POINT_TO_POINT_TRACE.md` | 6227 | "UAT Point-to-Point Trace - CRM -> Subsidiary -> Holding" | Matriks trace sebelas titik P00-P10 dengan query SQL per titik, rule isolasi root cause, dan template CSV; metodologi deteksi titik putus |
| `UAT_CHECKLIST_VARIAN_FASE1.md` | 4104 | "UAT Checklist Produk Varian - Fase 1" | Matriks uji varian fase 1 lintas pembelian, distribusi, penjualan, API, dan DB (24 butuan); prosedur dummy data UAT ber-marker `[UATV3_...]` dan prasyarat `missing_total=0` |
| `phase1-uat-quick-check.md` | 1959 | "Fase 1 UAT Quick Check" | UAT cepat fase 1 varian: sepuluh langkah berurutan, evidence minimum, dan kriteria PASS; skrip `20260409_phase1_uat_smoke.sql` |
| `phase2-uat-quick-check.md` | 2436 | "Fase 2 UAT Quick Check" | UAT cepat fase 2 variant identity di followup, locker, dan cache: lima skenario plus kriteria lulus dan skrip `20260409_phase2_uat_smoke.sql` |
| `phase2-uat-rekening-varian-check.md` | 2023 | "Fase 2 UAT Rekening Pembantu Varian" | UAT posting accounting item varian di pembelian dan penjualan: tiga skenario plus parameter skrip `@TRX_ID`, `@PRODUK_ID`, `@VARIANT_ID`, `@REKENING`; skrip `20260412_rekening_varian_uat_smoke.sql` |
| `spec-driven-testing.md` | 11578 | "Spec-driven testing (plan -> generate -> heal)" | Metodologi otomatisasi UAT Playwright: alur plan, generate, heal; seed test; struktur spec; aturan perbaikan dan rekonsiliasi spec (bukan test case) |
| `user_learning_rules.md` | 7879 | "Aturan Kerja & Pembelajaran Pasangan (User Learning Protocol)" | Governance penguji: protokol audit 4-lapis, guardrail integritas varian dan dual-write, perintah Cek Session dan Jalankan CLI Transaksi, pemisahan akuntansi versus stok varian |
| `pedoman_as_is_lock.md` | 302 | Tanpa H1; baris pertama "MODE: AS-IS LOCK (HTML -> PDF)" | Prosedur konversi HTML ke PDF secara 1:1 tanpa refactor, output verbatim plus diff; prosedur kedisiplinan saat verifikasi output cetak |
| `eform.md` | 4064 | "Rangkuman Diskusi: Implementasi PDF dalam Sistem Stok Opname vs Pajak" | Reference teknis: rasional penolakan PDF untuk stock opname, karakteristik e-Form DJP, solusi PDF interaktif FDF/XFDF via `pdftk` |

Catatan kelengkapan: seluruh 12 file yang terdaftar pada job `san-uat` telah dibaca dan dipetakan di atas, dan tidak ada file yang tercantum pada job namun terlewat. Dokumen yang dirujuk di dalam korpus tetapi tidak tersedia dalam job ini, yaitu skrip SQL smoke-check, paket dummy UAT, template CSV trace, screenshot evidence, dan empat dokumen cross-reference Playwright, tercatat sebagai gap pada temuan K-11 dan K-13.
