Mengapa manual ini ada
Fitur Pra-konsultasi iRehab dibangun di atas satu prinsip desain: AI bukan untuk menulis prosa bagi Anda — AI ada untuk mengembalikan waktu kepada Anda. Saat pasien duduk, layar sudah memiliki ringkasan terstruktur. Anda tidak menghabiskan lima menit mengumpulkan data dasar — Anda menginvestasikan lima menit itu untuk mendengarkan, memeriksa, memutuskan. Rasionalisasi desain lengkap ada di Ringkasan Pra-kunjungan: Saat Pasien Tidak Tahu Apakah Tendon atau Saraf.
Manual ini untuk dokter yang benar-benar memakai fitur ini. Cetak dan tempel di meja.
1. Sebelum klinik: cetak poster QR hari ini
- Buka Doctor PWA (
irehab-doctor.pages.dev) dan masuk - Pindah ke tab "Pra-konsultasi"
- Di kanan atas, ketuk "Cetak QR Hari Ini"
- Pratinjau A4 terbuka → cetak atau simpan sebagai PDF
Catatan:
- Sebaiknya cetak dari komputer klinik agar tata letak bersih. Safari di iPhone kadang merusak tata letak — jika hanya ada HP, simpan dulu sebagai PDF
- Poster menampilkan nama dokter hari itu. Cetak ulang saat dokter berganti
- Tempel di tempat yang mudah dilihat pasien — ruang tunggu atau meja resepsionis. Jika pasien tidak bisa memindai, petugas resepsionis dapat membantu
2. Cara membaca antrean pra-konsultasi
Setelah pasien mengirim formulir, rekam medis muncul di antrean "Pra-konsultasi" Anda dalam sekitar 30 detik. Setiap kartu menampilkan:
- Nama + tahun lahir + jenis kelamin (anak kecil ditampilkan "X tahun Y bulan")
- Keluhan utama satu baris — kata-kata pasien, apa adanya
- Skor nyeri VAS (0–10)
- Label jenis sensasi (nyeri / kesemutan / lemah / beberapa / lainnya)
- Bilah peringatan merah — muncul jika kombinasi gejala perlu perhatian ekstra; lihat ini lebih dulu
- Label ⚠️ Pencarian manual — rekam ditarik dari antrean dokter lain dengan kode; tanyakan beberapa hal ekstra
Perluas kartu untuk melihat draft ringkasan lengkap dalam dua format:
- Ringkasan telegrafi — salin satu-ketuk untuk ditempel ke baris S di HIS (
R't knee,B/L,F/M/N) - Paragraf utuh — untuk laporan IRB atau surat rujukan
3. Pohon keputusan saat konsultasi
Di akhir kunjungan, tekan satu tombol penutup. Tiga pilihan:
┌──────────────────────────┐
│ Pemantauan (konservatif)│ → Pasien masuk daftar pemantauan iRehab
│ │ VAS + GROC dikirim 3 hari sebelum kunjungan ulang
└──────────────────────────┘
┌──────────────────────────┐
│ Operasi atau rehab │ → Membuat rekam asuhan formal
│ │ Anda pilih jalur (TKA / THA / Bahu / Rehab umum)
└──────────────────────────┘
┌──────────────────────────┐
│ Tutup (tanpa pemantauan)│ → Rekam disimpan 180 hari untuk rujukan
│ │ Sistem tidak mengirim notifikasi lagi
└──────────────────────────┘
Setiap tombol memunculkan kotak konfirmasi yang mencantumkan apa yang akan dilakukan sistem — konfirmasi sebelum dijalankan.
4. Pencarian manual dengan kode konfirmasi
Kapan digunakan:
- Antrean terlihat kosong tetapi pasien yakin sudah mengisi
- Pasien memberikan kode
PC-XXXXXX - Anda menggantikan dokter lain (pasien memindai QR dokter lain)
- Bantu lintas klinik
Cara:
- Di kanan atas antrean, ketuk "⊕ Pencarian Manual"
- Masukkan 6 karakter yang dibacakan pasien:
PC- [ _ _ _ _ _ _ ](tidak sensitif huruf besar/kecil; jika ditempel dari LINE, sistem membersihkan otomatis) - Kirim → rekam masuk antrean Anda dengan label ⚠️ Pencarian Manual
- Jika rekam aslinya milik dokter lain, kartu menampilkan "Dokter asal: XXX" — pengingat ini bukan pasien tetap Anda, tanyakan lebih banyak
Batasan: hanya di dalam rumah sakit yang sama. Tidak ada pencarian antar-RS.
5. Pertanyaan umum
T: Pasien bilang sudah mengisi, tapi antrean saya kosong. Bagaimana?
J: Pertama cek waktu — pengiriman ke tampil sekitar 30 detik. Masih tidak muncul? Minta kode PC-XXXXXX dan gunakan Pencarian Manual (bagian 4).
T: Bagaimana dengan karakter mirip seperti O dan 0?
J: Sistem sengaja mengecualikan karakter yang mudah bingung (tidak ada O / 0 / I / 1 dalam kode). Yang dibacakan pasien tidak akan ambigu.
T: Saya menggantikan Dr. X. Bagaimana antrean beliau? J: Gunakan bagian 4 untuk menarik rekam ke antrean Anda dengan kode. Kartu akan menandai "Dokter asal: X". Tutup seperti biasa — rekam asuhan akan benar tercatat atas nama Anda karena Andalah yang benar-benar memeriksa pasien.
T: Pasien mengisi setengah lalu pergi. Apa yang terjadi? J: Rekam dalam status "belum dikirim" dan tidak masuk antrean. Jika kembali dan memindai QR yang sama dari HP yang sama, sistem melanjutkan dari langkah terakhir.
T: Saya menekan "Tutup" tanpa sengaja — cara membatalkan? J: Rekam yang ditutup disimpan 180 hari. Buka rekam, di kanan atas ketuk "Buka Kembali", pilih "Pemantauan" atau "Operasi atau rehab". Rekam asuhan baru dibuat; penutupan lama ditandai "ditarik".
T: Apa arti bilah peringatan merah? J: Jawaban pasien cocok dengan kombinasi yang sistem tandai untuk perhatian ekstra (contoh: "lemah + memburuk + terus-menerus"). Bukan diagnosis, hanya pengingat untuk memverifikasi gejala peringatan tersebut saat pemeriksaan. Apakah benar-benar darurat, tetap keputusan Anda.
6. Terjemahan AI (opsional) — Bawa kunci Gemini Anda sendiri (BYOK)
Fitur opsional. Jika tidak diaktifkan, penggunaan harian tidak terpengaruh; Anda akan melihat keluhan utama dalam bahasa asli pasien tanpa terjemahan otomatis. Ini desain BYoAI (Bring-your-own-AI): dokter memakai kuota API Gemini sendiri, biaya ditanggung sendiri (sangat rendah), server iRehab tidak menyimpan respons LLM apa pun.
Kapan mengaktifkan
- Klinik Anda sering menerima pasien bukan penutur asli bahasa Tionghoa (Vietnam, Indonesia, Jepang, Korea, Inggris…)
- Anda ingin satu ketukan untuk menerjemahkan keluhan berbahasa asing ke bahasa yang Anda baca dengan mudah
Langkah aktivasi (5 menit)
Langkah 1 — Ambil kunci dari Google AI Studio
- Peramban buka https://aistudio.google.com/app/apikey
- Masuk dengan akun Google (gunakan akun pribadi, bukan akun rumah sakit)
- Klik "Create API key" → akan muncul string yang diawali
AIza... - Jangan tutup tab; salin string itu
Langkah 2 — Pastikan billing aktif (sangat penting)
- Klik kunci yang baru dibuat → atau sidebar kiri "Billing" → aktifkan billing
- Meski hanya pakai tier gratis, Google mensyaratkan project terpasang kartu kredit sebelum memberi kuota normal
- Tanpa billing, pendaftaran akan gagal (muncul "quota exceeded")
Langkah 3 — Daftarkan kunci di Doctor PWA
- Pindah ke tab "✨ AI" di bagian bawah (bukan Profile; pengaturan BYOK pindah dari Profile ke tab AI)
- Cari kartu "BYOK Gemini Key"
- Ketuk "Aktifkan dan masukkan kunci"
- Baca catatan tujuan → Lanjutkan
- Centang ketiga persetujuan (data terkirim ke Google, rumah sakit mengizinkan, iRehab tidak bertanggung jawab atas pemrosesan sisi Google) → Lanjutkan
- Tempel
AIza...→ tekan "Simpan kunci" - Sukses ditandai indikator hijau "Terkonfigurasi (aktif)"
Kesalahan pendaftaran umum
| Pesan error | Kenapa | Penanganan |
|---|---|---|
| Format tidak valid | Salin-tempel ada spasi berlebih atau karakter kurang | Salin ulang AIza... lengkap |
| Kunci tidak valid atau dicabut | Kunci benar-benar dihapus atau dibatasi | Kembali ke AI Studio, buat kunci baru |
| Kuota habis | Kuota Google terpicu | Tunggu 1–2 menit / pastikan billing aktif / ganti kunci |
| Error respons Google | Format respons Google bermasalah | Tunggu 1 menit; jika terus gagal, hubungi engineering |
| Layanan tidak stabil sementara | KMS backend iRehab tidak tersedia sementara | Tunggu 1 menit dan coba lagi |
| Terlalu banyak percobaan | Lebih dari 20 pendaftaran dalam 1 jam | Tunggu 1 jam |
Cara pakai setelah aktif
Perluas kartu pasien di antrean pra-konsultasi → area Path B akan menampilkan tombol "Terjemahkan Keluhan" (hanya muncul jika bahasa keluhan pasien ≠ bahasa UI Anda). Ketuk untuk mengirim keluhan ke API Gemini milik Anda sendiri; dalam hitungan detik terjemahan satu baris muncul di kartu.
Penting:
- Terjemahan adalah alat bantu baca; tidak menimpa baris S di HIS. Baris S tetap ditempel dengan ringkasan telegrafi asli
- Teks asli pasien dipertahankan 100% dalam rekam — tidak diubah, tidak diringkas, tidak ditulis ulang
- Terjemahan hanya berjalan saat Anda menekan tombol — tidak otomatis. Anda yang memutuskan kapan menerjemahkan
Jaminan keamanan (IT rumah sakit mungkin bertanya)
- Kunci Anda tidak pernah keluar dari browser + backend iRehab; tidak masuk log, pesan error, atau sistem support
- Penyimpanan backend memakai Google KMS envelope encryption (enkripsi berlapis); bahkan teknisi iRehab tidak bisa membukanya langsung
- Setiap dekripsi kunci mencatat Google Cloud Audit Log (pemakaian anomali dapat dilacak)
- Server iRehab tidak menyimpan konten respons LLM; hasil terjemahan hanya tampil di browser Anda
- Anda bisa menekan "Hapus Kunci" di tab AI kapan saja — secret terenkripsi di backend langsung dihapus
- Log penggunaan historis dipertahankan untuk audit, tidak dihapus
Yang perlu disampaikan ke IT rumah sakit
- Data melewati HTTPS ke Google Gemini API (
generativelanguage.googleapis.com) - Setiap kirim hanya berisi teks keluhan pasien — tanpa nama, KTP, atau nomor rekam medis
- Kebijakan retensi Google di jalur ini: jalur API komersial, tidak dipakai untuk melatih model (ada jaminan kontrak)
- Jika kebijakan rumah sakit melarang, IT dapat memberi tahu kepala departemen dan kami akan menonaktifkan fitur untuk seluruh institusi dari backend
