Quản lý Thẻ từ (Card Ticket)
Module: Hướng dẫn sử dụng → Case Study I → Bãi đỗ xe → Quản lý Thẻ từ (Card Ticket)
Case study mô tả cách BQL bãi xe phát hành thẻ từ (Card Ticket) cho vé lượt — thẻ vật lý được tái sử dụng nhiều lần thay cho vé giấy. Các số trên ảnh tương ứng với số thứ tự trong bảng thành phần bên dưới.
1. Sơ đồ tổng quan về luồng

2. Các bước thực hiện
Bước 1 — Mở danh sách thẻ từ
Tại Chi tiết bãi đỗ → Quản lý thẻ xe → Vé lượt, chuyển sang Thẻ từ. Danh sách hiển thị các đợt phát hành thẻ từ kèm loại vé lượt, loại phương tiện và trạng thái.

| # | Thành phần | Loại | Ghi chú |
|---|---|---|---|
| 1 | Quản lý vé lượt | Khối chức năng | |
| 2 | Tab Thẻ từ | Chuyển chế độ | |
| 3 | Tạo thẻ từ | Nút | Mở form ở Bước 2 |
| 4 | Lọc trạng thái | Danh sách chọn | |
| 5 | Danh sách thẻ từ | Bảng | Mã thẻ từ, loại vé lượt, loại phương tiện, trạng thái, thao tác |
Bước 2 — Tạo thẻ từ
Nhấn Tạo thẻ từ, chọn loại vé lượt, nhập mã thẻ từ (có thể nhập nhiều mã, mỗi mã một dòng, ví dụ CARD0001, CARD0002), ghi chú và nhấn Tạo thẻ từ.

| # | Thành phần | Loại | Ghi chú |
|---|---|---|---|
| 1 | Loại vé lượt | Danh sách chọn | Bắt buộc |
| 2 | Mã thẻ từ | Trường nhập nhiều dòng | Bắt buộc; mã in trên thẻ/đọc từ đầu đọc |
| 3 | Loại phương tiện | Tự động | Theo loại vé lượt |
| 4 | Ghi chú | Trường nhập | |
| 5 | Tạo thẻ từ | Nút |
Bước 3 — Vận hành thẻ từ
Thẻ từ được phát cho khách khi xe vào và thu lại khi xe ra; phí tính theo cấu hình vé lượt. Theo dõi thẻ đang lưu hành tại tab Xe trong bãi và đối soát tại Lịch sử ra vào.
Lưu ý: Thẻ từ dùng cho vé lượt khác với thẻ gắn vé tháng của cư dân (quản lý tại Quản lý thẻ).
3. QA Tips
| Tình huống | Nguyên nhân | Cách xử lý |
|---|---|---|
| Báo trùng mã thẻ | Mã thẻ đã được phát hành trước đó | Kiểm tra danh sách thẻ từ, dùng mã khác |
| Thẻ không mở được barrier | Thẻ chưa được đồng bộ xuống thiết bị | Kiểm tra Kết nối tích hợp của bãi |
| Khách làm mất thẻ từ | Thẻ đang ở trạng thái lưu hành | Khóa thẻ và thu phí theo quy định mất thẻ |
| Loại phương tiện không đúng | Chọn sai loại vé lượt | Tạo lại thẻ với loại vé lượt đúng |
