Troubleshoot offline sync
Audience: Front desk
Objective: Recover queued check-in/out and HK updates after a network drop.
Symptoms
- Action said it was saved offline
- Queue not clearing
- “Server won - refresh” after sync
Likely causes
| Cause | How to check |
|---|---|
| Still offline | Browser network indicator |
| Action not queueable | Only check-in, check-out, HK task patch, POS post-to-folio queue |
| Conflict 409 | Server state changed; refresh and redo |
| Max retries | Item stuck after repeated failures |
Fix
- Restore connectivity.
- Use Sync now if shown.
- On conflict, refresh the board and re-apply the correct state manually.
- Never assume night audit queued - run it online.
Related
- Offline & PWA
- For engineers:
docs/features-shipped/OFFLINE-MODE.md