Vì sao có cuốn cẩm nang này
Tính năng Khám tiền tư vấn của iRehab dựa trên một nguyên tắc thiết kế: AI không viết văn thay bạn — AI trả thời gian lại cho bạn. Khi bệnh nhân ngồi xuống, màn hình đã có một bản tóm tắt có cấu trúc. Bạn không mất năm phút hỏi thông tin cơ bản — năm phút đó dành cho việc lắng nghe, khám, quyết định. Lý do thiết kế đầy đủ trong bài Bản tóm tắt tiền khám: Khi bệnh nhân không phân biệt được gân và thần kinh.
Cẩm nang này dành cho bác sĩ thực tế sử dụng tính năng. In và dán cạnh bàn làm việc.
1. Chuẩn bị trước khi khám: in poster QR trong ngày
- Mở Doctor PWA (
irehab-doctor.pages.dev) và đăng nhập - Chuyển sang tab "Khám tiền tư vấn"
- Góc trên bên phải, chạm "In QR hôm nay"
- Bản xem trước A4 mở ra → in hoặc lưu thành PDF
Lưu ý:
- Nên in từ máy tính để bàn trong phòng khám cho bố cục sạch. Safari trên iPhone đôi khi làm lệch bố cục — nếu chỉ có điện thoại, lưu PDF rồi in
- Poster hiển thị tên bác sĩ khám trong ngày. In lại khi đổi bác sĩ
- Dán nơi bệnh nhân dễ thấy — khu chờ hoặc quầy tiếp nhận. Nếu bệnh nhân không biết quét, nhân viên quầy có thể hỗ trợ
2. Đọc danh sách tiền tư vấn
Sau khi bệnh nhân gửi biểu mẫu, hồ sơ xuất hiện trong danh sách "Khám tiền tư vấn" của bạn trong vòng khoảng 30 giây. Mỗi thẻ hiển thị:
- Tên + năm sinh + giới tính (trẻ nhỏ sẽ hiện "X tuổi Y tháng")
- Chủ than một dòng — nguyên văn lời bệnh nhân, không chỉnh sửa
- Điểm đau VAS (0–10)
- Nhãn loại cảm giác (đau / tê / yếu / nhiều loại / khác)
- Thanh cảnh báo đỏ — xuất hiện khi tổ hợp triệu chứng cần lưu ý; ưu tiên xem trước
- Nhãn ⚠️ Tra cứu thủ công — hồ sơ được kéo từ danh sách của bác sĩ khác bằng mã; hãy hỏi thêm vài câu
Mở rộng thẻ để thấy bản tóm tắt đầy đủ ở hai định dạng:
- Tóm tắt điện tín — một chạm sao chép để dán vào dòng S của HIS (
R't knee,B/L,F/M/N) - Đoạn văn mạch lạc — dùng khi viết báo cáo IRB hoặc giấy chuyển tuyến
3. Cây quyết định trong buổi khám
Cuối mỗi buổi khám, nhấn một nút kết luận. Ba lựa chọn:
┌──────────────────────────┐
│ Theo dõi (bảo tồn) │ → Bệnh nhân vào danh sách theo dõi iRehab
│ │ Khảo sát VAS + GROC gửi 3 ngày trước tái khám
└──────────────────────────┘
┌──────────────────────────┐
│ Phẫu thuật hoặc PHCN │ → Tạo hồ sơ chăm sóc chính thức
│ │ Bạn chọn phác đồ (TKA / THA / Vai / PHCN chung)
└──────────────────────────┘
┌──────────────────────────┐
│ Kết thúc (không TD) │ → Hồ sơ lưu 180 ngày để tra cứu
│ │ Hệ thống không gửi thông báo cho bệnh nhân
└──────────────────────────┘
Mỗi nút đều hiện hộp thoại xác nhận liệt kê hệ thống sẽ làm gì tiếp theo — xác nhận trước khi gửi đi.
4. Tra cứu thủ công bằng mã xác nhận
Khi nào dùng:
- Danh sách của bạn trống nhưng bệnh nhân khẳng định đã điền xong
- Bệnh nhân đưa mã
PC-XXXXXX - Bạn khám thay cho bác sĩ khác (bệnh nhân quét QR của bác sĩ khác)
- Hỗ trợ chéo phòng khám
Cách làm:
- Góc trên bên phải danh sách, chạm "⊕ Tra cứu thủ công"
- Nhập 6 ký tự bệnh nhân đọc:
PC- [ _ _ _ _ _ _ ](không phân biệt hoa/thường; dán từ LINE cũng được — hệ thống tự làm sạch) - Gửi → hồ sơ vào danh sách của bạn, gắn nhãn ⚠️ Tra cứu thủ công
- Nếu hồ sơ gốc thuộc bác sĩ khác, thẻ hiện "Bác sĩ gốc: XXX" — nhắc bạn đây không phải bệnh nhân của bạn, hỏi kỹ thêm
Giới hạn: chỉ tra cứu trong cùng bệnh viện. Không tra chéo bệnh viện.
5. Câu hỏi thường gặp
Hỏi: Bệnh nhân nói đã điền xong nhưng danh sách của tôi trống, phải làm sao?
Đáp: Trước hết kiểm tra thời gian — từ gửi đến hiển thị khoảng 30 giây. Vẫn không có? Yêu cầu mã PC-XXXXXX và làm theo mục 4.
Hỏi: Ký tự dễ nhầm như O và 0 thì sao?
Đáp: Hệ thống cố ý loại trừ các ký tự dễ nhầm (không có O / 0 / I / 1 trong mã sinh ra). Mã bệnh nhân đọc cho bạn chắc chắn không gây nhầm lẫn.
Hỏi: Tôi khám thay bác sĩ X, danh sách của họ thì sao? Đáp: Dùng mục 4 kéo hồ sơ vào danh sách của bạn bằng mã. Thẻ sẽ hiện "Bác sĩ gốc: X". Kết luận như bình thường — hồ sơ chăm sóc sẽ gắn đúng với bạn vì bạn mới là người khám.
Hỏi: Bệnh nhân điền nửa chừng rồi bỏ đi, sẽ ra sao? Đáp: Hồ sơ ở trạng thái "chưa gửi", không vào danh sách. Nếu họ quay lại và quét cùng QR bằng cùng điện thoại, hệ thống tiếp tục từ bước dang dở.
Hỏi: Tôi lỡ bấm "Kết thúc" — làm sao sửa? Đáp: Hồ sơ đã kết thúc vẫn lưu 180 ngày. Mở hồ sơ, góc trên phải chạm "Mở lại", rồi chọn "Theo dõi" hoặc "Phẫu thuật hoặc PHCN". Hệ thống tạo hồ sơ chăm sóc mới; lần kết thúc cũ đánh dấu "đã rút lại".
Hỏi: Thanh cảnh báo đỏ nghĩa là gì? Đáp: Câu trả lời của bệnh nhân khớp với tổ hợp triệu chứng cần lưu ý (ví dụ: "yếu + nặng dần + dai dẳng"). Không phải chẩn đoán, chỉ nhắc bạn xác nhận các triệu chứng cảnh báo trong lúc khám. Có thực sự cấp cứu hay không vẫn do bạn quyết định.
6. Dịch AI (tuỳ chọn) — Tự mang khoá Gemini của bạn (BYOK)
Tính năng tuỳ chọn. Không bật cũng không ảnh hưởng sử dụng thường ngày; chỉ là khi bệnh nhân điền chủ than bằng ngôn ngữ khác, bạn sẽ thấy nguyên văn nhưng không có bản dịch tự động. Đây là thiết kế BYoAI (Bring-your-own-AI): bác sĩ dùng hạn ngạch Gemini API của chính mình, tự chịu chi phí (rất thấp), máy chủ iRehab không lưu bất kỳ phản hồi LLM nào.
Khi nào bật
- Phòng khám của bạn thường gặp bệnh nhân không nói tiếng Trung bản ngữ (Việt, Indonesia, Nhật, Hàn, Anh…)
- Muốn một chạm dịch chủ than ngoại ngữ của bệnh nhân sang ngôn ngữ bạn đọc thạo
Các bước kích hoạt (5 phút)
Bước 1 — Lấy khoá từ Google AI Studio
- Trình duyệt mở https://aistudio.google.com/app/apikey
- Đăng nhập bằng tài khoản Google (nên dùng tài khoản cá nhân, không dùng tài khoản bệnh viện)
- Nhấn "Create API key" → nhận chuỗi bắt đầu
AIza... - Chưa đóng tab, copy chuỗi đó
Bước 2 — Xác nhận bật billing (rất quan trọng)
- Nhấn vào key vừa tạo → hoặc cột trái "Billing" → bật billing
- Dù chỉ dùng gói miễn phí, Google yêu cầu project gắn thẻ tín dụng trước khi cấp quota bình thường
- Không bật billing → đăng ký sẽ thất bại (hiện lỗi "quota exceeded")
Bước 3 — Đăng ký khoá trong Doctor PWA
- Chuyển sang tab "✨ AI" ở dưới cùng (không phải Profile; BYOK đã chuyển từ Profile sang tab AI)
- Tìm thẻ "BYOK Gemini Key"
- Nhấn "Bật và nhập khoá"
- Đọc mục đích sử dụng → Tiếp tục
- Tick đủ ba mục đồng ý (dữ liệu gửi đến Google, bệnh viện cho phép, iRehab không chịu trách nhiệm phần Google xử lý) → Tiếp tục
- Dán
AIza...→ nhấn "Lưu khoá" - Thành công sẽ thấy chỉ báo xanh "Đã cấu hình (có thể dùng)"
Lỗi đăng ký thường gặp
| Thông báo | Lý do | Cách xử lý |
|---|---|---|
| Định dạng không hợp lệ | Copy-paste có khoảng trắng thừa hoặc thiếu ký tự | Copy lại toàn bộ AIza... |
| Khoá không hợp lệ hoặc đã bị thu hồi | Khoá bị xoá hoặc giới hạn quyền | Quay lại AI Studio tạo khoá mới |
| Hết quota | Quota Google bị kích hoạt | Đợi 1–2 phút / kiểm tra billing / thay khoá |
| Lỗi phản hồi Google | Định dạng phản hồi Google bất thường | Đợi 1 phút; nếu lặp lại, báo kỹ thuật |
| Dịch vụ tạm thời không ổn định | KMS backend iRehab tạm thời không sẵn sàng | Đợi 1 phút rồi thử lại |
| Thử quá nhiều lần | Hơn 20 lần đăng ký trong 1 giờ | Đợi 1 giờ |
Cách dùng sau khi kích hoạt
Mở thẻ bệnh nhân trong danh sách tiền tư vấn → khu vực Path B sẽ có thêm nút "Dịch chủ than" (chỉ hiện khi ngôn ngữ CC của bệnh nhân ≠ ngôn ngữ UI của bạn). Nhấn sẽ gửi chủ than đến API Gemini của chính bạn, trong vài giây sẽ hiển thị bản dịch một dòng trên thẻ.
Quan trọng:
- Bản dịch là hỗ trợ đọc, không ghi đè dòng S của HIS; dòng S vẫn dán tóm tắt điện tín gốc
- Nguyên văn bệnh nhân được giữ 100% trong hồ sơ — không sửa, không tóm tắt, không viết lại
- Bản dịch chỉ chạy khi bạn bấm — không tự động kích hoạt. Bạn quyết định khi nào dịch
Đảm bảo bảo mật (IT bệnh viện có thể hỏi)
- Khoá không bao giờ rời khỏi trình duyệt của bạn + backend iRehab; không vào log / thông báo lỗi / hệ thống hỗ trợ
- Lưu trữ backend dùng Google KMS envelope encryption (mã hoá hai lớp); ngay cả kỹ sư iRehab cũng không thể đọc trực tiếp
- Mỗi lần giải mã khoá đều ghi Google Cloud Audit Log (có thể truy vết nếu dùng bất thường)
- Máy chủ iRehab không lưu nội dung phản hồi LLM; kết quả dịch chỉ hiển thị trên trình duyệt của bạn
- Bạn có thể nhấn "Gỡ khoá" trong tab AI bất cứ lúc nào — secret mã hoá trên backend xoá ngay
- Nhật ký sử dụng lịch sử được giữ lại để kiểm toán, không xoá
Cần nói gì với IT bệnh viện
- Dữ liệu đi qua HTTPS đến Google Gemini API (
generativelanguage.googleapis.com) - Mỗi lần gửi chỉ chứa văn bản chủ than của bệnh nhân — không có tên, CCCD, mã bệnh án
- Chính sách lưu giữ phía Google: đường dẫn API thương mại, không dùng để huấn luyện mô hình (có cam kết hợp đồng)
- Nếu chính sách bệnh viện cấm, IT báo với trưởng khoa — chúng tôi sẽ tắt tính năng cho toàn cơ sở từ backend