How openwaterhealth/openlifu-3dscanner works
OpenLIFU-3DScanner is an Android research-scanning app: users authenticate, identify a subject or session, capture guided photos, upload them for backend reconstruction, and inspect the resulting mesh. The README also documents face and QR analysis, offline scan storage, live progress, and automatic cleanup. The graph combines those documented capabilities with relationships visible in the sampled source; unsampled screen and service wiring is not asserted as verified.
Main entry points: AppNavigation.kt App navigation · ReconstructionRepository.kt Reconstruction repository · AuthService.kt Auth service · MainActivity.kt Android activity
Components 24
App and navigation
- Android activity
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/activity/MainActivity.kt - App navigation
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/navigation/AppNavigation.kt - Authentication UI
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/screen/signin/LoginScreen.kt - Home dashboard
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/screen/home/HomeScreen.kt - Collection management
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/screen/collection/CollectionsScreen.kt
Capture workflow
- QR scanning
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/screen/qr/QrScannerScreen.kt - Guided scanner
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/screen/scanner/ScannerScreen.kt - Face analysis
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/core/FaceAnalyzer.kt - Scan details and mesh
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/screen/photoscan/PhotoscanScreen.kt
Cloud and reconstruction
- Auth service
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/AuthService.kt - User repository
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/UserRepository.kt - Cloud repository
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/CloudRepository.kt - Reconstruction repository
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/ReconstructionRepository.kt - Collection API
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/PhotocollectionService.kt - Photoscan API
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/PhotoscanService.kt - Progress socket
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/WebsocketService.kt - Foreground service
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/service/ReconstructionService.kt
Local data and operations
- Room database
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/db/AppDatabase.kt - Scan ownership records
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/db/ScanOwnershipEntity.kt - Scan content provider
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/provider/PhotoscanContentProvider.kt - Local cleanup worker
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/work/LocalScanCleanupWorker.kt - Local scan files
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/extensions/getModelsDir.kt
Other components
- Scanner user
- Reconstruction backend
Connections 23
- Scanner user → Android activity: opens app
README.md - Android activity → App navigation: hosts routes
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/activity/MainActivity.kt - App navigation → Authentication UI: routes to
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/navigation/AppNavigation.kt - App navigation → Home dashboard: routes to
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/navigation/AppNavigation.kt - Home dashboard → Collection management: opens collections
- Collection management → QR scanning: identifies session
- App navigation → Guided scanner: routes to
README.md - Guided scanner → Face analysis: uses framing analysis
README.md - App navigation → Scan details and mesh: opens scan details
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/navigation/AppNavigation.kt - User repository → Auth service: delegates authentication
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/UserRepository.kt - Auth service → Reconstruction backend: authenticates remotely
- Auth service → Reconstruction backend: stores tokens
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/AuthService.kt - Cloud repository → Reconstruction repository: delegates uploads
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/CloudRepository.kt - Reconstruction repository → Collection API: creates collections
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/ReconstructionRepository.kt - Reconstruction repository → Photoscan API: requests scan data
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/ReconstructionRepository.kt - Collection API → Reconstruction backend: sends collection and photos
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/PhotocollectionService.kt - Photoscan API → Reconstruction backend: fetches meshes
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/PhotoscanService.kt - Reconstruction repository → Progress socket: subscribes to progress
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/repository/ReconstructionRepository.kt - Progress socket → Reconstruction backend: receives live updates
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/network/api/WebsocketService.kt - Foreground service → Reconstruction repository: observes upload state
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/service/ReconstructionService.kt - Room database → Scan ownership records: persists records
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/db/AppDatabase.kt - Scan content provider → Room database: exposes scan data
- Local cleanup worker → Local scan files: deletes stale files
OpenLIFU-3DScanner/app/src/main/java/health/openwater/openlifu3dscanner/work/LocalScanCleanupWorker.kt