Hướng dẫn sử dụng phần mềm quanlyphongmach

Tài liệu hướng dẫn nghiệp vụ của phần mềm quản lý phòng khám hộ kinh doanh. Chọn mục ở cột bên trái, hoặc gõ từ khoá vào ô tìm kiếm.

Mỗi người bệnh đi qua các khâu, mỗi khâu do 1 bộ phận phụ trách:

1. Thu ngân→2. Bác sĩ→3. Cận lâm sàng→4. Nhà thuốc

Lưu ý: hướng dẫn mô tả các chức năng đang dùng được. Ảnh chụp màn hình và hướng dẫn riêng cho Lịch, Tổng quan sẽ được bổ sung sau.

Bắt đầu

Đăng nhập

Mọi người dùng

Mỗi phòng khám có địa chỉ riêng dạng tenphongkham.quanlyphongmach.com. Tài khoản do Quản trị viên của phòng khám tạo.

  1. Mở địa chỉ phần mềm của phòng khám.
  2. Nhập Tên đăng nhập và Mật khẩu, bấm Đăng nhập.
  3. Phần mềm tự mở màn hình chính theo vai trò của bạn (vd Thu ngân mở màn hình Thu ngân).
Lưu ý: nhập sai mật khẩu nhiều lần, tài khoản có thể bị khoá tạm thời (theo cài đặt Bảo mật). Quản trị viên mở khoá được ngay ở Quản trị › Người dùng.

Giao diện chung, tài khoản và đổi mật khẩu

Mọi người dùng

  1. 1 Thanh menu bên trái: chỉ hiện các trang bạn được cấp quyền. Muốn thêm trang, nhờ Quản trị viên cấp quyền ở Vai trò. Link Hướng dẫn sử dụng ở cuối menu mở tài liệu này.
  2. 2 Tài khoản (góc dưới menu): bấm để Đổi mật khẩu hoặc Thoát (đăng xuất).
  3. Các bảng dữ liệu đều có ô tìm kiếm dưới tiêu đề cột, bấm tên cột để sắp xếp, chọn số dòng mỗi trang ở cuối bảng.

Thu ngân và tiếp đón

Tiếp đón khách và đăng ký khám (tab Danh sách)

Thu ngân, lễ tân

  1. Vào Thu ngân, tab Danh sách: bảng khách hàng của phòng khám.
  2. Tìm khách theo tên, mã khách, số điện thoại hoặc CCCD. Nút Quét CCCD đọc mã QR trên căn cước bằng camera, hoặc gõ số CCCD (9 hoặc 12 số, phần mềm kiểm tra lại ở máy chủ). Khách chưa có CCCD có nút Cập nhật CCCD.
  3. Khách mới: bấm Thêm khách và nhập hồ sơ.
  4. Bấm Đăng ký khám ở dòng của khách, chọn dịch vụ khám và nhập lý do khám để tạo lượt khám.
  5. Bấm In số thứ tự đưa khách nếu phòng khám dùng số thứ tự.
Lưu ý: mỗi dịch vụ thuộc một mã số thuế (MST) đã gắn sẵn trong Danh mục. Thu ngân không phải chọn MST khi đăng ký khám.

Thu tiền và phiếu thu theo MST (tab Đã đăng ký)

Thu ngân

  1. Vào tab Đã đăng ký. Danh sách lọc theo ngày đăng ký lượt khám và theo trạng thái; số tiền hiện theo từng MST.
  2. Ở dòng của khách bấm Thanh toán TM (tiền mặt) hoặc Thanh toán CK (chuyển khoản). Chuyển khoản hiện mã QR riêng cho tài khoản ngân hàng của từng MST.
  3. Phần mềm tạo mỗi MST một phiếu thu với số riêng. Bấm Xem hoặc In để xem, in phiếu cho khách.

Khách chuyển khoản thì lượt ở trạng thái chờ chuyển khoản. Khi tiền về, bấm Đã nhận tiền (hoặc Xem QR để đưa lại mã cho khách); khách đổi ý thì bấm Huỷ để nhả khoản đang giữ chỗ.

Thanh toán hàng loạt: tick nhiều dòng rồi bấm thanh toán tiền mặt hoặc chuyển khoản một lần, tối đa 50 lượt mỗi lần. Lượt nào đã thu, đã giữ chỗ chuyển khoản hoặc lỗi thì được bỏ qua và báo trong bảng kết quả, các lượt còn lại vẫn chạy bình thường.

Giao dịch ngân hàng chưa khớp lượt nào được xem ở Kế toán › Báo cáo › Đối chiếu ngân hàng.

Lưu ý: bấm hai lần hoặc hai máy cùng thu một lượt thì chỉ một lần được ghi, lần còn lại báo đã xử lý. Phòng khám đặt khám trước hay sau khi trả tiền ở Quản trị › Chính sách thu tiền.

Hoàn tiền từng dòng và hoàn tác phiếu thu

Thu ngân, quản lý

  1. Vào tab Đã đăng ký, mở Xem lượt cần xử lý. Bấm in lại nếu khách cần bản khác.
  2. Muốn trả một phần: chọn Hoàn tiền ở đúng dòng, nhập số lượng và lý do (huỷ dịch vụ, khách yêu cầu, trả hàng / thuốc, tính sai tiền).
  3. Muốn trả toàn bộ lượt: bấm Hoàn tác phiếu thu, nhập lý do và xác nhận.

Phần mềm lập phiếu chi hoàn tiền riêng cho từng MST, phiếu thu gốc giữ nguyên. Có thể hoàn tác nhiều lượt cùng lúc (tối đa 50 lượt).

Chú ý: hoàn tác phiếu thu luôn hoàn 100% số đã thu và không thu lại được trên cùng lượt; muốn thu tiếp phải đăng ký khám mới. Chỉ định chưa thực hiện bị huỷ theo, dòng thuốc đã phát thì không hoàn tác được. Không sửa hay xoá phiếu thu đã lập; mọi chỉnh sửa tiền đều làm bằng phiếu hoàn mới. Trả thuốc có thể chọn nhập lại kho hoặc huỷ hàng.

Ca thu ngân và đối chiếu két tiền

Thu ngân

  1. Đầu ca vào tab Ca thu ngân, mở ca.
  2. Cuối ca đếm tiền mặt trong két theo từng MST và nhập vào.
  3. Phần mềm so với tiền mặt dự kiến từ sổ quỹ do chính bạn ghi trong ca. Lệch thì phải ghi lý do.

Ca chỉ để ghi nhận và đối chiếu. Chưa mở ca vẫn thu tiền bình thường.

Lịch hẹn tái khám

Thu ngân, bác sĩ

Tab Lịch hẹn liệt kê các hẹn sắp tới. Bác sĩ hẹn tái khám ngay trong màn khám, thu ngân gọi nhắc khách và đánh dấu đã gọi, hoặc huỷ hẹn khi khách báo không đến.

Khám bệnh

Hàng chờ và mở lượt khám

Bác sĩ

Mỗi bộ phận (Nội, Ngoại, Sản, Nhi) có hàng chờ riêng, tự làm mới khoảng 10 giây một lần. Các nhóm chính:

  • Chờ khám: khách đã đủ điều kiện (đã trả phí khám nếu phòng khám thu trước).
  • Chờ đóng phí khám (màu xám): khách chưa trả, chỉ để biết, chưa mở khám được.
  • Đang khám, Chờ kết quả, Có kết quả: theo tiến độ cận lâm sàng.

Bấm vào một khách để mở màn khám.

Màn khám: sinh hiệu, chẩn đoán, chỉ định

Bác sĩ

  1. Nhập sinh hiệu, lý do khám, bệnh sử và kết quả khám.
  2. Chọn chẩn đoán ICD-10 (gõ mã hoặc tên bệnh).
  3. Thêm chỉ định cận lâm sàng (xét nghiệm, siêu âm, X-quang, điện tim, thủ thuật). Việc nào bạn tự làm thì bấm Tôi thực hiện, kết quả nhập ngay trong màn khám.
  4. Xem lịch sử lượt khám và kết quả cũ của khách ở cùng màn hình.

Kê đơn, hẹn tái khám, in phiếu

Bác sĩ

  1. Mục kê đơn: chọn thuốc, số lượng, đơn vị và cách dùng. Có thể dùng đơn mẫu. Màn hình báo tồn kho của thuốc đang chọn.
  2. Đặt hẹn tái khám nếu cần.
  3. In phiếu khám và đơn thuốc cho khách.
Lưu ý: đơn đã ký chuyển sang Nhà thuốc. Tiền thuốc do nhà thuốc hay thu ngân thu tuỳ cài đặt ở Chính sách thu tiền.

Cận lâm sàng

Hàng chờ của từng phòng

Kỹ thuật viên CLS, bác sĩ

Siêu âm, Xét nghiệm, X-quang, Điện tim và Thủ thuật mỗi nơi một hàng chờ riêng:

  • Chờ thực hiện: chỉ định đã đủ điều kiện làm.
  • Chờ thu tiền: khách chưa trả, hiện rõ lý do. Chưa làm cho đến khi khách trả (hoặc có người được phép cho làm trước kèm lý do).
  • Đang làm, Xong hôm nay.

Nhập, sửa và in kết quả

Kỹ thuật viên CLS, bác sĩ

  1. Mở chỉ định trong hàng chờ.
  2. Nhập kết quả: văn bản (theo mẫu) hoặc bảng chỉ số xét nghiệm có cờ cao / thấp. Đính kèm ảnh hoặc PDF nếu có.
  3. Lưu và in kết quả.
Chú ý: sửa kết quả đã lưu sẽ tạo phiên bản mới, bản cũ vẫn xem lại được. Không có thao tác xoá kết quả.

Nhà thuốc và kho

Phát thuốc theo đơn

Dược sĩ

  1. Vào Nhà thuốc, tab Phát thuốc & bán lẻ. Hàng chờ gồm đơn đã trả tiền và đơn cần thu tiền tại quầy thuốc.
  2. Mở đơn, kiểm thuốc. Phần mềm gợi ý lô theo nguyên tắc hết hạn trước, xuất trước.
  3. Nếu nhà thuốc thu tiền thì thu ngay tại đây (phiếu thu cũng tách theo MST).
  4. Xác nhận phát. Thiếu hàng thì phát một phần, đơn còn lại nằm ở nhóm chờ phát.

Bán lẻ

Dược sĩ

Tab Bán lẻ: quét mã vạch hoặc gõ tên thuốc để thêm vào giỏ, kiểm các thuốc cần kê đơn, thu tiền và in phiếu. Bán lẻ không tính vào lượt khám.

Kho, nhập hàng, kiểm kê, chuyển kho

Dược sĩ, quản lý kho

  • Kho: tồn theo lô và hạn dùng. Biểu tượng cảnh báo cho thuốc cận hạn hoặc dưới tồn tối thiểu.
  • Nhập hàng: tạo phiếu nhập từ nhà cung cấp, ghi đơn vị, số lô, hạn dùng và giá nhập.
  • Kiểm kê: đếm tồn thực tế và đối chiếu với sổ kho.
  • Chuyển kho: chuyển hàng giữa hai MST của cùng phòng khám. Lập phiếu nháp rồi ghi sổ, lô được giữ nguyên số lô, hạn và giá vốn.
Lưu ý: sổ kho chỉ ghi thêm dòng mới. Nhập nhầm thì làm bút toán điều chỉnh, không xoá dòng cũ.

Kế toán, báo cáo và danh mục

Sổ quỹ, phiếu thu chi tay, công nợ

Kế toán

  • Sổ quỹ: mọi khoản thu chi tiền mặt và ngân hàng, tách theo MST.
  • Phiếu thu/chi tay: ghi khoản phát sinh ngoài bán hàng (tiền điện, thuê mặt bằng...). Ghi nhầm thì lập phiếu đảo.
  • Công nợ NCC: tiền còn nợ nhà cung cấp theo từng phiếu nhập.
  • Loại chi phí: danh sách loại chi phí dùng khi chi. Phòng khám cũ bấm Thêm loại chi phí mẫu để có bộ mặc định.

Báo cáo theo MST và danh mục

Quản trị viên, kế toán

Mọi báo cáo tiền ở Báo cáo có bộ chọn Tổng thể (cả phòng khám) hoặc từng MST. Doanh thu lấy từ phiếu thu trừ phiếu hoàn. Có báo cáo doanh thu, sổ phiếu thu, hoàn tiền, sổ quỹ, xuất nhập tồn, cận hạn, tồn tối thiểu, công nợ NCC và cảnh báo ngưỡng doanh thu năm của từng MST.

Danh mục (Hàng hoá, Nhóm hàng, Chỉ số XN, Khách hàng, Nhà cung cấp, Tài khoản ngân hàng, Lý do): mỗi hàng hoá và dịch vụ gắn với một MST. Đổi MST hay giá trong danh mục chỉ áp dụng cho lần bán sau, phiếu đã lập không đổi.

Lưu ý: thêm MST và tài khoản ngân hàng của từng MST ở Quản trị › Mã số thuế. Cài đặt khám trước hay thu sau ở Quản trị › Chính sách thu tiền.

Quản trị

Người dùng: thêm tài khoản, mở khoá, đặt lại mật khẩu

Quản trị viên

  1. Vào Quản trị, tab Người dùng, bấm 1 Thêm người dùng.
  2. Nhập tên đăng nhập, họ tên, vai trò (Thu ngân, Bác sĩ, Kỹ thuật viên cận lâm sàng, Dược sĩ, Kế toán hoặc vai trò tự thêm), điện thoại, mật khẩu, lưu.
  3. Trên từng tài khoản: Sửa, Phân quyền (cấp quyền Xem/Sửa từng trang riêng cho người này), Reset mật khẩu, Mở khoá ngay (khi bị khoá do nhập sai mật khẩu), Xoá / Khôi phục.

Vai trò: quyền Xem / Sửa từng trang

Quản trị viên

  1. Tab Vai trò: bảng trang × vai trò, mỗi vai trò có 2 cột: Xem (mở trang, xem dữ liệu) và Sửa (thêm/sửa/xoá dữ liệu trên trang). Tích Sửa tự tích Xem; bỏ Xem tự bỏ Sửa.
  2. Bấm Thêm vai trò để tạo vai trò mới (vd Trưởng phòng). Vai trò hệ thống (nền xám) không sửa/xoá được.
  3. Quản trị viên luôn có toàn quyền. Người chỉ có quyền Xem vẫn mở được trang nhưng thao tác lưu/sửa/xoá sẽ bị từ chối.

Cài đặt hệ thống

Quản trị viên

Tab Cài đặt hệ thống chia nhóm theo trang: Chung, Lễ tân, Bác sĩ, Thu ngân, Kho, Phiếu in, Bảo mật. Một số cài đặt hay dùng:

  • Thu ngân: nhiều hình thức thanh toán trên 1 phiếu, mã QR chuyển khoản, giảm giá trên hoá đơn.
  • Kho: số ngày cảnh báo hết hạn.
  • Phiếu in: số bản in, in phiếu thu dạng PDF.
  • Bảo mật: độ dài và độ khó mật khẩu, khoá tài khoản khi đăng nhập sai nhiều lần.

Thông tin cơ sở, cước tháng này

Quản trị viên

Tab Thông tin cơ sở: tên phòng khám, địa chỉ, điện thoại, logo (in trên phiếu). Dòng trên cùng cho biết số lượt khám và cước tạm tính tháng này, số dư ví.

Chú ý: mục Vùng nguy hiểm › Xóa toàn bộ dữ liệu đưa phần mềm về trắng hoàn toàn (chỉ giữ tài khoản admin đang đăng nhập), không khôi phục được.

Nhật ký truy cập

Quản trị viên

Tab Nhật ký ghi lại đăng nhập, tạo/sửa tài khoản và các thao tác quan trọng: ai làm, làm gì, lúc nào.

Gợi ý AI

Bật gợi ý AI

Quản trị viên

Vào Quản trị › AI. Có hai nguồn AI:

  • API key của bên thứ 3: OpenAI, Google Gemini, Anthropic Claude, DeepSeek hoặc OpenRouter. Dán API key, bấm Tải danh sách model để chọn model.
  • MedGemma tự chạy (máy chủ của phòng khám): phòng khám tự chạy MedGemma, nhập địa chỉ máy chủ (https, tên miền công khai), API key của máy chủ đó và tên model (gợi ý medgemma-1.5-4b-it). quanlyphongmach không vận hành máy chủ AI. Cách cài và đưa máy chủ ra https: xem Cài MedGemma trên máy của phòng khám và Đưa MedGemma ra https bằng Cloudflare Tunnel.
  1. Chọn nguồn AI, nhập API key (hoặc địa chỉ máy chủ) và model.
  2. Đọc khung lưu ý màu vàng, tích ô đồng ý (đổi nhà cung cấp phải đồng ý lại).
  3. Bật Bật gợi ý AI cho bác sĩ rồi bấm Lưu. Bấm Kiểm tra kết nối để thử.
Chú ý: khách hàng tự chịu trách nhiệm về bảo mật thông tin khách hàng khi dùng gợi ý AI. API key được lưu mã hoá và không hiện lại sau khi lưu.

Cài MedGemma trên máy của phòng khám

Quản trị viên · làm một lần, cần người quen dùng máy tính

MedGemma là mô hình AI y khoa của Google. Phòng khám tự cài trên một máy luôn bật (máy trạm hoặc máy chủ nhỏ), rồi nối với phần mềm ở Quản trị › AI. quanlyphongmach không cài và không vận hành máy chủ AI thay phòng khám.

Cần cóGợi ý
MáyWindows, macOS hoặc Linux; RAM trống từ 8 GB (nên 16 GB); ổ cứng trống 10 GB. Có card đồ hoạ rời hoặc Mac chip Apple thì trả lời nhanh hơn nhiều.
MạngInternet lần đầu để tải mô hình (khoảng 3–5 GB). Sau đó máy chỉ cần Internet để nối ra Cloudflare ở bước tiếp theo.
Thời gian trả lờiMáy chỉ có CPU có thể mất vài phút một lượt. Phần mềm chờ tối đa khoảng 2 phút, quá thì báo lỗi; máy yếu nên dùng bản nhỏ (4B, lượng tử hoá Q4) như dưới đây.

Cách A (khuyên dùng): llama-server, có API key

llama-server đặt được API key ngay từ đầu, nên khi đưa ra Internet chỉ ai biết key mới gọi được.

  1. Cài llama.cpp. macOS (cần Homebrew): mở Terminal, gõ lệnh dưới. Windows: mở PowerShell, gõ lệnh dưới. Nếu lệnh không chạy, tải bản dựng sẵn ở trang github.com/ggml-org/llama.cpp/releases.
    # macOS
    brew install llama.cpp
    
    # Windows (PowerShell)
    winget install llama.cpp
    Đóng cửa sổ lệnh, mở lại, gõ llama-server --version để chắc chắn đã cài.
  2. Tạo API key: một chuỗi ngẫu nhiên dài (từ 32 ký tự), chỉ gồm chữ và số. Chép lại, lát nữa dùng hai lần. Không dùng chữ dễ đoán như tên phòng khám.
    # macOS / Linux
    openssl rand -hex 24
    
    # Windows (PowerShell)
    -join ((48..57)+(97..122) | Get-Random -Count 40 | ForEach-Object {[char]$_})
  3. Chạy máy chủ MedGemma (thay KHOA_API bằng key vừa tạo). Lần đầu máy tải mô hình nên phải chờ; thấy dòng báo máy chủ đang lắng nghe là xong. Giữ nguyên cửa sổ này.
    llama-server -hf unsloth/medgemma-1.5-4b-it-GGUF:UD-Q4_K_XL --alias medgemma-1.5-4b-it --host 127.0.0.1 --port 8080 --api-key KHOA_API
    --host 127.0.0.1 nghĩa là chỉ chính máy này gọi được; đường hầm ở bước sau chạy cùng máy nên vẫn nối được. --alias đặt tên model là medgemma-1.5-4b-it, đúng tên phần mềm gợi ý.
  4. Thử trên chính máy đó (mở cửa sổ lệnh thứ hai). Trên Windows PowerShell gõ curl.exe thay cho curl.
    curl http://127.0.0.1:8080/v1/models -H "Authorization: Bearer KHOA_API"
    Thấy kết quả có chữ medgemma-1.5-4b-it là máy chủ chạy tốt. Bỏ phần -H ... thì phải bị từ chối (lỗi 401).
Lưu ý: tắt cửa sổ lệnh hoặc khởi động lại máy thì MedGemma dừng; chạy lại lệnh ở bước 3. Muốn tự chạy mỗi khi bật máy, nhờ kỹ thuật viên đặt lệnh đó thành dịch vụ khởi động cùng hệ điều hành.
Ảnh cận lâm sàng: bản tải ở trên thường kèm phần đọc ảnh. Nếu AI báo không đọc được ảnh, để tắt tuỳ chọn Gửi kèm ảnh cận lâm sàng; gợi ý bằng chữ vẫn dùng bình thường.

Cách B: Ollama (dễ cài hơn, nhưng không có API key)

Cài Ollama từ ollama.com/download, rồi mở cửa sổ lệnh:

ollama run medgemma1.5

Lệnh này tải bản medgemma1.5:4b-it-q4_K_M (khoảng 3,3 GB). Ollama lắng nghe ở http://localhost:11434; tên model nhập vào phần mềm là medgemma1.5:4b-it-q4_K_M (bấm Tải danh sách model để chọn đúng tên).

Chú ý: Ollama không có API key. Nếu đưa thẳng ra Internet bằng đường hầm, ai biết địa chỉ cũng gọi được và dùng máy của phòng khám. Muốn dùng Ollama, phải thêm lớp bảo vệ (nhờ kỹ thuật viên); nếu không thì dùng cách A.

Đưa MedGemma ra https bằng Cloudflare Tunnel

Quản trị viên · làm sau khi máy MedGemma đã chạy

Phần mềm quanlyphongmach chạy trên máy chủ trên Internet nên không với tới địa chỉ trong mạng của phòng khám (localhost, 192.168.x.x, http://...) và sẽ báo "Chỉ nhận địa chỉ https". Cloudflare Tunnel giải quyết việc này: máy MedGemma tự nối ra ngoài tới Cloudflare và nhận về một địa chỉ https://... công khai. Không cần mở cổng trên modem, không cần IP tĩnh.

Cần có: tài khoản Cloudflare (gói Free) và một tên miền đã quản lý ở Cloudflare (vd tenphongkham.vn). Dưới đây dùng địa chỉ ai.tenphongkham.vn làm ví dụ.

  1. Đăng nhập dash.cloudflare.com, mở Zero Trust (lần đầu chọn gói Free, làm theo các bước Cloudflare hiện ra).
  2. Vào Networks › Tunnels (có thể nằm trong Networks › Connectors), bấm Create a tunnel, chọn Cloudflared, đặt tên (vd medgemma-phong-kham), bấm Save tunnel.
  3. Chọn đúng hệ điều hành của máy chạy MedGemma, chép lệnh Cloudflare hiện ra và chạy trên máy đó. Lệnh này cài cloudflared thành dịch vụ tự chạy cùng máy. Khi trạng thái chuyển thành Connected, bấm Next.
  4. Ở phần Public hostname: Subdomain ai; Domain chọn tên miền của bạn; Service type HTTP; URL localhost:8080 (cách A) hoặc localhost:11434 (cách B). Mở Additional application settings › HTTP Settings, ở HTTP Host Header điền đúng cổng đó (vd localhost:8080); cách B bắt buộc điền, không thì Ollama trả lỗi 403. Bấm Save.
  5. Thử từ ngoài: dùng máy khác hoặc điện thoại tắt wifi (dùng 4G).
    curl https://ai.tenphongkham.vn/v1/models -H "Authorization: Bearer KHOA_API"
    Thấy danh sách có medgemma-1.5-4b-it là đúng. Không gửi key thì phải bị từ chối (401).
  6. Điền vào phần mềm: vào Quản trị › AI, chọn nguồn MedGemma tự chạy (máy chủ của phòng khám).
    • Địa chỉ máy chủ: https://ai.tenphongkham.vn/v1 (nhớ có /v1 ở cuối).
    • API key của máy chủ: dán KHOA_API.
    • Bấm Tải danh sách model, chọn medgemma-1.5-4b-it.
    • Đọc khung lưu ý, tích ô đồng ý, bật Bật gợi ý AI cho bác sĩ, bấm Lưu, rồi Kiểm tra kết nối.
Chỉ để thử nhanh: không có tên miền thì chạy cloudflared tunnel --url http://localhost:8080 (cần cài cloudflared từ trang tải của Cloudflare). Cloudflare cấp địa chỉ https://....trycloudflare.com nhưng địa chỉ đổi mỗi lần chạy lại, không dùng cho phòng khám thật.
Chú ý bảo mật: dữ liệu đi qua Cloudflare nên Cloudflare có thể thấy nội dung gửi tới AI (phần mềm đã bỏ họ tên, số điện thoại, địa chỉ, số giấy tờ, ngày sinh khỏi nội dung gửi, xem Dữ liệu nào được gửi cho AI). Luôn đặt API key cho máy chủ MedGemma, không dùng key đơn giản, không chia sẻ địa chỉ và key ra ngoài. Nghi key bị lộ thì chạy lại llama-server với key mới và nhập lại ở Quản trị › AI.
Lưu ý: máy MedGemma tắt hoặc mất mạng thì gợi ý AI báo lỗi kết nối; các phần khác của phần mềm vẫn dùng bình thường.

Gợi ý AI báo lỗi: cách xử lý

Quản trị viên

Thông báo / hiện tượngNguyên nhân và cách xử lý
"Chỉ nhận địa chỉ https", "Không nhận địa chỉ IP"Bạn nhập http://, localhost hoặc IP mạng nội bộ. Bản đang dùng không nhận các địa chỉ này; làm theo Cloudflare Tunnel để có địa chỉ https.
Lỗi 401 hoặc 403API key sai hoặc thiếu. Nhập lại đúng key đã đặt cho llama-server. Nếu dùng Ollama mà bị 403, kiểm tra ô HTTP Host Header ở bước 4 của Cloudflare Tunnel.
Lỗi 502, 1033 hoặc "không kết nối được"Máy MedGemma đã tắt, llama-server đã dừng hoặc cloudflared mất kết nối. Mở lại cửa sổ chạy llama-server; kiểm tra tunnel ở Cloudflare đang Healthy / Connected.
Chờ lâu rồi báo hết thời gianMáy trả lời chậm hơn thời gian chờ (khoảng 2 phút). Dùng máy có card đồ hoạ, đóng bớt chương trình khác, hoặc dùng bản MedGemma nhỏ hơn.
Tải danh sách model trống, hoặc báo không có modelTên model sai. Với llama-server nhập medgemma-1.5-4b-it (đúng giá trị --alias); với Ollama chọn tên trong danh sách.
Đổi địa chỉ máy chủ rồi phải đồng ý lạiBình thường: sự đồng ý gắn với địa chỉ máy chủ, đổi địa chỉ thì tích đồng ý lại.

Dùng gợi ý AI ở màn khám

Bác sĩ

Sau khi nhận khám và nhập bệnh sử, sinh hiệu (và có kết quả cận lâm sàng nếu có), bấm Gợi ý chẩn đoán và thuốc ở bảng Gợi ý AI. AI mất khoảng 1–2 phút để phân tích.

  1. Đọc tóm tắt, chẩn đoán gợi ý (kèm mã ICD-10 trong danh mục), cận lâm sàng nên làm thêm, thuốc gợi ý, lời dặn và dấu hiệu cần chuyển viện.
  2. Ở bảng Chẩn đoán, hàng Gợi ý AI có nút chọn nhanh mã ICD-10; bấm để thêm, rồi bấm Lưu chẩn đoán như thường.
  3. Ở bảng Đơn thuốc (đơn nháp), hàng Thuốc AI gợi ý có nút thêm thuốc trong danh mục (kèm tồn kho, cách dùng và số ngày điền sẵn); thuốc kiểm soát chỉ hiện nhãn, kê tay.

Cũng có khung Hỏi AI để hỏi tự do về ca đang khám, và ở màn kết quả cận lâm sàng để gợi ý cách diễn đạt kết luận. Gợi ý gần nhất được lưu, tải lại trang vẫn thấy.

Lưu ý: gợi ý của AI chỉ để tham khảo. AI không tự ghi vào hồ sơ; bác sĩ kiểm tra lại và chịu trách nhiệm với chẩn đoán, đơn thuốc cuối cùng.

Dữ liệu nào được gửi cho AI

Mọi người dùng

Gửi: giới tính, tuổi, triệu chứng, sinh hiệu, chẩn đoán đã chọn, kết quả và ảnh cận lâm sàng (tối đa 3 ảnh, nếu bật), 3 lượt khám trước, kèm mã bệnh nhân dạng tên-phòng-khám-mã-khách.

Không gửi: họ tên (họ tên bác sĩ gõ trong hồ sơ được thay bằng mã), số điện thoại, địa chỉ, số giấy tờ, ngày sinh, mã lượt khám. Việc che thông tin chỉ làm được tốt nhất có thể; ảnh có thể có tên khách in trên phim. Kết quả gợi ý có cấu trúc được lưu trong hồ sơ lượt khám; câu hỏi và câu trả lời ở khung hỏi tự do không được lưu.