FAQ — Quyền & vai trò

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

Phiên bản tiếng Anh

FAQ — access & roles (English)

Mục lục

• Không mở được Bán hàng
• Trang Access Denied (403)
• Không có tab Khách hàng
• Thấy Cài đặt nhưng lưu thiết bị lỗi
• Nhân viên không đổi được cửa hàng
• Vẫn bị kẹt?

Không mở được Bán hàng

Tab **Bán hàng** bị ẩn, hoặc click vào thì hiển thị banner "Bạn không có quyền truy cập".

Nguyên nhân: Tài khoản nhân viên thiếu module pos hoặc order ghi.

Cách xử lý (chủ cửa hàng):

1. Đăng nhập vendor web bằng tài khoản chủ.
2. Vào Nhân viên → Vai trò → mở vai trò của nhân viên.
3. Bật module POS ghi (hoặc order ghi cho dashboard POS).
4. Lưu — nhân viên đăng xuất rồi đăng nhập lại để áp dụng.

Xem: Vai trò (Vendor).

Trang Access Denied (403)

Truy cập 1 đường dẫn (ví dụ `/point-of-sale/orders`) → hiện trang trắng với dòng "Access Denied" hoặc icon ổ khóa.

Nguyên nhân: Route yêu cầu 1 module không có trong profile.modules của bạn.

Cách xử lý:

Màn truy cập	Module cần	Hành động
/point-of-sale/sale	pos write	Báo chủ bật POS ghi trong vai trò
/point-of-sale/orders	order read	Báo chủ bật Order đọc
/point-of-sale/customers	customer read	Báo chủ bật Customer đọc
/point-of-sale/returns	order write	Báo chủ bật Order ghi
/point-of-sale/settings/*	settings write	Báo chủ bật Settings ghi

Lưu ý: Chủ cửa hàng thường pass mọi route POS (vì có settings + pos ghi).

Xem: Đăng nhập & quyền truy cập.

Không có tab Khách hàng

Trên sidebar Thu ngân, **mục "Khách hàng"** không hiển thị.

Nguyên nhân: Vai trò thiếu customer đọc trong profile.modules.

Cách xử lý: Báo chủ bật module Customer (đọc) trong Nhân viên → Vai trò. Sau đó đăng xuất / đăng nhập lại.

Thấy Cài đặt nhưng lưu thiết bị lỗi

Mở được `/point-of-sale/settings` nhưng khi thêm máy in / terminal thì API trả lỗi **403 Forbidden**.

Nguyên nhân: Mở Cài đặt cần settings đọc (mọi nhân viên có), nhưng lưu CRUD cần settings ghi hoặc pos ghi.

Cách xử lý:

• Báo chủ kiểm tra vai trò có cả 2: settings đọc + settings/pos ghi.
• Thường thì chỉ chủ cửa hàng mới nên cấu hình thiết bị phần cứng.

Nhân viên không đổi được cửa hàng

Trên top bar, **store selector** bị khóa (icon ổ khóa) hoặc chỉ hiển thị 1 cửa hàng duy nhất.

Nguyên nhân: Nhân viên chỉ thuộc 1 cửa hàng trong hệ thống (profile.store_id cố định).

Cách xử lý:

• Nếu nhân viên thực sự làm ở nhiều chi nhánh: chủ phải gán thêm store_id trong Nhân viên → Chi tiết → Cửa hàng.
• Nếu nhân viên chỉ làm 1 cửa hàng: đây là cấu hình đúng, không cần đổi.

Xem: Nhân viên & cửa hàng.

Vẫn bị kẹt?

- Screenshot **trang Access Denied** hoặc banner lỗi. - **Email nhân viên** + **vai trò** hiện tại. - **URL** đang truy cập (ví dụ `/point-of-sale/sale`). - **Mã lỗi API** (nếu hiện ở console trình duyệt — mở DevTools → Network).

Gửi chủ cửa hàng — chủ có quyền điều chỉnh vai trò. Nếu chủ cũng bị chặn, liên hệ support@lionpos.com.

Kịch bản test (nội bộ QA)

ID	Kịch bản
P3	Nhân viên không có pos / order ghi không mở được Bán hàng
TC-PS2-003	Truy cập cửa hàng ngoài tenancy → 403 trên API

Xem thêm

• Đăng nhập & quyền truy cập
• Vai trò (Vendor)
• Nhân viên & cửa hàng
• Tổng quan cửa hàng