Debugging
Log
Sentra Assist menggunakan logger berlingkup (utils/logger.ts) dengan saluran
debug:
global— Peristiwa ekstensi umumriwayat— Riwayat pasien / operasi DASbackground— Peristiwa skrip latar belakangcontent— Peristiwa skrip kontenfiller— Operasi pengisian formulir otomatis
Aktifkan saluran debug melalui variabel lingkungan VITE_DEBUG_*.
Kesalahan umum
| Kesalahan | Penyebab | Perbaikan |
|---|---|---|
| Ekstensi tidak memuat | Mode pengembang tidak diaktifkan | Aktifkan di chrome://extensions/ |
npm install gagal | Versi Node.js terlalu lama | Tingkatkan ke Node.js >= 22 |
| Kesalahan autentikasi Dashboard | Sesi magic-link tidak valid | Autentikasi ulang melalui Pengaturan |
| Panel samping "Login diperlukan" | URL dasar Dashboard salah | Periksa Pengaturan → Crew URL |
| Formulir tidak terisi otomatis | Pemetaan DAS basi | Klik Inisialisasi di header |
| Kesalahan batas kata | Batas bidang ePuskesmas adalah 225 kata | Sentra membatasi keluhan pada 220 kata |
| Kesalahan TypeScript | Ketidakcocokan tipe atau impor hilang | Jalankan npm run typecheck |
| LLM tidak berfungsi | Kunci API hilang | Periksa SENTRA_OPENAI_API_KEY |
| Peringatan SYMPHONY hilang | Jembatan dinonaktifkan | Periksa SENTRA_DISABLE_TRAJECTORY_BRIDGE |
Buku panduan pemecahan masalah
- Periksa konsol skrip latar belakang (Chrome DevTools → Service Worker)
- Periksa konsol panel samping (klik kanan di panel samping → Periksa)
- Verifikasi state
chrome.storage.localmelalui DevTools → Aplikasi → Penyimpanan - Periksa permintaan jaringan di DevTools skrip latar belakang
- Tinjau log audit (
lib/iskandar-diagnosis-engine/audit-logger.ts) untuk masalah alur diagnosis