Posted inPython

Tạo và quét QR Code bằng Python: Giải pháp thực tế cho quản lý kho và check-in

Python tutorial - IT technology blog
Python tutorial - IT technology blog

Tại sao QR Code vẫn là “vua” trong bài toán định danh vật lý?

Nếu bạn đang tìm cách quản lý hàng nghìn món đồ trong kho mà không muốn chi hàng chục triệu cho máy quét RFID, QR Code chính là cứu cánh. Trong các dự án mình từng làm, từ quản lý vật tư đến app check-in sự kiện, QR Code luôn thắng nhờ tính kinh tế. Một thẻ RFID có giá từ 5.000đ – 20.000đ, trong khi QR Code gần như miễn phí vì chỉ tốn tiền in giấy.

Về khả năng lưu trữ, Barcode truyền thống chỉ chứa được khoảng 20-25 ký tự. Ngược lại, QR Code có thể tải được tối đa 7,089 chữ số hoặc 4,296 ký tự chữ cái. Quan trọng nhất, bất kỳ chiếc smartphone nào hiện nay cũng có thể trở thành đầu đọc chuyên nghiệp.

Bài viết này sẽ đi thẳng vào cách xử lý QR Code bằng Python. Chúng ta không chỉ tạo ảnh rồi để đó, mà sẽ tích hợp chúng vào một quy trình vận hành thực tế.

Lựa chọn phương pháp triển khai tối ưu

Thông thường, chúng ta có hai hướng tiếp cận chính:

  • Dùng Online API (như Google Charts): Bạn gửi request và nhận về link ảnh. Cách này nhanh nhưng phụ thuộc internet. Nếu server API lỗi hoặc dữ liệu nhạy cảm bị rò rỉ, hệ thống của bạn sẽ gặp rắc rối lớn.
  • Dùng thư viện Local (qrcode, pyzbar): Mọi thao tác xử lý ngay trên máy của bạn. Tốc độ phản hồi chỉ tính bằng mili giây, hoạt động offline và dễ dàng tùy biến logo hay màu sắc thương hiệu.

Với các hệ thống yêu cầu độ ổn định cao như quản lý kho (WMS), mình luôn ưu tiên phương án chạy local. Thư viện qrcode rất nhẹ, chuyên dùng để tạo mã. Trong khi đó, pyzbar nổi tiếng với khả năng đọc mã cực nhạy, kể cả khi ảnh bị nghiêng hoặc hơi mờ.

Hướng dẫn triển khai chi tiết

1. Thiết lập môi trường

Cài đặt các thư viện cần thiết qua pip. Mình sẽ dùng thêm Pillow để xử lý ảnh và opencv-python để quét mã qua camera thời gian thực.

pip install qrcode[pil] pyzbar opencv-python

Lưu ý cho người dùng Windows: Nếu chạy code báo lỗi thiếu DLL, bạn cần cài thêm Visual C++ Redistributable. Với Linux, đừng quên cài libzbar0 qua apt-get để thư viện hoạt động.

2. Tạo mã QR chuyên nghiệp

Hãy giả định mỗi món hàng trong kho cần một mã định danh chứa ID sản phẩm, ngày nhập và mã lô. Đoạn code dưới đây sẽ tạo ra một mã QR có mức độ sửa lỗi cao nhất.

import qrcode

def create_warehouse_qr(data, filename="product_001.png"):
    qr = qrcode.QRCode(
        version=1, 
        error_correction=qrcode.constants.ERROR_CORRECT_H, # Cho phép hỏng 30% diện tích vẫn đọc được
        box_size=10,
        border=4,
    )
    qr.add_data(data)
    qr.make(fit=True)

    img = qr.make_image(fill_color="black", back_color="white")
    img.save(filename)
    print(f"Thành công: {filename}")

# Dữ liệu thực tế thường dùng phân cách bằng dấu gạch đứng
raw_data = "SKU-9923|2023-12-01|ZONE-A"
create_warehouse_qr(raw_data)

Khi dữ liệu trở nên phức tạp, mình thường dùng Regex để bóc tách thông tin sau khi quét. Nếu bạn muốn kiểm tra nhanh các pattern Regex trước khi đưa vào code, hãy thử dùng Regex Tester. Công cụ này giúp bạn xác nhận ngay lập tức liệu pattern có bắt đúng mã SKU hay không.

3. Giải mã QR Code từ hình ảnh

Sau khi nhãn được dán, nhân viên chỉ cần chụp ảnh để nhập kho. pyzbar sẽ giúp ta đọc nội dung từ file ảnh đó một cách dễ dàng.

from pyzbar.pyzbar import decode
from PIL import Image

def scan_qr_file(path):
    results = decode(Image.open(path))
    for obj in results:
        print(f"Nội dung: {obj.data.decode('utf-8')}")
        print(f"Chất lượng mã: {obj.type}")

scan_qr_file("product_001.png")

4. Hệ thống quét Real-time qua Camera

Đây là ứng dụng phổ biến nhất cho các quầy check-in. Thay vì mở từng file, hệ thống sẽ quét liên tục qua webcam. Mỗi khi phát hiện mã mới, nó sẽ tự động đối chiếu dữ liệu.

import cv2
from pyzbar.pyzbar import decode

def start_scanner():
    cam = cv2.VideoCapture(0)
    history = set()

    while True:
        _, frame = cam.read()
        for code in decode(frame):
            content = code.data.decode('utf-8')
            if content not in history:
                print(f"[CHECK-IN]: {content}")
                history.add(content)
                # Vẽ khung xác nhận lên màn hình
                x, y, w, h = code.rect
                cv2.rectangle(frame, (x, y), (x+w, y+h), (0, 255, 0), 3)

        cv2.imshow("Scanner", frame)
        if cv2.waitKey(1) & 0xFF == ord('q'): break

    cam.release()
    cv2.destroyAllWindows()

Kinh nghiệm thực tế để hệ thống chạy ổn định

Sau nhiều dự án triển khai thực tế, mình rút ra 3 quy tắc vàng giúp giảm thiểu lỗi quét:

  1. Ưu tiên Error Correction mức H: Trong môi trường kho bãi, nhãn dán rất dễ bị trầy xước hoặc dính bụi. Mức H cho phép phục hồi tới 30% dữ liệu bị mất, giúp nhân viên không phải quét đi quét lại nhiều lần.
  2. Kiểm soát mật độ dữ liệu: Đừng nhét cả một đoạn văn bản dài vào QR. Mã càng nhiều chữ thì các ô vuông càng nhỏ và khít nhau. Điều này khiến các camera rẻ tiền rất khó lấy nét. Tốt nhất hãy chỉ lưu ID hoặc một đường link rút gọn.
  3. Độ tương phản là then chốt: Luôn in mã đen trên nền trắng. Tránh dùng các màu nhạt hoặc in trên bề mặt nilon bóng vì ánh đèn sẽ gây lóa, làm tê liệt đầu đọc.

Lời kết

Kết hợp qrcode và pyzbar là phương án nhanh nhất để số hóa quy trình vận hành bằng Python. Dù bạn làm quản lý tài sản hay vé mời sự kiện, bộ đôi này vẫn đáp ứng cực tốt về cả tốc độ lẫn độ chính xác. Nếu gặp khó khăn khi cài đặt zbar trên Docker hoặc môi trường Windows, hãy để lại câu hỏi bên dưới để mình hỗ trợ nhé!

Share:
Tags: