feat: add etms qr code guide

Author: jialin97

docs/integration/hrms/e-tms/app-usage.md

@@ -13,23 +13,26 @@ Enable **Autostart** for SQL HRMS to ensure E TMS features work accordingly (ref
     ![dashboard](../../../../static/img/integration/hrms/e-tms/dashboard.png)  
 
 - **Session Card:** User's work session shift time
+    - Icon on the top right corner (green box) indicates the clock method (by GPS or QR) of the day. If there is no icon displayed, it means that user is not required to clock for that day  
     - It shows user's first Clock In and last Clock Out of the day with an estimated calculation of late in and early out
     - User can tap on the card to direct to User's Attendance Log
     - User can tap on the ***'Clock In' button*** to direct to Clock In / Clock Out page
-        - If no work session is assigned, the button will be disabled  
+        - If no work session is assigned or no clock method is selected, the button will be disabled  
 - **Upcoming Holiday:** User's upcoming public holidays
 
 
 ## Clock In / Clock Out
 
+### By GPS
+
 | **Button** | **Explanation** |
 | :--------- | :-------------- |
 | ![clock-button1](../../../../static/img/integration/hrms/e-tms/clock-button1.png) | SQL HRMS app's Location service is unable to start. This may due to the following reasons: <br/><br/> 1. User's location service is not enabled <br/> 2. The required location permission is not allowed <br/><br/> Refer [Location Service and Permission](../permission.md#location) |  
 | ![clock-button2](../../../../static/img/integration/hrms/e-tms/clock-button2.png) | SQL HRMS app is trying to get user's current location | 
 | ![clock-button3](../../../../static/img/integration/hrms/e-tms/clock-button3.png) | User is not within work location. However, if user is really within their work location, SQL HRMS app will continuously try to get a more accurate position so that user will be able to Clock In / Clock Out | 
 | ![clock-button4](../../../../static/img/integration/hrms/e-tms/clock-button4.png) | User's location is mocked and is not allowed to Clock In / Out | 
-| ![clock-button5](../../../../static/img/integration/hrms/e-tms/clock-button5.png) | User is within work location and is allowed to Clock In | 
-| ![clock-button6](../../../../static/img/integration/hrms/e-tms/clock-button6.png) | User is within work location and is allowed to Clock Out | 
+| ![clock-button5](../../../../static/img/integration/hrms/e-tms/clock-button5.png) | User is within work location and is allowed to Clock In |  
+| ![clock-button6](../../../../static/img/integration/hrms/e-tms/clock-button6.png) | User is within work location and is allowed to Clock Out |  
 
 **Clock In**  
 
@@ -66,16 +69,48 @@ If user forget to clock out, the app will reset the time tracking after 10 hours
     - An earn replacement leave application will be posted when employee clocked out
     - When employee tap the ***'Clock Out' button***, a **'Claim As Leave'** dialog will be prompt that allows the employee to pick the leave type that they want to claim
 
-    ![clock-out7](../../../../static/img/integration/hrms/e-tms/clock-out7.png)
+    ![clock-out7](../../../../static/img/integration/hrms/e-tms/clock-out7.png)  
+
+### By QR  
+
+| **Button** | **Explanation** |  
+| :--------- | :-------------- |  
+| ![clock-button7](../../../../static/img/integration/hrms/e-tms/clock-button7.png) | SQL HRMS app's Bluetooth service is unable to start. This may due to the following reasons: <br/><br/> 1. User's Bluetooth service is not enabled <br/> 2. The required nearby devices permission is not allowed <br/><br/> Refer [Bluetooth Service and Nearby Devices Permission](../permission#nearby-devices--bluetooth) |  
+| ![clock-button5](../../../../static/img/integration/hrms/e-tms/clock-button5.png) | User is allowed to Clock In |  
+| ![clock-button6](../../../../static/img/integration/hrms/e-tms/clock-button6.png) | User is allowed to Clock Out |  
+
+**Clock In**  
+
+    ![clock-in3](../../../../static/img/integration/hrms/e-tms/clock-in3.png)  
+
+- **'Attachments'** field will not be available  
+- Proceed to Clock In will generate a QR Code that will be scanned by SQL Clock In app  
+    - User can adjust the brightness of the screen with the slider  
+    - The QR Code will only be valid for 20s before user will need to regenerate a new QR Code  
+
+**Clock Out**  
+
+    ![clock-out8](../../../../static/img/integration/hrms/e-tms/clock-out8.png)  
+
+- If ***'Claim OT' switch*** is turned on, it will go through similar OT validations as *By GPS* before QR Code is generated  
+
+:::warning
+Screenshotting the QR Code is not allowed!
+:::
 
 ### Work Location
 
 **Step:** Tap ***'View Work Location' label button***  
 
     ![work-location](../../../../static/img/integration/hrms/e-tms/work-location.png)  
 
+- **Purple Location icon:** Employee's current location
 - **Green Check icon:** Location that the employee is currently in
 
+:::info
+Multiple work locations with the same coordinate will be considered as one
+:::
+
 ## Work Session Calendar
 
 ### My Work Session
@@ -86,7 +121,8 @@ User can view his own work session in calendar view
 
 - **Red font with purple box:** Public Holiday
 - **Purple box:** Rest Day
-- **Location icon:** Direct to Work Location page to view locations where the user is allowed to clock in / clock out on that day (refer [Work Location](#work-location))
+- **Icon (bottom right corner):** Clock Method
+- **Whole card:** Direct to [Work Location](#work-location) page to view locations where the user is allowed to clock in / clock out on that day
 
 ### Team Work Session
 

docs/integration/hrms/e-tms/payroll-setup.md

@@ -66,12 +66,24 @@ Option 2: Click on ***'P' button*** | Select date
 **Step 3:** Enter Break Time
 - May add up to 3 break times
 
-**Step 4:** Select Rules  
-- ***'Clock In / Clock Out' checkbox:*** Requires to clock in / out in SQL HRMS app
-- ***'GPS Monitoring' checkbox:*** Post status update if employee left work location
+**Step 4:** Select a Clock Method
+- ***'GPS' checkbox:*** Clock in / out using employee's location in SQL HRMS app
+- ***'QR' checkbox:*** Clock in / out using QR Code generated from SQL HRMS app and scan it on SQL Clock In app
+
+:::info
+1. Only one clock method can be selected. However, if none of the clock method is selected, then the clock in / out button in SQL HRMS app will be disabled and employee does not require to clock in / out.
+2. Clock Method on days without work session, public holiday and rest day is by default **GPS**.
+:::
+
+**Step 5:** Select Rules  
+- ***'GPS Monitoring' checkbox:*** Post status update if employee left work location 
 - ***'Site Photo' checkbox:*** Requires to take photo before clock in / out (User cannot upload picture from album)
 
-**Step 5:** Save
+:::info
+***'GPS Monitoring'*** and ***'Site Photo'*** will be disabled if ***'QR'*** or ***no clock method*** is selected
+:::
+
+**Step 6:** Save  
 
 **Optional**
 - User may select ***'Leave Rules'*** if applicable

docs/integration/hrms/permission.md

@@ -146,4 +146,54 @@ If you have disabled this feature previously, you can skip all of the following
 
 **Step 2:** Select ***'Allow Full Access'***  
 
-    ![ios-photo3](../../../static/img/integration/hrms/permission/ios-photo3.png)  
+    ![ios-photo3](../../../static/img/integration/hrms/permission/ios-photo3.png)
+
+## Nearby Devices / Bluetooth
+
+### Android  
+
+**From SQL HRMS app**  
+
+:::info
+For **Android 11 and below**, may skip to Step 2  
+:::
+
+**Step 1:** Select ***'Allow'***   
+
+    ![android-bluetooth1](../../../static/img/integration/hrms/permission/android-bluetooth1.png)
+
+**Step 2:** Turn on ***Bluetooth service***  
+
+    ![android-bluetooth2](../../../static/img/integration/hrms/permission/android-bluetooth2.png)
+
+**From Device Settings**  
+
+:::info
+Only for **Android 12 and above**  
+:::
+
+**Step:** App Info | App permissions | Nearby devices | Select ***'Allow'***  
+
+    ![android-bluetooth3](../../../static/img/integration/hrms/permission/android-bluetooth3.png)  
+
+### iOS
+
+**From SQL HRMS app**  
+
+**Step 1:** Select ***'Allow'***  
+
+    ![ios-bluetooth1](../../../static/img/integration/hrms/permission/ios-bluetooth1.png)  
+
+**Step 2:** Select ***'Settings'*** | Toggle ***'Bluetooth'*** on | Return to SQL HRMS   
+
+    ![ios-bluetooth2](../../../static/img/integration/hrms/permission/ios-bluetooth2.png)  
+
+**From Device Settings**  
+
+**Step 1:** Settings | Search for ***'SQL HRMS'*** | Toggle ***'Bluetooth'*** on  
+
+    ![ios-bluetooth3](../../../static/img/integration/hrms/permission/ios-bluetooth3.png)  
+
+**Step 2:** Settings | Bluetooth | Toggle ***'Bluetooth'*** on  
+
+    ![ios-bluetooth4](../../../static/img/integration/hrms/permission/ios-bluetooth4.png)