An on-site inspection management app with two roles (Inspector & Supervisor). Supports offline work, automatic sync, phone OTP login (Firebase Auth), Google Maps integration, reports with photos/ML Kit auto-labeling, chat, notifications, and PDF export.

🎥 Demo video: https://youtu.be/N1hbhho7Pu8

At Phuong Hai company, traditional inspection workflows often relied on manual note-taking, delayed reporting, and fragmented communication, which slowed down operations and created unnecessary risks. We wanted to change that by building an app that:

• Centralizes all inspection data into a single, reliable platform.

• Reduces paperwork, improves accuracy, and minimizes human errors.

• Enables supervisors to monitor tasks, assign jobs, and review reports instantly.

• Strengthens collaboration between inspectors and supervisors through real-time messaging and notifications.

• Ultimately, our goal was to streamline the inspection process, save time for employees, and help the company make faster, better-informed decisions.

• Applying Android Jetpack components such as ViewModel, LiveData, and WorkManager.
• Designing an offline-first architecture with background synchronization.
• Collaborating effectively using version control tools (Git & GitHub).
• Writing clean, scalable, and maintainable code with dependency injection (Hilt).
• Gaining insights into the challenges of building business-oriented mobile applications.

• App name: FieldInspectionApp
• Package: com.phuonghai.inspection
• Min SDK: 24
• Target / Compile SDK: 36
• Language: Kotlin
• UI: Jetpack Compose (Material3)
• DI: Hilt
• Local DB: Room
• Background sync: WorkManager + Foreground Service (network listener)
• Backend: Firebase (Auth – Phone OTP, Firestore, Storage, Realtime DB for chat)
• Maps: Google Maps (Maps Compose + Play Services Location)
• ML: ML Kit (Image Labeling)
• PDF export: iText7
• Networking: OkHttp
• Architecture: Clean Architecture + MVVM + Repository + UseCase
• Modules: zip contains only the app/ module (no Gradle root project).

🔐 Security note: the repo includes google-services.json and a hard-coded Google Maps API key inside AndroidManifest.xml. For public repos, remove these and load them from local.properties + manifestPlaceholders.

• Login with phone number + OTP (Firebase Phone Auth).
• Dashboard: view assigned tasks, filter by branch/priority.
• Create Report: title, description, inspection type (Electrical, Fire Safety, Structural, Food Hygiene, Environmental, Machinery), score, location (lat/lng + address), photos/videos.
• ML Kit Image Labeling: auto-suggests labels from attached images.
• Offline support: reports/tasks stored in Room → auto-synced to Firestore/Storage when online.
• Report history: view past reports with status (PENDING/APPROVED/REJECTED) and supervisor notes.
• 1–1 Chat with Supervisor, plus notifications for updates.

• Dashboard + Google Maps view of report locations.
• Review reports: update status ASSIGN / IN_PROGRESS / COMPLETED / CANCELLED / OVERDUE (Task) and PASSED/FAILED/NEEDS_ATTENTION (Report).
• Manage notifications and chat with Inspectors.
• Filter by Branch, Priority, or time.

• Network monitor + Foreground service: triggers WorkManager sync.
• FileProvider for external file sharing (PDF/images).
• PDF export with iText7 (note license restrictions).

• Clean Architecture + MVVM
  • Presentation: Compose screens + ViewModels
  • Domain: models, repositories, use cases
  • Data: repositories (Firebase/Room), local DB, remote Firestore/Storage/Realtime
  • Core: DI (Hilt), networking, sync, file storage

app/src/main/java/com/phuonghai/inspection/
├─ InspectionApp.kt              # @HiltAndroidApp entry point, network listener
├─ MainActivity.kt / MainViewModel.kt
├─ core/ (di, network, storage, sync)
├─ data/ (local Room, repositories, remote Firebase)
├─ domain/ (model, repository interfaces, use cases)
├─ presentation/
│  ├─ auth (PhoneLogin, OTP, Splash)
│  ├─ navigation (NavHost + bottom bars for roles)
│  ├─ inspector (dashboard, report, history, notifications, tasks, chat)
│  ├─ supervisor (dashboard, map, history, report, tasks, chat)
│  └─ theme
└─ res/xml (backup rules, file_paths, etc.)

⚠️ One file (SupervisorMapScreen.kt) uses package com.donut.assignment2... instead of com.phuonghai.inspection.... Should be fixed to avoid build errors.

• Firebase: requires google-services.json in app/. Don’t commit this file.
• Google Maps API key: move from AndroidManifest.xml → local.properties + manifestPlaceholders.
• Permissions: INTERNET, NETWORK_STATE, FINE_LOCATION, CAMERA, STORAGE.

• Run on device/emulator with Google Play services.
• Login flow: enter phone → receive OTP → verify → redirect to Inspector/Supervisor dashboard based on Firestore role.

Clone the repository:

git clone https://github.com/RMIT-Vietnam-Teaching/assignment-2-group-donut

Account:

• Supervisor Account: Phone: 123456789, OTP: 123456
• Inspector Account: Phone: 223456789, OTP: 123456

• Compose: Material3, icons, window-size-class.
• DI: Hilt.
• Coroutines.
• Room.
• WorkManager, App Startup.
• Maps: Maps Compose, Play Services Maps/Location.
• Firebase: Auth, Firestore, Storage, Realtime DB.
• ML Kit: image labeling.
• Networking: OkHttp.
• PDF: iText7.
• Testing: JUnit, Robolectric.

data class User(uId: String, fullName: String, phoneNumber: String, role: UserRole)

data class Task(taskId: String, title: String, description: String, priority: Priority, status: TaskStatus)

data class Report(reportId: String, inspectorId: String, taskId: String,
                  title: String, description: String, type: InspectionType,
                  lat: String, lng: String, address: String, score: Int?,
                  responseStatus: ResponseStatus, imageUrl: String?)

• Wrong package → fix SupervisorMapScreen.kt.
• AGP/Kotlin mismatch → adjust root build.gradle.kts or update Studio.
• Missing Compose BOM/libs.versions.toml → add or replace aliases with direct versions.
• Maps API key empty → app crashes → use manifestPlaceholders.
• Storage permissions (use Scoped Storage for Android 10+).

• Code is already structured with Clean Architecture + MVVM, ready to extend.
• Hide/change all API keys before making the repo public.