Language: Vietnamese

Function (Function Description)	Login: This document teaches the end user how to use the Login/Login feature in the system correctly and safely.
Version (Version)	v1.0
Creation date (Created at)	Jan 12, 2026
Conditions of use (Prerequisites)	The device has been whitelist IP address, has a VPN and has a stable network connection There is an account that logs into the PMS. In case the user does not have an account, it is necessary to contact the Support team or Admin to create an account.

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:

• Information security: Prevents unauthorized access to personal or systemic data.
• Personalize the experience: After logging in, the system can display content suitable for each user.
• 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:

• Quickly understand the purpose of the Login feature and what to prepare before logging in
• 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
  • Sign in with Gmail: use your Google account for quick authentication.
• 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. Log in with Username/Password + OTP

i. Users visit the PMS Portal web at the Login screen

ii. Enter Username with Password, then press the “Sign in” button on the screen or press the “Enter” button on the keyboard.

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

iv. Users enter OTP into the textbox OTP“OTP”

v. If OTP is correct → the user logs in successfully.

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

2. Log in with Gmail (Google sign-in)

i. Users visit the PMS Portal web at the Login screen

ii. Users choose the “Sign in with Google” button.

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

iv. Users select Gmail account and confirm or enter Google Email/Password (if not logged in) and allow access

v. If the Gmail account matches the Gmail of the active account in the system → The system automatically turns off the Google Authentication Browser tab to return to the PMS portal login tab, navigate to the Dashboard screen and successfully log in notifications.

vi. If you refuse access → The system automatically turns off the Google Authentication Browser tab to return to the PMS Portal login tab and display the error toast message “Unable to sign in because you cancelled Google sign-in.”

IV. Description Of GUI (User Interface)

The “Login” form includes:

• School of “Username”: Username
• “Password” field: Password (indulgent)
• “Sign in” button: Confirm login
• “Sign in with Google” button: Sign in with your Google account.

V. General Guidance and Support

1. Tips For Use:

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

2. Support: If you have a problem, contact email support@airfeedkh.com.
3. Update: This guideline may change. Please check the new version in the “Help” section.

---

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.

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 only allows you to 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 logo 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 accounts, 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

Below are the standard steps to use the function. Follow the order to ensure efficiency.

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, click “Sign in” or press Enter on the keyboard.

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

iv. The user enters the OTP into the OTP“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 (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.