Brief — Hướng dẫn thao tác dành cho bác sĩ

Vì sao có cuốn cẩm nang này

Tính năng Brief 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.

Trước khi bắt đầu: thiết lập lần đầu (đưa bảng hỏi của bạn lên hoạt động)

Quy trình hằng ngày bên dưới (từ Mục 1 trở đi) giả định bảng hỏi của bạn đã lên hoạt động. Nếu đây là lần đầu bạn thiết lập, hãy hoàn tất 6 bước sau trước — khoảng 15 phút, trong đó vài bước do đội De Novo thực hiện giúp bạn.

Chúng tôi cố ý thiết kế theo nguyên tắc thử trước, quyết định sau: bạn sẽ tự điền bảng hỏi một lần với vai trò bệnh nhân (hoặc xem qua bản nháp trước), thấy ổn mới chính thức bật lên. Không cần ký hợp đồng hay thanh toán trước khi làm việc này.

Lấy tài khoản (theo lời mời). iRehab hoạt động theo cơ chế mời. Liên hệ đội De Novo, chúng tôi sẽ kích hoạt tài khoản bác sĩ bằng email của bạn rồi gửi cho bạn một liên kết mời đăng ký. Nếu chuyên khoa của bạn cần bảng hỏi tuỳ chỉnh (ví dụ: Sản Phụ khoa gộp ba bảng Phụ khoa, Sản khoa, Niệu Phụ khoa thành một), chúng tôi sẽ gửi trước cho bạn một trang xác nhận để bạn xem từng câu một, sau đó bạn tổng hợp quyết định gửi lại để chúng tôi chốt bản (thường qua 1–2 lần chỉnh sửa qua lại).
Đăng ký tài khoản bác sĩ. Mở liên kết mời rồi điền thông tin tại doctor.denovortho.com/#/register (email phải trùng với lời mời; điền đúng chuyên khoa). ⚠️ Nhất định phải dùng liên kết mời — tự mở trang đăng ký riêng sẽ thiếu mã mời.
Xác nhận bảng hỏi của bạn trong Composer. Đăng nhập Doctor PWA, mở trình soạn bảng hỏi (Composer), và kiểm tra từng câu khớp với bản bạn đã chốt.
Tạo QR trong Dispatch Center. Sau khi xác nhận ổn, vào Dispatch Center, tạo mã QR cho bảng hỏi rồi in ra dán ở phòng khám hoặc quầy tiếp tân. (Một áp phích dùng lại được nhiều lần — không cần in lại mỗi ngày; xem Mục 1 bên dưới.)
Tự mình thử điền trước (dogfood). Dùng điện thoại quét mã QR của chính bạn, điền bảng hỏi từ đầu đến cuối với vai trò bệnh nhân. Đây là bước kiểm tra cuối cùng trước khi lên hoạt động chính thức — bạn sẽ thấy đúng trải nghiệm điền form thực tế của bệnh nhân.
Quay lại tab Brief để xem kết quả. Bản test bạn vừa điền sẽ xuất hiện trong danh sách Brief khoảng 30 giây sau — mở ra là bản tóm tắt có cấu trúc mà bạn sẽ nhận được cho bệnh nhân thật. Thấy đúng là xong; việc sử dụng hằng ngày bắt đầu từ Mục 1 bên dưới.

Sau khi thiết lập xong, quy trình hằng ngày rất đơn giản: bệnh nhân quét QR trên áp phích để điền bảng hỏi, còn bạn đọc lướt qua danh sách Brief là xong (xem chi tiết ở Mục 1–2 bên dưới).

1. Chuẩn bị trước khám: tạo áp phích QR trong Dispatch Center

Mở Doctor PWA (doctor.denovortho.com) và đăng nhập
Vào tab Dispatch Center
Tìm mẫu bảng hỏi chuyên khoa của bạn, nhấn Generate poster QR
Nhấn Print A4 poster để mở bản xem trước A4, rồi in hoặc lưu 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
Một áp phích có thể dùng lại (mặc định ~200 lần hoặc 60 ngày); tự động hết hạn khi đạt giới hạn hoặc hết thời hạn, và có thể tạo lại hoặc thu hồi bất cứ lúc nào
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 Brief

Sau khi bệnh nhân gửi biểu mẫu, hồ sơ xuất hiện trong danh sách "Brief" 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:

Nút kết thúc	Hệ thống sẽ làm gì
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 AQ.Ab...
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 AQ.Ab... → 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ộ `AQ.Ab...`
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 Brief → 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