FAQ — Đăng nhập & tài khoản

import { Card, CardGrid, Aside } from ‘@astrojs/starlight/components’;

Lỗi đăng nhập

“Sai email hoặc mật khẩu.”

Xác nhận email đúng như chủ cửa hàng cấp.
Kiểm tra Caps Lock, thử với mật khẩu hiện (icon 👁).
Đặt lại mật khẩu qua link trên màn đăng nhập.

“Tài khoản đang bị tạm khóa.”

Tài khoản bị chủ cửa hàng vô hiệu hóa. Nhờ chủ bật lại trong Nhân viên.

“Chỉ tài khoản nhân viên mới được đăng nhập ở đây.”

Bạn mở /cashier-login bằng tài khoản owner. Phiên owner không thể vận hành workspace cashier. Dùng:

Vai trò	Đăng nhập tại
Owner	`/vendor-login`
Employee (POS)	`/cashier-login`
Employee (dashboard)	`/login`

“Lỗi mạng” / spinner quay mãi

Lần đầu Vendor Desktop cần internet — kết nối mạng.
Đăng nhập trình duyệt luôn cần internet.
Nếu spinner > 30 giây, refresh rồi thử lại.

Lỗi validation trước khi click Đăng nhập

Trường	Lỗi	Xử lý
Email	`Vui lòng nhập đúng định dạng email.`	Gõ lại — chắc chắn có `@`
Mật khẩu	`Trường này là bắt buộc.`	Nhập mật khẩu

Đặt lại mật khẩu

Tôi không nhận được email OTP

Đợi 1–2 phút — email có thể trễ.
Kiểm tra thư mục spam / junk.
Xác nhận email bạn nhập đúng (lỗi gõ là nguyên nhân #1).
Click Gửi lại mã trên màn OTP.
Nếu vẫn không có sau 5 phút, nhờ chủ kiểm mail server.

“Mã không hợp lệ hoặc đã hết hạn”

OTP hết hạn sau 10 phút.
Mỗi Gửi lại sẽ vô hiệu mã trước đó.
Nhập mã mới nhất từ email gần nhất.

“Phiên đặt lại đã hết hạn” trên /reset-password

Token reset sống trong sessionStorage — biến mất nếu bạn:

Đóng tab.
Đổi trình duyệt.
Đợi hơn 15 phút giữa Verify OTP và Reset password.

Bắt đầu lại từ /forgot-password và yêu cầu mã mới.

Tôi muốn reset từ thiết bị khác

Bạn có thể yêu cầu email reset trên bất kỳ thiết bị nào, nhưng Verify OTP và Reset password phải hoàn thành trên cùng session trình duyệt vì dùng sessionStorage. Dùng thiết bị đã mở /forgot-password.

Quyền Owner vs Cashier

Workspace cashier là fullscreen POS không có menu dashboard. Cấp tài khoản owner ở đây là rủi ro bảo mật:

Giao diện cashier ẩn role switcher owner và công cụ admin.
Quyền owner gồm settings ghi — quầy cashier không bao giờ nên đổi cấu hình cửa hàng.
Để owner giám sát tại quầy, owner nên mở /point-of-sale/sale từ vendor web (sau khi đăng nhập /vendor-login).

Không — chỉ tài khoản nhân viên (tạo từ Nhân viên → + Thêm) mới đăng nhập được ở đó. Owner nên:

Dùng /vendor-login cho back-office.
Mở /point-of-sale/sale từ menu dashboard (chế độ giám sát) để ring đơn khi cần.

Không. /vendor-login chỉ chấp nhận vendor_type === "owner". Nhân viên đăng nhập tại /cashier-login hoặc /login.

Phiên & cookies

“Ghi nhớ đăng nhập” làm gì?

Cài đặt	Hiệu lửa
✅ BẬT (mặc định cashier)	Refresh token lưu `localStorage` 30 ngày
❌ TẮT	Refresh token giữ `sessionStorage` — mất khi đóng trình duyệt

Tôi dùng chung PC quầy với nhân viên khác

Tick TẮT “Ghi nhớ” để mỗi ca phải đăng nhập lại.
Hoặc đăng xuất cuối ca (Cài đặt → Hồ sơ → Đăng xuất trong workspace POS).

Cách đăng xuất

Từ workspace POS:

Mở Cài đặt → Hồ sơ.
Cuộn xuống cuối.
Click Đăng xuất.
Xác nhận dialog.

Hoặc chỉ cần đóng app — nếu “Ghi nhớ” TẮT, phiên kết thúc ngay.

Đa cửa hàng

Form đăng nhập tra hồ sơ nhân viên và tự chọn:

Nếu store_id có trong hồ sơ → cửa hàng đó.
Nếu pos_register_id có → lane đó được chọn sẵn.
Nếu không có, picker hiện cho đến khi bạn chọn.

Tôi chuyển cửa hàng giữa ca và catalog đổi — có bình thường không?

Có — catalog, giá, khách hàng và thuế đều theo cửa hàng. Chuyển cửa hàng qua store selector trên thanh trên; giỏ hàng tự động xóa.

Vẫn bị kẹt?

Gửi cho chủ cửa hàng hoặc support@lionpos.com. Với sự cố platform, kiểm tra trang status trước.