# 📘 BLUEPRINT PERANCANGAN DAN VALIDASI SISTEM AI
**Kategori:** Framework Pengembangan & Identifikasi Masalah  
**Versi:** 1.0  
**Format:** VS Code Production Ready  

---

## 🎯 PENDAHULUAN & REVIEW FRAMEWORK

Dokumen ini berfungsi sebagai cetak biru (*blueprint*) terstruktur untuk merancang, mengimplementasikan, dan memvalidasi solusi berbasis AI. 

### Catatan Hasil Review Sistem:
*   **Kelayakan:** **Sangat Layak (Nilai 9/10)**. Kerangka kerja ini mengunci risiko halusinasi AI menggunakan kombinasi *Alignment* dan pengujian *Three-Way Matching*.
*   **Rekomendasi Arsitektur:** Dilengkapi dengan jalur *Human-in-the-Loop* (HITL) sebagai katup pengaman jika validasi otomatis AI mendeteksi kegagalan data.

---

## 📅 1. GAMBAR FLOWCHART SISTEM

*Gunakan ekstensi VS Code seperti **Markdown Preview Mermaid Support** untuk melihat visualisasi bagan di bawah ini secara langsung.*

```mermaid
graph TD
    A[Mulai: Dokumen / Data Masuk] --> B[Data Input / Context]
    B --> C[Prompt & AI Processing]
    C --> D[Data Output / Response]
    
    %% Proses Validasi
    B --> E{Three-Way Matching}
    D --> E
    F[(Database Internal)] --> E
    
    %% Keputusan
    E -- Cocok / Valid --> G[Otomatisasi Selesai / Transaksi Sukses]
    E -- Gagal / Anomali --> H[Jalur Human-in-the-Loop]
    
    %% Hasil Akhir
    H --> I[Koreksi Manual oleh Staf]
    I --> J[Feedback untuk Perbaikan Prompt]
```

---

## 📖 2. CERITA PROSES (NARRATIVE)

### 2.1 Kondisi Saat Ini (Current State & Pain Points)
*Ceritakan hambatan operasional, pemborosan waktu, atau potensi kesalahan manusia (human error) sebelum AI diterapkan.*
> **Tulis Narasi Masalah Anda di Sini:** ...

### 2.2 Alur Berjalan Sistem AI (Future State)
1.  **Inisiasi (Input):** Sistem menerima berkas atau data mentah dari pengguna atau sistem eksternal.
2.  **Pemrosesan (Processing):** AI membaca data input, mencocokkannya dengan instruksi (kesepakatan pemahaman), lalu melakukan analisis logis.
3.  **Generasi (Output):** AI mengeluarkan hasil keputusan atau ekstraksi data terstruktur.
4.  **Validasi (3WM):** Sistem melakukan komparasi tiga arah secara otomatis antara Data Input, Database Internal, dan Response AI.
5.  **Penyelesaian:** Jika lolos validasi, transaksi dicatat otomatis. Jika gagal, data dilempar ke dasbor manusia untuk diperiksa.

---

## 💾 3. PEMETAAN DATA (INPUT VS RESPONSE)

Definisi istilah teknis yang digunakan dalam arsitektur data sistem ini:
*   **Data Input:** Data awal, berkas, atau teks yang dimasukkan ke AI (disebut juga *Prompt/Context*).
*   **Data Output (Response):** Hasil keluaran resmi dari sistem AI setelah memproses input.

### Tabel Kamus Data:

| Kategori Data | Nama Variabel / Dokumen | Tipe Data | Keterangan / Batasan |
| :--- | :--- | :--- | :--- |
| **Input** | `source_document` | PDF / File | Dokumen mentah eksternal (misal: Invoice) |
| **Input** | `internal_reference_db` | JSON / Table | Data pembanding di sistem kita (misal: PO) |
| **Response** | `status_verifikasi` | String | Output AI: `VALID` atau `REJECT` |
| **Response** | `catatan_anomali` | Text / String | Alasan spesifik jika status bernilai `REJECT` |

---

## 🤝 4. KESEPAKATAN KESEPEMAHAMAN (AI ALIGNMENT GUIDELINES)

*Bagian ini berisi instruksi sistem (System Prompt) untuk mengunci kecerdasan AI agar bekerja konsisten dan tidak berhalusinasi.*

1.  **Aturan Persona:** Anda adalah sistem AI Auditor Data yang kaku, skeptis, dan berbasis data. Jangan memberikan kalimat basa-basi.
2.  **Aturan Toleransi Angka:** Tidak boleh ada pembulatan mandiri pada angka desimal. Nilai `1500.50` tidak sama dengan `1501`.
3.  **Aturan Penolakan:** Jika ada salah satu kolom wajib (seperti *Transaction ID*) yang kosong atau tidak terbaca pada Data Input, AI wajib langsung mengeluarkan respon `REJECT`.
4.  **Batasan Pengetahuan:** Jangan berasumsi atau menebak data yang tidak tertulis pada konteks input yang diberikan.

---

## 🧪 5. PENGUJIAN "THREE-WAY MATCHING" (3WM)

Metode validasi tingkat tinggi untuk memastikan akurasi kerja AI sebelum data masuk ke sistem inti.

*   **Dokumen A (Sumber Eksternal):** Data hasil ekstraksi AI dari dokumen masuk.
*   **Dokumen B (Sumber Internal):** Data referensi asli yang tersimpan di database internal kita.
*   **Dokumen C (Aturan Bisnis):** Aturan validasi atau limitasi transaksi yang disepakati.

### Matriks Kelulusan Uji 3WM:
*   [ ] Apakah **Nilai Finansial / Jumlah** di Dokumen A == Dokumen B?
*   [ ] Apakah **Identitas Penjual / Pembeli** di Dokumen A == Dokumen B?
*   [ ] Apakah **Spesifikasi Item** sesuai dengan batasan di Dokumen C?

*Sistem dinyatakan lolos jika seluruh indikator di atas berstatus **TRUE/YA**.*

---

## 📑 6. KASUS RIIL & SIMULASI TRANSAKSI

*Catatan: Nomor transaksi awal di sini menggunakan istilah teknis **Transaction ID / Reference Number**. Istilah **Seeds Number** hanya digunakan di internal kode untuk mengunci tingkat keacakan kreativitas AI.*

### Kasus Uji 1: Jalur Sukses (Happy Path)
*   **Transaction ID (Reference Number):** `TX-2026-0001`
*   **Data Input:** Foto Nota (Nomor: INV-777), Nama: Ahmad, Total: Rp150.000.
*   **Data Pembanding Internal:** Sisa Limit Ahmad di DB: Rp500.000.
*   **Ekspektasi Response AI:** `Status: APPROVED. Sisa Limit Baru: Rp350.000.`
*   **Hasil Aktual Pengujian:** [Isi setelah uji coba dilakukan]
*   **Status Akhir:** `[ PASS / FAIL ]`

### Kasus Uji 2: Jalur Gagal / Anomali (Edge Case)
*   **Transaction ID (Reference Number):** `TX-2026-0002`
*   **Data Input:** Foto Nota (Nomor: INV-778), Nama: Ahmad, Total: Rp600.000.
*   **Data Pembanding Internal:** Sisa Limit Ahmad di DB: Rp500.000.
*   **Ekspektasi Response AI:** `Status: REJECT. Alasan: Total transaksi melebihi limit.`
*   **Hasil Aktual Pengujian:** [Isi setelah uji coba dilakukan]
*   **Status Akhir:** `[ PASS / FAIL ]`

---

## 👤 7. JALUR INTERVENSI MANUSIA (HUMAN-IN-THE-LOOP)

SOP penanganan apabila pengujian *Three-Way Matching* (Poin 5) atau Kasus Uji (Poin 6) mendeteksi adanya status `REJECT` atau `FAIL`:
1.  Sistem otomatis menghentikan proses otomatisasi secara instan.
2.  Data transaksi dikirim ke dasbor antrean peninjauan manual tim **[Sebutkan Nama Tim/Staf]**.
3.  Manusia melakukan verifikasi visual ulang dalam waktu maksimal **[X] Jam**.
4.  Jika kesalahan disebabkan oleh AI yang salah membaca data, lakukan pembaruan instruksi pada **Poin 4 (AI Alignment)**.