Indicator Location
The sync indicator is located on the right side of the application's top bar (topbar). It is always visible and shows the current connection and data synchronization status.
Indicator Statuses
Online (green)
The device is connected to the internet and all data is synchronized with the server. This is the normal state.
The indicator displays as a green dot or connection icon.
What it means:
- Connection to the server is established
- No pending changes
- All data is up to date
Offline (amber)
The device is not connected to the internet. The application is working with local data.
The indicator displays as an amber (orange) dot or disconnection icon.
What it means:
- No connection to the server
- The application is working with cached data
- All new changes are saved locally
- Synchronization will start automatically when connectivity is restored
Syncing (animated)
Synchronization is in progress -- local changes are being sent to the server.
The indicator displays as an animated (pulsing) sync icon.
What it means:
- Connectivity has been restored or manual sync was triggered
- Pending changes are being sent to the server in chronological order
- The process usually takes a few seconds
Pending Changes Counter
A number is displayed next to the indicator -- the count of changes awaiting synchronization. Each action performed offline increases the counter by one:
- Check-in mark -- +1
- Manual payment mark -- +1
- Registration status change -- +1
Display examples:
- Green dot with no number -- everything is synchronized
- Amber dot + 3 -- offline, 3 changes pending
- Animation + 3 -> 2 -> 1 -> 0 -- synchronization in progress, changes being sent
When the counter reaches zero, the indicator switches to the green status.
What is pendingSync
Each change made offline receives a pendingSync=true flag in the local database. This flag means:
- The change has been saved locally
- The change has not yet been sent to the server
- It will be transmitted during the next synchronization
After successfully being sent to the server, the flag is removed (pendingSync=false), and the record is considered synchronized.
Manual Synchronization
In addition to automatic synchronization when connectivity is restored, you can trigger sync manually:
- Click on the sync indicator in the top bar.
- A details panel will open with information:
- Current connection status
- Number of pending changes
- Time of the last successful synchronization
- Click the Sync button.
Manual sync is useful when:
- You want to make sure all data has been sent before closing the application
- Automatic sync did not trigger after connectivity was restored
- You want to verify that synchronization is working correctly
If the device is offline, the "Sync" button will be disabled.
Sync Notifications
The application shows toast notifications for key synchronization events:
| Event | Notification |
|---|---|
| Connection lost | "You are offline. Data is being saved locally" |
| Connection restored | "Connection restored. Syncing..." |
| Successful sync | "All data synchronized" |
| Sync error | "Sync error. Retrying in 30s" |
| Data conflict | "Conflict detected. Your input is needed" (Business+) |
Recommendations
- Do not close the application immediately after working offline. Wait until the pending changes counter reaches zero.
- Check the indicator before the event starts. Make sure data is up to date (green status).
- During extended offline work, periodically check the counter. A large number of pending changes (50+) may slow down synchronization when connectivity is restored.