🔍 Hướng dẫn chi tiết

Kiểm tra chất lượng (QC)

Hướng dẫn tạo báo cáo kiểm tra QC, quản lý kết quả OK/NG, theo dõi tỉ lệ đạt và đối chiếu số lượng với bản vẽ theo từng đơn hàng (PO).

Danh sách QC Tạo báo cáo QC Về mục lục

🔗 Đi đến

📋 Tổng quan ➕ Tạo báo cáo QC 📑 Các trường dữ liệu 📊 Quản lý danh sách ✅ Kết quả OK/NG 📎 File bản vẽ 🔍 Lọc & Tìm kiếm 📥 Xuất / Nhập Excel 🔐 Phân quyền ⚠️ Lưu ý

📋 Tổng quan — Module Kiểm tra chất lượng (QC)

Module QC ghi nhận và quản lý toàn bộ kết quả kiểm tra chất lượng sản phẩm theo từng đơn hàng (PO) và bản vẽ. Hệ thống hỗ trợ cascade chọn Khách hàng → PO → Bản vẽ, tự động lấy số lượng yêu cầu, tính tỉ lệ OK và đối chiếu số lượng kiểm với số lượng yêu cầu.

👤 Khách hàng

→

📦 PO

→

📐 Bản vẽ

→

🔍 Báo cáo QC

→

✅ OK / ❌ NG

Module gồm 2 trang chính + các trang hỗ trợ:

📋 Danh sách QC

Trang qc_inspection.php — Xem, lọc, tìm kiếm, sửa, xoá toàn bộ báo cáo kiểm tra.

➕ Tạo báo cáo QC

Trang qc_report.php — Form tạo mới với cascade Khách hàng → PO → Bản vẽ và xem trước kết quả.

📥 Nhập / Xuất Excel

Hỗ trợ nhập hàng loạt từ Excel và xuất danh sách đã lọc ra file Excel.

Danh sách QC Tạo báo cáo Nhập từ Excel

➕ Tạo báo cáo QC mới — Các bước thực hiện

Truy cập qc_report.php hoặc bấm nút + Thêm mới trên trang danh sách. Form sử dụng cascade 3 cấp để đảm bảo dữ liệu chính xác.

1

Chọn Khách hàng *

Dropdown lấy danh sách khách hàng thuộc doanh nghiệp. Sau khi chọn, hệ thống tự tải danh sách PO tương ứng.
2

Chọn Mã / Tên PO *

Chỉ hiển thị PO của khách hàng đã chọn. Banner sẽ hiện Ngày nhận và Ngày giao của PO. Sau đó hệ thống tải danh sách bản vẽ thuộc PO.
3

Chọn Mã bản vẽ *

Chọn bản vẽ → hệ thống tự điền Tên chi tiết và SL yêu cầu (từ bảng drawings). Trường SL yêu cầu được tô màu vàng để dễ nhận biết.
4

Nhập Số lượng kiểm, OK, NG *

Nhập số lượng đã kiểm tra, số OK và số NG. Hệ thống tự tính tỉ lệ % và so sánh với SL yêu cầu (hiển thị “Đúng số lượng”, “Còn thiếu” hoặc “Vượt”).
5

Chọn Ngày kiểm tra & Nhân viên QC *

Ngày kiểm tra không được lớn hơn ngày hiện tại. Nhân viên QC chọn từ danh sách employees của doanh nghiệp.
6

Ghi chú (tuỳ chọn) & Lưu

Có thể ghi mô tả lỗi, nguyên nhân, biện pháp xử lý. Bấm Lưu báo cáo → hệ thống chuyển về trang danh sách QC.

✏️

Sửa báo cáo đã tạoTừ trang danh sách bấm nút ✏️ Sửa để mở edit_inspection.php?id={id}. Có thể cập nhật toàn bộ thông tin kết quả kiểm tra.

👁️

Xem trước kết quả realtimeKhi nhập OK / NG / Số lượng kiểm, khung “Xem trước kết quả” cập nhật ngay badge ✅ OK, ❌ NG và % đạt (màu xanh ≥90%, vàng ≥70%, đỏ <70%).

📑 Giải thích các trường dữ liệu

Trường	Bắt buộc	Mô tả
Khách hàng	Bắt buộc	Chọn từ danh sách customers. Dùng để cascade tải PO.
Mã / Tên PO	Bắt buộc	PO thuộc khách hàng đã chọn. Lưu cả `po_id` và `po_name` vào bảng inspections.
Mã bản vẽ	Bắt buộc	Bản vẽ thuộc PO. Hệ thống tự lấy tên chi tiết và số lượng yêu cầu.
Tên chi tiết	Tự động	Điền tự động từ description của bản vẽ (readonly).
SL yêu cầu	Tự động	Lấy từ `drawings.quantity_required`. Dùng để so sánh với số lượng kiểm.
Số lượng kiểm	Bắt buộc	Tổng số sản phẩm đã kiểm tra trong lần QC này.
OK	Bắt buộc	Số lượng đạt (OK). Dùng để tính tỉ lệ %.
NG	Bắt buộc	Số lượng không đạt (NG).
Ngày kiểm tra	Bắt buộc	Ngày thực hiện QC. Không được lớn hơn ngày hiện tại.
Nhân viên kiểm tra	Bắt buộc	Chọn từ danh sách employees của doanh nghiệp (tên + role).
Ghi chú	Tuỳ chọn	Mô tả lỗi, nguyên nhân, biện pháp xử lý…

📊 Quản lý danh sách kiểm tra QC

Trang Kiểm tra chất lượng (qc_inspection.php) hiển thị toàn bộ báo cáo QC theo thứ tự ngày kiểm tra mới nhất, dưới dạng bảng (Desktop) hoặc card (Mobile).

📋 Giao diện bảng — Desktop

#	Khách hàng	PO Name	Tên bản vẽ	SL kiểm	SL y/c	Ngày QC	OK	NG	Tỉ lệ	Nhân viên	Hành động
1	Công ty ABC	PO-240601	Chi tiết trục chính	100	100	15/07/2024	98	2	98%	Nguyễn Văn A
2	Công ty XYZ	PO-240720	Ống dẫn khí	50	60	20/07/2024	35	15	70%	Trần Thị B

✏️

Nút SửaMở trang edit_inspection.php?id={id} để chỉnh sửa toàn bộ thông tin báo cáo QC.

🗑️

Nút XoáHiện modal xác nhận. Xoá bằng AJAX và loại bỏ dòng/card khỏi giao diện ngay lập tức. Hành động không thể hoàn tác.

📱

Giao diện MobileTrên màn hình <768px chuyển sang dạng card, hiển thị đầy đủ badge OK/NG/%, thông tin bản vẽ, khách hàng và nút Sửa/Xoá.

✅ Kết quả OK / NG & Tỉ lệ đạt

Mỗi báo cáo QC ghi nhận số lượng OK và NG. Hệ thống tự tính tỉ lệ đạt theo công thức:

        Tỉ lệ % = (OK ÷ Số lượng kiểm) × 100
      

Màu badge tỉ lệ được phân loại như sau:

≥ 90% — Xanh (đạt tốt) 70% – 89% — Vàng (cảnh báo) < 70% — Đỏ (cần xử lý)

⚖️

Đối chiếu SL kiểm vs SL yêu cầuKhi nhập số lượng kiểm, hệ thống so sánh với SL yêu cầu của bản vẽ và hiển thị ngay:

Đúng số lượng — SL kiểm = SL yêu cầu
Còn thiếu X chiếc — SL kiểm < SL yêu cầu
Vượt X chiếc — SL kiểm > SL yêu cầu

📎 Xem file đính kèm bản vẽ

Trên danh sách QC, cột File đính kèm hiển thị các nút tương ứng với file đã upload cho bản vẽ (PDF, Ảnh, AutoCAD, SolidWorks, STEP, IGS, DXF, HTML).

Bấm vào nút sẽ mở modal xem trước file ngay trên trình duyệt (hỗ trợ PDF.js cho file PDF và hiển thị ảnh trực tiếp). Có nút Tải về nếu cần.

🔗

Nguồn fileFile được lấy từ bảng drawings theo drawing_id của báo cáo QC. Nếu bản vẽ chưa có file nào thì hiển thị “Không có”.

🔍 Lọc & Tìm kiếm

Trang danh sách cung cấp bộ lọc mạnh và tìm kiếm nhanh (live search):

🔎

Lọc theo PO ID / Drawing ID / Tên bản vẽNhập chính xác ID hoặc một phần tên bản vẽ để lọc.

📅

Lọc theo khoảng ngàyChọn Từ ngày – Đến ngày hoặc dùng các nút nhanh: Hôm nay, Hôm qua, 3 ngày, Tuần này, Tháng này…

🏷️

Từ khoáTìm theo tên PO, tên bản vẽ hoặc tên nhân viên kiểm tra (LIKE search).

⚡

Tìm nhanh realtimeÔ tìm kiếm phía trên bảng lọc ngay trên client theo tên khách hàng, PO, bản vẽ, nhân viên mà không cần reload trang.

🔄

Đặt lại bộ lọcBấm nút Đặt lại để xoá toàn bộ điều kiện và quay về danh sách đầy đủ.

↕️

Sắp xếp cộtBấm tiêu đề cột (PO Name, Ngày QC, OK, NG, Nhân viên…) để sắp xếp tăng/giảm. Mũi tên ↑↓ hiển thị trạng thái hiện tại.

📥 Xuất Excel & Nhập hàng loạt

📤

Xuất ExcelNút Xuất Excel trên trang danh sách xuất toàn bộ (hoặc theo bộ lọc hiện tại) ra file Excel qua export_inspections_to_excel.php.

📥

Nhập từ ExcelTrên form tạo báo cáo có nút Nhập từ Excel dẫn đến import_multi_qc-report_from_excel.php để nhập nhiều báo cáo cùng lúc.

🔐 Phân quyền người dùng

Module QC được bảo vệ bởi auth_guard.php và kiểm tra bussines_id trên mọi thao tác:

Hành động	Người dùng đã đăng nhập
Xem danh sách QC	✅ Có (chỉ dữ liệu của doanh nghiệp mình)
Tạo / Sửa báo cáo QC	✅ Có
Xoá báo cáo QC	✅ Có (có modal xác nhận + kiểm tra bussines_id)
Xuất / Nhập Excel	✅ Có
Xem file bản vẽ	✅ Có

⚠️

Lưu ý bảo mậtMọi truy vấn đều gắn điều kiện bussines_id lấy từ session. Không thể xem hoặc sửa dữ liệu QC của doanh nghiệp khác.

⚠️ Lưu ý quan trọng

🚨

Xoá là vĩnh viễnKhi xoá một báo cáo QC, dữ liệu bị xoá khỏi bảng inspections và không thể khôi phục. Hãy kiểm tra kỹ trước khi xác nhận.

📅

Ngày kiểm tra không được vượt quá hôm nayForm tạo/sửa chặn ngày lớn hơn ngày hiện tại để tránh nhập liệu sai.

🔗

Cascade bắt buộcPhải chọn đúng thứ tự Khách hàng → PO → Bản vẽ. Nếu thay đổi Khách hàng hoặc PO, các trường phía sau sẽ được reset.

📊

Tỉ lệ & đối chiếu số lượngTỉ lệ % và so sánh SL kiểm vs SL yêu cầu chỉ mang tính tham khảo trên giao diện. Dữ liệu gốc vẫn là OK, NG và quantity đã lưu.

🏢

Dữ liệu độc lập theo doanh nghiệpMỗi doanh nghiệp (bussines_id) chỉ thấy và quản lý báo cáo QC của mình. Không chia sẻ dữ liệu giữa các doanh nghiệp.

Tiếp tục khám phá các chức năng liên quan:

Danh sách QC Tạo báo cáo QC Nhập từ Excel Mục lục hướng dẫn