Overview
Jadimaju AI FAQ Assistant adalah platform bantuan pelanggan yang dirancang untuk menjembatani kebutuhan dua sisi sekaligus: pelanggan yang mencari jawaban cepat, dan tim customer service yang ingin mengurangi pertanyaan berulang. Aplikasi ini mencakup landing page publik dengan pencarian FAQ real-time, AI assistant berbasis Groq, form pengiriman pertanyaan, serta admin panel lengkap untuk mengelola FAQ, knowledge base, pertanyaan masuk, dan log percakapan AI.
Background / Problem
Tim customer service sering menerima pertanyaan yang sama berulang kali dari pelanggan tanpa ada sistem bantuan mandiri yang memadai. Hal ini menyebabkan waktu respons lebih lambat, beban kerja CS meningkat, dan pengalaman pelanggan menjadi kurang efisien. Diperlukan sistem terpusat yang dapat memberikan jawaban otomatis berdasarkan knowledge internal perusahaan sekaligus memudahkan admin dalam mengelola konten bantuan.
My Role
Saya bertanggung jawab penuh terhadap perancangan arsitektur, pengembangan full-stack (frontend dan backend), integrasi AI, desain database, serta deployment dan pengujian aplikasi secara end-to-end.
Process
Perencanaan & Arsitektur
Dimulai dengan penyusunan Product Requirements Document (PRD) yang mencakup 29 section — mulai dari user roles, API specification, database schema, AI system design, hingga security dan testing strategy. Arsitektur mengikuti pola frontend-backend terpisah dengan REST API dan MySQL sebagai database utama.
Pengembangan Backend
Backend dibangun dengan Express 4 dan MySQL 8, menggunakan pola layering (routes, controllers, services, validators) tanpa ORM — query SQL eksplisit untuk kemudahan review. Fitur utama backend meliputi:
Pengembangan Frontend
Frontend dibangun dengan React 18 + Vite 5 + TailwindCSS 3. Menggunakan Zustand untuk state management (auth, chat, theme), React Hook Form + Zod untuk validasi form, dan Axios interceptor untuk refresh token otomatis. Fitur-fitur utama meliputi:
Integrasi AI
AI tidak mengambil jawaban bebas dari internet. Sistem melakukan retrieval dari FAQ dan Knowledge Base via MySQL FULLTEXT, lalu menyusun prompt ketat agar AI hanya menjawab berdasarkan konteks internal. Jika informasi tidak cukup, AI diarahkan untuk memberikan fallback dan menyarankan pelanggan menghubungi CS. Untuk admin, AI hanya membuat draft balasan — admin tetap melakukan review sebelum email dikirim.
Key Features / Deliverables
Tools / Technologies
Result / Impact
Aplikasi berhasil dikembangkan sebagai MVP dengan seluruh fitur utama berfungsi penuh. Build frontend dan lint berjalan tanpa error. Sebanyak 29 unit test berhasil lolos di frontend. Aplikasi dapat dijalankan dalam dua mode: menggunakan mock API (tanpa backend) untuk development cepat, atau terhubung ke backend real dengan database MySQL untuk production.
Aplikasi ini dirancang sebagai fondasi yang solid — data tersimpan real di database, admin panel berfungsi penuh, UI responsif di semua perangkat, dan integrasi AI digunakan untuk mempercepat workflow CS, bukan menggantikan peran admin.
Reflection
Tantangan terbesar dalam pengembangan ini adalah memastikan AI tidak mengarang jawaban di luar knowledge base, menjaga UI tetap nyaman di perangkat mobile untuk admin panel yang kaya data, serta mendukung dual-mode deployment (mock API vs real backend). Solusi kuncinya adalah strict prompt engineering dengan retrieval-based context, mobile-first approach dengan card layout di layar kecil, dan arsitektur frontend yang mendukung Mock Service Worker untuk isolasi development.
