8health docs

Hướng dẫn sử dụng

Tài liệu thao tác nhanh cho đơn vị khám sức khỏe: tạo đơn vị, nhập hồ sơ, quét CCCD/QR, hoàn thiện giấy KSK, tải file đính kèm và xuất dữ liệu.

Tổng quan quy trình

1. Tạo đơn vịĐăng nhập Google, tạo đơn vị, cam kết sử dụng đúng mục đích, sau đó vào trang sửa đơn vị để bổ sung cấu hình.
2. Cấu hình giấy KSKThiết lập dòng tiêu đề, địa điểm ký, người kết luận, chữ ký trong suốt và mẫu DOCX nếu có.
3. Nhập hồ sơNhập thủ công, quét CCCD bằng Hanel, quét QR VNeID bằng camera hoặc máy quét QR.
4. Hoàn thiện giấy KSKMở giấy KSK HTML, chỉnh các ô vàng, chọn phân loại, upload ảnh 4x6, tải DOCX hoặc in/PDF.
5. Đính kèm tài liệuTải ảnh/file vào hồ sơ, in tem QR để người dân hoặc nhân viên scan và upload nhanh.
6. Xuất dữ liệuXuất DOCX hàng loạt, JSON hoặc Excel. Dữ liệu giấy KSK được xuất kèm label tiếng Việt rõ nghĩa.

Bắt đầu sử dụng

  1. Đăng nhập bằng tài khoản Google.
  2. Nếu chưa có đơn vị, hệ thống sẽ yêu cầu tạo đơn vị. Bấm TIẾP TỤC sau khi nhập các thông tin tối thiểu và xác nhận cam kết.
  3. Sau khi tạo, hệ thống chuyển sang trang Sửa thông tin đơn vị để bổ sung cấu hình chi tiết.
  4. Khi có nhiều đơn vị, vào Quản lý đơn vị để chọn đơn vị đang dùng.
  5. Vào Hồ sơ khám sức khỏe để nhập hoặc xem danh sách hồ sơ.
Dữ liệu hồ sơ, tài khoản máy quét, thành viên và cấu hình giấy KSK được tách theo từng đơn vị.

Quản lý đơn vị

Thông tin cần cấu hình

  • Tên đơn vị: dùng để nhận diện đơn vị và mặc định cho dòng dưới của giấy KSK khi tạo mới.
  • Dòng trên giấy KSK: mặc định là SỞ Y TẾ NGHỆ AN.
  • Dòng dưới giấy KSK: nên là tên đơn vị in trên giấy khám sức khỏe.
  • Địa điểm ký: để trống nếu muốn người dùng tự nhập trên phiếu.
  • Người kết luận: tên bác sĩ/người kết luận mặc định ở chân trang giấy KSK.
  • Chữ ký: tải ảnh chữ ký, hệ thống tự crop, đổi PNG và tách nền.

Thành viên trong đơn vị

  • Chủ sở hữu có thể thêm người dùng bằng Gmail.
  • Thành viên được thêm sẽ thấy và thao tác trên dữ liệu của đơn vị đó.
  • Khi không dùng nữa có thể xóa thành viên khỏi đơn vị.

Xóa đơn vị

Xóa đơn vị sẽ xóa đơn vị, thành viên và toàn bộ hồ sơ gắn với đơn vị đó. Hệ thống yêu cầu gõ lại tên đơn vị để tránh xóa nhầm.

Mở quản lý đơn vị

Nhập và quản lý hồ sơ

Nhập thủ công

  1. Bấm Nhập mới.
  2. Nhập thông tin hành chính cần thiết.
  3. Lưu hồ sơ, sau đó mở chi tiết để bổ sung file hoặc giấy KSK.

Danh sách hồ sơ

  • Tìm theo CCCD, họ tên, điện thoại hoặc địa chỉ.
  • Lọc theo độ tuổi: tất cả, từ 18 tuổi trở lên, dưới 18 tuổi.
  • Bấm vào dòng hồ sơ để xem chi tiết.
  • Các nút nhanh: Giấy KSK, Tải DOCX, Tải PDF, Tải file lên.

Giấy khám sức khỏe HTML/DOCX

Chọn mẫu tự động

Hệ thống tự chọn mẫu giấy KSK theo ngày sinh: dưới 18 tuổi hoặc từ đủ 18 tuổi trở lên. Nếu đơn vị đã tải mẫu DOCX riêng, hệ thống ưu tiên dùng mẫu riêng của đơn vị.

Chỉnh trên HTML

  • Các ô nền vàng là dữ liệu có thể chỉnh và sẽ tự lưu.
  • Có nút Phân loại I nhanh để đặt nhanh các mục phân loại lâm sàng về Loại I.
  • Ảnh 4x6 có thể chọn trực tiếp trong giấy KSK.
  • Chân trang dùng cấu hình đơn vị: địa điểm ký, ngày tháng, người kết luận và chữ ký.

Chữ ký người kết luận

  • Vào Sửa đơn vị → Mặc định chân trang giấy KSK.
  • Bấm Thêm chữ ký, chọn ảnh chữ ký.
  • Ảnh được convert về PNG, giảm kích thước đủ dùng, crop và tách nền tự động.
  • Preview nền ca rô giúp kiểm tra phần trong suốt.

Tải/in biểu mẫu

  • Tải DOCX: tải file Word theo mẫu hiện tại.
  • In/PDF: in trực tiếp từ HTML hoặc lưu PDF bằng trình duyệt.
  • Xóa điền lại: xóa dữ liệu đã chỉnh trên giấy KSK để quay về dữ liệu mặc định.

File đính kèm và tem QR

  • Trong danh sách hoặc chi tiết hồ sơ, bấm Tải file lên để thêm ảnh, PDF, Word, Excel hoặc file liên quan.
  • Ảnh được hiển thị dạng gallery trong chi tiết hồ sơ.
  • Mỗi hồ sơ có QR đính kèm riêng để mở trang upload nhanh.
  • Bấm In tem để in tem QR dán lên phiếu/tài liệu. Khi scan tem, người dùng có thể tải file vào đúng hồ sơ.
  • File đính kèm có thể mở hoặc xóa trong chi tiết hồ sơ.

Cài đặt máy quét CCCD Hanel

Mỗi đơn vị có endpoint, username và password riêng để phần mềm Hanel gửi dữ liệu CCCD đúng vào đơn vị đang dùng.

Tải phần mềm máy quét

Tải IDCheckSetup_v1.0_251125.zip
  1. Vào Quản lý đơn vị, mở mục Tài khoản API Hanel.
  2. Bấm Copy toàn bộ cấu hình hoặc copy riêng Endpoint, Username, Password.
  3. Cài phần mềm Hanel trên máy tính kết nối đầu đọc CCCD.
  4. Mở Thiết lập cấu hình, bật Run as service, chọn Xuất file dữ liệu, rồi bấm Cài đặt lấy dữ liệu gốc.
  5. Dán endpoint vào ô Webhook, nhập username/password, chọn Gửi sau khi đọc thẻ.
  6. Bấm Lưu thông tin, mở trang Quét CCCD của đơn vị và quét thử CCCD.
Màn hình thiết lập cấu hình máy quét CCCD
Bước 1: mở Thiết lập cấu hình và chọn Cài đặt lấy dữ liệu gốc.
Màn hình cấu hình webhook và tài khoản máy quét
Bước 2: nhập Webhook, tài khoản, mật khẩu và chọn gửi sau khi đọc thẻ.
Nếu reset mật khẩu máy quét, cần cập nhật lại mật khẩu trong phần mềm Hanel. Mật khẩu cũ sẽ hết hiệu lực.

Quét QR VNeID/CCCD

Quét bằng camera

  1. Mở Quét QR bằng camera.
  2. Cho phép trình duyệt sử dụng camera.
  3. Đưa QR vào khung quét. Hệ thống sẽ đọc CCCD và mở/tạo hồ sơ.

Quét bằng máy quét QR

  1. Mở Quét QR bằng máy quét.
  2. Đặt con trỏ vào ô nhập nếu cần.
  3. Quét QR trên VNeID/CCCD. Máy quét sẽ nhập chuỗi QR vào hệ thống.

Xuất dữ liệu

  • DOCX: xuất hàng loạt giấy khám sức khỏe theo bộ lọc hiện tại, đóng gói thành file ZIP.
  • JSON: xuất hồ sơ và dữ liệu giấy KSK. JSON có fields theo key kỹ thuật, field_labels để đọc label tiếng Việt, và fields_labeled dạng label → giá trị.
  • Excel: xuất hồ sơ cùng toàn bộ trường giấy KSK, tiêu đề cột dùng label tiếng Việt rõ nghĩa.
  • Các nút xuất trên trang danh sách sẽ áp dụng bộ lọc tìm kiếm/độ tuổi đang chọn.

Lưu ý sử dụng

  • 8health được phát triển miễn phí nhằm hỗ trợ cộng đồng trong công tác khám sức khỏe và quản lý hồ sơ sức khỏe đúng quy định.
  • Người tạo đơn vị cần có thẩm quyền tạo và quản lý thông tin đơn vị.
  • Chỉ sử dụng dữ liệu cho mục đích khám sức khỏe hợp pháp; không kinh doanh, trục lợi, mua bán hoặc chia sẻ trái phép dữ liệu.
  • Kiểm tra lại thông tin trước khi in, ký, đóng dấu hoặc gửi dữ liệu ra ngoài hệ thống.
  • Không chia sẻ tài khoản API Hanel/mật khẩu máy quét cho người không có trách nhiệm.