[FEAT]: Offline-first mobile companion app for field incident capture

[utkarshqz]

📝 Description

First responders need to capture incident data at the scene — in basements, forests, and areas with no connectivity. The current FireForm interface requires a station connection, making it unusable in the field. This feature proposes a mobile companion app that works completely offline and syncs automatically when officers return to the station.

💡 Rationale

FireForm's "Report Once, File Everywhere" promise only holds if officers can report from where incidents actually happen. Without offline capture, officers resort to paper notes and manual re-entry — exactly the redundant work FireForm was built to eliminate.

🛠️ Proposed Solution

A Progressive Web App (PWA) served at /mobile by the existing FastAPI server — installable on any phone via "Add to Home Screen", no app store required.

• New mobile/ folder with index.html, manifest.json, sw.js
• Service Worker caches app shell for offline loading
• Voice recording and text notes stored in IndexedDB
• GPS coordinates captured offline via device GPS
• Auto-sync to station on WiFi reconnection
• Audio transcribed via faster-whisper, combined with notes
• Mount mobile/ as StaticFiles in api/main.py

✅ Acceptance Criteria

• PWA installable on Android and iOS
• App loads from cache with zero connectivity
• Voice and text captured offline, persists across app close
• GPS coordinates captured without internet
• Auto-syncs when WiFi restored
• Filled PDFs downloadable from mobile after sync
• Documentation updated in docs/

📌 Additional Context

Future extensions: photo/video capture for scene documentation, multi-officer report unification by incident ID, push notifications when PDFs are ready.