Implement PDF reports for submissions

app/build.gradle

@@ -190,6 +190,7 @@ dependencies {
     implementation fileTree(include: ['*.jar'], dir: 'libs')
     implementation project(':core:domain')
     implementation project(':core:ui')
+    implementation project(':feature:pdf')
     implementation libs.androidx.multidex
     implementation libs.androidx.preference.ktx
 

app/src/main/java/org/groundplatform/android/di/GroundApplicationModule.kt

@@ -27,6 +27,10 @@ import java.util.Locale
 import javax.inject.Singleton
 import org.groundplatform.android.R
 import org.groundplatform.android.util.SurveyDeepLinkParser
+import org.groundplatform.ui.util.AndroidDateFormatter
+import org.groundplatform.ui.util.ComposeStringResolver
+import org.groundplatform.ui.util.DateFormatter
+import org.groundplatform.ui.util.StringResolver
 
 @InstallIn(SingletonComponent::class)
 @Module(includes = [ViewModelModule::class])
@@ -47,4 +51,11 @@ object GroundApplicationModule {
       deepLinkHost = resources.getString(R.string.deeplink_host),
       deepLinkPath = resources.getString(R.string.survey_deeplink_path),
     )
+
+  @Provides
+  @Singleton
+  fun provideDateFormatter(@ApplicationContext context: Context): DateFormatter =
+    AndroidDateFormatter(context)
+
+  @Provides @Singleton fun provideStringResolver(): StringResolver = ComposeStringResolver
 }

app/src/main/java/org/groundplatform/android/di/PdfModule.kt

@@ -0,0 +1,112 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.groundplatform.android.di
+
+import android.content.Context
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.android.qualifiers.ApplicationContext
+import dagger.hilt.components.SingletonComponent
+import javax.inject.Singleton
+import kotlinx.coroutines.CoroutineDispatcher
+import org.groundplatform.android.BuildConfig
+import org.groundplatform.android.R
+import org.groundplatform.android.di.coroutines.DefaultDispatcher
+import org.groundplatform.android.di.coroutines.IoDispatcher
+import org.groundplatform.feature.pdf.AndroidPdfImageProvider
+import org.groundplatform.feature.pdf.AndroidPdfOutputProvider
+import org.groundplatform.feature.pdf.AndroidPdfRenderer
+import org.groundplatform.feature.pdf.AndroidPdfReportLauncher
+import org.groundplatform.feature.pdf.LoiReportExporter
+import org.groundplatform.feature.pdf.PdfExportService
+import org.groundplatform.feature.pdf.PdfImageProvider
+import org.groundplatform.feature.pdf.PdfOutputProvider
+import org.groundplatform.feature.pdf.PdfRenderer
+import org.groundplatform.feature.pdf.PdfReportLauncher
+import org.groundplatform.feature.pdf.mapper.LoiReportMapper
+import org.groundplatform.feature.pdf.mapper.TaskValueMapper
+import org.groundplatform.ui.util.DateFormatter
+import org.groundplatform.ui.util.StringResolver
+
+@Module
+@InstallIn(SingletonComponent::class)
+object PdfModule {
+
+  @Provides
+  @Singleton
+  fun providePdfImageProvider(@ApplicationContext context: Context): PdfImageProvider =
+    AndroidPdfImageProvider(context = context, logoDrawableRes = R.drawable.ground_logo)
+
+  @Provides
+  @Singleton
+  fun providePdfOutputFactory(@ApplicationContext context: Context): PdfOutputProvider =
+    AndroidPdfOutputProvider(context)
+
+  @Provides
+  @Singleton
+  fun providePdfRenderer(@IoDispatcher ioDispatcher: CoroutineDispatcher): PdfRenderer =
+    AndroidPdfRenderer(ioDispatcher)
+
+  @Provides
+  @Singleton
+  fun provideTaskValueMapper(
+    strings: StringResolver,
+    dateFormatter: DateFormatter,
+  ): TaskValueMapper = TaskValueMapper(strings = strings, dateFormatter = dateFormatter)
+
+  @Provides
+  @Singleton
+  fun provideLoiReportMapper(
+    taskValueMapper: TaskValueMapper,
+    strings: StringResolver,
+    dateFormatter: DateFormatter,
+  ): LoiReportMapper =
+    LoiReportMapper(
+      taskValueMapper = taskValueMapper,
+      strings = strings,
+      dateFormatter = dateFormatter,
+    )
+
+  @Provides
+  @Singleton
+  fun providePdfReportLauncher(@ApplicationContext context: Context): PdfReportLauncher =
+    AndroidPdfReportLauncher(context = context, fileProviderAuthority = BuildConfig.APPLICATION_ID)
+
+  @Provides
+  @Singleton
+  fun providePdfReportService(
+    imageProvider: PdfImageProvider,
+    renderer: PdfRenderer,
+    outputProvider: PdfOutputProvider,
+    launcher: PdfReportLauncher,
+    @DefaultDispatcher coroutineDispatcher: CoroutineDispatcher,
+  ): PdfExportService =
+    PdfExportService(
+      imageProvider = imageProvider,
+      renderer = renderer,
+      outputProvider = outputProvider,
+      launcher = launcher,
+      coroutineDispatcher = coroutineDispatcher,
+    )
+
+  @Provides
+  @Singleton
+  fun provideLoiReportExporter(
+    mapper: LoiReportMapper,
+    exportService: PdfExportService,
+  ): LoiReportExporter = LoiReportExporter(mapper = mapper, exportService = exportService)
+}

app/src/main/java/org/groundplatform/android/di/UseCaseModule.kt

@@ -38,7 +38,14 @@ object UseCaseModule {
     locationOfInterestRepository: LocationOfInterestRepositoryInterface,
     userRepository: UserRepositoryInterface,
     surveyRepository: SurveyRepositoryInterface,
-  ) = GetLoiReportUseCase(locationOfInterestRepository, userRepository, surveyRepository)
+    submissionRepository: SubmissionRepositoryInterface,
+  ) =
+    GetLoiReportUseCase(
+      locationOfInterestRepository = locationOfInterestRepository,
+      userRepositoryInterface = userRepository,
+      surveyRepositoryInterface = surveyRepository,
+      submissionRepositoryInterface = submissionRepository,
+    )
 
   @Provides
   fun providesUpdateUserSettingsUseCase(userRepository: UserRepositoryInterface) =

app/src/main/java/org/groundplatform/android/di/coroutines/CoroutineDispatchersModule.kt

@@ -30,8 +30,14 @@ object CoroutineDispatchersModule {
   @IoDispatcher @Provides fun provideIoDispatcher(): CoroutineDispatcher = Dispatchers.IO
 
   @MainDispatcher @Provides fun provideMainDispatcher(): CoroutineDispatcher = Dispatchers.Main
+
+  @DefaultDispatcher
+  @Provides
+  fun provideDefaultDispatcher(): CoroutineDispatcher = Dispatchers.Default
 }
 
+@Retention(AnnotationRetention.RUNTIME) @Qualifier annotation class DefaultDispatcher
+
 @Retention(AnnotationRetention.RUNTIME) @Qualifier annotation class IoDispatcher
 
 @Retention(AnnotationRetention.RUNTIME) @Qualifier annotation class MainDispatcher

app/src/main/java/org/groundplatform/android/repository/SubmissionRepository.kt

@@ -112,4 +112,7 @@ constructor(
 
   private suspend fun getPendingDeleteCount(loiId: String) =
     localSubmissionStore.getPendingDeleteCount(loiId)
+
+  override suspend fun getSubmissions(loi: LocationOfInterest) =
+    localSubmissionStore.getSubmissions(loi, loi.job.id)
 }

app/src/main/java/org/groundplatform/android/ui/datacollection/DataCollectionFragment.kt

@@ -22,14 +22,14 @@ import android.view.ViewGroup
 import androidx.hilt.navigation.fragment.hiltNavGraphViewModels
 import androidx.navigation.fragment.findNavController
 import dagger.hilt.android.AndroidEntryPoint
+import javax.inject.Inject
 import org.groundplatform.android.R
 import org.groundplatform.android.ui.common.AbstractFragment
 import org.groundplatform.android.ui.common.BackPressListener
 import org.groundplatform.android.ui.common.EphemeralPopups
 import org.groundplatform.android.ui.home.HomeScreenViewModel
 import org.groundplatform.android.util.createComposeView
 import org.groundplatform.android.util.openAppSettings
-import javax.inject.Inject
 
 /** Fragment allowing the user to collect data to complete a task. */
 @AndroidEntryPoint
@@ -55,6 +55,7 @@ class DataCollectionFragment : AbstractFragment(), BackPressListener {
       onExitConfirmed = { navigateBack() },
       onOpenSettings = { requireActivity().openAppSettings() },
       onAwaitingPhotoCapture = { homeScreenViewModel.awaitingPhotoCapture = it },
+      onReportExportError = { popups.ErrorPopup().unknownError() },
     )
   }
 

app/src/main/java/org/groundplatform/android/ui/datacollection/DataCollectionScreen.kt

@@ -43,6 +43,7 @@ import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import org.groundplatform.android.R
 import org.groundplatform.android.ui.components.ConfirmationDialog
 import org.groundplatform.android.ui.datacollection.tasks.TaskScreenContainer
+import org.groundplatform.ui.components.loireport.LoiReportAction
 
 /**
  * The main screen for data collection, coordinating the task sequence and host UI.
@@ -57,6 +58,7 @@ import org.groundplatform.android.ui.datacollection.tasks.TaskScreenContainer
 fun DataCollectionScreen(
   viewModel: DataCollectionViewModel,
   onValidationError: (resId: Int) -> Unit,
+  onReportExportError: () -> Unit,
   onExitConfirmed: () -> Unit,
   onOpenSettings: () -> Unit,
   onAwaitingPhotoCapture: (Boolean) -> Unit,
@@ -71,11 +73,16 @@ fun DataCollectionScreen(
         is DataCollectionUiEffect.OpenSettings -> onOpenSettings()
         is DataCollectionUiEffect.SetAwaitingPhotoCapture -> onAwaitingPhotoCapture(effect.awaiting)
         is DataCollectionUiEffect.ShowValidationError -> onValidationError(effect.errorResId)
+        is DataCollectionUiEffect.ShowReportExportError -> onReportExportError()
       }
     }
   }
 
-  DataCollectionContent(uiState = uiState, onCloseClicked = { viewModel.onCloseClicked() }) {
+  DataCollectionContent(
+    uiState = uiState,
+    onCloseClicked = { viewModel.onCloseClicked() },
+    onLoiReportAction = { viewModel.onLoiReportAction(it) },
+  ) {
     readyState ->
     val tasks = readyState.tasks
     if (tasks.isNotEmpty()) {
@@ -134,6 +141,7 @@ object DataCollectionScreenTestTags {
 fun DataCollectionContent(
   uiState: DataCollectionUiState,
   onCloseClicked: () -> Unit,
+  onLoiReportAction: (LoiReportAction) -> Unit,
   pagerContent: @Composable (DataCollectionUiState.Ready) -> Unit,
 ) {
   Scaffold(topBar = { DataCollectionToolbar(uiState, onCloseClicked) }) { innerPadding ->
@@ -153,7 +161,11 @@ fun DataCollectionContent(
             ReadyContent { pagerContent(uiState) }
           }
           is DataCollectionUiState.TaskSubmitted -> {
-            DataSubmissionConfirmationScreen(loiReport = uiState.loiReport) { onCloseClicked() }
+            DataSubmissionConfirmationScreen(
+              loiReport = uiState.loiReport,
+              onLoiReportAction = onLoiReportAction,
+              onDismissed = onCloseClicked,
+            )
           }
         }
       }

app/src/main/java/org/groundplatform/android/ui/datacollection/DataCollectionScreenPreviews.kt

@@ -29,6 +29,7 @@ import org.groundplatform.android.ui.common.ExcludeFromJacocoGeneratedReport
 import org.groundplatform.domain.model.job.Job
 import org.groundplatform.domain.model.locationofinterest.LoiReport
 import org.groundplatform.ui.theme.AppTheme
+import kotlin.time.Clock
 
 private const val PAGER_CONTENT_TEXT = "Pager Content Area"
 
@@ -37,7 +38,11 @@ private const val PAGER_CONTENT_TEXT = "Pager Content Area"
 @ExcludeFromJacocoGeneratedReport
 private fun DataCollectionContentLoadingPreview() {
   AppTheme {
-    DataCollectionContent(uiState = DataCollectionUiState.Loading, onCloseClicked = {}) {
+    DataCollectionContent(
+      uiState = DataCollectionUiState.Loading,
+      onCloseClicked = {},
+      onLoiReportAction = {},
+    ) {
       Box(modifier = Modifier.fillMaxSize().background(Color.LightGray)) {
         Text(text = PAGER_CONTENT_TEXT, modifier = Modifier.align(Alignment.Center))
       }
@@ -57,6 +62,7 @@ private fun DataCollectionContentErrorPreview() {
           cause = Error("Some error"),
         ),
       onCloseClicked = {},
+      onLoiReportAction = {},
     ) {
       Box(modifier = Modifier.fillMaxSize().background(Color.LightGray)) {
         Text(text = PAGER_CONTENT_TEXT, modifier = Modifier.align(Alignment.Center))
@@ -82,6 +88,7 @@ private fun DataCollectionContentPreview() {
           position = TaskPosition(0, 1, 3),
         ),
       onCloseClicked = {},
+      onLoiReportAction = {},
     ) {
       Box(modifier = Modifier.fillMaxSize().background(Color.LightGray)) {
         Text(text = PAGER_CONTENT_TEXT, modifier = Modifier.align(Alignment.Center))
@@ -99,9 +106,21 @@ private fun DataCollectionContentCompletePreview() {
       uiState =
         DataCollectionUiState.TaskSubmitted(
           loiReport =
-            LoiReport(loiName = "Point A", geoJson = JsonObject(mapOf()), submissionDetails = null)
+            LoiReport(
+              loiName = "Point A",
+              geoJson = JsonObject(mapOf()),
+              submissionDetails =
+                LoiReport.SubmissionDetails(
+                  surveyName = "Test Survey",
+                  userName = "John Doe",
+                  userEmail = "john.doe@example.com",
+                  dateMillis = Clock.System.now().toEpochMilliseconds(),
+                  submissions = emptyList(),
+                ),
+            )
         ),
       onCloseClicked = {},
+      onLoiReportAction = {},
     ) {
       Box(modifier = Modifier.fillMaxSize().background(Color.LightGray)) {
         Text(text = PAGER_CONTENT_TEXT, modifier = Modifier.align(Alignment.Center))

app/src/main/java/org/groundplatform/android/ui/datacollection/DataCollectionViewModel.kt

@@ -59,6 +59,8 @@ import org.groundplatform.domain.model.task.Task
 import org.groundplatform.domain.repository.SubmissionRepositoryInterface
 import org.groundplatform.domain.usecases.GetLoiReportUseCase
 import org.groundplatform.domain.usecases.submission.SubmitDataUseCase
+import org.groundplatform.feature.pdf.LoiReportExporter
+import org.groundplatform.ui.components.loireport.LoiReportAction
 import timber.log.Timber
 
 sealed interface DataCollectionUiEffect {
@@ -69,6 +71,8 @@ sealed interface DataCollectionUiEffect {
   data class SetAwaitingPhotoCapture(val awaiting: Boolean) : DataCollectionUiEffect
 
   data class ShowValidationError(val errorResId: Int) : DataCollectionUiEffect
+
+  data object ShowReportExportError : DataCollectionUiEffect
 }
 
 /** View model for the Data Collection fragment. */
@@ -86,6 +90,7 @@ internal constructor(
   private val viewModelFactory: ViewModelFactory,
   private val dataCollectionInitializer: DataCollectionInitializer,
   private val getLoiReportUseCase: GetLoiReportUseCase,
+  private val loiReportExporter: LoiReportExporter,
 ) : AbstractViewModel() {
 
   private val _uiEffects = Channel<DataCollectionUiEffect>(Channel.BUFFERED)
@@ -200,6 +205,15 @@ internal constructor(
     }
   }
 
+  fun onLoiReportAction(action: LoiReportAction) {
+    val loiReport = (uiState.value as? DataCollectionUiState.TaskSubmitted)?.loiReport
+    viewModelScope.launch {
+      if (loiReport == null || loiReportExporter.export(loiReport, action).isFailure) {
+        _uiEffects.send(DataCollectionUiEffect.ShowReportExportError)
+      }
+    }
+  }
+
   fun handleLoiNameAction(action: LoiNameAction, taskId: String) {
     when (action) {
       is LoiNameAction.Confirmed -> {