Template Dokumentasi Blackbox — WAJIB DIIKUTI PERSIS

Salin blok di bawah untuk tiap fitur menjadi docs/blackbox-testing/report/{domain}-{fitur}.md.
Jangan ubah urutan/judul bagian — keseragaman antar-dokumen adalah syarat.
Gaya bahasa: Indonesia natural, hindari glyph "AI" (em-dash, panah, ≠, dsb) di teks yang bisa dibaca user.

Blackbox Testing — {Nama Fitur} ({DOMAIN})

Domain: PT | PP | Apostille & Legalisasi
Fitur: {mis. Pendirian PT}
Role/aktor: {mis. notaris (input), verifikator_pt (verifikasi)}
Tanggal uji: {YYYY-MM-DD}
Penguji (sesi): {Supervisor X}
Build/commit: {git short sha}

1. Ringkasan fitur

Deskripsi singkat 3-5 kalimat: apa yang dilakukan fitur ini, siapa penggunanya, hasil akhir yang diharapkan.

2. Full workflow

2.1 Diagram state

stateDiagram-v2 [*] --> CREATED CREATED --> EXTRACTING EXTRACTING --> READY READY --> COMPLETED COMPLETED --> [*]

(Sesuaikan state nyata: sertakan AWAITING_CLASSIFICATION / AWAITING_COMPANY_SELECTION / IN_VERIFICATION bila relevan.)

2.2 Sequence (aktor - sistem)

sequenceDiagram actor U as User (role) participant FE as Frontend participant BE as Backend participant OCR as OCR/LLM U->>FE: Unggah dokumen FE->>BE: POST /api/... BE->>OCR: proses (async) BE-->>FE: status polling U->>FE: Tinjau & finalisasi

2.3 Peta route & UI

Langkah	Route	Komponen	Elemen interaktif utama	Selector
Unggah	`/klasifikasi`	KlasifikasiPage	dropzone, tombol Lanjut	`tambah-dokumen-input`
...	...	...	...	...

3. Prasyarat & data uji

ID data	Tipe	Berkas	Deskripsi	Ekspektasi sistem
D-POS-01	Positive	`akta-pendirian-valid.pdf`	Semua field lengkap & konsisten	Lolos ekstraksi, gate finalisasi terbuka
D-NEG-01	Negative	`akta-expired.pdf`	Tanggal akta kedaluwarsa	Validasi FAIL, finalisasi terblokir
D-NEG-02	Negative	`ktp-nik-mismatch.pdf`	NIK tidak cocok roster	Match gagal, banner peringatan

4. Matriks skenario uji

ID	Tipe	Lapisan	Langkah ringkas	Ekspektasi	Hasil aktual	Status	Bukti
TC-01	Positive	UI+API	Upload D-POS-01 -> tinjau -> finalisasi	Selesai, status COMPLETED	...	PASS/FAIL	`artifacts/tc-01/*.png`
TC-02	Negative	API	Upload D-NEG-01	Validasi FAIL "akta kedaluwarsa"	...	PASS/FAIL	...
TC-03	Negative	UI	Finalisasi saat field belum dikonfirmasi	Tombol Finalisasi disabled	...	PASS/FAIL	...

Sertakan positive & negative selengkap mungkin: happy path, tiap aturan validasi, boundary (dokumen kurang, format salah, duplikasi, field kosong, mismatch lintas-dokumen), dan interaksi UI (navigasi, disabled state, banner).

5. Cakupan UI (semua yang diakses user)

Route/Elemen	Diuji?	Perilaku benar?	Catatan
`/klasifikasi` upload	Ya	Ya	-
Papan klasifikasi drag-drop	Ya	Ya	-
Tombol Finalisasi (gate)	Ya	Ya	-
Panel verifikator (Setujui/Tolak/Revisi)	Ya	-	-

Tujuan: memastikan tidak ada UI yang bisa diakses user yang terlewat.

6. Temuan bug & perbaikan

ID bug	Severity	Ringkas	Reproduksi	Ekspektasi	Aktual	Screenshot	Rekomendasi perbaikan
BUG-01	High/Med/Low	...	1..2..3	...	...	`artifacts/bug-01.png`	...

Severity: High = blokir alur/kehilangan data/salah hasil; Med = salah perilaku tapi ada workaround; Low = kosmetik/teks.

7. Ringkasan & rekomendasi

Total skenario: {n} (PASS {x} / FAIL {y})
Cakupan UI: {routes diuji}/{total}
Bug: High {a}, Med {b}, Low {c}
Rekomendasi prioritas: ...
Gap/keterbatasan (mis. data tidak tersedia): ...