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.
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
Nguồn: Sharecode.vn
Toàn bộ file tải về có hướng dẫn cài đặt chi tiết đầy đủ cũng vi video demo và video hướng dẫn cài đặt . các bạn tải về xem kỹ và thực hiện có bất kỳ lỗi gì liên quan đến cài đặt thì liên hệ theo thông tin của mình ở hướng dẫn cài đặt
: tài khoản demo :admin99
mk: 123456