Đăng ký Vé tháng từ App Cư dân
Module: Hướng dẫn sử dụng → Case Study I → Bãi đỗ xe → Đăng ký Vé tháng từ App Cư dân
Case study mô tả luồng đăng ký vé tháng từ App cư dân: cư dân gửi yêu cầu trên App, Ban quản lý bãi xe tiếp nhận và xử lý trên Web theo mô hình hai bước tách biệt — (1) Duyệt yêu cầu, (2) Tạo vé tháng để chọn ngày bắt đầu và sinh vé + hóa đơn đồng bộ. 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 — Tiếp nhận yêu cầu từ App
Vào Bãi xe thông minh → Danh sách bãi đỗ → Chi tiết, chọn tab Yêu cầu cấp vé tháng. Yêu cầu từ App cư dân hiển thị với mã YCVXT, căn hộ, cư dân, nhóm khách hàng, loại vé, biển số, số tiền, trạng thái, ngày gửi, thẻ liên kết, mã vé liên kết và tình trạng thanh toán. Thẻ Yêu cầu chờ duyệt ở đầu trang cho biết số yêu cầu mới.

| # | Thành phần | Loại | Ghi chú |
|---|---|---|---|
| 1 | Tab Yêu cầu cấp vé tháng | Tab | |
| 2 | Tạo yêu cầu (thay cư dân) | Nút | BQL tạo yêu cầu hộ cư dân (Bước 2) |
| 3 | Quy tắc 2 bước | Thông tin | Duyệt chỉ cho phép phát hành; Tạo vé tháng mới sinh vé và hóa đơn |
| 4 | Lọc trạng thái | Danh sách chọn | Chờ duyệt / Đã duyệt / Từ chối… |
| 5 | Danh sách yêu cầu | Bảng | Thao tác: Xem chi tiết, Tạo vé tháng/Thanh toán |
Bước 2 — Tạo yêu cầu thay cư dân (khi cần)
Trường hợp cư dân đăng ký trực tiếp tại quầy, nhấn Tạo yêu cầu cấp vé tháng và thực hiện 4 bước: chọn Khách hàng → Căn hộ → Thẻ tòa nhà → Vé tháng.

| # | Thành phần | Loại | Ghi chú |
|---|---|---|---|
| 1 | 4 bước tạo yêu cầu | Thanh tiến trình | Khách hàng → Căn hộ → Thẻ tòa nhà → Vé tháng |
| 2 | Tìm kiếm người dùng | Ô tìm kiếm | Theo tên, SĐT, email, mã căn hộ |
| 3 | Tiếp tục | Nút | Chuyển sang bước kế tiếp |
Bước 3 — Duyệt và phát hành vé tháng
Mở chi tiết yêu cầu, kiểm tra thông tin rồi Duyệt. Yêu cầu chuyển sang Đã duyệt nhưng chưa có vé/phiếu thu. Tiếp theo dùng Tạo vé tháng để chốt ngày bắt đầu — hệ thống sinh vé tháng (mã VT) và hóa đơn; cư dân thanh toán qua QR trên App hoặc tại quầy. Chi tiết bước tạo vé xem bài Đăng ký vé tháng.
Lưu ý: Chỉ nhấn Xác nhận thanh toán khi đã nhận được tiền; thao tác này ghi nhận phiếu thu cho vé tháng.
3. QA Tips
| Tình huống | Nguyên nhân | Cách xử lý |
|---|---|---|
| Không thấy yêu cầu cư dân vừa gửi | Cư dân chọn bãi đỗ khác hoặc đang lọc trạng thái | Chọn đúng bãi đỗ và lọc Tất cả |
| Đã duyệt nhưng cư dân chưa có vé | Mô hình 2 bước: chưa Tạo vé tháng | Thực hiện Tạo vé tháng để sinh vé và hóa đơn |
| Không tìm thấy thẻ tòa nhà ở bước 3 | Căn hộ chưa được cấp thẻ hoặc thẻ chưa gắn xe | Cấp/gắn thẻ tại Quản lý thẻ trước |
| TT thanh toán vẫn Chờ thanh toán | Cư dân chưa chuyển khoản hoặc chưa xác nhận | Đối soát giao dịch rồi xác nhận thanh toán |
