Buku Panduan Resmi CORA

FAQ & Pemecahan Masalah (Troubleshooting)

Jawaban untuk pertanyaan yang sering diajukan seputar sistem CORA, panduan penanganan kendala teknis (troubleshooting), serta daftar istilah teknis (glosarium).

🌐

5.1 FAQ Umum & Konsep Sistem CORA

Q1: Apakah Web CORA dapat diakses dari smartphone atau tablet?

Jawaban: Ya, Web CORA dibangun dengan antarmuka yang sepenuhnya responsif (mobile-friendly), sehingga dapat diakses dengan lancar dari perangkat laptop, komputer desktop, tablet, maupun smartphone Android dan iOS tanpa perlu memasang aplikasi tambahan.

Q2: Berapa lama waktu yang dibutuhkan untuk menyelesaikan satu sesi wawancara?

Jawaban: Rata-rata sesi wawancara berlangsung antara 10 hingga 20 menit (sekitar 8 sampai 15 kali pertukaran pesan), tergantung pada kelengkapan dan kedalaman cerita alur kerja yang Anda berikan kepada Asisten AI.

Q3: Apakah narasumber diwajibkan memahami istilah teknis pemrograman?

Jawaban: Sama sekali tidak. AI CORA dirancang untuk memahami bahasa sehari-hari dan menggali alur operasional kerja nyata. Anda cukup menceritakan rutinitas, kendala, dan harapan Anda apa adanya seperti berbicara dengan rekan kerja.

👥

5.2 FAQ Khusus Pengguna Stakeholder (Sesi, Tiket, & Privasi)

Q4: Apakah saya bisa menjeda (pause) wawancara dan melanjutkannya di hari lain?

Jawaban: Sangat bisa. Seluruh pertukaran pesan tersimpan otomatis secara real-time di server. Anda cukup login kembali ke akun Anda kapan saja, buka menu 'Wawancara Saya', dan klik tombol Lanjutkan untuk meneruskan obrolan.

Q5: Apakah data wawancara saya dapat dilihat oleh publik di internet?

Jawaban: Tidak. Seluruh percakapan, transkrip, dan ringkasan kebutuhan bersifat privat dan terenkripsi. Data hanya dapat diakses oleh Anda sendiri serta tim Analis Sistem (Elicitor) yang mengelola proyek terkait.

Q6: Bisakah satu stakeholder mengikuti lebih dari satu proyek wawancara yang berbeda?

Jawaban: Sangat bisa. Anda cukup memasukkan kode tiket proyek baru pada menu 'Gabung Proyek', dan seluruh riwayat proyek yang Anda ikuti akan tersusun rapi pada dashboard akun Anda.

📊

5.3 FAQ Khusus Analis Sistem / Elicitor (Proyek, Evaluasi, & SRS)

Q7: Mengapa dokumen resume proyek (SRS Resume) belum bisa di-generate?

Jawaban: Dokumen resume proyek memerlukan minimal 1 sesi wawancara stakeholder yang telah tuntas hingga tahap konfirmasi kesepakatan (Agreement of Communication / AoC) berstatus 'Completed'.

Q8: Apa yang harus dilakukan jika terjadi tingkat False Valid yang tinggi pada suatu tiket?

Jawaban: Evaluasi kembali rumusan Sasaran Wawancara (Goals) pada tiket tersebut. Pastikan goals dirumuskan secara spesifik (SMART), tidak menggabungkan banyak topik dalam satu kalimat (multi-question), dan sesuai dengan batasan peran narasumber.

Q9: Bagaimana cara mengunduh berkas transkrip lengkap seluruh wawancara?

Jawaban: Buka menu 'Monitoring Wawancara' di panel admin, pilih sesi yang diinginkan, klik tombol 'Lihat Transkrip', lalu klik tombol biru Download PDF.

⚠️

4.1 Panduan Pemecahan Masalah (Troubleshooting) untuk Stakeholder

Gejala Kendala Teknis Kemungkinan Penyebab Langkah Solusi Praktis
Kode Tiket 'Tidak Valid' atau 'Tidak Ditemukan' Salah mengetik huruf/angka (misal: huruf O tertukar angka 0). Periksa kembali kode tiket pada pesan/email admin. Salin dan tempel (copy-paste) kode secara langsung tanpa spasi tambahan.
Keterangan 'Tiket Expired' atau 'Belum Mulai' Waktu saat ini berada di luar rentang jadwal waktu aktif tiket (time window). Hubungi administrator melalui Live Support Chat di pojok kanan bawah untuk meminta perpanjangan jadwal tiket.
Pesan 'Sistem Sedang Sibuk, Kirim Ulang Pesan' Lonjakan antrean server AI atau sambungan internet sempat terputus sesaat. Cukup klik tombol Kirim Pesan (Retry) kembali. Anda tidak perlu me-refresh halaman agar teks ketikan tidak hilang.
Chat Tidak Menggulir ke Bawah Otomatis Browser memblokir auto-scroll atau versi browser usang. Gunakan Chrome atau Firefox versi terbaru dan pastikan JavaScript aktif.
Lupa Password Akun Stakeholder Lupa kata sandi yang didaftarkan saat registrasi. Hubungi admin proyek Anda melalui tombol bantuan untuk meminta reset password akun.
🛠️

4.2 Panduan Pemecahan Masalah (Troubleshooting) untuk Elicitor / Admin

Gejala Kendala Admin Penyebab Teknis Langkah Penanganan
Email Notifikasi Tiket Belum Diterima Konfigurasi SMTP server belum aktif atau email masuk folder Spam. Minta stakeholder memeriksa folder Spam, atau klik tombol Resend Email pada tabel tiket detail proyek.
Tingkat False Valid Tinggi Target wawancara (goals) terlalu panjang, ambigu, atau bahasa campuran. Perbaiki rumusan goals tiket menjadi poin-poin singkat yang spesifik (SMART goals) dan berikan batasan peran yang jelas.
Gagal Generate Resume SRS Belum ada narasumber yang menyelesaikan wawancara hingga tahap persetujuan (AoC). Pastikan minimal ada 1 stakeholder yang telah menuntaskan sesi wawancara hingga berstatus 'Completed'.
Quota Tiket 'Max Uses' Habis Jumlah stakeholder yang mencoba bergabung melebihi kuota tiket yang diterbitkan. Buat tiket baru atau tambahkan stakeholder pada proyek tersebut melalui panel manajemen proyek.
📖

8. Glosarium & Daftar Istilah Teknis Sistem CORA

Agreement of Communication (AoC): Tahap verifikasi penutup di mana AI menyajikan rangkuman butir kebutuhan dan meminta konfirmasi narasumber.
Anti-Pola Pertanyaan (Antipattern): Pola kesalahan dalam perumusan pertanyaan wawancara (leading questions, multi-question, ambiguous).
False Valid: Draf pertanyaan AI yang terdeteksi melanggar standar kualitas, lalu dicegat dan diperbaiki otomatis sebelum terkirim.
Proto-Persona: Representasi profil pengguna berbasis demografi & konteks operasional yang memandu empati wawancara AI.
Retrieval-Augmented Generation (RAG): Arsitektur pencarian konteks pengetahuan terverifikasi untuk memperkaya respons AI.
Software Requirements Specification (SRS): Dokumen spesifikasi formal yang memuat kebutuhan fungsional dan non-fungsional sistem.