Mô tả

Tổng quan dự án

Hệ thống Kiểm Kê Tài Sản gồm ba phần:

• Backend (Node.js/Express + MongoDB): Cung cấp API cho đăng nhập, quản lý tài sản, phiếu kiểm kê, kiểm kê qua EPC, lịch sử thay đổi, nhập Excel.

• Frontend Web (React + Vite): Giao diện quản trị để đăng nhập, quản lý tài sản, tạo/xem phiếu kiểm kê, in tem QR, xem audit log (chỉ admin).

• Android App (Kotlin): Ứng dụng di động hỗ trợ kiểm kê tại hiện trường, quét thẻ EPC bằng máy quét UHF (AutoID Utouch2).

Chức năng chính

• Đăng nhập/đăng ký, phân quyền (admin/user).

• Tài sản: danh sách, tìm kiếm, lọc (nhà máy/khu vực/bộ phận), thêm/sửa/xóa, xuất Excel (web).

• Phiếu kiểm kê: tạo phiếu, xem chi tiết, thống kê đã kiểm/chưa kiểm, khóa/mở khóa, xóa phiếu (khi chưa khóa).

• Kiểm kê bằng EPC (Android): quét UHF RFID, đánh dấu đã kiểm, quản lý “tài sản quét thừa”.

• In tem QR (web, admin): in hoặc lưu PDF tem 70x23mm (QR + mã tài sản).

• Audit log (web, admin): xem lịch sử thay đổi.

• Nhập Excel (web, admin): import tài sản hàng loạt.

Phần cứng cần có (cho tính năng quét RFID)

• Máy quét UHF RFID: AutoID Utouch2 (kết nối Bluetooth với thiết bị Android).

• Thẻ EPC RFID (EPC Gen2), đã được ghi mã EPC duy nhất và gắn lên tài sản.

Cách người dùng thao tác (tóm tắt)

1) Quản trị (web):

• Đăng nhập, tạo tài khoản, phân quyền.

• Nhập tài sản (form hoặc Excel), liên kết EPC code nếu có.

• Tạo phiếu kiểm kê, in tem QR (admin), xem audit log (admin).

2) Kiểm kê (Android):

• Cấu hình BASE_URL trỏ về backend.

• Pair máy quét AutoID Utouch2 qua Bluetooth.

• Mở phiếu kiểm kê, nhấn trigger để quét thẻ EPC; tài sản sẽ được đánh dấu đã kiểm, thừa sẽ vào danh sách “quét thừa”.

3) In tem (web, admin):

• Chọn tài sản → In tem QR (70x23mm) → In ra máy in tem hoặc lưu PDF.

4) Kiểm tra/lưu ý kết nối:

• Backend: http://localhost:8000 (hoặc IP LAN nếu thiết bị khác mạng).

• Frontend: http://localhost:5173 (mặc định).

• Android: Emulator dùng 10.0.2.2:8000; thiết bị thật dùng IP máy tính + port backend, mở firewall cho port 8000.

Tài liệu kèm theo

• INSTALLATION_GUIDE.md: Hướng dẫn cài đặt chi tiết backend, frontend, Android, cấu hình thiết bị, troubleshoot, checklist.

• android-app/README.md: Hướng dẫn riêng cho Android App.