QSfera/Desktop/test/gui/release-test-plan/testplan.md

Preparation

• create a release or test plan issue in GitHub

• copy each test section of this test plan into a separate comment in the issue

• add links to every section in the main comment

  * [ ] 1. Install, Setup and Configuration @tester1
    -> https://github.com/opencloud-eu/desktop/issues/xxxx#issuecomment-xxxxxxxxx
  * [ ] 2. Folders
    -> ...
  * [ ] 3. Files
    -> ...
  * [ ] 4. Move files and folders
    -> ...
  * [ ] 5. Edit Files
    -> ...
  * [ ] 6. Delete Files and Folders
    -> ...
  * [ ] 7. Sync process
    -> ...
  * [ ] 8. Spaces and Sharing
    -> ...
  * [ ] 9. Pause and resume sync
    -> ...
  * [ ] 10. Advanced configuration
    -> ...
  * [ ] 11. Selective sync
    -> ...
  * [ ] 12. Overlay icons
    -> ...
  * [ ] 13. Context menu
    -> ...
  * [ ] 14. VFS
    -> ...
  

• If not stated otherwise each test should be run on every platform win/linux/mac. Record the result as per platform.

• "Enable logging to temporary folder" and "Log Http traffic" (tab 'Settings', button 'Logs') to have log-files available if needed to report an issue.

• Make sure all automated UI tests run successfully in CI and run them locally on Windows.

• all tests that are automated are marked with a 🤖 in the 'Result' column (for the corresponding platform) and the name of the test in the 'Related Comment' column

• If multiple people are working on the tests at the same time, mark the tests everyone is working on with the GitHub name of the tester.

• Add the test result to the 'Result' column. For success: ✔️, failure: ❌ (link the reported #issue to 'Related Comment')

Testplan

1. Install, Setup and Configuration

Try everything here once with Keycloak and once with Lico (the single binary builtin IdP). To easily run a Keycloak setup, use the deployment examples.

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Update Installation	1. Install a previous version 2. Update to the new version		🚧 Win 🚧 macOS 🚧 Linux
2	Install the new version	Delete any previous version Windows: - Install the desktop client using .exe installer. Mac: - Install the desktop client using .pkg installer Ubuntu or Debian with GNOME desktop: - Run the client as AppImage. Fedora with GNOME desktop: - Run the client as AppImage. All platforms: - Check the version from the Settings tab -> About	installed version is correct	🚧 Win 🚧 macOS 🚧 Linux
3	Verify that you can enter a server address (self signed cert)	1. Launch desktop client 2. Enter a server address 3. Click on Next 4. If it is the first time you should accept the certificate		🤖 Win 🚧 macOS 🤖 Linux	tst_addAccount
4	Valid Login	1. Log in with the correct username and password	Login successful	🤖 Win 🚧 macOS 🤖 Linux	tst_addAccount
5	Invalid Login	1. Try to log in with wrong username or password	Error message Logon failed. Please verify your credentials and try again. is shown	🚧 Win 🚧 macOS 🚧 Linux
6	Skip sync folder	Skip sync folder configuration during setup	Setup is completed, no folder is synced, but can be added later	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
7	Configure sync folder	Configure sync folder configuration during setup	Setup is completed, folder is synced	🤖 Win 🚧 macOS 🤖 Linux	tst_addAccount
8	Remove an account	1. Add an account to desktop client 2. Upload files and folders via WebUI 3. Wait for sync to complete 4. Remove the account	The account is removed from the Desktop client but the files and folder exist on the file system	🤖 Win 🚧 macOS 🤖 Linux	tst_removeAccountConnection
9	re-add an account	1. Add an account to desktop client 2. Upload files and folders via WebUI 3. Wait for sync to complete 4. Remove the account 5. Add the same account again	The account is added, all files and folder are synced	🤖 Win 🚧 macOS 🤖 Linux	tst_addAccount

2. Folders

• 'Go to local sync folder and create a folder' means: "Open folder" on client dot ... menu, create a new folder in file browser
• 'Verify on the server' means: the folder is sent from client to server / check either with web browser or another client

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	create a folder	1. Add an account to desktop client 2. Open local sync folder 3. Create a folder 4. Wait for sync to complete	The folder is available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
2	folder with long name	1. Create a folder with a long name (~100 characters) 2. Wait for sync to complete	The folder is available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
3	folder with special characters	1. Create a folder with special characters and emojis (e.g. $%ñ&💥🫨❤️‍🔥) in the local sync folder 2. Wait for sync to complete	The folder is available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
4	folder with many subfolders	1. Inside the sync root, create a folder with 5 empty subfolders and 5 subfolders containing files 2. Wait for sync to complete	All 10 subfolders are available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
5	sync many folders at once	1. Create 400 folders outside the sync root 2. Move those folders into the sync root 3. Wait for sync to complete	All 400 folders are available on the server	🚧 Win 🚧 macOS 🚧 Linux
6	copy of a folder	1. Open local sync folder 2. Create a folder with some files in it 3. Copy and paste that folder 4. Wait for sync to complete 5. Check the folders and the content of file inside it	Both original and copied folders are available and contains the file on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
7	subfolder with long name	1. Open local sync folder 2. Create a folder 3. Create a subfolder with long name (~220 characters) 4. Wait for sync to complete	Folder and subfolder are available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
8	pre-existing folders	1. Quit the desktop client 2. Goto the local sync folder 3. Create folders at several levels 4. Open the desktop client 5. Wait for sync to complete	All folders are available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
9	.zip/.rar files with elaborate internal folder structures	1. Create a zip file with many internal folders and files 2. Copy that zip file into the sync root 3. Unzip that zip file inside the sync root	All extracted files and folders are available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
10	Invalid system names	1. On the server, create folders CON, COM1 and test% and files PRN and foo% 2. Add that account to the desktop client	- MacOS client syncs down CON, COM1 and PRN but not test% and foo% - Windows client syncs down test% and foo% but not CON, COM1 and PRN - Linux client syncs down all	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
11	Long path on Windows	1. Make sure LongPathsEnabled in Windows registry is 'off' (see https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=cmd) 2. On the server, create a file (~30 chars) inside 6 subfolders (each ~50 chars) to get a path length > 260 chars (> MAX_PATH) 3. Start desktop client 4. Open local sync folder and enter the subfolders 5. Create a new file	1. All subfolders and the file are available in the local sync folder 2. New file is synced to the server	🚧 Win

3. Files

Note: "Via Web" means check files on server in the web browser

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	create a file	1. Add an account to desktop client 2. Open local sync folder 3. Create a file	- observe a BLUE progress icon followed by a GREEN icon in the file explorer - the file is available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
2	Add various types of files	1. Open local sync folder 2. Create/upload various types of files Microsoft Word, Microsoft Excel, Microsoft Powerpoint, JPG, PNG, JPEG, PDF, MP3, MP4, etc	- the Sync files tab shows all the files as synced - all files are available on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
3	File with long name can be synced	1. Open local sync folder 2. Create a file with long name: thisIsAVeryLongFileNameToCheckThatItWorks-thisIsAVeryLongFileNameToCheckThatItWorks-thisIsAVeryLongFileNameToCheckThatItWorks-thisIsAVeryLongFileNameToCheckThatItWorks-thisIsAVeryLongFileNameToCheckThatItWorks-thisIs.txt	Sync is successful	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
4	copy/drag&drops multiple files at a time	1. Copy some files to the local sync folder 2. Drag&Drop some files to the local sync folder	- user can see the completed GREEN icon overlay on all types of files - the Sync files tab shows all files as synced	🚧 Win 🚧 macOS 🚧 Linux
5	Sync files (from server and desktop client) at the same time	1. Add a (big) file inside of the local sync folder, and in the same time, upload another file through the webUI in the same folder (make sure that both files are uploaded at the same time)	Both files are synced correctly. Check via Web UI and the Desktop Client	🚧 Win 🚧 macOS 🚧 Linux
6	Same name files but with different extensions	1. Open local sync folder 2. Create two files with same name but different extensions	Both files sync correctly	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
7	File with spaces in the name	1. Open local sync folder 2. Create, copy or move a file (having space in its name) in the local sync folder	File syncs correctly	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
8	Create and delete a file with special characters in the name	1. Open local sync folder 2. Create/upload a file with special characters in its name (e.g. ~`!@#$^&()-_=+{[}];',$%ñ&💥🫨❤️‍🔥) 3. Wait for sync to complete 4. Delete the file from the local sync folder	Look via the Web and make sure that the file got deleted	🚧 Win 🚧 macOS 🤖 Linux	tst_deleteFilesFolders
9	Upload a 50MB file	1. Create a folder inside the local sync folder 2. Copy a large file (50MB) in this folder	The file is synced to the server	🚧 Win 🚧 macOS 🤖 Linux
10	Upload a 3GB file	1. On the server, upload a large 3GB file 2. Add that account to desktop client	File is synced to the desktop client	🚧 Win 🚧 macOS 🚧 Linux
11	Upload multiple files (with a sum of 1000MB)	1. Open local sync folder 2. Upload a folder containing 1000 files (1MB each)	All files are synced to the server	🚧 Win 🚧 macOS 🤖 Linux	tst_syncing
12	Upload 500MB + 500MB files	1. Open temp folder 2. Create two folders containing 500 files each(1MB per file) 3. Move those folders from temp folder to sync folder 4. Wait for folders to be synced	All folders and files are synced to the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
13	Upload a 1024MB file	1. Open local sync folder 2. Upload a 1GB file	The file is synced to the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing
14	quota limit	1. Open local sync folder 2. Upload the necessary large files to fill up the quota	Warning: "Space quota exceeded. Please contact the Administrator of this space."	🚧 Win 🚧 macOS 🚧 Linux

4. Move files and folders

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Move from sub-levels to root	1. Move couple of files and folders from different sub-levels to the sync root 2. Wait for sync to complete 3. Check the contents of files and folders	The contents are correct (on the server)	🚧 Win 🚧 macOS 🤖 Linux	tst_moveFilesFolders
2	Move a folder and file down to sub-folder	1. Move a folder and file from sync root to a 5 level deep sub-folder 2. Wait for sync to complete 3. Check the content of file and folder exist	The content of the file is correct and folder exists (on the server)	🤖 Win 🚧 macOS 🤖 Linux	tst_moveFilesFolders
3	Move a folder and file up from sub-folder to the root	1. Move a folder and file from a 5 level deep folder to the sync root 2. Wait for sync to complete 3. Check the content of file and folder exist	The content of the file is correct and folder exists (on the server)	🤖 Win 🚧 macOS 🤖 Linux	tst_moveFilesFolders
4	Move files from one folder to another	1. Move some files from Folder1 to Folder2 2. Wait for sync to complete 3. Check both folders contents	Both folders have the correct content (on the server)	🤖 Win 🚧 macOS 🤖 Linux	tst_moveFilesFolders

5. Edit Files

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Edit a .txt file	1. Create a .txt file in the local sync folder 2. Add some text 3. Wait for it to sync 4. Modify the .txt file and add more content 5. Wait for it to sync	The file at the server had the same content after the sync is completed	🤖 Win 🚧 macOS 🤖 Linux	tst_editFiles
2	Edit a .docx file	1. Create a .docx file in the local sync folder 2. Add some text 3. Wait for it to sync 4. Modify the .docx file and add more content 5. Wait for it to sync 6. Modify the .docx file and add more content 7. Wait for it to sync	The file at the server had the same content after the sync is completed	🤖 Win 🚧 macOS 🤖 Linux	tst_editFiles
3	Edit a .xlsx file	1. Create a .xlsx file in the local sync folder 2. Add some text 3. Wait for it to sync 4. Modify the .xlsx file and add more content 5. Wait for it to sync 6. Modify the .xlsx file and add more content 7. Wait for it to sync	The file at the server had the same content after the sync is completed	🤖 Win 🚧 macOS 🤖 Linux	tst_editFiles
4	Replace a .pdf file	1. Create a .pdf file in the local sync folder 2. Replace it with a same name pdf file having different content 3. Wait for it to sync 4. Modify the .pdf file and add more content 5. Wait for it to sync 6. Modify the .pdf file and add more content 7. Wait for it to sync	The file at the server had the same content after the sync is completed	🤖 Win 🚧 macOS 🤖 Linux	tst_editFiles
5	Edit a file while the folder is renamed	1. Add an account to desktop client that has a folder containing a file in it 2. From the file explorer, open that file and edit it 3. From the web, rename the folder 4. Sync with the oc-worker 5. Do not refresh the browser and download the file edited	The file on the server has the same content	🚧 Win 🚧 macOS 🚧 Linux
6	Rename file and folder at the same time	1. Add an account to desktop client that has a folder containing a file in it 2. From the web, rename that folder and at the same time from the file explorer, rename a file contained in that folder	File and folder should be renamed both in the server and locally	🚧 Win 🚧 macOS 🚧 Linux

6. Delete Files and Folders

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Delete a file	1. On the server, create a file 2. Add that account to the desktop client 3. Open the local sync folder 4. Delete that file	The file is deleted on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_deleteFilesFolders
2	Delete a file with long name	1. On the server, create a file with long name 2. Add that account to the desktop client 3. Open the local sync folder 4. Delete that file	The file is deleted on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_deleteFilesFolders (Maximum length of filename is 228 chraracter)
3	Delete a folder	1. On the server, create a folder 2. Add that account to the desktop client 3. Open the local sync folder 4. Delete that folder	The folder is deleted on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_deleteFilesFolders
4	Delete a folder with long name	1. On the server, create a folder with long name 2. Add that account to the desktop client 3. Open the local sync folder 4. Delete that folder	The folder is deleted on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_deleteFilesFolders
5	Delete multiple files	1. On the server, create some files 2. Add that account to the desktop client 3. Open the local sync folder 4. Delete some files	The files get deleted on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_deleteFilesFolders
6	Delete a large file (2048MB)	1. On the server, create a large file (2048MB) 2. Add that account to the desktop client 3. Open the local sync folder 4. Delete that file	The file gets deleted on the server	🚧 Win 🚧 macOS 🚧 Linux

7. Sync process

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Move a file while in sync	1. Move couple of files (File1 and File2) with different contents to the root sync folder 2. Let them sync 3. Move other files to the root sync folder and while in sync, delete File1 and rename File2 toFile1	The content of file is correct	🚧 Win 🚧 macOS 🚧 Linux
2	Edit a file while in sync	1. Create a .txt file with some content 2. Let it sync 3. Rename the file and while in sync, edit the content of the .txt file	The content of file is correct	🚧 Win 🚧 macOS 🚧 Linux
3	Delete folders while in sync	1. Create folders tree folders+subfolders (e.g folder1, folder2, folder3 and some .txt files in this folder) 2. Delete some folders while in sync	Folders get deleted on the server	🚧 Win 🚧 macOS 🚧 Linux
4	Delete folders while sync with two clients	1. Create a tree of folders+subfolders (e.g folder1, folder2, folder3 and some .txt files in this folder) 2. Delete some folders and while in sync, sync with another client at the same time	On the server, make sure that the folders got deleted and the remaining folders sync correctly	🚧 Win 🚧 macOS 🚧 Linux

8. Spaces and Sharing

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Viewer can view files in Space	1. On the server, create a space, upload a file in it and add a user with Viewer role 2. As a space member (Viewer), add that space to the desktop client 3. Open the local sync folder and open that file	The file can be opened	🤖 Win 🚧 macOS 🤖 Linux	tst_spaces
2	Viewer cannot edit files in Space	1. On the server, create a space, upload a file in it and add a user with Viewer role 2. As a space member (Viewer), add that space to the desktop client 3. Open the local sync folder 4. Edit that file and save it	Changes are not synced. Locally a conflicted copy is created	🤖 Win 🚧 macOS 🤖 Linux	tst_spaces
3	Editor can rename files in Space	1. On the server, create a space, upload a file in it and add a user with Editor role 2. As a space member (Editor), add that space to the desktop client 3. Open the local sync folder 4. Rename that file	The files is renamed and synced	🤖 Win 🚧 macOS 🤖 Linux	tst_spaces
4	Manager can add new folders in Space	1. On the server, create a space, upload a file in it and add a user with Manager role 2. As a space member (Manager), add that space to the desktop client 3. Open the local sync folder 4. Create a new folder	New folder is synced	🤖 Win 🚧 macOS 🤖 Linux	tst_spaces
5	Remove a project space sync connection	1. On the server, create a space, upload a file in it and add a user with Manager role 2. As a space member (Manager), add that space to the desktop client 3. Wait till all files and folder are synced 4. Remove the space from the desktop client	Space is deleted from the list, all files and folders still exist in the local sync folder	🤖 Win 🚧 macOS 🤖 Linux	tst_spaces
6	sync a received shared folder can view(secure)	1. On the server, create a folder 2. upload some files into it 3. Share the folder with an other user with can view(secure) permissions 4. As the share receiver, add the "Shares" space to the desktop client 5. create folders locally in the received share 6. copy files into the received local folder	Folder is shown, but no files are synced in ether direction, error message shown by the client	🚧 Win 🚧 macOS 🚧 Linux
7	sync a received shared folder can view	1. On the server, create a folder 2. upload some files into it 3. Share the folder with an other user with can view permissions 4. As the share receiver, add the "Shares" space to the desktop client 5. create folders locally in the received share 6. copy files into the received local folder	Folder and files are downloaded, but no folder/files are uploaded to the server, error message shown by the client	🤖 Win 🚧 macOS 🤖 Linux	tst_spaces
8	sync a received shared folder can upload	1. On the server, create a folder 2. upload some files into it 3. Share the folder with an other user with can upload permissions 4. As the share receiver, add the "Shares" space to the desktop client 5. create folders locally in the received share 6. copy files into the received local folder 7. edit a local file	Folder and files are synced in both directions, but editing results in a new conflict file and the change is not uploaded	🚧 Win 🚧 macOS 🚧 Linux
9	sync a received shared folder can edit	1. On the server, create a folder 2. upload some files into it 3. Share the folder with an other user with can edit permissions 4. As the share receiver, add the "Shares" space to the desktop client 5. create folders locally in the received share 6. copy files into the received local folder 7. edit a local file	Folder and files are synced in both directions	🚧 Win 🚧 macOS 🤖 Linux	tst-spaces
10	remove a share	1. On the server, create a folder 2. upload some files into it 3. Share the folder with an other user with can edit permissions 4. As the share receiver, add the "Shares" space to the desktop client 5. wait till the folder is synced locally 6. Delete the share on the server	Folder and files disappear from the local sync folder	🚧 Win 🚧 macOS 🤖 Linux
11	remove a share while offline	1. On the server, create a folder 2. upload some files into it 3. Share the folder with an other user with can edit permissions 4. As the share receiver, add the "Shares" space to the desktop client 5. wait till the folder is synced locally 6. Disconnect from the server e.g. by disconnecting from the internet 7. Add a new file to the shared folder locally 8. Delete the share on the server 9. reestablish the connection to the server	Files or folder are deleted locally	🚧 Win 🚧 macOS 🚧 Linux
12	Viewer creates folder in a project space	1. On the server, create a project space 2. Add an user in that space with Can view permission role. 3. As a space member (Viewer), add that space to the desktop client 4. Open the local sync folder and create a folder	Folder is blacklisted	🚧 Win 🚧 macOS 🤖 Linux

9. Pause and resume sync

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Sync after reestablishing the connection	1. Add an account to the desktop client 2. Disconnect from the server e.g. by disconnecting from the internet 3. Copy several files and folders into the sync folder 4. reestablish the connection to the server 5. Wait for sync	The files and folder are synced to the server	🚧 Win 🚧 macOS 🚧 Linux
2	Merge folder content after reestablishing the connection	1. Add an account to the desktop client 2. Disconnect from the server e.g. by disconnecting from the internet 3. Upload a folder with some files to the server e.g. by the webUI or an other client 4. In the local sync folder, create a folder with the same name but different files 5. reestablish the connection to the server 6. Wait for sync	All files and folder are synced to the server and to the local sync folder	🚧 Win 🚧 macOS 🚧 Linux
3	Deletion after reestablishing the connection	1. Add an account to the desktop client 2. Disconnect from the server e.g. by disconnecting from the internet 3. Delete a folder from the local sync folder 4. Connect the Internet 5. Wait for sync	The folder is deleted from the server	🚧 Win 🚧 macOS 🚧 Linux
4	manually pause/resume a sync	1. Add an account to the desktop client 2. Upload big files to the server into a project space & personal space via WebUI 3. Copy other big files into the local sync folder of the project space & personal space 4. Pause the sync while files are uploaded/downloaded 5. Resume the sync.	All files are folders are synced correctly in both directions	🚧 Win 🚧 macOS 🚧 Linux
5	Force a sync while an Upload to a different space is running	1. Add an account to the desktop client 2. Copy small files into the local sync folder of a project space 3. Copy big files into the local sync folder of the personal space 4. Wait till the project space sync is finished and personal space sync still runs 5. Force a sync of the project space.	All files are folders are synced correctly in both directions	🚧 Win 🚧 macOS 🚧 Linux
6	Force a sync while Download from a different space is running	1. Add an account to the desktop client 2. Upload small files into a project space using the webUI 3. Upload big files into a personal space using the webUI 4. Wait till the project space sync is finished and personal space sync still runs 5. Force a sync of the project space.	All files are folders are synced correctly in both directions	🚧 Win 🚧 macOS 🚧 Linux
7	Conflicting file	1. Add an account to the desktop client 2. save a file in the local sync folder 3. Disconnect from the server e.g. by disconnecting from the internet 4. Edit the same file locally and on the server 4. reestablish the connection to the server 5. Wait for sync	Conflict file are created locally and on the server	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing

10. Advanced configuration

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Advanced configuration	1. Start the desktop client and fill in the server details 2. Check the advanced configuration checkbox	Download everything option is selected	🤖 Win 🚧 macOS 🤖 Linux	tst_addAccount
2	Configure synchronization manually	1. Start the desktop client and fill in the server details 2. Check the advanced configuration checkbox 3. choose Configure synchronization manually 4. Connect the account 5. Choose a space and a local folder	The space is synced into the chosen folder	🤖 Win 🚧 macOS 🤖 Linux	tst_addAccount
3	Configure synchronization manually, a space	1. Start the desktop client and fill in the server details 2. Check the advanced configuration checkbox 3. choose Configure synchronization manually 4. Connect the account 5. Choose "Cancel" in the next screen	- No local sync folder is created - The setting window is opened and the account is registered	🤖 Win 🚧 macOS 🤖 Linux	tst_syncing

11. Selective sync

Note

Selective sync is not available on Windows due to VFS implemented by default.

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	sync only one folder	1. Upload some files and folders to the server 2. add an account to the desktop client with manual sync configuration 3. Choose the personal space to be synced 4. choose a local folder 5. Select only one folder to be synced and add the connection	Only one folder is synced	🚧 macOS 🤖 Linux	tst_syncing
2	unselected subfolders	1. Upload a folder that has many subfolders to the server 2. Connect the desktop client and sync the personal space From the ... button for the space select "Chose what to sync" window, select the folder that has many subfolders 3. Extend that folder and unselect some subfolders 3. Click "OK"	The parent folder is synced but not the unselected subfolders	🚧 macOS 🤖 Linux	tst_syncing
3	Folder without subfolder in the list	1. From the Deselect remote folders... window, click on the > for a folder that does not have subfolders	the > disappears	🚧 macOS 🚧 Linux
4	sync files both ways for selected folder	1. From the Deselect remote folders... window, select a folder to sync and add the connection 2. Upload some files via webUI into that folder 3. Copy some other files into the corresponding local folder 4. Wait for sync	Files are synced both ways	🚧 macOS 🚧 Linux
5	sync files for unselected folder	1. From the Deselect remote folders... window, unselect a folder and add connection 2. From the server, upload some files in that unselected folder	The folder and files are not available in the sync folder Previously synced folders are deleted	🚧 macOS 🤖 Linux	tst-syncing
6	sync of files in root folder	1. From the Deselect remote folders... window, unselect all the folders 2. Add the connection	files that are in the root folder are synced	🚧 macOS 🚧 Linux
7	sorting of folders	1. In the Deselect remote folders... window, sort the folders by name and size	Sorting works	🚧 macOS 🤖 Linux	tst_syncing

12. Overlay icons

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	overlay icons	1. Launch the Desktop client 2. Open the file explorer	Check qsfera overlay icons are present.	🚧 Win
2	offline state	1. Disconnect from the server e.g. by disconnecting from the internet 2. Launch the Desktop client 3. Check the overlay icons in the local sync folder	The overlay icons are not shown	🚧 Win
3	paused sync	1. Launch the Desktop client 2. Check the overlay icons 3. Pause the sync 4. Check the overlay icons	The overlay icons disappear	🚧 Win
4	everything synced	1. Open the local sync folder 2. Add a folder having multiple nested files and folders 3. Check the overlay icons	The green check is shown in all the folders/files	🚧 Win
5	sync in progress	1. Open the local sync folder 2. Add some files and folders 3. Check the overlay icons	The files/folder that are waiting to sync have the blue icons	🚧 Win
6	warning during sync	1. Open the local sync folder 3. Add a problematic file (path longer than 255 characters) 3. Check the overlay icons	The files that are not synced due to a problem have the yellow warning triangle icons	🚧 Win
7	fatal error during sync	1. Open the local sync folder 3. Create a sync error 3. Check the overlay icons	The files/folders that are not synced due to a fatal problem have the red error icons	🚧 Win

13. Context menu

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Sharing	1. Open the context menu of a synced file 2. Click on "Share ..."	A browser window opens and takes the user to the sharing page of the file	🚧 Win 🚧 macOS 🚧 Linux
2	Private Link	1. Open the context menu of a synced file 2. Click on "Copy private Link to clipboard" 3. Paste the link from the clipboard into a browser window	The browser takes the user to the file	🚧 Win 🚧 macOS 🚧 Linux
3	Show in web browser	1. Open the context menu of a synced markdown file 2. Click on "Show in web browser"	A browser window opens and takes the user to the file, opened in the markdown editor	🚧 Win 🚧 macOS 🚧 Linux
4	file versions	1. Open the context menu of a synced markdown file 2. Click on "Show file versions in web browser"	A browser window opens and takes the user to the file, with the side bar opened, showind the versions	🚧 Win 🚧 macOS 🚧 Linux

14. VFS

Note

“Always keep on this device” = you’ve pinned the file locally, so it stays on your device at all times and won’t be evicted automatically.
“Available on this device” = the file is locally present now, but may be removed automatically to free up space.
“Hydrated (full) file” = the file’s full data is present locally (downloaded or created), and you can convert it into a placeholder (dehydrated) by using the ‘Free up space’ action; additionally, the system could later turn it into a placeholder automatically if space is needed.
“Dehydrated (placeholder) file” = the file appears locally but only as a lightweight placeholder with minimal footprint; actual data isn’t downloaded until accessed.
The following image demonstrates how the full pinned, full and placeholder file states are shown in File Explorer:

1. Full Pinned.txt = Always keep on this device
2. Full.txt = Available on this device (Hydrated)
3. Placeholder.txt = Placeholder (Dehydrated)

ID	Test Case	Steps to reproduce	Expected Result	Result	Related Comment (Squish-test)
1	Add account and connect to server	1. Create two files with some content inside a folder in the server 2. Add an account to the desktop client 3. Open local sync folder and check status of all resources (2 files and their parent folder)	All resources (2 files and their parent folder) are virtual (Status: dehydrated)	🚧 Win
2	Open a file	1. Create a file with some content in the server 2. Add an account to the desktop client 3. Open local sync folder and open that file 4. Create a new file locally in the local sync folder, edit, save and exit it	Both files are physically available (Status: hydrated)	🚧 Win
3	Free up space	1. Create several new files in a new folder inside local sync folder 2. Right click on local folder, click on Free up space	Folder along with files are dehydrated. Icon changed to cloud	🚧 Win
4	Always keep	1. Create a file with content inside a local sync folder 2. Right click on that file and click on "Always keep on this device"	File is physically available, same as Always keep on this device	🚧 Win
5	Locked file	1. Create a file with content inside a local sync folder Open it in LibreOffice(LO)(Opening a resource in LO makes it locked), edit and save but don't exit 2. 'Free up space' in Explorer on the locked file → no error message, client shows "i" (Status: spinning icon), Activity tells that file is in use 3. Exit libreoffice	File is dehydrated correctly (Status: placeholder) after few seconds	🚧 Win
6	Move file and directory locally	1. Create a file and a directory (with some files) inside the local sync root (some hydrated, some dehydrated) 2. Move (Cut + Paste) the file and the directory to a different folder inside the sync root	Both hydrated and dehydrated items are moved accordingly on the server (i.e., the same structure appears on the server)	🚧 Win
7	Move file and directory outside sync root	1. Create a folder inside the sync root (which may be hydrated or dehydrated) 2. Move this folder to a location outside the sync root	The folder is removed on the server as well and no residual placeholder remains locally	🚧 Win
8	Move file/directory on the server	1. Within the server (via web UI) move a file and a directory (including some dehydrated files) from one location to another	The local sync root reflects the move: both hydrated and dehydrated files show up in the new location and removed from the old location	🚧 Win
9	Remove directory while the file is still open locally	1. Create a directory inside local sync folder; create a file inside and open it in LibreOffice (LO) (file locked) 2. On the server, delete/remove the directory 3. While LO is still open, edit and save the file 4. Close LO	After closing LO, the directory and file are recreated locally (and synced to server)	🚧 Win
10	File name clash due to same name (but different case) in folder	1. On the server: create a folder FolderA. 2. Inside FolderA create two files with identical names (e.g., NewFile and Newfile) 3. On the client: monitor sync and observe warning message: “file name clash…” appears for some seconds. 4. In the local sync folder: open FolderA and check status of both files and the folder. 5. Move FolderA from the sync-root to another location outside the sync-root	The client first displays the “file name clash” warning and lists the clash in Activity tab under “Not synced”. The folder FolderA and the file(s) show a placeholder/cloud icon status. After moving FolderA outside the sync-root, the file that had previously been synced will be deleted locally and from the server, and the file that had not synced will now be synced and present inside FolderA both on the server and locally.	🚧 Win