Offline & PWA
Audience: Front desk / admin
Objective: Know what still works when the network drops - and what does not.
What it is
Opseno can queue selected write mutations in the browser (IndexedDB) when the network fails, then replay them when online. Housekeeping also has a mobile PWA shell at /hk.
This is an MVP offline queue - not a full offline replica of the entire app.
Mutations that can queue
| Action | Notes |
|---|---|
| Check-in | Queued on network failure |
| Check-out | Queued on network failure |
| Housekeeping task update | Queued on network failure |
| POS post-to-folio | Queued on network failure |
Not queued: reads, night audit, most admin APIs, arbitrary PMS mutations.
Conflict behaviour
On flush, success removes the item. 409 conflicts drop with a “server won - refresh” style message. Retryable errors back off (limited retries).
Common misconceptions
- Offline mode does not mean night audit works offline.
- HK PWA helps mobile housekeeping; it does not replace property Wi-Fi for all modules.