Language: Vietnamese

Chức năng (Function description)	Đăng nhập: Tài liệu này hướng dẫn người dùng cuối cách sử dụng tính năng Login/Đăng nhập trong hệ thống một cách đúng và an toàn.
Phiên bản (Version)	v1.0
Ngày tạo (Created at)	Jan 12, 2026
Điều kiện sử dụng (Prerequisites)	Thiết bị đã được whitelist IP address, có VPN và có kết nối mạng ổn địnhĐã có tài khoản đăng nhập vào PMS. Trường hợp người dùng chưa có tài khoản, cần liên hệ Support team hoặc Admin để tạo tài khoản.

Version log

ID	Version	Description	Updated at	Updated by
1	ver1.0	I. Giới Thiệu và Mục Tiêu 1. Giới thiệu 2. Mục tiêu II. Các Tính Năng Chính III. Các Bước Thao Tác Cơ Bản Trên Màn Hình V. Mô Tả GUI (Giao Diện Người Dùng) V. Hướng Dẫn Chung và Hỗ Trợ	Jan 7, 2026	Sun

I. Giới Thiệu và Mục Tiêu

1. Giới thiệu

Tính năng Login (Đăng nhập) là bước đầu tiên và quan trọng nhất để người dùng truy cập vào hệ thống. Đây là cơ chế xác thực danh tính, đảm bảo chỉ những người có quyền mới có thể sử dụng các chức năng bên trong hệ thống.

Vai trò của tính năng Login:

• Bảo mật thông tin: Ngăn chặn truy cập trái phép vào dữ liệu cá nhân hoặc hệ thống.
• Cá nhân hóa trải nghiệm: Sau khi đăng nhập, hệ thống có thể hiển thị nội dung phù hợp với từng người dùng.
• Theo dõi hoạt động: Ghi nhận lịch sử sử dụng, thao tác và hành vi người dùng để phục vụ phân tích hoặc hỗ trợ.

2. Mục tiêu

Nội dung tập trung vào trải nghiệm thao tác thực tế trên màn hình, giúp người dùng:

• Hiểu nhanh mục đích của tính năng Login và những gì cần chuẩn bị trước khi đăng nhập
• Thực hiện đúng các bước đăng nhập (tài khoản/mật khẩu, Gmail)
• Nhận biết và xử lý các tình huống thường gặp và edge case (nhập sai, OTP hết hạn, tài khoản bị khoá, hệ thống lỗi…)
• Biết cách đọc thông báo trên màn hình và thực hiện các bước khắc phục tương ứng

II. Các Tính Năng Chính

• Đăng nhập bằng Username với Password/ Gmail
  • Đăng nhập bằng Username/ Password + OTP: Yêu cầu user nhập mã OTP gửi qua Telegram/ Email sau khi nhập đúng Username/ Password
  • Đăng nhập bằng Gmail: sử dụng tài khoản Google để xác thực nhanh chóng.
• Thông báo lỗi: Hiển thị lý do đăng nhập thất bại
• Bảo mật phiên đăng nhập: tự động hết hạn sau 60 phút không hoạt động
• Tích hợp với các tính năng khác: Sau đăng nhập thành công, chuyển hướng đến màn hình Dashboard.

III. Các Bước Thao Tác Cơ Bản Trên Màn Hình

Dưới đây là các bước thao tác tiêu chuẩn để sử dụng chức năng. Thực hiện theo thứ tự để đảm bảo hiệu quả.

1. Đăng nhập bằng Username/ Password + OTP

i. Người dùng truy cập web PMS Portal tại màn hình Login

ii. Nhập Username với Password, sau đó nhấn nút “Sign in” trên màn hình hoặc nhấn nút “Enter” trên bàn phím

iii. Nếu hợp lệ → PMS gửi OTP qua Telegram Bot/ Email đã đăng ký cho tài khoản tương ứng

iv. Người dùng nhập OTP vào textbox “OTP”

v. Nếu OTP đúng → người dùng đăng nhập thành công.

vi. Nếu OTP sai → hệ thống hiển thị thông báo lỗi “Invalid OTP. Please press the Resend OTP and try again.”

2. Đăng nhập bằng Gmail (Google sign-in)

i. Người dùng truy cập web PMS Portal tại màn hình Login

ii. Người dùng chọn nút “Sign in with Google”

iii. Hệ thống mở tab trình duyệt mới và điều hướng user đến màn hình xác thực của Google.

iv. User chọn tài khoản Gmail và xác nhận hoặc nhập Email/ Password Google (nếu chưa đăng nhập) và cho phép quyền truy cập

v. Nếu tài khoản Gmail khớp với Gmail của tài khoản đang hoạt động trong hệ thống → Hệ thống tự động tắt tab trình duyệt xác thực của Google để quay lại tab đăng nhập PMS portal, điều hướng vào màn hình Dashboard và thông báo đăng nhập thành công.

vi. Nếu từ chối quyền truy cập → Hệ thống tự động tắt tab trình duyệt xác thực của Google để quay lại tab đăng nhập PMS Portal và hiển thị error toast với message “Unable to sign in because you cancelled Google sign-in.”

IV. Mô Tả GUI (Giao Diện Người Dùng)

Form “Login” gồm:

• Trường “Username”: Tên đăng nhập
• Trường “Password”: Mật khẩu (ẩn ký tự)
• Nút “Sign in”: Xác nhận đăng nhập
• Nút “Sign in with Google”: Đăng nhập bằng tài khoản Google.

V. Hướng Dẫn Chung và Hỗ Trợ

1. Mẹo Sử Dụng:

• Luôn kiểm tra kỹ Username và Password trước khi đăng nhập.
• Nếu quên mật khẩu → liên hệ bộ phận hỗ trợ qua email/điện thoại.
• Nếu tài khoản bị khóa → liên hệ bộ phận hỗ trợ qua email/điện thoại.
• Nếu gặp lỗi mạng → kiểm tra kết nối internet hoặc thử lại sau.
• Nếu chưa kích hoạt tài khoản → liên hệ bộ phận hỗ trợ qua email/điện thoại.
• Nếu chưa nhận được mã OTP → kiểm tra Telegram bot hoặc thử lại.

2. Hỗ Trợ: Nếu gặp vấn đề, liên hệ email support@airfeedkh.com.
3. Cập Nhật: Guideline này có thể thay đổi. Vui lòng kiểm tra phiên bản mới trong phần “Help”.

---

Language: English

Function description	Login: This document guides end users on how to use the Login feature in the system correctly and securely.
Version	v1.0
Created at	Jan 12, 2026
Prerequisites	The device’s IP address has been whitelisted, VPN is available, and the network connection is stable.A PMS login account is available. If the user does not have an account yet, please contact the Support team or Admin to create one.

Version log

ID	Version	Description	Updated at	Updated by
1	ver1.0	I. Introduction and Objectives 1. Introduction 2. Objectives II. Primary features III. Normal flow IV. GUI description V. General Guidance and Support	Jan 7, 2026	Sun

I. Introduction and Objectives

1. Introduction

The Login feature is the first and most important step for users to access the system. It is an identity authentication mechanism that ensures only authorized users can use the system’s functions.

Meaning of the Login feature:

• Information security: Prevents unauthorized access to personal or system data.
• Personalized experience: After login, the system can display content tailored to each user.
• Activity tracking: Records usage history, actions, and user behavior for analysis or support purposes.

2. Objectives

This document focuses on the practical on-screen experience to help users:

• Quickly understand the purpose of the Login feature and what needs to be prepared before logging in
• Perform the correct login steps (username/password, Gmail)
• Identify and handle common cases and edge cases (wrong input, expired OTP, locked account, system errors, etc.)
• Understand on-screen messages and follow the corresponding troubleshooting steps

II. Primary features

• Login with Username & Password / Gmail
• Login with Username & Password + OTP: Requires the user to enter an OTP sent via Telegram/Email after valid username/password is entered
• Login with Gmail: Uses a Google account for quick authentication
• Error messages: Displays the reason for login failure
• Session security: Automatically expires after 60 minutes of inactivity
• Integration with other features: After successful login, redirects to the Dashboard screen

III. Normal flow

Dưới đây là các bước thao tác tiêu chuẩn để sử dụng chức năng. Thực hiện theo thứ tự để đảm bảo hiệu quả.

1. Login with Username/ Password + OTP

i. The user opens the PMS Portal website and lands on the Login screen.

ii. Enter Username and Password, then click “Sign in” or press Enter on the keyboard.

iii. If valid → the PMS sends an OTP to the registered Telegram Bot/Email for the corresponding account.

iv. The user enters the OTP into the “OTP” textbox.

v. If the OTP is correct → login is successful.

vi. If the OTP is incorrect → the system displays the error message: “Invalid OTP. Please press the Resend OTP and try again.”

2. Login with Gmail (Google sign-in)

i. The user opens the PMS Portal website and lands on the Login screen.

ii. The user clicks “Sign in with Google.”

iii. The system opens a new browser tab and redirects the user to Google’s authentication screen.

iv. The user selects a Gmail account and confirms, or enters Google Email/Password (if not already logged in), and grants access permissions.

v. If the Gmail account matches an active account in the system → the system automatically closes the Google authentication tab, returns to the PMS Portal tab, redirects to the Dashboard screen, and shows a successful login notification.

vi. If the user denies access → the system automatically closes the Google authentication tab, returns to the PMS Portal tab, and shows an error toast message: “Unable to sign in because you cancelled Google sign-in.”

IV. GUI description

The “Login” form includes:

• “Username” field: Username
• “Password” field: Password (masked)
• “Sign in” button: Confirm login
• “Sign in with Google” button: Login using a Google account

V. General Guidance and Support

1. Usage Tips

• Always double-check the Username and Password before logging in.
• If you forget your password → contact support via email/phone.
• If your account is locked → contact support via email/phone.
• If you encounter network issues → check your internet connection or try again later.
• If your account has not been activated → contact support via email/phone.
• If you have not received the OTP → check the Telegram bot or try again.

2. Support

If you face any issues, please contact: support@airfeedkh.com.

3. Updates

This guideline may be updated. Please check the latest version in the “Help” section.