📖 Hướng Dẫn Sử Dụng

Cách khôi phục mật khẩu (dành cho người dùng)

Yêu cầu để sử dụng tính năng này

• Tài khoản của bạn phải có địa chỉ email được thiết lập sẵn
• Nếu tài khoản chưa có email, liên hệ Admin để bổ sung

Admin: Xử lý khi người dùng không có email

Nếu tài khoản không có email:

1. Vào Admin → Users
2. Tìm tài khoản người dùng
3. Thêm địa chỉ email hợp lệ
4. Hoặc Admin có thể reset password trực tiếp ngay trên trang quản lý người dùng

Tổng quan

Chức năng Bulk Import Users cho phép quản trị viên tạo hàng chục hoặc hàng trăm tài khoản chỉ trong vài phút bằng cách upload file CSV.

Cách sử dụng

username,fname,lname,facility_name
bacsi1@clinic.vn,Nguyễn,Văn A,Phòng khám Test
bacsi2@clinic.vn,Trần,Thị B,Phòng khám Test

Thiết lập mặc định cho tài khoản mới

Tính năng này dùng khi nào?

• 🔁 Thuốc dài hạn: Bệnh nhân tái khám, cấp thuốc hàng tháng
• 📋 Đơn tái cấp: Thuốc mãn tính (tiểu đường, huyết áp…)
• 👥 Đơn mẫu: Thuốc dùng cho nhiều bệnh nhân
• ⚖️ Điều chỉnh liều: Sao chép rồi chỉ sửa liều/số lượng

Cách sao chép đơn thuốc

Ví dụ thực tế

Tái cấp thuốc tiểu đường hàng tháng

1. Vào hồ sơ bệnh nhân
2. Xem đơn thuốc tháng trước (Metformin 500mg)
3. Nhấn Copy → Xác nhận OK
4. Kiểm tra thông tin (không cần sửa) → Nhấn Lưu
5. In đơn cho bệnh nhân → Hoàn tất trong 10 giây

Tăng liều huyết áp

1. Sao chép đơn cũ (Amlodipine 5mg x1)
2. Sửa số lượng: 1 → 2
3. Sửa hướng dẫn: "Uống 1 viên/ngày" → "Uống 2 viên/ngày"
4. Thêm ghi chú → Nhấn Lưu

Sau khi sao chép

• Đơn mới được lưu với ngày hôm nay
• Tự động trừ kho thuốc (nếu bật tính năng)
• Có thể in đơn, tạo PDF, hiển thị QR code

Tính năng này giải quyết vấn đề gì?

Cách sử dụng

Ví dụ minh họa

Nhập "alphachymotripsine"

Dropdown "in-house" hiển thị:

  -- or select from inventory --    ← mặc định

  alpha_chuan [NDC123]              ← In đậm, khớp ✓
  alpha_chuan 2 [NDC456]            ← In đậm, khớp ✓
  ─────────────────────────
  alu_chuan [NDC789]                ← Xám, không khớp
  paracetamol_500 [NDC345]          ← Xám, không khớp

Cách A – Ký từng phiếu khám

Cách B – Ký tất cả phiếu khám cùng lúc (MỚI)

Phiếu nào được ký tự động?

Xử lý lỗi phổ biến

Modal không đóng sau khi nhập mật khẩu

1. Mở DevTools (F12) → Tab Console
2. Nếu thấy "The password you entered is invalid" → Kiểm tra lại mật khẩu
3. Thử đăng xuất và đăng nhập lại
4. Vẫn lỗi → Liên hệ Admin

Nút "Ký tất cả" không hiện

• Tất cả phiếu đã được ký → Không cần ký thêm
• Encounter không có phiếu nào
• Tài khoản không có quyền write → Liên hệ Admin

Hai chế độ ghi âm

Kiểm tra nhanh chế độ đang dùng

Vào bất kỳ form nào (SOAP/Messages) và xem số nút hiển thị:

• 1 nút MIC 🎤 → Đang ở chế độ Voice-to-Text
• 1 nút CASSETTE ⏺️ → Đang ở chế độ File Recording (AI)
• 2 nút → Đang ở chế độ Both

Cách thay đổi chế độ ghi âm (Admin)

Hướng dẫn sử dụng ghi âm

Chế độ Voice-to-Text (nút MIC 🎤)

1. Trong biểu mẫu SOAP hoặc Messages, click nút 🎤 MIC
2. Trình duyệt yêu cầu quyền microphone → Click Allow/Cho phép
3. Nói rõ ràng vào microphone
4. Văn bản xuất hiện ngay lập tức trong ô nhập liệu
5. Click nút MIC lần nữa để dừng

Chế độ File Recording (nút CASSETTE ⏺️)

1. Click nút ⏺️ CASSETTE để bắt đầu ghi
2. Nói nội dung cần ghi
3. Click nút lần nữa để dừng và upload file
4. File âm được gửi đến AI để xử lý
5. Kết quả transcription trả về sau 22:00 cùng ngày

Tổng quan

Chế độ Đào tạo (Education Mode) biến hệ thống OpenEMR thành môi trường đào tạo lâm sàng. Khi bật, menu "Đào tạo" xuất hiện trên thanh điều hướng chính với đầy đủ công cụ:

• 🏥 Bệnh nhân ảo: Hồ sơ bệnh nhân giả lập cho mục đích đào tạo
• 📝 Kịch bản lâm sàng: Case studies điển hình
• 📊 Báo cáo đào tạo: Theo dõi tiến độ và kết quả học viên
• 🔒 Tách biệt dữ liệu: Dữ liệu đào tạo không ảnh hưởng bệnh nhân thực

Cấu trúc menu Đào tạo

Đào tạo
├── Bảng Điều Khiển Đào Tạo    → Trang tổng quan thống kê
├── Bệnh Nhân Ảo               → Quản lý hồ sơ giả lập
├── Kịch Bản Lâm Sàng          → Tạo và quản lý case studies
└── Báo Cáo Đào Tạo            → Xem báo cáo và đánh giá

Bật Chế Độ Đào Tạo (Admin)

$education_mode = 1;  // 1 = bật, 0 = tắt

Bảng Điều Khiển Đào Tạo

Truy cập: Đào tạo → Bảng Điều Khiển Đào Tạo

Dashboard chia thành các phần:

Quy trình sử dụng

Truy cập chức năng

• Từ menu: Click "Đào tạo" → Chọn "Quản lý kịch bản"
• Từ dashboard: Education Management → "Kịch Bản Lâm Sàng" → Click "Scenario Library" (xem) hoặc "Create Scenario" (tạo mới)

Tạo câu hỏi mới

Phân loại câu hỏi

Điểm nổi bật

• ✅ Giao cho cả lớp một lần – không cần giao từng người
• ✅ Mỗi học viên nhận bài khác nhau – ngẫu nhiên hoàn toàn
• ✅ Cùng chủ đề, cùng thời hạn – dễ quản lý

Bước 1: Quản lý lớp học

Truy cập: Education Dashboard → Quản Lý Sinh Viên → "Manage Classes"

Tạo lớp mới

1. Click "Create New Class"
2. Điền Tên lớp (VD: "Lớp A", "Khóa 2026") và mô tả
3. Click "Create Class"

Thêm học viên vào lớp

1. Click vào lớp muốn thêm học viên
2. Kéo xuống phần "Add Students"
3. Chọn học viên từ dropdown → Click "Add to Class"

Bước 2: Giao bài cho lớp

Truy cập: Education Dashboard → Quản Lý Sinh Viên → "Assign to Class"

Cách hoạt động

• 📅 Ngày 1: 5 câu của Bệnh nhân A
• 📅 Ngày 2: 5 câu của Bệnh nhân B
• 📅 Ngày 3: 5 câu của Bệnh nhân C…
• ⏱️ Mỗi bài có thời hạn 7 ngày kể từ ngày giao
• 🎲 Câu hỏi và bệnh nhân được chọn ngẫu nhiên
• ✅ Chỉ chọn bệnh nhân có ≥5 câu hỏi trong ngân hàng

Truy cập

Navigation: Education Mode → Education Dashboard → Kịch Bản Lâm Sàng → "Assign Scenarios"

Cách sử dụng

Xem kết quả sau khi giao

Hệ thống hiển thị bảng tóm tắt gồm:

• Danh sách ngày đã giao bài
• Bệnh nhân ảo được chọn mỗi ngày
• 5 câu hỏi đã giao (ID câu hỏi)
• Thời hạn nộp bài (7 ngày sau ngày giao)

Truy cập hệ thống

• Qua menu: Đăng nhập Admin → Admin → System → Backup & Storage Monitor
• Trực tiếp: /interface/main/backup_monitor.php

Dashboard – Bảng điều khiển

Hiển thị ngay khi vào trang, tự động cập nhật mỗi 30 giây:

Tạo Backup

Các loại backup

• 📁 Database Only: Chỉ sao lưu cơ sở dữ liệu
• 📂 Files Only: Chỉ sao lưu thư mục files/documents
• 💿 Full Backup: Sao lưu cả database và files (khuyến nghị)

Cách tạo backup

Thời gian ước tính

Quản lý lịch sử Backup

Bảng hiển thị 50 backup gần nhất:

Tổng quan

Full OpenEMR là ứng dụng web đầy đủ tính năng dành cho quản lý phòng khám. Đây là giao diện chính mà bác sĩ và nhân viên y tế sử dụng hàng ngày để thăm khám, kê đơn, ghi nhận xét nghiệm và quản lý hồ sơ bệnh nhân.

Đăng nhập

Giao diện chính

Sau khi đăng nhập, màn hình chính hiển thị:

Quản lý bệnh nhân

Thêm bệnh nhân mới

Tìm kiếm bệnh nhân

Sử dụng ô tìm kiếm ở góc trên bên phải. Gõ tên, mã bệnh nhân hoặc số điện thoại → Enter. Kết quả hiển thị danh sách với các thao tác: Hồ sơ, Khám mới, Lịch sử.

Khám bệnh — Encounter

Sinh hiệu (Vitals)

Trong mỗi lượt khám, click tab Sinh hiệu để nhập:

Kê đơn thuốc (Prescriptions)

Xét nghiệm (Labs)

Để yêu cầu xét nghiệm: Trong lượt khám → Tab Xét nghiệm → Chọn loại xét nghiệm → Điền thông tin → Lưu. Kết quả xét nghiệm sẽ được cập nhật sau khi phòng lab hoàn thành.

Thanh toán (Billing)

Tab Thanh toán cho phép tạo hóa đơn, theo dõi công nợ và in biên lai. Hỗ trợ nhiều hình thức thanh toán: tiền mặt, chuyển khoản, bảo hiểm y tế.

Báo cáo

Menu Báo cáo cung cấp các mẫu báo cáo có sẵn: báo cáo bệnh nhân theo thời gian, doanh thu, thuốc đã kê, bệnh theo ICD-10. Xem thêm tại mục Báo cáo & Thống kê.

Quản lý thuốc — Kho

Menu Quản trị → Thuốc cho phép quản lý danh mục thuốc, tồn kho, nhập/xuất, theo dõi hạn sử dụng. Hỗ trợ ánh xạ mã MOH (Bộ Y tế) và tạo mẫu đơn thuốc (prescription templates).

Ký điện tử phiếu khám

Trong mỗi phiếu khám (SOAP, Khám lâm sàng, Sinh hiệu), click nút eSign và nhập mật khẩu để ký. Có thể ký tất cả phiếu chưa ký cùng lúc bằng nút "Ký tất cả phiếu khám". Xem hướng dẫn chi tiết tại mục Ký điện tử.

Tổng quan

Desktop App là ứng dụng React SPA (Single Page Application) dành cho máy tính, cung cấp giao diện hiện đại, trực quan và nhanh. Ứng dụng chia sẻ cùng backend với Full OpenEMR nhưng được thiết kế tinh gọn, tập trung vào các tác vụ chính.

Đăng nhập

Giao diện — Sidebar

Sau khi đăng nhập, thanh sidebar bên trái hiển thị các mục chính:

Quản lý bệnh nhân

Danh sách bệnh nhân

Click Danh Sách BN → Hiển thị danh sách bệnh nhân với các cột: STT, Họ tên, Ngày sinh, Giới tính, Số điện thoại, Địa chỉ. Có thể tìm kiếm theo tên hoặc số điện thoại.

Thêm bệnh nhân mới

Chi tiết bệnh nhân

Click vào một bệnh nhân trong danh sách → Mở trang chi tiết với các tab:

Khám nhanh (Quick Encounter)

Công cụ (Tools)

Click Công Cụ trên sidebar để mở menu các công cụ hỗ trợ:

• 🤖 AI Chat: Chat với AI y khoa (Gemma4) — hỗ trợ tra cứu, tư vấn
• 🔢 Tra mã ICD-10: Tìm kiếm mã bệnh theo ICD-10
• 🏷️ Tra mã Site Codes: Tra cứu mã nội bộ
• 📐 BMI Calculator: Tính chỉ số BMI
• 📷 QR Scanner: Quét mã QR bệnh nhân

Cấu hình hệ thống

Desktop App kết nối qua các API endpoints:

• auth.php — Xác thực đăng nhập (POST với {username, password})
• patients.php — Quản lý bệnh nhân
• encounters.php — Quản lý lượt khám
• prescriptions.php — Quản lý đơn thuốc
• tools.php — Công cụ AI, ICD-10

Tổng quan

Mobile App là ứng dụng PHP được thiết kế dành riêng cho thiết bị di động. Giao diện gọn nhẹ, thanh điều hướng dưới cùng giúp thao tác nhanh bằng một tay. Tích hợp đầy đủ các công cụ AI: OCR, Dictation, AI Chat, Tóm tắt y bạ.

Đăng nhập

Giao diện — Bottom Navigation

Thanh điều hướng dưới cùng gồm 5 mục:

Quản lý bệnh nhân

Tìm kiếm bệnh nhân

Click Bệnh Nhân → Ô tìm kiếm ở đầu trang. Gõ tên, số điện thoại hoặc mã bệnh nhân. Kết quả hiển thị dạng danh sách, click vào để xem chi tiết.

Tạo bệnh nhân mới

Chi tiết bệnh nhân

Gồm các tab:

• Thông tin — Hồ sơ cá nhân, bảo hiểm
• Lượt khám — Danh sách và tạo lượt khám mới
• Đơn thuốc — Kê đơn, xem lịch sử
• Tài liệu — Upload và xem tài liệu, hình ảnh, kết quả xét nghiệm

Khám nhanh (Quick Encounter)

Công cụ Mobile

Click Công Cụ (🔧) để mở danh sách tools:

Báo cáo Mobile

Trang Báo Cáo trên Mobile cung cấp 4 loại báo cáo với biểu đồ Chart.js:

• 📊 Bệnh nhân — Thống kê bệnh nhân theo thời gian
• 💊 Đơn thuốc — Thống kê thuốc đã kê
• 🦠 Bệnh — Thống kê bệnh theo ICD-10
• 📈 Xu hướng khám — Biểu đồ số lượt khám theo ngày

Tổng quan

Portal V2 là ứng dụng Vue 3 SPA dành cho bệnh nhân. Bệnh nhân có thể đăng nhập, xem hồ sơ sức khỏe, đặt lịch hẹn, xem kết quả xét nghiệm, nhắn tin với bác sĩ và thanh toán trực tuyến.

Đăng nhập

Bệnh nhân có 2 cách đăng nhập:

Các trang chính

Đặt lịch hẹn

Upload tài liệu với OCR

Nhật ký sức khỏe

Bệnh nhân có thể ghi nhật ký sức khỏe hàng ngày: chỉ số đường huyết, huyết áp, cân nặng, triệu chứng. Dữ liệu được biểu diễn dưới dạng biểu đồ để theo dõi xu hướng.

Tra cứu thuốc

Chức năng Medication Lookup cho phép bệnh nhân tra cứu thông tin thuốc: công dụng, liều dùng, tác dụng phụ, tương tác thuốc.

Cấu hình tính năng (Admin)

Các tính năng Portal có thể bật/tắt theo site:

Tổng quan

Master Admin là ứng dụng quản trị trung tâm dành cho Admin hệ thống. Từ đây, Admin có thể quản lý nhiều site (phòng khám), người dùng toàn hệ thống, giám sát hiệu năng, tạo backup và triển khai cập nhật.

Đăng nhập

Dashboard — Bảng điều khiển

Sau khi đăng nhập, dashboard hiển thị tổng quan hệ thống:

Quản lý Site

Menu Sites Management cho phép:

• Tạo site mới — Cấu hình phòng khám mới với đầy đủ package
• Chỉnh sửa site — Thay đổi cấu hình, package, giới hạn dung lượng
• Xóa site — Vô hiệu hóa hoặc xóa hoàn toàn
• Provisioning — Tự động tạo cấu hình site, database, thư mục

Quản lý người dùng

Menu Users cho phép quản lý người dùng trên tất cả các site:

• Xem danh sách người dùng toàn hệ thống
• Thêm/sửa/xóa người dùng
• Đặt lại mật khẩu
• Phân quyền theo ACL
• Import hàng loạt từ CSV

Giám sát (Monitoring)

Mục Monitoring cung cấp:

• 📈 Biểu đồ CPU, RAM, Disk của server
• 📊 Thống kê số lượt khám theo site, theo thời gian
• ⏱️ Thời gian phản hồi API trung bình
• 🔔 Lịch sử cảnh báo và sự kiện hệ thống

27 công cụ quản trị (Admin Tools)

Truy cập: /ba/master/admin/tools/. Đây là bộ công cụ mạnh mẽ dành cho Admin:

Email System

Master Admin quản lý toàn bộ hệ thống email:

• Queue Management — Xem hàng đợi email, gửi lại email lỗi
• Templates — Tạo và chỉnh sửa mẫu email (quên mật khẩu, xác nhận lịch hẹn...)
• SMTP Config — Cấu hình SMTP server cho từng site

Backup & Khôi phục

Xem hướng dẫn chi tiết tại mục Backup & Storage Monitor. Từ Master Admin có thể tạo backup cho bất kỳ site nào và theo dõi tiến độ tập trung.

Giới thiệu

BA Clinic tích hợp các công cụ AI mạnh mẽ chạy trên nền tảng GPU, hỗ trợ bác sĩ trong nhiều tác vụ lâm sàng. Các công cụ AI hoạt động xuyên suốt trên tất cả nền tảng: Desktop App, Mobile App, Full OpenEMR và Portal V2.

Danh sách công cụ AI

Kiến trúc AI

Các công cụ AI hoạt động theo mô hình client-server:

• Client (Mobile/Desktop/Portal) gửi request đến API endpoint
• API Proxy: /api/ai-tools/ocr-proxy.php — nhận request, chuyển đến AI server
• AI Server GPU: Xử lý mô hình (DeepSeek OCR / Gemma4) và trả kết quả

Hướng dẫn chi tiết

Click vào các mục bên dưới để xem hướng dẫn cụ thể cho từng công cụ:

Tổng quan

Tính năng OCR (Optical Character Recognition) cho phép chụp ảnh hoặc upload hình ảnh tài liệu y tế, hệ thống AI (dựa trên Qwen2.5-VL-3B) sẽ tự động nhận dạng và trích xuất văn bản.

Các loại tài liệu hỗ trợ

Cách sử dụng trên Mobile

Cách sử dụng trên Portal V2

Cách sử dụng trên Desktop

API OCR

Endpoint: POST /api/ai-tools/ocr-proxy.php

• Body: multipart/form-data với file ảnh
• Kết quả: JSON chứa văn bản nhận dạng

Tổng quan

Tính năng Dictation (Chép chính tả) cho phép bác sĩ nói nội dung khám bệnh, hệ thống tự động chuyển thành văn bản và điền vào form SOAP hoặc tin nhắn. Hỗ trợ 2 chế độ: thời gian thực (Web Speech API) và AI chỉnh sửa sau (Gemma4).

Hai chế độ ghi âm

Sử dụng Dictation trên Mobile

Sử dụng Dictation trên Full OpenEMR

Trong giao diện Full OpenEMR, tính năng ghi âm được tích hợp vào tất cả các textarea qua speech-module. Khi click vào ô nhập liệu, nút MIC 🎤 xuất hiện ngay cạnh ô:

Sử dụng Dictation trên Desktop App

Trên Desktop App (React SPA), dictation có thể truy cập qua Công Cụ → AI Chat với chế độ correct (chỉnh sửa dictation). Hoặc qua API tools.php.

Lưu ý khi sử dụng

• Nói rõ ràng, tốc độ vừa phải, không nói quá nhanh
• Sử dụng trong môi trường yên tĩnh để giảm nhiễu
• Kết quả Web Speech API có thể không hoàn hảo → sử dụng AI Correct để cải thiện
• Luôn kiểm tra lại văn bản trước khi lưu

Tổng quan

AI Chat là công cụ chat với AI y khoa dựa trên mô hình Gemma4. Bác sĩ có thể đặt câu hỏi về chẩn đoán, phác đồ điều trị, tương tác thuốc, tra cứu ICD-10 và nhiều hơn nữa. Công cụ có sẵn trên Desktop, Mobile và Full OpenEMR.

Các chế độ AI Chat

Sử dụng AI Chat trên Mobile

Sử dụng AI Chat trên Desktop

Sử dụng AI Chat trên Full OpenEMR

Trong Full OpenEMR, AI Chat có thể truy cập qua menu hoặc tích hợp trong các form nhập liệu.

AI Tóm tắt y bạ (Mobile)

Tính năng AI Tóm tắt y bạ (tool-summarize.php) tự động rút gọn hồ sơ bệnh án của bệnh nhân thành bản tóm tắt ngắn gọn, bao gồm:

• 🆔 Thông tin bệnh nhân: Tên, tuổi, giới tính, mã bệnh nhân
• 📋 Tiền sử bệnh: Bệnh nền, dị ứng, phẫu thuật trước đây
• 💊 Thuốc đang dùng: Danh sách thuốc hiện tại, liều dùng
• 📊 Kết quả xét nghiệm gần nhất: Các chỉ số quan trọng
• 📝 Kết luận: Chẩn đoán chính, kế hoạch điều trị

Ví dụ câu hỏi cho AI Chat

Tổng quan

Hệ thống cung cấp nhiều loại báo cáo và thống kê trực quan, giúp bác sĩ và quản lý nắm bắt tình hình hoạt động của phòng khám. Báo cáo có sẵn trên tất cả các nền tảng: Desktop, Mobile, Full OpenEMR và Master Admin.

Báo cáo trên Desktop App

Truy cập: Click Báo Cáo trên sidebar → Trang báo cáo hiển thị các thống kê và biểu đồ.

Báo cáo trên Mobile App

Mobile App cung cấp 4 loại báo cáo với biểu đồ Chart.js: vào Trang Chủ → Chọn loại báo cáo từ danh sách.

1. Báo cáo Bệnh nhân

Thống kê số bệnh nhân theo ngày trong tháng. Biểu đồ cột hiển thị số lượng bệnh nhân mới mỗi ngày. Hỗ trợ xem chi tiết khi click vào từng cột.

2. Báo cáo Đơn thuốc

Danh sách thuốc được kê nhiều nhất, kèm số lượng và tần suất. Hữu ích để quản lý tồn kho và dự báo nhu cầu thuốc.

3. Báo cáo Bệnh

Thống kê bệnh theo mã ICD-10. Xem được bệnh nào xuất hiện nhiều nhất, phân bố theo giới tính và độ tuổi.

4. Báo cáo Xu hướng khám

Biểu đồ đường thể hiện xu hướng số lượt khám theo thời gian. Giúp nhận biết mùa cao điểm và lập kế hoạch nhân sự.

Báo cáo trên Full OpenEMR

Menu Báo cáo trong Full OpenEMR cung cấp đầy đủ các mẫu báo cáo chuẩn của OpenEMR:

• Báo cáo lâm sàng: Danh sách bệnh nhân theo chẩn đoán, thuốc đã kê
• Báo cáo tài chính: Doanh thu, công nợ, thanh toán
• Báo cáo nhân sự: Số lượt khám theo bác sĩ, hiệu suất làm việc
• Báo cáo bảo hiểm: Thống kê bệnh nhân bảo hiểm y tế
• Báo cáo ICD-10: Phân bố bệnh theo mã ICD-10

Báo cáo trên Master Admin

Master Admin cung cấp dashboard tổng quan với thống kê theo từng site. Cho phép Admin so sánh hiệu suất giữa các phòng khám, xem tổng dung lượng, số người dùng và cảnh báo toàn hệ thống.

Xuất báo cáo

Hầu hết các báo cáo đều hỗ trợ xuất dữ liệu:

• 📄 In trực tiếp: In từ trình duyệt
• 📊 Xuất PDF: Tải báo cáo dạng PDF
• 📑 Xuất CSV/Excel: Tải dữ liệu thô để phân tích

Tùy chỉnh khoảng thời gian

Tổng quan

Hệ thống Workers là các tiến trình (daemon) và tác vụ cron chạy nền, đảm bảo các xử lý tự động diễn ra liên tục: xử lý AI, transcribe ghi âm, đồng bộ đơn thuốc, merge dữ liệu và nhiều tác vụ khác.

Danh sách Workers

Quản lý Workers

Dùng script run.sh để quản lý tất cả workers:

Xem trạng thái

cd /ba/workers/
bash run.sh status

Hiển thị danh sách worker và trạng thái: 🟢 running hoặc 🔴 stopped.

Khởi động tất cả workers

bash run.sh start

Dừng tất cả workers

bash run.sh stop

Khởi động lại

bash run.sh restart

Chi tiết từng Worker

EMR Processor

Worker quan trọng nhất — xử lý tất cả tác vụ AI: OCR nhận dạng văn bản, AI Chat, tóm tắt y bạ. Chạy dưới dạng daemon với cơ chế cron dự phòng mỗi 3 phút. Nếu daemon gặp sự cố, cron sẽ khởi động lại.

• Đọc hàng đợi từ database
• Gửi request đến AI server GPU
• Lưu kết quả vào database
• Ghi log chi tiết vào /ba/workers/logs/

Recorder Processor

Xử lý các file ghi âm từ chế độ Cassette ⏺️. Khi bác sĩ ghi âm bằng nút Cassette, file âm thanh được lưu và đưa vào hàng đợi. Recorder Processor lấy file, gửi đến AI transcribe và lưu kết quả.

Intake Processor

Chạy dưới dạng daemon riêng cho mỗi site (phòng khám). Xử lý dữ liệu tiếp nhận: đăng ký bệnh nhân mới, cập nhật thông tin từ cổng thông tin, đồng bộ dữ liệu từ các nguồn bên ngoài.

Merge Worker

Chạy mỗi 2 phút, tự động phát hiện và gộp các hồ sơ bệnh nhân trùng lặp dựa trên tên, ngày sinh và số điện thoại. Ghi log chi tiết để Admin kiểm tra.

Transcribe Audio

Chạy mỗi 5 phút, kiểm tra các file ghi âm chưa được xử lý. Gửi file đến AI speech-to-text và cập nhật kết quả vào form SOAP tương ứng.

Prescription Sync

Chạy mỗi 30 phút, đồng bộ dữ liệu đơn thuốc giữa các hệ thống (Desktop, Mobile, Full). Đảm bảo đơn thuốc mới tạo trên nền tảng nào cũng xuất hiện trên các nền tảng khác.

Kiểm tra Logs

Log của workers được ghi tại:

ls -la /ba/workers/logs/

Xem log gần nhất:

tail -f /ba/workers/logs/emr_processor.log
tail -f /ba/workers/logs/recorder.log

Xử lý sự cố

Tổng quan

CodeFinder là hệ thống tra cứu mã y tế thông minh, hỗ trợ tìm kiếm ICD-10, ICPC2, CPT, và mã dịch vụ. Cache 3 tầng cho tốc độ tra cứu nhanh.

Cách sử dụng Mobile

Trên Desktop

Vào 🛠️ Công Cụ → Tra ICD-10. Giao diện tìm kiếm tương tự, hỗ trợ gõ ≥2 ký tự để bắt đầu tìm.

Mã hỗ trợ