Menghindari Kegagalan Workflow

Jika Gagal Sekali, Nilainya Jadi Nol

"If it fails during delivery, the client forgets the 30 hours you spent building it."

Client tidak menilai berapa lama kamu mengerjakan workflow. Mereka menilai: apakah workflow-nya berjalan dengan benar? Satu kegagalan saat delivery bisa menghapus seluruh kepercayaan yang sudah dibangun.

---

Mengapa End-to-End Testing Non-Negotiable

❌ Testing per node:
   [Node A] ✅  [Node B] ✅  [Node C] ✅
   → Tapi gabungan A+B+C bisa GAGAL!

✅ Testing end-to-end:
   [Trigger] → [Node A] → [Node B] → [Node C] → [Output]
   → Jalankan PERSIS seperti client akan menjalankannya

Jangan test node satu per satu lalu anggap selesai. Jalankan seluruh workflow dari trigger sampai completion — persis seperti yang akan terjadi di production.

---

Happy Cases vs Unhappy Cases

Tipe Testing	Contoh	Prioritas
Happy case	User upload invoice valid → data terekstrak sempurna	Wajib
Unhappy case	User upload gambar bukan invoice → apa yang terjadi?	Wajib
Edge case	File lebih dari 5MB, field kosong, format aneh	Wajib
API failure	OpenAI timeout, Google Sheets rate limit	Wajib

                    Test Scenarios
                         │
           ┌─────────────┼─────────────┐
           │             │             │
     Happy Cases   Unhappy Cases   Edge Cases
     "Semua OK"   "Input salah"   "Skenario langka"
           │             │             │
           └─────────────┼─────────────┘
                         │
                  Semua HARUS lulus
                  sebelum delivery

---

Checklist Quality Control

• [ ] Conditional branching berfungsi di semua jalur (true DAN false)
• [ ] Data transform benar di setiap step
• [ ] Semua trigger dan filter berjalan sesuai ekspektasi
• [ ] Empty fields ditangani dengan baik
• [ ] Format tidak terduga tidak menyebabkan crash
• [ ] API failure di-handle gracefully
• [ ] Credentials menggunakan milik client, bukan milikmu

---

Masalah Credentials: Penyebab Kegagalan #1

Yang paling sering menyebabkan workflow gagal saat migrasi:

Development (API key kamu)
     │
     ▼
Migration ke client
     │
     ▼
❌ "Node X gagal: credential invalid"
     │
     ▼
Ternyata 1 node masih pakai API key lama

Solusi

Langkah	Detail
Minta client buat akun sendiri	Jangan pakai "Sign in with Google" — buat username/password yang bisa dishare
Screen sharing saat setup	Ajak client share screen untuk autentikasi
Kirim Loom video	Jelaskan proses credential setup via video
Verifikasi SEMUA node	Pastikan tidak ada satu pun node yang masih pakai credential-mu

Pengalaman Nyata

"Di proyek kedua saya, karena terburu-buru, saya skip testing satu edge case. Workflow gagal di depan client. Meskipun saya bisa handle dengan baik, itu merusak kepercayaan — bukan hanya terhadap saya, tapi terhadap teknologi automation itu sendiri."

---

Dokumentasi Limitasi

Jika menemukan batasan saat testing, dokumentasikan dan sampaikan ke client:

Contoh Dokumentasi Limitasi:
─────────────────────────────────────────────
• File upload max 5MB (limit API pihak ketiga)
• Processing time: ~30 detik per invoice
• Format yang didukung: PDF, JPG, PNG
• Bahasa yang didukung: Indonesia, English
─────────────────────────────────────────────

Jangan sembunyikan limitasi — client lebih menghargai transparansi daripada kejutan di production.

---

Setelah Go-Live: Tetap Waspada

Testing di staging ≠ selesai. Setelah workflow live di production:

1. Pantau initial runs — Jangan langsung lepas tangan
2. Pastikan semua edge case tercatat dan ter-handle
3. Monitor error rate selama minggu pertama
4. Siap response jika ada masalah

---

Takeaway

Expert dan amateur sama-sama bisa build workflow. Yang membedakan: expert memastikan workflow-nya TIDAK GAGAL saat delivery. Testing end-to-end bukan opsional — ini non-negotiable.