feat(feature:autopay): add module structure and navigation integration

Author: biplab1

cmp-android/dependencies/prodReleaseRuntimeClasspath.tree.txt

@@ -3012,6 +3012,38 @@
 |    |    +--- org.jetbrains.compose.material3:material3:1.8.2 (*)
 |    |    +--- org.jetbrains.compose.components:components-resources:1.8.2 (*)
 |    |    \--- org.jetbrains.compose.components:components-ui-tooling-preview:1.8.2 (*)
+|    +--- project :feature:autopay
+|    |    +--- androidx.lifecycle:lifecycle-runtime-compose:2.9.2 (*)
+|    |    +--- androidx.lifecycle:lifecycle-viewmodel-compose:2.9.2 (*)
+|    |    +--- androidx.tracing:tracing-ktx:1.3.0 (*)
+|    |    +--- io.insert-koin:koin-bom:4.1.0 (*)
+|    |    +--- io.insert-koin:koin-android:4.1.0 (*)
+|    |    +--- io.insert-koin:koin-androidx-compose:4.1.0 (*)
+|    |    +--- io.insert-koin:koin-androidx-navigation:4.1.0 (*)
+|    |    +--- io.insert-koin:koin-core-viewmodel:4.1.0 (*)
+|    |    +--- org.jetbrains.kotlin:kotlin-stdlib:2.1.20 -> 2.1.21 (*)
+|    |    +--- io.insert-koin:koin-core:4.1.0 (*)
+|    |    +--- io.insert-koin:koin-annotations:2.1.0 (*)
+|    |    +--- project :core:ui (*)
+|    |    +--- project :core:designsystem (*)
+|    |    +--- project :core:data (*)
+|    |    +--- io.insert-koin:koin-compose:4.1.0 (*)
+|    |    +--- io.insert-koin:koin-compose-viewmodel:4.1.0 (*)
+|    |    +--- org.jetbrains.compose.runtime:runtime:1.8.2 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-runtime-compose:2.9.1 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-viewmodel-compose:2.9.1 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-viewmodel:2.9.1 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-viewmodel-savedstate:2.9.1 (*)
+|    |    +--- org.jetbrains.androidx.savedstate:savedstate:1.3.1 (*)
+|    |    +--- org.jetbrains.androidx.core:core-bundle:1.0.1 (*)
+|    |    +--- org.jetbrains.androidx.navigation:navigation-compose:2.9.0-beta03 (*)
+|    |    +--- org.jetbrains.kotlinx:kotlinx-collections-immutable:0.3.8 (*)
+|    |    +--- org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3 -> 1.8.0 (*)
+|    |    +--- org.jetbrains.compose.ui:ui:1.8.2 (*)
+|    |    +--- org.jetbrains.compose.foundation:foundation:1.8.2 (*)
+|    |    +--- org.jetbrains.compose.material3:material3:1.8.2 (*)
+|    |    +--- org.jetbrains.compose.components:components-resources:1.8.2 (*)
+|    |    \--- org.jetbrains.compose.components:components-ui-tooling-preview:1.8.2 (*)
 |    \--- org.jetbrains.kotlin:kotlin-parcelize-runtime:2.1.20 (*)
 +--- project :core:data (*)
 +--- project :core:ui (*)

cmp-android/dependencies/prodReleaseRuntimeClasspath.txt

@@ -12,6 +12,7 @@
 :core:ui
 :feature:accounts
 :feature:auth
+:feature:autopay
 :feature:editpassword
 :feature:faq
 :feature:finance

cmp-shared/build.gradle.kts

@@ -55,6 +55,7 @@ kotlin {
             implementation(projects.feature.qr)
             implementation(projects.feature.merchants)
             implementation(projects.feature.upiSetup)
+            implementation(projects.feature.autopay)
         }
 
         desktopMain.dependencies {

cmp-shared/src/commonMain/kotlin/org/mifospay/shared/di/KoinModules.kt

@@ -24,6 +24,7 @@ import org.mifospay.core.network.di.LocalModule
 import org.mifospay.core.network.di.NetworkModule
 import org.mifospay.feature.accounts.di.AccountsModule
 import org.mifospay.feature.auth.di.AuthModule
+import org.mifospay.feature.autopay.di.AutoPayModule
 import org.mifospay.feature.editpassword.di.EditPasswordModule
 import org.mifospay.feature.faq.di.FaqModule
 import org.mifospay.feature.history.di.HistoryModule
@@ -88,6 +89,7 @@ object KoinModules {
             QrModule,
             MerchantsModule,
             UpiSetupModule,
+            AutoPayModule,
         )
     }
     private val LibraryModule = module {

cmp-shared/src/commonMain/kotlin/org/mifospay/shared/navigation/MifosNavHost.kt

@@ -22,6 +22,13 @@ import org.mifospay.feature.accounts.savingsaccount.addEditSavingAccountScreen
 import org.mifospay.feature.accounts.savingsaccount.details.navigateToSavingAccountDetails
 import org.mifospay.feature.accounts.savingsaccount.details.savingAccountDetailRoute
 import org.mifospay.feature.accounts.savingsaccount.navigateToSavingAccountAddEdit
+import org.mifospay.feature.autopay.AutoPayScreen
+import org.mifospay.feature.autopay.autoPayGraph
+import org.mifospay.feature.autopay.navigateToAutoPay
+import org.mifospay.feature.autopay.navigateToAutoPayHistory
+import org.mifospay.feature.autopay.navigateToAutoPayPreferences
+import org.mifospay.feature.autopay.navigateToAutoPayRules
+import org.mifospay.feature.autopay.navigateToAutoPaySetup
 import org.mifospay.feature.editpassword.navigation.editPasswordScreen
 import org.mifospay.feature.editpassword.navigation.navigateToEditPassword
 import org.mifospay.feature.faq.navigation.faqScreen
@@ -127,6 +134,22 @@ internal fun MifosNavHost(
                 navigateToInvoiceDetailScreen = navController::navigateToInvoiceDetail,
             )
         },
+        TabContent(PaymentsScreenContents.AUTOPAY.name) {
+            AutoPayScreen(
+                onNavigateToSetup = {
+                    navController.navigateToAutoPaySetup()
+                },
+                onNavigateToRules = {
+                    navController.navigateToAutoPayRules()
+                },
+                onNavigateToPreferences = {
+                    navController.navigateToAutoPayPreferences()
+                },
+                onNavigateToHistory = {
+                    navController.navigateToAutoPayHistory()
+                },
+            )
+        },
     )
 
     val tabContents = listOf(
@@ -167,6 +190,9 @@ internal fun MifosNavHost(
                 navController.navigateToShowQrScreen()
             },
             onPay = navController::navigateToSendMoneyOptionsScreen,
+            onAutoPay = {
+                navController.navigateToAutoPay()
+            },
             navigateToTransactionDetail = navController::navigateToSpecificTransaction,
             navigateToAccountDetail = navController::navigateToSavingAccountDetails,
         )
@@ -388,5 +414,10 @@ internal fun MifosNavHost(
         setupUpiPinScreen(
             navigateBack = navController::navigateUp,
         )
+
+        autoPayGraph(
+            navController = navController,
+            onNavigateBack = navController::navigateUp,
+        )
     }
 }

core/designsystem/src/commonMain/kotlin/org/mifospay/core/designsystem/icon/MifosIcons.kt

@@ -29,6 +29,7 @@ import androidx.compose.material.icons.filled.Description
 import androidx.compose.material.icons.filled.Edit
 import androidx.compose.material.icons.filled.FlashOff
 import androidx.compose.material.icons.filled.FlashOn
+import androidx.compose.material.icons.filled.History
 import androidx.compose.material.icons.filled.Info
 import androidx.compose.material.icons.filled.KeyboardArrowDown
 import androidx.compose.material.icons.filled.Person
@@ -135,4 +136,5 @@ object MifosIcons {
     val ArrowForward = Icons.AutoMirrored.Filled.ArrowForward
 
     val CurrencyRupee = Icons.Filled.CurrencyRupee
+    val History = Icons.Filled.History
 }

feature/autopay/README.md

@@ -0,0 +1,51 @@
+# AutoPay Feature
+
+## Overview
+The AutoPay feature module provides functionality for setting up and managing automatic payment schedules. This module allows users to configure recurring payments, set up payment rules, and manage their automatic payment preferences.
+
+## Features
+- Set up recurring payment schedules
+- Configure payment rules and conditions
+- Manage automatic payment preferences
+- View payment history and status
+- Enable/disable automatic payments
+
+## Screenshots
+### Android
+*Screenshots will be added as the feature is developed*
+
+### Desktop
+*Screenshots will be added as the feature is developed*
+
+### Web
+*Screenshots will be added as the feature is developed*
+
+## Module Structure
+```
+feature/autopay/
+├── src/
+│   ├── commonMain/
+│   │   ├── kotlin/org/mifospay/feature/autopay/
+│   │   │   ├── di/
+│   │   │   │   └── AutoPayModule.kt
+│   │   │   ├── AutoPayScreen.kt
+│   │   │   ├── AutoPayNavigation.kt
+│   │   │   └── AutoPayViewModel.kt
+│   │   └── composeResources/
+│   └── androidMain/
+│       └── kotlin/org/mifospay/feature/autopay/
+├── build.gradle.kts
+└── README.md
+```
+
+## Dependencies
+- Compose UI components
+- Material3 design system
+- Koin dependency injection
+- Core domain modules (as needed)
+
+## Usage
+This module is designed to be integrated into the main application through dependency injection. The AutoPayModule provides the necessary dependencies for the AutoPay feature.
+
+## Development Status
+🚧 **In Development** - Basic module structure created

feature/autopay/build.gradle.kts

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2024 Mifos Initiative
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * See https://github.com/openMF/mobile-wallet/blob/master/LICENSE.md
+ */
+plugins {
+    alias(libs.plugins.cmp.feature.convention)
+}
+
+android {
+    namespace = "org.mifospay.feature.autopay"
+}
+
+kotlin {
+    sourceSets {
+        commonMain.dependencies {
+            implementation(compose.ui)
+            implementation(compose.foundation)
+            implementation(compose.material3)
+            implementation(compose.components.resources)
+            implementation(compose.components.uiToolingPreview)
+        }
+    }
+}

feature/autopay/src/commonMain/kotlin/org/mifospay/feature/autopay/AutoPayHistoryScreen.kt

@@ -0,0 +1,54 @@
+/*
+ * Copyright 2024 Mifos Initiative
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * See https://github.com/openMF/mobile-wallet/blob/master/LICENSE.md
+ */
+package org.mifospay.feature.autopay
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.dp
+
+@Composable
+fun AutoPayHistoryScreen(
+    onNavigateBack: () -> Unit,
+    modifier: Modifier = Modifier,
+) {
+    Surface(
+        modifier = modifier.fillMaxSize(),
+        color = MaterialTheme.colorScheme.background,
+    ) {
+        Column(
+            modifier = Modifier
+                .fillMaxSize()
+                .padding(16.dp),
+            horizontalAlignment = Alignment.CenterHorizontally,
+            verticalArrangement = Arrangement.Center,
+        ) {
+            Text(
+                text = "AutoPay History",
+                style = MaterialTheme.typography.headlineMedium,
+                color = MaterialTheme.colorScheme.onBackground,
+            )
+
+            Text(
+                text = "View your automatic payment history",
+                style = MaterialTheme.typography.bodyLarge,
+                color = MaterialTheme.colorScheme.onSurfaceVariant,
+                modifier = Modifier.padding(top = 8.dp),
+            )
+        }
+    }
+}

feature/autopay/src/commonMain/kotlin/org/mifospay/feature/autopay/AutoPayNavigation.kt

@@ -0,0 +1,90 @@
+/*
+ * Copyright 2024 Mifos Initiative
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * See https://github.com/openMF/mobile-wallet/blob/master/LICENSE.md
+ */
+package org.mifospay.feature.autopay
+
+import androidx.navigation.NavController
+import androidx.navigation.NavGraphBuilder
+import androidx.navigation.NavOptions
+import androidx.navigation.compose.composable
+import androidx.navigation.navOptions
+
+object AutoPayNavigation {
+    const val AUTO_PAY_ROUTE = "autopay"
+    const val AUTO_PAY_SETUP_ROUTE = "autopay/setup"
+    const val AUTO_PAY_RULES_ROUTE = "autopay/rules"
+    const val AUTO_PAY_PREFERENCES_ROUTE = "autopay/preferences"
+    const val AUTO_PAY_HISTORY_ROUTE = "autopay/history"
+}
+
+fun NavController.navigateToAutoPay(navOptions: NavOptions? = null) {
+    navigate(AutoPayNavigation.AUTO_PAY_ROUTE, navOptions)
+}
+
+fun NavController.navigateToAutoPaySetup(navOptions: NavOptions? = null) {
+    navigate(AutoPayNavigation.AUTO_PAY_SETUP_ROUTE, navOptions)
+}
+
+fun NavController.navigateToAutoPayRules(navOptions: NavOptions? = null) {
+    navigate(AutoPayNavigation.AUTO_PAY_RULES_ROUTE, navOptions)
+}
+
+fun NavController.navigateToAutoPayPreferences(navOptions: NavOptions? = null) {
+    navigate(AutoPayNavigation.AUTO_PAY_PREFERENCES_ROUTE, navOptions)
+}
+
+fun NavController.navigateToAutoPayHistory(navOptions: NavOptions? = null) {
+    navigate(AutoPayNavigation.AUTO_PAY_HISTORY_ROUTE, navOptions)
+}
+
+fun NavGraphBuilder.autoPayGraph(
+    navController: NavController,
+    onNavigateBack: () -> Unit = { navController.navigateUp() },
+) {
+    composable(AutoPayNavigation.AUTO_PAY_ROUTE) {
+        AutoPayScreen(
+            onNavigateToSetup = {
+                navController.navigateToAutoPaySetup()
+            },
+            onNavigateToRules = {
+                navController.navigateToAutoPayRules()
+            },
+            onNavigateToPreferences = {
+                navController.navigateToAutoPayPreferences()
+            },
+            onNavigateToHistory = {
+                navController.navigateToAutoPayHistory()
+            },
+        )
+    }
+
+    composable(AutoPayNavigation.AUTO_PAY_SETUP_ROUTE) {
+        AutoPaySetupScreen(
+            onNavigateBack = onNavigateBack,
+        )
+    }
+
+    composable(AutoPayNavigation.AUTO_PAY_RULES_ROUTE) {
+        AutoPayRulesScreen(
+            onNavigateBack = onNavigateBack,
+        )
+    }
+
+    composable(AutoPayNavigation.AUTO_PAY_PREFERENCES_ROUTE) {
+        AutoPayPreferencesScreen(
+            onNavigateBack = onNavigateBack,
+        )
+    }
+
+    composable(AutoPayNavigation.AUTO_PAY_HISTORY_ROUTE) {
+        AutoPayHistoryScreen(
+            onNavigateBack = onNavigateBack,
+        )
+    }
+}