Skip to content

Commit 17c12bf

Browse files
songlim327songlim327
authored
Merge pull request #2 from jssql1234/visiondocs
feat: add vision documentation
2 parents 2444911 + 0773e5f commit 17c12bf

File tree

218 files changed

+2139
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

218 files changed

+2139
-0
lines changed

‎docs/integration/vision/_category_.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "SQL Vision",
3+
"position": 4,
4+
"link": {
5+
"type": "generated-index",
6+
"description": "SQL Vision related topics"
7+
}
8+
}

‎docs/integration/vision/gift/_category_.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "Gift",
3+
"position": 8,
4+
"link": {
5+
"type": "generated-index",
6+
"description": "Guidance to create Gift and redeem Gift in SQL Vision."
7+
}
8+
}

‎docs/integration/vision/gift/introduction.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Gift Introduction
6+
7+
The Gifts feature, accessible through **Main Dashboard > Wallet > Gifts**, allows managers to create digital gifts. All users can then redeem these gifts using coins earned by completing missions.
8+
9+
|![gift](../../../../static/img/integration/vision/gift/giftIntro1.png)|![gift](../../../../static/img/integration/vision/gift/giftIntro2.png)|
10+
|:--------------------------------|:--------------------------------|
11+

‎docs/integration/vision/gift/manager.md‎

Lines changed: 117 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,117 @@
1+
---
2+
sidebar_position: 3
3+
---
4+
5+
# Manager
6+
:::info[Note]
7+
8+
These feature is only available to **manager**.
9+
10+
:::
11+
12+
## Gift Creation
13+
:::info[Note]
14+
After a manager creates a gift, users receive a notification about the new gift.
15+
:::
16+
To add a new gift, managers can go to **More icon> Add Gift**.
17+
18+
![gift](../../../../static/img/integration/vision/gift/gotoAddGift.png)
19+
20+
### 1. Gift Redemption Details
21+
22+
![gift](../../../../static/img/integration/vision/gift/addGiftStep1.png)
23+
24+
| Properties | Description | Note |
25+
|:-----------------------------|:-----------------------------------------------------------------------------------|:--------:|
26+
| **1.0 Name** | The name of the gift. | Required |
27+
| **1.1 Description** | A detailed description of the gift. | Required |
28+
| **1.2 Terms & Conditions** | To specify the rules, requirements, guidelines, and limitations that the user must agree to in order to redeem the gift. | Required |
29+
| **1.3 Redemption Validity Start Date** | The first date when the gift can be redeemed. | Required |
30+
| **1.4 Redemption Validity End Date** | The last date when the gift can be redeemed. | Required |
31+
| **1.5 Clear** | Clears all content on the current page. | - |
32+
| **1.6 Next** | Navigates to the previous page. | - |
33+
34+
### 2. Gift Redeemption Criteria
35+
36+
![gift](../../../../static/img/integration/vision/gift/addGiftStep2.png)
37+
38+
| Properties | Description | Note |
39+
|:-----------------------------|:-----------------------------------------------------------------------------------|:--------:|
40+
| **2.0 Redeem Coins** | To specify the amount of coins required to redeem the gift. | Required |
41+
| **2.1 Category** | To select a category to classify the gift, such as Uncategorised, Food & Beverages, Shopping, Service, Entertainment, Digital Goods, or Travel Accommodation. | Required |
42+
| **2.2 Available Quantity** | To specify the total number of units of the gift that are available for redemption. | Required |
43+
| **2.3 Max Allowable Redemption Per Employee** | To specify the maximum number of times a user can redeem the gift.| Required |
44+
| **2.4 Attactment** | To upload an image associated with the gift, such as a product photo or promotional graphic, through the mobile's camera or gallery. | - |
45+
| **2.5 Clear** | Clears all content on the current page. | - |
46+
| **2.6 Back** | Navigates to the previous page. | - |
47+
| **2.7 Create** | To submit and create the new gift entry after filling in all required details. | - |
48+
49+
50+
## Gift Update
51+
52+
53+
### 1. Choose Gift
54+
55+
To update a gift, the manager can go to **More icon > Manage Gift** and select the gift want to be update.
56+
|![gift](../../../../static/img/integration/vision/gift/gotoManageGift.png)|![gift](../../../../static/img/integration/vision/gift/chooseEditGift.png) |
57+
|:------------------------------------|:-----------------------------------------------------|
58+
59+
### 2. Update Gift Details
60+
In step 2 of edit mode, the user can update the gift's status using the **"Set as Active"** field.
61+
62+
:::info[Note]
63+
64+
The **Active** status can only be set if the Redemption Validity End Date is **on or after** the the current date.
65+
66+
:::
67+
68+
|![gift](../../../../static/img/integration/vision/gift/editGiftStep1.png)|![gift](../../../../static/img/integration/vision/gift/editGiftStep2.png) |
69+
|:------------------------------------|:-----------------------------------------------------|
70+
71+
## Gift Issue
72+
73+
### 1. Choose Gift Issuance Request
74+
75+
The gift can only be issued after the user has redeemed it. To issue a gift, the manager can go to **More icon > Manage Redemption** and select a gift issuance request.
76+
77+
|![gift](../../../../static/img/integration/vision/gift/gotoManageRedemption.png)|![gift](../../../../static/img/integration/vision/gift/chooseIssueGift.png) |
78+
|:------------------------------------|:-----------------------------------------------------|
79+
80+
### 2. Confirm Issuance
81+
After clicking **Issue**, select **Confirm** to complete issuing the gift.
82+
|![gift](../../../../static/img/integration/vision/gift/issueConfirmation.png)|![gift](../../../../static/img/integration/vision/gift/doneIssuedGift.png) |
83+
|:------------------------------------|:-----------------------------------------------------|
84+
85+
### 3. Check Issuance
86+
87+
To check completed issuances, **toggle on Issued Gift**s to display the latest issued gift.
88+
89+
|![gift](../../../../static/img/integration/vision/gift/gotoIssuedPage.png)|![gift](../../../../static/img/integration/vision/gift/checkIssuance.png) |
90+
|:------------------------------------|:-----------------------------------------------------|
91+
92+
93+
## Manage Gift
94+
95+
### 1. Gift Status
96+
97+
|Active Gifts|Inactive Gifts |
98+
|:--------------------------------|:---------------------------------|
99+
|![gift](../../../../static/img/integration/vision/gift/activeGift.png)|![gift](../../../../static/img/integration/vision/gift/inactiveGift.png)|
100+
101+
|Propertise|Description|
102+
|:--------------------------------|:--------------------------------|
103+
|**1.0 Inactive Gifts Switch - Toggle Off**|Displays all active gifts.|
104+
|**1.1 Deactivate**|Deactivate all currently selected active gifts|
105+
|**1.2 Inactive Gifts Switch - Toggle On**|Displays all inactive gifts.|
106+
|**1.3 Active**|Activate all currently selected inactive gifts|
107+
108+
### 2. Expired Gift
109+
110+
The activation will **fail** if the gift has expired. To activate the gift, the manager must [**update**](#2-update-gift-details) its **Redemption Validity End Date**.
111+
112+
|![gift](../../../../static/img/integration/vision/gift/expiredGift.png)|![gift](../../../../static/img/integration/vision/gift/activationFailed.png) |
113+
|:------------------------------------|:-----------------------------------------------------|
114+
115+
116+
117+

‎docs/integration/vision/gift/user.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
sidebar_position: 2
3+
---
4+
5+
# User
6+
7+
:::info[Note]
8+
9+
These feature are available to both **manager** and **employee**.
10+
11+
:::
12+
13+
## Gift Redeem
14+
### 1. Gift Filter Type
15+
16+
|Gift Category Filter Chip|Filter Drawer|
17+
|:--------------------------------|:--------------------------------|
18+
|![gift](../../../../static/img/integration/vision/gift/filterChip.png)|![gift](../../../../static/img/integration/vision/gift/filterDrawer.png)|
19+
20+
|Propertise|Description|
21+
|:--------------------------------|:--------------------------------|
22+
|**1.0 Gift Category Filter Chip**|Displays all gifts that match any of the chosen categorie.|
23+
|**1.1 Clear**| Deselect all the selected filter option.|
24+
|**1.2 Shop By Price Filter**|Display gifts that match any of the chosen specific price ranges.|
25+
|**1.3 Sort by Featured**|Display the gifts bassed on popularity in descending order.|
26+
|**1.4 Sort by Newest**|Display the most recently added gifts in descending order.|
27+
|**1.5 Sort by Price: High-to-Low**|Display gifts from expensive to cheap.|
28+
|**1.6 Sort by Price: Low-to-High**|Display gifts from cheap to expensive.|
29+
|**1.7 Reset**|Select all the filter options again.|
30+
31+
32+
### 2. Choose gift
33+
Choose a gift, and a bottom bar will appear.
34+
:::info[Note]
35+
36+
Once the gift has expired, it will no longer be displayed for redemption. The manager will need to [**update**](../gift/manager.md#2-update-gift-details) the redemption validity end date to reactivate the gift for future redemptions.
37+
38+
:::
39+
40+
|![gift](../../../../static/img/integration/vision/gift/chooseGift.png)|![gift](../../../../static/img/integration/vision/gift/redeemGift.png)|
41+
|:--------------------------------|:--------------------------------|
42+
43+
|Propertise|Description|
44+
|:--------------------------------|:--------------------------------|
45+
|**1.0 Validity Duration**|The period during which the gift can be redeemed. The gift will not be available for redemption before or after this period.|
46+
|**1.1 Terms and Conditions**|A clickable text that directs users to the page outlining the rules, requirements, guidelines, and limitations they must agree to in order to redeem the gift.|
47+
|**1.2 Max Redeem**|The maximum quantity of a gift that a user is allowed to redeem. |
48+
|**1.3 Quantity Input Field**|A field that allow users to enter the desired quantity to redeem .It can be adjusted by either entering an amount in the text field or using the plus and minus buttons.|
49+
|**1.4 Redeem**|A button to add the selected gift to the gift cart.|
50+
51+
### 3. Confirm Redemption
52+
After clicking **Redeem**, select **Confirm** to confirm. If the redemption is successful, a success dialog will appear automatically.
53+
54+
|![gift](../../../../static/img/integration/vision/gift/confirmRedeem.png)|![gift](../../../../static/img/integration/vision/gift/redeemSuccess.png)|
55+
|:-----------------------------------|:-----------------------------------|
56+
57+
### 4. View Redemption
58+
To view redeemed gifts, users can go to **Cart icon> MyRedemption**. If a gift shows as **0/1 issued**, it means that **one redemption has been made**, but it **has not yet been issued**.
59+
60+
:::info[Note]
61+
62+
Users will need to wait for approval or issuance from the manager before the gift can be used.
63+
64+
:::
65+
66+
|![gift](../../../../static/img/integration/vision/gift/goRedeemCart.png)|![gift](../../../../static/img/integration/vision/gift/myRedemption.png)|
67+
|:-----------------------------------|:-----------------------------------|
68+
69+
## Redemption Log
70+
Redemption log lets users view a history of redeemed rewards, showing who redeemed each reward and when it was redeemed.
71+
72+
To view the redemption log, users can go to **More icon> Redemption Log**.
73+
74+
|![gift](../../../../static/img/integration/vision/gift/gotoRedemption.png)|![gift](../../../../static/img/integration/vision/gift/redemptionLog.png)|
75+
|:-----------------------------------|:-----------------------------------|

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

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
---
2+
sidebar_position: 9
3+
---
4+
5+
# Linking to SQL Account
6+
7+
## Introduction
8+
9+
SQL Vision are linked to SQL Account to get the amount of sales target achieved by employees.
10+
11+
## Requirement
12+
13+
- SQL Vision Sync
14+
- SQL Account
15+
- SQL Vision
16+
- Internet Access
17+
18+
## Setup
19+
20+
1. **Run SQLVisionSync-Setup.exe**
21+
22+
2. Click **Next | Next | Next | Install**
23+
24+
3. Click **Finish**
25+
26+
## Connect SQL Account and SQL Vision with SQL Vision Sync
27+
28+
![Sync Program](../../../static/img/integration/vision/account/text-connection.png)
29+
30+
1. Insert the SQL accounting DFC file into the corresponding field of SQL Vision Sync. You can find the SQL account DFC file in the path specified within the SQL Account Database of the SQL Accounting Software.
31+
32+
![Sync Program](../../../static/img/integration/vision/account/location-DCF-file.png)
33+
34+
2. Open the dropdown and select the database from the dropdown lsit.
35+
36+
3. Insert the user name and password fields with the SQL Accounting Software user name and password.
37+
38+
4. Click **Test Connection**.
39+
:::info[Hint]
40+
41+
The SQL Accounting Software must be open and logged in during the connection process.
42+
43+
:::
44+
45+
5. Click **Next** to continue the following steps.
46+
47+
48+
![Sync Program](../../../static/img/integration/vision/account/get-otp-and-token.png)
49+
50+
6. Insert the company ID.
51+
7. Click **Get OTP** .
52+
8. Insert the OTP Get from the step 7 into the OTP field.
53+
9. Click **Get Token**.
54+
10. Click **Next** to continue the following steps.
55+
56+
![Sync Program](../../../static/img/integration/vision/account/export-data.png)
57+
58+
11. Select the last export date
59+
12. Click **Export Data**.
60+
13. Once the data is exported, the SQL Vision mobile app will sync and display the data retrieved from the SQL Accounting Software.
61+
62+
:::info[Parameter for SQL Vision Sync]
63+
64+
![Sync Program](../../../static/img/integration/vision/account/export-log-file.png)
65+
66+
:::
67+
68+
## Strategy
69+
70+
The **Strategy** is a formula that helps managers and the application categorize specific targets for each mission. This setup allows the application to accurately retrieve the target amounts associated with a mission from the SQL Account system.
71+
72+
:::tip Example Scenario
73+
74+
<!-- Suppose you’re managing a Sales Department and want to track quarterly targets for different product lines: -->
75+
Suppose you’re managing a Sales Department and want to track Q1 sales targets:
76+
77+
<!-- 1. **Define a Strategy**
78+
Create a strategy named **"Q1 Product Line A Sales"** to track sales targets for Product Line A for the first quarter. -->
79+
80+
1. **Assign Strategy to Mission**
81+
For the mission **"Achieve Q1 Sales Target"**, assign the **"Invoice Based Strategy"** strategy.
82+
<!-- For the mission **"Achieve Q1 Sales Target for Product Line A"**, assign the **"Invoice Based Strategy"** strategy. -->
83+
84+
2. **Automated Target Tracking**
85+
With this setup, the application will automatically retrieve and update the sales progress daily, based on employee achievements recorded in SQL Account. Managers can view this updated progress daily in SQL Vision.
86+
<!-- With this setup, the application will automatically retrieve and update the sales progress for Product Line A daily, based on employee achievements recorded in SQL Account. Managers can view this updated progress daily in SQL Vision. -->
87+
88+
:::
89+
90+
### 1.0 Pre-defined Strategy
91+
92+
By default, SQL Vision automatically adds two pre-defined strategies to a newly created company, as shown in the image below:
93+
94+
![Predefined Strategy](../../../static/img/integration/vision/account/predefined-strategy.png)
95+
96+
If the system encounters an error and fails to create the pre-defined strategies, you can manually add them by navigating to the Company Configuration section. When this issue occurs, SQL Vision will display a dialog box prompting you to add the default strategies manually, as shown in the image below:
97+
98+
![Predefined Strategy-Add](../../../static/img/integration/vision/account/predefined-strategy-add.png)
99+
100+
### 1.1 Creating or Editing a Strategy
101+
102+
Coming Soon.
103+
104+
<!-- Managers can create or modify strategies by navigating to **Main Dashboard > Side Bar > Company Configuration**.
105+
106+
![Company Configuration](../../../static/img/integration/vision/main-dashboard/companyConfiguration.png)
107+
108+
#### 1. Add Strategy
109+
110+
To add a new strategy, follow these steps:
111+
112+
![Add Strategy](../../../static/img/integration/vision/account/strategy-add.png)
113+
114+
| Step | Description |
115+
|:----------------------|:---------------------------------------------------------|
116+
| **1. Add Icon** | Click the add icon to create a new strategy. |
117+
| **2. Text Field** | Enter the name of your strategy. |
118+
| **3. Add Button** | Click the add button to preview the new strategy. |
119+
| **4. Preview** | View your strategy in the preview. Use the X to remove it if needed. |
120+
| **5. Save Button** | Save your new strategy. |
121+
| **6. Cancel Button** | Cancel your creation. |
122+
123+
#### 2. Edit Strategy
124+
125+
To edit an existing strategy, follow these steps:
126+
127+
![Edit Strategy](../../../static/img/integration/vision/account/strategy-edit.png)
128+
129+
| Step | Description |
130+
|:----------------------|:------------------------------------------------------------------|
131+
| **1. Edit Icon** | Click the edit icon to modify an existing strategy. |
132+
| **2. Text Field** | Change the name of the strategy as needed. |
133+
| **3. Edit Button** | Click the edit button to preview your modifications. |
134+
| **4. Preview** | View the strategy in the preview. Use the Edit Icon to re-edit if necessary. |
135+
| **5. Save Button** | Save your updated strategy. |
136+
| **6. Cancel Button** | Cancel the modification. | -->
137+

0 commit comments

Comments
 (0)