Chuyển tới nội dung chính

🔬 Chuyên ngành xét nghiệm & Đánh giá hợp chuẩn

Phòng thí nghiệm Xbook hoạt động theo mô hình đa chuyên ngành: addon lõi laboratory chạy luồng chung (yêu cầu → mẫu → phân tích → kết quả), còn mỗi chuyên ngành được cài thêm như một addon riêng. Nhóm chuyên ngành đánh giá (như An toàn thực phẩm — ATTP) bổ sung bộ đánh giá hợp chuẩn (đạt / không đạt) bằng cách so kết quả với ngưỡng cho phép (permissible limit theo TCVN / QCVN) đã khai trong dữ liệu chuẩn của chỉ tiêu.

💡 Addon chuyên ngành không thay đổi luồng lõi: bạn vẫn nhập yêu cầu, mẫu và kết quả như bình thường — phần hợp chuẩn được hệ thống tự tính thêm ngay khi có kết quả.

Các chuyên ngành được hỗ trợ​

Mỗi chuyên ngành là một cặp addon: addon laboratory_<ngành> (luồng nghiệp vụ) và addon dữ liệu chuẩn parameter_<ngành> (chỉ tiêu, ngưỡng). Cài chuyên ngành nào thì hệ thống nạp thêm năng lực của chuyên ngành đó.

Chuyên ngànhAddonNội dung
Hóa lý / Hóa sinhlaboratory_chemistryLuồng định lượng hóa phân tích (Hóa lý)
Vi sinhlaboratory_microbiologyĐếm khuẩn lạc (CFU) + định tính có/không (Vi sinh)
Huyết thanh họclaboratory_serologyLuồng xét nghiệm huyết thanh
Sinh học phân tửlaboratory_molecularLuồng xét nghiệm sinh học phân tử
An toàn thực phẩmlaboratory_foodChấm hợp chuẩn ATTP trên kết quả
Thức ăn chăn nuôilaboratory_feedChấm hợp chuẩn thức ăn chăn nuôi (TACN)
Vật liệu xây dựnglaboratory_constructionLuồng thử nghiệm vật liệu: dự án, bộ mẫu, kết quả theo công thức (LAS-XD)
Nước & Môi trườnglaboratory_environmentLuồng xét nghiệm nước và môi trường
Kháng sinh đồlaboratory_antibioticLuồng kháng sinh đồ

💡 Các chuyên ngành đo (như Hóa lý, Vi sinh) tạo ra giá trị kết quả; còn chuyên ngành đánh giá (như An toàn thực phẩm) không tự đo mà chấm điểm giá trị đó so với ngưỡng tiêu chuẩn.

Nguyên lý đánh giá hợp chuẩn​

Lấy chuyên ngành An toàn thực phẩm (laboratory_food) làm ví dụ điển hình. Khi cài addon này (cùng parameter_food), hệ thống bổ sung:

  1. Ngưỡng giới hạn trên dữ liệu chuẩn của chỉ tiêu — gồm cận dưới, cận trên và tiêu chuẩn viện dẫn.
  2. Cột hợp chuẩn (Food Conformity) trên dòng chỉ tiêu kết quả — tự cập nhật Đạt / Không đạt ngay khi nhập kết quả.

Hệ thống so giá trị kết quả với khoảng cho phép [cận dưới, cận trên]:

  • Kết quả nằm trong khoảng → Đạt (Pass).
  • Kết quả thấp hơn cận dưới → Không đạt (Fail), lý do “Dưới giới hạn thực phẩm” (Below food limit).
  • Kết quả vượt cận trên → Không đạt (Fail), lý do “Trên giới hạn thực phẩm” (Above food limit).
  • Chưa khai ngưỡng cho chỉ tiêu → N/A (không áp dụng).

💡 Cách chấm này áp dụng được cho cả kết quả định lượng và định tính: với kết quả định tính, giá trị là 1.0 (phát hiện) / 0.0 (không phát hiện), nên quy tắc “phải không có” chỉ cần đặt cận trên = 0.

⚠️ Hợp chuẩn được tính trên giá trị số chuẩn hóa của kết quả, không phải trên chuỗi hiển thị có kèm đơn vị (ví dụ chuỗi 2.5e+05 CFU/g). Hãy nhập đúng giá trị đo để hệ thống chấm chính xác.

Khai báo ngưỡng cho phép​

Ngưỡng giới hạn được khai trên dữ liệu chuẩn của chỉ tiêu (parameter), theo từng nền mẫu / sản phẩm.

  1. Mở Chỉ tiêu cần thiết lập ngưỡng (xem trang Chỉ tiêu).
  2. Vào tab An toàn thực phẩm (Food Safety).
  3. Tại nhóm Giới hạn cho phép (Permissible Limit), nhập Cận dưới (Food Limit Min) và Cận trên (Food Limit Max).
  4. Tại nhóm Viện dẫn (Reference), nhập Tiêu chuẩn thực phẩm (Food Standard) — tiêu chuẩn TCVN / QCVN được viện dẫn cho ngưỡng này.
  5. Lưu. Trường Giới hạn thực phẩm (Food Limit) sẽ tự hiển thị khoảng giá trị đã khai.

📷 Cần chèn ảnh: /img/modules/laboratory/disciplines/01.png — tab “An toàn thực phẩm” trên chỉ tiêu với nhóm Giới hạn cho phép và Viện dẫn.

💡 Ngưỡng cho phép gắn với biến thể chỉ tiêu (theo nền mẫu / mặt hàng), nên cùng một chỉ tiêu có thể có ngưỡng khác nhau cho từng loại sản phẩm.

TrườngÝ nghĩa
Cận dưới (Food Limit Min)Giá trị nhỏ nhất cho phép; kết quả thấp hơn sẽ bị chấm Không đạt
Cận trên (Food Limit Max)Giá trị lớn nhất cho phép; kết quả vượt sẽ bị chấm Không đạt
Giới hạn thực phẩm (Food Limit)Khoảng giá trị hiển thị, hệ thống tự tổng hợp từ cận dưới và cận trên
Tiêu chuẩn thực phẩm (Food Standard)Tiêu chuẩn TCVN / QCVN viện dẫn cho ngưỡng

Xem kết quả hợp chuẩn​

Sau khi đã khai ngưỡng, mỗi khi nhập / cập nhật kết quả trên dòng chỉ tiêu, hệ thống tự chấm và hiển thị nhãn hợp chuẩn.

  1. Mở phân tích và nhập kết quả cho từng dòng chỉ tiêu (xem trang Phương pháp).
  2. Cột / trường Hợp chuẩn (Food Conformity) hiển thị nhãn:
    • Đạt (Pass) — badge màu xanh.
    • Không đạt (Fail) — badge màu đỏ.
    • N/A — chỉ tiêu chưa khai ngưỡng (không hiển thị badge).
  3. Trên form thao tác dòng chỉ tiêu, hệ thống còn hiển thị Giới hạn thực phẩm và Tiêu chuẩn thực phẩm kèm theo để đối chiếu.

📷 Cần chèn ảnh: /img/modules/laboratory/disciplines/02.png — danh sách dòng chỉ tiêu với cột Hợp chuẩn hiển thị badge Đạt / Không đạt.

💡 Nhãn hợp chuẩn được lưu và tính tự động theo kết quả: chỉ cần kết quả thay đổi là badge cập nhật lại ngay, không phải thao tác chấm thủ công.

Mở rộng sang chuyên ngành khác​

Cùng một cơ chế áp dụng cho các chuyên ngành đánh giá khác. Ví dụ Thức ăn chăn nuôi (laboratory_feed + parameter_feed) cũng chấm hợp chuẩn TACN theo ngưỡng tương ứng. Quy trình chung khi triển khai một chuyên ngành:

  1. Cài addon chuyên ngành tương ứng (laboratory_<ngành>) cùng addon dữ liệu chuẩn (parameter_<ngành>).
  2. Khai ngưỡng / dữ liệu chuẩn cho các chỉ tiêu thuộc chuyên ngành đó.
  3. Nhập kết quả như luồng chung → hệ thống tự phân loại hợp chuẩn theo ngưỡng đã khai.

⚠️ Phần mô tả chi tiết cách chấm và các nhãn ở trên được kiểm chứng trực tiếp trên addon An toàn thực phẩm (laboratory_food). Các chuyên ngành khác tuân theo cùng mô hình nhưng có thể khác về trường và nhãn cụ thể — hãy đối chiếu trên hệ thống đã cài đặt thực tế.

Liên quan​