Documentation

Field PWA

Verified field/mobile routes and offline sync primitives in the PWA frontend.

Status: VerifiedSources: 3

The field PWA exposes protected operator routes under /app/field. Implemented route entries include measurements, movements, sync, and placeholders for well shutdowns and well tests. Offline state is tracked with a sync queue store that counts pending, syncing, rejected, and synced items.

  • The PWA redirects legacy /app/admin/* traffic toward the admin surface for active admin sessions.
  • The sync store can add queue items, retry rejected items, refresh pending/error counts, and request a sync run.
  • The offline route is explicitly registered at /offline.

Pending validation

  • Browser service-worker registration and background sync behavior should be validated in a real PWA install context.
  • Conflict resolution semantics for queued records need workflow-level review before being documented as guarantees.

Source basis

  • services/frontend-pwa/src/app/router/index.tsx
  • services/frontend-pwa/src/lib/sync/sync-store.ts
  • services/frontend-pwa/src/lib/db/index.ts