Rilis v2 (2.0)

Ringkasan perubahan utama dari dd6473d → 3cdc6cc:

• Registrasi + OTP (request & verify) di feature-auth.
• Screen Result Passing untuk mengirim hasil antar layar dengan aman.
• Deep Linking & Notification Actions (navigasi dari tautan/deeplink dan aksi notifikasi).
• Fitur Notifikasi end-to-end: permission, FCM token registration, daftar notifikasi dengan pull-to-refresh.
• Integrasi Firebase Cloud Messaging (FCM).
• Caching berbasis Room + pembersihan otomatis cache.
• Penanganan Session Expiration terpusat.
• Refactor BaseViewModel + RetryManager + Global Snackbar & Bottom Sheet error.
• Dokumentasi ONBOARDING.md dan CONTRIBUTING.md diperbarui.

Panduan Migrasi Singkat dari v1

• Turunkan ViewModel dari BaseViewModel untuk loading/error standar.
• Gunakan RetryManager untuk operasi yang dapat diulang (network).
• Manfaatkan cache Room di repository untuk data yang sering diakses.
• Daftarkan token FCM saat login/refresh (lihat feature-notification).
• Untuk navigasi yang mengembalikan nilai, gunakan Screen Result Passing.

1. Fitur Utama

• Autentikasi (Login) dengan validasi domain dan penanganan error yang rapi
• Dashboard (kerangka), Transfer, Gold, Loan, Payment, Profile, Support (terstruktur per-feature)
• Splash → Routing awal berdasarkan status sesi (token) ke Login atau Dashboard
• Profil: menampilkan header profil dan Logout yang benar-benar menghapus sesi
• Loading Global dengan reference counter (tidak gampang "nyangkut")
• Internationalization (i18n): semua string UI di strings.xml; ViewModel memakai StringProvider
• Navigasi Compose yang dipusatkan (Navigator + Destination), aman untuk modular
• Design System: palet warna, tipografi, dan komponen re-usable di lib-designsystem
• Registrasi + OTP (request & verify) terintegrasi di auth
• Notifikasi in-app dengan FCM (permission, token registration, list + pull-to-refresh)
• Deep linking & aksi notifikasi yang menavigasi ke layar terkait
• Global Snackbar untuk notifikasi in-app & Bottom Sheet untuk error fatal
• Caching Room dengan auto-clearing untuk data basi
• Session expiration handling terpusat yang konsisten di seluruh fitur

2. Teknologi dan Prinsip

• Kotlin, Coroutines + Flow
• Jetpack Compose (Material 3), collectAsStateWithLifecycle untuk lifecycle-aware
• Hilt (Dependency Injection)
• MVVM + Clean Architecture
• Modularization per feature + core + library
• Coil untuk pemuatan gambar (contoh di Profile)
• Result/Failure sebagai kontrak domain untuk error yang kuat secara tipe
• Room untuk caching data
• Firebase Cloud Messaging (FCM) untuk push notification

3. Arsitektur: MVVM + Clean

Lapisan Utama

Aliran Data

Contoh submit form:

UI → ViewModel → UseCase (domain) → Repository → 
Result dikembalikan → ViewModel map ke state/error → UI render

4. Struktur Proyek

Struktur dalam Satu Feature (Auth)

5. Komponen Penting

sealed class Result<out T> {
    data class Success<out T>(val data: T) : Result<T>()
    data class Error(
        val message: String = "",
        val code: Int? = null,
        val failure: DomainFailure? = null
    ) : Result<Nothing>()
}

class LoginUseCase(
    private val repo: AuthRepository,
    dispatcher: CoroutineDispatcher
) : UseCase<LoginUseCase.Param, User>(dispatcher) {

    data class Param(val username: String, val password: String)

    override suspend fun execute(param: Param): Result<User> {
        val username = param.username.trim()
        val password = param.password

        if (username.isBlank()) 
            return Result.Error(failure = LoginFailure.UsernameEmpty)
        if (password.isBlank()) 
            return Result.Error(failure = LoginFailure.PasswordEmpty)

        val usernameValid = username.length >= 3
        val pwdValid = password.length >= 6
        
        if (!usernameValid) 
            return Result.Error(failure = LoginFailure.UsernameTooShort)
        if (!pwdValid) 
            return Result.Error(failure = LoginFailure.PasswordTooShort)

        return repo.login(username, password)
    }
}

private val _events = MutableSharedFlow<LoginEvent>(replay = 1)
val events: SharedFlow<LoginEvent> = _events

// on success: 
_events.emit(LoginEvent.LoginSuccess(user))

interface StringProvider { 
    fun get(id: Int): String 
}

class AndroidStringProvider @Inject constructor(
    @ApplicationContext ctx: Context
) : StringProvider {
    override fun get(id: Int) = ctx.getString(id)
}

fun show() { /* ++counter → isLoading true */ }
fun hide() { /* --counter → isLoading false jika 0 */ }

5.6 Navigasi, Splash, dan Sesi

• AppNavViewModel mengamati status login dari SessionRepository
• Splash menavigasi ke Dashboard atau Login berdasarkan isLoggedIn
• Profile logout: memanggil clearSession() lalu navigate ke Login dengan clear back stack

5.7 Design System

Warna brand (BrandRed, dsb), tema Material3, komponen seperti ShimmerPlaceholder. Komponen UI diselaraskan dengan MaterialTheme untuk konsistensi.

@HiltViewModel
class ExampleViewModel @Inject constructor(
    private val useCase: DoSomethingUseCase,
    private val retry: RetryManager,
) : BaseViewModel() {
    fun submit() = launchWithLoading {
        retry.run { emitSnackbarOnError = true }
            .execute { useCase() }
            .onSuccess { /* update state */ }
            .onFailure { /* optional handling */ }
    }
}

6. Praktik Baik di UI

• Gunakan collectAsStateWithLifecycle untuk semua StateFlow
• Gunakan one-off event (SharedFlow/Channel) untuk tindakan yang tidak idempotent
• Reset error saat input berubah di ViewModel, bukan di UI
• Semua string UI melalui strings.xml; ViewModel pakai StringProvider
• Disable input saat loading; sembunyikan keyboard ketika submit

7. Contoh Alur Login

1. LoginScreen memanggil vm.login() pada IME Done / klik tombol
2. LoginViewModel:
   • show() LoadingManager
   • loginUseCase(Param) → Result
   • Success → emit(LoginEvent.LoginSuccess)
   • Error → map LoginFailure ke usernameError/passwordError atau generalError
   • hide() LoadingManager
3. UI mengamati events dan melakukan navigasi

8. Menjalankan Proyek

1. Buka dengan Android Studio (Hedgehog+ direkomendasikan)
2. Sync Gradle, pastikan JDK yang sesuai
3. Jalankan app pada emulator/perangkat
4. Modul yang diperlukan akan ter-build otomatis

9. Konvensi Kode

Konvensi Penamaan

Dependency Injection (Hilt)

@Module
@InstallIn(SingletonComponent::class)
interface AuthDataModule {
    @Binds
    fun bindAuthRepository(impl: AuthRepositoryImpl): AuthRepository
}

Error Handling & Mapping

when (val res = loginUseCase(param)) {
    is Result.Success -> 
        _events.emit(LoginEvent.LoginSuccess(res.data))
    is Result.Error -> when (res.failure) {
        LoginFailure.UsernameEmpty -> 
            _state.update { 
                it.copy(usernameError = sp.get(R.string.error_username_empty)) 
            }
        LoginFailure.PasswordTooShort -> 
            _state.update { 
                it.copy(passwordError = sp.get(R.string.error_password_short)) 
            }
        else -> 
            _state.update { 
                it.copy(generalError = sp.get(R.string.error_generic)) 
            }
    }
}

10. Panduan Testing

Unit Test UseCase

class LoginUseCaseTest {
    private val repo = FakeAuthRepository()
    private val useCase = LoginUseCase(repo, StandardTestDispatcher())

    @Test 
    fun blank_username_returns_failure() = runTest {
        val res = useCase(LoginUseCase.Param(" ", "123456"))
        assertTrue(res is Result.Error && 
                   res.failure == LoginFailure.UsernameEmpty)
    }
}

Unit Test ViewModel

• Gunakan FakeStringProvider
• Gunakan UnconfinedTestDispatcher
• Gunakan fake/mocked repository

Perintah Testing

# Jalankan semua unit test
./gradlew testDebugUnitTest

# Jalankan lint
./gradlew lint

Cara Membuat Feature Baru

1. Buat modul baru feature-xyz
2. Buat paket: domain, data, ui/screen, navigation
3. Definisikan Failure, UseCase, dan kontrak Repository di domain
4. Implementasikan RepositoryImpl + mapper di data
5. Buat XyzScreen + XyzViewModel di presentation
6. Tambah route di navigation dan daftarkan di AppNavHost
7. Tambah dependency modul di build.gradle.kts
8. Tulis minimal 1 unit test UseCase dan 1 unit test ViewModel

Template ViewModel

@HiltViewModel
class XyzViewModel @Inject constructor(
    private val useCase: XyzUseCase,
    private val sp: StringProvider,
    private val loading: LoadingManager,
) : ViewModel() {
    // StateFlow, events, intent handlers
}

Build Configuration

Build Variants & Environment

android {
  buildTypes {
    debug { 
        buildConfigField("String", "BASE_URL", '"https://dev.api"') 
    }
    release { 
        buildConfigField("String", "BASE_URL", '"https://prod.api"') 
    }
  }
}

Secrets Management

val API_KEY: String by project
buildTypes {
  debug { 
    buildConfigField("String", "API_KEY", '"' + API_KEY + '"') 
  }
}

Quality & Accessibility

Logging & Analytics

• Gunakan wrapper logging (Timber)
• Timber.d untuk debug non-sensitif
• Timber.e untuk error (tanpa PII)
• Nonaktifkan verbose log di release

Aksesibilitas & i18n

• Semua komponen punya contentDescription bila relevan
• Hindari teks hardcoded; gunakan strings.xml
• Gunakan semantics heading() untuk judul list/section
• Pastikan kontras warna mengikuti Material3

Definition of Done

Minimal Requirements

• ✅ Unit test untuk UseCase dan ViewModel lulus
• ✅ Tidak ada literal string di domain/data
• ✅ Loading tidak nyangkut; navigasi idempotent
• ✅ Dokumentasi route/fitur baru ditambahkan

PR Checklist

• ☑️ Nama branch sesuai konvensi
• ☑️ Screenshot UI (light/dark) bila ada perubahan UI
• ☑️ Test lulus, lint lulus
• ☑️ Update strings + aksesibilitas

11. Troubleshooting & FAQ

Peta Dependensi Modul

Pedoman Navigasi

• Route didefinisikan di lib-navigation atau paket navigation tiap feature
• Setelah login sukses: navigate ke Dashboard dan clear back stack Login
• Logout dari Profile: clear hingga Dashboard, lalu navigate ke Login

Contoh Pemakaian

navController.navigate(Routes.DASHBOARD) {
    popUpTo(Routes.LOGIN) { inclusive = true }
}

Tambahan v2

• Deep Link: definisikan uriPattern di graph tiap feature; gunakan helper di lib-navigation untuk memetakan deep link → Destination.
• Notification Actions: intent dari notifikasi memicu deep link yang sama; lihat feature-notification dan AppNavHost contoh implementasinya.

Ringkasan Teknologi

Best Practices Summary

Workflow Development

1. Membuat Feature Baru

1. Buat module feature-xyz
2. Setup struktur: domain, data, ui, navigation
3. Definisikan contracts (UseCase, Repository, Failure)
4. Implementasi domain logic
5. Implementasi data layer
6. Buat UI dengan Compose
7. Setup ViewModel dengan proper state management
8. Tambahkan route ke navigation graph
9. Tulis unit tests
10. Update documentation

2. Code Review Checklist

• Architecture compliance (MVVM + Clean)
• Proper error handling
• i18n implementation
• Unit test coverage
• No hardcoded strings
• Proper dependency injection
• Memory leak prevention
• Accessibility support

Glossary

Resources & Links

Documentation

• Jetpack Compose: developer.android.com/jetpack/compose
• Hilt: developer.android.com/training/dependency-injection/hilt-android
• Kotlin Coroutines: kotlinlang.org/docs/coroutines-overview.html
• Material 3: m3.material.io

Best Practices

• Clean Architecture Guide
• Android Architecture Components
• Kotlin Coding Conventions
• Compose API Guidelines

Version History

Terima Kasih

Dokumentasi ini dibuat untuk membantu developer memahami dan menggunakan
BankingApp dengan lebih efektif.