feat: add vision documentation (v1.5.0) (#17)

* feat: add vision first time setup, faq & introduction

* update: vision docs to match vision v1.5.0

---------

Co-authored-by: anndreaw <andrea.xhwong@gmail.com>
Co-authored-by: bryanngyc <bryangyc19@gmail.com>

Author: 3 people

docs/integration/vision/faq.md

@@ -0,0 +1,17 @@
+---
+sidebar_position: 11
+title: FAQ
+---
+
+## Payroll & Sync Settings
+
+### Error: Missing drive link detected. 
+`Missing drive link detected. Please contact your system administrator to enable the drive link and ensure SQL Payroll is updated to version 1.2025.288.232 or later before re-syncing`
+
+![Missing Drive Link error](../../../static/img/integration/vision/faq/missingDriveLink.png)
+
+This error occurs when no Drive link is present to upload attachments or images.
+
+**Fix it in SQL Payroll:**
+
+- Check if drive link is present in SQL Payroll. May refer [**Drive Setup**](/integration/hrms/payroll-setup#sql-drive)

docs/integration/vision/first-time-setup.md

@@ -0,0 +1,66 @@
+---
+sidebar_position: 2
+title: "First Time Setup"
+---
+
+## SQL Payroll Company
+
+1. Navigate to Files > Company Profile and enter company details
+2. Important Fields :
+    - Company Name
+    - Email (for getting OTP)
+
+![company-profile](../../../static/img/integration/vision/setup/company.png)
+
+## SQL Drive
+
+If you wish to upload images or attachments in Gift module or Assignment module you will require this step. If no may skip to the next step.
+
+:::info[Prerequisites]
+May contact SQL support to register email address for SQL Drive.
+
+Make sure you are logging into an ADMIN user before proceed with the steps below.
+:::
+
+1. Navigate to File > Company Profile..., click on the ☁️.
+   ![sql-drive1](../../../static/img/integration/hrms/payroll-setup/sql-drive1.png)
+
+2. Switch on Drive.
+   ![sql-drive2](../../../static/img/integration/hrms/payroll-setup/sql-drive2.png)
+
+3. Click on "Log in" > Log in with Google. Enter your Gmail account + password and press on "Grant access".
+   ![sql-drive3](../../../static/img/integration/hrms/payroll-setup/sql-drive3.png)
+
+4. Save.
+
+## SQL Payroll Employees
+
+1. Navigate to Human Resource > Maintain Employee
+2. Create New Employees or go to existing employees
+3. Important Fields:
+    - Employee Code
+    - Name
+    - Manager Tag (This will determine their role in SQL Vision)
+    - Active Tag
+    - Email (For each employee to login to their account)
+
+    ![employee](../../../static/img/integration/vision/setup/employee.png)
+4. Optional Fields:
+    - Group > Branch / HR Group / Department may be used to categorise employee
+
+    ![grouping](../../../static/img/integration/vision/setup/grouping.png)
+
+## Sync to SQL Vision
+
+This step will automatically sync all data to SQL Vision. If in future have any changes e.g. employee info, may perform this step again.
+
+1. ☁️ > Sync Cloud..
+2. Click Sync All
+    ![payroll-sync](../../../static/img/integration/vision/setup/sync.png)
+
+
+:::info Login
+
+After completing the setup, you can proceed to log in to the employee account as usual.
+
+:::

docs/integration/vision/gift/manager.md

@@ -107,7 +107,7 @@ To check completed issuances, **toggle on Issued Gifts** to display the latest i
 
 ### Expired Gift
 
-The activation will **fail** if the gift has expired. To activate the gift, the manager must [**update**](#gift-update) its **Redemption Validity End Date**.
+When activating expired gifts, a **new expiry date** must be set for each selected. The expiry date must be **later than the current date**.
 
-|![gift](../../../../static/img/integration/vision/gift/expiredGift.png)|![gift](../../../../static/img/integration/vision/gift/activationFailed.png)                  |
+|![expired gift](../../../../static/img/integration/vision/gift/expiredGift.png)|![activate expired gift](../../../../static/img/integration/vision/gift/activateExpiredGift.png)     |
 |:------------------------------------|:-----------------------------------------------------|

docs/integration/vision/group.md

@@ -39,14 +39,6 @@ Manager can view all the created groups in **Main Dashboard | Manage Group**. In
 2. Edit by changing either the **Group Name**, **Admin**, **Group Leader** and **Group Members**.
 3. Tap **Save** to save the changes, or **Cancel** to discard the changes.
 
-### Delete Group
-
-![Manage Group - Delete](../../../static/img/integration/vision/group/g-delete.png)
-
-1. Swipe **Left** on the group card that you want to delete. Tap **Delete**.
-2. Confirm by tapping **Yes**.
-3. You can also delete a group when editing, on the top right **delete icon**.
-
 ## Apply Group
 
 Group can be applied when creating a [**Target**](task/manager_view/task_creation/target#step-3---participants-information), [**Assignment (Step 3)**](task/manager_view/task_creation/assignment#step-3---participants-information) or an [**Upskill (Step 4)**](upskill/manager_view/upskill-creation#step-4---participants-information).

docs/integration/vision/introduction.md

@@ -0,0 +1,27 @@
+---
+sidebar_position: 1
+title: "Introduction"
+---
+
+## What is SQL Vision
+
+SQL Vision is a task management system designed to work with SQL Payroll & SQL Account. With SQL Vision, managers and employees share clear goals, track performance in real time, and get rewards transparently.
+
+Find out more about [SQL Vision](https://www.sql.com.my/sql-vision/)
+
+## Demo
+
+This system supports both **mobile** and **web applications**, allowing users to access the platform across multiple devices.
+
+The **mobile application** is designed for both **users and managers**, providing convenient access to essential features and enabling quick interactions on the go.
+
+The **web application**, on the other hand, focuses more on **management and administrative functionalities**. It provides managers with a more comprehensive interface for monitoring, managing data, and performing administrative tasks.
+
+You can explore the system through the demo links below:
+
+- 🌐 **Web Application Demo**  
+  [WebApp](https://vision.sql.com.my/)
+
+- 📱 **Mobile Application Demo**  
+  [Android](market://details?id=my.com.sql.app.vision)  | 
+  [IOS](https://apps.apple.com/my/app/sql-vision/id6736932365)

docs/integration/vision/linking-to-account.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 10
+sidebar_position: 12
 ---
 
 # Linking to SQL Account
@@ -48,7 +48,7 @@ SQL Vision is linked to SQL Account to get the amount of sales target achieved b
     ![Sync Program](../../../static/img/integration/vision/account/get-otp-and-token.png)
 
 6. Insert the company ID.
-7. Click **Get OTP** .
+7. Click **Get OTP** . (The OTP will be sent to the email set in SQL Payroll > File > Company Profile)
 8. Insert the OTP obtained from the Step 7 into the OTP field.
 9. Click **Get Token**.
 10. Click **Next** to continue the following steps.
@@ -83,7 +83,7 @@ Suppose you’re managing a Sales Department and want to track Q1 sales targets:
 
 ### Pre-defined Strategy
 
-By default, SQL Vision automatically adds two pre-defined strategies to a newly created company, as shown in the image below:
+By default, SQL Vision automatically adds four pre-defined strategies to a newly created company, as shown in the image below:
 
 ![Predefined Strategy](../../../static/img/integration/vision/account/predefined-strategy.png)
 

docs/integration/vision/linking-to-payroll.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 11
+sidebar_position: 13
 ---
 
 # Linking to SQL Payroll

docs/integration/vision/login.md

@@ -1,12 +1,12 @@
 ---
 title: Login
 description: A brief guide on logging into the SQL VISION mobile application
-sidebar_position: 1
+sidebar_position: 3
 ---
 
-1. Enter the user company email address
+1. Enter the user's email address
 
-    ![Login Email](../../../static/img/integration/vision/login/email.png)
+    ![Login Email](../../../static/img/integration/vision/login/loginPage.png)
 
 2. Submit email
 
@@ -17,7 +17,7 @@ sidebar_position: 1
 
 3. **Resend OTP** allows user to request again an One-Time Password(OTP)
 
-    ![Resend OTP](../../../static/img/integration/vision/login/resendOTP.png)
+    ![Resend OTP](../../../static/img/integration/vision/login/requestOTP.png)
 
 4. Verification
     1. Enter the received OTP

docs/integration/vision/main-dashboard.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 4
 ---
 
 # Main Dashboard
@@ -14,23 +14,23 @@ sidebar_position: 2
 
 ### Upskill
 
-- Displays all available courses and courses in which the user is currently enrolled.
+- Displays all available courses and the courses in which the user is currently enrolled.
 
 ### Gantt Chart
 
 - Displays a visual timeline of tasks and deadlines, allowing the user to track progress across project.
 
 ### Wallet
 
-- Displays earned cash and coins, transaction history, and available rewards for redemption.
+- Displays earned cash and coins, transaction history, upcoming payouts and rewards available for redemption.
 
 ### Manage Task
 
-- Allows user to create, edit and update tasks, track task progress and review completed tasks.
+- Allows users to create, edit, and update tasks, track task progress, and review completed tasks.
 
 ### Manage Upskill
 
-- Allows user to create, edit and update courses, track course progress and review completed course.
+- Allows users to create, edit and update courses, track course progress and review completed course.
 
 ### Manage Group
 
@@ -62,7 +62,7 @@ sidebar_position: 2
 
 ![Earned Card](../../../static/img/integration/vision/main-dashboard/earnedCard.png)
 
-- Displays the cash and coin rewards earned by the user for the current or previous month, allowing easy tracking of monthly earnings.
+- Displays the user's cash and coin rewards for the current or previous month, allowing easy tracking of monthly earnings.
 
 ## Account Setting
 
@@ -89,7 +89,7 @@ Details are **view-only** and **cannot be edited** or **modified** from the mobi
 ### Company Configuration (Manager)
 
 - Enables managers to view and modify company settings, including the closing period (days), estimated payout day, and payment strategies.
-- Managers can switch between Default and Customize strategies and use the search bar to quickly locate specific strategies.
+- Managers can view default strategies and configure custom strategies with the Default and Customize tab.
 - For more details about strategy, refer to [**Linking to SQL Account | Strategy**](./linking-to-account.md#strategy).
 
 ![Company Configuration](../../../static/img/integration/vision/account/predefined-strategy.png)
@@ -103,6 +103,22 @@ Details are **view-only** and **cannot be edited** or **modified** from the mobi
 
 ![Switch Company](../../../static/img/integration/vision/main-dashboard/switchCompany.png)
 
+### Storage
+
+- Show the total space used by SQL Vision and provide option to clear cache.
+
+![Storage](../../../static/img/integration/vision/main-dashboard/storage.png)
+
+### Devices
+
+- Displays the devices currently logged into the account and allows users to manually remove any of them, except the current device.
+
+![Devices](../../../static/img/integration/vision/main-dashboard/devices.png)
+
+:::warning NOTE
+*This function is accessible only by using the Vision application.*
+:::
+
 ### Help
 
 - Directs users to SQL Vision’s documentation page for support resources and user guides.

docs/integration/vision/task/_category_.json

@@ -1,6 +1,6 @@
 {
     "label": "Task",
-    "position": 3,
+    "position": 5,
     "link": {
       "type": "generated-index",
       "description": "Guidance to Task Module in SQL Vision."