Làm việc ngoại tuyến & đồng bộ

Mạng phòng khám đôi khi chập chờn, và mất điện làm router ngưng hoạt động — nhưng buổi khám vẫn phải tiếp tục. Ứng dụng DentIQ được thiết kế để không làm mất dữ liệu lâm sàng khi rớt mạng: bạn vẫn xem được hồ sơ đã tải, vẫn lưu được ghi nhận và ảnh, rồi hệ thống tự đồng bộ khi có mạng trở lại.

1. Xem được gì khi ngoại tuyến

• Patient 360 của những bệnh nhân bạn đã mở khi còn mạng — thông tin, dòng thời gian, tóm tắt lượt khám và kế hoạch ở bản đã đồng bộ gần nhất.
• Hồ sơ lượt khám / ghi nhận lâm sàng đã tải trước đó, kèm các chỉnh sửa bạn vừa lưu ngoại tuyến (hiển thị ngay nhờ lớp phủ hàng đợi).
• Màn hình báo rõ "Đang ngoại tuyến — hiển thị dữ liệu đã đồng bộ" để bạn biết đây là bản lưu, không phải dữ liệu mới nhất.

Bệnh nhân chưa từng mở khi online sẽ hiện "Không có dữ liệu ngoại tuyến" — không phải lỗi, chỉ là chưa có bản lưu trên máy.

2. Lưu được gì khi ngoại tuyến

• Sinh hiệu & ghi nhận lâm sàng (snapshot lượt khám): mạch, huyết áp, ghi chú, tiến triển, khám tổng quát…
• Đóng lượt khám (kết thúc buổi khám).
• Chụp ảnh bệnh nhân — ảnh được lưu trên máy và xếp hàng chờ tải lên; thư viện ảnh hiển thị ngay với nhãn "chờ tải lên".

Khi lưu ngoại tuyến, ứng dụng báo "Đã lưu ngoại tuyến — sẽ đồng bộ khi có mạng" và xem như thành công; thay đổi nằm an toàn trong hàng đợi trên thiết bị.

3. KHÔNG dùng được khi ngoại tuyến

• Thu tiền / thanh toán và hoá đơn điện tử — liên quan tiền, cần server.
• Ký / chấp nhận kế hoạch điều trị — phát sinh nghĩa vụ tài chính.
• Đặt lịch / dời lịch hẹn — dễ xung đột chỗ trống.
• Quay video lâm sàng — cần kết nối (tệp quá lớn để xếp hàng an toàn trên trình duyệt).
• Đăng nhập lần đầu và dữ liệu của bệnh nhân chưa mở khi online.

4. Đồng bộ diễn ra thế nào

• Tự động khi mạng trở lại và khi bạn mở lại ứng dụng. Hệ thống kiểm tra máy chủ thật sự trả lời trước khi gửi (tránh nhầm "có sóng nhưng không vào được server").
• Thủ công: vào màn hình "Offline & đồng bộ" bấm "Đồng bộ ngay".
• Số thay đổi đang chờ hiển thị dạng huy hiệu; khi còn mục chờ, ứng dụng nhắc "Đừng đóng ứng dụng cho đến khi đồng bộ xong".
• Ảnh được tải trước, rồi tới các ghi nhận tham chiếu ảnh — đúng thứ tự nên không lỗi thiếu ảnh.

5. Khi có xung đột (hai người sửa cùng lúc)

Trong phòng khám, mỗi bệnh nhân thường do một bác sĩ phụ trách tại một thời điểm nên xung đột hiếm. Nếu vẫn xảy ra (ví dụ một lượt khám bị sửa trên máy khác trong lúc bạn ngoại tuyến), khi đồng bộ áp dụng "bản ghi sau thắng" đối với ghi nhận lượt khám: bản mới nhất trên máy chủ được giữ, và ứng dụng báo cho bạn biết thay đổi ngoại tuyến nào không được áp dụng — không âm thầm ghi đè mất.

6. An toàn dữ liệu

• Hàng đợi thay đổi được lưu bền vững trên thiết bị (cơ sở dữ liệu cục bộ), nên sống sót qua việc đóng app, khởi động lại máy hay mất điện — không phải bộ nhớ tạm.
• Dữ liệu chờ đồng bộ nằm trên thiết bị của bạn cho tới khi lên server thành công, sau đó được dọn đi.

7. Khác biệt giữa bản gốc và bản web (PWA)

• Ứng dụng gốc (điện thoại/máy tính bảng): hỗ trợ ngoại tuyến đầy đủ cho ảnh; video vẫn cần mạng.
• Bản web PWA: hỗ trợ ngoại tuyến cho ảnh; không xếp hàng video ngoại tuyến (giới hạn bộ nhớ trình duyệt).
• Trình duyệt có thể tự dọn bộ nhớ khi máy gần đầy. Vì vậy trên web, hãy đồng bộ sớm sau khi có mạng lại, đừng để hàng đợi tồn lâu.

8. Mẹo & xử lý sự cố

• Mở trước hồ sơ khi còn mạng để có sẵn bản lưu offline cho buổi khám.
• Đồng bộ kẹt và báo "Cần đăng nhập lại để đồng bộ": phiên đã hết hạn khi ngoại tuyến lâu — đăng nhập lại, hàng đợi vẫn còn nguyên và sẽ gửi tiếp.
• Còn mục chờ: giữ ứng dụng mở tới khi huy hiệu về 0; trên web đừng đóng tab giữa chừng.
• Báo bộ nhớ đầy: đồng bộ những gì đang chờ rồi mới chụp thêm.
• Sau khi mạng ổn định, kéo làm mới để chắc màn hình hiển thị dữ liệu mới nhất từ máy chủ.

Thêm tình huống sự cố khác: xem Xử lý sự cố.