🧠 Mays AI Automation Doc Builder

Mays AI Automation Doc Builder adalah sistem generator dokumen otomatis berstandar perbankan enterprise (Bank-grade) untuk menyusun Evidence Report dan Berita Acara (BA) pengujian QA (SIT & UAT).

Sistem ini menghilangkan seluruh kebutuhan penyuntingan dokumen pasca-generasi secara manual dengan mengotomatisasi pencocokan skenario pengujian dari file CSV dengan dokumentasi screen capture Word, analisis surat undangan UAT PDF secara dinamis, pembagian seksi halaman tanda tangan secara otomatis, serta pembangunan tabel tanda tangan pejabat Bank secara dinamis.

📦 Keunggulan Edisi Standalone Binary (Tanpa Node.js)

Aplikasi ini telah dibundel ke dalam file binary mandiri (standalone executable). Rekan kerja Anda tidak memerlukan instalasi Node.js, Git, atau dependency apa pun. Cukup unduh file biner sesuai sistem operasi mereka:

• Windows: Mays_AI_Doc_Generator-win-x64.exe (Untuk laptop Windows)
• Mac M1/M2/M3: Mays_AI_Doc_Generator-macos-arm64 (Apple Silicon)
• Mac Intel: Mays_AI_Doc_Generator-macos-x64 (Intel Mac lama)

📂 Struktur Direktori & Workspace di Laptop Baru

Letakkan file aplikasi biner tersebut di folder kerja utama Anda, bersebelahan dengan folder proyek:

📁 Folder_Kerja/
├── Mays_AI_Doc_Generator-win-x64.exe   # File biner aplikasi (versi Windows)
├── mays_settings.json                 # Konfigurasi global API Key
└── ProjectName/
    └── [Nama_Folder_Proyek_Anda]/     # Contoh: "Penyelesaian Pada Aplikasi E-Collection Management System (RPA)"
        ├── ba_config.json             # File konfigurasi metadata & tanda tangan dinamis (PENTING!)
        ├── Master_Data/               # Folder Input utama QA
        │   ├── *.csv                  # CSV Skenario pengujian (SIT dan UAT)
        │   ├── *.docx                 # Dokumen evidence mentah hasil capture
        │   └── *.pdf                  # File undangan UAT (PDF) untuk deteksi tanda tangan dinamis
        └── Destination_Folder/        # Folder Output hasil generasi (*.docx)

⚡ Fitur Utama "Otak" Generator Dokumen

1. Banner & Alur Interaktif (Welcome Board)

Setiap kali aplikasi dijalankan, terminal akan memunculkan banner sambutan yang indah beserta panduan langkah demi langkah penggunaan. Jika dijalankan tanpa parameter, aplikasi akan memindai folder proyek aktif dan menampilkan menu nomor pilihan sehingga Anda tidak perlu mengetik nama folder yang panjang secara manual.

2. Pembagian Seksi Dokumen Berita Acara (Section Breaks)

Untuk menghasilkan layout tanda tangan pejabat yang rapi:

• Seksi 1 (Body Laporan): Berisi tabel metadata hingga daftar peserta. Footer menampilkan tabel paraf kecil untuk tim pelaksana.
• Seksi 2 (Tanda Tangan Pejabat): Memindahkan blok Mengetahui & Menyetujui secara otomatis ke halaman terakhir (mencegah tabel terpotong acak di tengah halaman). Footer tanda tangan kecil pada halaman terakhir ini disembunyikan agar tidak terjadi duplikasi tanda tangan yang tidak perlu.

3. Header Kotak Halaman 1 Formal

• Halaman 1: Judul pengujian USER ACCEPTANCE TESTING (UAT) atau SYSTEM INTEGRATION TESTING (SIT) ditampilkan rapi tanpa garis bawah di dalam kotak tabel berita acara, dengan Nomor BA terpusat di tengah (centered) sejajar dengan judul.
• Halaman 2+: Hanya menampilkan Nomor BA kecil rata kanan di margin atas untuk kepatuhan dokumen.

4. AI Self-Healing Engine (Pencegahan Kegagalan Otomatis)

Jika terjadi error saat kompilasi (misalnya: file ba_config.json tidak valid atau ada data pejabat yang kurang), sistem akan menghubungi Gemini AI secara otomatis untuk menganalisis kesalahan, merekomendasikan hot-patch konfigurasi, menimpa file config yang rusak secara otomatis, dan mengulangi eksekusi (rerun) secara instan hingga dokumen sukses dibuat.

🛠️ Cara Mengonfigurasi Gemini API Key

Agar AI Self-Healing aktif di laptop Anda maupun rekan kerja Anda, Anda dapat membagikan API Key yang sama dengan cara:

1. Buka file mays_settings.json yang berada di root folder kerja Anda menggunakan Text Editor.
2. Masukkan API Key Anda di bagian "gemini_api_key":

   {
     "gemini_api_key": "AIzaSyxxxxxxxxxxxxxxxxx"
   }

3. Simpan file tersebut. Generator biner akan otomatis membaca API Key dari file ini saat eksekusi.

🚀 Cara Menjalankan Generator di Laptop Lain

A. Pengguna WINDOWS

1. Buka folder kerja Anda di File Explorer.
2. Klik address bar di bagian atas, ketik cmd, lalu tekan Enter.
3. Jalankan salah satu perintah berikut:
   • Opsi 1 (Menu Interaktif - Tinggal Pilih Nomor):

     Mays_AI_Doc_Generator-win-x64.exe

   • Opsi 2 (Eksekusi Langsung Proyek Spesifik):

     Mays_AI_Doc_Generator-win-x64.exe "ProjectName/Nama_Folder_Proyek_Anda"

B. Pengguna MACOS (Macbook)

1. Buka Terminal di Mac Anda.
2. Arahkan ke folder kerja Anda menggunakan perintah cd (misal: cd /Users/nama/Downloads/Mays-Doc-Builder).
3. Berikan izin eksekusi aplikasi sekali saja:

   chmod +x Mays_AI_Doc_Generator-macos-arm64

4. Jalankan aplikasi:
   • Opsi 1 (Menu Interaktif - Tinggal Pilih Nomor):

     ./Mays_AI_Doc_Generator-macos-arm64

   • Opsi 2 (Eksekusi Langsung Proyek Spesifik):

     ./Mays_AI_Doc_Generator-macos-arm64 "ProjectName/Nama_Folder_Proyek_Anda"

C. Alternatif: Tanpa Mengirim File (Menggunakan NPX)

Jika Anda tidak ingin menyalin file binary apa pun ke laptop rekan kerja Anda, mereka dapat langsung menjalankannya menggunakan perintah npx di terminal folder kerja mereka:

• Menu Interaktif:

  npx mays-automation-ai-doc-generator

• Langsung Eksekusi Proyek:

  npx mays-automation-ai-doc-generator "ProjectName/Nama_Folder_Proyek_Anda"

⚙️ Skema Konfigurasi Dinamis (ba_config.json)

Buat file ba_config.json di dalam folder proyek Anda untuk mengontrol seluruh data variabel, tanggal, daftar hadir peserta, serta pejabat penandatangan.

Contoh Format Lengkap ba_config.json

{
  "noCrf": "082/CR/RPK/VI/2026",
  "versiDevice": "-",
  "tempat": "Hybrid",
  "lampiran": "Script UAT",
  "tanggal": "9 Juli 2026",
  "qaAnalyst": "Farras Syam Aly",
  "qaTesting": "Farras Syam Aly",
  "controlPic": "Farras Syam Aly",
  "catatan": "Seluruh skenario pengujian berjalan lancar.",
  
  "mengetahui": [
    { "divisi": "Divisi IT QA", "singkatan": "Div IT QA", "nama": "Theresia Tantri Astri", "jabatan": "Pemimpin" },
    { "divisi": "Divisi IT PM", "singkatan": "Div IT PM", "nama": "Yohana Minanda", "jabatan": "Pemimpin" },
    { "divisi": "Divisi Penyelamatan & Penyelesaian Kredit/Pembiayaan UMKM & Konsumer", "singkatan": "Div Penyelamatan & Penyelesaian Kredit/Pembiayaan UMKM & Konsumer", "nama": "Lisa Lubrina", "jabatan": "Pemimpin" },
    { "divisi": "Divisi Lelang & Portfolio Management", "singkatan": "Div Lelang & Portfolio Management", "nama": "Agus Mega Dwi", "jabatan": "Pemimpin" },
    { "divisi": "Divisi Risiko Operasional & Anti Fraud", "singkatan": "Divisi Risiko Operasional & Anti Fraud", "nama": "Dedy Susanto", "jabatan": "Pemimpin" }
  ],
  
  "menyetujui": [
    { "grup": "Grup IT Strategic Planning & Control", "singkatan": "Grup ISP", "nama": "Vicky Felicia Korompis", "jabatan": "Pemimpin" },
    { "grup": "Grup IT Application Development", "singkatan": "Grup IAD", "nama": "Anggisesa Jalulaga", "jabatan": "Pemimpin" }
  ],
  
  "peserta": [
    { "nama": "Farras Syam Aly", "jabatan": "Asisten ISP", "unit": "Grup ISP" }
  ]
}